circle-map
A method for circular DNA detection based on probabilistic mapping of ultrashort reads
Science Score: 23.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
○codemeta.json file
-
○.zenodo.json file
-
✓DOI references
Found 3 DOI reference(s) in README -
○Academic publication links
-
✓Committers with academic emails
2 of 5 committers (40.0%) from academic institutions -
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (14.3%) to scientific vocabulary
Keywords
Repository
A method for circular DNA detection based on probabilistic mapping of ultrashort reads
Basic Info
Statistics
- Stars: 66
- Watchers: 6
- Forks: 20
- Open Issues: 53
- Releases: 0
Topics
Metadata Files
README.md
Welcome to Circle-Map official repository!
Circle-Map is an easy to install, python package that implements all the steps required to detect extrachromosomal DNA circles. The package contains easy to run algorithms to accurately detect circular DNA formed from mappable and non mappable regions of a genome.
Why should I use Circle-Map?
Circle-Map takes as input an alignment of reads to a reference genome (e.g. a BWA-MEM generated BAM file) and like other methods, it will use those alignments to detect cases were the read has been split into two segments (e.g. split reads) to detect genomic rearrangements supporting a circular DNA structure.
However, this approach results in many split read alignments being missed because the aligner is not able to map both split segments of the read, either because they are too short or because they align to too many places. In this cases, the aligner will report a read alignment containing some of the bases unmapped (e.g soft-clipped reads).
Unlike other methods, Circle-Map is able to map both segments of the soft-clipped reads by realigning the unmapped parts probabilistically to a graph representation of the circular DNA breakpoints. Which allows for a more accurate detection of the circular DNA breakpoints. In our recent paper (https://bmcbioinformatics.biomedcentral.com/articles/10.1186/s12859-019-3160-3) we show how this approach dramatically increases sensitivity while retaining high precision.
Getting started
Installation
Circle-Map runs on GNU/Linux operating systems, requires >=python3.6 and can be installed and set-up using the following ways:
This will install Circle-Map, and all the external packages required to run every part of Circle-Map software.
Installation using pip:
python -m pip install Circle-Map
Installation using conda:
conda install -c bioconda circle-map
Note: If you want to simulate circular DNA short reads, you will need to install BBMap and ART on your system.
Using Circle-Map
Now you are ready to get started detecting circular DNA. We have created a Circle-Map wiki that explains step by step how you can go from your raw sequencing reads to interpretable results. In the wiki, you can try and learn using Circle-Map with the following tutorials:
Tutorial: identification of mappable circular DNA using Circle Map Realign
Tutorial: identification of repetitive circular DNA using Circle Map Repeats
Once you have detected circular DNA in your samples you will probably be interested at looking at the output files. To help you understanding the output, we have created a page explaining what is the information provided by Circle-Map in every column of its output. You can find the information in the following link:
Getting help
The best place for getting help, feedback,report bugs or request new features is to post an issue. You can also reach me at xsh723 at dot binf dot ku dot dk
Citing
If you use Circle-Map Realign, please cite:
- Prada-Luengo, I., Krogh, A., Maretty, L. & Regenberg,B. Sensitive detection of circular DNAs at single-nucleotide resolution using guided realignment of partially aligned reads. BMC Bioinformatics 20, 663 (2019) doi:10.1186/s12859-019-3160-3
If you use Circle-Map Repeats please cite:
- Prada-Luengo, I., Møller, H.D., Henriksen, R.A., Gao, Q., Larsen, C..E, Alizadeh, S., Maretty, L., Houseley, J. & Regenberg, B., Replicative aging is associated with loss of genetic heterogeneity from extrachromosomal circular DNA in Saccharomyces cerevisiae. Nucleic Acids Research gkaa545, doi:10.1093/nar/gkaa545
License
Circle-Map is freely available under the MIT license
Acknowledgements
Circle-Map is being developed by Iñigo Prada-Luengo, Anders Krogh, Lasse Maretty and Birgitte Regenberg at the University of Copenhagen
Owner
- Login: iprada
- Kind: user
- Location: Copenhagen
- Company: University of Copenhagen
- Repositories: 1
- Profile: https://github.com/iprada
postdoc
GitHub Events
Total
- Issues event: 7
- Watch event: 5
- Issue comment event: 7
- Fork event: 1
Last Year
- Issues event: 7
- Watch event: 5
- Issue comment event: 7
- Fork event: 1
Committers
Last synced: over 2 years ago
Top Committers
| Name | Commits | |
|---|---|---|
| iprada | i****a@s****k | 231 |
| iprada | i****o@b****k | 90 |
| iprada | i****a@g****m | 25 |
| Cyril Roelandt | t****l@g****m | 1 |
| JiguangPeng | p****g@g****m | 1 |
Committer Domains (Top 20 + Academic)
Issues and Pull Requests
Last synced: 6 months ago
All Time
- Total issues: 89
- Total pull requests: 5
- Average time to close issues: 22 days
- Average time to close pull requests: 6 days
- Total issue authors: 55
- Total pull request authors: 4
- Average comments per issue: 2.61
- Average comments per pull request: 0.4
- Merged pull requests: 3
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 8
- Pull requests: 0
- Average time to close issues: 2 days
- Average time to close pull requests: N/A
- Issue authors: 6
- Pull request authors: 0
- Average comments per issue: 0.75
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- shaka-emperor (5)
- johnstonmj (5)
- tchrisboles (5)
- hartlama (4)
- ShixiangWang (3)
- caijingtao1993 (3)
- MJoseMo (3)
- newpest (3)
- lanliting (3)
- zhuyiqin (2)
- Abdubidopsis (2)
- Somnvs (2)
- gq97 (2)
- zhang919 (2)
- huangyizR (2)
Pull Request Authors
- cchd0001 (2)
- iprada (1)
- Steap (1)
- JiguangPeng (1)
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 1
-
Total downloads:
- pypi 102 last-month
- Total dependent packages: 0
- Total dependent repositories: 1
- Total versions: 10
- Total maintainers: 1
pypi.org: circle-map
Circular DNA analysis tools
- Homepage: https://github.com/iprada/Circle-Map
- Documentation: https://circle-map.readthedocs.io/
- License: MIT License
-
Latest release: 1.1.4
published almost 6 years ago