A simple way to visualize features on human chromosome ideograms as shown in this article
Project description
- tagore * Installation * Requirements * Conversion script Python dependency * Quick start * Usage * Input file description
tagore
tagore
is a simple way to visualize features on human chromosome ideograms as shown in this article: https://www.nature.com/articles/srep12376
tagore
was designed to allow everyone to create 23AndMe style chromosome painting diagrams.
Installation
tagore
is a simple Python script that uses the RSVG library and has no other depenendies.
pip install tagore
tagore --version
# tagore (version 1.0)
Requirements
- Python 3.6+
- RSVG
Conversion script Python dependency
pip install click
Quick start
tagore --input example_ideogram/test.bed --prefix example_ideogram/example
Usage
usage: tagore.py [-h] [--version] -i <input.bed> [-p [output file prefix]] [-v] [-f]
tagore: a utility for illustrating human chromosomes
optional arguments:
-h, --help show this help message and exit
--version Print the software version.
-i <input.bed>, --input <input.bed> Input BED-like file
-p [output file prefix], --prefix [output file prefix] Output prefix [Default: "out"]
-v, --verbose Display verbose output
-f, --force Overwrite output files if they exist already
The input file is a bed-like format, described below. If an output prefix is not specified, the scripts uses "out" as the default prefix.
Helper scripts for converting RFmix and ADMIXTURE outputs are included in the scripts/
folder.
There is a more complete example of a full chromosome painting using RFmix output can be seen by running:
./scripts/rfmix2tagore.py --chr1 example_ideogram/1KGP-MXL104_chr1.bed \
--chr2 example_ideogram/1KGP-MXL104_chr2.bed \
--out example_ideogram/1KGP-MXL104_tagore.bed
tagore -input example_ideogram/1KGP-MXL104_tagore.bed \
--prefix example_ideogram/1KGP-MXL104
Input file description
#chr start stop feature size color chrCopy
chr1 10000000 20000000 0 1 #FF0000 1
chr2 20000000 30000000 0 1 #FF0000 2
chr2 40000000 50000000 0 0.5 #FF0000 1
Each column is explained below:
- chr - The chromosome on which a feature has to be drawn
- start - Start position (in bp) for feature
- stop - Stop position (in bp) for feature
- feature - The shape of the feature to be drawn
- 0 will draw a rectangle
- 1 will draw a circle
- 2 will draw a triangle pointing to the genomic location
- 3 will draw a line at that genomic location
- size - The horizontal size of the feature. Should range between 0 and 1.
- color - Specify the color of the genomic feature with a hex value (#FF0000 for red, etc.)
- chrCopy - Specify the chromosome copy on which the feature should be drawn (1 or 2). To draw the same feature on both chromosomes, you must specify the feature twice
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for tagore-1.0.post2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4e0cdfc89b491e2d5e375202af4b9e98132d73cbfcfd8484be1a3a939954127c |
|
MD5 | 734888cb098689f4edaa0909c09779f1 |
|
BLAKE2b-256 | e0e4b38016cb7db74c0c32526955c3cf8f43b7cbba9f977ace995293858d6593 |