venncommand.cpp

   1 /*
   2  *  venncommand.cpp
   3  *  Mothur
   4  *
   5  *  Created by Sarah Westcott on 3/30/09.
   6  *  Copyright 2009 Schloss Lab UMASS Amherst. All rights reserved.
   7  *
   8  */
   9
  10 #include "venncommand.h"
  11 #include "ace.h"
  12 #include "sobs.h"
  13 #include "chao1.h"
  14 //#include "jackknife.h"
  15 #include "sharedsobscollectsummary.h"
  16 #include "sharedchao1.h"
  17 #include "sharedace.h"
  18
  19
  20 //**********************************************************************************************************************
  21
  22 VennCommand::VennCommand(string option){
  23         try {
  24                 globaldata = GlobalData::getInstance();
  25                 abort = false;
  26                 allLines = 1;
  27                 lines.clear();
  28                 labels.clear();
  29
  30                 //allow user to run help
  31                 if(option == "help") { help(); abort = true; }
  32
  33                 else {
  34                         //valid paramters for this command
  35                         string AlignArray[] =  {"groups","line","label","calc", "abund"};
  36                         vector<string> myArray (AlignArray, AlignArray+(sizeof(AlignArray)/sizeof(string)));
  37
  38                         OptionParser parser(option);
  39                         map<string,string> parameters = parser.getParameters();
  40
  41                         ValidParameters validParameter;
  42
  43                         //check to make sure all parameters are valid for command
  44                         for (map<string,string>::iterator it = parameters.begin(); it != parameters.end(); it++) {
  45                                 if (validParameter.isValidParameter(it->first, myArray, it->second) != true) {  abort = true;  }
  46                         }
  47
  48                         //make sure the user has already run the read.otu command
  49                         if ((globaldata->getListFile() == "") && (globaldata->getSharedFile() == "")) {
  50                                  cout << "You must read a list, or a list and a group, or a shared before you can use the venn command." << endl; abort = true;
  51                         }
  52
  53                         //check for optional parameter and set defaults
  54                         // ...at some point should added some additional type checking...
  55                         line = validParameter.validFile(parameters, "line", false);
  56                         if (line == "not found") { line = "";  }
  57                         else {
  58                                 if(line != "all") {  splitAtDash(line, lines);  allLines = 0;  }
  59                                 else { allLines = 1;  }
  60                         }
  61
  62                         label = validParameter.validFile(parameters, "label", false);
  63                         if (label == "not found") { label = ""; }
  64                         else {
  65                                 if(label != "all") {  splitAtDash(label, labels);  allLines = 0;  }
  66                                 else { allLines = 1;  }
  67                         }
  68
  69                         //make sure user did not use both the line and label parameters
  70                         if ((line != "") && (label != "")) { cout << "You cannot use both the line and label parameters at the same time. " << endl; abort = true; }
  71                         //if the user has not specified any line or labels use the ones from read.otu
  72                         else if ((line == "") && (label == "")) {
  73                                 allLines = globaldata->allLines;
  74                                 labels = globaldata->labels;
  75                                 lines = globaldata->lines;
  76                         }
  77
  78                         groups = validParameter.validFile(parameters, "groups", false);
  79                         if (groups == "not found") { groups = ""; }
  80                         else {
  81                                 splitAtDash(groups, Groups);
  82                                 globaldata->Groups = Groups;
  83                         }
  84
  85                         format = globaldata->getFormat();
  86                         calc = validParameter.validFile(parameters, "calc", false);
  87                         if (calc == "not found") {
  88                                 if(format == "list") { calc = "sobs"; }
  89                                 else { calc = "sharedsobs"; }
  90                         }
  91                         else {
  92                                  if (calc == "default")  {
  93                                         if(format == "list") { calc = "sobs"; }
  94                                         else { calc = "sharedsobs"; }
  95                                 }
  96                         }
  97                         splitAtDash(calc, Estimators);
  98
  99                         string temp;
 100                         temp = validParameter.validFile(parameters, "abund", false);            if (temp == "not found") { temp = "10"; }
 101                         convert(temp, abund);
 102
 103                         if (abort == false) {
 104                                 validCalculator = new ValidCalculators();
 105
 106                                 int i;
 107
 108                                 if (format == "list") {
 109                                         for (i=0; i<Estimators.size(); i++) {
 110                                                 if (validCalculator->isValidCalculator("vennsingle", Estimators[i]) == true) {
 111                                                         if (Estimators[i] == "sobs") {
 112                                                                 vennCalculators.push_back(new Sobs());
 113                                                         }else if (Estimators[i] == "chao") {
 114                                                                 vennCalculators.push_back(new Chao1());
 115                                                         }else if (Estimators[i] == "ace") {
 116                                                                 if(abund < 5)
 117                                                                         abund = 10;
 118                                                                 vennCalculators.push_back(new Ace(abund));
 119                                                         }
 120                                                 }
 121                                         }
 122                                 }else {
 123                                         for (i=0; i<Estimators.size(); i++) {
 124                                                 if (validCalculator->isValidCalculator("vennshared", Estimators[i]) == true) {
 125                                                         if (Estimators[i] == "sharedsobs") {
 126                                                                 vennCalculators.push_back(new SharedSobsCS());
 127                                                         }else if (Estimators[i] == "sharedchao") {
 128                                                                 vennCalculators.push_back(new SharedChao1());
 129                                                         }else if (Estimators[i] == "sharedace") {
 130                                                                 vennCalculators.push_back(new SharedAce());
 131                                                         }
 132                                                 }
 133                                         }
 134                                 }
 135
 136                                 venn = new Venn();
 137                         }
 138                 }
 139
 140
 141
 142         }
 143         catch(exception& e) {
 144                 cout << "Standard Error: " << e.what() << " has occurred in the VennCommand class Function VennCommand. Please contact Pat Schloss at pschloss@microbio.umass.edu." << "\n";
 145                 exit(1);
 146         }
 147         catch(...) {
 148                 cout << "An unknown error has occurred in the VennCommand class function VennCommand. Please contact Pat Schloss at pschloss@microbio.umass.edu." << "\n";
 149                 exit(1);
 150         }
 151 }
 152
 153 //**********************************************************************************************************************
 154
 155 void VennCommand::help(){
 156         try {
 157                 cout << "The venn command can only be executed after a successful read.otu command." << "\n";
 158                 cout << "The venn command parameters are groups, calc, abund, line and label.  No parameters are required, but you may not use line and label at the same time." << "\n";
 159                 cout << "The groups parameter allows you to specify which of the groups in your groupfile you would like included in your venn diagram, you may only use a maximum of 4 groups." << "\n";
 160                 cout << "The group names are separated by dashes. The line and label allow you to select what distance levels you would like a venn diagram created for, and are also separated by dashes." << "\n";
 161                 cout << "The venn command should be in the following format: venn(groups=yourGroups, calc=yourCalcs, line=yourLines, label=yourLabels, abund=yourAbund)." << "\n";
 162                 cout << "Example venn(groups=A-B-C, line=1-3-5, calc=sharedsobs-sharedchao, abund=20)." << "\n";
 163                 cout << "The default value for groups is all the groups in your groupfile up to 4, and all lines in your inputfile will be used." << "\n";
 164                 cout << "The default value for calc is sobs if you have only read a list file or if you have selected only one group, and sharedsobs if you have multiple groups." << "\n";
 165                 cout << "The default available estimators for calc are sobs, chao and ace if you have only read a list file, and sharedsobs, sharedchao and sharedace if you have read a list and group file or a shared file." << "\n";
 166                 cout << "The only estmiator available four 4 groups is sharedsobs." << "\n";
 167                 cout << "The venn command outputs a .svg file for each calculator you specify at each distance you choose." << "\n";
 168                 cout << "Note: No spaces between parameter labels (i.e. groups), '=' and parameters (i.e.yourGroups)." << "\n" << "\n";
 169         }
 170         catch(exception& e) {
 171                 cout << "Standard Error: " << e.what() << " has occurred in the VennCommand class Function help. Please contact Pat Schloss at pschloss@microbio.umass.edu." << "\n";
 172                 exit(1);
 173         }
 174         catch(...) {
 175                 cout << "An unknown error has occurred in the VennCommand class function help. Please contact Pat Schloss at pschloss@microbio.umass.edu." << "\n";
 176                 exit(1);
 177         }
 178 }
 179
 180
 181 //**********************************************************************************************************************
 182
 183 VennCommand::~VennCommand(){
 184         delete input;
 185         delete read;
 186         delete venn;
 187         for (int i = 0; i < vennCalculators.size(); i++) {      delete vennCalculators[i];      }
 188 }
 189
 190 //**********************************************************************************************************************
 191
 192 int VennCommand::execute(){
 193         try {
 194
 195                 if (abort == true) { return 0; }
 196
 197                 int count = 1;
 198                 SAbundVector* lastSAbund;
 199                 vector<SharedRAbundVector*> lastLookup;
 200
 201                 //if the users entered no valid calculators don't execute command
 202                 if (vennCalculators.size() == 0) { return 0; }
 203
 204                 if (format == "sharedfile") {
 205                         //you have groups
 206                         read = new ReadOTUFile(globaldata->inputFileName);
 207                         read->read(&*globaldata);
 208
 209                         input = globaldata->ginput;
 210                         lookup = input->getSharedRAbundVectors();
 211                         lastLookup = lookup;
 212                 }else if (format == "list") {
 213                         //you are using just a list file and have only one group
 214                         read = new ReadOTUFile(globaldata->inputFileName);
 215                         read->read(&*globaldata);
 216
 217                         sabund = globaldata->sabund;
 218                         lastSAbund = globaldata->sabund;
 219                         input = globaldata->ginput;
 220                 }
 221
 222                 //if the users enters label "0.06" and there is no "0.06" in their file use the next lowest label.
 223                 set<string> processedLabels;
 224                 set<string> userLabels = labels;
 225                 set<int> userLines = lines;
 226
 227                 if (format != "list") {
 228
 229                         //as long as you are not at the end of the file or done wih the lines you want
 230                         while((lookup[0] != NULL) && ((allLines == 1) || (userLabels.size() != 0) || (userLines.size() != 0))) {
 231
 232                                 if(allLines == 1 || lines.count(count) == 1 || labels.count(lookup[0]->getLabel()) == 1){
 233                                         cout << lookup[0]->getLabel() << '\t' << count << endl;
 234                                         processedLabels.insert(lookup[0]->getLabel());
 235                                         userLabels.erase(lookup[0]->getLabel());
 236                                         userLines.erase(count);
 237
 238                                         if (lookup.size() > 4) {
 239                                                 cout << "Error: Too many groups chosen.  You may use up to 4 groups with the venn command.  I will use the first four groups in your groupfile." << endl;
 240                                                 for (int i = lookup.size(); i > 4; i--) { lookup.pop_back(); } //no memmory leak because pop_back calls destructor
 241                                         }
 242                                         venn->getPic(lookup, vennCalculators);
 243                                 }
 244
 245                                 if ((anyLabelsToProcess(lookup[0]->getLabel(), userLabels, "") == true) && (processedLabels.count(lastLookup[0]->getLabel()) != 1)) {
 246                                         cout << lastLookup[0]->getLabel() << '\t' << count << endl;
 247                                         processedLabels.insert(lastLookup[0]->getLabel());
 248                                         userLabels.erase(lastLookup[0]->getLabel());
 249
 250                                         if (lastLookup.size() > 4) {
 251                                                 cout << "Error: Too many groups chosen.  You may use up to 4 groups with the venn command.  I will use the first four groups in your groupfile." << endl;
 252                                                 for (int i = lastLookup.size(); i > 4; i--) { lastLookup.pop_back(); } //no memmory leak because pop_back calls destructor
 253                                         }
 254                                         venn->getPic(lastLookup, vennCalculators);
 255                                 }
 256
 257                                 //prevent memory leak
 258                                 if (count != 1) { for (int i = 0; i < lastLookup.size(); i++) {  delete lastLookup[i];  } }
 259                                 lastLookup = lookup;
 260
 261                                 //get next line to process
 262                                 lookup = input->getSharedRAbundVectors();
 263                                 count++;
 264                         }
 265
 266                         //output error messages about any remaining user labels
 267                         set<string>::iterator it;
 268                         bool needToRun = false;
 269                         for (it = userLabels.begin(); it != userLabels.end(); it++) {
 270                                 cout << "Your file does not include the label "<< *it;
 271                                 if (processedLabels.count(lastLookup[0]->getLabel()) != 1) {
 272                                         cout << ". I will use " << lastLookup[0]->getLabel() << "." << endl;
 273                                         needToRun = true;
 274                                 }else {
 275                                         cout << ". Please refer to " << lastLookup[0]->getLabel() << "." << endl;
 276                                 }
 277                         }
 278
 279                         //run last line if you need to
 280                         if (needToRun == true)  {
 281                                 cout << lastLookup[0]->getLabel() << '\t' << count << endl;
 282                                 if (lastLookup.size() > 4) {
 283                                         cout << "Error: Too many groups chosen.  You may use up to 4 groups with the venn command.  I will use the first four groups in your groupfile." << endl;
 284                                         for (int i = lastLookup.size(); i > 3; i--) { delete lastLookup[i]; lastLookup.pop_back(); }
 285                                 }
 286                                 venn->getPic(lastLookup, vennCalculators);
 287                         }
 288
 289                         for (int i = 0; i < lastLookup.size(); i++) {  delete lastLookup[i];  }
 290
 291                         //reset groups parameter
 292                         globaldata->Groups.clear();
 293
 294                 }else{
 295
 296                         while((sabund != NULL) && ((allLines == 1) || (userLabels.size() != 0) || (userLines.size() != 0))) {
 297
 298                                 if(allLines == 1 || lines.count(count) == 1 || labels.count(sabund->getLabel()) == 1){
 299
 300                                         cout << sabund->getLabel() << '\t' << count << endl;
 301                                         venn->getPic(sabund, vennCalculators);
 302
 303                                         processedLabels.insert(sabund->getLabel());
 304                                         userLabels.erase(sabund->getLabel());
 305                                         userLines.erase(count);
 306                                 }
 307
 308                                 if ((anyLabelsToProcess(sabund->getLabel(), userLabels, "") == true) && (processedLabels.count(lastSAbund->getLabel()) != 1)) {
 309
 310                                         cout << lastSAbund->getLabel() << '\t' << count << endl;
 311                                         venn->getPic(lastSAbund, vennCalculators);
 312
 313                                         processedLabels.insert(lastSAbund->getLabel());
 314                                         userLabels.erase(lastSAbund->getLabel());
 315                                 }
 316
 317                                 if (count != 1) { delete lastSAbund; }
 318                                 lastSAbund = sabund;
 319
 320                                 sabund = input->getSAbundVector();
 321                                 count++;
 322                         }
 323
 324                         //output error messages about any remaining user labels
 325                         set<string>::iterator it;
 326                         bool needToRun = false;
 327                         for (it = userLabels.begin(); it != userLabels.end(); it++) {
 328                                 cout << "Your file does not include the label "<< *it;
 329                                 if (processedLabels.count(lastSAbund->getLabel()) != 1) {
 330                                         cout << ". I will use " << lastSAbund->getLabel() << "." << endl;
 331                                         needToRun = true;
 332                                 }else {
 333                                         cout << ". Please refer to " << lastSAbund->getLabel() << "." << endl;
 334                                 }
 335                         }
 336
 337                         //run last line if you need to
 338                         if (needToRun == true)  {
 339                                 cout << lastSAbund->getLabel() << '\t' << count << endl;
 340                                 venn->getPic(lastSAbund, vennCalculators);
 341                         }
 342                         delete lastSAbund;
 343                 }
 344
 345                 return 0;
 346         }
 347         catch(exception& e) {
 348                 cout << "Standard Error: " << e.what() << " has occurred in the VennCommand class Function execute. Please contact Pat Schloss at pschloss@microbio.umass.edu." << "\n";
 349                 exit(1);
 350         }
 351         catch(...) {
 352                 cout << "An unknown error has occurred in the VennCommand class function execute. Please contact Pat Schloss at pschloss@microbio.umass.edu." << "\n";
 353                 exit(1);
 354         }
 355 }
 356
 357 //**********************************************************************************************************************