Breakpoints via assembly - Identifies breaks and attempts to assemble rearrangements.
Branch: dev
Clone or download
sb43 Merge tag '6.2.0' into dev
* Fixed bug where subset of intervals does not have reads -issue#65
* Informative error when .bas file is absent - issue#71
* temp file were now kept after running filter step - issue#73
* Fixed issue#66
* Added script to process centro/telomere data - issue#70
* Fixed bug where intermediate file name matches with one of the sample
Latest commit d08d174 Nov 1, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Rsupport
c++ C++11 compatibility fix [minor] Jul 9, 2018
distros Migration from CGP internal git repo Oct 31, 2014
perl added release note and updated version Nov 1, 2018
scripts Added a script to process UCSC centro/telo data for input to BRASS Jul 25, 2018
.gitignore updated libInstal.R to point to original copynumber package Oct 10, 2018
.travis.yml develop not dev branch of PCAP-core in `.travis.yml` Mar 27, 2018
CHANGES.md added release note and updated version Nov 1, 2018
Contributors.txt Adds in pre-github contibutor information, resolves #12 Mar 30, 2015
LICENSE Initial commit Oct 31, 2014
README.md Fix link to legacy ICGC version of PCAP-core Mar 15, 2018
prerelease.sh Update dates/email in license blocks Mar 12, 2018
setup.sh Fix type of equality used Mar 13, 2018

README.md

BRASS

Master Develop
Master Badge Develop Badge

Breakpoints via assembly

BRASS analyses one or more related BAM files of paired-end sequencing to determine potential rearrangement breakpoints.

There are several stages the main component being:

  1. Collect read-pairs where both ends map but NOT marked as properly-paired.
  2. Perform grouping based on mapped locations
  3. Filter
  4. Run assembly
  5. Annotate with GRASS

Quick installation

./setup.sh path_to_install_to

Skipping all external dependencies

If you want to only install the core of BRASS (C and perl wrappers) and use existing versions of tools from your path run as:

./setup.sh path_to_install_to 1

Skipping exonerate install

Central install via package manager of 2.2.0 is adequate. To skip just exonerate install run:

./setup.sh path_to_install_to 2

Pre-requisites

  • The C++ code (within this package) requires the presence of pstreams.h (and associated development libraries). This is not handled by the setup.sh script.

Perl packages:

Each of these has it's own dependencies.

R packages

A large number of R packages are required to run BRASS. To facilitate the install process there is a script Rsupport/libInstall.R that can be run to build these for you. See this file for the list of packages.

Alternatively you can run:

cd Rsupport
./setupR.sh path_to_install_to

Appending 1 to the command will request a complete local build of R (3.1.3).

Other tools that need to be in path

  • FASTA
    • If not done failures due to absence of ssearch36 will occur.
    • ssearch36 is the only program required.

Tools installed by setup.sh

Please use setup.sh to install these dependencies. Setting the environment variable CGP_PERLLIBS allows you to to append to PERL5LIB during install. Without this all dependancies are installed into the target area. setup.sh will not use PERL5LIB directly.

Please be aware that this expects basic C compilation libraries and tools to be available.

Running BRASS

This package includes a reference implementation which handles all of the linking together of steps.

Please see the -h and -m options of brass.pl for full usage information.

It can be run in a couple of ways:

  1. Fire and forget
  • Execute on a single host with multiple cores (or 1 if that's all you have)
  • Some efficiency overhead as some steps aren't parallel
  1. Farm style
  • Requires 2 extra parameters in the initial command
  • See -help for further details

Input

Initial mapping

BRASS has primarily been written to work with BWA mapped data. You are likely to get the most useful output from BWA-mem.

Library quality

Please be aware that paired-end libraries where properly-paired reads are heavily overlapped are unlikely to produce good results.

Additional mapping information

BRASS requires accurate information regarding the insert size distribution and expects to find a *.bam.bas file co-located with the *.bam's. These can be generated by the bam_stats program included in the PCAP-core project. If you use bwa_mem.pl to map your data (same repository) then this file is generated automatically for you.

Docker, Singularity and Dockstore

There is a pre-built image containing this codebase on quay.io.

This was primarily designed for use with dockstore.org but can be used as normal containers.

The docker images are know to work correctly after import into a singularity image.

LICENCE

Copyright (c) 2014-2018 Genome Research Ltd.

Author: CASM/Cancer IT <cgphelp@sanger.ac.uk>

This file is part of BRASS.

BRASS 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’."