com.compomics.util.preferences

Class GenePreferences

java.lang.Object

com.compomics.util.preferences.GenePreferences

All Implemented Interfaces:

java.io.Serializable

public class GenePreferences
extends java.lang.Object
implements java.io.Serializable

Contains methods for downloading gene and GO mappings.

Author:

Harald Barsnes

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	GENE_MAPPING_FILE_SUFFIX The suffix to use for files containing gene mappings.
static java.lang.String	GENE_MAPPING_FOLDER The folder where gene mapping related info is stored.
static java.lang.String	GO_MAPPING_FILE_SUFFIX The suffix to use for files containing GO mappings.

Constructor Summary

Constructors

Constructor and Description
GenePreferences() Create a new GenePreferences object.
GenePreferences(GenePreferences genePreferences) Creates new gene preferences based on a GenePreferences object.

Method Summary

Methods

Modifier and Type	Method and Description
void	createDefaultGeneMappingFiles(java.io.File aEnsemblVersionsFile, java.io.File aGoDomainsFile, java.io.File aSpeciesFile, java.io.File aDefaultSpeciesGoMappingsFile, java.io.File aDefaultSpeciesGeneMappingFile) Insert the default gene mappings files.
void	downloadGeneMappings(java.lang.String ensemblType, java.lang.String ensemblSchemaName, java.lang.String selectedSpecies, java.lang.String ensemblVersion, WaitingHandler waitingHandler) Download the gene mappings.
boolean	downloadGoMappings(java.lang.String ensemblType, java.lang.String ensemblSchemaName, java.lang.String selectedSpecies, WaitingHandler waitingHandler) Download the GO mappings.
java.util.HashMap<java.lang.String,java.util.ArrayList<java.lang.String>>	getAllSpecies() Return the species lists.
java.util.HashMap<java.lang.String,java.util.HashMap<java.lang.String,java.lang.String>>	getAllSpeciesMap() Returns the species map.
java.lang.String	getCurrentSpecies() Returns the current species.
java.lang.String	getCurrentSpeciesType() Returns the current species type.
java.lang.String	getEnsemblDatabaseName(java.lang.String speciesName) Deprecated. use the one with the Ensembl type parameter instead
java.lang.String	getEnsemblDatabaseName(java.lang.String ensemblType, java.lang.String speciesName) Returns the Ensembl database name corresponding to a species name according to the speciesMap.
java.lang.String	getEnsemblSpeciesVersion(java.lang.String speciesName) Deprecated. use getEnsemblSpeciesVersion(String ensemblType, String speciesName) instead
java.lang.String	getEnsemblSpeciesVersion(java.lang.String ensemblType, java.lang.String speciesName) Returns the Ensembl version for the given species name.
java.lang.String	getEnsemblVersion(java.lang.String ensemblDatabase) Returns the Ensembl version corresponding to the given Ensembl database according to the ensemblVersionsMap.
java.util.HashMap<java.lang.String,java.lang.String>	getEnsemblVersionsMap() Returns the Ensembl versions map.
java.io.File	getGeneMappingFolder() Returns the path to the folder containing the gene mapping files.
java.util.HashMap<java.lang.String,java.lang.String>	getGoDomainMap() Returns the GO domain map, e.g., key: GO term: GO:0007568, element: biological_process.
static java.lang.String	getProteinEvidencAsString(java.lang.Integer type) Return the protein evidence type as text.
java.util.ArrayList<java.lang.String>	getSpecies() Deprecated. use getAllSpecies instead
java.util.HashMap<java.lang.String,java.lang.String>	getSpeciesMap() Deprecated. use getAllSpeciesMap instead
void	loadEnsemblSpeciesVersions(java.io.File ensemblVersionsFile) Loads the given Ensembl species file.
boolean	loadGeneMappings(java.lang.String jarFilePath, WaitingHandler waitingHandler) Imports the gene mappings.
void	loadSpeciesAndGoDomains() Load the mapping files.
void	setCurrentSpecies(java.lang.String currentSpecies) Set the current species.
void	setCurrentSpeciesType(java.lang.String currentSpeciesType) Set the current species type.
void	updateEnsemblVersion(java.lang.String selectedSpecies, java.lang.String ensemblVersion) Update the Ensembl version for the given species.

Methods inherited from class java.lang.Object

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

Field Detail

GENE_MAPPING_FOLDER

public static final java.lang.String GENE_MAPPING_FOLDER

The folder where gene mapping related info is stored.

GENE_MAPPING_FILE_SUFFIX

public static final java.lang.String GENE_MAPPING_FILE_SUFFIX

The suffix to use for files containing gene mappings.

See Also:

Constant Field Values

GO_MAPPING_FILE_SUFFIX

public static final java.lang.String GO_MAPPING_FILE_SUFFIX

The suffix to use for files containing GO mappings.

See Also:

Constant Field Values

Constructor Detail

GenePreferences

public GenePreferences()

Create a new GenePreferences object.

GenePreferences

public GenePreferences(GenePreferences genePreferences)

Creates new gene preferences based on a GenePreferences object.

Parameters:

genePreferences -

Method Detail

getProteinEvidencAsString

public static java.lang.String getProteinEvidencAsString(java.lang.Integer type)

Return the protein evidence type as text.

Parameters:

type - the type of evidence

Returns:

the protein evidence type as text

downloadGoMappings

public boolean downloadGoMappings(java.lang.String ensemblType,
                         java.lang.String ensemblSchemaName,
                         java.lang.String selectedSpecies,
                         WaitingHandler waitingHandler)
                           throws java.net.MalformedURLException,
                                  java.io.IOException

Download the GO mappings.

Parameters:

ensemblType - the Ensembl type, e.g., default or plants

ensemblSchemaName - the Ensembl schema name, e.g., default or plants_mart_18

selectedSpecies -

waitingHandler -

Returns:

true of the downloading was OK

Throws:

java.net.MalformedURLException

java.io.IOException

downloadGeneMappings

public void downloadGeneMappings(java.lang.String ensemblType,
                        java.lang.String ensemblSchemaName,
                        java.lang.String selectedSpecies,
                        java.lang.String ensemblVersion,
                        WaitingHandler waitingHandler)
                          throws java.net.MalformedURLException,
                                 java.io.IOException,
                                 java.lang.IllegalArgumentException

Download the gene mappings.

Parameters:

ensemblType - the Ensembl type, e.g., default or plants

ensemblSchemaName - the Ensembl schema name, e.g., default or plants_mart_18

selectedSpecies -

ensemblVersion -

waitingHandler -

Throws:

java.net.MalformedURLException

java.io.IOException

java.lang.IllegalArgumentException

getGeneMappingFolder

public java.io.File getGeneMappingFolder()

Returns the path to the folder containing the gene mapping files.

Returns:

the gene mapping folder

getCurrentSpecies

public java.lang.String getCurrentSpecies()

Returns the current species.

Returns:

the currentSpecies

setCurrentSpecies

public void setCurrentSpecies(java.lang.String currentSpecies)

Set the current species.

Parameters:

currentSpecies - the currentSpecies to set

getCurrentSpeciesType

public java.lang.String getCurrentSpeciesType()

Returns the current species type.

Returns:

the currentSpeciesType

setCurrentSpeciesType

public void setCurrentSpeciesType(java.lang.String currentSpeciesType)

Set the current species type.

Parameters:

currentSpeciesType - the currentSpeciesType to set

createDefaultGeneMappingFiles

public void createDefaultGeneMappingFiles(java.io.File aEnsemblVersionsFile,
                                 java.io.File aGoDomainsFile,
                                 java.io.File aSpeciesFile,
                                 java.io.File aDefaultSpeciesGoMappingsFile,
                                 java.io.File aDefaultSpeciesGeneMappingFile)

Insert the default gene mappings files. If newer versions of the mapping exists they will not be overwritten.

Parameters:

aEnsemblVersionsFile -

aGoDomainsFile -

aSpeciesFile -

aDefaultSpeciesGoMappingsFile -

aDefaultSpeciesGeneMappingFile -

loadSpeciesAndGoDomains

public void loadSpeciesAndGoDomains()
                             throws java.io.IOException,
                                    java.lang.IllegalArgumentException

Load the mapping files.

Throws:

java.io.IOException

java.lang.IllegalArgumentException

getGoDomainMap

public java.util.HashMap<java.lang.String,java.lang.String> getGoDomainMap()

Returns the GO domain map, e.g., key: GO term: GO:0007568, element: biological_process.

Returns:

the goDomainMap

getSpeciesMap

public java.util.HashMap<java.lang.String,java.lang.String> getSpeciesMap()

Deprecated. use getAllSpeciesMap instead

Returns the species map. Key: latin name, element: Ensembl database name, e.g., key: Homo sapiens, element: hsapiens.

Returns:

the speciesMap

getAllSpeciesMap

public java.util.HashMap<java.lang.String,java.util.HashMap<java.lang.String,java.lang.String>> getAllSpeciesMap()

Returns the species map. Main key: Ensembl type, e.g., Vertebrates or Plants. Next level: key: latin name, element: ensembl database name, e.g., key: Homo sapiens, element: hsapiens_gene_ensembl.

Returns:

the speciesMap

getEnsemblDatabaseName

public java.lang.String getEnsemblDatabaseName(java.lang.String speciesName)

Deprecated. use the one with the Ensembl type parameter instead

Returns the Ensembl database name corresponding to a species name according to the speciesMap. Null if not found.

Parameters:

speciesName - the species name as available in the species list

Returns:

the Ensembl database name

getEnsemblDatabaseName

public java.lang.String getEnsemblDatabaseName(java.lang.String ensemblType,
                                      java.lang.String speciesName)

Returns the Ensembl database name corresponding to a species name according to the speciesMap. Null if not found.

Parameters:

ensemblType - the Ensembl type, e.g., Vertebrates or Plants

speciesName - the species name as available in the species list

Returns:

the Ensembl database name

getEnsemblVersionsMap

public java.util.HashMap<java.lang.String,java.lang.String> getEnsemblVersionsMap()

Returns the Ensembl versions map.

Returns:

the ensemblVersionsMap

getEnsemblVersion

public java.lang.String getEnsemblVersion(java.lang.String ensemblDatabase)

Returns the Ensembl version corresponding to the given Ensembl database according to the ensemblVersionsMap. Null if not found.

Parameters:

ensemblDatabase - the Ensembl database

Returns:

the Ensembl version

getEnsemblSpeciesVersion

public java.lang.String getEnsemblSpeciesVersion(java.lang.String speciesName)

Deprecated. use getEnsemblSpeciesVersion(String ensemblType, String speciesName) instead

Returns the Ensembl version for the given species name. Null if not found.

Parameters:

speciesName - the species name as available in the species list

Returns:

the Ensembl version

getEnsemblSpeciesVersion

public java.lang.String getEnsemblSpeciesVersion(java.lang.String ensemblType,
                                        java.lang.String speciesName)

Returns the Ensembl version for the given species name. Null if not found.

Parameters:

ensemblType - the Ensembl type, e.g., Vertebrates or Plants

speciesName - the species name as available in the species list

Returns:

the Ensembl version

getSpecies

public java.util.ArrayList<java.lang.String> getSpecies()

Deprecated. use getAllSpecies instead

Return the species list. NB: also contains species separators.

Returns:

the species

getAllSpecies

public java.util.HashMap<java.lang.String,java.util.ArrayList<java.lang.String>> getAllSpecies()

Return the species lists.

Returns:

the species

updateEnsemblVersion

public void updateEnsemblVersion(java.lang.String selectedSpecies,
                        java.lang.String ensemblVersion)
                          throws java.io.IOException

Update the Ensembl version for the given species.

Parameters:

selectedSpecies - the database name of the species to update, e.g., hsapiens_gene_ensembl

ensemblVersion - the new Ensembl version

Throws:

java.io.IOException

loadEnsemblSpeciesVersions

public void loadEnsemblSpeciesVersions(java.io.File ensemblVersionsFile)
                                throws java.io.FileNotFoundException,
                                       java.io.IOException

Loads the given Ensembl species file.

Parameters:

ensemblVersionsFile - the Ensembl species file to load

Throws:

java.io.FileNotFoundException

java.io.IOException

loadGeneMappings

public boolean loadGeneMappings(java.lang.String jarFilePath,
                       WaitingHandler waitingHandler)

Imports the gene mappings.

Parameters:

jarFilePath - the jar file path

waitingHandler - the waiting handler

Returns:

a boolean indicating whether the loading was successful