biolockj.module.classifier.wgs

Class Metaphlan2Classifier

java.lang.Object

biolockj.module.BioModuleImpl

biolockj.module.ScriptModuleImpl

biolockj.module.SeqModuleImpl

biolockj.module.classifier.ClassifierModuleImpl

biolockj.module.classifier.wgs.Metaphlan2Classifier

All Implemented Interfaces:

BioModule, ClassifierModule, DatabaseModule, ScriptModule, SeqModule, Comparable<BioModule>

public class Metaphlan2Classifier
extends ClassifierModuleImpl

This BioModule builds the bash scripts used to execute metaphlan2.py to classify WGS sequences with MetaPhlAn2.

GUI Module Name

MetaPhlAn2 Classifier

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	EXE_METAPHLAN Config exe property used to obtain the metaphlan2 executable
protected static String	EXE_METAPHLAN_PARAMS Config List property used to obtain the metaphlan2 executable params
protected static String	METAPHLAN2_DB Config Directory property containing alternate database: "metaphlan2.db" Must always be paired with "metaphlan2.mpa_pkl"
protected static String	METAPHLAN2_MPA_PKL Config File property containing path to the mpa_pkl file used to reference an alternate DB "metaphlan2.mpa_pkl" Must always be paired with "metaphlan2.db"

Fields inherited from class biolockj.module.BioModuleImpl

GZIP_EXT, LOG_EXT, PDF_EXT, RETURN, SH_EXT, TAB_DELIM, TSV_EXT, TXT_EXT

Fields inherited from interface biolockj.module.ScriptModule

SCRIPT_BATCH_SIZE, SCRIPT_DEFAULT_HEADER, SCRIPT_NUM_THREADS, SCRIPT_PERMISSIONS, SCRIPT_TIMEOUT

Fields inherited from interface biolockj.module.BioModule

MAIN_SCRIPT_PREFIX, OUTPUT_DIR, TEMP_DIR

Constructor Summary

Constructors

Constructor and Description
Metaphlan2Classifier()

Method Summary

Modifier and Type	Method and Description
List<List<String>>	buildScript(List<File> files) Build bash script lines to classify unpaired WGS reads with Metaphlan.
List<List<String>>	buildScriptForPairedReads(List<File> files) Build bash script lines to classify paired WGS reads with Metaphlan.
void	checkDependencies() Verify none of the derived command line parameters are included in Config."exe.metaphlan2""Params"
String	getClassifierExe() Metaphlan runs python scripts, so no special command is required
List<String>	getClassifierParams() Obtain the metaphlan2 runtime params
File	getDB() Return database directory, if multiple databases are configured, they must share a common parent directory and the common parent directory is returned by this method.
protected String	getParams() Metaphlan queries require standard parameters: --input_type, --nproc, -t Verify no invalid runtime params are passed and add rankSwitch if needed. Set the rankSwitch based on the Config."report.taxonomyLevels" if only one taxonomy level is to be reported, otherwise report all levels.
List<String>	getWorkerScriptFunctions() Method returns bash script lines used to build the functions called by the worker scripts.

Methods inherited from class biolockj.module.classifier.ClassifierModuleImpl

getClassifierType, getPostRequisiteModules, getSummary, validateModuleOrder

Methods inherited from class biolockj.module.SeqModuleImpl

getInputFiles, getSeqFiles, isValidInputModule

Methods inherited from class biolockj.module.ScriptModuleImpl

executeTask, getJobParams, getMainScript, getRuntimeParams, getScriptDir, getScriptErrors, getTimeout, hasScripts

Methods inherited from class biolockj.module.BioModuleImpl

cacheInputFiles, cleanUp, compareTo, equals, findModuleInputFiles, getFileCache, getID, getModuleDir, getOutputDir, getPreRequisiteModules, getTempDir, init, toString, validateFileNameUnique

Methods inherited from class java.lang.Object

clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface biolockj.module.SeqModule

getSeqFiles

Methods inherited from interface biolockj.module.ScriptModule

getJobParams, getMainScript, getScriptDir, getScriptErrors, getTimeout

Methods inherited from interface biolockj.module.BioModule

cleanUp, executeTask, getID, getInputFiles, getModuleDir, getOutputDir, getPreRequisiteModules, getTempDir, init, isValidInputModule

Field Detail

EXE_METAPHLAN

protected static final String EXE_METAPHLAN

Config exe property used to obtain the metaphlan2 executable

See Also:

Constant Field Values

EXE_METAPHLAN_PARAMS

protected static final String EXE_METAPHLAN_PARAMS

Config List property used to obtain the metaphlan2 executable params

See Also:

Constant Field Values

METAPHLAN2_DB

protected static final String METAPHLAN2_DB

Config Directory property containing alternate database: "metaphlan2.db"
Must always be paired with "metaphlan2.mpa_pkl"

See Also:

Constant Field Values

METAPHLAN2_MPA_PKL

protected static final String METAPHLAN2_MPA_PKL

Config File property containing path to the mpa_pkl file used to reference an alternate DB "metaphlan2.mpa_pkl"
Must always be paired with "metaphlan2.db"

See Also:

Constant Field Values

Constructor Detail

Metaphlan2Classifier

public Metaphlan2Classifier()

Method Detail

buildScript

public List<List<String>> buildScript(List<File> files)
                               throws Exception

Build bash script lines to classify unpaired WGS reads with Metaphlan. The inner list contains 1 bash script line per sample.

Example line:
python /app/metaphlan2.py --nproc 8 -t rel_ab_w_read_stats --input_type fasta ./input/sample42.fasta --bowtie2out ./temp/sample42.bowtie2.bz2 > ./output/sample42_reported.tsv

Specified by:

buildScript in interface ScriptModule

Specified by:

buildScript in class ScriptModuleImpl

Parameters:

files - Files in the input directory that contain only forward reads

Returns:

Nested list of bash scripts lines

Throws:

Exception - if unable to generate script lines

buildScriptForPairedReads

public List<List<String>> buildScriptForPairedReads(List<File> files)
                                             throws Exception

Build bash script lines to classify paired WGS reads with Metaphlan. The inner list contains 1 bash script line per sample.

Example line:
python /app/metaphlan2.py --nproc 8 -t rel_ab_w_read_stats --input_type fasta ./input/sample42_R1.fasta, ./input/sample42_R2.fasta --bowtie2out ./temp/sample42.bowtie2.bz2 > ./output/sample42_reported.tsv

Specified by:

buildScriptForPairedReads in interface ScriptModule

Overrides:

buildScriptForPairedReads in class ScriptModuleImpl

Parameters:

files - Files in the input directory that contain only paired reads

Returns:

Nested list of bash scripts lines

Throws:

Exception - if unable to generate the script lines

checkDependencies

public void checkDependencies()
                       throws Exception

Verify none of the derived command line parameters are included in Config."exe.metaphlan2""Params"

Specified by:

checkDependencies in interface BioModule

Overrides:

checkDependencies in class ClassifierModuleImpl

Throws:

Exception - thrown if missing or invalid dependencies are found

getClassifierExe

public String getClassifierExe()
                        throws Exception

Metaphlan runs python scripts, so no special command is required

Specified by:

getClassifierExe in interface ClassifierModule

Specified by:

getClassifierExe in class ClassifierModuleImpl

Returns:

Command to execute classifier program

Throws:

Exception - if the classifier program undefined or invalid

getClassifierParams

public List<String> getClassifierParams()
                                 throws Exception

Obtain the metaphlan2 runtime params

Specified by:

getClassifierParams in interface ClassifierModule

Specified by:

getClassifierParams in class ClassifierModuleImpl

Returns:

Runtime parameters

Throws:

Exception - thrown if parameters defined are invalid

getDB

public File getDB()
           throws Exception

Description copied from interface: DatabaseModule

Return database directory, if multiple databases are configured, they must share a common parent directory and the common parent directory is returned by this method.

Specified by:

getDB in interface DatabaseModule

Specified by:

getDB in class ClassifierModuleImpl

Returns:

Database directory

Throws:

Exception - thrown if any runtime error occurs

getWorkerScriptFunctions

public List<String> getWorkerScriptFunctions()
                                      throws Exception

Description copied from interface: ScriptModule

Method returns bash script lines used to build the functions called by the worker scripts.

Specified by:

getWorkerScriptFunctions in interface ScriptModule

Overrides:

getWorkerScriptFunctions in class ScriptModuleImpl

Returns:

Bash script lines for the functions

Throws:

Exception - if errors occur

getParams

protected String getParams()
                    throws Exception

Metaphlan queries require standard parameters: --input_type, --nproc, -t
Verify no invalid runtime params are passed and add rankSwitch if needed.
Set the rankSwitch based on the Config."report.taxonomyLevels" if only one taxonomy level is to be reported, otherwise report all levels.

Returns:

runtime parameters

Throws:

Exception - if errors occur