/dockstore-cgpwgs

Dockstore implementation of CGP core WGS analysis

Primary LanguageShellGNU Affero General Public License v3.0AGPL-3.0

dockstore-cgpwgs

dockstore-cgpwgs provides a complete multi threaded WGS analysis for SNV, INDEL, SV and Copynumber variation with associated annotation of VCF files. This has been packaged specifically for use with the Dockstore.org framework.

Gitter Badge

Quay Badge

Master Develop
Master Badge Develop Badge

Usage

This is intended to be run using the Dockstore.org framework under docker but can be executed as a normal docker container (or imported into singularity.

See the dockstore execution method here.

You should see the usage for the ds-cgpwgs.pl script for all parameters (or the cwl definition).

Required input files are

  1. Tumour BAM file
  2. Normal BAM file
  3. Core reference archive (e.g. core_ref_GRCh37d5.tar.gz)
  4. WXS reference archive (e.g. SNV_INDEL_ref_GRCh37d5.tar.gz)
  5. WGS reference archive (e.g. CNV_SV_ref_GRCh37d5_brass6+.tar.gz)
  6. VAGrENT (annotation) reference archive (e.g. VAGrENT_ref_GRCh37d5_ensembl_75.tar.gz)
  7. Subclonal reference archive (SUBCL_ref_GRCh37d5.tar.gz)
  • Only needed if skipbb is false
  1. QC reference archive (e.g. qcGenotype_GRCh37d5.tar.gz)

Inputs 1&2 are expected to have been mapped using dockstore-cgpmap

Please check the Wiki then raise an issue if you require additional information on how to generate your own reference files. Much of this information is available on the individual algorithm wiki pages (or the subsequently linked protocols papers).

Usable Cores

When running outside of a docker container you can set the number of CPUs via:

  • export CPU=N
  • -cores|-c option of ds-cgpwgs.pl

If not set detects available cores on system.

Other uses

Native docker

All of the tools installed as part of dockstore-cgpmap and dockstore-cgpwxs and the above packages are available for direct use.

See the docker guide in the wiki for more details.

Singularity

The resulting docker container has been tested with Singularity.

See the docker guide in the wiki for more details.

Verifying your deployment

The examples/ tree contains test json files populated with data that can be used to verify the tool.

Example data

The data linked in the 'examples' area is from the cell line COLO-829.

Diagram of internals

This diagram was generated based on v1.1.0, it does not describe any of the file provisioning handled by a Dockstore run.

Internal flow of docker image

Development environment

This project uses git pre-commit hooks. Please enable them to prevent inappropriate large files being included. Any pull request found not to have adhered to this will be rejected and the branch will need to be manually cleaned to keep the repo size down.

Activate the hooks with

git config core.hooksPath git-hooks

Release process

This project is maintained using HubFlow.

  1. Make appropriate changes
  2. Build image locally
  3. Run all example inputs and verify any changes are acceptable
  4. Bump version in Dockerfile and Dockstore.cwl
  5. Push changes
  6. Check state on Travis
  7. Generate the release (add notes to GitHub)
  8. Confirm that image has been built on quay.io
  9. Update the dockstore entry, see their docs.

LICENCE

Copyright (c) 2017-2019 Genome Research Ltd.

Author: Cancer Genome Project <cgphelp@sanger.ac.uk>

This file is part of dockstore-cgpwgs.

dockstore-cgpwgs is free software: you can redistribute it and/or modify it under
the terms of the GNU Affero General Public License as published by the Free
Software Foundation; either version 3 of the License, or (at your option) any
later version.

This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
details.

You should have received a copy of the GNU Affero General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.

1. The usage of a range of years within a copyright statement contained within
this distribution should be interpreted as being equivalent to a list of years
including the first and last year specified and all consecutive years between
them. For example, a copyright statement that reads ‘Copyright (c) 2005, 2007-
2009, 2011-2012’ should be interpreted as being identical to a statement that
reads ‘Copyright (c) 2005, 2007, 2008, 2009, 2011, 2012’ and a copyright
statement that reads ‘Copyright (c) 2005-2012’ should be interpreted as being
identical to a statement that reads ‘Copyright (c) 2005, 2006, 2007, 2008,
2009, 2010, 2011, 2012’."