Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / 068eb35c9a70e31a42f04d5cb69c36d59e4a2a69 / . / docs / dyn / genomics_v1beta2.variants.html
blob: 88f2479d28e751fe3cf1e8ff2f4c2652aeacb55c [file] [log] [blame]
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]1<html><body>
2<style>
3
4body, 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
15body {
16 font-size: 13px;
17 padding: 1em;
18}
19
20h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23}
24
25h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28}
29
30h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34}
35
36pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42 margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46 font-family: Arial, sans serif;
47}
48
49h1, 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.variants.html">variants</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78 <code><a href="#create">create(body)</a></code></p>
79<p class="firstline">Creates a new variant.</p>
80<p class="toc_element">
81 <code><a href="#delete">delete(variantId)</a></code></p>
82<p class="firstline">Deletes a variant.</p>
83<p class="toc_element">
84 <code><a href="#get">get(variantId)</a></code></p>
85<p class="firstline">Gets a variant by ID.</p>
86<p class="toc_element">
87 <code><a href="#search">search(body)</a></code></p>
88<p class="firstline">Gets a list of variants matching the criteria.</p>
89<p class="toc_element">
90 <code><a href="#update">update(variantId, body)</a></code></p>
91<p class="firstline">Updates a variant's names and info fields. All other modifications are silently ignored. Returns the modified variant without its calls.</p>
92<h3>Method Details</h3>
93<div class="method">
94 <code class="details" id="create">create(body)</code>
95 <pre>Creates a new variant.
96
97Args:
98 body: object, The request body. (required)
99 The object takes the form of:
100
101{ # A variant represents a change in DNA sequence relative to a reference sequence. For example, a variant could represent a SNP or an insertion. Variants belong to a variant set. Each of the calls on a variant represent a determination of genotype with respect to that variant. For example, a call might assign probability of 0.32 to the occurrence of a SNP named rs1234 in a sample named NA12345. A call belongs to a call set, which contains related calls typically from one sample.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]102 "info": { # A string which maps to an array of values.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]103 "a_key": [ # A string which maps to an array of values.
104 "A String",
105 ],
106 },
107 "variantSetId": "A String", # The ID of the variant set this variant belongs to.
108 "end": "A String", # The end position (0-based) of this variant. This corresponds to the first base after the last base in the reference allele. So, the length of the reference allele is (end - start). This is useful for variants that don't explicitly give alternate bases, for example large deletions.
109 "calls": [ # The variant calls for this particular variant. Each one represents the determination of genotype with respect to this variant.
110 { # A call represents the determination of genotype with respect to a particular variant. It may include associated information such as quality and phasing. For example, a call might assign a probability of 0.32 to the occurrence of a SNP named rs1234 in a call set with the name NA12345.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]111 "info": { # A string which maps to an array of values.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]112 "a_key": [ # A string which maps to an array of values.
113 "A String",
114 ],
115 },
116 "genotype": [ # The genotype of this variant call. Each value represents either the value of the referenceBases field or a 1-based index into alternateBases. If a variant had a referenceBases value of T and an alternateBases value of ["A", "C"], and the genotype was [2, 1], that would mean the call represented the heterozygous value CA for this variant. If the genotype was instead [0, 1], the represented value would be TA. Ordering of the genotype values is important if the phaseset is present. If a genotype is not called (that is, a . is present in the GT string) -1 is returned.
117 42,
118 ],
119 "callSetId": "A String", # The ID of the call set this variant call belongs to.
120 "phaseset": "A String", # If this field is present, this variant call's genotype ordering implies the phase of the bases and is consistent with any other variant calls in the same reference sequence which have the same phaseset value. When importing data from VCF, if the genotype data was phased but no phase set was specified this field will be set to *.
121 "genotypeLikelihood": [ # The genotype likelihoods for this variant call. Each array entry represents how likely a specific genotype is for this call. The value ordering is defined by the GL tag in the VCF spec. If Phred-scaled genotype likelihood scores (PL) are available and log10(P) genotype likelihood scores (GL) are not, PL scores are converted to GL scores. If both are available, PL scores are stored in info.
122 3.14,
123 ],
124 "callSetName": "A String", # The name of the call set this variant call belongs to.
125 },
126 ],
127 "created": "A String", # The date this variant was created, in milliseconds from the epoch.
128 "referenceBases": "A String", # The reference bases for this variant. They start at the given position.
129 "filter": [ # A list of filters (normally quality filters) this variant has failed. PASS indicates this variant has passed all filters.
130 "A String",
131 ],
132 "start": "A String", # The position at which this variant occurs (0-based). This corresponds to the first base of the string of reference bases.
133 "names": [ # Names for the variant, for example a RefSNP ID.
134 "A String",
135 ],
136 "alternateBases": [ # The bases that appear instead of the reference bases.
137 "A String",
138 ],
139 "referenceName": "A String", # The reference on which this variant occurs. (such as chr20 or X)
140 "quality": 3.14, # A measure of how likely this variant is to be real. A higher value is better.
141 "id": "A String", # The Google generated ID of the variant, immutable.
142 }
143
144
145Returns:
146 An object of the form:
147
148 { # A variant represents a change in DNA sequence relative to a reference sequence. For example, a variant could represent a SNP or an insertion. Variants belong to a variant set. Each of the calls on a variant represent a determination of genotype with respect to that variant. For example, a call might assign probability of 0.32 to the occurrence of a SNP named rs1234 in a sample named NA12345. A call belongs to a call set, which contains related calls typically from one sample.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]149 "info": { # A string which maps to an array of values.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]150 "a_key": [ # A string which maps to an array of values.
151 "A String",
152 ],
153 },
154 "variantSetId": "A String", # The ID of the variant set this variant belongs to.
155 "end": "A String", # The end position (0-based) of this variant. This corresponds to the first base after the last base in the reference allele. So, the length of the reference allele is (end - start). This is useful for variants that don't explicitly give alternate bases, for example large deletions.
156 "calls": [ # The variant calls for this particular variant. Each one represents the determination of genotype with respect to this variant.
157 { # A call represents the determination of genotype with respect to a particular variant. It may include associated information such as quality and phasing. For example, a call might assign a probability of 0.32 to the occurrence of a SNP named rs1234 in a call set with the name NA12345.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]158 "info": { # A string which maps to an array of values.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]159 "a_key": [ # A string which maps to an array of values.
160 "A String",
161 ],
162 },
163 "genotype": [ # The genotype of this variant call. Each value represents either the value of the referenceBases field or a 1-based index into alternateBases. If a variant had a referenceBases value of T and an alternateBases value of ["A", "C"], and the genotype was [2, 1], that would mean the call represented the heterozygous value CA for this variant. If the genotype was instead [0, 1], the represented value would be TA. Ordering of the genotype values is important if the phaseset is present. If a genotype is not called (that is, a . is present in the GT string) -1 is returned.
164 42,
165 ],
166 "callSetId": "A String", # The ID of the call set this variant call belongs to.
167 "phaseset": "A String", # If this field is present, this variant call's genotype ordering implies the phase of the bases and is consistent with any other variant calls in the same reference sequence which have the same phaseset value. When importing data from VCF, if the genotype data was phased but no phase set was specified this field will be set to *.
168 "genotypeLikelihood": [ # The genotype likelihoods for this variant call. Each array entry represents how likely a specific genotype is for this call. The value ordering is defined by the GL tag in the VCF spec. If Phred-scaled genotype likelihood scores (PL) are available and log10(P) genotype likelihood scores (GL) are not, PL scores are converted to GL scores. If both are available, PL scores are stored in info.
169 3.14,
170 ],
171 "callSetName": "A String", # The name of the call set this variant call belongs to.
172 },
173 ],
174 "created": "A String", # The date this variant was created, in milliseconds from the epoch.
175 "referenceBases": "A String", # The reference bases for this variant. They start at the given position.
176 "filter": [ # A list of filters (normally quality filters) this variant has failed. PASS indicates this variant has passed all filters.
177 "A String",
178 ],
179 "start": "A String", # The position at which this variant occurs (0-based). This corresponds to the first base of the string of reference bases.
180 "names": [ # Names for the variant, for example a RefSNP ID.
181 "A String",
182 ],
183 "alternateBases": [ # The bases that appear instead of the reference bases.
184 "A String",
185 ],
186 "referenceName": "A String", # The reference on which this variant occurs. (such as chr20 or X)
187 "quality": 3.14, # A measure of how likely this variant is to be real. A higher value is better.
188 "id": "A String", # The Google generated ID of the variant, immutable.
189 }</pre>
190</div>
191
192<div class="method">
193 <code class="details" id="delete">delete(variantId)</code>
194 <pre>Deletes a variant.
195
196Args:
197 variantId: string, The ID of the variant to be deleted. (required)
198</pre>
199</div>
200
201<div class="method">
202 <code class="details" id="get">get(variantId)</code>
203 <pre>Gets a variant by ID.
204
205Args:
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]206 variantId: string, Required. (required)
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]207
208Returns:
209 An object of the form:
210
211 { # A variant represents a change in DNA sequence relative to a reference sequence. For example, a variant could represent a SNP or an insertion. Variants belong to a variant set. Each of the calls on a variant represent a determination of genotype with respect to that variant. For example, a call might assign probability of 0.32 to the occurrence of a SNP named rs1234 in a sample named NA12345. A call belongs to a call set, which contains related calls typically from one sample.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]212 "info": { # A string which maps to an array of values.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]213 "a_key": [ # A string which maps to an array of values.
214 "A String",
215 ],
216 },
217 "variantSetId": "A String", # The ID of the variant set this variant belongs to.
218 "end": "A String", # The end position (0-based) of this variant. This corresponds to the first base after the last base in the reference allele. So, the length of the reference allele is (end - start). This is useful for variants that don't explicitly give alternate bases, for example large deletions.
219 "calls": [ # The variant calls for this particular variant. Each one represents the determination of genotype with respect to this variant.
220 { # A call represents the determination of genotype with respect to a particular variant. It may include associated information such as quality and phasing. For example, a call might assign a probability of 0.32 to the occurrence of a SNP named rs1234 in a call set with the name NA12345.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]221 "info": { # A string which maps to an array of values.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]222 "a_key": [ # A string which maps to an array of values.
223 "A String",
224 ],
225 },
226 "genotype": [ # The genotype of this variant call. Each value represents either the value of the referenceBases field or a 1-based index into alternateBases. If a variant had a referenceBases value of T and an alternateBases value of ["A", "C"], and the genotype was [2, 1], that would mean the call represented the heterozygous value CA for this variant. If the genotype was instead [0, 1], the represented value would be TA. Ordering of the genotype values is important if the phaseset is present. If a genotype is not called (that is, a . is present in the GT string) -1 is returned.
227 42,
228 ],
229 "callSetId": "A String", # The ID of the call set this variant call belongs to.
230 "phaseset": "A String", # If this field is present, this variant call's genotype ordering implies the phase of the bases and is consistent with any other variant calls in the same reference sequence which have the same phaseset value. When importing data from VCF, if the genotype data was phased but no phase set was specified this field will be set to *.
231 "genotypeLikelihood": [ # The genotype likelihoods for this variant call. Each array entry represents how likely a specific genotype is for this call. The value ordering is defined by the GL tag in the VCF spec. If Phred-scaled genotype likelihood scores (PL) are available and log10(P) genotype likelihood scores (GL) are not, PL scores are converted to GL scores. If both are available, PL scores are stored in info.
232 3.14,
233 ],
234 "callSetName": "A String", # The name of the call set this variant call belongs to.
235 },
236 ],
237 "created": "A String", # The date this variant was created, in milliseconds from the epoch.
238 "referenceBases": "A String", # The reference bases for this variant. They start at the given position.
239 "filter": [ # A list of filters (normally quality filters) this variant has failed. PASS indicates this variant has passed all filters.
240 "A String",
241 ],
242 "start": "A String", # The position at which this variant occurs (0-based). This corresponds to the first base of the string of reference bases.
243 "names": [ # Names for the variant, for example a RefSNP ID.
244 "A String",
245 ],
246 "alternateBases": [ # The bases that appear instead of the reference bases.
247 "A String",
248 ],
249 "referenceName": "A String", # The reference on which this variant occurs. (such as chr20 or X)
250 "quality": 3.14, # A measure of how likely this variant is to be real. A higher value is better.
251 "id": "A String", # The Google generated ID of the variant, immutable.
252 }</pre>
253</div>
254
255<div class="method">
256 <code class="details" id="search">search(body)</code>
257 <pre>Gets a list of variants matching the criteria.
258
259Implements GlobalAllianceApi.searchVariants.
260
261Args:
262 body: object, The request body. (required)
263 The object takes the form of:
264
265{ # The variant search request.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]266 "end": "A String", # The end of the window, 0-based exclusive. If unspecified or 0, defaults to the length of the reference.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]267 "pageSize": 42, # The maximum number of variants to return in a single page. If unspecified, defaults to 5000. The maximum value is 10000.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]268 "start": "A String", # The beginning of the window (0-based, inclusive) for which overlapping variants should be returned. If unspecified, defaults to 0.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]269 "maxCalls": 42, # The maximum number of calls to return in a single page. Note that this limit may be exceeded in the event that a matching variant contains more calls than the requested maximum. If unspecified, defaults to 5000. The maximum value is 10000.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]270 "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 Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]271 "callSetIds": [ # Only return variant calls which belong to call sets with these ids. Leaving this blank returns all variant calls. If a variant has no calls belonging to any of these call sets, it won't be returned at all.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]272 "A String",
273 ],
274 "variantName": "A String", # Only return variants which have exactly this name.
275 "referenceName": "A String", # Required. Only return variants in this reference sequence.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]276 "variantSetIds": [ # At most one variant set ID must be provided. Only variants from this variant set will be returned. If omitted, a call set id must be included in the request. Both this and call_set_ids may be set.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]277 "A String",
278 ],
279 }
280
281
282Returns:
283 An object of the form:
284
285 { # The variant search response.
286 "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.
287 "variants": [ # The list of matching Variants.
288 { # A variant represents a change in DNA sequence relative to a reference sequence. For example, a variant could represent a SNP or an insertion. Variants belong to a variant set. Each of the calls on a variant represent a determination of genotype with respect to that variant. For example, a call might assign probability of 0.32 to the occurrence of a SNP named rs1234 in a sample named NA12345. A call belongs to a call set, which contains related calls typically from one sample.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]289 "info": { # A string which maps to an array of values.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]290 "a_key": [ # A string which maps to an array of values.
291 "A String",
292 ],
293 },
294 "variantSetId": "A String", # The ID of the variant set this variant belongs to.
295 "end": "A String", # The end position (0-based) of this variant. This corresponds to the first base after the last base in the reference allele. So, the length of the reference allele is (end - start). This is useful for variants that don't explicitly give alternate bases, for example large deletions.
296 "calls": [ # The variant calls for this particular variant. Each one represents the determination of genotype with respect to this variant.
297 { # A call represents the determination of genotype with respect to a particular variant. It may include associated information such as quality and phasing. For example, a call might assign a probability of 0.32 to the occurrence of a SNP named rs1234 in a call set with the name NA12345.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]298 "info": { # A string which maps to an array of values.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]299 "a_key": [ # A string which maps to an array of values.
300 "A String",
301 ],
302 },
303 "genotype": [ # The genotype of this variant call. Each value represents either the value of the referenceBases field or a 1-based index into alternateBases. If a variant had a referenceBases value of T and an alternateBases value of ["A", "C"], and the genotype was [2, 1], that would mean the call represented the heterozygous value CA for this variant. If the genotype was instead [0, 1], the represented value would be TA. Ordering of the genotype values is important if the phaseset is present. If a genotype is not called (that is, a . is present in the GT string) -1 is returned.
304 42,
305 ],
306 "callSetId": "A String", # The ID of the call set this variant call belongs to.
307 "phaseset": "A String", # If this field is present, this variant call's genotype ordering implies the phase of the bases and is consistent with any other variant calls in the same reference sequence which have the same phaseset value. When importing data from VCF, if the genotype data was phased but no phase set was specified this field will be set to *.
308 "genotypeLikelihood": [ # The genotype likelihoods for this variant call. Each array entry represents how likely a specific genotype is for this call. The value ordering is defined by the GL tag in the VCF spec. If Phred-scaled genotype likelihood scores (PL) are available and log10(P) genotype likelihood scores (GL) are not, PL scores are converted to GL scores. If both are available, PL scores are stored in info.
309 3.14,
310 ],
311 "callSetName": "A String", # The name of the call set this variant call belongs to.
312 },
313 ],
314 "created": "A String", # The date this variant was created, in milliseconds from the epoch.
315 "referenceBases": "A String", # The reference bases for this variant. They start at the given position.
316 "filter": [ # A list of filters (normally quality filters) this variant has failed. PASS indicates this variant has passed all filters.
317 "A String",
318 ],
319 "start": "A String", # The position at which this variant occurs (0-based). This corresponds to the first base of the string of reference bases.
320 "names": [ # Names for the variant, for example a RefSNP ID.
321 "A String",
322 ],
323 "alternateBases": [ # The bases that appear instead of the reference bases.
324 "A String",
325 ],
326 "referenceName": "A String", # The reference on which this variant occurs. (such as chr20 or X)
327 "quality": 3.14, # A measure of how likely this variant is to be real. A higher value is better.
328 "id": "A String", # The Google generated ID of the variant, immutable.
329 },
330 ],
331 }</pre>
332</div>
333
334<div class="method">
335 <code class="details" id="update">update(variantId, body)</code>
336 <pre>Updates a variant's names and info fields. All other modifications are silently ignored. Returns the modified variant without its calls.
337
338Args:
339 variantId: string, The ID of the variant to be updated. (required)
340 body: object, The request body. (required)
341 The object takes the form of:
342
343{ # A variant represents a change in DNA sequence relative to a reference sequence. For example, a variant could represent a SNP or an insertion. Variants belong to a variant set. Each of the calls on a variant represent a determination of genotype with respect to that variant. For example, a call might assign probability of 0.32 to the occurrence of a SNP named rs1234 in a sample named NA12345. A call belongs to a call set, which contains related calls typically from one sample.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]344 "info": { # A string which maps to an array of values.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]345 "a_key": [ # A string which maps to an array of values.
346 "A String",
347 ],
348 },
349 "variantSetId": "A String", # The ID of the variant set this variant belongs to.
350 "end": "A String", # The end position (0-based) of this variant. This corresponds to the first base after the last base in the reference allele. So, the length of the reference allele is (end - start). This is useful for variants that don't explicitly give alternate bases, for example large deletions.
351 "calls": [ # The variant calls for this particular variant. Each one represents the determination of genotype with respect to this variant.
352 { # A call represents the determination of genotype with respect to a particular variant. It may include associated information such as quality and phasing. For example, a call might assign a probability of 0.32 to the occurrence of a SNP named rs1234 in a call set with the name NA12345.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]353 "info": { # A string which maps to an array of values.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]354 "a_key": [ # A string which maps to an array of values.
355 "A String",
356 ],
357 },
358 "genotype": [ # The genotype of this variant call. Each value represents either the value of the referenceBases field or a 1-based index into alternateBases. If a variant had a referenceBases value of T and an alternateBases value of ["A", "C"], and the genotype was [2, 1], that would mean the call represented the heterozygous value CA for this variant. If the genotype was instead [0, 1], the represented value would be TA. Ordering of the genotype values is important if the phaseset is present. If a genotype is not called (that is, a . is present in the GT string) -1 is returned.
359 42,
360 ],
361 "callSetId": "A String", # The ID of the call set this variant call belongs to.
362 "phaseset": "A String", # If this field is present, this variant call's genotype ordering implies the phase of the bases and is consistent with any other variant calls in the same reference sequence which have the same phaseset value. When importing data from VCF, if the genotype data was phased but no phase set was specified this field will be set to *.
363 "genotypeLikelihood": [ # The genotype likelihoods for this variant call. Each array entry represents how likely a specific genotype is for this call. The value ordering is defined by the GL tag in the VCF spec. If Phred-scaled genotype likelihood scores (PL) are available and log10(P) genotype likelihood scores (GL) are not, PL scores are converted to GL scores. If both are available, PL scores are stored in info.
364 3.14,
365 ],
366 "callSetName": "A String", # The name of the call set this variant call belongs to.
367 },
368 ],
369 "created": "A String", # The date this variant was created, in milliseconds from the epoch.
370 "referenceBases": "A String", # The reference bases for this variant. They start at the given position.
371 "filter": [ # A list of filters (normally quality filters) this variant has failed. PASS indicates this variant has passed all filters.
372 "A String",
373 ],
374 "start": "A String", # The position at which this variant occurs (0-based). This corresponds to the first base of the string of reference bases.
375 "names": [ # Names for the variant, for example a RefSNP ID.
376 "A String",
377 ],
378 "alternateBases": [ # The bases that appear instead of the reference bases.
379 "A String",
380 ],
381 "referenceName": "A String", # The reference on which this variant occurs. (such as chr20 or X)
382 "quality": 3.14, # A measure of how likely this variant is to be real. A higher value is better.
383 "id": "A String", # The Google generated ID of the variant, immutable.
384 }
385
386
387Returns:
388 An object of the form:
389
390 { # A variant represents a change in DNA sequence relative to a reference sequence. For example, a variant could represent a SNP or an insertion. Variants belong to a variant set. Each of the calls on a variant represent a determination of genotype with respect to that variant. For example, a call might assign probability of 0.32 to the occurrence of a SNP named rs1234 in a sample named NA12345. A call belongs to a call set, which contains related calls typically from one sample.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]391 "info": { # A string which maps to an array of values.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]392 "a_key": [ # A string which maps to an array of values.
393 "A String",
394 ],
395 },
396 "variantSetId": "A String", # The ID of the variant set this variant belongs to.
397 "end": "A String", # The end position (0-based) of this variant. This corresponds to the first base after the last base in the reference allele. So, the length of the reference allele is (end - start). This is useful for variants that don't explicitly give alternate bases, for example large deletions.
398 "calls": [ # The variant calls for this particular variant. Each one represents the determination of genotype with respect to this variant.
399 { # A call represents the determination of genotype with respect to a particular variant. It may include associated information such as quality and phasing. For example, a call might assign a probability of 0.32 to the occurrence of a SNP named rs1234 in a call set with the name NA12345.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]400 "info": { # A string which maps to an array of values.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]401 "a_key": [ # A string which maps to an array of values.
402 "A String",
403 ],
404 },
405 "genotype": [ # The genotype of this variant call. Each value represents either the value of the referenceBases field or a 1-based index into alternateBases. If a variant had a referenceBases value of T and an alternateBases value of ["A", "C"], and the genotype was [2, 1], that would mean the call represented the heterozygous value CA for this variant. If the genotype was instead [0, 1], the represented value would be TA. Ordering of the genotype values is important if the phaseset is present. If a genotype is not called (that is, a . is present in the GT string) -1 is returned.
406 42,
407 ],
408 "callSetId": "A String", # The ID of the call set this variant call belongs to.
409 "phaseset": "A String", # If this field is present, this variant call's genotype ordering implies the phase of the bases and is consistent with any other variant calls in the same reference sequence which have the same phaseset value. When importing data from VCF, if the genotype data was phased but no phase set was specified this field will be set to *.
410 "genotypeLikelihood": [ # The genotype likelihoods for this variant call. Each array entry represents how likely a specific genotype is for this call. The value ordering is defined by the GL tag in the VCF spec. If Phred-scaled genotype likelihood scores (PL) are available and log10(P) genotype likelihood scores (GL) are not, PL scores are converted to GL scores. If both are available, PL scores are stored in info.
411 3.14,
412 ],
413 "callSetName": "A String", # The name of the call set this variant call belongs to.
414 },
415 ],
416 "created": "A String", # The date this variant was created, in milliseconds from the epoch.
417 "referenceBases": "A String", # The reference bases for this variant. They start at the given position.
418 "filter": [ # A list of filters (normally quality filters) this variant has failed. PASS indicates this variant has passed all filters.
419 "A String",
420 ],
421 "start": "A String", # The position at which this variant occurs (0-based). This corresponds to the first base of the string of reference bases.
422 "names": [ # Names for the variant, for example a RefSNP ID.
423 "A String",
424 ],
425 "alternateBases": [ # The bases that appear instead of the reference bases.
426 "A String",
427 ],
428 "referenceName": "A String", # The reference on which this variant occurs. (such as chr20 or X)
429 "quality": 3.14, # A measure of how likely this variant is to be real. A higher value is better.
430 "id": "A String", # The Google generated ID of the variant, immutable.
431 }</pre>
432</div>
433
434</body></html>