Skip to content

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PIASO-data

Genome reference files and tutorial datasets for PIASO (Precise Integrative Analysis of Single-cell Omics).

Tutorial Datasets

All datasets are hosted on Zenodo under concept DOI 10.5281/zenodo.19699638 (always resolves to the latest version; current version: record 22012620).

Dataset Species Cells Format Size Tutorial Reference
SEA-AD MTG 20K (raw) Human 20,000 h5ad 1.8 GB PIASO intro, plotting, color palettes Gabitto et al. Nat Neurosci (2024)
Adult Cortex Multiome RNA Mouse 17,412 h5ad 2.5 GB GDR, marker gene prediction, markerDB Bravo González-Blas et al. Nat Methods (2023)
10K Mouse Brain GEM-X v4 Mouse 11,357 10x h5 65.5 MB RNA pipeline (single sample) 10x Genomics
E18 Neurons 10K v3 Mouse ~10,000 10x h5 45.4 MB RNA pipeline (multi-sample) 10x Genomics
E18 Nuclei 5K v3.1 Mouse ~5,000 10x h5 19.3 MB RNA pipeline (multi-sample) 10x Genomics
E18 Neurons 10K GEM-X v4 Mouse ~10,000 10x h5 64.5 MB RNA pipeline (multi-sample) 10x Genomics
PBMC snMultiome SAN1 Human 3,545 10x h5 73.2 MB PBMC pipeline (multi-sample) De Rop et al. Nat Biotechnol (2024)
PBMC snMultiome SAN2 Human 4,360 10x h5 83.7 MB PBMC pipeline (single + multi) De Rop et al. Nat Biotechnol (2024)
PIASOmarkerDB Allen Immune Human CSV 115 KB PIASOmarkerDB API Gong et al. Nature (2025)

Cytome datasets

Ready-to-stream .cytome files — open them directly, no conversion step, constant memory at any scale:

Dataset (registry name) Species Cells Size Tutorial Reference
sea_ad_mtg_20k_cytome Human 20,000 269 MB cytome basics Gabitto et al. Nat Neurosci (2024)
adult_cortex_multiome_rna_cytome Mouse 17,412 192 MB GDR on cytome Bravo González-Blas et al. Nat Methods (2023)
allen_devvis_rna Mouse 200,061 1.4 GB GDR at scale Gao et al. Nature (2025)
humandevcx_38_rna Human 213,090 1.1 GB large-scale workflows Wang et al. Nature (2025)
humanlifespan_pfc_rna Human 1,501,089 25.7 GB million-cell streaming Catching et al. Cell Reports (2026)

Each file stores raw UMI counts (RNA_counts, verified integer at conversion) plus cell annotations from the source atlas.

import piaso

# Stream a 200k-cell dataset without loading it into memory
ds = piaso.data.load_dataset("allen_devvis_rna", return_type="cytome")

Programmatic access

import piaso

# List all available datasets
piaso.data.list_datasets()

# Download and load a dataset
adata = piaso.data.load_dataset("sea_ad_mtg_20k")

# Just download (returns local path)
path = piaso.data.fetch_dataset("mouse_brain_10k_gemx")

Files are cached in ~/.piaso/data/datasets/ by default. To use a different location (PIASO ≥ 1.2.1), any of these works — most specific wins:

piaso.data.fetch_dataset("allen_devvis_rna", data_dir="/big/disk/piaso")  # per call
piaso.settings.data_dir = "/big/disk/piaso"                               # per session
# or per machine:  export PIASO_DATA_DIR=/big/disk/piaso

The dataset registry (datasets.json) is fetched from this repo and cached locally for 24 h; piaso.data.refresh_registry() forces an update.

Genome References

hg38 (Human)

File Description
hg38_genes.bed Gene body BED (chrom, start, end, gene_name, score, strand)
hg38_promoterSet.bed Promoter regions BED
GRCh38-cCREs.CTCF-only.bed ENCODE cCREs CTCF-only sites
hg38.chrom.sizes Chromosome sizes
hg38_transcript_tss.bed Transcript TSS positions

mm10 (Mouse)

File Description
mm10_genes.bed Gene body BED (chrom, start, end, gene_name, score, strand)
mm10_promoterSet.bed Promoter regions BED
mm10-cCREs.CTCF-only.bed ENCODE cCREs CTCF-only sites
mm10.chrom.sizes Chromosome sizes
mm10_transcript_tss.bed Transcript TSS positions

Genome usage

import piaso

# Auto-download genome files (fetches from this repo)
piaso.data.fetch_genome("hg38")
piaso.data.fetch_genome("mm10")

Manual genome installation

mkdir -p ~/.piaso/data
tar -xzf hg38.tar.gz -C ~/.piaso/data/
tar -xzf mm10.tar.gz -C ~/.piaso/data/

References

  • Gabitto, M.I., Travaglini, K.J., Rachleff, V.M. et al. Integrated multimodal cell atlas of Alzheimer's disease. Nat Neurosci 27, 2366–2383 (2024). DOI: 10.1038/s41593-024-01774-5
  • Bravo González-Blas, C., De Winter, S., Hulselmans, G. et al. SCENIC+: single-cell multiomic inference of enhancers and gene regulatory networks. Nat Methods 20, 1355–1367 (2023). DOI: 10.1038/s41592-023-01938-4
  • De Rop, F.V., Hulselmans, G., Flerin, C. et al. Systematic benchmarking of single-cell ATAC-sequencing protocols. Nat Biotechnol 42, 916–926 (2024). DOI: 10.1038/s41587-023-01881-x
  • Gao, Y., van Velthoven, C.T.J., Lee, C. et al. Continuous cell-type diversification in mouse visual cortex development. Nature 647, 127–142 (2025). DOI: 10.1038/s41586-025-09644-1
  • Wang, L., Wang, C., Moriano, J.A. et al. Molecular and cellular dynamics of the developing human neocortex. Nature 647, 169–178 (2025). DOI: 10.1038/s41586-024-08351-7
  • Catching, A., Weller, C.A., Hu, F. et al. Single-nucleus multiome analysis in the human prefrontal cortex identifies gene expression and cis-regulatory elements associated with aging. Cell Reports 45, 117110 (2026). DOI: 10.1016/j.celrep.2026.117110
  • Gong, Q., Sharma, M., Glass, M.C. et al. Multi-omic profiling reveals age-related immune dynamics in healthy adults. Nature 648, 696–706 (2025). DOI: 10.1038/s41586-025-09686-5

License

Genome reference files are derived from public annotations (UCSC, ENCODE). Tutorial datasets are redistributed under CC BY 4.0 with attribution to original sources.

About

Genome reference files and tutorial datasets for PIASO

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors