Skip to content

Latest commit

 

History

History
216 lines (178 loc) · 8.72 KB

README.md

File metadata and controls

216 lines (178 loc) · 8.72 KB
Raw

tabula-muris

The Tabula muris data was generated by the Chan Zuckerberg Biohub. For a detailed description of the project please refer to our publication Transcriptomic characterization of 20 organs and tissues from mouse at single cell resolution creates a Tabula Muris. The Tabula muris project is a a compendium of single cell transcriptomic data from the mouse containing nearly 100,000 cells from 20 organs and tissues. The data allow for direct and controlled comparison of gene expression in cell types shared between tissues, such as immune cells from distinct anatomical locations. The resource also enables contrasting two distinct technical approaches:

  • microfluidic droplet-based 3'-end counting, which provides a survey of thousands of cells per organ at relatively low coverage.
  • FACS-based full length transcript analysis, which provides higher sensitivity and coverage.

This rich collection of annotated cells will be a useful resource for:

  • Defining gene expression in previously poorly-characterized cell populations.
  • Validating findings in future targeted single-cell studies.
  • Developing of methods for integrating datasets (eg between the FACS and droplet experiments), characterizing batch effects, and quantifying the variation of gene expression in many cell types between organs and animals.

Since late 2017, Tabula muris data have been made available to all users free of charge. AWS has made the data freely available on Amazon S3 so that anyone can download the resource to perform analysis and advance medical discovery without needing to worry about the cost of storing Tabula muris data or the time required to download it.

Learn more about how Tabula muris data is used in the project vignettes repo.

Installation - Python

To install the Python dependencies, create a tabula-muris-env environment by using the environment.yml file provided:

conda env create -f environment.yml

Activate the environment and install it to your Jupyter notebook with:

source activate tabula-muris-env
python -m ipykernel install --user --name tabula-muris-env --display-name "Python 3.6 (tabula-muris-env)"

Installation - R

Packages:

install.packages(c("here", "Seurat", "useful", "ontologyIndex", "tidyverse"))

Getting started

From "raw" gene-cell counts tables

If you want to start from the raw gene-cell counts tables, then first download the data from figshare. You can download manually from the links (FACS and Droplet) or run a script we've prepared:

bash 00_data_ingest/download_data.sh

This will download two zip files,droplet_raw_data.zip and facs_raw_data.zip and unzip them into the folder structure described below. Then you'll have two folders in 00_data_ingest (the location is important - everything here depends on the folder structure).

FACS

The FACS folder should look like this:

00_facs_raw_data
├── FACS
│   ├── Aorta-counts.csv
│   ├── Bladder-counts.csv
│   ├── Brain_Myeloid-counts.csv
│   ├── Brain_Non-Myeloid-counts.csv
│   ├── Diaphragm-counts.csv
│   ├── Fat-counts.csv
│   ├── Heart-counts.csv
│   ├── Kidney-counts.csv
│   ├── Large_Intestine-counts.csv
│   ├── Limb_Muscle-counts.csv
│   ├── Liver-counts.csv
│   ├── Lung-counts.csv
│   ├── Mammary_Gland-counts.csv
│   ├── Marrow-counts.csv
│   ├── Pancreas-counts.csv
│   ├── Skin-counts.csv
│   ├── Spleen-counts.csv
│   ├── Thymus-counts.csv
│   ├── Tongue-counts.csv
│   └── Trachea-counts.csv
├── FACS.zip
├── annotations_FACS.csv
└── metadata_FACS.csv

Droplet

Now your droplet folders should look like this:

01_droplet_raw_data
├── annotations_droplet.csv
├── droplet
│   ├── Bladder-10X_P4_3
│   ├── Bladder-10X_P4_4
│   ├── Bladder-10X_P7_7
│   ├── Heart_and_Aorta-10X_P7_4
│   ├── Kidney-10X_P4_5
│   ├── Kidney-10X_P4_6
│   ├── Kidney-10X_P7_5
│   ├── Limb_Muscle-10X_P7_14
│   ├── Limb_Muscle-10X_P7_15
│   ├── Liver-10X_P4_2
│   ├── Liver-10X_P7_0
│   ├── Liver-10X_P7_1
│   ├── Lung-10X_P7_8
│   ├── Lung-10X_P7_9
│   ├── Lung-10X_P8_12
│   ├── Lung-10X_P8_13
│   ├── Mammary_Gland-10X_P7_12
│   ├── Mammary_Gland-10X_P7_13
│   ├── Marrow-10X_P7_2
│   ├── Marrow-10X_P7_3
│   ├── Spleen-10X_P4_7
│   ├── Spleen-10X_P7_6
│   ├── Thymus-10X_P7_11
│   ├── Tongue-10X_P4_0
│   ├── Tongue-10X_P4_1
│   ├── Tongue-10X_P7_10
│   ├── Trachea-10X_P8_14
│   └── Trachea-10X_P8_15
├── droplet.zip
└── metadata_droplet.csv

All of the *-10X_* folders contain a barcodes.tsv, genes.tsv, and matrix.mtx file as output by cellranger from 10X genomics.

01_droplet_raw_data/droplet/Bladder-10X_P4_3
├── barcodes.tsv
├── genes.tsv
└── matrix.mtx

Folder Organization

  • FACS = SmartSeq2 on FACS-sorted plates
  • Microfluidic = 10x droplet-based unique molecular identifier (UMI)-barcoded transcripts and cells
tabula_muris/
    00_data_ingest/               # How the data was processed from gene-cell tables
        README.md
        download_robj.Rmd         # Download R objects for figures using this script
        02_tissue_analysis_rmd/                  # *Generate* R objects for figures yourself
            Aorta_facs.Rmd
            Brain-Non-microglia_facs.Rmd
            Brain-Microglia_facs.Rmd
            Bladder_facs.Rmd
            Bladder_droplet.Rmd
            Colon_facs.Rmd
            Heart_facs.Rmd
            Heart_droplet.Rmd
            ... more files ...
        03_tissue_annotation_csv/
            Aorta_facs_annotation.csv
            Brain-Non-microglia_facs_annotation.csv
            Brain-Microglia_facs_annotation.csv
            Bladder_facs_annotation.csv
            Bladder_droplet_annotation.csv
            Colon_facs_annotation.csv
            Heart_facs_annotation.csv
            Heart_droplet_annotation.csv
            ... more files ...
        04_tissue_robj_generated/
        10_tissue_robj_downloaded/
        11_global_robj/
        12_extract_number_of_genes_cells/
        13_ngenes_ncells_facs/
        14_ngenes_ncells_droplet/
        15_color_palette/
        16_genes_for_tissue_tsne/
        20_dissociation_genes/
        All_Droplet_Notebook.Rmd
        All_FACS_Notebook.Rmd
        Droplet_Notebook.Rmd
        FACS_Notebook.Rmd
        README.md
        cell_order_FACS.txt
        cell_order_droplets.txt
        download_data.sh
    01_figure1/                   # Overview + #cell barplots + #gene/#reads horizonplots
        README.md
        figure1{b-g}.ipynb
    02_figure2/                   # FACS TSNE plots + annotation barplots
        README.md
        figure2a.Rmd
        figure2b.Rmd
        figure2c.ipynb
    03_figure3/                   # All-cell clustering heatmap with dendrogram
        figure3.Rmd
    04_figure4/                   # Analysis of all T cells sorted by FACS
        figure4{a-d}.Rmd
    05_figure5/                   # Transcription factor expression analysis
        figure5.Rmd
    11_supplementary_figure1/     # Histograms of number of genes detected across tissues
    12_supplementary_figure2/     # FACS vs Microfluidics - # cells expressing a gene
    13_supplementary_figure3/     # FACS vs Microfluidics - # genes detected per cell
    14_supplementary_figure4/     # FACS vs Microfluidics - dynamic range
    15_supplementary_figure5/     # Microfluidics TSNE plots + annotation barplots
    16_supplementary_figure6/     # Analysis of dissociation-induced genes
    17_supplementary_figure7/     # Transcription factor enrichment in cell types

How to cite this dataset

If you find the Tabula muris data useful for your research please cite our publication

Contact

If you have questions about the data, you can create an Issue at the project repo on GitHub.

License

There are no restrictions on the use of data received from the Chan Zuckerberg Biohub, unless expressly identified prior to or at the time of receipt.