https://github.com/biothings/myvariant.info
MyVariant.info: A BioThings API for human variant annotations
https://github.com/biothings/myvariant.info
annotations api bioinformatics biothings ncats-translator variant-annotations variants webservice
Last synced: about 1 month ago
JSON representation
MyVariant.info: A BioThings API for human variant annotations
- Host: GitHub
- URL: https://github.com/biothings/myvariant.info
- Owner: biothings
- License: other
- Created: 2014-04-26T20:30:49.000Z (almost 12 years ago)
- Default Branch: master
- Last Pushed: 2025-09-10T21:40:32.000Z (5 months ago)
- Last Synced: 2025-09-11T01:30:47.925Z (5 months ago)
- Topics: annotations, api, bioinformatics, biothings, ncats-translator, variant-annotations, variants, webservice
- Language: Python
- Homepage: http://myvariant.info
- Size: 12.9 MB
- Stars: 95
- Watchers: 29
- Forks: 32
- Open Issues: 56
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Introduction
-------------
This is a project coming out of [1st NoB Hackathon](https://github.com/Network-of-BioThings/nob-hq/wiki/1st-Network-of-BioThings-Hackathon).
The scope of this project is to aggregate existing annotations for genetic variants. Variant annotations have drawn huge amount of efforts from researchers, which made many variant annotation resources available, but also very scattered. Doing integration of all of them is hard, so we want to create a simple way to pool them together first, with high-performance programmatic access. That way, the further integration (e.g. deduplication, deriving higher-level annotations, etc) can be much easier.
From the discussion of the hackathon, we decided a strategy summarized as below:
##### A very simple rule to aggregate variant annotations
* each variant is represented as a JSON document
* the only requirement of the JSON document is that the key of this JSON document ("_id" field in this document) follows [HGVS nomenclature](http://www.hgvs.org/mutnomen/recs-DNA.html). For example:
```javascript
{
'_id': 'chr1:g.35366C>T',
'allele1': 'C',
'allele2': 'T',
'chrom': 'chr1',
'chromEnd': 35367,
'chromStart': 35366,
'func': 'unknown',
'rsid': 'rs71409357',
'snpclass': 'single',
'strand': '-'
}
```
* that way, we can then merge multiple annotations for the same variant into a merged JSON document. Each resource of annotations is under its own field. Here is [a merged example](https://gist.github.com/newgene/9251a2036918caea694c).
##### A powerful query-engine to access/query aggregated annotations
The query engine we developed for [MyGene.info](http://mygene.info) can be easily adapted to provide the high-performance and flexible query interface for programmatic access. [MyGene.info](http://mygene.info) follows the same spirit, but for gene annotations. It currently serves ~3M request per month.
##### User contributions of variant annotations
User contribution is vital, given the scale of available (also increasing) resources. The simple rule we defined above makes the merging new annotation resource very easy, essentially writing a JSON importer. And the sophisticated query-engine we built can save users effort to build their own infrastructure, which provides the incentive for them to contribute.
Also note that it's not only the data-provider can write the importer, anyone who finds a useful resource can do that as well (of course, check to make sure the data release license allows that)
See the guideline below for contributing JSON importer.
How to contribute
------------------
See this [How to contribute](CONTRIBUTE.md) document.