biolockj.util

Class MetaUtil

java.lang.Object

biolockj.util.MetaUtil

public class MetaUtil
extends Object

This utility is used to read, modify, or create a metadata file for the sequence data. The 1st row must hold the Sample ID and column names must be unique. Metadata information is cached in this class for quick access throughout the application.

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	DEFAULT_COL_DELIM Default column delimiter = tab character
protected static String	DEFAULT_COMMENT_CHAR Default comment character for any new metadata file created by a BioModule: ""
protected static String	DEFAULT_NULL_VALUE Default field value to represent null-value: "NA"
static String	META_BARCODE_COLUMN Config property "metadata.barcodeColumn" defines metadata column with identifying barcode
static String	META_COLUMN_DELIM Config property that defines how metadata columns are separated: "metadata.columnDelim" Typically files are tab or comma separated.
static String	META_COMMENT_CHAR Config property to set metadata file comment indicator: "metadata.commentChar" Empty string is a valid option indicating no comments in metadata file
static String	META_FILE_PATH Config String property: "metadata.filePath" If absolute file path, use file as metadata. If directory path, must find exactly 1 file within, to use as metadata.
static String	META_FILENAME_COLUMN Config property "metadata.fileNameColumn" defines metadata column with input file names
static String	META_NULL_VALUE Config property to set metadata file empty cell: "metadata.nullValue"
static String	META_REQUIRED Config Boolean property: "metadata.required" If Y, require metadata row for each sample with sequence data in "input.dirPaths". If N, samples without metadata are ignored.
static String	USE_EVERY_ROW Config Boolean property: "metadata.useEveryRow" If Y, require a sequence file for every SampleID (every row) in "metadata.filePath". If N, metadata can include extraneous SampleIDs.

Method Summary

Modifier and Type	Method and Description
static void	addColumn(String colName, Map<String,String> map, File fileDir, boolean removeMissingIds) Adds a column to the metadata file.
static boolean	exists() Determine if metadata file exists
static boolean	fieldValuesAreUnique(String field, boolean ignoreNulls) Determine if the given field has only unique values.
static String	getField(String sampleId, String field) Get metadata field value for given sampleId.
static List<String>	getFieldNames() Get a list of all metadata fields (metadata file column names except the 1st).
static List<String>	getFieldValues(String field, boolean ignoreNulls) Get metadata column for given field name.
static String	getFileName() Get the metadata file name, if it exists, otherwise return projectName.tsv
static String	getForcedColumnName(String name) Used to generate a guaranteed to be unique column name.
static String	getID() Get the metadata file ID column name.
static String	getLatestColumnName(String name) Returns the latest version of the given column.
static File	getMetadata() Metadata file getter.
static String	getPath() Return the metadata file path
static List<String>	getRecord(String sampleId) Get metadata row for a given Sample ID.
static List<String>	getSampleIds() Get the first column from the metadata file.
static String	getSystemMetaCol(BioModule module, String col) Return a system generated metadata column name based on the module status.
static Set<String>	getUniqueFieldValues(String field, boolean ignoreNulls) Count the number of unique values in the given field.
static boolean	hasColumn(String columnName) Check if columnName exists in the current metadata file.
static void	initialize() Check dependencies used to handle the metadata file are defined and unique.
static void	refreshCache() Refresh the metadata cache.
static void	removeColumn(String colName, File fileDir) Remove the metadata column from the metadata file
static void	setFile(File file) Set a new metadata file.

Methods inherited from class java.lang.Object

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

Field Detail

META_BARCODE_COLUMN

public static final String META_BARCODE_COLUMN

Config property "metadata.barcodeColumn" defines metadata column with identifying barcode

See Also:

Constant Field Values

META_COLUMN_DELIM

public static final String META_COLUMN_DELIM

Config property that defines how metadata columns are separated: "metadata.columnDelim" Typically files are tab or comma separated.

See Also:

Constant Field Values

META_COMMENT_CHAR

public static final String META_COMMENT_CHAR

Config property to set metadata file comment indicator: "metadata.commentChar"
Empty string is a valid option indicating no comments in metadata file

See Also:

Constant Field Values

META_FILE_PATH

public static final String META_FILE_PATH

Config String property: "metadata.filePath"
If absolute file path, use file as metadata.
If directory path, must find exactly 1 file within, to use as metadata.

See Also:

Constant Field Values

META_FILENAME_COLUMN

public static final String META_FILENAME_COLUMN

Config property "metadata.fileNameColumn" defines metadata column with input file names

See Also:

Constant Field Values

META_NULL_VALUE

public static final String META_NULL_VALUE

Config property to set metadata file empty cell: "metadata.nullValue"

See Also:

Constant Field Values

META_REQUIRED

public static final String META_REQUIRED

Config Boolean property: "metadata.required"
If Y, require metadata row for each sample with sequence data in "input.dirPaths".
If N, samples without metadata are ignored.

See Also:

Constant Field Values

USE_EVERY_ROW

public static final String USE_EVERY_ROW

Config Boolean property: "metadata.useEveryRow"
If Y, require a sequence file for every SampleID (every row) in "metadata.filePath".
If N, metadata can include extraneous SampleIDs.

See Also:

Constant Field Values

DEFAULT_COL_DELIM

protected static final String DEFAULT_COL_DELIM

Default column delimiter = tab character

See Also:

Constant Field Values

DEFAULT_COMMENT_CHAR

protected static final String DEFAULT_COMMENT_CHAR

Default comment character for any new metadata file created by a BioModule: ""

See Also:

Constant Field Values

DEFAULT_NULL_VALUE

protected static final String DEFAULT_NULL_VALUE

Default field value to represent null-value: "NA"

See Also:

Constant Field Values

Method Detail

addColumn

public static void addColumn(String colName,
                             Map<String,String> map,
                             File fileDir,
                             boolean removeMissingIds)
                      throws Exception

Adds a column to the metadata file. The updated metadata file is output to the fileDir. Once the new file is created, the new file is cached in memory and used as the new metadata.

Parameters:

colName - Name of new column

map - Map relates Sample ID to a field value

fileDir - File representing output directory for new metadata file

removeMissingIds - if TRUE, sampleIds not include in the map param will be removed from the metadata

Throws:

Exception - if unable to add the new column

exists

public static boolean exists()
                      throws Exception

Determine if metadata file exists

Returns:

TRUE if metadata exists

Throws:

Exception - if error occurs trying to read metadata file

fieldValuesAreUnique

public static boolean fieldValuesAreUnique(String field,
                                           boolean ignoreNulls)
                                    throws Exception

Determine if the given field has only unique values.

Parameters:

field - Metadata column

ignoreNulls - if TRUE ignore duplicate "metadata.nullValue" values

Returns:

boolean if field values are unique

Throws:

Exception - if runtime errors occur

getField

public static String getField(String sampleId,
                              String field)
                       throws Exception

Get metadata field value for given sampleId.

Parameters:

sampleId - Sample ID

field - Field Name (column name in metadata file)

Returns:

Metadata field value

Throws:

Exception - if parameters are invalid

getFieldNames

public static List<String> getFieldNames()
                                  throws Exception

Get a list of all metadata fields (metadata file column names except the 1st).

Returns:

List of metadata column names, excluding the 1st column

Throws:

Exception - if unable to read metadata file

getFieldValues

public static List<String> getFieldValues(String field,
                                          boolean ignoreNulls)
                                   throws Exception

Get metadata column for given field name.

Parameters:

field - Column name

ignoreNulls - if TRUE ignore duplicate "metadata.nullValue" values

Returns:

List of Column values for sample ID

Throws:

Exception - if metadata file or column name not found

getFileName

public static String getFileName()

Get the metadata file name, if it exists, otherwise return projectName.tsv

Returns:

Name of metadata file, or a default name if no metadata file exists #throws Exception if errors occur

getForcedColumnName

public static String getForcedColumnName(String name)
                                  throws Exception

Used to generate a guaranteed to be unique column name. If parameter "name" already exists, this will return name_1, or name_2, etc until an unused column name is found. If a column already exists, but contains only Config."metadata.nullValue" values, return the name of that empty column to overwrite.

Parameters:

name - Base column name

Returns:

Column name

Throws:

Exception - if errors occur

getID

public static String getID()

Get the metadata file ID column name. This value may change as updates are made by BioModules.

Returns:

Metadata ID column name

getLatestColumnName

public static String getLatestColumnName(String name)
                                  throws Exception

Returns the latest version of the given column.

Parameters:

name - Base column name

Returns:

column name

Throws:

Exception - if errors occur

getMetadata

public static File getMetadata()
                        throws Exception

Metadata file getter. This path changes as new versions are created by the BioModules.

Returns:

Metadata file

Throws:

Exception - if any errors occur

getPath

public static String getPath()

Return the metadata file path

Returns:

String the metadata file path

getRecord

public static List<String> getRecord(String sampleId)
                              throws Exception

Get metadata row for a given Sample ID.

Parameters:

sampleId - Sample ID

Returns:

Metadata row values for sample ID

Throws:

Exception - if Sample ID not found or metadata file doesn't exist

getSampleIds

public static List<String> getSampleIds()

Get the first column from the metadata file.

Returns:

Sample IDs found in metadata file

getSystemMetaCol

public static String getSystemMetaCol(BioModule module,
                                      String col)
                               throws Exception

Return a system generated metadata column name based on the module status.

Parameters:

module - BioModule

col - Column name

Returns:

Metadata column name

Throws:

Exception - if errors occur

getUniqueFieldValues

public static Set<String> getUniqueFieldValues(String field,
                                               boolean ignoreNulls)
                                        throws Exception

Count the number of unique values in the given field.

Parameters:

field - Column header

ignoreNulls - if TRUE ignore duplicate "metadata.nullValue" values

Returns:

Number of unique values

Throws:

Exception - if errors occur

hasColumn

public static boolean hasColumn(String columnName)

Check if columnName exists in the current metadata file.

Parameters:

columnName - Column name

Returns:

TRUE if columnName exists in hearder row of metadata file

initialize

public static void initialize()
                       throws Exception

Check dependencies used to handle the metadata file are defined and unique. For undefined properties we set the same default values as used by the R{utils} read.table() function.

• "metadata.columnDelim" column separator
• "metadata.commentChar" indicates start of comment in a cell, Requires length == 1
• "metadata.nullValue" indicates null cell

Throws:

Exception - if invalid Config properties are detected

refreshCache

public static void refreshCache()
                         throws Exception

Refresh the metadata cache.

Throws:

Exception - if unable to refresh cache

removeColumn

public static void removeColumn(String colName,
                                File fileDir)
                         throws Exception

Remove the metadata column from the metadata file

Parameters:

colName - Name of column to remove

fileDir - File representing output directory for new metadata file

Throws:

Exception - if errors occur

setFile

public static void setFile(File file)
                    throws Exception

Set a new metadata file.

Parameters:

file - New metadata file

Throws:

Exception - if null parameter is passed