Sample Ingestion

Panomics supports the ingestion of transcriptomics samples from local and remote sources. The ingestion process requires a Standard Compute runtime.

Ingestion Workflow

Sample ingestion is a straightforward, multi-step process.

We recommend users upload samples in a project. This makes tracking and metadata setting simpler.

1

Create a project for your study

Once the project is created, go to the Samples tab and click on the Import Samples button in the grid toolbar.

2

Select the sample type

Choose one of the supported modalities.

3

Select the sample file mode

In Panomics, the concept of file mode was introduced to distinguish between one file per dataset (gene by samples or cells) and one file per sample (output from Salmon quantification).

single - each sample will be uploaded as an individual file

combined - all samples are represented in a single file

4

Select the sample source

Users can import samples from their local disk, Panomics assets, AWS S3 or DNAnexus. For AWS and DNAnexus, an external API key must be configured.

5

Select the files

Depending on the sample source, this step will differ.

1. Local disk - drop your files in the upload area.

2. Panomics Assets - select the Panomics project and then select the files you wish to import.

3. AWS S3 - input the name of the S3 bucket, the prefix, and a regex to select only the files you intend to import.

4. DNAnexus - select the DNAnexus project and a regex to select only the files you intend to import.

6

Input sample attributes

1. Batch ID - auto-generated ID to help you identify the sample batch easily.

2. Organism - the organism of the sample donors.

3. Gene column - the name of the column that refers to the gene ID or gene symbol. Supported IDs are Ensemble and Entrez. Applies to CSV file inputs.

4. Normalized counts - whether you are uploading normalized counts.

5. Strip prefix characters - whether you would like the platform to strip one or more characters from the beginning of the sample names. This is useful if your sample names are numeric only, but the output was generated in R, which adds an X.

6. First sample column index - for combined samples, indicate what column index represents the first sample (zero-based).

Supported file inputs

Microarray

Panomics supports the ingestion of normalized intensities files that have been mapped to gene IDs or gene symbols. Only the combined sample file mode is accepted.

Accepted formats: .txt, .csv, .tsv, .gz

Example file:

5MB

GSE133715_expression.csv

Microarray input file

RNA-seq and sRNA-seq

Panomics supports the ingestion of raw or normalized bulk RNA-seq samples. Both single and combined file modes are accepted.

Accepted formats: .txt, .csv, .tsv, .gz

Single file mode sample data:

2MB

SRR3184306.transcriptome.genes.results.gz

2MB

SRR3184305.transcriptome.genes.results.gz

Combined file mode sample data:

37KB

GSE136961_raw_count_clean.csv

scRNA-seq and snRNA-seq

For single cell or single nucleus RNA-seq samples, only the single file mode is currently supported.

Accepted formats: .txt, .csv, .tsv, .h5, .h5ad, .gz, .tar.gz

Tar gz files must contain 3 files that follow this convention:

• GSM5474339_AD5_barcodes.tsv.gz

• GSM5474339_AD5_features.tsv.gz

• GSM5474339_AD5_matrix.mtx.gz

Sample data:

20MB

GSM5474339.zip

archive

Sample ingestion demo videos

Bulk RNA-seq using the combined samples file mode

Single-cell RNA-seq using zipped barcodes, features, matrix files