biolockj.module.report.r

Class R_CalculateStats

java.lang.Object

biolockj.module.BioModuleImpl

biolockj.module.ScriptModuleImpl

biolockj.module.report.r.R_Module

biolockj.module.report.r.R_CalculateStats

All Implemented Interfaces:

BioModule, ScriptModule, Comparable<BioModule>

public class R_CalculateStats
extends R_Module

This BioModule is used to build the R script used to generate taxonomy statistics and plots.

GUI Module Name

R Statistics Calculator

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	ADJ_PVAL_ATTRIBUTE This "r_CalculateStats.pAdjustMethod" option can be set in Config file: "ATTRIBUTE"
protected static String	ADJ_PVAL_GLOBAL This "r_CalculateStats.pAdjustMethod" option can be set in Config file: "GLOBAL"
protected static String	ADJ_PVAL_LOCAL This "r_CalculateStats.pAdjustMethod" option can be set in Config file: "LOCAL"
protected static String	ADJ_PVAL_TAXA This "r_CalculateStats.pAdjustMethod" option can be set in Config file: "TAXA"
protected static String	P_VALS_NP Non parametric p-value identifier: "nonParametricPvals"
protected static String	P_VALS_NP_ADJ Non parametric adjusted p-value identifier: "adjNonParPvals"
protected static String	P_VALS_PAR Parametric p-value identifier: "parametricPvals"
protected static String	P_VALS_PAR_ADJ Parametric adjusted p-value identifier: "adjParPvals"
protected static String	R_ADJ_PVALS_SCOPE Config String property: "r_CalculateStats.pAdjustScope" defines R p.adjust( n ) parameter.
protected static String	R_PVAL_ADJ_METHOD Config String property: "r_CalculateStats.pAdjustMethod" defines p.adjust( method ) parameter.
protected static String	R_SQUARED_VALS R^2 identifier: "rSquaredVals"

Fields inherited from class biolockj.module.report.r.R_Module

EXE_RSCRIPT, P_VAL_CUTOFF, R_COLOR_BASE, R_COLOR_HIGHLIGHT, R_COLOR_PALETTE, R_COLOR_POINT, R_DEBUG, R_FUNCTION_LIB, R_MAIN_SCRIPT, R_PCH, R_RARE_OTU_THRESHOLD, R_SAVE_R_DATA, R_TIMEOUT

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
R_CalculateStats()

Method Summary

Modifier and Type	Method and Description
void	checkDependencies() Validate configuration file properties used to build the R report: super.checkDependencies() Require "r_CalculateStats.pAdjustScope" Require "r_CalculateStats.pAdjustMethod"
static File	getStatsFile(BioModule module, String level, Boolean isParametric, Boolean isAdjusted) Get the stats file for the given fileType and taxonomy level.
static String	getSuffix(Boolean isParametric, Boolean isAdjusted) Get the file name suffix used to specify types of statistics.
static boolean	isStatsFile(File file) Analyze file name for key strings to determine if file is a stats file output by this module.

Methods inherited from class biolockj.module.report.r.R_Module

buildDockerBashScript, buildScript, executeTask, getJobParams, getMainR, getMetaMergedModule, getModuleScript, getPreRequisiteModules, getPrimaryScript, getRTemplateDir, getStatPreReqs, getSummary, getTimeout, getWorkerScriptFunctions, writeNewScript, writePrimaryScript, writeScript

Methods inherited from class biolockj.module.ScriptModuleImpl

buildScriptForPairedReads, getMainScript, getRuntimeParams, getScriptDir, getScriptErrors, hasScripts

Methods inherited from class biolockj.module.BioModuleImpl

cacheInputFiles, cleanUp, compareTo, equals, findModuleInputFiles, getFileCache, getID, getInputFiles, getModuleDir, getOutputDir, getPostRequisiteModules, getTempDir, init, isValidInputModule, toString, validateFileNameUnique

Methods inherited from class java.lang.Object

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

Methods inherited from interface biolockj.module.BioModule

cleanUp, getID, getInputFiles, getModuleDir, getOutputDir, getPostRequisiteModules, getTempDir, init, isValidInputModule

Field Detail

ADJ_PVAL_ATTRIBUTE

protected static final String ADJ_PVAL_ATTRIBUTE

This "r_CalculateStats.pAdjustMethod" option can be set in Config file: "ATTRIBUTE"

See Also:

Constant Field Values

ADJ_PVAL_GLOBAL

protected static final String ADJ_PVAL_GLOBAL

This "r_CalculateStats.pAdjustMethod" option can be set in Config file: "GLOBAL"

See Also:

Constant Field Values

ADJ_PVAL_LOCAL

protected static final String ADJ_PVAL_LOCAL

This "r_CalculateStats.pAdjustMethod" option can be set in Config file: "LOCAL"

See Also:

Constant Field Values

ADJ_PVAL_TAXA

protected static final String ADJ_PVAL_TAXA

This "r_CalculateStats.pAdjustMethod" option can be set in Config file: "TAXA"

See Also:

Constant Field Values

P_VALS_NP

protected static final String P_VALS_NP

Non parametric p-value identifier: "nonParametricPvals"

See Also:

Constant Field Values

P_VALS_NP_ADJ

protected static final String P_VALS_NP_ADJ

Non parametric adjusted p-value identifier: "adjNonParPvals"

See Also:

Constant Field Values

P_VALS_PAR

protected static final String P_VALS_PAR

Parametric p-value identifier: "parametricPvals"

See Also:

Constant Field Values

P_VALS_PAR_ADJ

protected static final String P_VALS_PAR_ADJ

Parametric adjusted p-value identifier: "adjParPvals"

See Also:

Constant Field Values

R_ADJ_PVALS_SCOPE

protected static final String R_ADJ_PVALS_SCOPE

Config String property: "r_CalculateStats.pAdjustScope" defines R p.adjust( n ) parameter. There are 4 supported options:

1. "GLOBAL" n = number of all pVal tests for all fields and all taxonomy levels
2. "ATTRIBUTE" n = number of all pVal tests for 1 field at all taxonomy levels
3. "TAXA" n = number of all pVal tests for all fields at 1 taxonomy level
4. "LOCAL" n = number of all pVal tests for 1 field at 1 taxonomy level

See Also:

Constant Field Values

R_PVAL_ADJ_METHOD

protected static final String R_PVAL_ADJ_METHOD

Config String property: "r_CalculateStats.pAdjustMethod" defines p.adjust( method ) parameter. p.adjust.methods = c("holm", "hochberg", "hommel", "bonferroni", "BH", "BY", "fdr", "none")

See Also:

Constant Field Values

R_SQUARED_VALS

protected static final String R_SQUARED_VALS

R^2 identifier: "rSquaredVals"

See Also:

Constant Field Values

Constructor Detail

R_CalculateStats

public R_CalculateStats()

Method Detail

checkDependencies

public void checkDependencies()
                       throws Exception

Validate configuration file properties used to build the R report:

• super.checkDependencies()
• Require "r_CalculateStats.pAdjustScope"
• Require "r_CalculateStats.pAdjustMethod"

Specified by:

checkDependencies in interface BioModule

Overrides:

checkDependencies in class R_Module

Throws:

Exception - thrown if missing or invalid dependencies are found

getStatsFile

public static File getStatsFile(BioModule module,
                                String level,
                                Boolean isParametric,
                                Boolean isAdjusted)
                         throws Exception

Get the stats file for the given fileType and taxonomy level.

Parameters:

module - Calling module

level - Taxonomy level

isParametric - Boolean TRUE to query for parametric file

isAdjusted - Boolean TRUE to query for adjusted p-value file

Returns:

File Table of statistics or null

Throws:

Exception - if errors occur

getSuffix

public static String getSuffix(Boolean isParametric,
                               Boolean isAdjusted)
                        throws Exception

Get the file name suffix used to specify types of statistics.

Parameters:

isParametric - boolean get the Parametric rather than the non-parametric suffix. If null, get the r-squared suffix.

isAdjusted - boolean get the adjusted rather than the non-adjusted suffix

Returns:

file name suffix

Throws:

Exception - if errors occur

isStatsFile

public static boolean isStatsFile(File file)

Analyze file name for key strings to determine if file is a stats file output by this module.

Parameters:

file - Ambiguous file

Returns:

TRUE if file name is formatted as if output by this module