Interface ExpressionExperimentService
- All Superinterfaces:
BaseImmutableService<ExpressionExperiment>,BaseReadOnlyService<ExpressionExperiment>,BaseService<ExpressionExperiment>,BaseVoEnabledService<ExpressionExperiment,,ExpressionExperimentValueObject> FilteringService<ExpressionExperiment>,FilteringVoEnabledService<ExpressionExperiment,,ExpressionExperimentValueObject> SecurableBaseImmutableService<ExpressionExperiment>,SecurableBaseReadOnlyService<ExpressionExperiment>,SecurableBaseService<ExpressionExperiment>,SecurableBaseVoEnabledService<ExpressionExperiment,,ExpressionExperimentValueObject> SecurableFilteringVoEnabledService<ExpressionExperiment,ExpressionExperimentValueObject>
- All Known Implementing Classes:
ExpressionExperimentServiceImpl
- Author:
- kelsey
-
Nested Class Summary
Nested ClassesModifier and TypeInterfaceDescriptionstatic final class -
Field Summary
Fields -
Method Summary
Modifier and TypeMethodDescriptionvoidWill add the vocab characteristic to the expression experiment and persist the changes.addFactor(ExpressionExperiment ee, ExperimentalFactor factor) voidIntended with the case of a continuous factor being added.intaddRawDataVectors(ExpressionExperiment eeToUpdate, QuantitationType quantitationType, Collection<RawExpressionDataVector> newVectors) Used when we want to add data for a quantitation type.Applyproposedas the experiment's newExperimentalDesign.browse(int start, int limit) longcountBioMaterials(Filters filters) longcountWithCache(Filters filters, Set<Long> extraIds) Count the number of experiments that match the given filters.intcreateProcessedDataVectors(ExpressionExperiment ee, Collection<ProcessedExpressionDataVector> vectors) Create a new set of processed vectors for an experiment.booleanexistsByShortName(String datasetShortName) Check if a dataset with a given short name.returns ids of search results.filterByTaxon(Collection<Long> ids, Taxon taxon) Remove IDs of Experiments that are not from the given taxon.findByAccession(String accession) findByAccession(DatabaseEntry accession) findByBioAssay(BioAssay ba, boolean includeSubSets) findByBioMaterial(BioMaterial bm, boolean includeSubSets) findByBioMaterials(Collection<BioMaterial> biomaterials) findByDesignId(Long designId) findByExpressedGene(Gene gene, double rank) findByFactor(ExperimentalFactor factor) findByFactors(Collection<ExperimentalFactor> factors) findByFactorValue(FactorValue factorValue) findByFactorValueId(Long factorValueId) findByFactorValueIds(Collection<Long> factorValueIds) findByFactorValues(Collection<FactorValue> factorValues) findByGene(Gene gene) findByName(String name) findByShortName(String shortName) findByShortNameAndThawLite(String shortName) findByShortNameWithPrimaryPublication(String shortName) findByTaxon(Taxon taxon) findByUpdatedLimit(int limit) findIdByBioAssay(BioAssay ba, boolean b) findIdByDesign(ExperimentalDesign design) findIdByFactor(ExperimentalFactor factor) findIdByFactorValue(FactorValue factor) findIdsByBioMaterial(BioMaterial bm, boolean includeSubSets) findOneByAccession(String accession) findOneByName(String name) findUpdatedAfter(Date date) Retrieve annotations for a given experiment.Retrieve annotations for a given experiment subset.getAnnotationsUsageFrequency(Filters filters, Set<Long> extraIds, String category, Collection<String> excludedCategoryUris, Collection<String> excludedTermUris, int minFrequency, Collection<String> retainedTermUris, int maxResults, boolean includePredicates, boolean includeObjects, long timeout, TimeUnit timeUnit) Obtain annotation usage frequency for datasets matching the given filters.getArrayDesignsUsed(ExpressionExperiment expressionExperiment) Obtain a collection ofArrayDesignused by a specific set of vectors.getArrayDesignsUsed(ExpressionExperiment ee, QuantitationType qt, Class<? extends DataVector> vectorType) Obtain a collection ofArrayDesignused by a specific set of vectors.getArrayDesignUsedOrOriginalPlatformUsageFrequency(Filters filters, Set<Long> extraIds, int maxResults) Calculate the usage frequency of platforms by the datasets matching the provided filters.Obtain the dimension associated to the given quantitation type for the given experiment.getBioAssayDimension(ExpressionExperiment ee, QuantitationType qt, Class<? extends BulkExpressionDataVector> dataVectorType) getBioAssayDimensionById(ExpressionExperiment ee, Long dimensionId) Find aBioAssayDimensionby ID.getBioAssayDimensionById(ExpressionExperiment ee, Long dimensionId, Class<? extends BulkExpressionDataVector> dataVectorType) getBioAssayDimensionsWithAssays(ExpressionExperiment expressionExperiment) Obtain all the dimensions associated to the given experiment.Obtain allBioAssayDimensions associated to a particularQuantitationType.longgetBioMaterialCount(ExpressionExperiment expressionExperiment) getCategoriesUsageFrequency(Filters filters, Set<Long> extraIds, Collection<String> excludedCategoryUris, Collection<String> excludedTermUris, Collection<String> retainedTermUris, int maxResults) Obtain category usage frequency for datasets matching the given filter.getEnhancedFilters(Filters f, Collection<OntologyTerm> mentionedTerms, Collection<OntologyTerm> inferredTerms, long timeout, TimeUnit timeUnit) Perform various transformation to the provided filters to enhance it.Build a full structured representation of an experiment'sExperimentalDesign: factors, factor values (with statements carrying stable database IDs), and per-biomaterial factor-value assignments.getGenesUsedByPreferredVectors(ExpressionExperiment experimentConstraint) Retrieve the genes used by the preferred vectors of this experiment.getLastArrayDesignUpdate(Collection<ExpressionExperiment> expressionExperiments) getLastArrayDesignUpdate(ExpressionExperiment expressionExperiment) getNumberOfDesignElementsPerSample(ExpressionExperiment expressionExperiment) Obtain the number of design elements for the platform of each bioassay in the given experiment.Iterates over the quantitation types for a given expression experiment and returns the preferred quantitation types.getPreferredRawDataVectors(ExpressionExperiment expressionExperiment) Obtain the dimension associated to the processed data for the given experiment.Obtain the dimension associated to the processed data for the given experiment.getProcessedDataVectors(ExpressionExperiment ee, List<BioAssay> assays) getQuantitationTypes(ExpressionExperiment expressionExperiment) Retrieve all the quantitation types used by the given expression experiment.getQuantitationTypes(ExpressionExperiment expressionExperiment, BioAssayDimension dimension) Retrieve all the quantitation types used by the given experiment and dimension.getQuantitationTypes(ExpressionExperiment expressionExperiment, BioAssayDimension dimension, Class<? extends BulkExpressionDataVector> dataVectorType) Map<Class<? extends DataVector>, Set<QuantitationType>> getQuantitationTypeValueObjects(ExpressionExperiment expressionExperiment) Load allQuantitationTypeassociated to an expression experiment as VOs.longgetRawDataVectors(ExpressionExperiment ee, List<BioAssay> samples, QuantitationType qt) getSampleRemovalEvents(Collection<ExpressionExperiment> expressionExperiments) getSubSetByIdWithCharacteristics(ExpressionExperiment ee, Long subSetId) Obtain a particular subset by ID.getSubSets(ExpressionExperiment expressionExperiment, BioAssayDimension dimension) Obtain the subsets for a particular dimension.getSubSetsByDimension(ExpressionExperiment expressionExperiment) Obtain all the subsets organized by dimension for a given dataset.getSubSetsByDimensionWithBioAssays(ExpressionExperiment expressionExperiment) Obtain all the subsets organized by dimension for a given dataset.getSubSetsByFactorValue(ExpressionExperiment expressionExperiment, BioAssayDimension dimension) Reconstitute the FV to subset mapping for a given experiment.getSubSetsByFactorValue(ExpressionExperiment expressionExperiment, ExperimentalFactor experimentalFactor, BioAssayDimension dimension) Reconstitute the FV to subset mapping for a given experiment and factor.getSubSetsByFactorValueWithCharacteristicsAndBioAssays(ExpressionExperiment expressionExperiment, ExperimentalFactor experimentalFactor, BioAssayDimension dimension) Reconstitute the FV to subset mapping for a given experiment and factor.getSubSetsWithBioAssays(ExpressionExperiment expressionExperiment) Obtain all the subsets for a given dataset.getSubSetsWithBioAssays(ExpressionExperiment expressionExperiment, BioAssayDimension dimension) Obtain the subsets for a particular dimension.Obtain all the subsets for a given dataset.Return the taxon for each of the given experiments.getTaxaUsageFrequency(Filters filters, Set<Long> extraIds) Calculate the usage frequency of taxa by the datasets matching the provided filters.getTaxon(ExpressionExperiment expressionExperiment) Returns the taxon of the given experiment.getTechnologyTypeUsageFrequency(Filters filters, Set<Long> extraIds) booleanTest if the given experiment has processed data vectors.booleanisBlackListed(String geoAccession) booleanisRNASeq(ExpressionExperiment expressionExperiment) booleanIndicate if the given experiment is a single-cell experiment.booleanisTroubled(ExpressionExperiment expressionExperiment) Check if the dataset is either troubled or uses a troubled platform.booleanisTwoChannel(ExpressionExperiment expressionExperiment) Test if this experiment was run on a two-color microarray platform.loadAllIdentifiersAndName(boolean includeNames) Load all possible identifiers for experiments.Load references for all experiments.loadAndThaw(Long id) Load an experiment and thaw it as perthaw(ExpressionExperiment).loadAndThawLite(Long id) <T extends Exception>
ExpressionExperimentloadAndThawLiteOrFail(Long id, Function<String, T> exceptionSupplier) <T extends Exception>
ExpressionExperimentloadAndThawLiteOrFail(Long id, Function<String, T> exceptionSupplier, String message) Load an experiment and thaw it as perthawLite(ExpressionExperiment)or fail with the supplied exception and message.<T extends Exception>
ExpressionExperimentloadAndThawLiterOrFail(Long id, Function<String, T> exceptionSupplier) Load an experiment without cache and thaw it as perthaw(ExpressionExperiment)withCacheMode.REFRESH.<T extends Exception>
ExpressionExperimentloadAndThawOrFail(Long id, Function<String, T> exceptionSupplier) Load an experiment and thaw it as perthawLite(ExpressionExperiment)or fail with the supplied exception and message.loadBlacklistedValueObjects(Filters filters, Sort sort, int offset, int limit) loadDetailsValueObjects(Collection<Long> ids, Taxon taxon, Sort sort, int offset, int limit) loadDetailsValueObjectsWithCache(Collection<Long> ids, Taxon taxon, Sort sort, int offset, int limit) loadIdsWithCache(Filters filters, Sort sort) loadReference(Long id) loadReferences(Collection<Long> ids) Load references for the given experiment IDs.Load troubled experiment IDs.loadValueObjectsByIds(List<Long> ids, boolean maintainOrder) Variant ofBaseVoEnabledService.loadValueObjectsByIds(Collection)that preserve its input order.Load VOs for the given dataset IDs and initialize their relations likeSecurableFilteringVoEnabledService.load(Filters, Sort).loadValueObjectsWithCache(Filters filters, Sort sort, int offset, int limit) Load an experiment with its audit trail initialized.Predict what would happen ifproposedwere applied as the experiment's new design via PUT.intvoidremoveCharacteristics(ExpressionExperiment ee, Collection<Characteristic> characteristicsToRemove) intRemove the processed data vectors for the given experiment.intintremoveRawDataVectors(ExpressionExperiment ee, QuantitationType qt, boolean keepDimension) intUsed when we are replacing data, such as when converting an experiment from one platform to another.intreplaceProcessedDataVectors(ExpressionExperiment ee, Collection<ProcessedExpressionDataVector> vectors) Replace the processed data vectors for the given experiment.intreplaceRawDataVectors(ExpressionExperiment ee, QuantitationType quantitationType, Collection<RawExpressionDataVector> vectors) thaw(ExpressionExperiment expressionExperiment) thawLite(ExpressionExperiment expressionExperiment) thawLiter(ExpressionExperiment expressionExperiment) voidupdateQuantitationType(ExpressionExperiment ee, QuantitationType qt, QuantitationType previousPreferredQt) Update a quantitation type.Methods inherited from interface ubic.gemma.persistence.service.BaseReadOnlyService
countAll, getElementClass, loadOrFail, loadOrFailMethods inherited from interface ubic.gemma.persistence.service.FilteringService
count, getFilter, getFilter, getFilter, getFilter, getFilter, getFilter, getFilterableProperties, getFilterablePropertyAllowedValues, getFilterablePropertyConfigAttributes, getFilterablePropertyDescription, getFilterablePropertyResolvableAllowedValuesLabels, getFilterablePropertyType, getSort, isFilterablePropertyDeprecated, isFilterablePropertyUsingSubqueryMethods inherited from interface ubic.gemma.persistence.service.common.auditAndSecurity.SecurableBaseImmutableService
create, create, findOrCreate, remove, removeMethods inherited from interface ubic.gemma.persistence.service.common.auditAndSecurity.SecurableBaseReadOnlyService
find, findOrFail, load, load, loadAll, loadOrFail, loadOrFail, loadOrFail, loadOrFail, streamAll, streamAllMethods inherited from interface ubic.gemma.persistence.service.common.auditAndSecurity.SecurableBaseService
save, save, update, updateMethods inherited from interface ubic.gemma.persistence.service.common.auditAndSecurity.SecurableBaseVoEnabledService
loadAllValueObjects, loadValueObject, loadValueObjectById, loadValueObjects, loadValueObjectsByIdsMethods inherited from interface ubic.gemma.persistence.service.common.auditAndSecurity.SecurableFilteringVoEnabledService
load, load, loadIds, loadValueObjects, loadValueObjects
-
Field Details
-
FREE_TEXT
Special indicator for free-text terms.- See Also:
-
UNCATEGORIZED
Special indicator for uncategorized terms.- See Also:
-
-
Method Details
-
loadReference
-
loadReferences
Load references for the given experiment IDs. -
loadAllReferences
Collection<ExpressionExperiment> loadAllReferences()Load references for all experiments.References are pre-filtered for ACLs as per
SecurableFilteringVoEnabledService.loadIds(Filters, Sort). -
loadWithAuditTrail
@Nullable @Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_READ_QUIET"}) ExpressionExperiment loadWithAuditTrail(Long id) Load an experiment with its audit trail initialized. -
loadTroubledIds
Load troubled experiment IDs.- See Also:
-
loadAllIdentifiersAndName
Load all possible identifiers for experiments.- Parameters:
includeNames- if true, include experiment names as possible identifier- Returns:
- a mapping of candidate identifier to experiment name
-
reload
- See Also:
-
addFactor
@Secured({"GROUP_USER","ACL_SECURABLE_EDIT"}) ExperimentalFactor addFactor(ExpressionExperiment ee, ExperimentalFactor factor) -
addFactorValue
@Secured({"GROUP_USER","ACL_SECURABLE_EDIT"}) FactorValue addFactorValue(ExpressionExperiment ee, FactorValue fv) - Parameters:
ee- experiment.fv- must already have the experimental factor filled in.
-
addFactorValues
@Secured({"GROUP_USER","ACL_SECURABLE_EDIT"}) void addFactorValues(ExpressionExperiment ee, Map<BioMaterial, FactorValue> fvs) Intended with the case of a continuous factor being added. -
getRawDataVectors
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Collection<RawExpressionDataVector> getRawDataVectors(ExpressionExperiment ee, QuantitationType qt) - See Also:
-
getRawDataVectors
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Collection<RawExpressionDataVector> getRawDataVectors(ExpressionExperiment ee, List<BioAssay> samples, QuantitationType qt) - See Also:
-
getPreferredRawDataVectors
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Collection<RawExpressionDataVector> getPreferredRawDataVectors(ExpressionExperiment expressionExperiment) - See Also:
-
getMissingValuesVectors
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Map<QuantitationType,Collection<RawExpressionDataVector>> getMissingValuesVectors(ExpressionExperiment ee) - See Also:
-
addRawDataVectors
@Secured({"GROUP_USER","ACL_SECURABLE_EDIT"}) int addRawDataVectors(ExpressionExperiment eeToUpdate, QuantitationType quantitationType, Collection<RawExpressionDataVector> newVectors) Used when we want to add data for a quantitation type. Does not remove any existing vectors.- Parameters:
eeToUpdate- experiment to be updated.newVectors- vectors to be added.- Returns:
- the number of added vectors
-
replaceRawDataVectors
@Secured({"GROUP_USER","ACL_SECURABLE_EDIT"}) int replaceRawDataVectors(ExpressionExperiment ee, QuantitationType quantitationType, Collection<RawExpressionDataVector> vectors) - See Also:
-
replaceAllRawDataVectors
@Secured({"GROUP_USER","ACL_SECURABLE_EDIT"}) int replaceAllRawDataVectors(ExpressionExperiment ee, Collection<RawExpressionDataVector> vectors) Used when we are replacing data, such as when converting an experiment from one platform to another. Examples would be exon array or RNA-seq data sets, or other situations where we are replacing data. Does not take care of computing the processed data vectors, but it does clear them out.- Parameters:
ee- experimentvectors- If they are from more than one platform, that will be dealt with.- Returns:
- the number of vectors replaced
-
removeAllRawDataVectors
- See Also:
-
removeRawDataVectors
@Secured({"GROUP_USER","ACL_SECURABLE_EDIT"}) int removeRawDataVectors(ExpressionExperiment ee, QuantitationType qt) - See Also:
-
removeRawDataVectors
@Secured({"GROUP_USER","ACL_SECURABLE_EDIT"}) int removeRawDataVectors(ExpressionExperiment ee, QuantitationType qt, boolean keepDimension) - See Also:
-
getProcessedDataVectors
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Optional<Collection<ProcessedExpressionDataVector>> getProcessedDataVectors(ExpressionExperiment ee) - Returns:
- a collection of processed data vectors for the given experiment and list of assays, or
Optional.empty()if there are no processed vectors - See Also:
-
getProcessedDataVectors
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Optional<Collection<ProcessedExpressionDataVector>> getProcessedDataVectors(ExpressionExperiment ee, List<BioAssay> assays) - Returns:
- a collection of processed data vectors for the given experiment and list of assays, or
Optional.empty()if there are no processed vectors - See Also:
-
createProcessedDataVectors
@Secured({"GROUP_USER","ACL_SECURABLE_EDIT"}) int createProcessedDataVectors(ExpressionExperiment ee, Collection<ProcessedExpressionDataVector> vectors) Create a new set of processed vectors for an experiment.You might actually want to use
ProcessedExpressionDataVectorService.createProcessedDataVectors(ExpressionExperiment, boolean, boolean)as this method is fairly low-level.- See Also:
-
replaceProcessedDataVectors
@Secured({"GROUP_USER","ACL_SECURABLE_EDIT"}) int replaceProcessedDataVectors(ExpressionExperiment ee, Collection<ProcessedExpressionDataVector> vectors) Replace the processed data vectors for the given experiment.You might actually want to use
ProcessedExpressionDataVectorService.replaceProcessedDataVectors(ExpressionExperiment, Collection, boolean)(ExpressionExperiment)}. as this method is fairly low-level.- See Also:
-
removeProcessedDataVectors
@Secured({"GROUP_USER","ACL_SECURABLE_EDIT"}) int removeProcessedDataVectors(ExpressionExperiment ee) Remove the processed data vectors for the given experiment.You might actually want to use
ProcessedExpressionDataVectorService.removeProcessedDataVectors(ExpressionExperiment). as this method is fairly low-level.- See Also:
-
browse
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_COLLECTION_READ"}) List<ExpressionExperiment> browse(int start, int limit) -
filter
returns ids of search results.- Parameters:
searchString- search string- Returns:
- collection of ids or an empty collection.
- Throws:
SearchException
-
filterByTaxon
Remove IDs of Experiments that are not from the given taxon.- Parameters:
ids- collection to purge.taxon- taxon to retain.- Returns:
- purged IDs.
-
loadWithCharacteristics
@Nullable @Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_READ_QUIET"}) ExpressionExperiment loadWithCharacteristics(Long id) -
loadAndThawLiteOrFail
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_READ"}) <T extends Exception> ExpressionExperiment loadAndThawLiteOrFail(Long id, Function<String, T> exceptionSupplier, String message) throws TLoad an experiment and thaw it as perthawLite(ExpressionExperiment)or fail with the supplied exception and message.- Throws:
T
-
loadAndThawLiteOrFail
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_READ"}) <T extends Exception> ExpressionExperiment loadAndThawLiteOrFail(Long id, Function<String, T> exceptionSupplier) throws T- Throws:
T
-
loadAndThawLiterOrFail
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_READ"}) <T extends Exception> ExpressionExperiment loadAndThawLiterOrFail(Long id, Function<String, T> exceptionSupplier) throws T- Throws:
T
-
loadAndThaw
@Nullable @Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_READ"}) ExpressionExperiment loadAndThaw(Long id) Load an experiment and thaw it as perthaw(ExpressionExperiment). -
loadAndThawLite
@Nullable @Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_READ"}) ExpressionExperiment loadAndThawLite(Long id) -
loadAndThawLiteWithRefreshCacheMode
@Nullable @Secured({"GROUP_ADMIN","AFTER_ACL_READ"}) ExpressionExperiment loadAndThawLiteWithRefreshCacheMode(Long id) Load an experiment without cache and thaw it as perthaw(ExpressionExperiment)withCacheMode.REFRESH.This has the side effect of refreshing the cache with the latest data. Since this can be expensive, only administrators are allowed to do this.
-
loadAndThawOrFail
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_READ"}) <T extends Exception> ExpressionExperiment loadAndThawOrFail(Long id, Function<String, T> exceptionSupplier) throws TLoad an experiment and thaw it as perthawLite(ExpressionExperiment)or fail with the supplied exception and message.- Throws:
T
-
loadIdsWithCache
-
countWithCache
Count the number of experiments that match the given filters.- Parameters:
filters- a set of filters to be applied as perSecurableFilteringVoEnabledService.loadIds(Filters, Sort)extraIds- a set of extra IDs to be intersected with the IDs retrieved by the filters
-
loadValueObjectsWithCache
-
loadWithPrimaryPublication
@Nullable @Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_READ_QUIET"}) ExpressionExperiment loadWithPrimaryPublication(Long id) -
loadWithPrimaryPublicationAndOtherRelevantPublications
@Nullable @Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_READ_QUIET"}) ExpressionExperiment loadWithPrimaryPublicationAndOtherRelevantPublications(Long id) -
loadWithMeanVarianceRelation
@Nullable @Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_READ_QUIET"}) ExpressionExperiment loadWithMeanVarianceRelation(Long id) -
findByAccession
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_COLLECTION_READ"}) Collection<ExpressionExperiment> findByAccession(DatabaseEntry accession) - Parameters:
accession- accession- Returns:
- Experiments which have the given accession. There can be more than one, because one GEO accession can result in multiple experiments in Gemma.
-
findByAccession
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_COLLECTION_READ"}) Collection<ExpressionExperiment> findByAccession(String accession) -
findOneByAccession
@Nullable @Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_READ_QUIET"}) ExpressionExperiment findOneByAccession(String accession) -
findByBibliographicReference
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_COLLECTION_READ"}) Collection<ExpressionExperiment> findByBibliographicReference(BibliographicReference bibRef) - Parameters:
bibRef- bibliographic reference- Returns:
- a collection of EE that have that reference that BibliographicReference
-
findByBioAssay
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_READ"}) ExpressionExperiment findByBioAssay(BioAssay ba) - Parameters:
ba- bio material- Returns:
- experiment the given bioassay is associated with
-
findByBioAssay
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_READ"}) ExpressionExperiment findByBioAssay(BioAssay ba, boolean includeSubSets) - Parameters:
includeSubSets- include assays that belong to subsets of the experiment
-
findIdByBioAssay
-
findByBioMaterial
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_COLLECTION_READ"}) Collection<ExpressionExperiment> findByBioMaterial(BioMaterial bm) - Parameters:
bm- bio material- Returns:
- experiment the given biomaterial is associated with
-
findByBioMaterial
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_COLLECTION_READ"}) Collection<ExpressionExperiment> findByBioMaterial(BioMaterial bm, boolean includeSubSets) - Parameters:
includeSubSets- include samples that are associated to assays that belong to subsets of the experiment
-
findIdsByBioMaterial
-
findByBioMaterials
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_COLLECTION_READ"}) Map<ExpressionExperiment,Collection<BioMaterial>> findByBioMaterials(Collection<BioMaterial> biomaterials) -
findByExpressedGene
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_COLLECTION_READ"}) Collection<ExpressionExperiment> findByExpressedGene(Gene gene, double rank) - Parameters:
gene- generank- rank- Returns:
- a collection of expression experiment ids that express the given gene above the given expression level
-
findByDesign
@Nullable @Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_READ"}) ExpressionExperiment findByDesign(ExperimentalDesign ed) -
findIdByDesign
-
findByDesignId
@Nullable @Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_READ"}) ExpressionExperiment findByDesignId(Long designId) -
findByFactor
@Nullable @Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_READ"}) ExpressionExperiment findByFactor(ExperimentalFactor factor) -
findIdByFactor
-
findByFactors
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_COLLECTION_READ"}) Collection<ExpressionExperiment> findByFactors(Collection<ExperimentalFactor> factors) -
findByFactorValue
@Nullable @Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_READ"}) ExpressionExperiment findByFactorValue(FactorValue factorValue) -
findIdByFactorValue
-
findByFactorValueId
@Nullable @Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_READ"}) ExpressionExperiment findByFactorValueId(Long factorValueId) -
findByFactorValues
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_COLLECTION_READ"}) Collection<ExpressionExperiment> findByFactorValues(Collection<FactorValue> factorValues) -
findByFactorValueIds
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_COLLECTION_READ"}) Collection<ExpressionExperiment> findByFactorValueIds(Collection<Long> factorValueIds) -
findByGene
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_COLLECTION_READ"}) Collection<ExpressionExperiment> findByGene(Gene gene) - Parameters:
gene- gene- Returns:
- a collection of expression experiments that have an AD that detects the given Gene (ie a probe on the AD hybridizes to the given Gene)
-
findByName
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_COLLECTION_READ"}) Collection<ExpressionExperiment> findByName(String name) -
findOneByName
@Nullable @Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_READ_QUIET"}) ExpressionExperiment findOneByName(String name) -
findByQuantitationType
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_READ"}) ExpressionExperiment findByQuantitationType(QuantitationType type) -
findByShortName
@Nullable @Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_READ_QUIET"}) ExpressionExperiment findByShortName(String shortName) -
findByShortNameWithPrimaryPublication
@Nullable @Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_READ_QUIET"}) ExpressionExperiment findByShortNameWithPrimaryPublication(String shortName) -
findByShortNameAndThawLite
@Nullable @Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_READ_QUIET"}) ExpressionExperiment findByShortNameAndThawLite(String shortName) -
findByTaxon
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_COLLECTION_READ"}) Collection<ExpressionExperiment> findByTaxon(Taxon taxon) -
findByUpdatedLimit
@Secured({"GROUP_AGENT","AFTER_ACL_COLLECTION_READ"}) List<ExpressionExperiment> findByUpdatedLimit(int limit) -
findUpdatedAfter
@Secured({"GROUP_AGENT","AFTER_ACL_COLLECTION_READ"}) Collection<ExpressionExperiment> findUpdatedAfter(Date date) -
findByMeanVarianceRelation
@Nullable @Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_READ_QUIET"}) ExpressionExperiment findByMeanVarianceRelation(MeanVarianceRelation mvr) -
findIdByMeanVarianceRelation
-
existsByShortName
Check if a dataset with a given short name.No ACL checks are performed.
-
getAnnotationCountsByIds
- Parameters:
ids- ids- Returns:
- the map of ids to number of terms associated with each expression experiment.
-
getAnnotations
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Set<AnnotationValueObject> getAnnotations(ExpressionExperiment ee) Retrieve annotations for a given experiment.The following are included:
- Experiment-level tags
- Experimental design tags
- Sample-level tags
-
getAnnotations
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Set<AnnotationValueObject> getAnnotations(ExpressionExperimentSubSet ee) Retrieve annotations for a given experiment subset.The following are included:
- Experiment-level tags
- Subset-level tags
- Experimental design tags minus the subset factor
- Sample-level tags for the samples within the subset
-
getExperimentalDesignValueObject
@Nullable @Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) ExperimentalDesignValueObject getExperimentalDesignValueObject(ExpressionExperiment ee) Build a full structured representation of an experiment'sExperimentalDesign: factors, factor values (with statements carrying stable database IDs), and per-biomaterial factor-value assignments. Returnsnullif the experiment has no design attached. -
previewDesignChange
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) DesignPreflightReport previewDesignChange(ExpressionExperiment ee, ExperimentalDesignValueObject proposed) Predict what would happen ifproposedwere applied as the experiment's new design via PUT. Performs both validation (blockers) and impact analysis (deletions, dependent analyses, affected subsets). Never mutates state.- Parameters:
ee- the target experimentproposed- the candidate design as it would be sent toPUT /datasets/{id}/design- Returns:
- a
DesignPreflightReportdescribing the diff and its consequences
-
applyDesignChange
@Secured({"GROUP_USER","ACL_SECURABLE_EDIT"}) ExperimentalDesignValueObject applyDesignChange(ExpressionExperiment ee, ExperimentalDesignValueObject proposed) Applyproposedas the experiment's newExperimentalDesign.Performs the same validation as
previewDesignChange(ExpressionExperiment, ExperimentalDesignValueObject)and throwsIllegalArgumentExceptionwhen blockers are present; the caller is expected to surface preflight feedback before invoking this method. Statements on kept factor values are replaced wholesale (any statement not echoed in the payload is deleted); factor values and factors not echoed are deleted. Differential expression analyses whose factors or factor values are affected are cascaded.Emits a single
ExperimentalDesignUpdatedEventsummarising the change.- Parameters:
ee- the target experimentproposed- the new design- Returns:
- the freshly-rebuilt
ExperimentalDesignValueObjectafter the update
-
getEnhancedFilters
Filters getEnhancedFilters(Filters f, @Nullable Collection<OntologyTerm> mentionedTerms, @Nullable Collection<OntologyTerm> inferredTerms, long timeout, TimeUnit timeUnit) throws TimeoutException Perform various transformation to the provided filters to enhance it.- rewrite clauses over objects and predicates to include second/third, etc... predicates/objects
- apply ontological inference to augment a filter with additional terms.
- Parameters:
mentionedTerms- if non-null, all the terms explicitly mentioned in the filters are added to the collection.inferredTerms- if non-null, all the terms inferred from those mentioned in the filters are added to the collection- Throws:
TimeoutException
-
getNumberOfDesignElementsPerSample
Obtain the number of design elements for the platform of each bioassay in the given experiment. -
getCategoriesUsageFrequency
Map<Characteristic,Long> getCategoriesUsageFrequency(@Nullable Filters filters, @Nullable Set<Long> extraIds, @Nullable Collection<String> excludedCategoryUris, @Nullable Collection<String> excludedTermUris, @Nullable Collection<String> retainedTermUris, int maxResults) Obtain category usage frequency for datasets matching the given filter.- Parameters:
filters- filters restricting the terms to a given set of datasetsexcludedCategoryUris- ensure that the given category URIs are excludedexcludedTermUris- ensure that the given term URIs and their sub-terms (as persubClassOfrelation) are excluded; this requires relevant ontologies to be loaded inOntologyService.retainedTermUris- ensure that the given terms are retained (overrides any exclusion from minFrequency and excludedTermUris)maxResults- maximum number of results to return
-
getAnnotationsUsageFrequency
List<ExpressionExperimentService.CharacteristicWithUsageStatisticsAndOntologyTerm> getAnnotationsUsageFrequency(@Nullable Filters filters, @Nullable Set<Long> extraIds, @Nullable String category, @Nullable Collection<String> excludedCategoryUris, @Nullable Collection<String> excludedTermUris, int minFrequency, @Nullable Collection<String> retainedTermUris, int maxResults, boolean includePredicates, boolean includeObjects, long timeout, TimeUnit timeUnit) throws TimeoutException Obtain annotation usage frequency for datasets matching the given filters.Terms may originate from the experiment tags, experimental design or samples.
The implementation uses a denormalized table for associating EEs to characteristics which is not always in sync if new terms are attached.
- Parameters:
filters- filters restricting the terms to a given set of datasetscategory- a category to restrict annotations to, or null to include all categoriesexcludedCategoryUris- ensure that the given category URIs are excludedexcludedTermUris- ensure that the given term URIs and their sub-terms (as persubClassOfrelation) are excluded; this requires relevant ontologies to be loaded inOntologyService.minFrequency- minimum occurrences of a term to be included in the resultsretainedTermUris- ensure that the given terms are retained (overrides any exclusion from minFrequency and excludedTermUris)maxResults- maximum number of results to returnincludePredicates- include usage frequencies of predicates in the resultsincludeObjects- include usage frequencies of objects in the results- Returns:
- mapping annotations grouped by category and term (URI or value if null) to their number of occurrences in the matched datasets and ordered in descending number of associated experiments
- Throws:
TimeoutException- See Also:
-
getArrayDesignsUsed
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Collection<ArrayDesign> getArrayDesignsUsed(ExpressionExperiment expressionExperiment) - Parameters:
expressionExperiment- experiment- Returns:
- a collection of ArrayDesigns referenced by any of the BioAssays that make up the given ExpressionExperiment.
-
getArrayDesignsUsed
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Collection<ArrayDesign> getArrayDesignsUsed(ExpressionExperiment ee, QuantitationType qt) Obtain a collection ofArrayDesignused by a specific set of vectors.The type of vectors is inferred.
- See Also:
-
getArrayDesignsUsed
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Collection<ArrayDesign> getArrayDesignsUsed(ExpressionExperiment ee, QuantitationType qt, Class<? extends DataVector> vectorType) Obtain a collection ofArrayDesignused by a specific set of vectors. -
getGenesUsedByPreferredVectors
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Collection<Gene> getGenesUsedByPreferredVectors(ExpressionExperiment experimentConstraint) Retrieve the genes used by the preferred vectors of this experiment. -
getTechnologyTypeUsageFrequency
-
getArrayDesignUsedOrOriginalPlatformUsageFrequency
Map<ArrayDesign,Long> getArrayDesignUsedOrOriginalPlatformUsageFrequency(@Nullable Filters filters, @Nullable Set<Long> extraIds, int maxResults) Calculate the usage frequency of platforms by the datasets matching the provided filters.- Parameters:
filters- a set of filters to be applied as perSecurableFilteringVoEnabledService.loadIds(Filters, Sort)extraIds- a set of extra IDs to be intersected with the IDs retrieved by the filtersmaxResults- the maximum of results, or unlimited if less than 1
-
getTaxaUsageFrequency
Calculate the usage frequency of taxa by the datasets matching the provided filters.If no filters are supplied (either being null or empty), the
getPerTaxonCount()fast path is used.- Parameters:
filters- a set of filters to be applied as perSecurableFilteringVoEnabledService.loadIds(Filters, Sort)extraIds- a set of extra IDs to be intersected with the IDs retrieved by the filters- See Also:
-
getBioAssayDimensionsWithAssays
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Collection<BioAssayDimension> getBioAssayDimensionsWithAssays(ExpressionExperiment expressionExperiment) Obtain all the dimensions associated to the given experiment.Assays are initialized as per
Thaws.thawBioAssay(BioAssay). -
getBioAssayDimension
@Nullable @Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) BioAssayDimension getBioAssayDimension(ExpressionExperiment ee, QuantitationType qt, Class<? extends BulkExpressionDataVector> dataVectorType) -
getBioAssayDimension
@Nullable @Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) BioAssayDimension getBioAssayDimension(ExpressionExperiment ee, QuantitationType qt) Obtain the dimension associated to the given quantitation type for the given experiment.This fails if there happens to be more than one dimension for the given QT.
-
getProcessedBioAssayDimension
@Nullable @Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) BioAssayDimension getProcessedBioAssayDimension(ExpressionExperiment ee) Obtain the dimension associated to the processed data for the given experiment. -
getProcessedBioAssayDimensionsWithAssays
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Collection<BioAssayDimension> getProcessedBioAssayDimensionsWithAssays(ExpressionExperiment ee) Obtain the dimension associated to the processed data for the given experiment.Assays are initialized as per
Thaws.thawBioAssay(BioAssay).In some special edge cases, a
QuantitationTypemay have more than oneBioAssayDimension. If you cannot handle this, usegetProcessedBioAssayDimension(ExpressionExperiment)instead. -
getBioAssayDimensionsWithAssays
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Collection<BioAssayDimension> getBioAssayDimensionsWithAssays(ExpressionExperiment ee, QuantitationType qt) Obtain allBioAssayDimensions associated to a particularQuantitationType.Assays initialized as per
Thaws.thawBioAssay(BioAssay)In some special edge cases, a
QuantitationTypemay have more than oneBioAssayDimension. -
getBioAssayDimensionById
@Nullable @Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) BioAssayDimension getBioAssayDimensionById(ExpressionExperiment ee, Long dimensionId, Class<? extends BulkExpressionDataVector> dataVectorType) -
getBioAssayDimensionById
@Nullable @Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) BioAssayDimension getBioAssayDimensionById(ExpressionExperiment ee, Long dimensionId) Find aBioAssayDimensionby ID.This is less efficient than
getBioAssayDimensionById(ExpressionExperiment, Long, Class)because all bulk vector types need to be inspected. -
getBioMaterialCount
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) long getBioMaterialCount(ExpressionExperiment expressionExperiment) - Parameters:
expressionExperiment- experiment- Returns:
- the amount of biomaterials associated with the given expression experiment.
-
getRawDataVectorCount
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) long getRawDataVectorCount(ExpressionExperiment ee) -
getExperimentsWithOutliers
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_COLLECTION_READ"}) Collection<ExpressionExperiment> getExperimentsWithOutliers() -
getLastArrayDesignUpdate
@Secured("IS_AUTHENTICATED_ANONYMOUSLY") Map<Long,Date> getLastArrayDesignUpdate(Collection<ExpressionExperiment> expressionExperiments) -
getLastArrayDesignUpdate
@Nullable @Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Date getLastArrayDesignUpdate(ExpressionExperiment expressionExperiment) - Parameters:
expressionExperiment- experiment- Returns:
- the date of the last time any of the array designs associated with this experiment were updated.
-
getLastLinkAnalysis
- Parameters:
ids- ids- Returns:
- AuditEvents of the latest link analyses for the specified expression experiment ids. This returns a map of id -> AuditEvent. If the events do not exist, the map entry will point to null.
-
getLastMissingValueAnalysis
- Parameters:
ids- ids- Returns:
- AuditEvents of the latest missing value analysis for the specified expression experiment ids. This returns a map of id -> AuditEvent. If the events do not exist, the map entry will point to null.
-
getLastProcessedDataUpdate
- Parameters:
ids- ids- Returns:
- AuditEvents of the latest rank computation for the specified expression experiment ids. This returns a map of id -> AuditEvent. If the events do not exist, the map entry will point to null.
-
getPerTaxonCount
- Returns:
- counts of expression experiments grouped by taxon
-
getPopulatedFactorCounts
- Parameters:
ids- ids- Returns:
- map of ids to how many factor values the experiment has, counting only factor values which are associated with biomaterials.
-
getPopulatedFactorCountsExcludeBatch
- Parameters:
ids- ids- Returns:
- map of ids to how many factor values the experiment has, counting only factor values which are associated with biomaterials and only factors that aren't batch
-
getPreferredQuantitationType
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Optional<QuantitationType> getPreferredQuantitationType(ExpressionExperiment ee) Iterates over the quantitation types for a given expression experiment and returns the preferred quantitation types.- Parameters:
ee- experiment- Returns:
- quantitation types
-
getProcessedQuantitationType
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Optional<QuantitationType> getProcessedQuantitationType(ExpressionExperiment ee) -
hasProcessedExpressionData
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) boolean hasProcessedExpressionData(ExpressionExperiment ee) Test if the given experiment has processed data vectors. -
getQuantitationTypeCount
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Map<QuantitationType,Long> getQuantitationTypeCount(ExpressionExperiment ee) - Returns:
- counts design element data vectors grouped by quantitation type
-
getQuantitationTypes
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Collection<QuantitationType> getQuantitationTypes(ExpressionExperiment expressionExperiment) Retrieve all the quantitation types used by the given expression experiment.- See Also:
-
getQuantitationTypesByVectorType
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Map<Class<? extends DataVector>,Set<QuantitationType>> getQuantitationTypesByVectorType(ExpressionExperiment ee) -
getQuantitationTypes
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Collection<QuantitationType> getQuantitationTypes(ExpressionExperiment expressionExperiment, BioAssayDimension dimension) Retrieve all the quantitation types used by the given experiment and dimension. -
getQuantitationTypes
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Collection<QuantitationType> getQuantitationTypes(ExpressionExperiment expressionExperiment, BioAssayDimension dimension, Class<? extends BulkExpressionDataVector> dataVectorType) -
getQuantitationTypeValueObjects
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Collection<QuantitationTypeValueObject> getQuantitationTypeValueObjects(ExpressionExperiment expressionExperiment) Load allQuantitationTypeassociated to an expression experiment as VOs.- See Also:
-
getSampleRemovalEvents
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_MAP_READ"}) Map<ExpressionExperiment,Collection<AuditEvent>> getSampleRemovalEvents(Collection<ExpressionExperiment> expressionExperiments) -
getSubSetsWithBioAssays
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Collection<ExpressionExperimentSubSet> getSubSetsWithBioAssays(ExpressionExperiment expressionExperiment) Obtain all the subsets for a given dataset. -
getSubSetsWithCharacteristics
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Collection<ExpressionExperimentSubSet> getSubSetsWithCharacteristics(ExpressionExperiment ee) Obtain all the subsets for a given dataset.Subsets characteristics are initialized and assays are thawed as per
Thaws.thawBioAssay(BioAssay). -
getSubSetsByDimension
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Map<BioAssayDimension,Set<ExpressionExperimentSubSet>> getSubSetsByDimension(ExpressionExperiment expressionExperiment) Obtain all the subsets organized by dimension for a given dataset. -
getSubSetsByDimensionWithBioAssays
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Map<BioAssayDimension,Set<ExpressionExperimentSubSet>> getSubSetsByDimensionWithBioAssays(ExpressionExperiment expressionExperiment) Obtain all the subsets organized by dimension for a given dataset.Assays are thawed as per
Thaws.thawBioAssay(BioAssay). -
getSubSets
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Collection<ExpressionExperimentSubSet> getSubSets(ExpressionExperiment expressionExperiment, BioAssayDimension dimension) Obtain the subsets for a particular dimension. -
getSubSetsWithBioAssays
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Collection<ExpressionExperimentSubSet> getSubSetsWithBioAssays(ExpressionExperiment expressionExperiment, BioAssayDimension dimension) Obtain the subsets for a particular dimension.Assays are lightly thawed.
-
getSubSetsByFactorValue
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Map<ExperimentalFactor,Map<FactorValue, getSubSetsByFactorValueExpressionExperimentSubSet>> (ExpressionExperiment expressionExperiment, BioAssayDimension dimension) Reconstitute the FV to subset mapping for a given experiment.This will generally return a single factor that was used for splitting the dataset. However, if there are confounding factors, those will be returned as well.
-
getSubSetsByFactorValue
@Nullable @Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Map<FactorValue,ExpressionExperimentSubSet> getSubSetsByFactorValue(ExpressionExperiment expressionExperiment, ExperimentalFactor experimentalFactor, BioAssayDimension dimension) Reconstitute the FV to subset mapping for a given experiment and factor. -
getSubSetsByFactorValueWithCharacteristicsAndBioAssays
@Nullable @Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Map<FactorValue,ExpressionExperimentSubSet> getSubSetsByFactorValueWithCharacteristicsAndBioAssays(ExpressionExperiment expressionExperiment, ExperimentalFactor experimentalFactor, BioAssayDimension dimension) Reconstitute the FV to subset mapping for a given experiment and factor.Subsets characteristics are initialized and assays are thawed as per
Thaws.thawBioAssay(BioAssay). -
getSubSetByIdWithCharacteristics
@Nullable @Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) ExpressionExperimentSubSet getSubSetByIdWithCharacteristics(ExpressionExperiment ee, Long subSetId) -
getSubSetByIdWithCharacteristicsAndBioAssays
@Nullable @Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) ExpressionExperimentSubSet getSubSetByIdWithCharacteristicsAndBioAssays(ExpressionExperiment ee, Long subSetId) Obtain a particular subset by ID.Subsets characteristics are initialized and assays are thawed as per
Thaws.thawBioAssay(BioAssay). -
getTaxa
Return the taxon for each of the given experiments. -
getTaxon
@Nullable @Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Taxon getTaxon(ExpressionExperiment expressionExperiment) Returns the taxon of the given experiment.- Returns:
- taxon, or null if the experiment taxon cannot be determined (i.e., if it has no samples).
-
isSingleCell
Indicate if the given experiment is a single-cell experiment.Gemma does not treat single-cell experiments differently from other experiments, so we need to rely on various aspect of the dataset to determine if it is a single-cell experiment.
-
isRNASeq
- Parameters:
expressionExperiment- ee- Returns:
- true if this experiment was run on a sequencing-based platform.
-
isTwoChannel
Test if this experiment was run on a two-color microarray platform. -
isTroubled
Check if the dataset is either troubled or uses a troubled platform. -
loadDetailsValueObjects
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_VALUE_OBJECT_COLLECTION_READ"}) Slice<ExpressionExperimentDetailsValueObject> loadDetailsValueObjects(Collection<Long> ids, @Nullable Taxon taxon, @Nullable Sort sort, int offset, int limit) - See Also:
-
loadDetailsValueObjectsWithCache
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_VALUE_OBJECT_COLLECTION_READ"}) Slice<ExpressionExperimentDetailsValueObject> loadDetailsValueObjectsWithCache(Collection<Long> ids, @Nullable Taxon taxon, @Nullable Sort sort, int offset, int limit) -
loadDetailsValueObjectsByIds
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_VALUE_OBJECT_COLLECTION_READ"}) List<ExpressionExperimentDetailsValueObject> loadDetailsValueObjectsByIds(Collection<Long> ids) -
loadDetailsValueObjectsByIdsWithCache
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_VALUE_OBJECT_COLLECTION_READ"}) List<ExpressionExperimentDetailsValueObject> loadDetailsValueObjectsByIdsWithCache(Collection<Long> ids) -
loadBlacklistedValueObjects
-
loadLackingFactors
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_COLLECTION_READ"}) Collection<ExpressionExperiment> loadLackingFactors() -
loadLackingTags
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_COLLECTION_READ"}) Collection<ExpressionExperiment> loadLackingTags() -
loadValueObjectsByIdsWithRelationsAndCache
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_VALUE_OBJECT_COLLECTION_READ"}) List<ExpressionExperimentValueObject> loadValueObjectsByIdsWithRelationsAndCache(List<Long> ids) Load VOs for the given dataset IDs and initialize their relations likeSecurableFilteringVoEnabledService.load(Filters, Sort).The order of VOs is preserved.
-
loadValueObjectsByIds
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_VALUE_OBJECT_COLLECTION_READ"}) List<ExpressionExperimentValueObject> loadValueObjectsByIds(List<Long> ids, boolean maintainOrder) Variant ofBaseVoEnabledService.loadValueObjectsByIds(Collection)that preserve its input order.- Parameters:
ids- ids to loadmaintainOrder- If true, order of valueObjects returned will correspond to order of ids passed in.- Returns:
- value objects
-
addCharacteristic
@Secured({"GROUP_USER","ACL_SECURABLE_EDIT"}) void addCharacteristic(ExpressionExperiment ee, Characteristic vc) Will add the vocab characteristic to the expression experiment and persist the changes.- Parameters:
ee- the experiment to add the characteristics to.vc- If the evidence code is null, it will be filled in with IC. A category and value must be provided.
-
removeCharacteristics
@Secured({"GROUP_USER","ACL_SECURABLE_EDIT"}) void removeCharacteristics(ExpressionExperiment ee, Collection<Characteristic> characteristicsToRemove) -
thaw
@CheckReturnValue @Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) ExpressionExperiment thaw(ExpressionExperiment expressionExperiment) - See Also:
-
thawLiter
@CheckReturnValue @Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) ExpressionExperiment thawLiter(ExpressionExperiment expressionExperiment) - See Also:
-
thawLite
@CheckReturnValue @Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) ExpressionExperiment thawLite(ExpressionExperiment expressionExperiment) - See Also:
-
isBlackListed
-
isSuitableForDEA
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","ACL_SECURABLE_READ"}) Boolean isSuitableForDEA(ExpressionExperiment ee) - Returns:
- true if the experiment is not explicitly marked as unsuitable for DEA; false otherwise.
-
getExperimentsLackingPublications
@Secured({"IS_AUTHENTICATED_ANONYMOUSLY","AFTER_ACL_COLLECTION_READ"}) Collection<ExpressionExperiment> getExperimentsLackingPublications()- Returns:
- collection of GEO experiments which lack an association with a publication (non-GEO experiments will be ignored)
-
updateQuantitationType
@Secured({"GROUP_USER","ACL_SECURABLE_EDIT"}) void updateQuantitationType(ExpressionExperiment ee, QuantitationType qt, @Nullable QuantitationType previousPreferredQt) Update a quantitation type.If the provided QT is preferred (i.e. either single-cell, raw or processed), all other QTs in the experiment for that type of vectors will be set to non-preferred.
- Parameters:
previousPreferredQt- if theQuantitationType.getIsPreferred()(orQuantitationType.getIsSingleCellPreferred()for single-cell data) status is changing, this indicates which QT was previously preferred. If null, it is assumed that no QT was previously preferred. This only affects the event added to the audit trail, all other QTs will have their preferred status updated regardless.- See Also:
-
updateMeanVarianceRelation
@Secured({"GROUP_USER","ACL_SECURABLE_EDIT"}) MeanVarianceRelation updateMeanVarianceRelation(ExpressionExperiment ee, MeanVarianceRelation mvr) -
countBioMaterials
- See Also:
-