Skip to main content

Annotate VCF files with str variants

Project description

Stranger Build Status Coverage Status PyPI Version

Annotates output files from ExpansionHunter with the pathologic implications of the repeat sizes.


git clone
cd stranger
pip install --editable .


stranger --help
Usage: stranger [OPTIONS] VCF

  Annotate str variants with str status

  -f, --repeats-file PATH         Path to a file with repeat definitions. See
                                  README for explanation  [default: /Users/man
                                  Set the level of log output.  [default:
  --help                          Show this message and exit.

Repeat definitions

The repeats are called with Expansion Hunter as mentioned earlier. Expansion Hunter will annotate the number of times that a repeat has been seen in the bam files of each individual and what repeat id the variant has. Stranger will annotate the level of pathogenecity for the repeat number. The intervals that comes with the package are manually collected from the literature since there is no source where this information can be collected. There is a repeat definitions file that comes with Stranger in stranger/resources/repeatexpansionsloci.tsv. This is a tsv formated file on the following format:

hgnc_id hgnc_symbol repid ru normal_max pathologic_min disease
10548 ATXN1 ATXN1 CAG 35 45 SCA1
10555 ATXN2 ATXN2 CAG 31 39 SCA2
7106 ATXN3 ATXN3 CAG 44 60 SCA3
10560 ATXN7 ATXN7 CAG 19 37 SCA7
10561 ATXN8OS ATXN8OS CAG 50 80 SCA8
10549 ATXN10 ATXN10 ATTCT 32 800 SCA10
9305 PPP2R2B PPP2R2B CAG 35 49 SCA12
11588 TBP TBP CAG 31 49 SCA17
3951 FXN FXN CAG 35 51 FRDA
4851 HTT HTT CCG 36 37 Huntington
3775 FMR1 FMR1 CGG 65 200 FragileX
3776 AFF2 AFF2 CCG 25 200 FRAXE
13164 CNBP CNBP CCTG 30 75 DM2
2933 DMPK DMPK CAG 37 50 DM1
3033 ATN1 ATN1 CAG 34 49 DRPLA
15911 NOP56 NOP56 GGCCTG 14 650 SCA36
28337 C9ORF72 C9ORF72 GGCCCC 25 40 FTDALS1
1541 CBL CBL CGG 79 100 FRAX11B
14203 JPH3 JPH3 CTG 28 40 HDL2
644 AR AR CAG 35 38 SBMA

The file is structured like a SCOUT gene panel, with STR specific columns.

Column Content
HGNC_ID HGNC identifier for the repeat or most associated gene.
HGNC_SYMBOL HGNC symbol for the repeat or most associated gene.
REPID ExpansionHunter repeat ID.
RU Basic repeat unit, as seen in ExpansionHunter. Unused.
Normal_Max (#copies) Longest repeat expected for normal individual; higher are marked pre- or full-mutation
Pathologic_Min (#copies) Shortest repeat expected for pathology. This and higher is annotated as full-mutation.
Disease Associated disease.

As a default the file that follows the distribution is used but the users can create their own file. Header line(s) should be preceded with a #.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for stranger, version 0.5.5
Filename, size File type Python version Upload date Hashes
Filename, size stranger-0.5.5-py2.py3-none-any.whl (12.3 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size stranger-0.5.5.tar.gz (18.7 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page