Scroll to navigation

BUILDTREES.PY(1) User Commands BUILDTREES.PY(1)

NAME

BuildTrees.py - Repertoire clonal assignment toolkit (Python 3)

DESCRIPTION

/usr/bin/BuildTrees.py:488: SyntaxWarning: "is" with a literal. Did you mean "=="?

if germline is "":

/usr/bin/BuildTrees.py:543: SyntaxWarning: "is" with a literal. Did you mean "=="?

if ngermline is "":

/usr/bin/BuildTrees.py:801: SyntaxWarning: "is not" with a literal. Did you mean "!="?

if regions["cdr3_imgt"] is not "" and regions["cdr3_imgt"] is not None:

/usr/bin/BuildTrees.py:827: SyntaxWarning: "is not" with a literal. Did you mean "!="?

elif regions["fwr3_imgt"] is not "" and regions["fwr3_imgt"] is not None:

usage: BuildTrees.py [--version] [-h] -d DB_FILES [DB_FILES ...]

[--outdir OUT_DIR] [--outname OUT_NAME] [--log LOG_FILE]
[--failed] [--format {airr,changeo}] [--collapse] [--ncdr3] [--nmask] [--md META_DATA [META_DATA ...]] [--clones TARGET_CLONES [TARGET_CLONES ...]] [--minseq MIN_SEQ] [--sample SAMPLE_DEPTH] [--append APPEND [APPEND ...]] [--igphyml] [--nproc NPROC] [--clean {none,all}] [--optimize {n,r,l,lr,tl,tlr}] [--omega {e,ce,e,e,ce,e,e,ce,ce,ce}] [-t {e,ce}] [--motifs MOTIFS] [--hotness HOTNESS] [--oformat {tab,txt}] [--nohlp] [--asr ASR]

Converts TSV files into IgPhyML input files

help:

show program's version number and exit
show this help message and exit

standard arguments:

A list of tab delimited database files. (default: None)
Specify to changes the output directory to the location specified. The input file directory is used if this is not specified. (default: None)
Changes the prefix of the successfully processed output file to the string specified. May not be specified with multiple input files. (default: None)
Specify to write verbose logging to a file. May not be specified with multiple input files. (default: None)
If specified create files containing records that fail processing. (default: False)
Specify input and output format. (default: airr)

sequence processing arguments:

If specified, collapse identical sequences before exporting to fasta. (default: False)
If specified, remove CDR3 from all sequences. (default: False)
If specified, do not attempt to mask split codons. (default: False)
List of fields to containing metadata to include in output fasta file sequence headers. (default: None)
List of clone IDs to output, if specified. (default: None)
Minimum number of data sequences. Any clones with fewer than the specified number of sequences will be excluded. (default: 1)
Depth of reads to be subsampled (before deduplication). (default: -1)
List of columns to append to sequence ID to ensure uniqueness. (default: None)

IgPhyML arguments (see igphyml -h for details):

Run IgPhyML on output? (default: False)
Number of threads to parallelize IgPhyML across. (default: 1)
Delete intermediate files? none: leave all intermediate files; all: delete all intermediate files. (default: none)
Optimize combination of topology (t) branch lengths (l) and parameters (r), or nothing (n), for IgPhyML. (default: lr)
Omega parameters to estimate for FWR,CDR respectively: e = estimate, ce = estimate + confidence interval (default: e,e)
Kappa parameters to estimate: e = estimate, ce = estimate + confidence interval (default: e)
Which motifs to estimate mutability. (default: WRC_2:0,GYW_0:1,WA_1:2,TW_0:3,SYC_2:4,GRS_0:5)
Mutability parameters to estimate: e = estimate, ce = estimate + confidence interval (default: e,e,e,e,e,e)
IgPhyML output format. (default: tab)
Don't run HLP model? (default: False)
Ancestral sequence reconstruction interval (0-1). (default: -1)

output files:

<folder>
folder containing fasta and partition files for each clone.
lineages
successfully processed records.
lineages-fail
database records failed processing.
igphyml-pass
parameter estimates and lineage trees from running IgPhyML, if specified

required fields:

sequence_id, sequence, sequence_alignment, germline_alignment_d_mask or germline_alignment, v_call, j_call, clone_id, v_sequence_start

AUTHOR


This manpage was written by Nilesh Patra for the Debian distribution and
can be used for any other usage of the program.

October 2020 BuildTrees.py 1.0.1