https://github.com/heuermh/googlegenomics-protobufs

Protobuf files used to represent data in the Google Genomics APIs.
https://github.com/heuermh/googlegenomics-protobufs

Last synced: 9 days ago
JSON representation

Protobuf files used to represent data in the Google Genomics APIs.

• Host: GitHub
• URL: https://github.com/heuermh/googlegenomics-protobufs
• Owner: heuermh
• License: apache-2.0
• Created: 2014-07-09T20:50:36.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2014-04-29T21:11:41.000Z (over 10 years ago)
• Last Synced: 2024-05-02T00:30:09.923Z (6 months ago)
• Homepage:
• Size: 152 KB
• Stars: 0
• Watchers: 4
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • Contributing: CONTRIBUTING.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
protobufs

=========

The `Google Genomics API `_ uses `protobuf

`_ files to represent genomics

data. The client libraries, documentation, and JSON output are all auto generated

from these ``.proto`` files.

read.proto:

    represents a group of bases and their metadata.

readset.proto:

    represents a collection of reads along with information from the BAM file(s)

    the reads were imported from.

variant.proto:

    variants represent a change in DNA sequence relative to a reference.

    the calls on a variant represent whether a sample (aka callset) has that particular variant.

common.proto:

    holds messages that will be common across many genomics objects. Currently it

    only contains a basic key value pair.

bam.proto:

    contains all messages that map 1-1 with the BAM format. The hope is that all

    important BAM information will be pulled into top level readset fields. Until

    this is done, each readset contains the exact header sections from the BAM file

    it was imported from.

service.proto:

    defines the REST service used to expose these objects.  

The format provided by these files is also documented in the `API definition file

`_.

Note also that all of the Google Genomics APIs can return protobufs instead of JSON

by adding an ``alt=proto`` URL parameter to a request.

Project status

--------------

Goals

~~~~~

* Expose the proto files that back the Google Genomics APIs for easy discussion and sharing. 

Current status

~~~~~~~~~~~~~~

This is static code. Probably best not to compile the files nor depend on them in any way. 

See the `GA4GH repositories `_ if you are interested in schema 

development for Genomics APIs.