Skip to main content

A multi-sample identification of ribosomal content

Project description

https://badge.fury.io/py/sequana-ribofinder.svg JOSS (journal of open source software) DOI https://github.com/sequana/ribofinder/actions/workflows/main.yml/badge.svg Python 3.8 | 3.9 | 3.10

This is is the ribofinder pipeline from the Sequana project

Overview:

Simple parallele workflow to detect and report ribosomal content

Input:

FastQ files

Output:

HTML reports

Status:

production

Citation:

Cokelaer et al, (2017), ‘Sequana’: a Set of Snakemake NGS pipelines, Journal of Open Source Software, 2(16), 352, JOSS DOI doi:10.21105/joss.00352

Installation

Using pip from Python, just install this package:

pip install sequana_ribofinder --upgrade

The –upgrade option is to make sure you’ll get the latest version.

Usage

This pipeline scans input fastq.gz files found in the local directory and identify the proportion of ribosomal content.

For help, please type:

sequana_ribofinder --help

The following command searches for input files in DATAPATH. Then, te user provide a list of rRNA sequences in FastA format in test.fasta. This command creates a directory called ribofinder/ where a snakemake pipeline can:

sequana_ribofinder --input-directory DATAPATH --rRNA-file test.fasta

You will then need to execute the pipeline:

cd ribofinder
sh ribofinder.sh  # for a local run

This launch a snakemake pipeline. If you are familiar with snakemake, you can retrieve the pipeline itself and its configuration files and then execute the pipeline yourself with specific parameters:

snakemake -s ribofinder.rules -c config.yaml --cores 4 --wrapper-prefix git+file:////home/user/sequana_wrappers

Or use sequanix interface.

Requirements

This pipelines requires the following executable(s):

  • bowtie1 >= 1.3.0

  • bedtools

  • samtools

  • bamtools

  • pigz

https://raw.githubusercontent.com/sequana/ribofinder/master/sequana_pipelines/ribofinder/dag.png

Details

This pipeline runs ribofinder in parallel on the input fastq files. A brief sequana summary report is also produced.

You can start from the reference file and the GFF file. By default we search for the feature called rRNA to be found in the GFF file:

sequana_ribofinder --input-directory . --reference-file genome.fasta --gff-file genome.gff

If the default feature rRNA is not found, no error is raised for now. If you know the expected feature, you can provide it though:

sequana_ribofinder --input-directory . --reference-file genome.fasta --gff-file genome.gff --rRNA-feature gene_rRNA

If you have an existing or custom rRNA file, you can then use it as follows, in which case, no input reference is required:

sequana_ribofinder --input-directory . --rRNA-file ribo.fasta

Rules and configuration details

Here is the latest documented configuration file to be used with the pipeline. Each rule used in the pipeline may have a section in the configuration file.

Changelog

Version

Description

1.1.1

  • hotfix for running on HPC (slurm)

1.1.0

  • Uses click (refactoring of sequana_pipetools)

1.0.1

  • add sequana_wrappers in the config/pipeline

1.0.0

  • use graphviz apptainer and latest wrappers

0.13.0

  • add final apptainers and update CI actions

0.12.0

  • set singularity containers

0.11.1

  • Fix config file (removing hard-coded path)

0.11.0

  • Fix multiqc plot using same fix as in sequna_rnaseq pipelines

  • add utility plot to check rate of ribosomal per sequence and also the corresponding RPKM.

0.10.2

  • Fix the bowtie1 rule (all samples were named bowtie1)

0.10.1

  • add additional test and fix bug in pipeline (regression bug)

0.10.0

  • Update to use sequana-wrappers. Remove multiqc. summary.html is self-content

0.9.3

  • fix logger

0.9.2

First release.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sequana_ribofinder-1.1.1.tar.gz (33.9 kB view details)

Uploaded Source

Built Distribution

sequana_ribofinder-1.1.1-py3-none-any.whl (33.3 kB view details)

Uploaded Python 3

File details

Details for the file sequana_ribofinder-1.1.1.tar.gz.

File metadata

  • Download URL: sequana_ribofinder-1.1.1.tar.gz
  • Upload date:
  • Size: 33.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.6

File hashes

Hashes for sequana_ribofinder-1.1.1.tar.gz
Algorithm Hash digest
SHA256 658938cfcd4d9dffadf5d243105e7dc27731985639e9b8dc12b7f3e0020ad9e0
MD5 0ea3bac42f50c862a05f4bfd48ebdcb1
BLAKE2b-256 3a005086b88360b00825f0529048fec06c618c47c94827e3ee5b8c73c1a4a012

See more details on using hashes here.

File details

Details for the file sequana_ribofinder-1.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for sequana_ribofinder-1.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 347f114d5688a98d05b1b7ee3e2e247ea59c77ed92a44bbbca5f39a0f512fbc7
MD5 5cf29315a1e229a0e1d499f8ee4a5d2a
BLAKE2b-256 3741a1fd2d18dbff4feb972186963390b6383f18129b5dbd961f8498ddcd409b

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page