stranger


Namestranger JSON
Version 0.9.0 PyPI version JSON
download
home_pagehttps://github.com/moonso/stranger
SummaryAnnotate VCF files with str variants
upload_time2024-05-28 08:00:11
maintainerNone
docs_urlNone
authorMåns Magnusson
requires_python>=3.6.0
licenseMIT
keywords vcf variants str
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI
coveralls test coverage No coveralls.
            
# Stranger [![Build Status][travis-image]][travis-url] [![Coverage Status][coveralls-image]][coveralls-url] [![PyPI Version][pypi-img]][pypi-url][![DOI][doi-image]][doi-url]

Annotates output files from [ExpansionHunter][hunter] and [TRGT][trgt] with the pathologic implications of the repeat sizes.

## Installation

```
git clone github.com/clinical-genomics/stranger
cd stranger
pip install --editable .
```

## Usage

```
Usage: stranger [OPTIONS] VCF

  Annotate str variants with str status

Options:
  -f, --repeats-file PATH         Path to a file with repeat definitions. See
                                  README for explanation  [default: $HOME/
                                  stranger/stranger/resources/vari
                                  ant_catalog_grch37.json]
  -i, --family_id TEXT
  -t, --trgt                      File was produced with TRGT
  --version
  --loglevel [DEBUG|INFO|WARNING|ERROR|CRITICAL]
                                  Set the level of log output.  [default:
                                  INFO]
  --help                          Show this message and exit.
```


## Repeat definitions

The repeats are called with Expansion Hunter as mentioned earlier. ExpansionHunter 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 pathogenicity for the repeat number. The intervals that comes with the package are manually collected from the literature since there is no single source where this information can be collected.

You can find a repeat definitions json file that comes with Stranger [here](https://github.com/moonso/stranger/blob/master/stranger/resources/variant_catalog_grch37.json). It is based on the ExpansionHunter variant catalog, but extended with a few disease locus relevant keys:

| Column/Key      | Content/Value                                                                                   |
|-----------------|-------------------------------------------------------------------------------------------------|
| 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.                                          |
| DisplayRU       | Repeat unit, as clinicians are used to see it.                                                  |
| 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.                                                                             |
| InheritanceMode | Mode of inheritance "AR", "AD", "XR" etc                                                        |
| Source          | Reference literature resource type, eg GeneReviews or PubMed                                    |
| SourceId        | PMID or GeneReviews book ID for references                                                      |
| TRID            | Trgt repeat ID if not same as REPID                                                             |
| PathologicStruc | Array of index for pathogenic motif                                                             |


Other fields accepted by ExpansionHunter are also encouraged.

For convenience, here is a formated table with some of the current contents:

| HGNCId | LocusId | DisplayRU | InheritanceMode | normal_max | pathologic_min | Disease | SourceDisplay | SourceId |
| ------- | ------- | ------- | ------- | ------- | ------- | ------- | ------- | ------- |
| 3776 | AFF2 | CCG | XR | 39 | 200 | Fraxe | GeneReviews Internet 2019-11-07 | NBK535148 |
| 644 | AR | CAG | XR | 34 | 38 | SBMA | GeneReviews Internet 2019-11-07 | NBK535148 |
| 18060 | ARX_EIEE | GCN | XR | 16 | 17 | EIEE | GeneReviews Internet 2019-11-07 | NBK535148 |
| 18060 | ARX_PRTS | GCN | XR | 12 | 20 | PRTS | GeneReviews Internet 2019-11-07 | NBK535148 |
| 3033 | ATN1 | CAG | AD | 35 | 48 | DRPLA | GeneReviews Internet 2019-11-07 | NBK535148 |
| 10549 | ATXN10 | ATTCT | AD | 32 | 800 | SCA10 | GeneReviews Internet 2019-11-07 | NBK535148 |
| 10548 | ATXN1 | CAG | AD | 35 | 45 | SCA1 | GeneReviews Internet SCA1 2017-06-22 | NBK1184 |
| 10555 | ATXN2 | CAG | AD | 31 | 37 | SCA2 | GeneReviews Internet SCA2 2019-02-14 | NBK1275 |
| 7106 | ATXN3 | CAG | AD | 44 | 60 | MJD | GeneReviews Internet 2019-11-07 | NBK535148 |
| 10560 | ATXN7 | CAG | AD | 19 | 36 | SCA7 | GeneReviews Internet 2019-11-07 | NBK535148 |
| 10561 | ATXN8OS | CTG | AD | 50 | 80 | SCA8 | GeneReviews Internet 2019-11-07 | NBK535148 |
| 28337 | C9ORF72 | GGCCCC | AD | 25 | 40 | FTDALS1 | GeneReviews Internet 2019-11-07 | NBK535148 |
| 1388 | CACNA1A | CAG | AD | 18 | 20 | SCA6 | GeneReviews Internet 2019-11-07 | NBK535148 |
| 1541 | CBL | CCG | AD | 79 | 100 | FRAX11B | Jones et al Nature 1995 | 7603564 |
| 1541 | BEAN1 | TGGAA | AD | 10 | 40 | SCA31 | Sato et al AJHG 2009 | 7603564 |
| 13164 | CNBP | CCTG | AD | 30 | 75 | DM2 | GeneReviews Internet 2020-03-19 | NBK1466 |
| 2482 | CSTB | CCCCGCCCCGCG | AR | 3 | 30 | EPM1 | GeneReviews Internet 2019-11-07 | NBK535148 |
| 2482 | DAB1 | ATTTC | AD | 16 | 31 | SCA37 | GeneReviews Internet 2019-05-30 | NBK541729 |
| 29284 | DIP2B | CGG | AD | 24 | 270 | FRA12A | GeneReviews Internet 2019-11-07 | NBK535148 |
| 2933 | DMPK | CTG | AD | 34 | 50 | DM1 | GeneReviews Internet 2019-10-03 | NBK1165 |
| 18683 | EIF4A3 | TCGGCAGCGGCGCAGCGAGG | AR | 9 | 10 | RCPS | GeneReviews Internet 2019-11-07 | NBK535148 |
| 3775 | FMR1 | CGG | XR | 55 | 200 | FragileX | GeneReviews Internet 2019-11-07 | NBK535148 |
| 1092 | FOXL2 | GCN | AD | 14 | 15 | BPES | GeneReviews Internet 2019-11-07 | NBK535148 |
| 3951 | FXN | GAA | AR | 35 | 51 | FRDA | GeneReviews Internet 2019-11-07 | NBK535148 |
| 4331 | GLS | GCA | AR | 20 | 90 | GDPAG | van Kuilenburg et al (2019) NEJM 380:1433-1441 | 30970188 |
| 5102 | HOXA13_I | GCN | AD | 14 | 22 | HFGS | GeneReviews Internet 2019-08-08 | NBK1423 |
| 5102 | HOXA13_II | GCN | AD | 12 | 18 | HFGS | GeneReviews Internet 2019-08-08 | NBK1423 |
| 5102 | HOXA13_III | GCN | AD | 18 | 24 | HFGS | GeneReviews Internet 2019-08-08 | NBK1423 |
| 5136 | HOXD13 | GCN | AD | 15 | 22 | SDTY5 | GeneReviews Internet 2019-11-07 | NBK535148 |
| 4851 | HTT | CAG | AD | 36 | 40 | Huntington | GeneReviews Internet 2020-06-11 | NBK1305 |
| 14203 | JPH3 | CTG | AD | 28 | 40 | HDL2 | GeneReviews Internet 2019-06-27 | NBK1529 |
| 31708 | LRP12 | CGN | AD | 45 | 90 | OPDM1 | GeneReviews Internet 2019-11-07 | NBK535148 |
| 1226 | GIPC1 | GGC | AD | 32 | 73 | OPDM2 | Deng et al (2020) AJHG 106(6):793-804 | 32413282 |
| 17043 | NIPA1 | GCN | AD | 8 | 10000 | ALS - susceptibility to | Tazelaar et al (2019) Neurobiol Aging 74:234.e9-234.e15 | 30342764 |
| 15911 | NOP56 | GGCCTG | AD | 14 | 650 | SCA36 | GeneReviews Internet 2014-08-07 | NBK231880 |
| 53924 | NOTCH2NLC | CGG | AD | 38 | 66 | NIID | GeneReviews Internet 2019-11-07 | NBK535148 |
| 8565 | PABPN1 | GCN | AD | 10 | 12 | OPMD | GeneReviews Internet 2014-02-20 | NBK1126 |
| 9143 | PHOX2B | GCN | AD | 20 | 25 | CCHS | GeneReviews Internet 2014-01-30 | NBK1427 |
| 9305 | PPP2R2B | CAG | AD | 32 | 51 | SCA12 | GeneReviews Internet 2019-11-07 | NBK535148 |
| 16854 | RAPGEF2 | TTTCA | AD | 1 | 10 | FAME7 | Ishiura et al (2018) Nature Genetics 50;581-90 | 29507423 |
| 9969 | RFC1 | AARRG | AR | 11 | 12 | CANVAS | Cortese et al 2019 Nat Gen PMID: 30926972 | 30926972 |
| 31750 | SAMD12 | TTTCA | AD | 1 | 10 | FAME1 | Ishiura et al (2018) Nature Genetics 50;581-90 | 29507423 |
| 10472 | RUNX2 | GCN | AD | 17 | 20 | CCD | GeneReviews Internet 2019-11-07 | NBK535148 |
| 11199 | SOX3 | GCN | XR | 15 | 22 | MRGH | GeneReviews Internet 2019-11-07 | NBK535148 |
| 11588 | TBP | CAN | AD | 40 | 49 | SCA17 | GeneReviews Internet 2019-09-12 | NBK1438 |
| 11592 | TBX1 | GCN | AD | 15 | 25 | TOF | GeneReviews Internet 2019-11-07 | NBK535148 |
| 11634 | TCF4 | CTG | AD | 39 | 100 | FECD3 | GeneReviews Internet 2019-11-07 | NBK535148 |
| 11969 | TNRC6A | TTTCA | AD | 1 | 10 | FAME6 | Ishiura et al (2018) Nature Genetics 50;581-90 | 29507423 |
| 15516 | XYLT1 | GGC | AR | 20 | 70 | DBQD2 | LaCroix et al (2018) AJHG 104(1):35-44 | 30554721 |
| 12873 | ZIC2 | GCN | AD | 15 | 25 | HPE5 | GeneReviews Internet 2019-11-07 | NBK535148 |
| 12874 | ZIC3 | GCN | XR | 10 | 12 | VACTERLX | GeneReviews Internet 2019-11-07 | NBK535148 |
| 9179 | POLG | CTG | - | 15 | 10000 | - | Research only. Contact CMMS, KUH, regarding findings. | CMMS |

Stranger can also read a legacy `.tsv` format file, structured like a [Scout](https://github.com/Clinical-Genomics/scout) gene panel, with STR specific columns.
The column names and keys correspond, but if in any kind of doubt, please read the code or use the json version.

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 `#`.

It is also possible to use an ExpansionHunter variant catalog json file with corresponding keys added. E.g.
```
[
    {
        "VariantType": "Repeat",
        "LocusId": "ATXN2",
        "LocusStructure": "(GCT)*",
        "ReferenceRegion": "chr12:112036753-112036822",
        "Disease": "SCA2",
        "NormalMax": 31,
        "PathologicMin": 39
    },
    {
        "VariantType": "Repeat",
        "LocusId": "PABPN1",
        "LocusStructure": "(GCG)*",
        "ReferenceRegion": "chr14:23790681-23790699",
        "Disease": "OPMD",
        "NormalMax": 6,
        "PathologicMin": 9
    }
]
```

Such files are also provided with the distribution. PRs with updates are much appreciated.

## Output

Output is by annotated VCF, with keys `STR_STATUS`, `NormalMax` and `PathologicMin`.

```
##INFO=<ID=STR_STATUS,Number=A,Type=String,Description="Repeat expansion status. Alternatives in [normal, pre_mutation, full_mutation]">
4       3076603 .       C       <STR17>,<STR18> .       PASS    END=3076660;REF=19;RL=57;RU=CAG;VARID=HTT;REPID=HTT;STR_STATUS=normal,normal
```

[hunter]: https://github.com/Illumina/ExpansionHunter
[trgt]: https://github.com/PacificBiosciences/trgt

[travis-url]: https://travis-ci.com/moonso/stranger
[travis-image]: https://travis-ci.com/moonso/stranger.svg?branch=master
[pypi-img]: https://img.shields.io/pypi/v/stranger.svg?style=flat-square
[pypi-url]: https://pypi.python.org/pypi/stranger/
[coveralls-url]: https://coveralls.io/github/moonso/stranger
[coveralls-image]: https://coveralls.io/repos/github/moonso/stranger/badge.svg?branch=master
[doi-image]: https://zenodo.org/badge/158848858.svg
[doi-url]: https://zenodo.org/badge/latestdoi/158848858



            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/moonso/stranger",
    "name": "stranger",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.6.0",
    "maintainer_email": null,
    "keywords": "vcf, variants, str",
    "author": "M\u00e5ns Magnusson",
    "author_email": "mans.magnusson@scilifelab.com",
    "download_url": "https://files.pythonhosted.org/packages/7e/73/8f7ab116a07da6c01c0456ba48dd372a2a6e0045dc00e904aa7ab68c238a/stranger-0.9.0.tar.gz",
    "platform": null,
    "description": "\n# Stranger [![Build Status][travis-image]][travis-url] [![Coverage Status][coveralls-image]][coveralls-url] [![PyPI Version][pypi-img]][pypi-url][![DOI][doi-image]][doi-url]\n\nAnnotates output files from [ExpansionHunter][hunter] and [TRGT][trgt] with the pathologic implications of the repeat sizes.\n\n## Installation\n\n```\ngit clone github.com/clinical-genomics/stranger\ncd stranger\npip install --editable .\n```\n\n## Usage\n\n```\nUsage: stranger [OPTIONS] VCF\n\n  Annotate str variants with str status\n\nOptions:\n  -f, --repeats-file PATH         Path to a file with repeat definitions. See\n                                  README for explanation  [default: $HOME/\n                                  stranger/stranger/resources/vari\n                                  ant_catalog_grch37.json]\n  -i, --family_id TEXT\n  -t, --trgt                      File was produced with TRGT\n  --version\n  --loglevel [DEBUG|INFO|WARNING|ERROR|CRITICAL]\n                                  Set the level of log output.  [default:\n                                  INFO]\n  --help                          Show this message and exit.\n```\n\n\n## Repeat definitions\n\nThe repeats are called with Expansion Hunter as mentioned earlier. ExpansionHunter 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.\nStranger will annotate the level of pathogenicity for the repeat number. The intervals that comes with the package are manually collected from the literature since there is no single source where this information can be collected.\n\nYou can find a repeat definitions json file that comes with Stranger [here](https://github.com/moonso/stranger/blob/master/stranger/resources/variant_catalog_grch37.json). It is based on the ExpansionHunter variant catalog, but extended with a few disease locus relevant keys:\n\n| Column/Key      | Content/Value                                                                                   |\n|-----------------|-------------------------------------------------------------------------------------------------|\n| HGNC_ID         | HGNC identifier for the repeat or most associated gene.                                         |\n| HGNC_SYMBOL     | HGNC symbol for the repeat or most associated gene.                                             |\n| REPID           | ExpansionHunter repeat ID.                                                                      |\n| RU              | Basic repeat unit, as seen in ExpansionHunter. Unused.                                          |\n| DisplayRU       | Repeat unit, as clinicians are used to see it.                                                  |\n| Normal_Max      | (#copies) Longest repeat expected for normal individual; higher are marked pre- or full-mutation |\n| Pathologic_Min  | (#copies) Shortest repeat expected for pathology. This and higher is annotated as full-mutation. |\n| Disease         | Associated disease.                                                                             |\n| InheritanceMode | Mode of inheritance \"AR\", \"AD\", \"XR\" etc                                                        |\n| Source          | Reference literature resource type, eg GeneReviews or PubMed                                    |\n| SourceId        | PMID or GeneReviews book ID for references                                                      |\n| TRID            | Trgt repeat ID if not same as REPID                                                             |\n| PathologicStruc | Array of index for pathogenic motif                                                             |\n\n\nOther fields accepted by ExpansionHunter are also encouraged.\n\nFor convenience, here is a formated table with some of the current contents:\n\n| HGNCId | LocusId | DisplayRU | InheritanceMode | normal_max | pathologic_min | Disease | SourceDisplay | SourceId |\n| ------- | ------- | ------- | ------- | ------- | ------- | ------- | ------- | ------- |\n| 3776 | AFF2 | CCG | XR | 39 | 200 | Fraxe | GeneReviews Internet 2019-11-07 | NBK535148 |\n| 644 | AR | CAG | XR | 34 | 38 | SBMA | GeneReviews Internet 2019-11-07 | NBK535148 |\n| 18060 | ARX_EIEE | GCN | XR | 16 | 17 | EIEE | GeneReviews Internet 2019-11-07 | NBK535148 |\n| 18060 | ARX_PRTS | GCN | XR | 12 | 20 | PRTS | GeneReviews Internet 2019-11-07 | NBK535148 |\n| 3033 | ATN1 | CAG | AD | 35 | 48 | DRPLA | GeneReviews Internet 2019-11-07 | NBK535148 |\n| 10549 | ATXN10 | ATTCT | AD | 32 | 800 | SCA10 | GeneReviews Internet 2019-11-07 | NBK535148 |\n| 10548 | ATXN1 | CAG | AD | 35 | 45 | SCA1 | GeneReviews Internet SCA1 2017-06-22 | NBK1184 |\n| 10555 | ATXN2 | CAG | AD | 31 | 37 | SCA2 | GeneReviews Internet SCA2 2019-02-14 | NBK1275 |\n| 7106 | ATXN3 | CAG | AD | 44 | 60 | MJD | GeneReviews Internet 2019-11-07 | NBK535148 |\n| 10560 | ATXN7 | CAG | AD | 19 | 36 | SCA7 | GeneReviews Internet 2019-11-07 | NBK535148 |\n| 10561 | ATXN8OS | CTG | AD | 50 | 80 | SCA8 | GeneReviews Internet 2019-11-07 | NBK535148 |\n| 28337 | C9ORF72 | GGCCCC | AD | 25 | 40 | FTDALS1 | GeneReviews Internet 2019-11-07 | NBK535148 |\n| 1388 | CACNA1A | CAG | AD | 18 | 20 | SCA6 | GeneReviews Internet 2019-11-07 | NBK535148 |\n| 1541 | CBL | CCG | AD | 79 | 100 | FRAX11B | Jones et al Nature 1995 | 7603564 |\n| 1541 | BEAN1 | TGGAA | AD | 10 | 40 | SCA31 | Sato et al AJHG 2009 | 7603564 |\n| 13164 | CNBP | CCTG | AD | 30 | 75 | DM2 | GeneReviews Internet 2020-03-19 | NBK1466 |\n| 2482 | CSTB | CCCCGCCCCGCG | AR | 3 | 30 | EPM1 | GeneReviews Internet 2019-11-07 | NBK535148 |\n| 2482 | DAB1 | ATTTC | AD | 16 | 31 | SCA37 | GeneReviews Internet 2019-05-30 | NBK541729 |\n| 29284 | DIP2B | CGG | AD | 24 | 270 | FRA12A | GeneReviews Internet 2019-11-07 | NBK535148 |\n| 2933 | DMPK | CTG | AD | 34 | 50 | DM1 | GeneReviews Internet 2019-10-03 | NBK1165 |\n| 18683 | EIF4A3 | TCGGCAGCGGCGCAGCGAGG | AR | 9 | 10 | RCPS | GeneReviews Internet 2019-11-07 | NBK535148 |\n| 3775 | FMR1 | CGG | XR | 55 | 200 | FragileX | GeneReviews Internet 2019-11-07 | NBK535148 |\n| 1092 | FOXL2 | GCN | AD | 14 | 15 | BPES | GeneReviews Internet 2019-11-07 | NBK535148 |\n| 3951 | FXN | GAA | AR | 35 | 51 | FRDA | GeneReviews Internet 2019-11-07 | NBK535148 |\n| 4331 | GLS | GCA | AR | 20 | 90 | GDPAG | van Kuilenburg et al (2019) NEJM 380:1433-1441 | 30970188 |\n| 5102 | HOXA13_I | GCN | AD | 14 | 22 | HFGS | GeneReviews Internet 2019-08-08 | NBK1423 |\n| 5102 | HOXA13_II | GCN | AD | 12 | 18 | HFGS | GeneReviews Internet 2019-08-08 | NBK1423 |\n| 5102 | HOXA13_III | GCN | AD | 18 | 24 | HFGS | GeneReviews Internet 2019-08-08 | NBK1423 |\n| 5136 | HOXD13 | GCN | AD | 15 | 22 | SDTY5 | GeneReviews Internet 2019-11-07 | NBK535148 |\n| 4851 | HTT | CAG | AD | 36 | 40 | Huntington | GeneReviews Internet 2020-06-11 | NBK1305 |\n| 14203 | JPH3 | CTG | AD | 28 | 40 | HDL2 | GeneReviews Internet 2019-06-27 | NBK1529 |\n| 31708 | LRP12 | CGN | AD | 45 | 90 | OPDM1 | GeneReviews Internet 2019-11-07 | NBK535148 |\n| 1226 | GIPC1 | GGC | AD | 32 | 73 | OPDM2 | Deng et al (2020) AJHG 106(6):793-804 | 32413282 |\n| 17043 | NIPA1 | GCN | AD | 8 | 10000 | ALS - susceptibility to | Tazelaar et al (2019) Neurobiol Aging 74:234.e9-234.e15 | 30342764 |\n| 15911 | NOP56 | GGCCTG | AD | 14 | 650 | SCA36 | GeneReviews Internet 2014-08-07 | NBK231880 |\n| 53924 | NOTCH2NLC | CGG | AD | 38 | 66 | NIID | GeneReviews Internet 2019-11-07 | NBK535148 |\n| 8565 | PABPN1 | GCN | AD | 10 | 12 | OPMD | GeneReviews Internet 2014-02-20 | NBK1126 |\n| 9143 | PHOX2B | GCN | AD | 20 | 25 | CCHS | GeneReviews Internet 2014-01-30 | NBK1427 |\n| 9305 | PPP2R2B | CAG | AD | 32 | 51 | SCA12 | GeneReviews Internet 2019-11-07 | NBK535148 |\n| 16854 | RAPGEF2 | TTTCA | AD | 1 | 10 | FAME7 | Ishiura et al (2018) Nature Genetics 50;581-90 | 29507423 |\n| 9969 | RFC1 | AARRG | AR | 11 | 12 | CANVAS | Cortese et al 2019 Nat Gen PMID: 30926972 | 30926972 |\n| 31750 | SAMD12 | TTTCA | AD | 1 | 10 | FAME1 | Ishiura et al (2018) Nature Genetics 50;581-90 | 29507423 |\n| 10472 | RUNX2 | GCN | AD | 17 | 20 | CCD | GeneReviews Internet 2019-11-07 | NBK535148 |\n| 11199 | SOX3 | GCN | XR | 15 | 22 | MRGH | GeneReviews Internet 2019-11-07 | NBK535148 |\n| 11588 | TBP | CAN | AD | 40 | 49 | SCA17 | GeneReviews Internet 2019-09-12 | NBK1438 |\n| 11592 | TBX1 | GCN | AD | 15 | 25 | TOF | GeneReviews Internet 2019-11-07 | NBK535148 |\n| 11634 | TCF4 | CTG | AD | 39 | 100 | FECD3 | GeneReviews Internet 2019-11-07 | NBK535148 |\n| 11969 | TNRC6A | TTTCA | AD | 1 | 10 | FAME6 | Ishiura et al (2018) Nature Genetics 50;581-90 | 29507423 |\n| 15516 | XYLT1 | GGC | AR | 20 | 70 | DBQD2 | LaCroix et al (2018) AJHG 104(1):35-44 | 30554721 |\n| 12873 | ZIC2 | GCN | AD | 15 | 25 | HPE5 | GeneReviews Internet 2019-11-07 | NBK535148 |\n| 12874 | ZIC3 | GCN | XR | 10 | 12 | VACTERLX | GeneReviews Internet 2019-11-07 | NBK535148 |\n| 9179 | POLG | CTG | - | 15 | 10000 | - | Research only. Contact CMMS, KUH, regarding findings. | CMMS |\n\nStranger can also read a legacy `.tsv` format file, structured like a [Scout](https://github.com/Clinical-Genomics/scout) gene panel, with STR specific columns.\nThe column names and keys correspond, but if in any kind of doubt, please read the code or use the json version.\n\nAs a default the file that follows the distribution is used but the users can create their own file.\nHeader line(s) should be preceded with a `#`.\n\nIt is also possible to use an ExpansionHunter variant catalog json file with corresponding keys added. E.g.\n```\n[\n    {\n        \"VariantType\": \"Repeat\",\n        \"LocusId\": \"ATXN2\",\n        \"LocusStructure\": \"(GCT)*\",\n        \"ReferenceRegion\": \"chr12:112036753-112036822\",\n        \"Disease\": \"SCA2\",\n        \"NormalMax\": 31,\n        \"PathologicMin\": 39\n    },\n    {\n        \"VariantType\": \"Repeat\",\n        \"LocusId\": \"PABPN1\",\n        \"LocusStructure\": \"(GCG)*\",\n        \"ReferenceRegion\": \"chr14:23790681-23790699\",\n        \"Disease\": \"OPMD\",\n        \"NormalMax\": 6,\n        \"PathologicMin\": 9\n    }\n]\n```\n\nSuch files are also provided with the distribution. PRs with updates are much appreciated.\n\n## Output\n\nOutput is by annotated VCF, with keys `STR_STATUS`, `NormalMax` and `PathologicMin`.\n\n```\n##INFO=<ID=STR_STATUS,Number=A,Type=String,Description=\"Repeat expansion status. Alternatives in [normal, pre_mutation, full_mutation]\">\n4       3076603 .       C       <STR17>,<STR18> .       PASS    END=3076660;REF=19;RL=57;RU=CAG;VARID=HTT;REPID=HTT;STR_STATUS=normal,normal\n```\n\n[hunter]: https://github.com/Illumina/ExpansionHunter\n[trgt]: https://github.com/PacificBiosciences/trgt\n\n[travis-url]: https://travis-ci.com/moonso/stranger\n[travis-image]: https://travis-ci.com/moonso/stranger.svg?branch=master\n[pypi-img]: https://img.shields.io/pypi/v/stranger.svg?style=flat-square\n[pypi-url]: https://pypi.python.org/pypi/stranger/\n[coveralls-url]: https://coveralls.io/github/moonso/stranger\n[coveralls-image]: https://coveralls.io/repos/github/moonso/stranger/badge.svg?branch=master\n[doi-image]: https://zenodo.org/badge/158848858.svg\n[doi-url]: https://zenodo.org/badge/latestdoi/158848858\n\n\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Annotate VCF files with str variants",
    "version": "0.9.0",
    "project_urls": {
        "Homepage": "https://github.com/moonso/stranger"
    },
    "split_keywords": [
        "vcf",
        " variants",
        " str"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "078c33084a9f4079952fa7f9e19f3daf8076fd869e7ff4abba2af53ecdcdfc8b",
                "md5": "e5d46a2c18cfd4dc814c961cf31b8098",
                "sha256": "873b02be6421c494169b21900be1db733c1d3266132fcecba100e3751a76eda2"
            },
            "downloads": -1,
            "filename": "stranger-0.9.0-py2.py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "e5d46a2c18cfd4dc814c961cf31b8098",
            "packagetype": "bdist_wheel",
            "python_version": "py2.py3",
            "requires_python": ">=3.6.0",
            "size": 19544,
            "upload_time": "2024-05-28T08:00:08",
            "upload_time_iso_8601": "2024-05-28T08:00:08.156608Z",
            "url": "https://files.pythonhosted.org/packages/07/8c/33084a9f4079952fa7f9e19f3daf8076fd869e7ff4abba2af53ecdcdfc8b/stranger-0.9.0-py2.py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "7e738f7ab116a07da6c01c0456ba48dd372a2a6e0045dc00e904aa7ab68c238a",
                "md5": "8da81ef3bace945dcca596139072aae2",
                "sha256": "ecc1fc0b4f38c6415ee682ecbe4ecbd2df6db3b6807d11c82763d20e64109b93"
            },
            "downloads": -1,
            "filename": "stranger-0.9.0.tar.gz",
            "has_sig": false,
            "md5_digest": "8da81ef3bace945dcca596139072aae2",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.6.0",
            "size": 28804,
            "upload_time": "2024-05-28T08:00:11",
            "upload_time_iso_8601": "2024-05-28T08:00:11.143979Z",
            "url": "https://files.pythonhosted.org/packages/7e/73/8f7ab116a07da6c01c0456ba48dd372a2a6e0045dc00e904aa7ab68c238a/stranger-0.9.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-05-28 08:00:11",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "moonso",
    "github_project": "stranger",
    "travis_ci": true,
    "coveralls": false,
    "github_actions": false,
    "lcname": "stranger"
}
        
Elapsed time: 0.52300s