tooluniverse-expression-data-retrieval
Retrieve gene expression and omics datasets from ArrayExpress and BioStudies with gene disambiguation and quality assessment. Use for finding RNA-seq/microarray datasets by organism/tissue/condition, comparing across studies (case-control, time-series, dose-response), and assessing dataset suitabili
By mims-harvard · 391 installs
npx skills add mims-harvard/tooluniverse --skill tooluniverse-expression-data-retrieval
Source repository · Upstream listing
Gene Expression & Omics Data Retrieval
Retrieve gene expression experiments and multi omics datasets with disambiguation and quality assessment.
IMPORTANT : Always use English terms in tool calls. Respond in the user's language.
LOOK UP DON'T GUESS : Never assume which datasets exist or their accessions. Always search to confirm.
Domain Reasoning
Before retrieving, determine: organism, tissue, experimental design (case control/time series/dose response). These affect which database to search and how to interpret results. RNA seq provides wider dynamic range; microarray has extensive legacy data. Prioritize experiments with =3 biological replicates, complete annotations, and both raw+processed data.
Workflow
Phase 0: Clarification (When Needed)
Ask ONLY if: gene name ambiguous, tissue/condition unclear, organism not specified.
Skip for: specific accessions (E MTAB , E GEOD , S BSST ), clear disease/tissue+organism, explicit platform requests.
Phase 1: Query Disambiguation
Resolve official gene symbol (HGNC for human, MGI for mouse). Note common aliases for search expansion.
User Query Type Search Strategy
Specific accession Direct retrieval
Gene + condition "[gene] [condition]" + species filter
Disease only "[disease]" + species filter
Technology specific Add platform keywords
Phase 2: Data Retrieval (Internal)
Search silently. Do NOT narrate the process.
Fallback Chains
Primary Fallback
ArrayExpress search BioStudies search
arrayexpress get experiment biostudies get study
arrayexpress get experiment files Note "Files unavailable"
Phase 3: Report Dataset Profile
Present as a Dataset Search Report . Hide search process. Include:
1. Search Summary : query, databases searched, result count
2. Top Experiments (per experiment):
Accession, organism, type (RNA seq/microarray), platform, sample count, date
Description, experimental design (conditions, replicates, tissue)
Sample groups table, data files table
Quality assessment (●●●/●●○/●○○)
3. Multi Omics Studies (from BioStudies): accession, type, data types included
4. Summary Table : all experiments ranked
5. Recommendations : best dataset for user's purpose, integration notes
6. Data Access : download links, database URLs
Data Quality Tiers
Tier Symbol Criteria
High ●●● =3 bio replicates, complete metadata, processed data available
Medium ●●○ 2 3 replicates OR some metadata gaps
Low ●○○ No replicates, sparse metadata, or access issues
Caution ○○○ Single sample, no replication, outdated platform
Reasoning Framework
Dataset quality : Prioritize =3 biological replicates, complete annotations, both raw+processed data. Single replicate experiments can inform but not be sole evidence.
Platform comparison : RNA seq = wider dynamic range, novel transcripts. Microarray = probe limited but extensive legacy data. Cross platform combining requires batch correction.
Metadata scoring : Rate 0 5 on: (1) sample annotations, (2) design documented, (3) pipeline described, (4) raw data deposited, (5) publication linked. Score <=2 warrants caution.
GEO vs ArrayExpress : GEO has broader coverage (older studies); ArrayExpress enforces stricter metadata. BioStudies captures multi omics. Search both.
Synthesis Questions
1. Does the dataset have sufficient replication and metadata for the intended analysis?
2. Are there batch effects or confounding variables?
3. Do multiple datasets show concordant patterns, and can they be integrated?
Error Handling
Error Response
"No experiments found" Broaden keywords, remove species filter, try synonyms
"Accession not found" Verify format, check if withdrawn
"Files not available" Note: "Data files restricted by submitter"
"API timeout" Retry once, note "(metadata retrieval incomplete)"
Tool Reference
ArrayExpress : arrayexpress search experiments (search), arrayexpress get experiment (metadata), arrayexpress get experiment files (downloads), arrayexpress get experiment samples (annotations)
BioStudies : biostudies search (search), biostudies get study (metadata+sections), biostudies get study files (files)
Additional Sources :
GEO search rnaseq datasets / geo search datasets GEO (largest RNA seq repo)
OmicsDI search datasets cross repository aggregation (GEO+ArrayExpress+PRIDE+MassIVE)
GTEx get expression summary baseline tissue expression (54 normal tissues, param: gene symbol )
ENAPortal search studies sequencing studies (param: query with description="..." )
CxGDisc search datasets single cell datasets (needs exact disease ontology terms)
PubMed search articles dataset discovery via publications
Search Parameters
ArrayExpress : keywords (free text), species (scientific name), array (platform filter), limit
BioStudies : query (free text), limit