sequana/pacbio_qc - Githubissues

.. image:: https://badge.fury.io/py/sequana-pacbio-qc.svg :target: https://pypi.python.org/pypi/sequana_pacbio_qc

.. image:: http://joss.theoj.org/papers/10.21105/joss.00352/status.svg :target: http://joss.theoj.org/papers/10.21105/joss.00352 :alt: JOSS (journal of open source software) DOI

.. image:: https://github.com/sequana/pacbio_qc/actions/workflows/main.yml/badge.svg :target: https://github.com/sequana/pacbio_qc/actions/workflows

.. image:: https://img.shields.io/badge/python-3.8%20%7C%203.9%20%7C3.10-blue.svg :target: https://pypi.python.org/pypi/sequana :alt: Python 3.8 | 3.9 | 3.10

.. image:: http://joss.theoj.org/papers/10.21105/joss.00352/status.svg :target: http://joss.theoj.org/papers/10.21105/joss.00352 :alt: JOSS (journal of open source software) DOI

|Codacy-Grade|

This is is the pacbio_qc pipeline from the Sequana <https://sequana.readthedocs.org>_ projet

:Overview: Quality control for pacbio datafiles (raw data or CCS files).

:Input: BAM files provided by Pacbio Sequencers. :Output: HTML reports with various plots including taxonomic plot :Status: production :Documentation: This README file, the Wiki from the github repository (link above) and https://sequana.readthedocs.io :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


Just install this package::

    pip install sequana_pacbio_qc

You will need **samtools** and  **kraken2** (optional) for the taxonomic analysis.

Usage

sequana_pacbio_qc --help
sequana_pacbio_qc --input-directory DATAPATH

If you want to filter out some BAM files, you may use the pattern in tab 'input data'.

In the configuration tab, in the kraken section add as many databases as you wish. You may simply unset the first database to skip the taxonomy, which is experimental.

This creates a directory with the pipeline and configuration file. You will then need to execute the pipeline::

cd pacbio_qc
sh pacbio_qc.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 pacbio_qc.rules -c config.yaml --cores 4 --stats stats.txt

Or use sequanix <https://sequana.readthedocs.io/en/main/sequanix.html>_ interface.

Requirements


This pipelines requires the following executable(s):

- sequana
- samtools
- kraken2
- multiqc

.. image:: https://raw.githubusercontent.com/sequana/pacbio_qc/main/sequana_pipelines/pacbio_qc/dag.png

Details

This pipeline takes as inputs a set of BAM files from Pacbio sequencers. It computes a set of basic statistics related to the read lengths. It also shows some histograms related to the GC content, SNR of the diodes and the number of passes Finally, a quick taxonomy can be performed using Kraken. HTML reports are created for each sample as well as a multiqc summary page.

Kraken databases are not provided with the pipeline. This step is optional and not used by default.

Changelog

========= ====================================================================
Version   Description
========= ====================================================================
1.0.1     fix missing import in the summary 
1.0.0     Uses latest wrappers and graphviz apptainers
0.11.0    Release to use latests sequana_pipetools framework
0.10.0    Update to use latest tools from sequana framework
0.9.0     First release of sequana_pacbio_qc using latest sequana rules and
          modules (0.9.5)
========= ====================================================================

Contribute & Code of Conduct

To contribute to this project, please take a look at the Contributing Guidelines <https://github.com/sequana/sequana/blob/main/CONTRIBUTING.rst> first. Please note that this project is released with a Code of Conduct <https://github.com/sequana/sequana/blob/main/CONDUCT.md>. By contributing to this project, you agree to abide by its terms.

Rules and configuration details



Here is the `latest documented configuration file <https://raw.githubusercontent.com/sequana/sequana_pacbio_qc/main/sequana_pipelines/pacbio_qc/config.yaml>`_
to be used with the pipeline. Each rule used in the pipeline may have a section in the configuration file. 

.. |Codacy-Grade| image:: https://app.codacy.com/project/badge/Grade/9b8355ff642f4de9acd4b270f8d14d10
   :target: https://www.codacy.com/gh/sequana/pacbio_qc/dashboard

sequana / pacbio_qc

readme