circle-map

A method for circular DNA detection based on probabilistic mapping of ultrashort reads

https://github.com/iprada/circle-map

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

circrna circrna-prediction circrnas circular-dna eccdna ecdna genotyping microdna ngs structural-variation
Last synced: 6 months ago · JSON representation

Repository

A method for circular DNA detection based on probabilistic mapping of ultrashort reads

Basic Info
  • Host: GitHub
  • Owner: iprada
  • License: mit
  • Language: Python
  • Default Branch: master
  • Homepage:
  • Size: 3.75 MB
Statistics
  • Stars: 66
  • Watchers: 6
  • Forks: 20
  • Open Issues: 53
  • Releases: 0
Topics
circrna circrna-prediction circrnas circular-dna eccdna ecdna genotyping microdna ngs structural-variation
Created almost 9 years ago · Last pushed over 1 year ago
Metadata Files
Readme License

README.md

Welcome to Circle-Map official repository!

PyPI Anaconda-Server Badge Bioconda Downloads Anaconda-Server Badge Anaconda-Server Badge

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:

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

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

All Time
  • Total Commits: 348
  • Total Committers: 5
  • Avg Commits per committer: 69.6
  • Development Distribution Score (DDS): 0.336
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email 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
question (9) bug (4) enhancement (3) duplicate (1) invalid (1)
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

  • Versions: 10
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 102 Last month
Rankings
Forks count: 8.9%
Stargazers count: 9.1%
Dependent packages count: 10.0%
Average: 14.2%
Downloads: 21.3%
Dependent repos count: 21.7%
Maintainers (1)
Last synced: 6 months ago