Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 1 | <html><body> |
| 2 | <style> |
| 3 | |
| 4 | body, h1, h2, h3, div, span, p, pre, a { |
| 5 | margin: 0; |
| 6 | padding: 0; |
| 7 | border: 0; |
| 8 | font-weight: inherit; |
| 9 | font-style: inherit; |
| 10 | font-size: 100%; |
| 11 | font-family: inherit; |
| 12 | vertical-align: baseline; |
| 13 | } |
| 14 | |
| 15 | body { |
| 16 | font-size: 13px; |
| 17 | padding: 1em; |
| 18 | } |
| 19 | |
| 20 | h1 { |
| 21 | font-size: 26px; |
| 22 | margin-bottom: 1em; |
| 23 | } |
| 24 | |
| 25 | h2 { |
| 26 | font-size: 24px; |
| 27 | margin-bottom: 1em; |
| 28 | } |
| 29 | |
| 30 | h3 { |
| 31 | font-size: 20px; |
| 32 | margin-bottom: 1em; |
| 33 | margin-top: 1em; |
| 34 | } |
| 35 | |
| 36 | pre, code { |
| 37 | line-height: 1.5; |
| 38 | font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace; |
| 39 | } |
| 40 | |
| 41 | pre { |
| 42 | margin-top: 0.5em; |
| 43 | } |
| 44 | |
| 45 | h1, h2, h3, p { |
| 46 | font-family: Arial, sans serif; |
| 47 | } |
| 48 | |
| 49 | h1, h2, h3 { |
| 50 | border-bottom: solid #CCC 1px; |
| 51 | } |
| 52 | |
| 53 | .toc_element { |
| 54 | margin-top: 0.5em; |
| 55 | } |
| 56 | |
| 57 | .firstline { |
| 58 | margin-left: 2 em; |
| 59 | } |
| 60 | |
| 61 | .method { |
| 62 | margin-top: 1em; |
| 63 | border: solid 1px #CCC; |
| 64 | padding: 1em; |
| 65 | background: #EEE; |
| 66 | } |
| 67 | |
| 68 | .details { |
| 69 | font-weight: bold; |
| 70 | font-size: 14px; |
| 71 | } |
| 72 | |
| 73 | </style> |
| 74 | |
| 75 | <h1><a href="genomics_v1beta2.html">Genomics API</a> . <a href="genomics_v1beta2.annotations.html">annotations</a></h1> |
| 76 | <h2>Instance Methods</h2> |
| 77 | <p class="toc_element"> |
| 78 | <code><a href="#batchCreate">batchCreate(body)</a></code></p> |
| 79 | <p class="firstline">Creates one or more new annotations atomically. All annotations must belong to the same annotation set. Caller must have WRITE permission for this annotation set. For optimal performance, batch positionally adjacent annotations together.</p> |
| 80 | <p class="toc_element"> |
| 81 | <code><a href="#create">create(body)</a></code></p> |
| 82 | <p class="firstline">Creates a new annotation. Caller must have WRITE permission for the associated annotation set.</p> |
| 83 | <p class="toc_element"> |
| 84 | <code><a href="#delete">delete(annotationId)</a></code></p> |
| 85 | <p class="firstline">Deletes an annotation. Caller must have WRITE permission for the associated annotation set.</p> |
| 86 | <p class="toc_element"> |
| 87 | <code><a href="#get">get(annotationId)</a></code></p> |
| 88 | <p class="firstline">Gets an annotation. Caller must have READ permission for the associated annotation set.</p> |
| 89 | <p class="toc_element"> |
| 90 | <code><a href="#patch">patch(annotationId, body)</a></code></p> |
| 91 | <p class="firstline">Updates an annotation. The update must respect all mutability restrictions and other invariants described on the annotation resource. Caller must have WRITE permission for the associated dataset. This method supports patch semantics.</p> |
| 92 | <p class="toc_element"> |
| 93 | <code><a href="#search">search(body)</a></code></p> |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 94 | <p class="firstline">Searches for annotations that match the given criteria. Results are ordered by genomic coordinate (by reference sequence, then position). Annotations with equivalent genomic coordinates are returned in an unspecified order. This order is consistent, such that two queries for the same content (regardless of page size) yield annotations in the same order across their respective streams of paginated responses. Caller must have READ permission for the queried annotation sets.</p> |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 95 | <p class="toc_element"> |
| 96 | <code><a href="#update">update(annotationId, body)</a></code></p> |
| 97 | <p class="firstline">Updates an annotation. The update must respect all mutability restrictions and other invariants described on the annotation resource. Caller must have WRITE permission for the associated dataset.</p> |
| 98 | <h3>Method Details</h3> |
| 99 | <div class="method"> |
| 100 | <code class="details" id="batchCreate">batchCreate(body)</code> |
| 101 | <pre>Creates one or more new annotations atomically. All annotations must belong to the same annotation set. Caller must have WRITE permission for this annotation set. For optimal performance, batch positionally adjacent annotations together. |
| 102 | |
| 103 | |
| 104 | If the request has a systemic issue, such as an attempt to write to an inaccessible annotation set, the entire RPC will fail accordingly. For lesser data issues, when possible an error will be isolated to the corresponding batch entry in the response; the remaining well formed annotations will be created normally. |
| 105 | |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 106 | |
| 107 | For details on the requirements for each individual annotation resource, see annotations.create. |
| 108 | |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 109 | Args: |
| 110 | body: object, The request body. (required) |
| 111 | The object takes the form of: |
| 112 | |
| 113 | { |
| 114 | "annotations": [ # The annotations to be created. At most 4096 can be specified in a single request. |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 115 | { # An annotation describes a region of reference genome. The value of an annotation may be one of several canonical types, supplemented by arbitrary info tags. An annotation is not inherently associated with a specific sample or individual (though a client could choose to use annotations in this way). Example canonical annotation types are GENE and VARIANT. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 116 | "info": { # A string which maps to an array of values. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 117 | "a_key": [ # A string which maps to an array of values. |
| 118 | "A String", |
| 119 | ], |
| 120 | }, |
| 121 | "name": "A String", # The display name of this annotation. |
| 122 | "type": "A String", # The data type for this annotation. Must match the containing annotation set's type. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 123 | "variant": { # A Variant annotation. # A variant annotation, which describes the effect of a variant on the genome, the coding sequence, and/or higher level consequences at the organism level e.g. pathogenicity. This field is only set for annotations of type VARIANT. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 124 | "type": "A String", # Type has been adapted from ClinVar's list of variant types. |
| 125 | "effect": "A String", # Effect of the variant on the coding sequence. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 126 | "transcriptIds": [ # Google annotation IDs of the transcripts affected by this variant. These should be provided when the variant is created. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 127 | "A String", |
| 128 | ], |
| 129 | "alternateBases": "A String", # The alternate allele for this variant. If multiple alternate alleles exist at this location, create a separate variant for each one, as they may represent distinct conditions. |
| 130 | "clinicalSignificance": "A String", # Describes the clinical significance of a variant. It is adapted from the ClinVar controlled vocabulary for clinical significance described at: http://www.ncbi.nlm.nih.gov/clinvar/docs/clinsig/ |
| 131 | "conditions": [ # The set of conditions associated with this variant. A condition describes the way a variant influences human health. |
| 132 | { |
| 133 | "conceptId": "A String", # The MedGen concept id associated with this gene. Search for these IDs at http://www.ncbi.nlm.nih.gov/medgen/ |
| 134 | "omimId": "A String", # The OMIM id for this condition. Search for these IDs at http://omim.org/ |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 135 | "externalIds": [ # The set of external IDs for this condition. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 136 | { |
| 137 | "sourceName": "A String", # The name of the source of this data. |
| 138 | "id": "A String", # The id used by the source of this data. |
| 139 | }, |
| 140 | ], |
| 141 | "names": [ # A set of names for the condition. |
| 142 | "A String", |
| 143 | ], |
| 144 | }, |
| 145 | ], |
| 146 | "geneId": "A String", # Google annotation ID of the gene affected by this variant. This should be provided when the variant is created. |
| 147 | }, |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 148 | "annotationSetId": "A String", # The annotation set to which this annotation belongs. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 149 | "position": { # A 0-based half-open genomic coordinate range over a reference sequence, for representing the position of a genomic resource. # The position of this annotation on the reference sequence. |
| 150 | "start": "A String", # The start position of the range on the reference, 0-based inclusive. |
| 151 | "referenceId": "A String", # The ID of the Google Genomics reference associated with this range. |
| 152 | "end": "A String", # The end position of the range on the reference, 0-based exclusive. |
| 153 | "reverseStrand": True or False, # Whether this range refers to the reverse strand, as opposed to the forward strand. Note that regardless of this field, the start/end position of the range always refer to the forward strand. |
| 154 | "referenceName": "A String", # The display name corresponding to the reference specified by referenceId, for example chr1, 1, or chrX. |
| 155 | }, |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 156 | "transcript": { # A transcript represents the assertion that a particular region of the reference genome may be transcribed as RNA. # A transcript value represents the assertion that a particular region of the reference genome may be transcribed as RNA. An alternative splicing pattern would be represented as a separate transcript object. This field is only set for annotations of type TRANSCRIPT. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 157 | "codingSequence": { # The range of the coding sequence for this transcript, if any. To determine the exact ranges of coding sequence, intersect this range with those of the exons, if any. If there are any exons, the codingSequence must start and end within them. |
| 158 | # |
| 159 | # Note that in some cases, the reference genome will not exactly match the observed mRNA transcript e.g. due to variance in the source genome from reference. In these cases, exon.frame will not necessarily match the expected reference reading frame and coding exon reference bases cannot necessarily be concatenated to produce the original transcript mRNA. |
| 160 | "start": "A String", # The start of the coding sequence on this annotation's reference sequence, 0-based inclusive. Note that this position is relative to the reference start, and not the containing annotation start. |
| 161 | "end": "A String", # The end of the coding sequence on this annotation's reference sequence, 0-based exclusive. Note that this position is relative to the reference start, and not the containing annotation start. |
| 162 | }, |
| 163 | "geneId": "A String", # The annotation ID of the gene from which this transcript is transcribed. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 164 | "exons": [ # The exons that compose this transcript. This field should be unset for genomes where transcript splicing does not occur, for example prokaryotes. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 165 | # |
| 166 | # |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 167 | # Introns are regions of the transcript that are not included in the spliced RNA product. Though not explicitly modeled here, intron ranges can be deduced; all regions of this transcript that are not exons are introns. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 168 | # |
| 169 | # |
| 170 | # Exonic sequences do not necessarily code for a translational product (amino acids). Only the regions of exons bounded by the codingSequence correspond to coding DNA sequence. |
| 171 | # |
| 172 | # |
| 173 | # Exons are ordered by start position and may not overlap. |
| 174 | { |
| 175 | "start": "A String", # The start position of the exon on this annotation's reference sequence, 0-based inclusive. Note that this is relative to the reference start, and not the containing annotation start. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 176 | "frame": { # Wrapper message for `int32`. # The frame of this exon. Contains a value of 0, 1, or 2, which indicates the offset of the first coding base of the exon within the reading frame of the coding DNA sequence, if any. This field is dependent on the strandedness of this annotation (see Annotation.position.reverseStrand). For forward stranded annotations, this offset is relative to the exon.start. For reverse strand annotations, this offset is relative to the exon.end-1. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 177 | # |
| 178 | # Unset if this exon does not intersect the coding sequence. Upon creation of a transcript, the frame must be populated for all or none of the coding exons. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 179 | # |
| 180 | # The JSON representation for `Int32Value` is JSON number. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 181 | "value": 42, # The int32 value. |
| 182 | }, |
| 183 | "end": "A String", # The end position of the exon on this annotation's reference sequence, 0-based exclusive. Note that this is relative to the reference start, and not the containing annotation start. |
| 184 | }, |
| 185 | ], |
| 186 | }, |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 187 | "id": "A String", # The server-generated annotation ID, unique across all annotations. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 188 | }, |
| 189 | ], |
| 190 | } |
| 191 | |
| 192 | |
| 193 | Returns: |
| 194 | An object of the form: |
| 195 | |
| 196 | { |
| 197 | "entries": [ # The resulting per-annotation entries, ordered consistently with the original request. |
| 198 | { |
| 199 | "status": { # The resulting status for this annotation operation. |
| 200 | "message": "A String", # Error message for this status, if any. |
| 201 | "code": 42, # The HTTP status code for this operation. |
| 202 | }, |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 203 | "annotation": { # An annotation describes a region of reference genome. The value of an annotation may be one of several canonical types, supplemented by arbitrary info tags. An annotation is not inherently associated with a specific sample or individual (though a client could choose to use annotations in this way). Example canonical annotation types are GENE and VARIANT. # The annotation, if any. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 204 | "info": { # A string which maps to an array of values. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 205 | "a_key": [ # A string which maps to an array of values. |
| 206 | "A String", |
| 207 | ], |
| 208 | }, |
| 209 | "name": "A String", # The display name of this annotation. |
| 210 | "type": "A String", # The data type for this annotation. Must match the containing annotation set's type. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 211 | "variant": { # A Variant annotation. # A variant annotation, which describes the effect of a variant on the genome, the coding sequence, and/or higher level consequences at the organism level e.g. pathogenicity. This field is only set for annotations of type VARIANT. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 212 | "type": "A String", # Type has been adapted from ClinVar's list of variant types. |
| 213 | "effect": "A String", # Effect of the variant on the coding sequence. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 214 | "transcriptIds": [ # Google annotation IDs of the transcripts affected by this variant. These should be provided when the variant is created. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 215 | "A String", |
| 216 | ], |
| 217 | "alternateBases": "A String", # The alternate allele for this variant. If multiple alternate alleles exist at this location, create a separate variant for each one, as they may represent distinct conditions. |
| 218 | "clinicalSignificance": "A String", # Describes the clinical significance of a variant. It is adapted from the ClinVar controlled vocabulary for clinical significance described at: http://www.ncbi.nlm.nih.gov/clinvar/docs/clinsig/ |
| 219 | "conditions": [ # The set of conditions associated with this variant. A condition describes the way a variant influences human health. |
| 220 | { |
| 221 | "conceptId": "A String", # The MedGen concept id associated with this gene. Search for these IDs at http://www.ncbi.nlm.nih.gov/medgen/ |
| 222 | "omimId": "A String", # The OMIM id for this condition. Search for these IDs at http://omim.org/ |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 223 | "externalIds": [ # The set of external IDs for this condition. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 224 | { |
| 225 | "sourceName": "A String", # The name of the source of this data. |
| 226 | "id": "A String", # The id used by the source of this data. |
| 227 | }, |
| 228 | ], |
| 229 | "names": [ # A set of names for the condition. |
| 230 | "A String", |
| 231 | ], |
| 232 | }, |
| 233 | ], |
| 234 | "geneId": "A String", # Google annotation ID of the gene affected by this variant. This should be provided when the variant is created. |
| 235 | }, |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 236 | "annotationSetId": "A String", # The annotation set to which this annotation belongs. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 237 | "position": { # A 0-based half-open genomic coordinate range over a reference sequence, for representing the position of a genomic resource. # The position of this annotation on the reference sequence. |
| 238 | "start": "A String", # The start position of the range on the reference, 0-based inclusive. |
| 239 | "referenceId": "A String", # The ID of the Google Genomics reference associated with this range. |
| 240 | "end": "A String", # The end position of the range on the reference, 0-based exclusive. |
| 241 | "reverseStrand": True or False, # Whether this range refers to the reverse strand, as opposed to the forward strand. Note that regardless of this field, the start/end position of the range always refer to the forward strand. |
| 242 | "referenceName": "A String", # The display name corresponding to the reference specified by referenceId, for example chr1, 1, or chrX. |
| 243 | }, |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 244 | "transcript": { # A transcript represents the assertion that a particular region of the reference genome may be transcribed as RNA. # A transcript value represents the assertion that a particular region of the reference genome may be transcribed as RNA. An alternative splicing pattern would be represented as a separate transcript object. This field is only set for annotations of type TRANSCRIPT. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 245 | "codingSequence": { # The range of the coding sequence for this transcript, if any. To determine the exact ranges of coding sequence, intersect this range with those of the exons, if any. If there are any exons, the codingSequence must start and end within them. |
| 246 | # |
| 247 | # Note that in some cases, the reference genome will not exactly match the observed mRNA transcript e.g. due to variance in the source genome from reference. In these cases, exon.frame will not necessarily match the expected reference reading frame and coding exon reference bases cannot necessarily be concatenated to produce the original transcript mRNA. |
| 248 | "start": "A String", # The start of the coding sequence on this annotation's reference sequence, 0-based inclusive. Note that this position is relative to the reference start, and not the containing annotation start. |
| 249 | "end": "A String", # The end of the coding sequence on this annotation's reference sequence, 0-based exclusive. Note that this position is relative to the reference start, and not the containing annotation start. |
| 250 | }, |
| 251 | "geneId": "A String", # The annotation ID of the gene from which this transcript is transcribed. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 252 | "exons": [ # The exons that compose this transcript. This field should be unset for genomes where transcript splicing does not occur, for example prokaryotes. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 253 | # |
| 254 | # |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 255 | # Introns are regions of the transcript that are not included in the spliced RNA product. Though not explicitly modeled here, intron ranges can be deduced; all regions of this transcript that are not exons are introns. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 256 | # |
| 257 | # |
| 258 | # Exonic sequences do not necessarily code for a translational product (amino acids). Only the regions of exons bounded by the codingSequence correspond to coding DNA sequence. |
| 259 | # |
| 260 | # |
| 261 | # Exons are ordered by start position and may not overlap. |
| 262 | { |
| 263 | "start": "A String", # The start position of the exon on this annotation's reference sequence, 0-based inclusive. Note that this is relative to the reference start, and not the containing annotation start. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 264 | "frame": { # Wrapper message for `int32`. # The frame of this exon. Contains a value of 0, 1, or 2, which indicates the offset of the first coding base of the exon within the reading frame of the coding DNA sequence, if any. This field is dependent on the strandedness of this annotation (see Annotation.position.reverseStrand). For forward stranded annotations, this offset is relative to the exon.start. For reverse strand annotations, this offset is relative to the exon.end-1. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 265 | # |
| 266 | # Unset if this exon does not intersect the coding sequence. Upon creation of a transcript, the frame must be populated for all or none of the coding exons. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 267 | # |
| 268 | # The JSON representation for `Int32Value` is JSON number. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 269 | "value": 42, # The int32 value. |
| 270 | }, |
| 271 | "end": "A String", # The end position of the exon on this annotation's reference sequence, 0-based exclusive. Note that this is relative to the reference start, and not the containing annotation start. |
| 272 | }, |
| 273 | ], |
| 274 | }, |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 275 | "id": "A String", # The server-generated annotation ID, unique across all annotations. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 276 | }, |
| 277 | }, |
| 278 | ], |
| 279 | }</pre> |
| 280 | </div> |
| 281 | |
| 282 | <div class="method"> |
| 283 | <code class="details" id="create">create(body)</code> |
| 284 | <pre>Creates a new annotation. Caller must have WRITE permission for the associated annotation set. |
| 285 | |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 286 | |
| 287 | The following fields must be provided when creating an annotation: |
| 288 | - annotationSetId |
| 289 | - position.referenceName or position.referenceId Transcripts |
| 290 | For annotations of type TRANSCRIPT, the following fields of annotation.transcript must be provided: |
| 291 | - exons.start |
| 292 | - exons.end |
| 293 | All other fields may be optionally specified, unless documented as being server-generated (for example, the id field). The annotated range must be no longer than 100Mbp (mega base pairs). See the annotation resource for additional restrictions on each field. |
| 294 | |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 295 | Args: |
| 296 | body: object, The request body. (required) |
| 297 | The object takes the form of: |
| 298 | |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 299 | { # An annotation describes a region of reference genome. The value of an annotation may be one of several canonical types, supplemented by arbitrary info tags. An annotation is not inherently associated with a specific sample or individual (though a client could choose to use annotations in this way). Example canonical annotation types are GENE and VARIANT. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 300 | "info": { # A string which maps to an array of values. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 301 | "a_key": [ # A string which maps to an array of values. |
| 302 | "A String", |
| 303 | ], |
| 304 | }, |
| 305 | "name": "A String", # The display name of this annotation. |
| 306 | "type": "A String", # The data type for this annotation. Must match the containing annotation set's type. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 307 | "variant": { # A Variant annotation. # A variant annotation, which describes the effect of a variant on the genome, the coding sequence, and/or higher level consequences at the organism level e.g. pathogenicity. This field is only set for annotations of type VARIANT. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 308 | "type": "A String", # Type has been adapted from ClinVar's list of variant types. |
| 309 | "effect": "A String", # Effect of the variant on the coding sequence. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 310 | "transcriptIds": [ # Google annotation IDs of the transcripts affected by this variant. These should be provided when the variant is created. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 311 | "A String", |
| 312 | ], |
| 313 | "alternateBases": "A String", # The alternate allele for this variant. If multiple alternate alleles exist at this location, create a separate variant for each one, as they may represent distinct conditions. |
| 314 | "clinicalSignificance": "A String", # Describes the clinical significance of a variant. It is adapted from the ClinVar controlled vocabulary for clinical significance described at: http://www.ncbi.nlm.nih.gov/clinvar/docs/clinsig/ |
| 315 | "conditions": [ # The set of conditions associated with this variant. A condition describes the way a variant influences human health. |
| 316 | { |
| 317 | "conceptId": "A String", # The MedGen concept id associated with this gene. Search for these IDs at http://www.ncbi.nlm.nih.gov/medgen/ |
| 318 | "omimId": "A String", # The OMIM id for this condition. Search for these IDs at http://omim.org/ |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 319 | "externalIds": [ # The set of external IDs for this condition. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 320 | { |
| 321 | "sourceName": "A String", # The name of the source of this data. |
| 322 | "id": "A String", # The id used by the source of this data. |
| 323 | }, |
| 324 | ], |
| 325 | "names": [ # A set of names for the condition. |
| 326 | "A String", |
| 327 | ], |
| 328 | }, |
| 329 | ], |
| 330 | "geneId": "A String", # Google annotation ID of the gene affected by this variant. This should be provided when the variant is created. |
| 331 | }, |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 332 | "annotationSetId": "A String", # The annotation set to which this annotation belongs. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 333 | "position": { # A 0-based half-open genomic coordinate range over a reference sequence, for representing the position of a genomic resource. # The position of this annotation on the reference sequence. |
| 334 | "start": "A String", # The start position of the range on the reference, 0-based inclusive. |
| 335 | "referenceId": "A String", # The ID of the Google Genomics reference associated with this range. |
| 336 | "end": "A String", # The end position of the range on the reference, 0-based exclusive. |
| 337 | "reverseStrand": True or False, # Whether this range refers to the reverse strand, as opposed to the forward strand. Note that regardless of this field, the start/end position of the range always refer to the forward strand. |
| 338 | "referenceName": "A String", # The display name corresponding to the reference specified by referenceId, for example chr1, 1, or chrX. |
| 339 | }, |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 340 | "transcript": { # A transcript represents the assertion that a particular region of the reference genome may be transcribed as RNA. # A transcript value represents the assertion that a particular region of the reference genome may be transcribed as RNA. An alternative splicing pattern would be represented as a separate transcript object. This field is only set for annotations of type TRANSCRIPT. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 341 | "codingSequence": { # The range of the coding sequence for this transcript, if any. To determine the exact ranges of coding sequence, intersect this range with those of the exons, if any. If there are any exons, the codingSequence must start and end within them. |
| 342 | # |
| 343 | # Note that in some cases, the reference genome will not exactly match the observed mRNA transcript e.g. due to variance in the source genome from reference. In these cases, exon.frame will not necessarily match the expected reference reading frame and coding exon reference bases cannot necessarily be concatenated to produce the original transcript mRNA. |
| 344 | "start": "A String", # The start of the coding sequence on this annotation's reference sequence, 0-based inclusive. Note that this position is relative to the reference start, and not the containing annotation start. |
| 345 | "end": "A String", # The end of the coding sequence on this annotation's reference sequence, 0-based exclusive. Note that this position is relative to the reference start, and not the containing annotation start. |
| 346 | }, |
| 347 | "geneId": "A String", # The annotation ID of the gene from which this transcript is transcribed. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 348 | "exons": [ # The exons that compose this transcript. This field should be unset for genomes where transcript splicing does not occur, for example prokaryotes. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 349 | # |
| 350 | # |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 351 | # Introns are regions of the transcript that are not included in the spliced RNA product. Though not explicitly modeled here, intron ranges can be deduced; all regions of this transcript that are not exons are introns. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 352 | # |
| 353 | # |
| 354 | # Exonic sequences do not necessarily code for a translational product (amino acids). Only the regions of exons bounded by the codingSequence correspond to coding DNA sequence. |
| 355 | # |
| 356 | # |
| 357 | # Exons are ordered by start position and may not overlap. |
| 358 | { |
| 359 | "start": "A String", # The start position of the exon on this annotation's reference sequence, 0-based inclusive. Note that this is relative to the reference start, and not the containing annotation start. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 360 | "frame": { # Wrapper message for `int32`. # The frame of this exon. Contains a value of 0, 1, or 2, which indicates the offset of the first coding base of the exon within the reading frame of the coding DNA sequence, if any. This field is dependent on the strandedness of this annotation (see Annotation.position.reverseStrand). For forward stranded annotations, this offset is relative to the exon.start. For reverse strand annotations, this offset is relative to the exon.end-1. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 361 | # |
| 362 | # Unset if this exon does not intersect the coding sequence. Upon creation of a transcript, the frame must be populated for all or none of the coding exons. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 363 | # |
| 364 | # The JSON representation for `Int32Value` is JSON number. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 365 | "value": 42, # The int32 value. |
| 366 | }, |
| 367 | "end": "A String", # The end position of the exon on this annotation's reference sequence, 0-based exclusive. Note that this is relative to the reference start, and not the containing annotation start. |
| 368 | }, |
| 369 | ], |
| 370 | }, |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 371 | "id": "A String", # The server-generated annotation ID, unique across all annotations. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 372 | } |
| 373 | |
| 374 | |
| 375 | Returns: |
| 376 | An object of the form: |
| 377 | |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 378 | { # An annotation describes a region of reference genome. The value of an annotation may be one of several canonical types, supplemented by arbitrary info tags. An annotation is not inherently associated with a specific sample or individual (though a client could choose to use annotations in this way). Example canonical annotation types are GENE and VARIANT. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 379 | "info": { # A string which maps to an array of values. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 380 | "a_key": [ # A string which maps to an array of values. |
| 381 | "A String", |
| 382 | ], |
| 383 | }, |
| 384 | "name": "A String", # The display name of this annotation. |
| 385 | "type": "A String", # The data type for this annotation. Must match the containing annotation set's type. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 386 | "variant": { # A Variant annotation. # A variant annotation, which describes the effect of a variant on the genome, the coding sequence, and/or higher level consequences at the organism level e.g. pathogenicity. This field is only set for annotations of type VARIANT. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 387 | "type": "A String", # Type has been adapted from ClinVar's list of variant types. |
| 388 | "effect": "A String", # Effect of the variant on the coding sequence. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 389 | "transcriptIds": [ # Google annotation IDs of the transcripts affected by this variant. These should be provided when the variant is created. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 390 | "A String", |
| 391 | ], |
| 392 | "alternateBases": "A String", # The alternate allele for this variant. If multiple alternate alleles exist at this location, create a separate variant for each one, as they may represent distinct conditions. |
| 393 | "clinicalSignificance": "A String", # Describes the clinical significance of a variant. It is adapted from the ClinVar controlled vocabulary for clinical significance described at: http://www.ncbi.nlm.nih.gov/clinvar/docs/clinsig/ |
| 394 | "conditions": [ # The set of conditions associated with this variant. A condition describes the way a variant influences human health. |
| 395 | { |
| 396 | "conceptId": "A String", # The MedGen concept id associated with this gene. Search for these IDs at http://www.ncbi.nlm.nih.gov/medgen/ |
| 397 | "omimId": "A String", # The OMIM id for this condition. Search for these IDs at http://omim.org/ |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 398 | "externalIds": [ # The set of external IDs for this condition. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 399 | { |
| 400 | "sourceName": "A String", # The name of the source of this data. |
| 401 | "id": "A String", # The id used by the source of this data. |
| 402 | }, |
| 403 | ], |
| 404 | "names": [ # A set of names for the condition. |
| 405 | "A String", |
| 406 | ], |
| 407 | }, |
| 408 | ], |
| 409 | "geneId": "A String", # Google annotation ID of the gene affected by this variant. This should be provided when the variant is created. |
| 410 | }, |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 411 | "annotationSetId": "A String", # The annotation set to which this annotation belongs. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 412 | "position": { # A 0-based half-open genomic coordinate range over a reference sequence, for representing the position of a genomic resource. # The position of this annotation on the reference sequence. |
| 413 | "start": "A String", # The start position of the range on the reference, 0-based inclusive. |
| 414 | "referenceId": "A String", # The ID of the Google Genomics reference associated with this range. |
| 415 | "end": "A String", # The end position of the range on the reference, 0-based exclusive. |
| 416 | "reverseStrand": True or False, # Whether this range refers to the reverse strand, as opposed to the forward strand. Note that regardless of this field, the start/end position of the range always refer to the forward strand. |
| 417 | "referenceName": "A String", # The display name corresponding to the reference specified by referenceId, for example chr1, 1, or chrX. |
| 418 | }, |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 419 | "transcript": { # A transcript represents the assertion that a particular region of the reference genome may be transcribed as RNA. # A transcript value represents the assertion that a particular region of the reference genome may be transcribed as RNA. An alternative splicing pattern would be represented as a separate transcript object. This field is only set for annotations of type TRANSCRIPT. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 420 | "codingSequence": { # The range of the coding sequence for this transcript, if any. To determine the exact ranges of coding sequence, intersect this range with those of the exons, if any. If there are any exons, the codingSequence must start and end within them. |
| 421 | # |
| 422 | # Note that in some cases, the reference genome will not exactly match the observed mRNA transcript e.g. due to variance in the source genome from reference. In these cases, exon.frame will not necessarily match the expected reference reading frame and coding exon reference bases cannot necessarily be concatenated to produce the original transcript mRNA. |
| 423 | "start": "A String", # The start of the coding sequence on this annotation's reference sequence, 0-based inclusive. Note that this position is relative to the reference start, and not the containing annotation start. |
| 424 | "end": "A String", # The end of the coding sequence on this annotation's reference sequence, 0-based exclusive. Note that this position is relative to the reference start, and not the containing annotation start. |
| 425 | }, |
| 426 | "geneId": "A String", # The annotation ID of the gene from which this transcript is transcribed. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 427 | "exons": [ # The exons that compose this transcript. This field should be unset for genomes where transcript splicing does not occur, for example prokaryotes. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 428 | # |
| 429 | # |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 430 | # Introns are regions of the transcript that are not included in the spliced RNA product. Though not explicitly modeled here, intron ranges can be deduced; all regions of this transcript that are not exons are introns. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 431 | # |
| 432 | # |
| 433 | # Exonic sequences do not necessarily code for a translational product (amino acids). Only the regions of exons bounded by the codingSequence correspond to coding DNA sequence. |
| 434 | # |
| 435 | # |
| 436 | # Exons are ordered by start position and may not overlap. |
| 437 | { |
| 438 | "start": "A String", # The start position of the exon on this annotation's reference sequence, 0-based inclusive. Note that this is relative to the reference start, and not the containing annotation start. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 439 | "frame": { # Wrapper message for `int32`. # The frame of this exon. Contains a value of 0, 1, or 2, which indicates the offset of the first coding base of the exon within the reading frame of the coding DNA sequence, if any. This field is dependent on the strandedness of this annotation (see Annotation.position.reverseStrand). For forward stranded annotations, this offset is relative to the exon.start. For reverse strand annotations, this offset is relative to the exon.end-1. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 440 | # |
| 441 | # Unset if this exon does not intersect the coding sequence. Upon creation of a transcript, the frame must be populated for all or none of the coding exons. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 442 | # |
| 443 | # The JSON representation for `Int32Value` is JSON number. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 444 | "value": 42, # The int32 value. |
| 445 | }, |
| 446 | "end": "A String", # The end position of the exon on this annotation's reference sequence, 0-based exclusive. Note that this is relative to the reference start, and not the containing annotation start. |
| 447 | }, |
| 448 | ], |
| 449 | }, |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 450 | "id": "A String", # The server-generated annotation ID, unique across all annotations. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 451 | }</pre> |
| 452 | </div> |
| 453 | |
| 454 | <div class="method"> |
| 455 | <code class="details" id="delete">delete(annotationId)</code> |
| 456 | <pre>Deletes an annotation. Caller must have WRITE permission for the associated annotation set. |
| 457 | |
| 458 | Args: |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 459 | annotationId: string, The ID of the annotation to be deleted. (required) |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 460 | </pre> |
| 461 | </div> |
| 462 | |
| 463 | <div class="method"> |
| 464 | <code class="details" id="get">get(annotationId)</code> |
| 465 | <pre>Gets an annotation. Caller must have READ permission for the associated annotation set. |
| 466 | |
| 467 | Args: |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 468 | annotationId: string, The ID of the annotation to be retrieved. (required) |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 469 | |
| 470 | Returns: |
| 471 | An object of the form: |
| 472 | |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 473 | { # An annotation describes a region of reference genome. The value of an annotation may be one of several canonical types, supplemented by arbitrary info tags. An annotation is not inherently associated with a specific sample or individual (though a client could choose to use annotations in this way). Example canonical annotation types are GENE and VARIANT. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 474 | "info": { # A string which maps to an array of values. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 475 | "a_key": [ # A string which maps to an array of values. |
| 476 | "A String", |
| 477 | ], |
| 478 | }, |
| 479 | "name": "A String", # The display name of this annotation. |
| 480 | "type": "A String", # The data type for this annotation. Must match the containing annotation set's type. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 481 | "variant": { # A Variant annotation. # A variant annotation, which describes the effect of a variant on the genome, the coding sequence, and/or higher level consequences at the organism level e.g. pathogenicity. This field is only set for annotations of type VARIANT. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 482 | "type": "A String", # Type has been adapted from ClinVar's list of variant types. |
| 483 | "effect": "A String", # Effect of the variant on the coding sequence. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 484 | "transcriptIds": [ # Google annotation IDs of the transcripts affected by this variant. These should be provided when the variant is created. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 485 | "A String", |
| 486 | ], |
| 487 | "alternateBases": "A String", # The alternate allele for this variant. If multiple alternate alleles exist at this location, create a separate variant for each one, as they may represent distinct conditions. |
| 488 | "clinicalSignificance": "A String", # Describes the clinical significance of a variant. It is adapted from the ClinVar controlled vocabulary for clinical significance described at: http://www.ncbi.nlm.nih.gov/clinvar/docs/clinsig/ |
| 489 | "conditions": [ # The set of conditions associated with this variant. A condition describes the way a variant influences human health. |
| 490 | { |
| 491 | "conceptId": "A String", # The MedGen concept id associated with this gene. Search for these IDs at http://www.ncbi.nlm.nih.gov/medgen/ |
| 492 | "omimId": "A String", # The OMIM id for this condition. Search for these IDs at http://omim.org/ |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 493 | "externalIds": [ # The set of external IDs for this condition. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 494 | { |
| 495 | "sourceName": "A String", # The name of the source of this data. |
| 496 | "id": "A String", # The id used by the source of this data. |
| 497 | }, |
| 498 | ], |
| 499 | "names": [ # A set of names for the condition. |
| 500 | "A String", |
| 501 | ], |
| 502 | }, |
| 503 | ], |
| 504 | "geneId": "A String", # Google annotation ID of the gene affected by this variant. This should be provided when the variant is created. |
| 505 | }, |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 506 | "annotationSetId": "A String", # The annotation set to which this annotation belongs. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 507 | "position": { # A 0-based half-open genomic coordinate range over a reference sequence, for representing the position of a genomic resource. # The position of this annotation on the reference sequence. |
| 508 | "start": "A String", # The start position of the range on the reference, 0-based inclusive. |
| 509 | "referenceId": "A String", # The ID of the Google Genomics reference associated with this range. |
| 510 | "end": "A String", # The end position of the range on the reference, 0-based exclusive. |
| 511 | "reverseStrand": True or False, # Whether this range refers to the reverse strand, as opposed to the forward strand. Note that regardless of this field, the start/end position of the range always refer to the forward strand. |
| 512 | "referenceName": "A String", # The display name corresponding to the reference specified by referenceId, for example chr1, 1, or chrX. |
| 513 | }, |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 514 | "transcript": { # A transcript represents the assertion that a particular region of the reference genome may be transcribed as RNA. # A transcript value represents the assertion that a particular region of the reference genome may be transcribed as RNA. An alternative splicing pattern would be represented as a separate transcript object. This field is only set for annotations of type TRANSCRIPT. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 515 | "codingSequence": { # The range of the coding sequence for this transcript, if any. To determine the exact ranges of coding sequence, intersect this range with those of the exons, if any. If there are any exons, the codingSequence must start and end within them. |
| 516 | # |
| 517 | # Note that in some cases, the reference genome will not exactly match the observed mRNA transcript e.g. due to variance in the source genome from reference. In these cases, exon.frame will not necessarily match the expected reference reading frame and coding exon reference bases cannot necessarily be concatenated to produce the original transcript mRNA. |
| 518 | "start": "A String", # The start of the coding sequence on this annotation's reference sequence, 0-based inclusive. Note that this position is relative to the reference start, and not the containing annotation start. |
| 519 | "end": "A String", # The end of the coding sequence on this annotation's reference sequence, 0-based exclusive. Note that this position is relative to the reference start, and not the containing annotation start. |
| 520 | }, |
| 521 | "geneId": "A String", # The annotation ID of the gene from which this transcript is transcribed. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 522 | "exons": [ # The exons that compose this transcript. This field should be unset for genomes where transcript splicing does not occur, for example prokaryotes. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 523 | # |
| 524 | # |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 525 | # Introns are regions of the transcript that are not included in the spliced RNA product. Though not explicitly modeled here, intron ranges can be deduced; all regions of this transcript that are not exons are introns. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 526 | # |
| 527 | # |
| 528 | # Exonic sequences do not necessarily code for a translational product (amino acids). Only the regions of exons bounded by the codingSequence correspond to coding DNA sequence. |
| 529 | # |
| 530 | # |
| 531 | # Exons are ordered by start position and may not overlap. |
| 532 | { |
| 533 | "start": "A String", # The start position of the exon on this annotation's reference sequence, 0-based inclusive. Note that this is relative to the reference start, and not the containing annotation start. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 534 | "frame": { # Wrapper message for `int32`. # The frame of this exon. Contains a value of 0, 1, or 2, which indicates the offset of the first coding base of the exon within the reading frame of the coding DNA sequence, if any. This field is dependent on the strandedness of this annotation (see Annotation.position.reverseStrand). For forward stranded annotations, this offset is relative to the exon.start. For reverse strand annotations, this offset is relative to the exon.end-1. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 535 | # |
| 536 | # Unset if this exon does not intersect the coding sequence. Upon creation of a transcript, the frame must be populated for all or none of the coding exons. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 537 | # |
| 538 | # The JSON representation for `Int32Value` is JSON number. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 539 | "value": 42, # The int32 value. |
| 540 | }, |
| 541 | "end": "A String", # The end position of the exon on this annotation's reference sequence, 0-based exclusive. Note that this is relative to the reference start, and not the containing annotation start. |
| 542 | }, |
| 543 | ], |
| 544 | }, |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 545 | "id": "A String", # The server-generated annotation ID, unique across all annotations. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 546 | }</pre> |
| 547 | </div> |
| 548 | |
| 549 | <div class="method"> |
| 550 | <code class="details" id="patch">patch(annotationId, body)</code> |
| 551 | <pre>Updates an annotation. The update must respect all mutability restrictions and other invariants described on the annotation resource. Caller must have WRITE permission for the associated dataset. This method supports patch semantics. |
| 552 | |
| 553 | Args: |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 554 | annotationId: string, The ID of the annotation to be updated. (required) |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 555 | body: object, The request body. (required) |
| 556 | The object takes the form of: |
| 557 | |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 558 | { # An annotation describes a region of reference genome. The value of an annotation may be one of several canonical types, supplemented by arbitrary info tags. An annotation is not inherently associated with a specific sample or individual (though a client could choose to use annotations in this way). Example canonical annotation types are GENE and VARIANT. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 559 | "info": { # A string which maps to an array of values. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 560 | "a_key": [ # A string which maps to an array of values. |
| 561 | "A String", |
| 562 | ], |
| 563 | }, |
| 564 | "name": "A String", # The display name of this annotation. |
| 565 | "type": "A String", # The data type for this annotation. Must match the containing annotation set's type. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 566 | "variant": { # A Variant annotation. # A variant annotation, which describes the effect of a variant on the genome, the coding sequence, and/or higher level consequences at the organism level e.g. pathogenicity. This field is only set for annotations of type VARIANT. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 567 | "type": "A String", # Type has been adapted from ClinVar's list of variant types. |
| 568 | "effect": "A String", # Effect of the variant on the coding sequence. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 569 | "transcriptIds": [ # Google annotation IDs of the transcripts affected by this variant. These should be provided when the variant is created. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 570 | "A String", |
| 571 | ], |
| 572 | "alternateBases": "A String", # The alternate allele for this variant. If multiple alternate alleles exist at this location, create a separate variant for each one, as they may represent distinct conditions. |
| 573 | "clinicalSignificance": "A String", # Describes the clinical significance of a variant. It is adapted from the ClinVar controlled vocabulary for clinical significance described at: http://www.ncbi.nlm.nih.gov/clinvar/docs/clinsig/ |
| 574 | "conditions": [ # The set of conditions associated with this variant. A condition describes the way a variant influences human health. |
| 575 | { |
| 576 | "conceptId": "A String", # The MedGen concept id associated with this gene. Search for these IDs at http://www.ncbi.nlm.nih.gov/medgen/ |
| 577 | "omimId": "A String", # The OMIM id for this condition. Search for these IDs at http://omim.org/ |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 578 | "externalIds": [ # The set of external IDs for this condition. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 579 | { |
| 580 | "sourceName": "A String", # The name of the source of this data. |
| 581 | "id": "A String", # The id used by the source of this data. |
| 582 | }, |
| 583 | ], |
| 584 | "names": [ # A set of names for the condition. |
| 585 | "A String", |
| 586 | ], |
| 587 | }, |
| 588 | ], |
| 589 | "geneId": "A String", # Google annotation ID of the gene affected by this variant. This should be provided when the variant is created. |
| 590 | }, |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 591 | "annotationSetId": "A String", # The annotation set to which this annotation belongs. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 592 | "position": { # A 0-based half-open genomic coordinate range over a reference sequence, for representing the position of a genomic resource. # The position of this annotation on the reference sequence. |
| 593 | "start": "A String", # The start position of the range on the reference, 0-based inclusive. |
| 594 | "referenceId": "A String", # The ID of the Google Genomics reference associated with this range. |
| 595 | "end": "A String", # The end position of the range on the reference, 0-based exclusive. |
| 596 | "reverseStrand": True or False, # Whether this range refers to the reverse strand, as opposed to the forward strand. Note that regardless of this field, the start/end position of the range always refer to the forward strand. |
| 597 | "referenceName": "A String", # The display name corresponding to the reference specified by referenceId, for example chr1, 1, or chrX. |
| 598 | }, |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 599 | "transcript": { # A transcript represents the assertion that a particular region of the reference genome may be transcribed as RNA. # A transcript value represents the assertion that a particular region of the reference genome may be transcribed as RNA. An alternative splicing pattern would be represented as a separate transcript object. This field is only set for annotations of type TRANSCRIPT. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 600 | "codingSequence": { # The range of the coding sequence for this transcript, if any. To determine the exact ranges of coding sequence, intersect this range with those of the exons, if any. If there are any exons, the codingSequence must start and end within them. |
| 601 | # |
| 602 | # Note that in some cases, the reference genome will not exactly match the observed mRNA transcript e.g. due to variance in the source genome from reference. In these cases, exon.frame will not necessarily match the expected reference reading frame and coding exon reference bases cannot necessarily be concatenated to produce the original transcript mRNA. |
| 603 | "start": "A String", # The start of the coding sequence on this annotation's reference sequence, 0-based inclusive. Note that this position is relative to the reference start, and not the containing annotation start. |
| 604 | "end": "A String", # The end of the coding sequence on this annotation's reference sequence, 0-based exclusive. Note that this position is relative to the reference start, and not the containing annotation start. |
| 605 | }, |
| 606 | "geneId": "A String", # The annotation ID of the gene from which this transcript is transcribed. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 607 | "exons": [ # The exons that compose this transcript. This field should be unset for genomes where transcript splicing does not occur, for example prokaryotes. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 608 | # |
| 609 | # |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 610 | # Introns are regions of the transcript that are not included in the spliced RNA product. Though not explicitly modeled here, intron ranges can be deduced; all regions of this transcript that are not exons are introns. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 611 | # |
| 612 | # |
| 613 | # Exonic sequences do not necessarily code for a translational product (amino acids). Only the regions of exons bounded by the codingSequence correspond to coding DNA sequence. |
| 614 | # |
| 615 | # |
| 616 | # Exons are ordered by start position and may not overlap. |
| 617 | { |
| 618 | "start": "A String", # The start position of the exon on this annotation's reference sequence, 0-based inclusive. Note that this is relative to the reference start, and not the containing annotation start. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 619 | "frame": { # Wrapper message for `int32`. # The frame of this exon. Contains a value of 0, 1, or 2, which indicates the offset of the first coding base of the exon within the reading frame of the coding DNA sequence, if any. This field is dependent on the strandedness of this annotation (see Annotation.position.reverseStrand). For forward stranded annotations, this offset is relative to the exon.start. For reverse strand annotations, this offset is relative to the exon.end-1. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 620 | # |
| 621 | # Unset if this exon does not intersect the coding sequence. Upon creation of a transcript, the frame must be populated for all or none of the coding exons. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 622 | # |
| 623 | # The JSON representation for `Int32Value` is JSON number. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 624 | "value": 42, # The int32 value. |
| 625 | }, |
| 626 | "end": "A String", # The end position of the exon on this annotation's reference sequence, 0-based exclusive. Note that this is relative to the reference start, and not the containing annotation start. |
| 627 | }, |
| 628 | ], |
| 629 | }, |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 630 | "id": "A String", # The server-generated annotation ID, unique across all annotations. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 631 | } |
| 632 | |
| 633 | |
| 634 | Returns: |
| 635 | An object of the form: |
| 636 | |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 637 | { # An annotation describes a region of reference genome. The value of an annotation may be one of several canonical types, supplemented by arbitrary info tags. An annotation is not inherently associated with a specific sample or individual (though a client could choose to use annotations in this way). Example canonical annotation types are GENE and VARIANT. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 638 | "info": { # A string which maps to an array of values. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 639 | "a_key": [ # A string which maps to an array of values. |
| 640 | "A String", |
| 641 | ], |
| 642 | }, |
| 643 | "name": "A String", # The display name of this annotation. |
| 644 | "type": "A String", # The data type for this annotation. Must match the containing annotation set's type. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 645 | "variant": { # A Variant annotation. # A variant annotation, which describes the effect of a variant on the genome, the coding sequence, and/or higher level consequences at the organism level e.g. pathogenicity. This field is only set for annotations of type VARIANT. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 646 | "type": "A String", # Type has been adapted from ClinVar's list of variant types. |
| 647 | "effect": "A String", # Effect of the variant on the coding sequence. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 648 | "transcriptIds": [ # Google annotation IDs of the transcripts affected by this variant. These should be provided when the variant is created. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 649 | "A String", |
| 650 | ], |
| 651 | "alternateBases": "A String", # The alternate allele for this variant. If multiple alternate alleles exist at this location, create a separate variant for each one, as they may represent distinct conditions. |
| 652 | "clinicalSignificance": "A String", # Describes the clinical significance of a variant. It is adapted from the ClinVar controlled vocabulary for clinical significance described at: http://www.ncbi.nlm.nih.gov/clinvar/docs/clinsig/ |
| 653 | "conditions": [ # The set of conditions associated with this variant. A condition describes the way a variant influences human health. |
| 654 | { |
| 655 | "conceptId": "A String", # The MedGen concept id associated with this gene. Search for these IDs at http://www.ncbi.nlm.nih.gov/medgen/ |
| 656 | "omimId": "A String", # The OMIM id for this condition. Search for these IDs at http://omim.org/ |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 657 | "externalIds": [ # The set of external IDs for this condition. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 658 | { |
| 659 | "sourceName": "A String", # The name of the source of this data. |
| 660 | "id": "A String", # The id used by the source of this data. |
| 661 | }, |
| 662 | ], |
| 663 | "names": [ # A set of names for the condition. |
| 664 | "A String", |
| 665 | ], |
| 666 | }, |
| 667 | ], |
| 668 | "geneId": "A String", # Google annotation ID of the gene affected by this variant. This should be provided when the variant is created. |
| 669 | }, |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 670 | "annotationSetId": "A String", # The annotation set to which this annotation belongs. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 671 | "position": { # A 0-based half-open genomic coordinate range over a reference sequence, for representing the position of a genomic resource. # The position of this annotation on the reference sequence. |
| 672 | "start": "A String", # The start position of the range on the reference, 0-based inclusive. |
| 673 | "referenceId": "A String", # The ID of the Google Genomics reference associated with this range. |
| 674 | "end": "A String", # The end position of the range on the reference, 0-based exclusive. |
| 675 | "reverseStrand": True or False, # Whether this range refers to the reverse strand, as opposed to the forward strand. Note that regardless of this field, the start/end position of the range always refer to the forward strand. |
| 676 | "referenceName": "A String", # The display name corresponding to the reference specified by referenceId, for example chr1, 1, or chrX. |
| 677 | }, |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 678 | "transcript": { # A transcript represents the assertion that a particular region of the reference genome may be transcribed as RNA. # A transcript value represents the assertion that a particular region of the reference genome may be transcribed as RNA. An alternative splicing pattern would be represented as a separate transcript object. This field is only set for annotations of type TRANSCRIPT. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 679 | "codingSequence": { # The range of the coding sequence for this transcript, if any. To determine the exact ranges of coding sequence, intersect this range with those of the exons, if any. If there are any exons, the codingSequence must start and end within them. |
| 680 | # |
| 681 | # Note that in some cases, the reference genome will not exactly match the observed mRNA transcript e.g. due to variance in the source genome from reference. In these cases, exon.frame will not necessarily match the expected reference reading frame and coding exon reference bases cannot necessarily be concatenated to produce the original transcript mRNA. |
| 682 | "start": "A String", # The start of the coding sequence on this annotation's reference sequence, 0-based inclusive. Note that this position is relative to the reference start, and not the containing annotation start. |
| 683 | "end": "A String", # The end of the coding sequence on this annotation's reference sequence, 0-based exclusive. Note that this position is relative to the reference start, and not the containing annotation start. |
| 684 | }, |
| 685 | "geneId": "A String", # The annotation ID of the gene from which this transcript is transcribed. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 686 | "exons": [ # The exons that compose this transcript. This field should be unset for genomes where transcript splicing does not occur, for example prokaryotes. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 687 | # |
| 688 | # |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 689 | # Introns are regions of the transcript that are not included in the spliced RNA product. Though not explicitly modeled here, intron ranges can be deduced; all regions of this transcript that are not exons are introns. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 690 | # |
| 691 | # |
| 692 | # Exonic sequences do not necessarily code for a translational product (amino acids). Only the regions of exons bounded by the codingSequence correspond to coding DNA sequence. |
| 693 | # |
| 694 | # |
| 695 | # Exons are ordered by start position and may not overlap. |
| 696 | { |
| 697 | "start": "A String", # The start position of the exon on this annotation's reference sequence, 0-based inclusive. Note that this is relative to the reference start, and not the containing annotation start. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 698 | "frame": { # Wrapper message for `int32`. # The frame of this exon. Contains a value of 0, 1, or 2, which indicates the offset of the first coding base of the exon within the reading frame of the coding DNA sequence, if any. This field is dependent on the strandedness of this annotation (see Annotation.position.reverseStrand). For forward stranded annotations, this offset is relative to the exon.start. For reverse strand annotations, this offset is relative to the exon.end-1. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 699 | # |
| 700 | # Unset if this exon does not intersect the coding sequence. Upon creation of a transcript, the frame must be populated for all or none of the coding exons. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 701 | # |
| 702 | # The JSON representation for `Int32Value` is JSON number. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 703 | "value": 42, # The int32 value. |
| 704 | }, |
| 705 | "end": "A String", # The end position of the exon on this annotation's reference sequence, 0-based exclusive. Note that this is relative to the reference start, and not the containing annotation start. |
| 706 | }, |
| 707 | ], |
| 708 | }, |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 709 | "id": "A String", # The server-generated annotation ID, unique across all annotations. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 710 | }</pre> |
| 711 | </div> |
| 712 | |
| 713 | <div class="method"> |
| 714 | <code class="details" id="search">search(body)</code> |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 715 | <pre>Searches for annotations that match the given criteria. Results are ordered by genomic coordinate (by reference sequence, then position). Annotations with equivalent genomic coordinates are returned in an unspecified order. This order is consistent, such that two queries for the same content (regardless of page size) yield annotations in the same order across their respective streams of paginated responses. Caller must have READ permission for the queried annotation sets. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 716 | |
| 717 | Args: |
| 718 | body: object, The request body. (required) |
| 719 | The object takes the form of: |
| 720 | |
| 721 | { |
| 722 | "pageToken": "A String", # The continuation token, which is used to page through large result sets. To get the next page of results, set this parameter to the value of nextPageToken from the previous response. |
Jon Wayne Parrott | 0a471d3 | 2016-05-19 10:54:38 -0700 | [diff] [blame] | 723 | "range": { # A 0-based half-open genomic coordinate range for search requests. reference_id or reference_name must be set. # If specified, this query matches only annotations that overlap this range. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 724 | "start": "A String", # The start position of the range on the reference, 0-based inclusive. If specified, referenceId or referenceName must also be specified. Defaults to 0. |
Jon Wayne Parrott | 0a471d3 | 2016-05-19 10:54:38 -0700 | [diff] [blame] | 725 | "referenceId": "A String", # The ID of the reference to query. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 726 | "end": "A String", # The end position of the range on the reference, 0-based exclusive. If specified, referenceId or referenceName must also be specified. If unset or 0, defaults to the length of the reference. |
Jon Wayne Parrott | 0a471d3 | 2016-05-19 10:54:38 -0700 | [diff] [blame] | 727 | "referenceName": "A String", # The name of the reference to query, within the reference set associated with this query. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 728 | }, |
| 729 | "annotationSetIds": [ # The annotation sets to search within. The caller must have READ access to these annotation sets. Required. All queried annotation sets must have the same type. |
| 730 | "A String", |
| 731 | ], |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 732 | "pageSize": 42, # The maximum number of results to return in a single page. If unspecified, defaults to 256. The maximum value is 2048. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 733 | } |
| 734 | |
| 735 | |
| 736 | Returns: |
| 737 | An object of the form: |
| 738 | |
| 739 | { |
| 740 | "nextPageToken": "A String", # The continuation token, which is used to page through large result sets. Provide this value in a subsequent request to return the next page of results. This field will be empty if there aren't any additional results. |
| 741 | "annotations": [ # The matching annotations. |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 742 | { # An annotation describes a region of reference genome. The value of an annotation may be one of several canonical types, supplemented by arbitrary info tags. An annotation is not inherently associated with a specific sample or individual (though a client could choose to use annotations in this way). Example canonical annotation types are GENE and VARIANT. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 743 | "info": { # A string which maps to an array of values. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 744 | "a_key": [ # A string which maps to an array of values. |
| 745 | "A String", |
| 746 | ], |
| 747 | }, |
| 748 | "name": "A String", # The display name of this annotation. |
| 749 | "type": "A String", # The data type for this annotation. Must match the containing annotation set's type. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 750 | "variant": { # A Variant annotation. # A variant annotation, which describes the effect of a variant on the genome, the coding sequence, and/or higher level consequences at the organism level e.g. pathogenicity. This field is only set for annotations of type VARIANT. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 751 | "type": "A String", # Type has been adapted from ClinVar's list of variant types. |
| 752 | "effect": "A String", # Effect of the variant on the coding sequence. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 753 | "transcriptIds": [ # Google annotation IDs of the transcripts affected by this variant. These should be provided when the variant is created. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 754 | "A String", |
| 755 | ], |
| 756 | "alternateBases": "A String", # The alternate allele for this variant. If multiple alternate alleles exist at this location, create a separate variant for each one, as they may represent distinct conditions. |
| 757 | "clinicalSignificance": "A String", # Describes the clinical significance of a variant. It is adapted from the ClinVar controlled vocabulary for clinical significance described at: http://www.ncbi.nlm.nih.gov/clinvar/docs/clinsig/ |
| 758 | "conditions": [ # The set of conditions associated with this variant. A condition describes the way a variant influences human health. |
| 759 | { |
| 760 | "conceptId": "A String", # The MedGen concept id associated with this gene. Search for these IDs at http://www.ncbi.nlm.nih.gov/medgen/ |
| 761 | "omimId": "A String", # The OMIM id for this condition. Search for these IDs at http://omim.org/ |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 762 | "externalIds": [ # The set of external IDs for this condition. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 763 | { |
| 764 | "sourceName": "A String", # The name of the source of this data. |
| 765 | "id": "A String", # The id used by the source of this data. |
| 766 | }, |
| 767 | ], |
| 768 | "names": [ # A set of names for the condition. |
| 769 | "A String", |
| 770 | ], |
| 771 | }, |
| 772 | ], |
| 773 | "geneId": "A String", # Google annotation ID of the gene affected by this variant. This should be provided when the variant is created. |
| 774 | }, |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 775 | "annotationSetId": "A String", # The annotation set to which this annotation belongs. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 776 | "position": { # A 0-based half-open genomic coordinate range over a reference sequence, for representing the position of a genomic resource. # The position of this annotation on the reference sequence. |
| 777 | "start": "A String", # The start position of the range on the reference, 0-based inclusive. |
| 778 | "referenceId": "A String", # The ID of the Google Genomics reference associated with this range. |
| 779 | "end": "A String", # The end position of the range on the reference, 0-based exclusive. |
| 780 | "reverseStrand": True or False, # Whether this range refers to the reverse strand, as opposed to the forward strand. Note that regardless of this field, the start/end position of the range always refer to the forward strand. |
| 781 | "referenceName": "A String", # The display name corresponding to the reference specified by referenceId, for example chr1, 1, or chrX. |
| 782 | }, |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 783 | "transcript": { # A transcript represents the assertion that a particular region of the reference genome may be transcribed as RNA. # A transcript value represents the assertion that a particular region of the reference genome may be transcribed as RNA. An alternative splicing pattern would be represented as a separate transcript object. This field is only set for annotations of type TRANSCRIPT. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 784 | "codingSequence": { # The range of the coding sequence for this transcript, if any. To determine the exact ranges of coding sequence, intersect this range with those of the exons, if any. If there are any exons, the codingSequence must start and end within them. |
| 785 | # |
| 786 | # Note that in some cases, the reference genome will not exactly match the observed mRNA transcript e.g. due to variance in the source genome from reference. In these cases, exon.frame will not necessarily match the expected reference reading frame and coding exon reference bases cannot necessarily be concatenated to produce the original transcript mRNA. |
| 787 | "start": "A String", # The start of the coding sequence on this annotation's reference sequence, 0-based inclusive. Note that this position is relative to the reference start, and not the containing annotation start. |
| 788 | "end": "A String", # The end of the coding sequence on this annotation's reference sequence, 0-based exclusive. Note that this position is relative to the reference start, and not the containing annotation start. |
| 789 | }, |
| 790 | "geneId": "A String", # The annotation ID of the gene from which this transcript is transcribed. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 791 | "exons": [ # The exons that compose this transcript. This field should be unset for genomes where transcript splicing does not occur, for example prokaryotes. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 792 | # |
| 793 | # |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 794 | # Introns are regions of the transcript that are not included in the spliced RNA product. Though not explicitly modeled here, intron ranges can be deduced; all regions of this transcript that are not exons are introns. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 795 | # |
| 796 | # |
| 797 | # Exonic sequences do not necessarily code for a translational product (amino acids). Only the regions of exons bounded by the codingSequence correspond to coding DNA sequence. |
| 798 | # |
| 799 | # |
| 800 | # Exons are ordered by start position and may not overlap. |
| 801 | { |
| 802 | "start": "A String", # The start position of the exon on this annotation's reference sequence, 0-based inclusive. Note that this is relative to the reference start, and not the containing annotation start. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 803 | "frame": { # Wrapper message for `int32`. # The frame of this exon. Contains a value of 0, 1, or 2, which indicates the offset of the first coding base of the exon within the reading frame of the coding DNA sequence, if any. This field is dependent on the strandedness of this annotation (see Annotation.position.reverseStrand). For forward stranded annotations, this offset is relative to the exon.start. For reverse strand annotations, this offset is relative to the exon.end-1. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 804 | # |
| 805 | # Unset if this exon does not intersect the coding sequence. Upon creation of a transcript, the frame must be populated for all or none of the coding exons. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 806 | # |
| 807 | # The JSON representation for `Int32Value` is JSON number. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 808 | "value": 42, # The int32 value. |
| 809 | }, |
| 810 | "end": "A String", # The end position of the exon on this annotation's reference sequence, 0-based exclusive. Note that this is relative to the reference start, and not the containing annotation start. |
| 811 | }, |
| 812 | ], |
| 813 | }, |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 814 | "id": "A String", # The server-generated annotation ID, unique across all annotations. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 815 | }, |
| 816 | ], |
| 817 | }</pre> |
| 818 | </div> |
| 819 | |
| 820 | <div class="method"> |
| 821 | <code class="details" id="update">update(annotationId, body)</code> |
| 822 | <pre>Updates an annotation. The update must respect all mutability restrictions and other invariants described on the annotation resource. Caller must have WRITE permission for the associated dataset. |
| 823 | |
| 824 | Args: |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 825 | annotationId: string, The ID of the annotation to be updated. (required) |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 826 | body: object, The request body. (required) |
| 827 | The object takes the form of: |
| 828 | |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 829 | { # An annotation describes a region of reference genome. The value of an annotation may be one of several canonical types, supplemented by arbitrary info tags. An annotation is not inherently associated with a specific sample or individual (though a client could choose to use annotations in this way). Example canonical annotation types are GENE and VARIANT. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 830 | "info": { # A string which maps to an array of values. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 831 | "a_key": [ # A string which maps to an array of values. |
| 832 | "A String", |
| 833 | ], |
| 834 | }, |
| 835 | "name": "A String", # The display name of this annotation. |
| 836 | "type": "A String", # The data type for this annotation. Must match the containing annotation set's type. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 837 | "variant": { # A Variant annotation. # A variant annotation, which describes the effect of a variant on the genome, the coding sequence, and/or higher level consequences at the organism level e.g. pathogenicity. This field is only set for annotations of type VARIANT. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 838 | "type": "A String", # Type has been adapted from ClinVar's list of variant types. |
| 839 | "effect": "A String", # Effect of the variant on the coding sequence. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 840 | "transcriptIds": [ # Google annotation IDs of the transcripts affected by this variant. These should be provided when the variant is created. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 841 | "A String", |
| 842 | ], |
| 843 | "alternateBases": "A String", # The alternate allele for this variant. If multiple alternate alleles exist at this location, create a separate variant for each one, as they may represent distinct conditions. |
| 844 | "clinicalSignificance": "A String", # Describes the clinical significance of a variant. It is adapted from the ClinVar controlled vocabulary for clinical significance described at: http://www.ncbi.nlm.nih.gov/clinvar/docs/clinsig/ |
| 845 | "conditions": [ # The set of conditions associated with this variant. A condition describes the way a variant influences human health. |
| 846 | { |
| 847 | "conceptId": "A String", # The MedGen concept id associated with this gene. Search for these IDs at http://www.ncbi.nlm.nih.gov/medgen/ |
| 848 | "omimId": "A String", # The OMIM id for this condition. Search for these IDs at http://omim.org/ |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 849 | "externalIds": [ # The set of external IDs for this condition. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 850 | { |
| 851 | "sourceName": "A String", # The name of the source of this data. |
| 852 | "id": "A String", # The id used by the source of this data. |
| 853 | }, |
| 854 | ], |
| 855 | "names": [ # A set of names for the condition. |
| 856 | "A String", |
| 857 | ], |
| 858 | }, |
| 859 | ], |
| 860 | "geneId": "A String", # Google annotation ID of the gene affected by this variant. This should be provided when the variant is created. |
| 861 | }, |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 862 | "annotationSetId": "A String", # The annotation set to which this annotation belongs. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 863 | "position": { # A 0-based half-open genomic coordinate range over a reference sequence, for representing the position of a genomic resource. # The position of this annotation on the reference sequence. |
| 864 | "start": "A String", # The start position of the range on the reference, 0-based inclusive. |
| 865 | "referenceId": "A String", # The ID of the Google Genomics reference associated with this range. |
| 866 | "end": "A String", # The end position of the range on the reference, 0-based exclusive. |
| 867 | "reverseStrand": True or False, # Whether this range refers to the reverse strand, as opposed to the forward strand. Note that regardless of this field, the start/end position of the range always refer to the forward strand. |
| 868 | "referenceName": "A String", # The display name corresponding to the reference specified by referenceId, for example chr1, 1, or chrX. |
| 869 | }, |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 870 | "transcript": { # A transcript represents the assertion that a particular region of the reference genome may be transcribed as RNA. # A transcript value represents the assertion that a particular region of the reference genome may be transcribed as RNA. An alternative splicing pattern would be represented as a separate transcript object. This field is only set for annotations of type TRANSCRIPT. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 871 | "codingSequence": { # The range of the coding sequence for this transcript, if any. To determine the exact ranges of coding sequence, intersect this range with those of the exons, if any. If there are any exons, the codingSequence must start and end within them. |
| 872 | # |
| 873 | # Note that in some cases, the reference genome will not exactly match the observed mRNA transcript e.g. due to variance in the source genome from reference. In these cases, exon.frame will not necessarily match the expected reference reading frame and coding exon reference bases cannot necessarily be concatenated to produce the original transcript mRNA. |
| 874 | "start": "A String", # The start of the coding sequence on this annotation's reference sequence, 0-based inclusive. Note that this position is relative to the reference start, and not the containing annotation start. |
| 875 | "end": "A String", # The end of the coding sequence on this annotation's reference sequence, 0-based exclusive. Note that this position is relative to the reference start, and not the containing annotation start. |
| 876 | }, |
| 877 | "geneId": "A String", # The annotation ID of the gene from which this transcript is transcribed. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 878 | "exons": [ # The exons that compose this transcript. This field should be unset for genomes where transcript splicing does not occur, for example prokaryotes. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 879 | # |
| 880 | # |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 881 | # Introns are regions of the transcript that are not included in the spliced RNA product. Though not explicitly modeled here, intron ranges can be deduced; all regions of this transcript that are not exons are introns. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 882 | # |
| 883 | # |
| 884 | # Exonic sequences do not necessarily code for a translational product (amino acids). Only the regions of exons bounded by the codingSequence correspond to coding DNA sequence. |
| 885 | # |
| 886 | # |
| 887 | # Exons are ordered by start position and may not overlap. |
| 888 | { |
| 889 | "start": "A String", # The start position of the exon on this annotation's reference sequence, 0-based inclusive. Note that this is relative to the reference start, and not the containing annotation start. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 890 | "frame": { # Wrapper message for `int32`. # The frame of this exon. Contains a value of 0, 1, or 2, which indicates the offset of the first coding base of the exon within the reading frame of the coding DNA sequence, if any. This field is dependent on the strandedness of this annotation (see Annotation.position.reverseStrand). For forward stranded annotations, this offset is relative to the exon.start. For reverse strand annotations, this offset is relative to the exon.end-1. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 891 | # |
| 892 | # Unset if this exon does not intersect the coding sequence. Upon creation of a transcript, the frame must be populated for all or none of the coding exons. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 893 | # |
| 894 | # The JSON representation for `Int32Value` is JSON number. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 895 | "value": 42, # The int32 value. |
| 896 | }, |
| 897 | "end": "A String", # The end position of the exon on this annotation's reference sequence, 0-based exclusive. Note that this is relative to the reference start, and not the containing annotation start. |
| 898 | }, |
| 899 | ], |
| 900 | }, |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 901 | "id": "A String", # The server-generated annotation ID, unique across all annotations. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 902 | } |
| 903 | |
| 904 | |
| 905 | Returns: |
| 906 | An object of the form: |
| 907 | |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 908 | { # An annotation describes a region of reference genome. The value of an annotation may be one of several canonical types, supplemented by arbitrary info tags. An annotation is not inherently associated with a specific sample or individual (though a client could choose to use annotations in this way). Example canonical annotation types are GENE and VARIANT. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 909 | "info": { # A string which maps to an array of values. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 910 | "a_key": [ # A string which maps to an array of values. |
| 911 | "A String", |
| 912 | ], |
| 913 | }, |
| 914 | "name": "A String", # The display name of this annotation. |
| 915 | "type": "A String", # The data type for this annotation. Must match the containing annotation set's type. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 916 | "variant": { # A Variant annotation. # A variant annotation, which describes the effect of a variant on the genome, the coding sequence, and/or higher level consequences at the organism level e.g. pathogenicity. This field is only set for annotations of type VARIANT. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 917 | "type": "A String", # Type has been adapted from ClinVar's list of variant types. |
| 918 | "effect": "A String", # Effect of the variant on the coding sequence. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 919 | "transcriptIds": [ # Google annotation IDs of the transcripts affected by this variant. These should be provided when the variant is created. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 920 | "A String", |
| 921 | ], |
| 922 | "alternateBases": "A String", # The alternate allele for this variant. If multiple alternate alleles exist at this location, create a separate variant for each one, as they may represent distinct conditions. |
| 923 | "clinicalSignificance": "A String", # Describes the clinical significance of a variant. It is adapted from the ClinVar controlled vocabulary for clinical significance described at: http://www.ncbi.nlm.nih.gov/clinvar/docs/clinsig/ |
| 924 | "conditions": [ # The set of conditions associated with this variant. A condition describes the way a variant influences human health. |
| 925 | { |
| 926 | "conceptId": "A String", # The MedGen concept id associated with this gene. Search for these IDs at http://www.ncbi.nlm.nih.gov/medgen/ |
| 927 | "omimId": "A String", # The OMIM id for this condition. Search for these IDs at http://omim.org/ |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 928 | "externalIds": [ # The set of external IDs for this condition. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 929 | { |
| 930 | "sourceName": "A String", # The name of the source of this data. |
| 931 | "id": "A String", # The id used by the source of this data. |
| 932 | }, |
| 933 | ], |
| 934 | "names": [ # A set of names for the condition. |
| 935 | "A String", |
| 936 | ], |
| 937 | }, |
| 938 | ], |
| 939 | "geneId": "A String", # Google annotation ID of the gene affected by this variant. This should be provided when the variant is created. |
| 940 | }, |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 941 | "annotationSetId": "A String", # The annotation set to which this annotation belongs. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 942 | "position": { # A 0-based half-open genomic coordinate range over a reference sequence, for representing the position of a genomic resource. # The position of this annotation on the reference sequence. |
| 943 | "start": "A String", # The start position of the range on the reference, 0-based inclusive. |
| 944 | "referenceId": "A String", # The ID of the Google Genomics reference associated with this range. |
| 945 | "end": "A String", # The end position of the range on the reference, 0-based exclusive. |
| 946 | "reverseStrand": True or False, # Whether this range refers to the reverse strand, as opposed to the forward strand. Note that regardless of this field, the start/end position of the range always refer to the forward strand. |
| 947 | "referenceName": "A String", # The display name corresponding to the reference specified by referenceId, for example chr1, 1, or chrX. |
| 948 | }, |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 949 | "transcript": { # A transcript represents the assertion that a particular region of the reference genome may be transcribed as RNA. # A transcript value represents the assertion that a particular region of the reference genome may be transcribed as RNA. An alternative splicing pattern would be represented as a separate transcript object. This field is only set for annotations of type TRANSCRIPT. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 950 | "codingSequence": { # The range of the coding sequence for this transcript, if any. To determine the exact ranges of coding sequence, intersect this range with those of the exons, if any. If there are any exons, the codingSequence must start and end within them. |
| 951 | # |
| 952 | # Note that in some cases, the reference genome will not exactly match the observed mRNA transcript e.g. due to variance in the source genome from reference. In these cases, exon.frame will not necessarily match the expected reference reading frame and coding exon reference bases cannot necessarily be concatenated to produce the original transcript mRNA. |
| 953 | "start": "A String", # The start of the coding sequence on this annotation's reference sequence, 0-based inclusive. Note that this position is relative to the reference start, and not the containing annotation start. |
| 954 | "end": "A String", # The end of the coding sequence on this annotation's reference sequence, 0-based exclusive. Note that this position is relative to the reference start, and not the containing annotation start. |
| 955 | }, |
| 956 | "geneId": "A String", # The annotation ID of the gene from which this transcript is transcribed. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 957 | "exons": [ # The exons that compose this transcript. This field should be unset for genomes where transcript splicing does not occur, for example prokaryotes. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 958 | # |
| 959 | # |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 960 | # Introns are regions of the transcript that are not included in the spliced RNA product. Though not explicitly modeled here, intron ranges can be deduced; all regions of this transcript that are not exons are introns. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 961 | # |
| 962 | # |
| 963 | # Exonic sequences do not necessarily code for a translational product (amino acids). Only the regions of exons bounded by the codingSequence correspond to coding DNA sequence. |
| 964 | # |
| 965 | # |
| 966 | # Exons are ordered by start position and may not overlap. |
| 967 | { |
| 968 | "start": "A String", # The start position of the exon on this annotation's reference sequence, 0-based inclusive. Note that this is relative to the reference start, and not the containing annotation start. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 969 | "frame": { # Wrapper message for `int32`. # The frame of this exon. Contains a value of 0, 1, or 2, which indicates the offset of the first coding base of the exon within the reading frame of the coding DNA sequence, if any. This field is dependent on the strandedness of this annotation (see Annotation.position.reverseStrand). For forward stranded annotations, this offset is relative to the exon.start. For reverse strand annotations, this offset is relative to the exon.end-1. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 970 | # |
| 971 | # Unset if this exon does not intersect the coding sequence. Upon creation of a transcript, the frame must be populated for all or none of the coding exons. |
Nathaniel Manista | 4f877e5 | 2015-06-15 16:44:50 +0000 | [diff] [blame] | 972 | # |
| 973 | # The JSON representation for `Int32Value` is JSON number. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 974 | "value": 42, # The int32 value. |
| 975 | }, |
| 976 | "end": "A String", # The end position of the exon on this annotation's reference sequence, 0-based exclusive. Note that this is relative to the reference start, and not the containing annotation start. |
| 977 | }, |
| 978 | ], |
| 979 | }, |
Jon Wayne Parrott | 36e41bc | 2016-02-19 16:02:29 -0800 | [diff] [blame] | 980 | "id": "A String", # The server-generated annotation ID, unique across all annotations. |
Craig Citro | e633be1 | 2015-03-02 13:40:36 -0800 | [diff] [blame] | 981 | }</pre> |
| 982 | </div> |
| 983 | |
| 984 | </body></html> |