Skip to content

ebi-gene-expression-group/isl_refs_to_refgenie

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Copy legacy ISL genome resources to Refgenie assets

This workflow is designed to copy all of the base genome resources used by the gene expression group to new Refgenie assets.

Prerequisites

  • Conda
  • Nextflow

Usage

nextflow run isl_refs_to_refgenie/main.nf \
    --mode=<type of salmon index: [normal, splici, both]> \
    --irapConfigDir=<path to directory with species-wise configuration files as used by IRAP> \
    --irapDataDir=<path to top level IRAP data directory, with 'references' subdirectory> \
    --refgenieDir=<path to refgenie top directory> \
    --islGenomes=<path togenome_references.conf>

What's done

workflow schematic

Input file

Input files are discovered for each species:

  1. Current reference genome file from species configs
  2. Current cDNA reference file from species configs
  3. Current GTF annotation file from species configs
  4. Newest cDNA FASTA matching pattern in genome_references.conf
  5. Newest GTF matching pattern in genome references.com
  6. Bacterial, fungal and viral sequence files, to be used in contamination checks.

Building Refgenie assets

The plain base genome FASTA is used as the root asset for an assembly. All others (cDNAs, GTFs etc) are sub-assets of that. Genomes, transcriptomes and GTFs are also combined with spike-ins (currently just ERCC) and built/indexed under a separate root asset. The intron-containing splici transcriptome asset is build with pyroe make-splici from the genome FASTA.

Genome indices

All genome resources are indexed by hisat2. Contamination indices are also indexed by Bowtie2.

Transcriptome indices

Each of the 4 transcriptome assets for each species (current and newest, with/without spikes) is indexed by both Kallisto and Salmon, with versions picked to match our single-cell pipelines. The Salmon indices can be eiher build with the cDNA ('normal') or an intron containing transcriptome can be indexed ('splici'). When running with --mode both, both normal and splici salmon index are generated.

Result

Top-level resources are named like ``species--assembly[--spikesname]`:

> refgenie list
                                                                     Local refgenie assets                                                                     
                                                      Server subscriptions: http://refgenomes.databio.org                                                      
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ genome                                                                        ┃ assets                                                                      ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ homo_sapiens--GRCh38                                                          │ fasta, fasta_txome, ensembl_gtf, salmon_index, kallisto_index, hisat2_index │
│ homo_sapiens--GRCh38--spikes_ercc                                             │ fasta, fasta_txome, ensembl_gtf, salmon_index, kallisto_index, hisat2_index │
│ escherichia_coli--str_k_12_substr_mg1655_ASM584v2                             │ fasta, hisat2_index                                                         │
│ fungi--refseq_fungi_53                                                        │ fasta, hisat2_index                                                         │
│ viruses--refseq_viral_2_1                                                     │ fasta, hisat2_index                                                         │
│ escherichia_coli-fungi--str_k_12_substr_mg1655_ASM584v2-refseq_fungi_53       │ fasta, bowtie2_index, hisat2_index                                          │
│ fungi-viruses--refseq_fungi_53-refseq_viral_2_1                               │ fasta, hisat2_index, bowtie2_index                                          │
│ escherichia_coli-viruses--str_k_12_substr_mg1655_ASM584v2-refseq_viral_2_1    │ fasta, hisat2_index, bowtie2_index                                          │
│ escherichia_coli-fungi-viruses--str_k_12_substr_mg1655_ASM584v2-refseq_fungi… │ fasta, hisat2_index, bowtie2_index                                          │
│ escherichia_coli--str_k_12_substr_mg1655_ASM584v2--spikes_ercc                │ fasta, hisat2_index                                                         │
│ fungi--refseq_fungi_53--spikes_ercc                                           │ fasta, hisat2_index                                                         │
│ viruses--refseq_viral_2_1--spikes_ercc                                        │ fasta, hisat2_index                                                         │
│ escherichia_coli-fungi--str_k_12_substr_mg1655_ASM584v2-refseq_fungi_53--spi… │ fasta, hisat2_index                                                         │
│ escherichia_coli-viruses--str_k_12_substr_mg1655_ASM584v2-refseq_viral_2_1--… │ fasta, hisat2_index                                                         │
│ escherichia_coli-fungi-viruses--str_k_12_substr_mg1655_ASM584v2-refseq_fungi… │ fasta, hisat2_index                                                         │
│ fungi-viruses--refseq_fungi_53-refseq_viral_2_1--spikes_ercc                  │ fasta, hisat2_index                                                         │
└───────────────────────────────────────────────────────────────────────────────┴─────────────────────────────────────────────────────────────────────────────┘
                                                     use refgenie list -g <genome> for more detailed view                                                      

(note the separate spike-in genomes for the main species, only human here).

Child assets for an assembly are named to indicate their type (e.g. genome, cDNA) where that's not clear from the asset type, the associated genome resource (e.g. Ensembl) releases, and by the version of software used to generate them (where applicable, specifically indexes):

> refgenie list -g homo_sapiens--GRCh38

                                                                     Local refgenie assets                                                                     
                                                      Server subscriptions: http://refgenomes.databio.org                                                      
┏━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ genome               ┃ asset (seek_keys)                                              ┃ tags                                                                ┃
┡━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ homo_sapiens--GRCh38 │ fasta (fasta, fai, chrom_sizes, dir)                           │ genome                                                              │
│ homo_sapiens--GRCh38 │ fasta_txome (fasta_txome, fai, chrom_sizes, dir)               │ cdna_ensembl104, cdna_newest, cdna_ensembl95, cdna_current          │
│ homo_sapiens--GRCh38 │ ensembl_gtf (ensembl_gtf, ensembl_tss, ensembl_gene_body, dir) │ ensembl104, newest, ensembl95, current                              │
│ homo_sapiens--GRCh38 │ salmon_index (salmon_index, dir)                               │ cdna_ensembl104--salmon_v1.2.0, cdna_ensembl95--salmon_v1.2.0,      │
│                      │                                                                │ cdna_newest--salmon_v1.2.0, cdna_current--salmon_v1.2.0             │
│ homo_sapiens--GRCh38 │ kallisto_index (kallisto_index, dir)                           │ cdna_ensembl104--kallisto_v0.45.0,                                  │
│                      │                                                                │ cdna_ensembl95--kallisto_v0.45.0, cdna_current--kallisto_v0.45.0,   │
│                      │                                                                │ cdna_newest--kallisto_v0.45.0                                       │
│ homo_sapiens--GRCh38 │ hisat2_index (hisat2_index, dir)                               │ genome--hisat2_v2.1.0                                               │
└──────────────────────┴────────────────────────────────────────────────────────────────┴─────────────────────────────────────────────────────────────────────┘

> refgenie list -g  homo_sapiens--GRCh38--spikes_ercc
                                                                     Local refgenie assets                                                                     
                                                      Server subscriptions: http://refgenomes.databio.org                                                      
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ genome                            ┃ asset (seek_keys)                                          ┃ tags                                                       ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ homo_sapiens--GRCh38--spikes_ercc │ fasta (fasta, fai, chrom_sizes, dir)                       │ genome                                                     │
│ homo_sapiens--GRCh38--spikes_ercc │ fasta_txome (fasta_txome, fai, chrom_sizes, dir)           │ cdna_ensembl95, cdna_current, cdna_ensembl104, cdna_newest │
│ homo_sapiens--GRCh38--spikes_ercc │ ensembl_gtf (ensembl_gtf, ensembl_tss, ensembl_gene_body,  │ ensembl104, newest, ensembl95, current                     │
│                                   │ dir)                                                       │                                                            │
│ homo_sapiens--GRCh38--spikes_ercc │ salmon_index (salmon_index, dir)                           │ cdna_ensembl95--salmon_v1.2.0,                             │
│                                   │                                                            │ cdna_ensembl104--salmon_v1.2.0,                            │
│                                   │                                                            │ cdna_current--salmon_v1.2.0, cdna_newest--salmon_v1.2.0    │
│ homo_sapiens--GRCh38--spikes_ercc │ kallisto_index (kallisto_index, dir)                       │ cdna_ensembl95--kallisto_v0.45.0,                          │
│                                   │                                                            │ cdna_ensembl104--kallisto_v0.45.0,                         │
│                                   │                                                            │ cdna_current--kallisto_v0.45.0,                            │
│                                   │                                                            │ cdna_newest--kallisto_v0.45.0                              │
│ homo_sapiens--GRCh38--spikes_ercc │ hisat2_index (hisat2_index, dir)                           │ genome--hisat2_v2.1.0                                      │
└───────────────────────────────────┴────────────────────────────────────────────────────────────┴────────────────────────────────────────────────────────────┘

Note that the spiked assemblies have all the same assets as the unspikes ones.

About

Build refgenie assets from existing ISL reference configs

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published