2 // getotulabelscommand.cpp
5 // Created by Sarah Westcott on 5/21/12.
6 // Copyright (c) 2012 Schloss Lab. All rights reserved.
9 #include "getotulabelscommand.h"
11 //**********************************************************************************************************************
12 vector<string> GetOtuLabelsCommand::setParameters(){
14 CommandParameter paccnos("accnos", "InputTypes", "", "", "none", "none", "none","",false,true, true); parameters.push_back(paccnos);
15 CommandParameter pconstaxonomy("constaxonomy", "InputTypes", "", "", "none", "FNGLT", "none","constaxonomy",false,false, true); parameters.push_back(pconstaxonomy);
16 CommandParameter plist("list", "InputTypes", "", "", "none", "FNGLT", "none","list",false,false, true); parameters.push_back(plist);
17 CommandParameter pshared("shared", "InputTypes", "", "", "none", "FNGLT", "none","shared",false,false, true); parameters.push_back(pshared);
18 CommandParameter potucorr("otucorr", "InputTypes", "", "", "none", "FNGLT", "none","otucorr",false,false, true); parameters.push_back(potucorr);
19 CommandParameter pcorraxes("corraxes", "InputTypes", "", "", "none", "FNGLT", "none","corraxes",false,false, true); parameters.push_back(pcorraxes);
20 CommandParameter plabel("label", "String", "", "", "", "", "","",false,false); parameters.push_back(plabel);
21 CommandParameter pinputdir("inputdir", "String", "", "", "", "", "","",false,false); parameters.push_back(pinputdir);
22 CommandParameter poutputdir("outputdir", "String", "", "", "", "", "","",false,false); parameters.push_back(poutputdir);
24 vector<string> myArray;
25 for (int i = 0; i < parameters.size(); i++) { myArray.push_back(parameters[i].name); }
29 m->errorOut(e, "GetOtuLabelsCommand", "setParameters");
33 //**********************************************************************************************************************
34 string GetOtuLabelsCommand::getHelpString(){
36 string helpString = "";
37 helpString += "The get.otulabels command can be used to select specific otus with the output from classify.otu, otu.association, or corr.axes commands. It can also be used to select a set of otus from a shared or list file.\n";
38 helpString += "The get.otulabels parameters are: constaxonomy, otucorr, corraxes, shared, list, label and accnos.\n";
39 helpString += "The constaxonomy parameter is used to input the results of the classify.otu command.\n";
40 helpString += "The otucorr parameter is used to input the results of the otu.association command.\n";
41 helpString += "The corraxes parameter is used to input the results of the corr.axes command.\n";
42 helpString += "The label parameter is used to analyze specific labels in your input. \n";
43 helpString += "The get.otulabels commmand should be in the following format: \n";
44 helpString += "get.otulabels(accnos=yourListOfOTULabels, corraxes=yourCorrAxesFile)\n";
48 m->errorOut(e, "GetOtuLabelsCommand", "getHelpString");
52 //**********************************************************************************************************************
53 string GetOtuLabelsCommand::getOutputPattern(string type) {
57 if (type == "constaxonomy") { pattern = "[filename],pick,[extension]"; }
58 else if (type == "otucorr") { pattern = "[filename],pick,[extension]"; }
59 else if (type == "corraxes") { pattern = "[filename],pick,[extension]"; }
60 else if (type == "list") { pattern = "[filename],[distance],pick,[extension]"; }
61 else if (type == "shared") { pattern = "[filename],[distance],pick,[extension]"; }
62 else { m->mothurOut("[ERROR]: No definition for type " + type + " output pattern.\n"); m->control_pressed = true; }
67 m->errorOut(e, "GetOtuLabelsCommand", "getOutputPattern");
72 //**********************************************************************************************************************
73 GetOtuLabelsCommand::GetOtuLabelsCommand(){
75 abort = true; calledHelp = true;
77 vector<string> tempOutNames;
78 outputTypes["constaxonomy"] = tempOutNames;
79 outputTypes["otucorr"] = tempOutNames;
80 outputTypes["corraxes"] = tempOutNames;
81 outputTypes["shared"] = tempOutNames;
82 outputTypes["list"] = tempOutNames;
85 m->errorOut(e, "GetOtuLabelsCommand", "GetOtuLabelsCommand");
89 //**********************************************************************************************************************
90 GetOtuLabelsCommand::GetOtuLabelsCommand(string option) {
92 abort = false; calledHelp = false;
94 //allow user to run help
95 if(option == "help") { help(); abort = true; calledHelp = true; }
96 else if(option == "citation") { citation(); abort = true; calledHelp = true;}
99 //valid paramters for this command
100 vector<string> myArray = setParameters();
102 OptionParser parser(option);
103 map<string,string> parameters = parser.getParameters();
105 ValidParameters validParameter;
106 map<string,string>::iterator it;
107 //check to make sure all parameters are valid for command
108 for (it = parameters.begin(); it != parameters.end(); it++) {
109 if (validParameter.isValidParameter(it->first, myArray, it->second) != true) { abort = true; }
113 //if the user changes the input directory command factory will send this info to us in the output parameter
114 string inputDir = validParameter.validFile(parameters, "inputdir", false);
115 if (inputDir == "not found"){ inputDir = ""; }
118 //edit file types below to include only the types you added as parameters
121 it = parameters.find("constaxonomy");
122 //user has given a template file
123 if(it != parameters.end()){
124 path = m->hasPath(it->second);
125 //if the user has not given a path then, add inputdir. else leave path alone.
126 if (path == "") { parameters["constaxonomy"] = inputDir + it->second; }
129 it = parameters.find("accnos");
130 //user has given a template file
131 if(it != parameters.end()){
132 path = m->hasPath(it->second);
133 //if the user has not given a path then, add inputdir. else leave path alone.
134 if (path == "") { parameters["accnos"] = inputDir + it->second; }
137 it = parameters.find("corraxes");
138 //user has given a template file
139 if(it != parameters.end()){
140 path = m->hasPath(it->second);
141 //if the user has not given a path then, add inputdir. else leave path alone.
142 if (path == "") { parameters["corraxes"] = inputDir + it->second; }
145 it = parameters.find("otucorr");
146 //user has given a template file
147 if(it != parameters.end()){
148 path = m->hasPath(it->second);
149 //if the user has not given a path then, add inputdir. else leave path alone.
150 if (path == "") { parameters["otucorr"] = inputDir + it->second; }
153 it = parameters.find("list");
154 //user has given a template file
155 if(it != parameters.end()){
156 path = m->hasPath(it->second);
157 //if the user has not given a path then, add inputdir. else leave path alone.
158 if (path == "") { parameters["list"] = inputDir + it->second; }
161 it = parameters.find("shared");
162 //user has given a template file
163 if(it != parameters.end()){
164 path = m->hasPath(it->second);
165 //if the user has not given a path then, add inputdir. else leave path alone.
166 if (path == "") { parameters["shared"] = inputDir + it->second; }
170 vector<string> tempOutNames;
171 outputTypes["constaxonomy"] = tempOutNames;
172 outputTypes["otucorr"] = tempOutNames;
173 outputTypes["corraxes"] = tempOutNames;
174 outputTypes["shared"] = tempOutNames;
175 outputTypes["list"] = tempOutNames;
177 //check for parameters
178 accnosfile = validParameter.validFile(parameters, "accnos", true);
179 if (accnosfile == "not open") { abort = true; }
180 else if (accnosfile == "not found") {
181 accnosfile = m->getAccnosFile();
182 if (accnosfile != "") { m->mothurOut("Using " + accnosfile + " as input file for the accnos parameter."); m->mothurOutEndLine(); }
184 m->mothurOut("You have no valid accnos file and accnos is required."); m->mothurOutEndLine();
187 }else { m->setAccnosFile(accnosfile); }
189 constaxonomyfile = validParameter.validFile(parameters, "constaxonomy", true);
190 if (constaxonomyfile == "not open") { constaxonomyfile = ""; abort = true; }
191 else if (constaxonomyfile == "not found") { constaxonomyfile = ""; }
193 corraxesfile = validParameter.validFile(parameters, "corraxes", true);
194 if (corraxesfile == "not open") { corraxesfile = ""; abort = true; }
195 else if (corraxesfile == "not found") { corraxesfile = ""; }
197 otucorrfile = validParameter.validFile(parameters, "otucorr", true);
198 if (otucorrfile == "not open") { otucorrfile = ""; abort = true; }
199 else if (otucorrfile == "not found") { otucorrfile = ""; }
201 listfile = validParameter.validFile(parameters, "list", true);
202 if (listfile == "not open") { listfile = ""; abort = true; }
203 else if (listfile == "not found") { listfile = ""; }
204 else { m->setListFile(listfile); }
206 sharedfile = validParameter.validFile(parameters, "shared", true);
207 if (sharedfile == "not open") { sharedfile = ""; abort = true; }
208 else if (sharedfile == "not found") { sharedfile = ""; }
209 else { m->setSharedFile(sharedfile); }
211 //if the user changes the output directory command factory will send this info to us in the output parameter
212 outputDir = validParameter.validFile(parameters, "outputdir", false); if (outputDir == "not found"){ outputDir = ""; }
214 if ((constaxonomyfile == "") && (corraxesfile == "") && (otucorrfile == "") && (sharedfile == "") && (listfile == "")) { m->mothurOut("You must provide one of the following: constaxonomy, corraxes, otucorr, shared or list."); m->mothurOutEndLine(); abort = true; }
216 if ((sharedfile != "") || (listfile != "")) {
217 label = validParameter.validFile(parameters, "label", false);
218 if (label == "not found") { label = ""; m->mothurOut("You did not provide a label, I will use the first label in your inputfile."); m->mothurOutEndLine(); label=""; }
223 catch(exception& e) {
224 m->errorOut(e, "GetOtuLabelsCommand", "GetOtuLabelsCommand");
228 //**********************************************************************************************************************
230 int GetOtuLabelsCommand::execute(){
233 if (abort == true) { if (calledHelp) { return 0; } return 2; }
235 //get labels you want to keep
236 labels = m->readAccnos(accnosfile);
238 set<string> newLabels;
239 for (set<string>::iterator it = labels.begin(); it != labels.end(); it++) { newLabels.insert(m->getSimpleLabel(*it)); }
242 if (m->control_pressed) { return 0; }
244 //read through the correct file and output lines you want to keep
245 if (constaxonomyfile != "") { readClassifyOtu(); }
246 if (corraxesfile != "") { readCorrAxes(); }
247 if (otucorrfile != "") { readOtuAssociation(); }
248 if (listfile != "") { readList(); }
249 if (sharedfile != "") { readShared(); }
251 if (m->control_pressed) { for (int i = 0; i < outputNames.size(); i++) { m->mothurRemove(outputNames[i]); } return 0; }
253 //output files created by command
254 m->mothurOutEndLine();
255 m->mothurOut("Output File Names: "); m->mothurOutEndLine();
256 for (int i = 0; i < outputNames.size(); i++) { m->mothurOut(outputNames[i]); m->mothurOutEndLine(); }
257 m->mothurOutEndLine();
260 itTypes = outputTypes.find("list");
261 if (itTypes != outputTypes.end()) {
262 if ((itTypes->second).size() != 0) { current = (itTypes->second)[0]; m->setListFile(current); }
265 itTypes = outputTypes.find("shared");
266 if (itTypes != outputTypes.end()) {
267 if ((itTypes->second).size() != 0) { current = (itTypes->second)[0]; m->setSharedFile(current); }
272 catch(exception& e) {
273 m->errorOut(e, "GetOtuLabelsCommand", "execute");
277 //**********************************************************************************************************************
278 int GetOtuLabelsCommand::readClassifyOtu(){
280 string thisOutputDir = outputDir;
281 if (outputDir == "") { thisOutputDir += m->hasPath(constaxonomyfile); }
282 map<string, string> variables;
283 variables["[filename]"] = thisOutputDir + m->getRootName(m->getSimpleName(constaxonomyfile));
284 variables["[extension]"] = m->getExtension(constaxonomyfile);
285 string outputFileName = getOutputFileName("constaxonomy", variables);
288 m->openOutputFile(outputFileName, out);
291 m->openInputFile(constaxonomyfile, in);
293 bool wroteSomething = false;
294 int selectedCount = 0;
297 string headers = m->getline(in);
298 out << headers << endl;
302 if (m->control_pressed) { break; }
304 string otu = ""; string tax = "unknown";
307 in >> otu >> size >> tax; m->gobble(in);
309 if (labels.count(m->getSimpleLabel(otu)) != 0) {
310 wroteSomething = true;
313 out << otu << '\t' << size << '\t' << tax << endl;
319 if (wroteSomething == false) { m->mothurOut("Your file does not contain any labels from the .accnos file."); m->mothurOutEndLine(); }
320 outputNames.push_back(outputFileName); outputTypes["constaxonomy"].push_back(outputFileName);
322 m->mothurOut("Selected " + toString(selectedCount) + " otus from your constaxonomy file."); m->mothurOutEndLine();
327 catch(exception& e) {
328 m->errorOut(e, "GetOtuLabelsCommand", "readClassifyOtu");
332 //**********************************************************************************************************************
333 int GetOtuLabelsCommand::readOtuAssociation(){
335 string thisOutputDir = outputDir;
336 if (outputDir == "") { thisOutputDir += m->hasPath(otucorrfile); }
337 map<string, string> variables;
338 variables["[filename]"] = thisOutputDir + m->getRootName(m->getSimpleName(otucorrfile));
339 variables["[extension]"] = m->getExtension(otucorrfile);
340 string outputFileName = getOutputFileName("otucorr", variables);
343 m->openOutputFile(outputFileName, out);
346 m->openInputFile(otucorrfile, in);
348 bool wroteSomething = false;
349 int selectedCount = 0;
352 string headers = m->getline(in);
353 out << headers << endl;
357 if (m->control_pressed) { break; }
362 string line = m->getline(in); m->gobble(in);
364 if ((labels.count(m->getSimpleLabel(otu1)) != 0) && (labels.count(m->getSimpleLabel(otu2)) != 0)){
365 wroteSomething = true;
368 out << otu1 << '\t' << otu2 << '\t' << line << endl;
374 if (wroteSomething == false) { m->mothurOut("Your file does not contain any labels from the .accnos file."); m->mothurOutEndLine(); }
375 outputNames.push_back(outputFileName); outputTypes["otucorr"].push_back(outputFileName);
377 m->mothurOut("Selected " + toString(selectedCount) + " lines from your otu.corr file."); m->mothurOutEndLine();
382 catch(exception& e) {
383 m->errorOut(e, "GetOtuLabelsCommand", "readOtuAssociation");
387 //**********************************************************************************************************************
388 int GetOtuLabelsCommand::readCorrAxes(){
390 string thisOutputDir = outputDir;
391 if (outputDir == "") { thisOutputDir += m->hasPath(corraxesfile); }
392 map<string, string> variables;
393 variables["[filename]"] = thisOutputDir + m->getRootName(m->getSimpleName(corraxesfile));
394 variables["[extension]"] = m->getExtension(corraxesfile);
395 string outputFileName = getOutputFileName("corraxes", variables);
398 m->openOutputFile(outputFileName, out);
402 m->openInputFile(corraxesfile, in);
404 bool wroteSomething = false;
405 int selectedCount = 0;
408 string headers = m->getline(in);
409 out << headers << endl;
413 if (m->control_pressed) { break; }
417 string line = m->getline(in); m->gobble(in);
419 if (labels.count(m->getSimpleLabel(otu)) != 0) {
420 wroteSomething = true;
423 out << otu << '\t' << line << endl;
429 if (wroteSomething == false) { m->mothurOut("Your file does not contain any labels from the .accnos file."); m->mothurOutEndLine(); }
430 outputNames.push_back(outputFileName); outputTypes["corraxes"].push_back(outputFileName);
432 m->mothurOut("Selected " + toString(selectedCount) + " lines from your corr.axes file."); m->mothurOutEndLine();
437 catch(exception& e) {
438 m->errorOut(e, "GetOtuLabelsCommand", "readCorrAxes");
442 //**********************************************************************************************************************
443 int GetOtuLabelsCommand::readShared(){
448 if (m->control_pressed) { for (int i = 0; i < lookup.size(); i++) { delete lookup[i]; } return 0; }
450 vector<string> newLabels;
452 //create new "filtered" lookup
453 vector<SharedRAbundVector*> newLookup;
454 for (int i = 0; i < lookup.size(); i++) {
455 SharedRAbundVector* temp = new SharedRAbundVector();
456 temp->setLabel(lookup[i]->getLabel());
457 temp->setGroup(lookup[i]->getGroup());
458 newLookup.push_back(temp);
461 bool wroteSomething = false;
463 for (int i = 0; i < lookup[0]->getNumBins(); i++) {
465 if (m->control_pressed) { for (int j = 0; j < newLookup.size(); j++) { delete newLookup[j]; } for (int j = 0; j < lookup.size(); j++) { delete lookup[j]; } return 0; }
467 //is this otu on the list
468 if (labels.count(m->getSimpleLabel(m->currentSharedBinLabels[i])) != 0) {
469 numSelected++; wroteSomething = true;
470 newLabels.push_back(m->currentSharedBinLabels[i]);
471 for (int j = 0; j < newLookup.size(); j++) { //add this OTU to the new lookup
472 newLookup[j]->push_back(lookup[j]->getAbundance(i), lookup[j]->getGroup());
477 string thisOutputDir = outputDir;
478 if (outputDir == "") { thisOutputDir += m->hasPath(sharedfile); }
479 map<string, string> variables;
480 variables["[filename]"] = thisOutputDir + m->getRootName(m->getSimpleName(sharedfile));
481 variables["[extension]"] = m->getExtension(sharedfile);
482 variables["[distance]"] = lookup[0]->getLabel();
483 string outputFileName = getOutputFileName("shared", variables);
485 m->openOutputFile(outputFileName, out);
486 outputTypes["shared"].push_back(outputFileName); outputNames.push_back(outputFileName);
488 for (int j = 0; j < lookup.size(); j++) { delete lookup[j]; }
490 m->currentSharedBinLabels = newLabels;
492 newLookup[0]->printHeaders(out);
494 for (int i = 0; i < newLookup.size(); i++) {
495 out << newLookup[i]->getLabel() << '\t' << newLookup[i]->getGroup() << '\t';
496 newLookup[i]->print(out);
500 for (int j = 0; j < newLookup.size(); j++) { delete newLookup[j]; }
502 if (wroteSomething == false) { m->mothurOut("Your file does not contain any OTUs from the .accnos file."); m->mothurOutEndLine(); }
504 m->mothurOut("Selected " + toString(numSelected) + " OTUs from your shared file."); m->mothurOutEndLine();
508 catch(exception& e) {
509 m->errorOut(e, "GetOtuLabelsCommand", "readShared");
513 //**********************************************************************************************************************
514 int GetOtuLabelsCommand::readList(){
518 if (m->control_pressed) { delete list; return 0;}
521 newList.setLabel(list->getLabel());
522 int selectedCount = 0;
523 bool wroteSomething = false;
525 vector<string> binLabels = list->getLabels();
526 vector<string> newLabels;
527 for (int i = 0; i < list->getNumBins(); i++) {
529 if (m->control_pressed) { delete list; return 0;}
531 if (labels.count(m->getSimpleLabel(binLabels[i])) != 0) {
533 newList.push_back(list->get(i));
534 newLabels.push_back(binLabels[i]);
538 string thisOutputDir = outputDir;
539 if (outputDir == "") { thisOutputDir += m->hasPath(listfile); }
540 map<string, string> variables;
541 variables["[filename]"] = thisOutputDir + m->getRootName(m->getSimpleName(listfile));
542 variables["[extension]"] = m->getExtension(listfile);
543 variables["[distance]"] = list->getLabel();
544 string outputFileName = getOutputFileName("list", variables);
546 m->openOutputFile(outputFileName, out);
549 //print new listvector
550 if (newList.getNumBins() != 0) {
551 wroteSomething = true;
552 newList.setLabels(newLabels);
553 newList.printHeaders(out);
558 if (wroteSomething == false) { m->mothurOut("Your file does not contain any OTUs from the .accnos file."); m->mothurOutEndLine(); }
559 outputNames.push_back(outputFileName); outputTypes["list"].push_back(outputFileName);
561 m->mothurOut("Selected " + toString(selectedCount) + " OTUs from your list file."); m->mothurOutEndLine();
565 catch(exception& e) {
566 m->errorOut(e, "GetOtuLabelsCommand", "readList");
570 //**********************************************************************************************************************
571 int GetOtuLabelsCommand::getListVector(){
573 InputData input(listfile, "list");
574 list = input.getListVector();
575 string lastLabel = list->getLabel();
577 if (label == "") { label = lastLabel; return 0; }
579 //if the users enters label "0.06" and there is no "0.06" in their file use the next lowest label.
580 set<string> labels; labels.insert(label);
581 set<string> processedLabels;
582 set<string> userLabels = labels;
584 //as long as you are not at the end of the file or done wih the lines you want
585 while((list != NULL) && (userLabels.size() != 0)) {
586 if (m->control_pressed) { return 0; }
588 if(labels.count(list->getLabel()) == 1){
589 processedLabels.insert(list->getLabel());
590 userLabels.erase(list->getLabel());
594 if ((m->anyLabelsToProcess(list->getLabel(), userLabels, "") == true) && (processedLabels.count(lastLabel) != 1)) {
595 string saveLabel = list->getLabel();
598 list = input.getListVector(lastLabel);
600 processedLabels.insert(list->getLabel());
601 userLabels.erase(list->getLabel());
603 //restore real lastlabel to save below
604 list->setLabel(saveLabel);
608 lastLabel = list->getLabel();
610 //get next line to process
611 //prevent memory leak
613 list = input.getListVector();
617 if (m->control_pressed) { return 0; }
619 //output error messages about any remaining user labels
620 set<string>::iterator it;
621 bool needToRun = false;
622 for (it = userLabels.begin(); it != userLabels.end(); it++) {
623 m->mothurOut("Your file does not include the label " + *it);
624 if (processedLabels.count(lastLabel) != 1) {
625 m->mothurOut(". I will use " + lastLabel + "."); m->mothurOutEndLine();
628 m->mothurOut(". Please refer to " + lastLabel + "."); m->mothurOutEndLine();
632 //run last label if you need to
633 if (needToRun == true) {
635 list = input.getListVector(lastLabel);
640 catch(exception& e) {
641 m->errorOut(e, "GetOtuLabelsCommand", "getListVector");
645 //**********************************************************************************************************************
646 int GetOtuLabelsCommand::getShared(){
648 InputData input(sharedfile, "sharedfile");
649 lookup = input.getSharedRAbundVectors();
650 string lastLabel = lookup[0]->getLabel();
652 if (label == "") { label = lastLabel; return 0; }
654 //if the users enters label "0.06" and there is no "0.06" in their file use the next lowest label.
655 set<string> labels; labels.insert(label);
656 set<string> processedLabels;
657 set<string> userLabels = labels;
659 //as long as you are not at the end of the file or done wih the lines you want
660 while((lookup[0] != NULL) && (userLabels.size() != 0)) {
661 if (m->control_pressed) { return 0; }
663 if(labels.count(lookup[0]->getLabel()) == 1){
664 processedLabels.insert(lookup[0]->getLabel());
665 userLabels.erase(lookup[0]->getLabel());
669 if ((m->anyLabelsToProcess(lookup[0]->getLabel(), userLabels, "") == true) && (processedLabels.count(lastLabel) != 1)) {
670 string saveLabel = lookup[0]->getLabel();
672 for (int i = 0; i < lookup.size(); i++) { delete lookup[i]; }
673 lookup = input.getSharedRAbundVectors(lastLabel);
675 processedLabels.insert(lookup[0]->getLabel());
676 userLabels.erase(lookup[0]->getLabel());
678 //restore real lastlabel to save below
679 lookup[0]->setLabel(saveLabel);
683 lastLabel = lookup[0]->getLabel();
685 //get next line to process
686 //prevent memory leak
687 for (int i = 0; i < lookup.size(); i++) { delete lookup[i]; }
688 lookup = input.getSharedRAbundVectors();
692 if (m->control_pressed) { return 0; }
694 //output error messages about any remaining user labels
695 set<string>::iterator it;
696 bool needToRun = false;
697 for (it = userLabels.begin(); it != userLabels.end(); it++) {
698 m->mothurOut("Your file does not include the label " + *it);
699 if (processedLabels.count(lastLabel) != 1) {
700 m->mothurOut(". I will use " + lastLabel + "."); m->mothurOutEndLine();
703 m->mothurOut(". Please refer to " + lastLabel + "."); m->mothurOutEndLine();
707 //run last label if you need to
708 if (needToRun == true) {
709 for (int i = 0; i < lookup.size(); i++) { if (lookup[i] != NULL) { delete lookup[i]; } }
710 lookup = input.getSharedRAbundVectors(lastLabel);
715 catch(exception& e) {
716 m->errorOut(e, "GetOtuLabelsCommand", "getShared");
720 //**********************************************************************************************************************