helpcommand.cpp

   1 /*
   2  *  helpcommand.cpp
   3  *  Dotur
   4  *
   5  *  Created by Sarah Westcott on 1/2/09.
   6  *  Copyright 2009 Schloss Lab UMASS Amherst. All rights reserved.
   7  *
   8  */
   9
  10 #include "helpcommand.h"
  11
  12 //**********************************************************************************************************************
  13
  14 HelpCommand::HelpCommand(){}
  15
  16 //**********************************************************************************************************************
  17
  18 HelpCommand::~HelpCommand(){}
  19
  20 //**********************************************************************************************************************
  21
  22 int HelpCommand::execute(){
  23
  24         globaldata = GlobalData::getInstance();
  25
  26         if (globaldata->helpRequest == "read.dist") {
  27                 cout << "The read.dist command parameter options are phylipfile or columnfile, namefile, cutoff and precision" << "\n";
  28                 cout << "The read.dist command should be in the following format: " << "\n";
  29                 cout << "read.dist(phylipfile=yourDistFile, namefile=yourNameFile, cutoff=yourCutoff, precision=yourPrecision) " << "\n";
  30                 cout << "The phylipfile or columnfile parameter is required, but only one may be used.  If you use a columnfile the namefile is required. " << "\n";
  31                 cout << "If you do not provide a cutoff value 10.00 is assumed. If you do not provide a precision value then 100 is assumed." << "\n";
  32                 cout << "Note: No spaces between parameter labels (i.e. distfile), '=' and parameters (i.e.yourDistfile)." << "\n" << "\n";
  33         }else if (globaldata->helpRequest == "read.otu") {
  34                 cout << "The read.otu command parameter options are listfile, rabundfile, sabundfile or orderfile." << "\n";
  35                 cout << "The read.otu command should be in the following format: " << "\n";
  36                 cout << "read.otu(listfile=yourListFile, orderfile=yourOrderFile) " << "\n";
  37                 cout << "The read.otu requires one of hte following parameters: listfile, rabundfile or sabundfile. Only one may be used at a time." << "\n";
  38                 cout << "Note: No spaces between parameter labels (i.e. listfile), '=' and parameters (i.e.yourListfile)." << "\n" << "\n";
  39         }else if (globaldata->helpRequest == "read.list") {
  40                 cout << "The read.list command parameter options are listfile and groupfile." << "\n";
  41                 cout << "The read.list command should be in the following format: " << "\n";
  42                 cout << "read.list(listfile=yourListFile, groupfile=yourGroupFile) " << "\n";
  43                 cout << "The listfile parameter and groupfile paramaters are required." << "\n";
  44                 cout << "The read.list command parses a list file and separates it into groups." << "\n";
  45                 cout << "It outputs a .shared file containing the otu information for each group as well as a .list file for each group." << "\n";
  46                 cout << "Note: No spaces between parameter labels (i.e. listfile), '=' and parameters (i.e.yourListfile)." << "\n" << "\n";
  47         }else if (globaldata->helpRequest == "cluster") {
  48                 cout << "The cluster command can only be executed after a successful read.phylip or read.column command." << "\n";
  49                 cout << "The cluster command parameter options are method, cuttoff and precision. No parameters are required." << "\n";
  50                 cout << "The cluster command should be in the following format: " << "\n";
  51                 cout << "cluster(method=yourMethod, cutoff=yourCutoff, precision=yourPrecision) " << "\n";
  52                 cout << "The acceptable cluster methods are furthest, nearest and average.  If no method is provided then furthest is assumed." << "\n" << "\n";
  53         }else if (globaldata->helpRequest == "collect.single") {
  54                 cout << "The collect.single command can only be executed after a successful read.list read.rabund or rad.sabund command. WITH ONE EXECEPTION. " << "\n";
  55                 cout << "The collect.single command can be executed after a successful cluster command.  It will use the .list file from the output of the cluster." << "\n";
  56                 cout << "The collect.single command parameters are label, line, freq, single.  No parameters are required, but you may not use " << "\n";
  57                 cout << "both the line and label parameters at the same time. The collect.single command should be in the following format: " << "\n";
  58                 cout << "collect.single(label=yourLabel, line=yourLines, iters=yourIters, freq=yourFreq, single=yourEstimators)." << "\n";
  59                 cout << "Example collect(label=unique-.01-.03, line=0,5,10, iters=10000, freq=10, single=collect-chao-ace-jack)." << "\n";
  60                 cout << "The default values for freq is 100, and single are sobs-chao-ace-jack-bootstrap-shannon-npshannon-simpson." << "\n";
  61                 cout << "The label and line parameters are used to analyze specific lines in your input." << "\n";
  62                 cout << "Note: No spaces between parameter labels (i.e. listfile), '=' and parameters (i.e.yourListfile)." << "\n" << "\n";
  63         }else if (globaldata->helpRequest == "collect.shared") {
  64                 cout << "The collect.shared command can only be executed after a successful read.shared command." << "\n";
  65                 cout << "The collect.shared command parameters are label, line, freq, jumble, shared.  No parameters are required, but you may not use " << "\n";
  66                 cout << "both the line and label parameters at the same time. The collect.shared command should be in the following format: " << "\n";
  67                 cout << "collect.shared(label=yourLabel, line=yourLines, freq=yourFreq, jumble=yourJumble, shared=yourEstimators)." << "\n";
  68                 cout << "Example collect.shared(label=unique-.01-.03, line=0,5,10, freq=10, jumble=1, shared=sharedChao-sharedAce-sharedJabund-sharedSorensonAbund-sharedJclass-sharedSorClass-sharedJest-sharedSorEst-SharedThetaYC-SharedThetaN)." << "\n";
  69                 cout << "The default values for jumble is 0 (meaning don’t jumble, if it’s set to 1 then it will jumble), freq is 100 and shared are sharedChao-sharedAce-sharedJabund-sharedSorensonAbund-sharedJclass-sharedSorClass-sharedJest-sharedSorEst-SharedThetaYC-SharedThetaN." << "\n";
  70                 cout << "The label and line parameters are used to analyze specific lines in your input." << "\n";
  71                 cout << "Note: No spaces between parameter labels (i.e. listfile), '=' and parameters (i.e.yourListfile)." << "\n" << "\n";
  72         }else if (globaldata->helpRequest == "rarefaction.single") {
  73                 cout << "The rarefaction.single command can only be executed after a successful read.list, read.rabund or read.sabund. WTIH ONE EXECEPTION." << "\n";
  74                 cout << "The rarefaction.single command can be executed after a successful cluster command.  It will use the .list file from the output of the cluster." << "\n";
  75                 cout << "The rarefaction.single command parameters are label, line, iters, freq, rarefaction.  No parameters are required, but you may not use " << "\n";
  76                 cout << "both the line and label parameters at the same time. The rarefaction.single command should be in the following format: " << "\n";
  77                 cout << "rarefaction.single(label=yourLabel, line=yourLines, iters=yourIters, freq=yourFreq, rarefaction=yourEstimators)." << "\n";
  78                 cout << "Example rarefaction.single(label=unique-.01-.03, line=0,5,10, iters=10000, freq=10, rarefaction=rarefaction-rchao-race-rjack-rbootstrap-rshannon-rnpshannon-rsimpson)." << "\n";
  79                 cout << "The default values for iters is 1000, freq is 100, and rarefaction is rarefaction which calculates the rarefaction curve for the observed richness." << "\n";
  80                 cout << "The label and line parameters are used to analyze specific lines in your input." << "\n";
  81                 cout << "Note: No spaces between parameter labels (i.e. listfile), '=' and parameters (i.e.yourListfile)." << "\n" << "\n";
  82         }else if (globaldata->helpRequest == "rarefaction.shared") {
  83                 cout << "The rarefaction.shared command can only be executed after a successful read.shared command." << "\n";
  84                 cout << "The rarefaction.shared command parameters are label, line, iters, jumble and sharedrarefaction.  No parameters are required, but you may not use " << "\n";
  85                 cout << "both the line and label parameters at the same time. The rarefaction command should be in the following format: " << "\n";
  86                 cout << "rarefaction.shared(label=yourLabel, line=yourLines, iters=yourIters, jumble=yourJumble, sharedrarefaction=yourEstimators)." << "\n";
  87                 cout << "Example rarefaction.shared(label=unique-.01-.03, line=0,5,10, iters=10000, jumble=1, sharedrarefaction=sharedobserved)." << "\n";
  88                 cout << "The default values for iters is 1000, jumble is 0 (meaning don’t jumble, if it’s set to 1 then it will jumble), freq is 100, and sharedrarefaction is sharedobserved which calculates the shared rarefaction curve for the observed richness." << "\n";
  89                 cout << "The label and line parameters are used to analyze specific lines in your input." << "\n";
  90                 cout << "Note: No spaces between parameter labels (i.e. listfile), '=' and parameters (i.e.yourListfile)." << "\n" << "\n";
  91         }else if (globaldata->helpRequest == "summary.single") {
  92                 cout << "The summary.single command can only be executed after a successful read.list, read.rabund or read.sabund. WTIH ONE EXECEPTION." << "\n";
  93                 cout << "The summary.single command can be executed after a successful cluster command.  It will use the .list file from the output of the cluster." << "\n";
  94                 cout << "The summary.single command parameters are label, line, summary.  No parameters are required, but you may not use " << "\n";
  95                 cout << "both the line and label parameters at the same time. The summary.single command should be in the following format: " << "\n";
  96                 cout << "summary.single(label=yourLabel, line=yourLines, summary=yourEstimators)." << "\n";
  97                 cout << "Example summary.single(label=unique-.01-.03, line=0,5,10, summary=sobs-chao-ace-jack-bootstrap-shannon-npshannon-simpson)." << "\n";
  98                 cout << "The default value summary is sobs-chao-ace-jack-bootstrap-shannon-npshannon-simpson" << "\n";
  99                 cout << "The label and line parameters are used to analyze specific lines in your input." << "\n";
 100                 cout << "Note: No spaces between parameter labels (i.e. listfile), '=' and parameters (i.e.yourListfile)." << "\n" << "\n";
 101         }else if (globaldata->helpRequest == "summary.shared") {
 102                 cout << "The summary.shared command can only be executed after a successful read.shared command." << "\n";
 103                 cout << "The summary.shared command parameters are label, line, jumble and sharedsummary.  No parameters are required, but you may not use " << "\n";
 104                 cout << "both the line and label parameters at the same time. The summary.shared command should be in the following format: " << "\n";
 105                 cout << "summary.shared(label=yourLabel, line=yourLines, jumble=yourJumble, sharedsummary=yourEstimators)." << "\n";
 106                 cout << "Example summary.shared(label=unique-.01-.03, line=0,5,10, jumble=1, sharedsummary=sharedChao-sharedAce-sharedJabund-sharedSorensonAbund-sharedJclass-sharedSorClass-sharedJest-sharedSorEst-SharedThetaYC-SharedThetaN)." << "\n";
 107                 cout << "The default value for jumble is 0 (meaning don’t jumble, if it’s set to 1 then it will jumble) and sharedsummary is sharedChao-sharedAce-sharedJabund-sharedSorensonAbund-sharedJclass-sharedSorClass-sharedJest-sharedSorEst-SharedThetaYC-SharedThetaN" << "\n";
 108                 cout << "The label and line parameters are used to analyze specific lines in your input." << "\n";
 109                 cout << "Note: No spaces between parameter labels (i.e. listfile), '=' and parameters (i.e.yourListfile)." << "\n" << "\n";
 110         }else if (globaldata->helpRequest == "quit") {
 111                 cout << "The quit command will terminate Dotur and should be in the following format: " << "\n";
 112                 cout << "quit()" << "\n" << "\n";
 113         }else if (globaldata->helpRequest == "") {
 114                 cout << "Valid commands are read.dist(), read.list(), read.otu(), cluster(), collect.single(), rarefaction.single(), summary.single(), collect.shared(), rarefaction.shared(), summary.shared(), quit(), help()." << "\n";
 115                 cout << "For more information about a specific command type 'help(commandName)' i.e. 'help(read.phylip)'" << endl;
 116         }else {
 117                 cout << "not a valid command" << endl;
 118         }
 119
 120         cout << endl << "For further assistance please refer to the Mothur manual, or contact Pat Schloss at pschloss@microbio.umass.edu." << "\n";
 121         return 0;
 122 }
 123
 124 //**********************************************************************************************************************/