pyxetabase 3.1.0.dev25__py3-none-any.whl → 4.0.0.dev29__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (37) hide show
  1. pyxetabase/rest_clients/_parent_rest_clients.py +47 -13
  2. pyxetabase/rest_clients/file_client.py +1 -1
  3. pyxetabase/rest_clients/variant_operation_client.py +1 -29
  4. {pyxetabase-3.1.0.dev25.dist-info → pyxetabase-4.0.0.dev29.dist-info}/METADATA +1 -1
  5. pyxetabase-4.0.0.dev29.dist-info/RECORD +35 -0
  6. pyopencga/__init__.py +0 -0
  7. pyopencga/commons.py +0 -347
  8. pyopencga/exceptions.py +0 -8
  9. pyopencga/opencga_client.py +0 -334
  10. pyopencga/opencga_config.py +0 -211
  11. pyopencga/rest_clients/__init__.py +0 -0
  12. pyopencga/rest_clients/_parent_rest_clients.py +0 -110
  13. pyopencga/rest_clients/admin_client.py +0 -172
  14. pyopencga/rest_clients/alignment_client.py +0 -373
  15. pyopencga/rest_clients/clinical_analysis_client.py +0 -1279
  16. pyopencga/rest_clients/cohort_client.py +0 -338
  17. pyopencga/rest_clients/disease_panel_client.py +0 -352
  18. pyopencga/rest_clients/family_client.py +0 -355
  19. pyopencga/rest_clients/file_client.py +0 -698
  20. pyopencga/rest_clients/ga4gh_client.py +0 -86
  21. pyopencga/rest_clients/individual_client.py +0 -435
  22. pyopencga/rest_clients/job_client.py +0 -415
  23. pyopencga/rest_clients/meta_client.py +0 -85
  24. pyopencga/rest_clients/organization_client.py +0 -216
  25. pyopencga/rest_clients/project_client.py +0 -128
  26. pyopencga/rest_clients/sample_client.py +0 -446
  27. pyopencga/rest_clients/study_client.py +0 -461
  28. pyopencga/rest_clients/user_client.py +0 -192
  29. pyopencga/rest_clients/variant_client.py +0 -1378
  30. pyopencga/rest_clients/variant_operation_client.py +0 -746
  31. pyopencga/rest_clients/workflow_client.py +0 -263
  32. pyopencga/rest_response.py +0 -220
  33. pyopencga/retry.py +0 -57
  34. pyxetabase-3.1.0.dev25.dist-info/RECORD +0 -63
  35. {pyxetabase-3.1.0.dev25.dist-info → pyxetabase-4.0.0.dev29.dist-info}/WHEEL +0 -0
  36. {pyxetabase-3.1.0.dev25.dist-info → pyxetabase-4.0.0.dev29.dist-info}/licenses/LICENSE +0 -0
  37. {pyxetabase-3.1.0.dev25.dist-info → pyxetabase-4.0.0.dev29.dist-info}/top_level.txt +0 -0
@@ -1,1378 +0,0 @@
1
- """
2
- WARNING: AUTOGENERATED CODE
3
-
4
- This code was generated by a tool.
5
-
6
- Manual changes to this file may cause unexpected behavior in your application.
7
- Manual changes to this file will be overwritten if the code is regenerated.
8
- """
9
-
10
- from pyopencga.rest_clients._parent_rest_clients import _ParentRestClient
11
-
12
-
13
- class Variant(_ParentRestClient):
14
- """
15
- This class contains methods for the 'Analysis - Variant' webservices
16
- PATH: /{apiVersion}/analysis/variant
17
- """
18
-
19
- def __init__(self, configuration, token=None, login_handler=None, *args, **kwargs):
20
- super(Variant, self).__init__(configuration, token, login_handler, *args, **kwargs)
21
-
22
- def aggregation_stats(self, **options):
23
- """
24
- Calculate and fetch aggregation stats.
25
- PATH: /{apiVersion}/analysis/variant/aggregationStats
26
-
27
- :param str saved_filter: Use a saved filter at User level.
28
- :param str region: List of regions, these can be just a single
29
- chromosome name or regions in the format chr:start-end, e.g.:
30
- 2,3:100000-200000.
31
- :param str type: List of types, accepted values are SNV, MNV, INDEL,
32
- SV, COPY_NUMBER, COPY_NUMBER_LOSS, COPY_NUMBER_GAIN, INSERTION,
33
- DELETION, DUPLICATION, TANDEM_DUPLICATION, BREAKEND, e.g.
34
- SNV,INDEL.
35
- :param str project: Project [organization@]project where project can
36
- be either the ID or the alias.
37
- :param str study: Filter variants from the given studies, these can be
38
- either the numeric ID or the alias with the format
39
- organization@project:study.
40
- :param str cohort: Select variants with calculated stats for the
41
- selected cohorts.
42
- :param str cohort_stats_ref: Reference Allele Frequency:
43
- [{study:}]{cohort}[<|>|<=|>=]{number}. e.g. ALL<=0.4.
44
- :param str cohort_stats_alt: Alternate Allele Frequency:
45
- [{study:}]{cohort}[<|>|<=|>=]{number}. e.g. ALL<=0.4.
46
- :param str cohort_stats_maf: Minor Allele Frequency:
47
- [{study:}]{cohort}[<|>|<=|>=]{number}. e.g. ALL<=0.4.
48
- :param str cohort_stats_mgf: Minor Genotype Frequency:
49
- [{study:}]{cohort}[<|>|<=|>=]{number}. e.g. ALL<=0.4.
50
- :param str cohort_stats_pass: Filter PASS frequency:
51
- [{study:}]{cohort}[<|>|<=|>=]{number}. e.g. ALL>0.8.
52
- :param str missing_alleles: Number of missing alleles:
53
- [{study:}]{cohort}[<|>|<=|>=]{number}.
54
- :param str missing_genotypes: Number of missing genotypes:
55
- [{study:}]{cohort}[<|>|<=|>=]{number}.
56
- :param str score: Filter by variant score:
57
- [{study:}]{score}[<|>|<=|>=]{number}.
58
- :param bool annotation_exists: Return only annotated variants.
59
- :param str gene: List of genes, most gene IDs are accepted (HGNC,
60
- Ensembl gene, ...). This is an alias to 'xref' parameter.
61
- :param str ct: List of SO consequence types, e.g.
62
- missense_variant,stop_lost or SO:0001583,SO:0001578. Accepts
63
- aliases 'loss_of_function' and 'protein_altering'.
64
- :param str xref: List of any external reference, these can be genes,
65
- proteins or variants. Accepted IDs include HGNC, Ensembl genes,
66
- dbSNP, ClinVar, HPO, Cosmic, HGVS ...
67
- :param str biotype: List of biotypes, e.g. protein_coding.
68
- :param str protein_substitution: Protein substitution scores include
69
- SIFT and PolyPhen. You can query using the score
70
- {protein_score}[<|>|<=|>=]{number} or the description
71
- {protein_score}[~=|=]{description} e.g. polyphen>0.1,sift=tolerant.
72
- :param str conservation: Filter by conservation score:
73
- {conservation_score}[<|>|<=|>=]{number} e.g.
74
- phastCons>0.5,phylop<0.1,gerp>0.1.
75
- :param str population_frequency_alt: Alternate Population Frequency:
76
- {study}:{population}[<|>|<=|>=]{number}. e.g. 1000G:ALL<0.01.
77
- :param str population_frequency_ref: Reference Population Frequency:
78
- {study}:{population}[<|>|<=|>=]{number}. e.g. 1000G:ALL<0.01.
79
- :param str population_frequency_maf: Population minor allele
80
- frequency: {study}:{population}[<|>|<=|>=]{number}. e.g.
81
- 1000G:ALL<0.01.
82
- :param str transcript_flag: List of transcript flags. e.g. canonical,
83
- CCDS, basic, LRG, MANE Select, MANE Plus Clinical, EGLH_HaemOnc,
84
- TSO500.
85
- :param str gene_trait_id: List of gene trait association id. e.g.
86
- 'umls:C0007222' , 'OMIM:269600'.
87
- :param str go: List of GO (Gene Ontology) terms. e.g. 'GO:0002020'.
88
- :param str expression: List of tissues of interest. e.g. 'lung'.
89
- :param str protein_keyword: List of Uniprot protein variant annotation
90
- keywords.
91
- :param str drug: List of drug names.
92
- :param str functional_score: Functional score:
93
- {functional_score}[<|>|<=|>=]{number} e.g. cadd_scaled>5.2 ,
94
- cadd_raw<=0.3.
95
- :param str clinical: Clinical source: clinvar, cosmic.
96
- :param str clinical_significance: Clinical significance: benign,
97
- likely_benign, likely_pathogenic, pathogenic.
98
- :param bool clinical_confirmed_status: Clinical confirmed status.
99
- :param str custom_annotation: Custom annotation:
100
- {key}[<|>|<=|>=]{number} or {key}[~=|=]{text}.
101
- :param str trait: List of traits, based on ClinVar, HPO, COSMIC, i.e.:
102
- IDs, histologies, descriptions,...
103
- :param str field: List of facet fields separated by semicolons, e.g.:
104
- studies;type. For nested faceted fields use >>, e.g.:
105
- chromosome>>type;percentile(gerp).
106
- """
107
-
108
- return self._get(category='analysis', resource='aggregationStats', subcategory='variant', **options)
109
-
110
- def metadata_annotation(self, **options):
111
- """
112
- Read variant annotations metadata from any saved versions.
113
- PATH: /{apiVersion}/analysis/variant/annotation/metadata
114
-
115
- :param str annotation_id: Annotation identifier.
116
- :param str project: Project [organization@]project where project can
117
- be either the ID or the alias.
118
- """
119
-
120
- return self._get(category='analysis', resource='metadata', subcategory='variant/annotation', **options)
121
-
122
- def query_annotation(self, **options):
123
- """
124
- Query variant annotations from any saved versions.
125
- PATH: /{apiVersion}/analysis/variant/annotation/query
126
-
127
- :param str id: List of variant IDs in the format chrom:start:ref:alt,
128
- e.g. 19:7177679:C:T.
129
- :param str region: List of regions, these can be just a single
130
- chromosome name or regions in the format chr:start-end, e.g.:
131
- 2,3:100000-200000.
132
- :param str include: Fields included in the response, whole JSON path
133
- must be provided.
134
- :param str exclude: Fields excluded in the response, whole JSON path
135
- must be provided.
136
- :param int limit: Number of results to be returned.
137
- :param int skip: Number of results to skip.
138
- :param str annotation_id: Annotation identifier.
139
- """
140
-
141
- return self._get(category='analysis', resource='query', subcategory='variant/annotation', **options)
142
-
143
- def run_circos(self, data=None, **options):
144
- """
145
- Generate a Circos plot for a given sample.
146
- PATH: /{apiVersion}/analysis/variant/circos/run
147
-
148
- :param dict data: Circos analysis params to customize the plot. These
149
- parameters include the title, the plot density (i.e., the number
150
- of points to display), the general query and the list of tracks.
151
- Currently, the supported track types are: COPY-NUMBER, INDEL,
152
- REARRANGEMENT and SNV. In addition, each track can contain a
153
- specific query. (REQUIRED)
154
- :param str study: study.
155
- """
156
-
157
- return self._post(category='analysis', resource='run', subcategory='variant/circos', data=data, **options)
158
-
159
- def delete_cohort_stats(self, **options):
160
- """
161
- Delete cohort variant stats from a cohort.
162
- PATH: /{apiVersion}/analysis/variant/cohort/stats/delete
163
-
164
- :param str study: study.
165
- :param str cohort: Cohort ID or UUID.
166
- """
167
-
168
- return self._delete(category='analysis', resource='delete', subcategory='variant/cohort/stats', **options)
169
-
170
- def info_cohort_stats(self, cohort, **options):
171
- """
172
- Read cohort variant stats from list of cohorts.
173
- PATH: /{apiVersion}/analysis/variant/cohort/stats/info
174
-
175
- :param str cohort: Comma separated list of cohort IDs or UUIDs up to a
176
- maximum of 100. (REQUIRED)
177
- :param str study: study.
178
- """
179
-
180
- options['cohort'] = cohort
181
- return self._get(category='analysis', resource='info', subcategory='variant/cohort/stats', **options)
182
-
183
- def run_cohort_stats(self, data=None, **options):
184
- """
185
- Compute cohort variant stats for the selected list of samples.
186
- PATH: /{apiVersion}/analysis/variant/cohort/stats/run
187
-
188
- :param dict data: Cohort variant stats params. (REQUIRED)
189
- :param str study: Study [[organization@]project:]study where study and
190
- project can be either the ID or UUID.
191
- :param str job_id: Job ID. It must be a unique string within the
192
- study. An ID will be autogenerated automatically if not provided.
193
- :param str job_description: Job description.
194
- :param str job_depends_on: Comma separated list of existing job IDs
195
- the job will depend on.
196
- :param str job_tags: Job tags.
197
- :param str job_scheduled_start_time: Time when the job is scheduled to
198
- start.
199
- :param str job_priority: Priority of the job.
200
- :param bool job_dry_run: Flag indicating that the job will be executed
201
- in dry-run mode. In this mode, OpenCGA will validate that all
202
- parameters and prerequisites are correctly set for successful
203
- execution, but the job will not actually run.
204
- """
205
-
206
- return self._post(category='analysis', resource='run', subcategory='variant/cohort/stats', data=data, **options)
207
-
208
- def run_exomiser(self, data=None, **options):
209
- """
210
- The Exomiser is a Java program that finds potential disease-causing
211
- variants from whole-exome or whole-genome sequencing data.
212
- PATH: /{apiVersion}/analysis/variant/exomiser/run
213
-
214
- :param dict data: Exomiser parameters. (REQUIRED)
215
- :param str study: study.
216
- :param str job_id: Job ID. It must be a unique string within the
217
- study. An ID will be autogenerated automatically if not provided.
218
- :param str job_depends_on: Comma separated list of existing job IDs
219
- the job will depend on.
220
- :param str job_description: Job description.
221
- :param str job_tags: Job tags.
222
- :param str job_scheduled_start_time: Time when the job is scheduled to
223
- start.
224
- :param str job_priority: Priority of the job.
225
- :param bool job_dry_run: Flag indicating that the job will be executed
226
- in dry-run mode. In this mode, OpenCGA will validate that all
227
- parameters and prerequisites are correctly set for successful
228
- execution, but the job will not actually run.
229
- """
230
-
231
- return self._post(category='analysis', resource='run', subcategory='variant/exomiser', data=data, **options)
232
-
233
- def run_export(self, data=None, **options):
234
- """
235
- Filter and export variants from the variant storage to a file.
236
- PATH: /{apiVersion}/analysis/variant/export/run
237
-
238
- :param dict data: Variant export params. (REQUIRED)
239
- :param str include: Fields included in the response, whole JSON path
240
- must be provided.
241
- :param str exclude: Fields excluded in the response, whole JSON path
242
- must be provided.
243
- :param str project: Project [organization@]project where project can
244
- be either the ID or the alias.
245
- :param str study: Study [[organization@]project:]study where study and
246
- project can be either the ID or UUID.
247
- :param str job_id: Job ID. It must be a unique string within the
248
- study. An ID will be autogenerated automatically if not provided.
249
- :param str job_description: Job description.
250
- :param str job_depends_on: Comma separated list of existing job IDs
251
- the job will depend on.
252
- :param str job_tags: Job tags.
253
- :param str job_scheduled_start_time: Time when the job is scheduled to
254
- start.
255
- :param str job_priority: Priority of the job.
256
- :param bool job_dry_run: Flag indicating that the job will be executed
257
- in dry-run mode. In this mode, OpenCGA will validate that all
258
- parameters and prerequisites are correctly set for successful
259
- execution, but the job will not actually run.
260
- """
261
-
262
- return self._post(category='analysis', resource='run', subcategory='variant/export', data=data, **options)
263
-
264
- def genotypes_family(self, mode_of_inheritance, **options):
265
- """
266
- Calculate the possible genotypes for the members of a family.
267
- PATH: /{apiVersion}/analysis/variant/family/genotypes
268
-
269
- :param str mode_of_inheritance: Mode of inheritance. Allowed values:
270
- ['AUTOSOMAL_DOMINANT AUTOSOMAL_RECESSIVE X_LINKED_DOMINANT
271
- X_LINKED_RECESSIVE Y_LINKED MITOCHONDRIAL DE_NOVO MENDELIAN_ERROR
272
- COMPOUND_HETEROZYGOUS UNKNOWN'] (REQUIRED)
273
- :param str study: Study [[organization@]project:]study where study and
274
- project can be either the ID or UUID.
275
- :param str family: Family id.
276
- :param str clinical_analysis: Clinical analysis id.
277
- :param str penetrance: Penetrance. Allowed values: ['COMPLETE
278
- INCOMPLETE UNKNOWN']
279
- :param str disorder: Disorder id.
280
- """
281
-
282
- options['modeOfInheritance'] = mode_of_inheritance
283
- return self._get(category='analysis', resource='genotypes', subcategory='variant/family', **options)
284
-
285
- def run_family_qc(self, data=None, **options):
286
- """
287
- Run quality control (QC) for a given family. It computes the
288
- relatedness scores among the family members.
289
- PATH: /{apiVersion}/analysis/variant/family/qc/run
290
-
291
- :param dict data: Family QC analysis params. Family ID. Relatedness
292
- method, by default 'PLINK/IBD'. Minor allele frequence (MAF) is
293
- used to filter variants before computing relatedness, e.g.:
294
- 1000G:CEU>0.35 or cohort:ALL>0.05. (REQUIRED)
295
- :param str study: Study [[organization@]project:]study where study and
296
- project can be either the ID or UUID.
297
- :param str job_id: Job ID. It must be a unique string within the
298
- study. An ID will be autogenerated automatically if not provided.
299
- :param str job_description: Job description.
300
- :param str job_depends_on: Comma separated list of existing job IDs
301
- the job will depend on.
302
- :param str job_tags: Job tags.
303
- :param str job_scheduled_start_time: Time when the job is scheduled to
304
- start.
305
- :param str job_priority: Priority of the job.
306
- :param bool job_dry_run: Flag indicating that the job will be executed
307
- in dry-run mode. In this mode, OpenCGA will validate that all
308
- parameters and prerequisites are correctly set for successful
309
- execution, but the job will not actually run.
310
- """
311
-
312
- return self._post(category='analysis', resource='run', subcategory='variant/family/qc', data=data, **options)
313
-
314
- def delete_file(self, **options):
315
- """
316
- [DEPRECATED] Use operation/variant/delete.
317
- PATH: /{apiVersion}/analysis/variant/file/delete
318
-
319
- :param str job_id: Job ID. It must be a unique string within the
320
- study. An ID will be autogenerated automatically if not provided.
321
- :param str job_description: Job description.
322
- :param str job_depends_on: Comma separated list of existing job IDs
323
- the job will depend on.
324
- :param str job_tags: Job tags.
325
- :param str job_scheduled_start_time: Time when the job is scheduled to
326
- start.
327
- :param str job_priority: Priority of the job.
328
- :param bool job_dry_run: Flag indicating that the job will be executed
329
- in dry-run mode. In this mode, OpenCGA will validate that all
330
- parameters and prerequisites are correctly set for successful
331
- execution, but the job will not actually run.
332
- :param str study: Study [[organization@]project:]study where study and
333
- project can be either the ID or UUID.
334
- :param str file: Files to remove.
335
- :param bool resume: Resume a previously failed indexation.
336
- """
337
-
338
- return self._delete(category='analysis', resource='delete', subcategory='variant/file', **options)
339
-
340
- def run_gatk(self, data=None, **options):
341
- """
342
- GATK is a Genome Analysis Toolkit for variant discovery in
343
- high-throughput sequencing data. Supported Gatk commands:
344
- HaplotypeCaller.
345
- PATH: /{apiVersion}/analysis/variant/gatk/run
346
-
347
- :param dict data: Gatk parameters. Supported Gatk commands:
348
- HaplotypeCaller. (REQUIRED)
349
- :param str study: study.
350
- :param str job_id: Job ID. It must be a unique string within the
351
- study. An ID will be autogenerated automatically if not provided.
352
- :param str job_description: Job description.
353
- :param str job_depends_on: Comma separated list of existing job IDs
354
- the job will depend on.
355
- :param str job_tags: Job tags.
356
- :param str job_scheduled_start_time: Time when the job is scheduled to
357
- start.
358
- :param str job_priority: Priority of the job.
359
- :param bool job_dry_run: Flag indicating that the job will be executed
360
- in dry-run mode. In this mode, OpenCGA will validate that all
361
- parameters and prerequisites are correctly set for successful
362
- execution, but the job will not actually run.
363
- """
364
-
365
- return self._post(category='analysis', resource='run', subcategory='variant/gatk', data=data, **options)
366
-
367
- def run_genome_plot(self, data=None, **options):
368
- """
369
- Generate a genome plot for a given sample.
370
- PATH: /{apiVersion}/analysis/variant/genomePlot/run
371
-
372
- :param dict data: Genome plot analysis params to customize the plot.
373
- The configuration file includes the title, the plot density (i.e.,
374
- the number of points to display), the general query and the list of
375
- tracks. Currently, the supported track types are: COPY-NUMBER,
376
- INDEL, REARRANGEMENT and SNV. In addition, each track can contain a
377
- specific query. (REQUIRED)
378
- :param str study: Study [[organization@]project:]study where study and
379
- project can be either the ID or UUID.
380
- :param str job_id: Job ID. It must be a unique string within the
381
- study. An ID will be autogenerated automatically if not provided.
382
- :param str job_description: Job description.
383
- :param str job_depends_on: Comma separated list of existing job IDs
384
- the job will depend on.
385
- :param str job_tags: Job tags.
386
- :param str job_scheduled_start_time: Time when the job is scheduled to
387
- start.
388
- :param str job_priority: Priority of the job.
389
- :param bool job_dry_run: Flag indicating that the job will be executed
390
- in dry-run mode. In this mode, OpenCGA will validate that all
391
- parameters and prerequisites are correctly set for successful
392
- execution, but the job will not actually run.
393
- """
394
-
395
- return self._post(category='analysis', resource='run', subcategory='variant/genomePlot', data=data, **options)
396
-
397
- def run_gwas(self, data=None, **options):
398
- """
399
- Run a Genome Wide Association Study between two cohorts.
400
- PATH: /{apiVersion}/analysis/variant/gwas/run
401
-
402
- :param dict data: Gwas analysis params. (REQUIRED)
403
- :param str study: Study [[organization@]project:]study where study and
404
- project can be either the ID or UUID.
405
- :param str job_id: Job ID. It must be a unique string within the
406
- study. An ID will be autogenerated automatically if not provided.
407
- :param str job_description: Job description.
408
- :param str job_depends_on: Comma separated list of existing job IDs
409
- the job will depend on.
410
- :param str job_tags: Job tags.
411
- :param str job_scheduled_start_time: Time when the job is scheduled to
412
- start.
413
- :param str job_priority: Priority of the job.
414
- :param bool job_dry_run: Flag indicating that the job will be executed
415
- in dry-run mode. In this mode, OpenCGA will validate that all
416
- parameters and prerequisites are correctly set for successful
417
- execution, but the job will not actually run.
418
- """
419
-
420
- return self._post(category='analysis', resource='run', subcategory='variant/gwas', data=data, **options)
421
-
422
- def run_hr_detect(self, data=None, **options):
423
- """
424
- Run HRDetect analysis for a given somatic sample.
425
- PATH: /{apiVersion}/analysis/variant/hrDetect/run
426
-
427
- :param dict data: HRDetect analysis parameters. (REQUIRED)
428
- :param str study: Study [[organization@]project:]study where study and
429
- project can be either the ID or UUID.
430
- :param str job_id: Job ID. It must be a unique string within the
431
- study. An ID will be autogenerated automatically if not provided.
432
- :param str job_description: Job description.
433
- :param str job_depends_on: Comma separated list of existing job IDs
434
- the job will depend on.
435
- :param str job_tags: Job tags.
436
- :param str job_scheduled_start_time: Time when the job is scheduled to
437
- start.
438
- :param str job_priority: Priority of the job.
439
- :param bool job_dry_run: Flag indicating that the job will be executed
440
- in dry-run mode. In this mode, OpenCGA will validate that all
441
- parameters and prerequisites are correctly set for successful
442
- execution, but the job will not actually run.
443
- """
444
-
445
- return self._post(category='analysis', resource='run', subcategory='variant/hrDetect', data=data, **options)
446
-
447
- def run_index(self, data=None, **options):
448
- """
449
- [DEPRECATED] Use operation/variant/index.
450
- PATH: /{apiVersion}/analysis/variant/index/run
451
-
452
- :param dict data: Variant index params. (REQUIRED)
453
- :param str study: Study [[organization@]project:]study where study and
454
- project can be either the ID or UUID.
455
- :param str job_id: Job ID. It must be a unique string within the
456
- study. An ID will be autogenerated automatically if not provided.
457
- :param str job_depends_on: Comma separated list of existing job IDs
458
- the job will depend on.
459
- :param str job_description: Job description.
460
- :param str job_tags: Job tags.
461
- :param str job_scheduled_start_time: Time when the job is scheduled to
462
- start.
463
- :param str job_priority: Priority of the job.
464
- :param bool job_dry_run: Flag indicating that the job will be executed
465
- in dry-run mode. In this mode, OpenCGA will validate that all
466
- parameters and prerequisites are correctly set for successful
467
- execution, but the job will not actually run.
468
- """
469
-
470
- return self._post(category='analysis', resource='run', subcategory='variant/index', data=data, **options)
471
-
472
- def run_individual_qc(self, data=None, **options):
473
- """
474
- Run quality control (QC) for a given individual. It includes inferred
475
- sex and mendelian errors (UDP).
476
- PATH: /{apiVersion}/analysis/variant/individual/qc/run
477
-
478
- :param dict data: Individual QC analysis params. (REQUIRED)
479
- :param str study: Study [[organization@]project:]study where study and
480
- project can be either the ID or UUID.
481
- :param str job_id: Job ID. It must be a unique string within the
482
- study. An ID will be autogenerated automatically if not provided.
483
- :param str job_description: Job description.
484
- :param str job_depends_on: Comma separated list of existing job IDs
485
- the job will depend on.
486
- :param str job_tags: Job tags.
487
- :param str job_scheduled_start_time: Time when the job is scheduled to
488
- start.
489
- :param str job_priority: Priority of the job.
490
- :param bool job_dry_run: Flag indicating that the job will be executed
491
- in dry-run mode. In this mode, OpenCGA will validate that all
492
- parameters and prerequisites are correctly set for successful
493
- execution, but the job will not actually run.
494
- """
495
-
496
- return self._post(category='analysis', resource='run', subcategory='variant/individual/qc', data=data, **options)
497
-
498
- def run_inferred_sex(self, data=None, **options):
499
- """
500
- Infer sex from chromosome mean coverages.
501
- PATH: /{apiVersion}/analysis/variant/inferredSex/run
502
-
503
- :param dict data: Inferred sex analysis params. (REQUIRED)
504
- :param str study: Study [[organization@]project:]study where study and
505
- project can be either the ID or UUID.
506
- :param str job_id: Job ID. It must be a unique string within the
507
- study. An ID will be autogenerated automatically if not provided.
508
- :param str job_description: Job description.
509
- :param str job_depends_on: Comma separated list of existing job IDs
510
- the job will depend on.
511
- :param str job_tags: Job tags.
512
- :param str job_scheduled_start_time: Time when the job is scheduled to
513
- start.
514
- :param str job_priority: Priority of the job.
515
- :param bool job_dry_run: Flag indicating that the job will be executed
516
- in dry-run mode. In this mode, OpenCGA will validate that all
517
- parameters and prerequisites are correctly set for successful
518
- execution, but the job will not actually run.
519
- """
520
-
521
- return self._post(category='analysis', resource='run', subcategory='variant/inferredSex', data=data, **options)
522
-
523
- def query_knockout_gene(self, **options):
524
- """
525
- Fetch values from KnockoutAnalysis result, by genes.
526
- PATH: /{apiVersion}/analysis/variant/knockout/gene/query
527
-
528
- :param int limit: Number of results to be returned.
529
- :param int skip: Number of results to skip.
530
- :param str study: study.
531
- :param str job: Job ID or UUID.
532
- """
533
-
534
- return self._get(category='analysis', resource='query', subcategory='variant/knockout/gene', **options)
535
-
536
- def query_knockout_individual(self, **options):
537
- """
538
- Fetch values from KnockoutAnalysis result, by individuals.
539
- PATH: /{apiVersion}/analysis/variant/knockout/individual/query
540
-
541
- :param int limit: Number of results to be returned.
542
- :param int skip: Number of results to skip.
543
- :param str study: study.
544
- :param str job: Job ID or UUID.
545
- """
546
-
547
- return self._get(category='analysis', resource='query', subcategory='variant/knockout/individual', **options)
548
-
549
- def run_knockout(self, data=None, **options):
550
- """
551
- Obtains the list of knocked out genes for each sample.
552
- PATH: /{apiVersion}/analysis/variant/knockout/run
553
-
554
- :param dict data: Gene knockout analysis params. (REQUIRED)
555
- :param str study: study.
556
- :param str job_id: Job ID. It must be a unique string within the
557
- study. An ID will be autogenerated automatically if not provided.
558
- :param str job_description: Job description.
559
- :param str job_depends_on: Comma separated list of existing job IDs
560
- the job will depend on.
561
- :param str job_tags: Job tags.
562
- :param str job_scheduled_start_time: Time when the job is scheduled to
563
- start.
564
- :param str job_priority: Priority of the job.
565
- :param bool job_dry_run: Flag indicating that the job will be executed
566
- in dry-run mode. In this mode, OpenCGA will validate that all
567
- parameters and prerequisites are correctly set for successful
568
- execution, but the job will not actually run.
569
- """
570
-
571
- return self._post(category='analysis', resource='run', subcategory='variant/knockout', data=data, **options)
572
-
573
- def run_liftover(self, data=None, **options):
574
- """
575
- BCFtools liftover plugin maps coordinates from assembly 37 to 38.
576
- PATH: /{apiVersion}/analysis/variant/liftover/run
577
-
578
- :param dict data: BCFtools +liftover plugin parameters. (REQUIRED)
579
- :param str study: study.
580
- :param str job_id: Job ID. It must be a unique string within the
581
- study. An ID will be autogenerated automatically if not provided.
582
- :param str job_description: Job description.
583
- :param str job_depends_on: Comma separated list of existing job IDs
584
- the job will depend on.
585
- :param str job_tags: Job tags.
586
- :param str job_scheduled_start_time: Time when the job is scheduled to
587
- start.
588
- :param str job_priority: Priority of the job.
589
- :param bool job_dry_run: Flag indicating that the job will be executed
590
- in dry-run mode. In this mode, OpenCGA will validate that all
591
- parameters and prerequisites are correctly set for successful
592
- execution, but the job will not actually run.
593
- """
594
-
595
- return self._post(category='analysis', resource='run', subcategory='variant/liftover', data=data, **options)
596
-
597
- def run_mendelian_error(self, data=None, **options):
598
- """
599
- Run mendelian error analysis to infer uniparental disomy regions.
600
- PATH: /{apiVersion}/analysis/variant/mendelianError/run
601
-
602
- :param dict data: Mendelian error analysis params. (REQUIRED)
603
- :param str study: Study [[organization@]project:]study where study and
604
- project can be either the ID or UUID.
605
- :param str job_id: Job ID. It must be a unique string within the
606
- study. An ID will be autogenerated automatically if not provided.
607
- :param str job_description: Job description.
608
- :param str job_depends_on: Comma separated list of existing job IDs
609
- the job will depend on.
610
- :param str job_tags: Job tags.
611
- :param str job_scheduled_start_time: Time when the job is scheduled to
612
- start.
613
- :param str job_priority: Priority of the job.
614
- :param bool job_dry_run: Flag indicating that the job will be executed
615
- in dry-run mode. In this mode, OpenCGA will validate that all
616
- parameters and prerequisites are correctly set for successful
617
- execution, but the job will not actually run.
618
- """
619
-
620
- return self._post(category='analysis', resource='run', subcategory='variant/mendelianError', data=data, **options)
621
-
622
- def metadata(self, **options):
623
- """
624
- .
625
- PATH: /{apiVersion}/analysis/variant/metadata
626
-
627
- :param str project: Project [organization@]project where project can
628
- be either the ID or the alias.
629
- :param str study: Filter variants from the given studies, these can be
630
- either the numeric ID or the alias with the format
631
- organization@project:study.
632
- :param str file: Filter variants from the files specified. This will
633
- set includeFile parameter when not provided.
634
- :param str sample: Filter variants by sample genotype. This will
635
- automatically set 'includeSample' parameter when not provided. This
636
- filter accepts multiple 3 forms: 1) List of samples: Samples that
637
- contain the main variant. Accepts AND ';' and OR ',' operators.
638
- e.g. HG0097,HG0098 . 2) List of samples with genotypes:
639
- {sample}:{gt1},{gt2}. Accepts AND ';' and OR ',' operators. e.g.
640
- HG0097:0/0;HG0098:0/1,1/1 . Unphased genotypes (e.g. 0/1, 1/1) will
641
- also include phased genotypes (e.g. 0|1, 1|0, 1|1), but not vice
642
- versa. When filtering by multi-allelic genotypes, any secondary
643
- allele will match, regardless of its position e.g. 1/2 will match
644
- with genotypes 1/2, 1/3, 1/4, .... Genotype aliases accepted:
645
- HOM_REF, HOM_ALT, HET, HET_REF, HET_ALT, HET_MISS and MISS e.g.
646
- HG0097:HOM_REF;HG0098:HET_REF,HOM_ALT . 3) Sample with segregation
647
- mode: {sample}:{segregation}. Only one sample accepted.Accepted
648
- segregation modes: [ autosomalDominant, autosomalRecessive,
649
- XLinkedDominant, XLinkedRecessive, YLinked, mitochondrial, deNovo,
650
- deNovoStrict, mendelianError, compoundHeterozygous ]. Value is case
651
- insensitive. e.g. HG0097:DeNovo Sample must have parents defined
652
- and indexed. .
653
- :param str include_study: List of studies to include in the result.
654
- Accepts 'all' and 'none'.
655
- :param str include_file: List of files to be returned. Accepts 'all'
656
- and 'none'. If undefined, automatically includes files used for
657
- filtering. If none, no file is included.
658
- :param str include_sample: List of samples to be included in the
659
- result. Accepts 'all' and 'none'. If undefined, automatically
660
- includes samples used for filtering. If none, no sample is
661
- included.
662
- :param str include: Fields included in the response, whole JSON path
663
- must be provided.
664
- :param str exclude: Fields excluded in the response, whole JSON path
665
- must be provided.
666
- """
667
-
668
- return self._get(category='analysis', resource='metadata', subcategory='variant', **options)
669
-
670
- def query_mutational_signature(self, **options):
671
- """
672
- Run mutational signature analysis for a given sample. Use context
673
- index.
674
- PATH: /{apiVersion}/analysis/variant/mutationalSignature/query
675
-
676
- :param str study: Filter variants from the given studies, these can be
677
- either the numeric ID or the alias with the format
678
- organization@project:study.
679
- :param str sample: Sample name.
680
- :param str type: Variant type. Valid values: SNV, SV.
681
- :param str ct: List of SO consequence types, e.g.
682
- missense_variant,stop_lost or SO:0001583,SO:0001578. Accepts
683
- aliases 'loss_of_function' and 'protein_altering'.
684
- :param str biotype: List of biotypes, e.g. protein_coding.
685
- :param str file_data: Filter by file data (i.e. FILTER, QUAL and INFO
686
- columns from VCF file). [{file}:]{key}{op}{value}[,;]* . If no file
687
- is specified, will use all files from 'file' filter. e.g. AN>200 or
688
- file_1.vcf:AN>200;file_2.vcf:AN<10 . Many fields can be combined.
689
- e.g. file_1.vcf:AN>200;DB=true;file_2.vcf:AN<10,FILTER=PASS,LowDP.
690
- :param str filter: Specify the FILTER for any of the files. If 'file'
691
- filter is provided, will match the file and the filter. e.g.:
692
- PASS,LowGQX.
693
- :param str qual: Specify the QUAL for any of the files. If 'file'
694
- filter is provided, will match the file and the qual. e.g.: >123.4.
695
- :param str region: List of regions, these can be just a single
696
- chromosome name or regions in the format chr:start-end, e.g.:
697
- 2,3:100000-200000.
698
- :param str gene: List of genes, most gene IDs are accepted (HGNC,
699
- Ensembl gene, ...). This is an alias to 'xref' parameter.
700
- :param str panel: Filter by genes from the given disease panel.
701
- :param str panel_mode_of_inheritance: Filter genes from specific
702
- panels that match certain mode of inheritance. Accepted values : [
703
- autosomalDominant, autosomalRecessive, XLinkedDominant,
704
- XLinkedRecessive, YLinked, mitochondrial, deNovo, mendelianError,
705
- compoundHeterozygous ].
706
- :param str panel_confidence: Filter genes from specific panels that
707
- match certain confidence. Accepted values : [ high, medium, low,
708
- rejected ].
709
- :param str panel_feature_type: Filter elements from specific panels by
710
- type. Accepted values : [ gene, region, str, variant ].
711
- :param str panel_role_in_cancer: Filter genes from specific panels
712
- that match certain role in cancer. Accepted values : [ both,
713
- oncogene, tumorSuppressorGene, fusion ].
714
- :param bool panel_intersection: Intersect panel genes and regions with
715
- given genes and regions from que input query. This will prevent
716
- returning variants from regions out of the panel.
717
- :param str ms_id: Signature ID.
718
- :param str ms_description: Signature description.
719
- """
720
-
721
- return self._get(category='analysis', resource='query', subcategory='variant/mutationalSignature', **options)
722
-
723
- def run_mutational_signature(self, data=None, **options):
724
- """
725
- Run mutational signature analysis for a given sample.
726
- PATH: /{apiVersion}/analysis/variant/mutationalSignature/run
727
-
728
- :param dict data: Mutational signature analysis parameters to index
729
- the genome context for that sample, and to compute both catalogue
730
- counts and signature fitting. In order to skip one of them, , use
731
- the following keywords: , catalogue, fitting. (REQUIRED)
732
- :param str study: Study [[organization@]project:]study where study and
733
- project can be either the ID or UUID.
734
- :param str job_id: Job ID. It must be a unique string within the
735
- study. An ID will be autogenerated automatically if not provided.
736
- :param str job_description: Job description.
737
- :param str job_depends_on: Comma separated list of existing job IDs
738
- the job will depend on.
739
- :param str job_tags: Job tags.
740
- :param str job_scheduled_start_time: Time when the job is scheduled to
741
- start.
742
- :param str job_priority: Priority of the job.
743
- :param bool job_dry_run: Flag indicating that the job will be executed
744
- in dry-run mode. In this mode, OpenCGA will validate that all
745
- parameters and prerequisites are correctly set for successful
746
- execution, but the job will not actually run.
747
- """
748
-
749
- return self._post(category='analysis', resource='run', subcategory='variant/mutationalSignature', data=data, **options)
750
-
751
- def run_plink(self, data=None, **options):
752
- """
753
- Plink is a whole genome association analysis toolset, designed to
754
- perform a range of basic, large-scale analyses.
755
- PATH: /{apiVersion}/analysis/variant/plink/run
756
-
757
- :param dict data: Plink params. (REQUIRED)
758
- :param str study: study.
759
- :param str job_id: Job ID. It must be a unique string within the
760
- study. An ID will be autogenerated automatically if not provided.
761
- :param str job_description: Job description.
762
- :param str job_depends_on: Comma separated list of existing job IDs
763
- the job will depend on.
764
- :param str job_tags: Job tags.
765
- :param str job_scheduled_start_time: Time when the job is scheduled to
766
- start.
767
- :param str job_priority: Priority of the job.
768
- :param bool job_dry_run: Flag indicating that the job will be executed
769
- in dry-run mode. In this mode, OpenCGA will validate that all
770
- parameters and prerequisites are correctly set for successful
771
- execution, but the job will not actually run.
772
- """
773
-
774
- return self._post(category='analysis', resource='run', subcategory='variant/plink', data=data, **options)
775
-
776
- def query(self, **options):
777
- """
778
- Filter and fetch variants from indexed VCF files in the variant
779
- storage.
780
- PATH: /{apiVersion}/analysis/variant/query
781
-
782
- :param str include: Fields included in the response, whole JSON path
783
- must be provided.
784
- :param str exclude: Fields excluded in the response, whole JSON path
785
- must be provided.
786
- :param int limit: Number of results to be returned.
787
- :param int skip: Number of results to skip.
788
- :param bool count: Get the total number of results matching the query.
789
- Deactivated by default.
790
- :param bool sort: Sort the results.
791
- :param bool summary: Fast fetch of main variant parameters.
792
- :param bool approximate_count: Get an approximate count, instead of an
793
- exact total count. Reduces execution time.
794
- :param int approximate_count_sampling_size: Sampling size to get the
795
- approximate count. Larger values increase accuracy but also
796
- increase execution time.
797
- :param str saved_filter: Use a saved filter at User level.
798
- :param str id: List of variant IDs in the format chrom:start:ref:alt,
799
- e.g. 19:7177679:C:T.
800
- :param str region: List of regions, these can be just a single
801
- chromosome name or regions in the format chr:start-end, e.g.:
802
- 2,3:100000-200000.
803
- :param str type: List of types, accepted values are SNV, MNV, INDEL,
804
- SV, COPY_NUMBER, COPY_NUMBER_LOSS, COPY_NUMBER_GAIN, INSERTION,
805
- DELETION, DUPLICATION, TANDEM_DUPLICATION, BREAKEND, e.g.
806
- SNV,INDEL.
807
- :param str reference: Reference allele.
808
- :param str alternate: Main alternate allele.
809
- :param str project: Project [organization@]project where project can
810
- be either the ID or the alias.
811
- :param str study: Filter variants from the given studies, these can be
812
- either the numeric ID or the alias with the format
813
- organization@project:study.
814
- :param str file: Filter variants from the files specified. This will
815
- set includeFile parameter when not provided.
816
- :param str filter: Specify the FILTER for any of the files. If 'file'
817
- filter is provided, will match the file and the filter. e.g.:
818
- PASS,LowGQX.
819
- :param str qual: Specify the QUAL for any of the files. If 'file'
820
- filter is provided, will match the file and the qual. e.g.: >123.4.
821
- :param str file_data: Filter by file data (i.e. FILTER, QUAL and INFO
822
- columns from VCF file). [{file}:]{key}{op}{value}[,;]* . If no file
823
- is specified, will use all files from 'file' filter. e.g. AN>200 or
824
- file_1.vcf:AN>200;file_2.vcf:AN<10 . Many fields can be combined.
825
- e.g. file_1.vcf:AN>200;DB=true;file_2.vcf:AN<10,FILTER=PASS,LowDP.
826
- :param str sample: Filter variants by sample genotype. This will
827
- automatically set 'includeSample' parameter when not provided. This
828
- filter accepts multiple 3 forms: 1) List of samples: Samples that
829
- contain the main variant. Accepts AND ';' and OR ',' operators.
830
- e.g. HG0097,HG0098 . 2) List of samples with genotypes:
831
- {sample}:{gt1},{gt2}. Accepts AND ';' and OR ',' operators. e.g.
832
- HG0097:0/0;HG0098:0/1,1/1 . Unphased genotypes (e.g. 0/1, 1/1) will
833
- also include phased genotypes (e.g. 0|1, 1|0, 1|1), but not vice
834
- versa. When filtering by multi-allelic genotypes, any secondary
835
- allele will match, regardless of its position e.g. 1/2 will match
836
- with genotypes 1/2, 1/3, 1/4, .... Genotype aliases accepted:
837
- HOM_REF, HOM_ALT, HET, HET_REF, HET_ALT, HET_MISS and MISS e.g.
838
- HG0097:HOM_REF;HG0098:HET_REF,HOM_ALT . 3) Sample with segregation
839
- mode: {sample}:{segregation}. Only one sample accepted.Accepted
840
- segregation modes: [ autosomalDominant, autosomalRecessive,
841
- XLinkedDominant, XLinkedRecessive, YLinked, mitochondrial, deNovo,
842
- deNovoStrict, mendelianError, compoundHeterozygous ]. Value is case
843
- insensitive. e.g. HG0097:DeNovo Sample must have parents defined
844
- and indexed. .
845
- :param str genotype: Samples with a specific genotype:
846
- {samp_1}:{gt_1}(,{gt_n})*(;{samp_n}:{gt_1}(,{gt_n})*)* e.g.
847
- HG0097:0/0;HG0098:0/1,1/1. Unphased genotypes (e.g. 0/1, 1/1) will
848
- also include phased genotypes (e.g. 0|1, 1|0, 1|1), but not vice
849
- versa. When filtering by multi-allelic genotypes, any secondary
850
- allele will match, regardless of its position e.g. 1/2 will match
851
- with genotypes 1/2, 1/3, 1/4, .... Genotype aliases accepted:
852
- HOM_REF, HOM_ALT, HET, HET_REF, HET_ALT, HET_MISS and MISS e.g.
853
- HG0097:HOM_REF;HG0098:HET_REF,HOM_ALT. This will automatically set
854
- 'includeSample' parameter when not provided.
855
- :param str sample_data: Filter by any SampleData field from samples.
856
- [{sample}:]{key}{op}{value}[,;]* . If no sample is specified, will
857
- use all samples from 'sample' or 'genotype' filter. e.g. DP>200 or
858
- HG0097:DP>200,HG0098:DP<10 . Many FORMAT fields can be combined.
859
- e.g. HG0097:DP>200;GT=1/1,0/1,HG0098:DP<10.
860
- :param str sample_annotation: Selects some samples using metadata
861
- information from Catalog. e.g.
862
- age>20;phenotype=hpo:123,hpo:456;name=smith.
863
- :param bool sample_metadata: Return the samples metadata group by
864
- study. Sample names will appear in the same order as their
865
- corresponding genotypes.
866
- :param str unknown_genotype: Returned genotype for unknown genotypes.
867
- Common values: [0/0, 0|0, ./.].
868
- :param int sample_limit: Limit the number of samples to be included in
869
- the result.
870
- :param int sample_skip: Skip some samples from the result. Useful for
871
- sample pagination.
872
- :param str cohort: Select variants with calculated stats for the
873
- selected cohorts.
874
- :param str cohort_stats_ref: Reference Allele Frequency:
875
- [{study:}]{cohort}[<|>|<=|>=]{number}. e.g. ALL<=0.4.
876
- :param str cohort_stats_alt: Alternate Allele Frequency:
877
- [{study:}]{cohort}[<|>|<=|>=]{number}. e.g. ALL<=0.4.
878
- :param str cohort_stats_maf: Minor Allele Frequency:
879
- [{study:}]{cohort}[<|>|<=|>=]{number}. e.g. ALL<=0.4.
880
- :param str cohort_stats_mgf: Minor Genotype Frequency:
881
- [{study:}]{cohort}[<|>|<=|>=]{number}. e.g. ALL<=0.4.
882
- :param str cohort_stats_pass: Filter PASS frequency:
883
- [{study:}]{cohort}[<|>|<=|>=]{number}. e.g. ALL>0.8.
884
- :param str missing_alleles: Number of missing alleles:
885
- [{study:}]{cohort}[<|>|<=|>=]{number}.
886
- :param str missing_genotypes: Number of missing genotypes:
887
- [{study:}]{cohort}[<|>|<=|>=]{number}.
888
- :param str score: Filter by variant score:
889
- [{study:}]{score}[<|>|<=|>=]{number}.
890
- :param str family: Filter variants where any of the samples from the
891
- given family contains the variant (HET or HOM_ALT).
892
- :param str family_disorder: Specify the disorder to use for the family
893
- segregation.
894
- :param str family_segregation: Filter by segregation mode from a given
895
- family. Accepted values: [ autosomalDominant, autosomalRecessive,
896
- XLinkedDominant, XLinkedRecessive, YLinked, mitochondrial, deNovo,
897
- deNovoStrict, mendelianError, compoundHeterozygous ].
898
- :param str family_members: Sub set of the members of a given family.
899
- :param str family_proband: Specify the proband child to use for the
900
- family segregation.
901
- :param str include_study: List of studies to include in the result.
902
- Accepts 'all' and 'none'.
903
- :param str include_file: List of files to be returned. Accepts 'all'
904
- and 'none'. If undefined, automatically includes files used for
905
- filtering. If none, no file is included.
906
- :param str include_sample: List of samples to be included in the
907
- result. Accepts 'all' and 'none'. If undefined, automatically
908
- includes samples used for filtering. If none, no sample is
909
- included.
910
- :param str include_sample_data: List of Sample Data keys (i.e. FORMAT
911
- column from VCF file) from Sample Data to include in the output.
912
- e.g: DP,AD. Accepts 'all' and 'none'.
913
- :param str include_genotype: Include genotypes, apart of other formats
914
- defined with includeFormat.
915
- :param str include_sample_id: Include sampleId on each result.
916
- :param bool annotation_exists: Return only annotated variants.
917
- :param str gene: List of genes, most gene IDs are accepted (HGNC,
918
- Ensembl gene, ...). This is an alias to 'xref' parameter.
919
- :param str ct: List of SO consequence types, e.g.
920
- missense_variant,stop_lost or SO:0001583,SO:0001578. Accepts
921
- aliases 'loss_of_function' and 'protein_altering'.
922
- :param str xref: List of any external reference, these can be genes,
923
- proteins or variants. Accepted IDs include HGNC, Ensembl genes,
924
- dbSNP, ClinVar, HPO, Cosmic, HGVS ...
925
- :param str biotype: List of biotypes, e.g. protein_coding.
926
- :param str protein_substitution: Protein substitution scores include
927
- SIFT and PolyPhen. You can query using the score
928
- {protein_score}[<|>|<=|>=]{number} or the description
929
- {protein_score}[~=|=]{description} e.g. polyphen>0.1,sift=tolerant.
930
- :param str conservation: Filter by conservation score:
931
- {conservation_score}[<|>|<=|>=]{number} e.g.
932
- phastCons>0.5,phylop<0.1,gerp>0.1.
933
- :param str population_frequency_alt: Alternate Population Frequency:
934
- {study}:{population}[<|>|<=|>=]{number}. e.g. 1000G:ALL<0.01.
935
- :param str population_frequency_ref: Reference Population Frequency:
936
- {study}:{population}[<|>|<=|>=]{number}. e.g. 1000G:ALL<0.01.
937
- :param str population_frequency_maf: Population minor allele
938
- frequency: {study}:{population}[<|>|<=|>=]{number}. e.g.
939
- 1000G:ALL<0.01.
940
- :param str transcript_flag: List of transcript flags. e.g. canonical,
941
- CCDS, basic, LRG, MANE Select, MANE Plus Clinical, EGLH_HaemOnc,
942
- TSO500.
943
- :param str gene_trait_id: List of gene trait association id. e.g.
944
- 'umls:C0007222' , 'OMIM:269600'.
945
- :param str go: List of GO (Gene Ontology) terms. e.g. 'GO:0002020'.
946
- :param str expression: List of tissues of interest. e.g. 'lung'.
947
- :param str protein_keyword: List of Uniprot protein variant annotation
948
- keywords.
949
- :param str drug: List of drug names.
950
- :param str functional_score: Functional score:
951
- {functional_score}[<|>|<=|>=]{number} e.g. cadd_scaled>5.2 ,
952
- cadd_raw<=0.3.
953
- :param str clinical: Clinical source: clinvar, cosmic.
954
- :param str clinical_significance: Clinical significance: benign,
955
- likely_benign, likely_pathogenic, pathogenic.
956
- :param bool clinical_confirmed_status: Clinical confirmed status.
957
- :param str custom_annotation: Custom annotation:
958
- {key}[<|>|<=|>=]{number} or {key}[~=|=]{text}.
959
- :param str panel: Filter by genes from the given disease panel.
960
- :param str panel_mode_of_inheritance: Filter genes from specific
961
- panels that match certain mode of inheritance. Accepted values : [
962
- autosomalDominant, autosomalRecessive, XLinkedDominant,
963
- XLinkedRecessive, YLinked, mitochondrial, deNovo, mendelianError,
964
- compoundHeterozygous ].
965
- :param str panel_confidence: Filter genes from specific panels that
966
- match certain confidence. Accepted values : [ high, medium, low,
967
- rejected ].
968
- :param str panel_role_in_cancer: Filter genes from specific panels
969
- that match certain role in cancer. Accepted values : [ both,
970
- oncogene, tumorSuppressorGene, fusion ].
971
- :param str panel_feature_type: Filter elements from specific panels by
972
- type. Accepted values : [ gene, region, str, variant ].
973
- :param bool panel_intersection: Intersect panel genes and regions with
974
- given genes and regions from que input query. This will prevent
975
- returning variants from regions out of the panel.
976
- :param str source: Select the variant data source from where to fetch
977
- the data. Accepted values are 'variant_index' (default) and
978
- 'secondary_sample_index'. When selecting a secondary_index, the
979
- data will be retrieved exclusively from that secondary index, and
980
- the 'include/exclude' parameters will be ignored. If the given
981
- query can not be fully resolved using the secondary index, an
982
- exception will be raised. As the returned variants will only
983
- contain data from the secondary_index, some data might be missing
984
- or be partial.
985
- :param str trait: List of traits, based on ClinVar, HPO, COSMIC, i.e.:
986
- IDs, histologies, descriptions,...
987
- """
988
-
989
- return self._get(category='analysis', resource='query', subcategory='variant', **options)
990
-
991
- def run_relatedness(self, data=None, **options):
992
- """
993
- Compute a score to quantify relatedness between samples.
994
- PATH: /{apiVersion}/analysis/variant/relatedness/run
995
-
996
- :param dict data: Relatedness analysis params. (REQUIRED)
997
- :param str study: Study [[organization@]project:]study where study and
998
- project can be either the ID or UUID.
999
- :param str job_id: Job ID. It must be a unique string within the
1000
- study. An ID will be autogenerated automatically if not provided.
1001
- :param str job_description: Job description.
1002
- :param str job_depends_on: Comma separated list of existing job IDs
1003
- the job will depend on.
1004
- :param str job_tags: Job tags.
1005
- :param str job_scheduled_start_time: Time when the job is scheduled to
1006
- start.
1007
- :param str job_priority: Priority of the job.
1008
- :param bool job_dry_run: Flag indicating that the job will be executed
1009
- in dry-run mode. In this mode, OpenCGA will validate that all
1010
- parameters and prerequisites are correctly set for successful
1011
- execution, but the job will not actually run.
1012
- """
1013
-
1014
- return self._post(category='analysis', resource='run', subcategory='variant/relatedness', data=data, **options)
1015
-
1016
- def run_rvtests(self, data=None, **options):
1017
- """
1018
- Rvtests is a flexible software package for genetic association
1019
- studies. Supported RvTests commands: rvtest, vcf2kinship.
1020
- PATH: /{apiVersion}/analysis/variant/rvtests/run
1021
-
1022
- :param dict data: RvTests parameters. Supported RvTests commands:
1023
- rvtest, vcf2kinship. (REQUIRED)
1024
- :param str study: study.
1025
- :param str job_id: Job ID. It must be a unique string within the
1026
- study. An ID will be autogenerated automatically if not provided.
1027
- :param str job_description: Job description.
1028
- :param str job_depends_on: Comma separated list of existing job IDs
1029
- the job will depend on.
1030
- :param str job_tags: Job tags.
1031
- :param str job_scheduled_start_time: Time when the job is scheduled to
1032
- start.
1033
- :param str job_priority: Priority of the job.
1034
- :param bool job_dry_run: Flag indicating that the job will be executed
1035
- in dry-run mode. In this mode, OpenCGA will validate that all
1036
- parameters and prerequisites are correctly set for successful
1037
- execution, but the job will not actually run.
1038
- """
1039
-
1040
- return self._post(category='analysis', resource='run', subcategory='variant/rvtests', data=data, **options)
1041
-
1042
- def aggregation_stats_sample(self, **options):
1043
- """
1044
- Calculate and fetch sample aggregation stats.
1045
- PATH: /{apiVersion}/analysis/variant/sample/aggregationStats
1046
-
1047
- :param str saved_filter: Use a saved filter at User level.
1048
- :param str region: List of regions, these can be just a single
1049
- chromosome name or regions in the format chr:start-end, e.g.:
1050
- 2,3:100000-200000.
1051
- :param str type: List of types, accepted values are SNV, MNV, INDEL,
1052
- SV, COPY_NUMBER, COPY_NUMBER_LOSS, COPY_NUMBER_GAIN, INSERTION,
1053
- DELETION, DUPLICATION, TANDEM_DUPLICATION, BREAKEND, e.g.
1054
- SNV,INDEL.
1055
- :param str project: Project [organization@]project where project can
1056
- be either the ID or the alias.
1057
- :param str study: Filter variants from the given studies, these can be
1058
- either the numeric ID or the alias with the format
1059
- organization@project:study.
1060
- :param str file: Filter variants from the files specified. This will
1061
- set includeFile parameter when not provided.
1062
- :param str filter: Specify the FILTER for any of the files. If 'file'
1063
- filter is provided, will match the file and the filter. e.g.:
1064
- PASS,LowGQX.
1065
- :param str sample: Filter variants by sample genotype. This will
1066
- automatically set 'includeSample' parameter when not provided. This
1067
- filter accepts multiple 3 forms: 1) List of samples: Samples that
1068
- contain the main variant. Accepts AND ';' and OR ',' operators.
1069
- e.g. HG0097,HG0098 . 2) List of samples with genotypes:
1070
- {sample}:{gt1},{gt2}. Accepts AND ';' and OR ',' operators. e.g.
1071
- HG0097:0/0;HG0098:0/1,1/1 . Unphased genotypes (e.g. 0/1, 1/1) will
1072
- also include phased genotypes (e.g. 0|1, 1|0, 1|1), but not vice
1073
- versa. When filtering by multi-allelic genotypes, any secondary
1074
- allele will match, regardless of its position e.g. 1/2 will match
1075
- with genotypes 1/2, 1/3, 1/4, .... Genotype aliases accepted:
1076
- HOM_REF, HOM_ALT, HET, HET_REF, HET_ALT, HET_MISS and MISS e.g.
1077
- HG0097:HOM_REF;HG0098:HET_REF,HOM_ALT . 3) Sample with segregation
1078
- mode: {sample}:{segregation}. Only one sample accepted.Accepted
1079
- segregation modes: [ autosomalDominant, autosomalRecessive,
1080
- XLinkedDominant, XLinkedRecessive, YLinked, mitochondrial, deNovo,
1081
- deNovoStrict, mendelianError, compoundHeterozygous ]. Value is case
1082
- insensitive. e.g. HG0097:DeNovo Sample must have parents defined
1083
- and indexed. .
1084
- :param str genotype: Samples with a specific genotype:
1085
- {samp_1}:{gt_1}(,{gt_n})*(;{samp_n}:{gt_1}(,{gt_n})*)* e.g.
1086
- HG0097:0/0;HG0098:0/1,1/1. Unphased genotypes (e.g. 0/1, 1/1) will
1087
- also include phased genotypes (e.g. 0|1, 1|0, 1|1), but not vice
1088
- versa. When filtering by multi-allelic genotypes, any secondary
1089
- allele will match, regardless of its position e.g. 1/2 will match
1090
- with genotypes 1/2, 1/3, 1/4, .... Genotype aliases accepted:
1091
- HOM_REF, HOM_ALT, HET, HET_REF, HET_ALT, HET_MISS and MISS e.g.
1092
- HG0097:HOM_REF;HG0098:HET_REF,HOM_ALT. This will automatically set
1093
- 'includeSample' parameter when not provided.
1094
- :param str sample_annotation: Selects some samples using metadata
1095
- information from Catalog. e.g.
1096
- age>20;phenotype=hpo:123,hpo:456;name=smith.
1097
- :param str family: Filter variants where any of the samples from the
1098
- given family contains the variant (HET or HOM_ALT).
1099
- :param str family_disorder: Specify the disorder to use for the family
1100
- segregation.
1101
- :param str family_segregation: Filter by segregation mode from a given
1102
- family. Accepted values: [ autosomalDominant, autosomalRecessive,
1103
- XLinkedDominant, XLinkedRecessive, YLinked, mitochondrial, deNovo,
1104
- deNovoStrict, mendelianError, compoundHeterozygous ].
1105
- :param str family_members: Sub set of the members of a given family.
1106
- :param str family_proband: Specify the proband child to use for the
1107
- family segregation.
1108
- :param str ct: List of SO consequence types, e.g.
1109
- missense_variant,stop_lost or SO:0001583,SO:0001578. Accepts
1110
- aliases 'loss_of_function' and 'protein_altering'.
1111
- :param str biotype: List of biotypes, e.g. protein_coding.
1112
- :param str population_frequency_alt: Alternate Population Frequency:
1113
- {study}:{population}[<|>|<=|>=]{number}. e.g. 1000G:ALL<0.01.
1114
- :param str clinical: Clinical source: clinvar, cosmic.
1115
- :param str clinical_significance: Clinical significance: benign,
1116
- likely_benign, likely_pathogenic, pathogenic.
1117
- :param bool clinical_confirmed_status: Clinical confirmed status.
1118
- :param str field: List of facet fields separated by semicolons, e.g.:
1119
- studies;type. For nested faceted fields use >>, e.g.:
1120
- chromosome>>type . Accepted values: chromosome, type, genotype,
1121
- consequenceType, biotype, clinicalSignificance, dp, qual, filter.
1122
- """
1123
-
1124
- return self._get(category='analysis', resource='aggregationStats', subcategory='variant/sample', **options)
1125
-
1126
- def run_sample_eligibility(self, data=None, **options):
1127
- """
1128
- Filter samples by a complex query involving metadata and variants
1129
- data.
1130
- PATH: /{apiVersion}/analysis/variant/sample/eligibility/run
1131
-
1132
- :param dict data: . (REQUIRED)
1133
- :param str study: Study [[organization@]project:]study where study and
1134
- project can be either the ID or UUID.
1135
- :param str job_id: Job ID. It must be a unique string within the
1136
- study. An ID will be autogenerated automatically if not provided.
1137
- :param str job_description: Job description.
1138
- :param str job_depends_on: Comma separated list of existing job IDs
1139
- the job will depend on.
1140
- :param str job_tags: Job tags.
1141
- :param str job_scheduled_start_time: Time when the job is scheduled to
1142
- start.
1143
- :param str job_priority: Priority of the job.
1144
- :param bool job_dry_run: Flag indicating that the job will be executed
1145
- in dry-run mode. In this mode, OpenCGA will validate that all
1146
- parameters and prerequisites are correctly set for successful
1147
- execution, but the job will not actually run.
1148
- """
1149
-
1150
- return self._post(category='analysis', resource='run', subcategory='variant/sample/eligibility', data=data, **options)
1151
-
1152
- def run_sample_qc(self, data=None, **options):
1153
- """
1154
- Run quality control (QC) for a given sample. It includes variant
1155
- stats, and if the sample is somatic, mutational signature and
1156
- genome plot are calculated.
1157
- PATH: /{apiVersion}/analysis/variant/sample/qc/run
1158
-
1159
- :param dict data: Sample QC analysis params. Mutational signature and
1160
- genome plot are calculated for somatic samples only. In order to
1161
- skip some metrics, use the following keywords (separated by
1162
- commas): variant-stats, signature, signature-catalogue,
1163
- signature-fitting, genome-plot. (REQUIRED)
1164
- :param str study: Study [[organization@]project:]study where study and
1165
- project can be either the ID or UUID.
1166
- :param str job_id: Job ID. It must be a unique string within the
1167
- study. An ID will be autogenerated automatically if not provided.
1168
- :param str job_description: Job description.
1169
- :param str job_depends_on: Comma separated list of existing job IDs
1170
- the job will depend on.
1171
- :param str job_tags: Job tags.
1172
- :param str job_scheduled_start_time: Time when the job is scheduled to
1173
- start.
1174
- :param str job_priority: Priority of the job.
1175
- :param bool job_dry_run: Flag indicating that the job will be executed
1176
- in dry-run mode. In this mode, OpenCGA will validate that all
1177
- parameters and prerequisites are correctly set for successful
1178
- execution, but the job will not actually run.
1179
- """
1180
-
1181
- return self._post(category='analysis', resource='run', subcategory='variant/sample/qc', data=data, **options)
1182
-
1183
- def query_sample(self, **options):
1184
- """
1185
- Get sample data of a given variant.
1186
- PATH: /{apiVersion}/analysis/variant/sample/query
1187
-
1188
- :param int limit: Number of results to be returned.
1189
- :param int skip: Number of results to skip.
1190
- :param str variant: Variant.
1191
- :param str study: Study where all the samples belong to.
1192
- :param str genotype: Genotypes that the sample must have to be
1193
- selected.
1194
- """
1195
-
1196
- return self._get(category='analysis', resource='query', subcategory='variant/sample', **options)
1197
-
1198
- def run_sample(self, data=None, **options):
1199
- """
1200
- Get samples given a set of variants.
1201
- PATH: /{apiVersion}/analysis/variant/sample/run
1202
-
1203
- :param dict data: Sample variant filter params. (REQUIRED)
1204
- :param str study: Study [[organization@]project:]study where study and
1205
- project can be either the ID or UUID.
1206
- :param str job_id: Job ID. It must be a unique string within the
1207
- study. An ID will be autogenerated automatically if not provided.
1208
- :param str job_description: Job description.
1209
- :param str job_depends_on: Comma separated list of existing job IDs
1210
- the job will depend on.
1211
- :param str job_tags: Job tags.
1212
- :param str job_scheduled_start_time: Time when the job is scheduled to
1213
- start.
1214
- :param str job_priority: Priority of the job.
1215
- :param bool job_dry_run: Flag indicating that the job will be executed
1216
- in dry-run mode. In this mode, OpenCGA will validate that all
1217
- parameters and prerequisites are correctly set for successful
1218
- execution, but the job will not actually run.
1219
- """
1220
-
1221
- return self._post(category='analysis', resource='run', subcategory='variant/sample', data=data, **options)
1222
-
1223
- def query_sample_stats(self, sample, **options):
1224
- """
1225
- Obtain sample variant stats from a sample.
1226
- PATH: /{apiVersion}/analysis/variant/sample/stats/query
1227
-
1228
- :param str sample: Sample ID. (REQUIRED)
1229
- :param str region: List of regions, these can be just a single
1230
- chromosome name or regions in the format chr:start-end, e.g.:
1231
- 2,3:100000-200000.
1232
- :param str type: List of types, accepted values are SNV, MNV, INDEL,
1233
- SV, COPY_NUMBER, COPY_NUMBER_LOSS, COPY_NUMBER_GAIN, INSERTION,
1234
- DELETION, DUPLICATION, TANDEM_DUPLICATION, BREAKEND, e.g.
1235
- SNV,INDEL.
1236
- :param str study: Study [[organization@]project:]study where study and
1237
- project can be either the ID or UUID.
1238
- :param str file: Filter variants from the files specified. This will
1239
- set includeFile parameter when not provided.
1240
- :param str filter: Specify the FILTER for any of the files. If 'file'
1241
- filter is provided, will match the file and the filter. e.g.:
1242
- PASS,LowGQX.
1243
- :param str sample_data: Filter by any SampleData field from samples.
1244
- [{sample}:]{key}{op}{value}[,;]* . If no sample is specified, will
1245
- use all samples from 'sample' or 'genotype' filter. e.g. DP>200 or
1246
- HG0097:DP>200,HG0098:DP<10 . Many FORMAT fields can be combined.
1247
- e.g. HG0097:DP>200;GT=1/1,0/1,HG0098:DP<10.
1248
- :param str ct: List of SO consequence types, e.g.
1249
- missense_variant,stop_lost or SO:0001583,SO:0001578. Accepts
1250
- aliases 'loss_of_function' and 'protein_altering'.
1251
- :param str biotype: List of biotypes, e.g. protein_coding.
1252
- :param str transcript_flag: List of transcript flags. e.g. canonical,
1253
- CCDS, basic, LRG, MANE Select, MANE Plus Clinical, EGLH_HaemOnc,
1254
- TSO500.
1255
- :param str population_frequency_alt: Alternate Population Frequency:
1256
- {study}:{population}[<|>|<=|>=]{number}. e.g. 1000G:ALL<0.01.
1257
- :param str clinical: Clinical source: clinvar, cosmic.
1258
- :param str clinical_significance: Clinical significance: benign,
1259
- likely_benign, likely_pathogenic, pathogenic.
1260
- :param bool clinical_confirmed_status: Clinical confirmed status.
1261
- :param bool filter_transcript: Do filter transcripts when obtaining
1262
- transcript counts.
1263
- """
1264
-
1265
- options['sample'] = sample
1266
- return self._get(category='analysis', resource='query', subcategory='variant/sample/stats', **options)
1267
-
1268
- def run_sample_stats(self, data=None, **options):
1269
- """
1270
- Compute sample variant stats for the selected list of samples.
1271
- PATH: /{apiVersion}/analysis/variant/sample/stats/run
1272
-
1273
- :param dict data: Sample variant stats params. Use index=true and
1274
- indexId='' to store the result in catalog sample QC. indexId=ALL
1275
- requires an empty query. Use sample=all to compute sample stats of
1276
- all samples in the variant storage. (REQUIRED)
1277
- :param str study: Study [[organization@]project:]study where study and
1278
- project can be either the ID or UUID.
1279
- :param str job_id: Job ID. It must be a unique string within the
1280
- study. An ID will be autogenerated automatically if not provided.
1281
- :param str job_description: Job description.
1282
- :param str job_depends_on: Comma separated list of existing job IDs
1283
- the job will depend on.
1284
- :param str job_tags: Job tags.
1285
- :param str job_scheduled_start_time: Time when the job is scheduled to
1286
- start.
1287
- :param str job_priority: Priority of the job.
1288
- :param bool job_dry_run: Flag indicating that the job will be executed
1289
- in dry-run mode. In this mode, OpenCGA will validate that all
1290
- parameters and prerequisites are correctly set for successful
1291
- execution, but the job will not actually run.
1292
- """
1293
-
1294
- return self._post(category='analysis', resource='run', subcategory='variant/sample/stats', data=data, **options)
1295
-
1296
- def run_stats_export(self, data=None, **options):
1297
- """
1298
- Export calculated variant stats and frequencies.
1299
- PATH: /{apiVersion}/analysis/variant/stats/export/run
1300
-
1301
- :param dict data: Variant stats export params. (REQUIRED)
1302
- :param str project: Project [organization@]project where project can
1303
- be either the ID or the alias.
1304
- :param str study: Study [[organization@]project:]study where study and
1305
- project can be either the ID or UUID.
1306
- :param str job_id: Job ID. It must be a unique string within the
1307
- study. An ID will be autogenerated automatically if not provided.
1308
- :param str job_description: Job description.
1309
- :param str job_depends_on: Comma separated list of existing job IDs
1310
- the job will depend on.
1311
- :param str job_tags: Job tags.
1312
- :param str job_scheduled_start_time: Time when the job is scheduled to
1313
- start.
1314
- :param str job_priority: Priority of the job.
1315
- :param bool job_dry_run: Flag indicating that the job will be executed
1316
- in dry-run mode. In this mode, OpenCGA will validate that all
1317
- parameters and prerequisites are correctly set for successful
1318
- execution, but the job will not actually run.
1319
- """
1320
-
1321
- return self._post(category='analysis', resource='run', subcategory='variant/stats/export', data=data, **options)
1322
-
1323
- def run_stats(self, data=None, **options):
1324
- """
1325
- Compute variant stats for any cohort and any set of variants.
1326
- PATH: /{apiVersion}/analysis/variant/stats/run
1327
-
1328
- :param dict data: Variant stats params. (REQUIRED)
1329
- :param str study: Study [[organization@]project:]study where study and
1330
- project can be either the ID or UUID.
1331
- :param str job_id: Job ID. It must be a unique string within the
1332
- study. An ID will be autogenerated automatically if not provided.
1333
- :param str job_description: Job description.
1334
- :param str job_depends_on: Comma separated list of existing job IDs
1335
- the job will depend on.
1336
- :param str job_tags: Job tags.
1337
- :param str job_scheduled_start_time: Time when the job is scheduled to
1338
- start.
1339
- :param str job_priority: Priority of the job.
1340
- :param bool job_dry_run: Flag indicating that the job will be executed
1341
- in dry-run mode. In this mode, OpenCGA will validate that all
1342
- parameters and prerequisites are correctly set for successful
1343
- execution, but the job will not actually run.
1344
- """
1345
-
1346
- return self._post(category='analysis', resource='run', subcategory='variant/stats', data=data, **options)
1347
-
1348
- def run_walker(self, data=None, **options):
1349
- """
1350
- Filter and walk variants from the variant storage to produce a file.
1351
- PATH: /{apiVersion}/analysis/variant/walker/run
1352
-
1353
- :param dict data: Variant walker params. (REQUIRED)
1354
- :param str include: Fields included in the response, whole JSON path
1355
- must be provided.
1356
- :param str exclude: Fields excluded in the response, whole JSON path
1357
- must be provided.
1358
- :param str project: Project [organization@]project where project can
1359
- be either the ID or the alias.
1360
- :param str study: Study [[organization@]project:]study where study and
1361
- project can be either the ID or UUID.
1362
- :param str job_id: Job ID. It must be a unique string within the
1363
- study. An ID will be autogenerated automatically if not provided.
1364
- :param str job_description: Job description.
1365
- :param str job_depends_on: Comma separated list of existing job IDs
1366
- the job will depend on.
1367
- :param str job_tags: Job tags.
1368
- :param str job_scheduled_start_time: Time when the job is scheduled to
1369
- start.
1370
- :param str job_priority: Priority of the job.
1371
- :param bool job_dry_run: Flag indicating that the job will be executed
1372
- in dry-run mode. In this mode, OpenCGA will validate that all
1373
- parameters and prerequisites are correctly set for successful
1374
- execution, but the job will not actually run.
1375
- """
1376
-
1377
- return self._post(category='analysis', resource='run', subcategory='variant/walker', data=data, **options)
1378
-