1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
|
<html><body>
<style>
body, h1, h2, h3, div, span, p, pre, a {
margin: 0;
padding: 0;
border: 0;
font-weight: inherit;
font-style: inherit;
font-size: 100%;
font-family: inherit;
vertical-align: baseline;
}
body {
font-size: 13px;
padding: 1em;
}
h1 {
font-size: 26px;
margin-bottom: 1em;
}
h2 {
font-size: 24px;
margin-bottom: 1em;
}
h3 {
font-size: 20px;
margin-bottom: 1em;
margin-top: 1em;
}
pre, code {
line-height: 1.5;
font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
}
pre {
margin-top: 0.5em;
}
h1, h2, h3, p {
font-family: Arial, sans serif;
}
h1, h2, h3 {
border-bottom: solid #CCC 1px;
}
.toc_element {
margin-top: 0.5em;
}
.firstline {
margin-left: 2 em;
}
.method {
margin-top: 1em;
border: solid 1px #CCC;
padding: 1em;
background: #EEE;
}
.details {
font-weight: bold;
font-size: 14px;
}
</style>
<h1><a href="genomics_v1beta.html">Genomics API</a> . <a href="genomics_v1beta.variantsets.html">variantsets</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
<code><a href="#delete">delete(variantSetId)</a></code></p>
<p class="firstline">Deletes the contents of a variant set. The variant set object is not deleted.</p>
<p class="toc_element">
<code><a href="#get">get(variantSetId)</a></code></p>
<p class="firstline">Gets a variant set by ID.</p>
<p class="toc_element">
<code><a href="#mergeVariants">mergeVariants(variantSetId, body)</a></code></p>
<p class="firstline">Merges the given variants with existing variants. Each variant will be merged with an existing variant that matches its reference sequence, start, end, reference bases, and alternative bases. If no such variant exists, a new one will be created.</p>
<p class="toc_element">
<code><a href="#patch">patch(variantSetId, body)</a></code></p>
<p class="firstline">Updates a variant set's metadata. All other modifications are silently ignored. Returns the modified variant set. This method supports patch semantics.</p>
<p class="toc_element">
<code><a href="#search">search(body)</a></code></p>
<p class="firstline">Returns a list of all variant sets matching search criteria.</p>
<p class="toc_element">
<code><a href="#update">update(variantSetId, body)</a></code></p>
<p class="firstline">Updates a variant set's metadata. All other modifications are silently ignored. Returns the modified variant set.</p>
<h3>Method Details</h3>
<div class="method">
<code class="details" id="delete">delete(variantSetId)</code>
<pre>Deletes the contents of a variant set. The variant set object is not deleted.
Args:
variantSetId: string, The ID of the variant set to be deleted. (required)
</pre>
</div>
<div class="method">
<code class="details" id="get">get(variantSetId)</code>
<pre>Gets a variant set by ID.
Args:
variantSetId: string, Required. The ID of the variant set. (required)
Returns:
An object of the form:
{ # A VariantSet represents a collection of Variants and their summary statistics.
"referenceBounds": [ # A list of all references used by the variants in a variant set with associated coordinate upper bounds for each one.
{ # ReferenceBound records an upper bound for the starting coordinate of variants in a particular reference.
"upperBound": "A String", # An upper bound (inclusive) on the starting coordinate of any variant in the reference sequence.
"referenceName": "A String", # The reference the bound is associate with.
},
],
"id": "A String", # The Google-generated ID of the variant set. Immutable.
"datasetId": "A String", # The dataset to which this variant set belongs. Immutable.
"metadata": [ # The metadata associated with this variant set.
{ # Metadata describes a single piece of variant call metadata. These data include a top level key and either a single value string (value) or a list of key-value pairs (info.) Value and info are mutually exclusive.
"info": { # Remaining structured metadata key-value pairs.
"a_key": [ # A string which maps to an array of values.
"A String",
],
},
"description": "A String", # A textual description of this metadata.
"number": "A String", # The number of values that can be included in a field described by this metadata.
"value": "A String", # The value field for simple metadata
"key": "A String", # The top-level key.
"type": "A String", # The type of data. Possible types include: Integer, Float, Flag, Character, and String.
"id": "A String", # User-provided ID field, not enforced by this API. Two or more pieces of structured metadata with identical id and key fields are considered equivalent.
},
],
}</pre>
</div>
<div class="method">
<code class="details" id="mergeVariants">mergeVariants(variantSetId, body)</code>
<pre>Merges the given variants with existing variants. Each variant will be merged with an existing variant that matches its reference sequence, start, end, reference bases, and alternative bases. If no such variant exists, a new one will be created.
When variants are merged, the call information from the new variant is added to the existing variant, and other fields (such as key/value pairs) are discarded.
Args:
variantSetId: string, The destination variant set. (required)
body: object, The request body. (required)
The object takes the form of:
{
"variants": [ # The variants to be merged with existing variants.
{ # A Variant represents a change in DNA sequence relative to some reference. For example, a Variant could represent a SNP or an insertion. Variants belong to a variant set.
"info": { # A map of additional variant information.
"a_key": [ # A string which maps to an array of values.
"A String",
],
},
"variantSetId": "A String", # The ID of the variant set this variant belongs to.
"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.
"calls": [ # The variant calls for this particular variant. Each one represents the determination of genotype with respect to this variant.
{ # 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.
"info": { # A map of additional variant call information.
"a_key": [ # A string which maps to an array of values.
"A String",
],
},
"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.
42,
],
"callSetId": "A String", # The ID of the call set this variant call belongs to.
"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 *.
"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.
3.14,
],
"callSetName": "A String", # The name of the call set this variant call belongs to.
},
],
"created": "A String", # The date this variant was created, in milliseconds from the epoch.
"referenceBases": "A String", # The reference bases for this variant. They start at the given position.
"filter": [ # A list of filters (normally quality filters) this variant has failed. PASS indicates this variant has passed all filters.
"A String",
],
"start": "A String", # The position at which this variant occurs (0-based). This corresponds to the first base of the string of reference bases.
"names": [ # Names for the variant, for example a RefSNP ID.
"A String",
],
"alternateBases": [ # The bases that appear instead of the reference bases.
"A String",
],
"referenceName": "A String", # The reference on which this variant occurs. (such as chr20 or X)
"quality": 3.14, # A measure of how likely this variant is to be real. A higher value is better.
"id": "A String", # The Google generated ID of the variant, immutable.
},
],
}
</pre>
</div>
<div class="method">
<code class="details" id="patch">patch(variantSetId, body)</code>
<pre>Updates a variant set's metadata. All other modifications are silently ignored. Returns the modified variant set. This method supports patch semantics.
Args:
variantSetId: string, The ID of the variant to be updated. (required)
body: object, The request body. (required)
The object takes the form of:
{ # A VariantSet represents a collection of Variants and their summary statistics.
"referenceBounds": [ # A list of all references used by the variants in a variant set with associated coordinate upper bounds for each one.
{ # ReferenceBound records an upper bound for the starting coordinate of variants in a particular reference.
"upperBound": "A String", # An upper bound (inclusive) on the starting coordinate of any variant in the reference sequence.
"referenceName": "A String", # The reference the bound is associate with.
},
],
"id": "A String", # The Google-generated ID of the variant set. Immutable.
"datasetId": "A String", # The dataset to which this variant set belongs. Immutable.
"metadata": [ # The metadata associated with this variant set.
{ # Metadata describes a single piece of variant call metadata. These data include a top level key and either a single value string (value) or a list of key-value pairs (info.) Value and info are mutually exclusive.
"info": { # Remaining structured metadata key-value pairs.
"a_key": [ # A string which maps to an array of values.
"A String",
],
},
"description": "A String", # A textual description of this metadata.
"number": "A String", # The number of values that can be included in a field described by this metadata.
"value": "A String", # The value field for simple metadata
"key": "A String", # The top-level key.
"type": "A String", # The type of data. Possible types include: Integer, Float, Flag, Character, and String.
"id": "A String", # User-provided ID field, not enforced by this API. Two or more pieces of structured metadata with identical id and key fields are considered equivalent.
},
],
}
Returns:
An object of the form:
{ # A VariantSet represents a collection of Variants and their summary statistics.
"referenceBounds": [ # A list of all references used by the variants in a variant set with associated coordinate upper bounds for each one.
{ # ReferenceBound records an upper bound for the starting coordinate of variants in a particular reference.
"upperBound": "A String", # An upper bound (inclusive) on the starting coordinate of any variant in the reference sequence.
"referenceName": "A String", # The reference the bound is associate with.
},
],
"id": "A String", # The Google-generated ID of the variant set. Immutable.
"datasetId": "A String", # The dataset to which this variant set belongs. Immutable.
"metadata": [ # The metadata associated with this variant set.
{ # Metadata describes a single piece of variant call metadata. These data include a top level key and either a single value string (value) or a list of key-value pairs (info.) Value and info are mutually exclusive.
"info": { # Remaining structured metadata key-value pairs.
"a_key": [ # A string which maps to an array of values.
"A String",
],
},
"description": "A String", # A textual description of this metadata.
"number": "A String", # The number of values that can be included in a field described by this metadata.
"value": "A String", # The value field for simple metadata
"key": "A String", # The top-level key.
"type": "A String", # The type of data. Possible types include: Integer, Float, Flag, Character, and String.
"id": "A String", # User-provided ID field, not enforced by this API. Two or more pieces of structured metadata with identical id and key fields are considered equivalent.
},
],
}</pre>
</div>
<div class="method">
<code class="details" id="search">search(body)</code>
<pre>Returns a list of all variant sets matching search criteria.
Args:
body: object, The request body. (required)
The object takes the form of:
{ # The search variant sets request.
"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.
"datasetIds": [ # Exactly one dataset ID must be provided here. Only variant sets which belong to this dataset will be returned.
"A String",
],
"pageSize": 42, # The maximum number of variant sets to return in a request.
}
Returns:
An object of the form:
{ # The search variant sets response.
"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.
"variantSets": [ # The variant sets belonging to the requested dataset.
{ # A VariantSet represents a collection of Variants and their summary statistics.
"referenceBounds": [ # A list of all references used by the variants in a variant set with associated coordinate upper bounds for each one.
{ # ReferenceBound records an upper bound for the starting coordinate of variants in a particular reference.
"upperBound": "A String", # An upper bound (inclusive) on the starting coordinate of any variant in the reference sequence.
"referenceName": "A String", # The reference the bound is associate with.
},
],
"id": "A String", # The Google-generated ID of the variant set. Immutable.
"datasetId": "A String", # The dataset to which this variant set belongs. Immutable.
"metadata": [ # The metadata associated with this variant set.
{ # Metadata describes a single piece of variant call metadata. These data include a top level key and either a single value string (value) or a list of key-value pairs (info.) Value and info are mutually exclusive.
"info": { # Remaining structured metadata key-value pairs.
"a_key": [ # A string which maps to an array of values.
"A String",
],
},
"description": "A String", # A textual description of this metadata.
"number": "A String", # The number of values that can be included in a field described by this metadata.
"value": "A String", # The value field for simple metadata
"key": "A String", # The top-level key.
"type": "A String", # The type of data. Possible types include: Integer, Float, Flag, Character, and String.
"id": "A String", # User-provided ID field, not enforced by this API. Two or more pieces of structured metadata with identical id and key fields are considered equivalent.
},
],
},
],
}</pre>
</div>
<div class="method">
<code class="details" id="update">update(variantSetId, body)</code>
<pre>Updates a variant set's metadata. All other modifications are silently ignored. Returns the modified variant set.
Args:
variantSetId: string, The ID of the variant to be updated. (required)
body: object, The request body. (required)
The object takes the form of:
{ # A VariantSet represents a collection of Variants and their summary statistics.
"referenceBounds": [ # A list of all references used by the variants in a variant set with associated coordinate upper bounds for each one.
{ # ReferenceBound records an upper bound for the starting coordinate of variants in a particular reference.
"upperBound": "A String", # An upper bound (inclusive) on the starting coordinate of any variant in the reference sequence.
"referenceName": "A String", # The reference the bound is associate with.
},
],
"id": "A String", # The Google-generated ID of the variant set. Immutable.
"datasetId": "A String", # The dataset to which this variant set belongs. Immutable.
"metadata": [ # The metadata associated with this variant set.
{ # Metadata describes a single piece of variant call metadata. These data include a top level key and either a single value string (value) or a list of key-value pairs (info.) Value and info are mutually exclusive.
"info": { # Remaining structured metadata key-value pairs.
"a_key": [ # A string which maps to an array of values.
"A String",
],
},
"description": "A String", # A textual description of this metadata.
"number": "A String", # The number of values that can be included in a field described by this metadata.
"value": "A String", # The value field for simple metadata
"key": "A String", # The top-level key.
"type": "A String", # The type of data. Possible types include: Integer, Float, Flag, Character, and String.
"id": "A String", # User-provided ID field, not enforced by this API. Two or more pieces of structured metadata with identical id and key fields are considered equivalent.
},
],
}
Returns:
An object of the form:
{ # A VariantSet represents a collection of Variants and their summary statistics.
"referenceBounds": [ # A list of all references used by the variants in a variant set with associated coordinate upper bounds for each one.
{ # ReferenceBound records an upper bound for the starting coordinate of variants in a particular reference.
"upperBound": "A String", # An upper bound (inclusive) on the starting coordinate of any variant in the reference sequence.
"referenceName": "A String", # The reference the bound is associate with.
},
],
"id": "A String", # The Google-generated ID of the variant set. Immutable.
"datasetId": "A String", # The dataset to which this variant set belongs. Immutable.
"metadata": [ # The metadata associated with this variant set.
{ # Metadata describes a single piece of variant call metadata. These data include a top level key and either a single value string (value) or a list of key-value pairs (info.) Value and info are mutually exclusive.
"info": { # Remaining structured metadata key-value pairs.
"a_key": [ # A string which maps to an array of values.
"A String",
],
},
"description": "A String", # A textual description of this metadata.
"number": "A String", # The number of values that can be included in a field described by this metadata.
"value": "A String", # The value field for simple metadata
"key": "A String", # The top-level key.
"type": "A String", # The type of data. Possible types include: Integer, Float, Flag, Character, and String.
"id": "A String", # User-provided ID field, not enforced by this API. Two or more pieces of structured metadata with identical id and key fields are considered equivalent.
},
],
}</pre>
</div>
</body></html>
|
