Skip to content

Commit

Permalink
sensitive mode removed. --no-mei option skips MEI clustering. Version…
Browse files Browse the repository at this point in the history
… 1.0.7
  • Loading branch information
calkan committed Dec 8, 2019
1 parent f85147f commit 7c2ba86
Show file tree
Hide file tree
Showing 3 changed files with 16 additions and 32 deletions.
4 changes: 2 additions & 2 deletions Makefile
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
TARDIS_VERSION := "1.0.6"
TARDIS_UPDATE := "December 04, 2019"
TARDIS_VERSION := "1.0.7"
TARDIS_UPDATE := "December 08, 2019"
TARDIS_DEBUG := 0
BUILD_DATE := "$(shell date)"
CC=gcc
Expand Down
25 changes: 3 additions & 22 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ Toolkit for Automated and Rapid DIscovery of Structural variants

Soylev, A., Kockan, C., Hormozdiari, F., & Alkan, C. (2017). Toolkit for automated and rapid discovery of structural variants. Methods, 129, 3-7. https://doi.org/10.1016/j.ymeth.2017.05.030

Soylev, A., Le, T., Amini, H., Alkan, C., & Hormozdiari, F. (2018). Discovery of tandem and interspersed segmental duplications using high throughput sequencing. Bioinformatics, [epub Apr 1; doi: 10.1093/bioinformatics/btz237], 2019.
Soylev, A., Le, T., Amini, H., Alkan, C., & Hormozdiari, F. (2018). Discovery of tandem and interspersed segmental duplications using high throughput sequencing. Bioinformatics, Oct 15; 35(20): 3923–3930, 2019.

TARDIS is developed and tested using Linux operating system (mostly Ubuntu flavors), and gcc versions 5.4 and 7.3. If it does not run as intended in other operating systems, we recommend to use the Docker container available at https://hub.docker.com/r/alkanlab/tardis/. We provide a sample script for Docker usage in this repository.

Expand All @@ -32,7 +32,6 @@ htslib also requires:

Optional dependencies
=====================
* mrFAST (https://github.com/BilkentCompGen/mrfast) - sensitive mode only.
* gnuplot http://www.gnuplot.info) - for plotting fragment size distributions.

Fetching TARDIS
Expand Down Expand Up @@ -107,26 +106,13 @@ Please refer to the SONIC development repository: https://github.com/calkan/soni
The README.md file includes documentation on how to obtain the necessary files for different genomes from the UCSC Genome Browser.


Running TARDIS - QUICK mode
Running TARDIS
===========================

tardis -i myinput.bam --ref human_g1k_v37.fasta --sonic human_g1k_v37.sonic \
--out myoutput


Running TARDIS - SENSITIVE mode (mrFAST Mappings)
=================================================

Sensitive mode uses mrFAST mappings (all possible mappings) with read-pair and read-depth signatures.

tardis -i myinput.bam --ref human_g1k_v37.fasta --sonic human_g1k_v37.sonic \
--sensitive --out myoutput

This command first runs mrFAST and creates the DIVET file that contains all possible mappings of the reads in your BAM file. However, if you already have the DIVET files (there should be as many DIVET files as there are libraries in your BAM files), you can use --skip-mrfast

DIVET files should be inside the TARDIS directory or under the divet/ folder


Running TARDIS - Multiple BAM/CRAM files
========================================

Expand Down Expand Up @@ -164,17 +150,12 @@ All parameters
--mei ["Alu:L1:SVA"] : List of mobile element names.
--no-soft-clip : Skip soft clip remapping.
--no-interdup : Skip interspersed duplication clustering.
--no-mei : Skip mobile element insertion (MEI) clustering.
--resolved : Output sequence resolved vcf calls.
--xa : Look for the alternative mapping locations in BWA.
--first-chr [chr_index] : Start running from a specific chromosome [0-based index in reference file]
--last-chr [chr_index] : Run up to a specific chromosome [0-based index in reference file]

Additional parameters for sensitive mode:

--sensitive : Sensitive mode that uses all map locations. Requires mrFAST remapping.
--skip-mrfast : Skip mrFAST mapping. Use this only if you already have the correct divet file. Sensitive mode only
--threads : Number of threads for mrFAST to remap discordant reads.

Additional parameters to build SONIC file within TARDIS:

--make-sonic [sonic file] : SONIC file that will contain the assembly annotations.
Expand Down
19 changes: 11 additions & 8 deletions cmdline.c
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ int parse_command_line( int argc, char** argv, parameters* params)
int index;
int o;
static int sensitive = 0, no_soft_clip = 0, debug = 0, no_interdup = 0, no_mei = 0;
static int skip_mrfast = 0, quick = 0, ten_x = 0, output_hs = 0, alt_mapping = 0, resolved = 0;
static int skip_mrfast = 0, quick = 1, ten_x = 0, output_hs = 0, alt_mapping = 0, resolved = 0;
static int make_sonic = 0;
static int load_sonic = 0;
static int do_remap = 0;
Expand Down Expand Up @@ -73,7 +73,7 @@ int parse_command_line( int argc, char** argv, parameters* params)
{"xa", no_argument, &alt_mapping, 1 },
{"resolved", no_argument, &resolved, 1 },
{"sensitive", no_argument, &sensitive, 1 },
{"skip-mrfast", no_argument, &skip_mrfast, 1 },
{"skip-mrfast", no_argument, &skip_mrfast, 1 },
{"quick" , no_argument, &quick, 1 },
{"remap" , no_argument, &do_remap, 1 },
{"10x", no_argument, &ten_x, 1},
Expand Down Expand Up @@ -190,14 +190,15 @@ int parse_command_line( int argc, char** argv, parameters* params)
}
}

/* check quick vs remap mode */
// check quick vs remap mode
if ( quick && do_remap){
fprintf(stderr, "Cannot run both in quick and remap mode. Resetting to default (quick mode).\n");
do_remap = 0;
}
else if ( do_remap){
quick = 0;
}
}


/* histogram only mode */
if ( histogram_only)
Expand Down Expand Up @@ -347,10 +348,10 @@ int parse_command_line( int argc, char** argv, parameters* params)
params->quick = 1;

if( params->quick)
running_mode = QUICK;
running_mode = QUICK;
else
running_mode = SENSITIVE;

running_mode = SENSITIVE;
if (load_sonic)
params->load_sonic = load_sonic;

Expand Down Expand Up @@ -390,11 +391,13 @@ void print_help( void)
fprintf( stdout, "\t--first-chr [chr_index] : Start running from a specific chromosome [0-based index in reference file].\n");
fprintf( stdout, "\t--last-chr [chr_index] : Run up to a specific chromosome [0-based index in reference file].\n");

/*
fprintf( stdout, "\n\tAdditional parameters for sensitive mode:\n\n");
fprintf( stdout, "\t--sensitive : Sensitive mode that uses all map locations. Requires mrFAST remapping.\n");
fprintf( stdout, "\t--skip-mrfast : Skip mrFAST mapping. Use this only if you already have the correct divet file. Sensitive mode only\n");
fprintf( stdout, "\t--threads : Number of threads for mrFAST to remap discordant reads.\n");

*/

fprintf( stdout, "\n\tAdditional parameters to build SONIC file within TARDIS:\n\n");
fprintf( stdout, "\t--make-sonic [sonic file] : SONIC file that will contain the assembly annotations.\n");
fprintf( stdout, "\t--sonic-info [\"string\"] : SONIC information string to be used as the reference genome name.\n");
Expand Down

0 comments on commit 7c2ba86

Please sign in to comment.