Package ubic.gemma.persistence.service.expression.bioAssayData

Interface ProcessedExpressionDataVectorService

All Superinterfaces:

BaseReadOnlyService<ProcessedExpressionDataVector>

All Known Implementing Classes:

ProcessedExpressionDataVectorServiceImpl

public interface ProcessedExpressionDataVectorService

Author:

Paul

Method Summary

Modifier and Type	Method	Description
int	computeProcessedExpressionData(ExpressionExperiment ee)	Create processed vectors and update ranks.
int	computeProcessedExpressionData(ExpressionExperiment ee, boolean ignoreQuantitationMismatch)	Create processed vectors and update ranks.
int	createProcessedDataVectors(ExpressionExperiment expressionExperiment)
int	createProcessedDataVectors(ExpressionExperiment expressionExperiment, boolean ignoreQuantitationMismatch)
Collection<T>	find(Collection<QuantitationType> quantitationTypes)	Find specific type (DesignElementDataVectorService) of vectors that meet the given criteria.
Collection<T>	find(QuantitationType quantitationType)	Find specific type (DesignElementDataVectorService) of vectors that meet the given criteria.
Collection<T>	find(BioAssayDimension bioAssayDimension)	Find specific type (raw or processed, depending on the service) of vectors that meet the given criteria.
Collection<T>	findAndThaw(Collection<QuantitationType> quantitationTypes)
Collection<T>	findAndThaw(QuantitationType quantitationType)	Find and thaw specific type (DesignElementDataVectorService) of vectors that meet the given criteria.
Collection<T>	findAndThaw(BioAssayDimension bioAssayDimension)
List<DoubleVectorValueObject>	getDiffExVectors(Long resultSetId, double threshold, int maxNumberOfResults)
List<ExperimentExpressionLevelsValueObject>	getExpressionLevels(Collection<ExpressionExperiment> ees, Collection<Gene> genes, boolean keepGeneNonSpecific, String consolidateMode)
List<ExperimentExpressionLevelsValueObject>	getExpressionLevelsByIds(Collection<Long> datasetIds, Collection<Gene> genes, boolean keepNonSpecific, String consolidationMode)	Retrieve expression levels by dataset IDs.
List<ExperimentExpressionLevelsValueObject>	getExpressionLevelsDiffEx(Collection<ExpressionExperiment> ees, Long diffExResultSetId, double threshold, int max, boolean keepGeneNonSpecific, String consolidateMode)
List<ExperimentExpressionLevelsValueObject>	getExpressionLevelsPca(Collection<ExpressionExperiment> ees, int threshold, int component, boolean keepGeneNonSpecific, String consolidateMode)
Collection<DoubleVectorValueObject>	getProcessedDataArrays(Collection<ExpressionExperiment> expressionExperiments, Collection<Long> genes)
Collection<DoubleVectorValueObject>	getProcessedDataArrays(BioAssaySet bioAssaySet, Collection<Long> genes)
Collection<DoubleVectorValueObject>	getProcessedDataArrays(ExpressionExperiment expressionExperiment)
Collection<DoubleVectorValueObject>	getProcessedDataArraysByProbe(Collection<ExpressionExperiment> expressionExperiments, Collection<CompositeSequence> compositeSequences)
Collection<ProcessedExpressionDataVector>	getProcessedDataVectors(ExpressionExperiment expressionExperiment)
Collection<ProcessedExpressionDataVector>	getProcessedDataVectorsAndThaw(ExpressionExperiment expressionExperiment)	Retrieve and thaw a collection of vectors for a given experiment.
Collection<DoubleVectorValueObject>	getRandomProcessedDataArrays(ExpressionExperiment ee, int limit)
Map<ExpressionExperiment,Map<Gene,Collection<Double>>>	getRanks(Collection<ExpressionExperiment> expressionExperiments, Collection<Gene> genes, ProcessedExpressionDataVectorDao.RankMethod method)
void	reorderByDesign(ExpressionExperiment ee)	Creates new bioAssayDimensions to match the experimental design, reorders the data to match, updates.
int	replaceProcessedDataVectors(ExpressionExperiment ee, Collection<ProcessedExpressionDataVector> vectors)	Replace the processed vectors of a EE with the given vectors.
Collection<T>	thaw(Collection<T> vectors)	Deprecated. Use findAndThaw(QuantitationType), findAndThaw(Collection) or findAndThaw(BioAssayDimension) instead, it's much more efficient.
void	updateRanks(ExpressionExperiment ee)	Update the ranks of the processed vectors for the given experiment.

Methods inherited from interface ubic.gemma.persistence.service.BaseReadOnlyService

countAll, find, findOrFail, getElementClass, load, load, loadAll, loadOrFail, loadOrFail, loadOrFail, loadOrFail

Method Detail

createProcessedDataVectors

@Secured({"GROUP_USER","ACL_SECURABLE_EDIT"})
int createProcessedDataVectors(ExpressionExperiment expressionExperiment)

See Also:

ProcessedExpressionDataVectorDao.createProcessedDataVectors(ExpressionExperiment, boolean)

createProcessedDataVectors

@Secured({"GROUP_USER","ACL_SECURABLE_EDIT"})
int createProcessedDataVectors(ExpressionExperiment expressionExperiment,
                               boolean ignoreQuantitationMismatch)
                        throws QuantitationMismatchException

Throws:

QuantitationMismatchException

See Also:

ProcessedExpressionDataVectorDao.createProcessedDataVectors(ExpressionExperiment, boolean)

computeProcessedExpressionData

@Secured({"GROUP_USER","ACL_SECURABLE_EDIT"})
int computeProcessedExpressionData(ExpressionExperiment ee)

Create processed vectors and update ranks.

Mismatch between quantitation type and data is ignored.

See Also:

createProcessedDataVectors(ExpressionExperiment), updateRanks(ExpressionExperiment)

computeProcessedExpressionData

@Secured({"GROUP_USER","ACL_SECURABLE_EDIT"})
int computeProcessedExpressionData(ExpressionExperiment ee,
                                   boolean ignoreQuantitationMismatch)
                            throws QuantitationMismatchException

Create processed vectors and update ranks.

Throws:

QuantitationMismatchException

See Also:

createProcessedDataVectors(ExpressionExperiment, boolean), updateRanks(ExpressionExperiment)

replaceProcessedDataVectors

@Secured({"GROUP_USER","ACL_SECURABLE_EDIT"})
int replaceProcessedDataVectors(ExpressionExperiment ee,
                                Collection<ProcessedExpressionDataVector> vectors)

Replace the processed vectors of a EE with the given vectors.

Ranks are recomputed.

Parameters:

ee - ee

vectors - non-persistent, all of the same quantitationtype

reorderByDesign

@Secured({"GROUP_USER","ACL_SECURABLE_EDIT"})
void reorderByDesign(ExpressionExperiment ee)

Creates new bioAssayDimensions to match the experimental design, reorders the data to match, updates.

updateRanks

@Secured({"GROUP_USER","ACL_SECURABLE_EDIT"})
void updateRanks(ExpressionExperiment ee)

Update the ranks of the processed vectors for the given experiment.

getExpressionLevels

@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_COLLECTION_READ"})
List<ExperimentExpressionLevelsValueObject> getExpressionLevels(Collection<ExpressionExperiment> ees,
                                                                Collection<Gene> genes,
                                                                boolean keepGeneNonSpecific,
                                                                @Nullable
                                                                String consolidateMode)

Parameters:

ees - expressionExperiments

genes - genes

consolidateMode - how to consolidate the vectors when there is more than one

keepGeneNonSpecific - whether to keep vectors that are not specific to the gene

Returns:

value objects containing structured information about the expression levels of given genes

getExpressionLevelsByIds

@Secured("IS_AUTHENTICATED_ANONYMOUSLY")
List<ExperimentExpressionLevelsValueObject> getExpressionLevelsByIds(Collection<Long> datasetIds,
                                                                     Collection<Gene> genes,
                                                                     boolean keepNonSpecific,
                                                                     @Nullable
                                                                     String consolidationMode)

Retrieve expression levels by dataset IDs.

See Also:

getExpressionLevels(Collection, Collection, boolean, String)

getExpressionLevelsPca

@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_COLLECTION_READ"})
List<ExperimentExpressionLevelsValueObject> getExpressionLevelsPca(Collection<ExpressionExperiment> ees,
                                                                   int threshold,
                                                                   int component,
                                                                   boolean keepGeneNonSpecific,
                                                                   @Nullable
                                                                   String consolidateMode)

Parameters:

ees - expressionExperiments

component - the principal component

threshold - threshold

consolidateMode - how to consolidate the vectors when there is more than one

keepGeneNonSpecific - whether to keep vectors that are not specific to the gene

Returns:

value objects containing structured information about the expression levels of genes highly loaded in the given principal component.

getExpressionLevelsDiffEx

@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_COLLECTION_READ"})
List<ExperimentExpressionLevelsValueObject> getExpressionLevelsDiffEx(Collection<ExpressionExperiment> ees,
                                                                      Long diffExResultSetId,
                                                                      double threshold,
                                                                      int max,
                                                                      boolean keepGeneNonSpecific,
                                                                      @Nullable
                                                                      String consolidateMode)

Parameters:

diffExResultSetId - the differential expression result set to access

threshold - threshold

consolidateMode - how to consolidate the vectors when there is more than one

keepGeneNonSpecific - whether to keep vectors that are not specific to the gene

ees - ees

max - max level

Returns:

value objects containing structured information about the expression levels of genes highly loaded in the given principal component.

getProcessedDataArrays

@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_COLLECTION_READ"})
Collection<DoubleVectorValueObject> getProcessedDataArrays(Collection<ExpressionExperiment> expressionExperiments,
                                                           Collection<Long> genes)

See Also:

CachedProcessedExpressionDataVectorService.getProcessedDataArrays(Collection, Collection)

getProcessedDataArrays

@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"})
Collection<DoubleVectorValueObject> getProcessedDataArrays(BioAssaySet bioAssaySet,
                                                           Collection<Long> genes)

See Also:

CachedProcessedExpressionDataVectorService.getProcessedDataArrays(BioAssaySet, Collection)

getProcessedDataArrays

@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"})
Collection<DoubleVectorValueObject> getProcessedDataArrays(ExpressionExperiment expressionExperiment)

See Also:

CachedProcessedExpressionDataVectorService.getProcessedDataArrays(BioAssaySet)

getRandomProcessedDataArrays

@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"})
Collection<DoubleVectorValueObject> getRandomProcessedDataArrays(ExpressionExperiment ee,
                                                                 int limit)

See Also:

CachedProcessedExpressionDataVectorService.getRandomProcessedDataArrays(BioAssaySet, int)

getProcessedDataArraysByProbe

@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_COLLECTION_READ"})
Collection<DoubleVectorValueObject> getProcessedDataArraysByProbe(Collection<ExpressionExperiment> expressionExperiments,
                                                                  Collection<CompositeSequence> compositeSequences)

See Also:

CachedProcessedExpressionDataVectorService.getProcessedDataArraysByProbe(Collection, Collection)

getProcessedDataVectors

@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"})
Collection<ProcessedExpressionDataVector> getProcessedDataVectors(ExpressionExperiment expressionExperiment)

See Also:

ProcessedExpressionDataVectorDao.getProcessedVectors(ExpressionExperiment)

getProcessedDataVectorsAndThaw

@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"})
Collection<ProcessedExpressionDataVector> getProcessedDataVectorsAndThaw(ExpressionExperiment expressionExperiment)

Retrieve and thaw a collection of vectors for a given experiment.

See Also:

ProcessedExpressionDataVectorDao.getProcessedVectors(ExpressionExperiment), DesignElementDataVectorDao.thaw(Collection)

getRanks

@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_COLLECTION_READ"})
Map<ExpressionExperiment,Map<Gene,Collection<Double>>> getRanks(Collection<ExpressionExperiment> expressionExperiments,
                                                                            Collection<Gene> genes,
                                                                            ProcessedExpressionDataVectorDao.RankMethod method)

See Also:

ProcessedExpressionDataVectorDao.getRanks(ExpressionExperiment, Collection, ProcessedExpressionDataVectorDao.RankMethod)

getDiffExVectors

List<DoubleVectorValueObject> getDiffExVectors(Long resultSetId,
                                               double threshold,
                                               int maxNumberOfResults)

find

@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_DATAVECTOR_COLLECTION_READ"})
Collection<T> find(BioAssayDimension bioAssayDimension)

Find specific type (raw or processed, depending on the service) of vectors that meet the given criteria.

Parameters:

bioAssayDimension - the BA dimension

Returns:

the found vectors of type DesignElementDataVectorService

findAndThaw

@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_DATAVECTOR_COLLECTION_READ"})
Collection<T> findAndThaw(BioAssayDimension bioAssayDimension)

find

@Secured("GROUP_ADMIN")
Collection<T> find(Collection<QuantitationType> quantitationTypes)

Find specific type (DesignElementDataVectorService) of vectors that meet the given criteria.

Parameters:

quantitationTypes - the QTs

Returns:

the found vectors of type DesignElementDataVectorService

findAndThaw

@Secured("GROUP_ADMIN")
Collection<T> findAndThaw(Collection<QuantitationType> quantitationTypes)

find

@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_DATAVECTOR_COLLECTION_READ"})
Collection<T> find(QuantitationType quantitationType)

Find specific type (DesignElementDataVectorService) of vectors that meet the given criteria.

Parameters:

quantitationType - the QT

Returns:

the found vectors of type DesignElementDataVectorService

findAndThaw

@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_DATAVECTOR_COLLECTION_READ"})
Collection<T> findAndThaw(QuantitationType quantitationType)

Find and thaw specific type (DesignElementDataVectorService) of vectors that meet the given criteria.

thaw

@CheckReturnValue
@Deprecated
Collection<T> thaw(Collection<T> vectors)

Deprecated.

Use findAndThaw(QuantitationType), findAndThaw(Collection) or findAndThaw(BioAssayDimension) instead, it's much more efficient.

Thaw the given vectors.