Difference between revisions of "DAS/2.1/Spec"
(Importing text from the original das2_protocol.html, with some mods) |
(Added link to Spec Review page) |
||
| (4 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| + | This '''DAS/2.1''' version is currently under development. Contributions to this new version are invited from both DAS/1 and DAS/2 developers with the goal of merging ideas from both camps to create a unified version of the spec suitable for all DAS-based applications. | ||
| + | |||
| + | '''See also:''' | ||
| + | * [http://biodas.org/documents/das2/das2_protocol.html Stable '''DAS/2.0''' specification] | ||
| + | * [[Spec Review]] | ||
| + | |||
==Overview== | ==Overview== | ||
| − | The DAS 2. | + | The DAS 2.x specification addresses some shortcomings of the DAS 1.x protocol, including: |
| − | * Better support for | + | * Better support for hierarchical structures (e.g. gene -> transcripts -> exons) |
* Ontology-based feature annotations | * Ontology-based feature annotations | ||
* Allow multiple formats, including formats only appropriate for some feature types | * Allow multiple formats, including formats only appropriate for some feature types | ||
| Line 10: | Line 16: | ||
DAS is a protocol for sharing biological data. This version of the | DAS is a protocol for sharing biological data. This version of the | ||
| − | specification, DAS 2. | + | specification, DAS 2.x, describes features located on the genomic |
sequence. Future versions will add support for sharing annotations of | sequence. Future versions will add support for sharing annotations of | ||
protein sequences, expression data, 3D structures and ontologies. The | protein sequences, expression data, 3D structures and ontologies. The | ||
| Line 16: | Line 22: | ||
large core shared with the protein sequence DAS. | large core shared with the protein sequence DAS. | ||
| − | A DAS 2. | + | A DAS 2.x annotation server provides feature information about one or |
more genome sources. Each source may have one or more versions. | more genome sources. Each source may have one or more versions. | ||
Different versions are usually based on different assemblies. As an | Different versions are usually based on different assemblies. As an | ||
| Line 34: | Line 40: | ||
associated with each annotation. These are called feature filters. | associated with each annotation. These are called feature filters. | ||
| − | DAS 2. | + | DAS 2.x is implemented using a |
[http://www.ics.uci.edu/~fielding/pubs/dissertation/top.htm ReST architecture]. | [http://www.ics.uci.edu/~fielding/pubs/dissertation/top.htm ReST architecture]. | ||
Each document (also called an entity or object) has | Each document (also called an entity or object) has | ||
| Line 46: | Line 52: | ||
==Retrieval of genomic sequence and annotation== | ==Retrieval of genomic sequence and annotation== | ||
| − | [[DAS/2/Spec/Get-Genomic]] | + | [[DAS/2.1/Spec/Get-Genomic]] for read-only access to genomic sequence and annotation data sources. |
==Stylesheet== | ==Stylesheet== | ||
==Writeback== | ==Writeback== | ||
| + | |||
| + | [[DAS/2.1/Spec/Writeback]] for write access (add, delete, edit) to annotation data sources. | ||
==Region locking== | ==Region locking== | ||
| − | + | ||
| + | [[DAS/2.1/Spec/Locking]] to prevent editing conflicts for clients and servers supporting writeback. | ||
| + | |||
==Assay Retrievals== | ==Assay Retrievals== | ||
==Ontology Retrievals== | ==Ontology Retrievals== | ||
Latest revision as of 14:41, 12 January 2009
This DAS/2.1 version is currently under development. Contributions to this new version are invited from both DAS/1 and DAS/2 developers with the goal of merging ideas from both camps to create a unified version of the spec suitable for all DAS-based applications.
See also:
Contents
Overview
The DAS 2.x specification addresses some shortcomings of the DAS 1.x protocol, including:
- Better support for hierarchical structures (e.g. gene -> transcripts -> exons)
- Ontology-based feature annotations
- Allow multiple formats, including formats only appropriate for some feature types
- A lock-based editing protocol for curational clients
- An extensible namespacing system that allows annotations in non-genomic coordinates (e.g. uniprot protein coordinates or PDB structure coordinates)
DAS is a protocol for sharing biological data. This version of the specification, DAS 2.x, describes features located on the genomic sequence. Future versions will add support for sharing annotations of protein sequences, expression data, 3D structures and ontologies. The genomic DAS interface is deliberately designed so there will be a large core shared with the protein sequence DAS.
A DAS 2.x annotation server provides feature information about one or more genome sources. Each source may have one or more versions. Different versions are usually based on different assemblies. As an implementation detail an assembly and corresponding sequence data may be distributed via a different machine, which is called the reference server.
Annotations are located on the genomic sequence with a start and end position. The range may be specified multiple times if there are alternate coordinate systems. An annotation may contain multiple non-continguous parts, making it the parent of those parts. Some parts may have more than one parent. Annotations have a type based on terms in SOFA (Sequence Ontology for Feature Annotation). Stylesheets contain a set of properties used to depict a given type.
Annotations can be searched by range, type, and a properties table associated with each annotation. These are called feature filters.
DAS 2.x is implemented using a ReST architecture. Each document (also called an entity or object) has a name, which is a URL. Fetching the URL gets information about the document. The DAS-specific documents are all in XML. Other data types have existing widely used formats, and sometimes more than one for the same data. A DAS server may provide a distinct document for each of these formats, along with information about which formats are available.
Retrieval of genomic sequence and annotation
DAS/2.1/Spec/Get-Genomic for read-only access to genomic sequence and annotation data sources.
Stylesheet
Writeback
DAS/2.1/Spec/Writeback for write access (add, delete, edit) to annotation data sources.
Region locking
DAS/2.1/Spec/Locking to prevent editing conflicts for clients and servers supporting writeback.
