2 * otuassociationcommand.cpp
5 * Created by westcott on 1/19/12.
6 * Copyright 2012 Schloss Lab. All rights reserved.
10 #include "otuassociationcommand.h"
11 #include "linearalgebra.h"
13 //**********************************************************************************************************************
14 vector<string> OTUAssociationCommand::setParameters(){
16 CommandParameter pshared("shared", "InputTypes", "", "", "SharedRelMeta", "SharedRelMeta", "none",false,false); parameters.push_back(pshared);
17 CommandParameter prelabund("relabund", "InputTypes", "", "", "SharedRelMeta", "SharedRelMeta", "none",false,false); parameters.push_back(prelabund);
18 CommandParameter pmetadata("metadata", "InputTypes", "", "", "SharedRelMeta", "SharedRelMeta", "none",false,false); parameters.push_back(pmetadata);
19 CommandParameter pcutoff("cutoff", "Number", "", "10", "", "", "",false,false); parameters.push_back(pcutoff);
20 CommandParameter plabel("label", "String", "", "", "", "", "",false,false); parameters.push_back(plabel);
21 CommandParameter pgroups("groups", "String", "", "", "", "", "",false,false); parameters.push_back(pgroups);
22 CommandParameter pmethod("method", "Multiple", "pearson-spearman-kendall", "pearson", "", "", "",false,false); parameters.push_back(pmethod);
23 CommandParameter pinputdir("inputdir", "String", "", "", "", "", "",false,false); parameters.push_back(pinputdir);
24 CommandParameter poutputdir("outputdir", "String", "", "", "", "", "",false,false); parameters.push_back(poutputdir);
26 vector<string> myArray;
27 for (int i = 0; i < parameters.size(); i++) { myArray.push_back(parameters[i].name); }
31 m->errorOut(e, "OTUAssociationCommand", "setParameters");
35 //**********************************************************************************************************************
36 string OTUAssociationCommand::getHelpString(){
38 string helpString = "";
39 helpString += "The otu.association command reads a shared or relabund file and calculates the correlation coefficients between otus.\n";
40 helpString += "If you provide a metadata file, mothur will calculate te correlation bewteen the metadata and the otus.\n";
41 helpString += "The otu.association command parameters are shared, relabund, metadata, groups, method, cutoff and label. The shared or relabund parameter is required.\n";
42 helpString += "The groups parameter allows you to specify which of the groups you would like included. The group names are separated by dashes.\n";
43 helpString += "The label parameter allows you to select what distances level you would like used, and are also separated by dashes.\n";
44 helpString += "The cutoff parameter allows you to set a pvalue at which the otu will be reported.\n";
45 helpString += "The method parameter allows you to select what method you would like to use. Options are pearson, spearman and kendall. Default=pearson.\n";
46 helpString += "The otu.association command should be in the following format: otu.association(shared=yourSharedFile, method=yourMethod).\n";
47 helpString += "Example otu.association(shared=genus.pool.shared, method=kendall).\n";
48 helpString += "The otu.association command outputs a .otu.corr file.\n";
49 helpString += "Note: No spaces between parameter labels (i.e. groups), '=' and parameters (i.e.yourGroups).\n";
53 m->errorOut(e, "OTUAssociationCommand", "getHelpString");
57 //**********************************************************************************************************************
58 string OTUAssociationCommand::getOutputFileNameTag(string type, string inputName=""){
60 string outputFileName = "";
61 map<string, vector<string> >::iterator it;
63 //is this a type this command creates
64 it = outputTypes.find(type);
65 if (it == outputTypes.end()) { m->mothurOut("[ERROR]: this command doesn't create a " + type + " output file.\n"); }
67 if (type == "otucorr") { outputFileName = "otu.corr"; }
68 else { m->mothurOut("[ERROR]: No definition for type " + type + " output file tag.\n"); m->control_pressed = true; }
70 return outputFileName;
73 m->errorOut(e, "OTUAssociationCommand", "getOutputFileNameTag");
77 //**********************************************************************************************************************
78 OTUAssociationCommand::OTUAssociationCommand(){
80 abort = true; calledHelp = true;
82 vector<string> tempOutNames;
83 outputTypes["otucorr"] = tempOutNames;
86 m->errorOut(e, "OTUAssociationCommand", "OTUAssociationCommand");
90 //**********************************************************************************************************************
91 OTUAssociationCommand::OTUAssociationCommand(string option) {
93 abort = false; calledHelp = false;
96 //allow user to run help
97 if(option == "help") { help(); abort = true; calledHelp = true; }
98 else if(option == "citation") { citation(); abort = true; calledHelp = true;}
101 vector<string> myArray = setParameters();
103 OptionParser parser(option);
104 map<string, string> parameters = parser.getParameters();
106 ValidParameters validParameter;
107 map<string, string>::iterator it;
109 //check to make sure all parameters are valid for command
110 for (it = parameters.begin(); it != parameters.end(); it++) {
111 if (validParameter.isValidParameter(it->first, myArray, it->second) != true) { abort = true; }
114 vector<string> tempOutNames;
115 outputTypes["otucorr"] = tempOutNames;
117 //if the user changes the input directory command factory will send this info to us in the output parameter
118 string inputDir = validParameter.validFile(parameters, "inputdir", false);
119 if (inputDir == "not found"){ inputDir = ""; }
122 it = parameters.find("shared");
123 //user has given a template file
124 if(it != parameters.end()){
125 path = m->hasPath(it->second);
126 //if the user has not given a path then, add inputdir. else leave path alone.
127 if (path == "") { parameters["shared"] = inputDir + it->second; }
130 it = parameters.find("relabund");
131 //user has given a template file
132 if(it != parameters.end()){
133 path = m->hasPath(it->second);
134 //if the user has not given a path then, add inputdir. else leave path alone.
135 if (path == "") { parameters["relabund"] = inputDir + it->second; }
138 it = parameters.find("metadata");
139 //user has given a template file
140 if(it != parameters.end()){
141 path = m->hasPath(it->second);
142 //if the user has not given a path then, add inputdir. else leave path alone.
143 if (path == "") { parameters["metadata"] = inputDir + it->second; }
148 //check for required parameters
149 sharedfile = validParameter.validFile(parameters, "shared", true);
150 if (sharedfile == "not open") { abort = true; }
151 else if (sharedfile == "not found") { sharedfile = ""; }
152 else { inputFileName = sharedfile; m->setSharedFile(sharedfile); }
154 relabundfile = validParameter.validFile(parameters, "relabund", true);
155 if (relabundfile == "not open") { abort = true; }
156 else if (relabundfile == "not found") { relabundfile = ""; }
157 else { inputFileName = relabundfile; m->setRelAbundFile(relabundfile); }
159 metadatafile = validParameter.validFile(parameters, "metadata", true);
160 if (metadatafile == "not open") { abort = true; metadatafile = ""; }
161 else if (metadatafile == "not found") { metadatafile = ""; }
163 groups = validParameter.validFile(parameters, "groups", false);
164 if (groups == "not found") { groups = ""; pickedGroups = false; }
167 m->splitAtDash(groups, Groups);
169 m->setGroups(Groups);
171 outputDir = validParameter.validFile(parameters, "outputdir", false); if (outputDir == "not found"){ outputDir = m->hasPath(inputFileName); }
173 label = validParameter.validFile(parameters, "label", false);
174 if (label == "not found") { label = ""; }
176 if(label != "all") { m->splitAtDash(label, labels); allLines = 0; }
177 else { allLines = 1; }
180 if ((relabundfile == "") && (sharedfile == "")) {
181 //is there are current file available for any of these?
182 //give priority to shared, then relabund
183 //if there is a current shared file, use it
184 sharedfile = m->getSharedFile();
185 if (sharedfile != "") { inputFileName = sharedfile; m->mothurOut("Using " + sharedfile + " as input file for the shared parameter."); m->mothurOutEndLine(); }
187 relabundfile = m->getRelAbundFile();
188 if (relabundfile != "") { inputFileName = relabundfile; m->mothurOut("Using " + relabundfile + " as input file for the relabund parameter."); m->mothurOutEndLine(); }
190 m->mothurOut("You must provide either a shared or relabund file."); m->mothurOutEndLine(); abort = true;
196 if ((relabundfile != "") && (sharedfile != "")) { m->mothurOut("You may only use one of the following : shared or relabund file."); m->mothurOutEndLine(); abort = true; }
198 method = validParameter.validFile(parameters, "method", false); if (method == "not found"){ method = "pearson"; }
200 string temp = validParameter.validFile(parameters, "cutoff", false);
201 if (temp == "not found") { temp = "10"; }
202 m->mothurConvert(temp, cutoff);
204 if ((method != "pearson") && (method != "spearman") && (method != "kendall")) { m->mothurOut(method + " is not a valid method. Valid methods are pearson, spearman, and kendall."); m->mothurOutEndLine(); abort = true; }
208 catch(exception& e) {
209 m->errorOut(e, "OTUAssociationCommand", "OTUAssociationCommand");
213 //**********************************************************************************************************************
215 int OTUAssociationCommand::execute(){
218 if (abort == true) { if (calledHelp) { return 0; } return 2; }
220 if (metadatafile != "") { readMetadata(); }
222 //function are identical just different datatypes
223 if (sharedfile != "") { processShared(); }
224 else if (relabundfile != "") { processRelabund(); }
226 if (m->control_pressed) { for (int i = 0; i < outputNames.size(); i++) { m->mothurRemove(outputNames[i]); } return 0; }
228 m->mothurOutEndLine();
229 m->mothurOut("Output File Names: "); m->mothurOutEndLine();
230 for (int i = 0; i < outputNames.size(); i++) { m->mothurOut(outputNames[i]); m->mothurOutEndLine(); }
231 m->mothurOutEndLine();
235 catch(exception& e) {
236 m->errorOut(e, "OTUAssociationCommand", "execute");
240 //**********************************************************************************************************************
241 int OTUAssociationCommand::processShared(){
243 InputData* input = new InputData(sharedfile, "sharedfile");
244 vector<SharedRAbundVector*> lookup = input->getSharedRAbundVectors();
245 string lastLabel = lookup[0]->getLabel();
247 if (metadatafile != "") {
250 if (metadata[0].size() != lookup.size()) { m->mothurOut("[ERROR]: You have selected to use " + toString(metadata[0].size()) + " data rows from the metadata file, but " + toString(lookup.size()) + " from the shared file.\n"); m->control_pressed = true; error=true;}
252 //maybe add extra info here?? compare groups in each file??
256 //if the users enters label "0.06" and there is no "0.06" in their file use the next lowest label.
257 set<string> processedLabels;
258 set<string> userLabels = labels;
260 //as long as you are not at the end of the file or done wih the lines you want
261 while((lookup[0] != NULL) && ((allLines == 1) || (userLabels.size() != 0))) {
263 if (m->control_pressed) { delete input; return 0; }
265 if(allLines == 1 || labels.count(lookup[0]->getLabel()) == 1){
266 processedLabels.insert(lookup[0]->getLabel());
267 userLabels.erase(lookup[0]->getLabel());
269 m->mothurOut(lookup[0]->getLabel()); m->mothurOutEndLine();
273 if ((m->anyLabelsToProcess(lookup[0]->getLabel(), userLabels, "") == true) && (processedLabels.count(lastLabel) != 1)) {
274 string saveLabel = lookup[0]->getLabel();
276 for (int i = 0; i < lookup.size(); i++) { delete lookup[i]; }
277 lookup = input->getSharedRAbundVectors(lastLabel);
279 processedLabels.insert(lookup[0]->getLabel());
280 userLabels.erase(lookup[0]->getLabel());
282 //restore real lastlabel to save below
283 lookup[0]->setLabel(saveLabel);
285 m->mothurOut(lookup[0]->getLabel()); m->mothurOutEndLine();
289 lastLabel = lookup[0]->getLabel();
291 //get next line to process
292 //prevent memory leak
293 for (int i = 0; i < lookup.size(); i++) { delete lookup[i]; }
294 lookup = input->getSharedRAbundVectors();
298 if (m->control_pressed) { delete input; return 0; }
300 //output error messages about any remaining user labels
301 set<string>::iterator it;
302 bool needToRun = false;
303 for (it = userLabels.begin(); it != userLabels.end(); it++) {
304 m->mothurOut("Your file does not include the label " + *it);
305 if (processedLabels.count(lastLabel) != 1) {
306 m->mothurOut(". I will use " + lastLabel + "."); m->mothurOutEndLine();
309 m->mothurOut(". Please refer to " + lastLabel + "."); m->mothurOutEndLine();
313 //run last label if you need to
314 if (needToRun == true) {
315 for (int i = 0; i < lookup.size(); i++) { if (lookup[i] != NULL) { delete lookup[i]; } }
316 lookup = input->getSharedRAbundVectors(lastLabel);
318 m->mothurOut(lookup[0]->getLabel()); m->mothurOutEndLine();
326 catch(exception& e) {
327 m->errorOut(e, "OTUAssociationCommand", "processShared");
331 //**********************************************************************************************************************
332 int OTUAssociationCommand::process(vector<SharedRAbundVector*>& lookup){
335 string outputFileName = outputDir + m->getRootName(m->getSimpleName(inputFileName)) + lookup[0]->getLabel() + "." + method + "." + getOutputFileNameTag("otucorr");
336 outputNames.push_back(outputFileName); outputTypes["otucorr"].push_back(outputFileName);
339 m->openOutputFile(outputFileName, out);
340 out.setf(ios::fixed, ios::floatfield); out.setf(ios::showpoint);
343 if (metadatafile == "") { out << "OTUA\tOTUB\t" << method << "Coef\tSignificance\n"; }
344 else { out << "OTUA\tMetadata\t" << method << "Coef\tSignificance\n"; }
347 vector< vector<double> > xy; xy.resize(lookup[0]->getNumBins());
348 for (int i = 0; i < lookup[0]->getNumBins(); i++) { for (int j = 0; j < lookup.size(); j++) { xy[i].push_back(lookup[j]->getAbundance(i)); } }
350 LinearAlgebra linear;
351 if (metadatafile == "") {//compare otus
352 for (int i = 0; i < xy.size(); i++) {
354 for (int k = 0; k < i; k++) {
356 if (m->control_pressed) { out.close(); return 0; }
360 if (method == "spearman") { coef = linear.calcSpearman(xy[i], xy[k], sig); }
361 else if (method == "pearson") { coef = linear.calcPearson(xy[i], xy[k], sig); }
362 else if (method == "kendall") { coef = linear.calcKendall(xy[i], xy[k], sig); }
363 else { m->mothurOut("[ERROR]: invalid method, choices are spearman, pearson or kendall."); m->mothurOutEndLine(); m->control_pressed = true; }
365 if (sig < cutoff) { out << m->binLabelsInFile[i] << '\t' << m->binLabelsInFile[k] << '\t' << coef << '\t' << sig << endl; }
368 }else { //compare otus to metadata
369 for (int i = 0; i < xy.size(); i++) {
371 for (int k = 0; k < metadata.size(); k++) {
373 if (m->control_pressed) { out.close(); return 0; }
377 if (method == "spearman") { coef = linear.calcSpearman(xy[i], metadata[k], sig); }
378 else if (method == "pearson") { coef = linear.calcPearson(xy[i], metadata[k], sig); }
379 else if (method == "kendall") { coef = linear.calcKendall(xy[i], metadata[k], sig); }
380 else { m->mothurOut("[ERROR]: invalid method, choices are spearman, pearson or kendall."); m->mothurOutEndLine(); m->control_pressed = true; }
382 if (sig < cutoff) { out << m->binLabelsInFile[i] << '\t' << metadataLabels[k] << '\t' << coef << '\t' << sig << endl; }
393 catch(exception& e) {
394 m->errorOut(e, "OTUAssociationCommand", "process");
398 //**********************************************************************************************************************
399 int OTUAssociationCommand::processRelabund(){
401 InputData* input = new InputData(relabundfile, "relabund");
402 vector<SharedRAbundFloatVector*> lookup = input->getSharedRAbundFloatVectors();
403 string lastLabel = lookup[0]->getLabel();
405 if (metadatafile != "") {
408 if (metadata[0].size() != lookup.size()) { m->mothurOut("[ERROR]: You have selected to use " + toString(metadata[0].size()) + " data rows from the metadata file, but " + toString(lookup.size()) + " from the relabund file.\n"); m->control_pressed = true; error=true;}
410 //maybe add extra info here?? compare groups in each file??
416 //if the users enters label "0.06" and there is no "0.06" in their file use the next lowest label.
417 set<string> processedLabels;
418 set<string> userLabels = labels;
420 //as long as you are not at the end of the file or done wih the lines you want
421 while((lookup[0] != NULL) && ((allLines == 1) || (userLabels.size() != 0))) {
423 if (m->control_pressed) { delete input; return 0; }
425 if(allLines == 1 || labels.count(lookup[0]->getLabel()) == 1){
426 processedLabels.insert(lookup[0]->getLabel());
427 userLabels.erase(lookup[0]->getLabel());
429 m->mothurOut(lookup[0]->getLabel()); m->mothurOutEndLine();
433 if ((m->anyLabelsToProcess(lookup[0]->getLabel(), userLabels, "") == true) && (processedLabels.count(lastLabel) != 1)) {
434 string saveLabel = lookup[0]->getLabel();
436 for (int i = 0; i < lookup.size(); i++) { delete lookup[i]; }
437 lookup = input->getSharedRAbundFloatVectors(lastLabel);
439 processedLabels.insert(lookup[0]->getLabel());
440 userLabels.erase(lookup[0]->getLabel());
442 //restore real lastlabel to save below
443 lookup[0]->setLabel(saveLabel);
445 m->mothurOut(lookup[0]->getLabel()); m->mothurOutEndLine();
449 lastLabel = lookup[0]->getLabel();
451 //get next line to process
452 //prevent memory leak
453 for (int i = 0; i < lookup.size(); i++) { delete lookup[i]; }
454 lookup = input->getSharedRAbundFloatVectors();
458 if (m->control_pressed) { delete input; return 0; }
460 //output error messages about any remaining user labels
461 set<string>::iterator it;
462 bool needToRun = false;
463 for (it = userLabels.begin(); it != userLabels.end(); it++) {
464 m->mothurOut("Your file does not include the label " + *it);
465 if (processedLabels.count(lastLabel) != 1) {
466 m->mothurOut(". I will use " + lastLabel + "."); m->mothurOutEndLine();
469 m->mothurOut(". Please refer to " + lastLabel + "."); m->mothurOutEndLine();
473 //run last label if you need to
474 if (needToRun == true) {
475 for (int i = 0; i < lookup.size(); i++) { if (lookup[i] != NULL) { delete lookup[i]; } }
476 lookup = input->getSharedRAbundFloatVectors(lastLabel);
478 m->mothurOut(lookup[0]->getLabel()); m->mothurOutEndLine();
486 catch(exception& e) {
487 m->errorOut(e, "OTUAssociationCommand", "processRelabund");
491 //**********************************************************************************************************************
492 int OTUAssociationCommand::process(vector<SharedRAbundFloatVector*>& lookup){
495 string outputFileName = outputDir + m->getRootName(m->getSimpleName(inputFileName)) + lookup[0]->getLabel() + "." + method + "." + getOutputFileNameTag("otucorr");
496 outputNames.push_back(outputFileName); outputTypes["otucorr"].push_back(outputFileName);
499 m->openOutputFile(outputFileName, out);
500 out.setf(ios::fixed, ios::floatfield); out.setf(ios::showpoint);
503 if (metadatafile == "") { out << "OTUA\tOTUB\t" << method << "Coef\tSignificance\n"; }
504 else { out << "OTUA\tMetadata\t" << method << "Coef\tSignificance\n"; }
506 vector< vector<double> > xy; xy.resize(lookup[0]->getNumBins());
507 for (int i = 0; i < lookup[0]->getNumBins(); i++) { for (int j = 0; j < lookup.size(); j++) { xy[i].push_back(lookup[j]->getAbundance(i)); } }
509 LinearAlgebra linear;
510 if (metadatafile == "") {//compare otus
511 for (int i = 0; i < xy.size(); i++) {
513 for (int k = 0; k < i; k++) {
515 if (m->control_pressed) { out.close(); return 0; }
519 if (method == "spearman") { coef = linear.calcSpearman(xy[i], xy[k], sig); }
520 else if (method == "pearson") { coef = linear.calcPearson(xy[i], xy[k], sig); }
521 else if (method == "kendall") { coef = linear.calcKendall(xy[i], xy[k], sig); }
522 else { m->mothurOut("[ERROR]: invalid method, choices are spearman, pearson or kendall."); m->mothurOutEndLine(); m->control_pressed = true; }
524 if (sig < cutoff) { out << m->binLabelsInFile[i] << '\t' << m->binLabelsInFile[k] << '\t' << coef << '\t' << sig << endl; }
527 }else { //compare otus to metadata
528 for (int i = 0; i < xy.size(); i++) {
530 for (int k = 0; k < metadata.size(); k++) {
532 if (m->control_pressed) { out.close(); return 0; }
536 if (method == "spearman") { coef = linear.calcSpearman(xy[i], metadata[k], sig); }
537 else if (method == "pearson") { coef = linear.calcPearson(xy[i], metadata[k], sig); }
538 else if (method == "kendall") { coef = linear.calcKendall(xy[i], metadata[k], sig); }
539 else { m->mothurOut("[ERROR]: invalid method, choices are spearman, pearson or kendall."); m->mothurOutEndLine(); m->control_pressed = true; }
541 if (sig < cutoff) { out << m->binLabelsInFile[i] << '\t' << metadataLabels[k] << '\t' << coef << '\t' << sig << endl; }
552 catch(exception& e) {
553 m->errorOut(e, "OTUAssociationCommand", "process");
557 /*****************************************************************/
558 int OTUAssociationCommand::readMetadata(){
561 m->openInputFile(metadatafile, in);
563 string headerLine = m->getline(in); m->gobble(in);
564 istringstream iss (headerLine,istringstream::in);
566 //read the first label, because it refers to the groups
568 iss >> columnLabel; m->gobble(iss);
570 //save names of columns you are reading
572 iss >> columnLabel; m->gobble(iss);
573 metadataLabels.push_back(columnLabel);
575 int count = metadataLabels.size();
580 if (m->control_pressed) { in.close(); return 0; }
583 in >> group; m->gobble(in);
585 SharedRAbundFloatVector* tempLookup = new SharedRAbundFloatVector();
586 tempLookup->setGroup(group);
587 tempLookup->setLabel("1");
589 for (int i = 0; i < count; i++) {
592 tempLookup->push_back(temp, group);
595 metadataLookup.push_back(tempLookup);
603 catch(exception& e) {
604 m->errorOut(e, "OTUAssociationCommand", "readMetadata");
608 /*****************************************************************/
609 //eliminate groups user did not pick, remove zeroed out otus, fill metadata vector.
610 int OTUAssociationCommand::getMetadata(){
613 vector<string> mGroups = m->getGroups();
616 for (int i = 0; i < metadataLookup.size(); i++) {
617 //if this sharedrabund is not from a group the user wants then delete it.
618 if (!(m->inUsersGroups(metadataLookup[i]->getGroup(), mGroups))) {
619 delete metadataLookup[i]; metadataLookup[i] = NULL;
620 metadataLookup.erase(metadataLookup.begin()+i);
626 vector<SharedRAbundFloatVector*> newLookup;
627 for (int i = 0; i < metadataLookup.size(); i++) {
628 SharedRAbundFloatVector* temp = new SharedRAbundFloatVector();
629 temp->setLabel(metadataLookup[i]->getLabel());
630 temp->setGroup(metadataLookup[i]->getGroup());
631 newLookup.push_back(temp);
635 vector<string> newBinLabels;
636 for (int i = 0; i < metadataLookup[0]->getNumBins(); i++) {
637 if (m->control_pressed) { for (int j = 0; j < newLookup.size(); j++) { delete newLookup[j]; } return 0; }
639 //look at each sharedRabund and make sure they are not all zero
641 for (int j = 0; j < metadataLookup.size(); j++) {
642 if (metadataLookup[j]->getAbundance(i) != 0) { allZero = false; break; }
645 //if they are not all zero add this bin
647 for (int j = 0; j < metadataLookup.size(); j++) {
648 newLookup[j]->push_back(metadataLookup[j]->getAbundance(i), metadataLookup[j]->getGroup());
650 newBinLabels.push_back(metadataLabels[i]);
654 metadataLabels = newBinLabels;
656 for (int j = 0; j < metadataLookup.size(); j++) { delete metadataLookup[j]; }
657 metadataLookup.clear();
659 metadata.resize(newLookup[0]->getNumBins());
660 for (int i = 0; i < newLookup[0]->getNumBins(); i++) { for (int j = 0; j < newLookup.size(); j++) { metadata[i].push_back(newLookup[j]->getAbundance(i)); } }
662 for (int j = 0; j < newLookup.size(); j++) { delete newLookup[j]; }
666 catch(exception& e) {
667 m->errorOut(e, "OTUAssociationCommand", "getMetadata");
671 /*****************************************************************/