pharmaobservatory 0.1.7 → 0.1.8

data/docs/BiomarkerEvidenceByYearRow.md

@@ -0,0 +1,32 @@
+# PharmaObservatory::BiomarkerEvidenceByYearRow
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **route_key** | **String** | The gene's route key, the entry key for the biomarkers object type; the gene symbol. | [optional] |
+| **gene_symbol** | **String** | The gene symbol. | [optional] |
+| **evidence_type** | **String** | The evidence arm. trial_mention counts trials that mention the gene (the year is the trial start year); publication_mention counts papers cited by registered trials that mention it (the year is the publication year). | [optional] |
+| **evidence_year** | **Integer** | The year of the mentions. Null for the undated class. | [optional] |
+| **year_class** | **String** | How the year is treated. plotted: inside the window the web chart draws. pre_window: before 1990. future_dated: after the current year. corpus_incomplete: after the latest year the arm's corpus covers. undated: the source has no year. | [optional] |
+| **n_mentions** | **Integer** | Mentions of the gene in that arm, year and class. A document that mentions the gene more than once counts once per mention. | [optional] |
+| **n_documents** | **Integer** | Distinct documents (trials or papers) that mention the gene in that arm, year and class. | [optional] |
+| **year_denominator** | **Integer** | Distinct documents in that arm and year that mention any gene, the denominator of the gene's share of the year. | [optional] |
+
+## Example
+
+```ruby
+require 'pharmaobservatory'
+
+instance = PharmaObservatory::BiomarkerEvidenceByYearRow.new(
+  route_key: null,
+  gene_symbol: null,
+  evidence_type: null,
+  evidence_year: null,
+  year_class: null,
+  n_mentions: null,
+  n_documents: null,
+  year_denominator: null
+)
+```
+

data/docs/BiomarkerTraversalStatusResponse.md

@@ -0,0 +1,58 @@
+# PharmaObservatory::BiomarkerTraversalStatusResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **dataset** | **String** |  |  |
+| **grain** | **String** |  | [optional] |
+| **object_type** | **String** |  | [optional] |
+| **id** | **String** |  | [optional] |
+| **scope** | [**BiomarkerAssayEvidenceResponseScope**](BiomarkerAssayEvidenceResponseScope.md) |  | [optional] |
+| **columns** | [**Array<DatasetColumn>**](DatasetColumn.md) |  |  |
+| **rows** | [**Array<BiomarkerTraversalStatusRow>**](BiomarkerTraversalStatusRow.md) |  |  |
+| **total** | **Integer** | The exact count of the filtered rows on an ungrouped read, carried by the cursor; null when grouped. | [optional] |
+| **next_cursor** | **String** |  | [optional] |
+| **sort** | **Array<String>** |  | [optional] |
+| **filters** | **Array<Hash<String, Object>>** |  | [optional] |
+| **group_by** | **Array<String>** |  | [optional] |
+| **measures** | **Array<String>** |  | [optional] |
+| **attribution** | [**Array<DatasetAttribution>**](DatasetAttribution.md) |  | [optional] |
+| **source_credit** | **String** |  | [optional] |
+| **withheld_tiers** | **Array<String>** |  | [optional] |
+| **withheld_columns** | **Array<String>** |  | [optional] |
+| **freshness** | [**BiomarkerAssayEvidenceResponseFreshness**](BiomarkerAssayEvidenceResponseFreshness.md) |  | [optional] |
+| **build** | [**BiomarkerAssayEvidenceResponseBuild**](BiomarkerAssayEvidenceResponseBuild.md) |  | [optional] |
+| **build_state** | [**DatasetBuildState**](DatasetBuildState.md) |  | [optional] |
+| **restriction** | **Hash<String, Object>** |  | [optional] |
+
+## Example
+
+```ruby
+require 'pharmaobservatory'
+
+instance = PharmaObservatory::BiomarkerTraversalStatusResponse.new(
+  dataset: null,
+  grain: null,
+  object_type: null,
+  id: null,
+  scope: null,
+  columns: null,
+  rows: null,
+  total: null,
+  next_cursor: null,
+  sort: null,
+  filters: null,
+  group_by: null,
+  measures: null,
+  attribution: null,
+  source_credit: null,
+  withheld_tiers: null,
+  withheld_columns: null,
+  freshness: null,
+  build: null,
+  build_state: null,
+  restriction: null
+)
+```
+

data/docs/BiomarkerTraversalStatusRow.md

@@ -0,0 +1,36 @@
+# PharmaObservatory::BiomarkerTraversalStatusRow
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **route_key** | **String** | The biomarker's route key, the entry key for the biomarkers object type. | [optional] |
+| **biomarker_id** | **String** | The biomarker's own key. | [optional] |
+| **biomarker_kind** | **String** | What kind of biomarker the row describes. | [optional] |
+| **traversal_key** | **String** | The traversal. | [optional] |
+| **display_order** | **Integer** | The order the web page lists the traversals in, one to nine. | [optional] |
+| **traversal_name** | **String** | The traversal's display name. | [optional] |
+| **applicability_state** | **String** | applicable: measured for this kind of biomarker. inapplicable: does not apply to this kind. not_measured: applies in principle but the corpus is not mined for this kind yet. | [optional] |
+| **context_mode** | **String** | How the traversal reads for this biomarker. direct: its own rows. parent_gene: the variant's gene rows. parent_and_exact: the gene's rows plus the exact variant's. child_variants: the gene's variant children. source_linked: shown when a source assertion resolves to it. bridge_deferred: depends on a bridge that has not landed. none: no traversal. | [optional] |
+| **reason_code** | **String** | The code behind the applicability state and context mode; state_detail is its sentence. | [optional] |
+| **state_detail** | **String** | The sentence the web page prints for the reason code. | [optional] |
+
+## Example
+
+```ruby
+require 'pharmaobservatory'
+
+instance = PharmaObservatory::BiomarkerTraversalStatusRow.new(
+  route_key: null,
+  biomarker_id: null,
+  biomarker_kind: null,
+  traversal_key: null,
+  display_order: null,
+  traversal_name: null,
+  applicability_state: null,
+  context_mode: null,
+  reason_code: null,
+  state_detail: null
+)
+```
+

data/docs/BiomarkersApi.md

@@ -4,22 +4,105 @@ All URIs are relative to *https://pharmaobservatory.com*
 
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
+| [**biomarkers_biomarker_allele_frequencies**](BiomarkersApi.md#biomarkers_biomarker_allele_frequencies) | **GET** /api/v1/biomarkers/{id}/biomarker_allele_frequencies | Population allele frequency of protein variants (gnomAD) |
 | [**biomarkers_biomarker_assay_evidence**](BiomarkersApi.md#biomarkers_biomarker_assay_evidence) | **GET** /api/v1/biomarkers/{id}/biomarker_assay_evidence | Biomarker assay evidence from the literature |
+| [**biomarkers_biomarker_assay_providers**](BiomarkersApi.md#biomarkers_biomarker_assay_providers) | **GET** /api/v1/biomarkers/{id}/biomarker_assay_providers | Biomarker assay providers (from validating papers) |
 | [**biomarkers_biomarker_assay_whitespace**](BiomarkersApi.md#biomarkers_biomarker_assay_whitespace) | **GET** /api/v1/biomarkers/{id}/biomarker_assay_whitespace | Biomarker assay whitespace (evidence against supplier supply) |
 | [**biomarkers_biomarker_bqp_assertions**](BiomarkersApi.md#biomarkers_biomarker_bqp_assertions) | **GET** /api/v1/biomarkers/{id}/biomarker_bqp_assertions | FDA biomarker qualification projects |
 | [**biomarkers_biomarker_cdx_assertions**](BiomarkersApi.md#biomarkers_biomarker_cdx_assertions) | **GET** /api/v1/biomarkers/{id}/biomarker_cdx_assertions | FDA companion diagnostic assertions |
 | [**biomarkers_biomarker_evidence**](BiomarkersApi.md#biomarkers_biomarker_evidence) | **GET** /api/v1/biomarkers/{id}/biomarker_evidence | Biomarker evidence |
+| [**biomarkers_biomarker_evidence_by_year**](BiomarkersApi.md#biomarkers_biomarker_evidence_by_year) | **GET** /api/v1/biomarkers/{id}/biomarker_evidence_by_year | Biomarker evidence by year (trial and publication mentions) |
 | [**biomarkers_biomarker_literature**](BiomarkersApi.md#biomarkers_biomarker_literature) | **GET** /api/v1/biomarkers/{id}/biomarker_literature | Trial-cited literature mentions |
 | [**biomarkers_biomarker_publishing_companies**](BiomarkersApi.md#biomarkers_biomarker_publishing_companies) | **GET** /api/v1/biomarkers/{id}/biomarker_publishing_companies | Companies publishing on a biomarker |
 | [**biomarkers_biomarker_relations**](BiomarkersApi.md#biomarkers_biomarker_relations) | **GET** /api/v1/biomarkers/{id}/biomarker_relations | Literature-extracted relations |
 | [**biomarkers_biomarker_sample_coverage**](BiomarkersApi.md#biomarkers_biomarker_sample_coverage) | **GET** /api/v1/biomarkers/{id}/biomarker_sample_coverage | Human sample screening coverage (GDC) |
 | [**biomarkers_biomarker_sample_prevalence**](BiomarkersApi.md#biomarkers_biomarker_sample_prevalence) | **GET** /api/v1/biomarkers/{id}/biomarker_sample_prevalence | Human sample screening reference (GDC cohorts) |
+| [**biomarkers_biomarker_traversal_status**](BiomarkersApi.md#biomarkers_biomarker_traversal_status) | **GET** /api/v1/biomarkers/{id}/biomarker_traversal_status | Biomarker coverage by traversal |
 | [**biomarkers_biomarker_validation**](BiomarkersApi.md#biomarkers_biomarker_validation) | **GET** /api/v1/biomarkers/{id}/biomarker_validation | Biomarker validation ladder |
 | [**biomarkers_biomarker_variant_mentions**](BiomarkersApi.md#biomarkers_biomarker_variant_mentions) | **GET** /api/v1/biomarkers/{id}/biomarker_variant_mentions | Protein variant mentions |
 | [**biomarkers_get**](BiomarkersApi.md#biomarkers_get) | **GET** /api/v1/biomarkers/{id} | One biomarker |
 | [**biomarkers_list**](BiomarkersApi.md#biomarkers_list) | **GET** /api/v1/biomarkers | List biomarkers |
 
 
+## biomarkers_biomarker_allele_frequencies
+
+> <BiomarkerAlleleFrequenciesResponse> biomarkers_biomarker_allele_frequencies(id, opts)
+
+Population allele frequency of protein variants (gnomAD)
+
+### Examples
+
+```ruby
+require 'time'
+require 'pharmaobservatory'
+# setup authorization
+PharmaObservatory.configure do |config|
+  # Configure Bearer authorization (JWT): ApiBearerJwt
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = PharmaObservatory::BiomarkersApi.new
+id = 'ESR1' # String | 
+opts = {
+  cursor: 'cursor_example', # String | The next_cursor of the previous page. Opaque; it is bound to the filters and the warehouse build that issued it.
+  limit: 56, # Integer | Rows per page, up to 500 (default 50).
+  sort: 'sort_example', # String | Comma separated columns, a leading minus for descending: sort=a,-b.
+  group_by: 'group_by_example', # String | A dimension to group by; a date takes :year, :quarter or :month.
+  measure: 'measure_example' # String | count, sum(col), avg(col), min(col), max(col), median(col) or count_distinct(col).
+}
+
+begin
+  # Population allele frequency of protein variants (gnomAD)
+  result = api_instance.biomarkers_biomarker_allele_frequencies(id, opts)
+  p result
+rescue PharmaObservatory::ApiError => e
+  puts "Error when calling BiomarkersApi->biomarkers_biomarker_allele_frequencies: #{e}"
+end
+```
+
+#### Using the biomarkers_biomarker_allele_frequencies_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<BiomarkerAlleleFrequenciesResponse>, Integer, Hash)> biomarkers_biomarker_allele_frequencies_with_http_info(id, opts)
+
+```ruby
+begin
+  # Population allele frequency of protein variants (gnomAD)
+  data, status_code, headers = api_instance.biomarkers_biomarker_allele_frequencies_with_http_info(id, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <BiomarkerAlleleFrequenciesResponse>
+rescue PharmaObservatory::ApiError => e
+  puts "Error when calling BiomarkersApi->biomarkers_biomarker_allele_frequencies_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  |  |
+| **cursor** | **String** | The next_cursor of the previous page. Opaque; it is bound to the filters and the warehouse build that issued it. | [optional] |
+| **limit** | **Integer** | Rows per page, up to 500 (default 50). | [optional] |
+| **sort** | **String** | Comma separated columns, a leading minus for descending: sort&#x3D;a,-b. | [optional] |
+| **group_by** | **String** | A dimension to group by; a date takes :year, :quarter or :month. | [optional] |
+| **measure** | **String** | count, sum(col), avg(col), min(col), max(col), median(col) or count_distinct(col). | [optional] |
+
+### Return type
+
+[**BiomarkerAlleleFrequenciesResponse**](BiomarkerAlleleFrequenciesResponse.md)
+
+### Authorization
+
+[ApiBearerJwt](../README.md#ApiBearerJwt)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## biomarkers_biomarker_assay_evidence
 
 > <BiomarkerAssayEvidenceResponse> biomarkers_biomarker_assay_evidence(id, opts)
@@ -99,6 +182,85 @@ end
 - **Accept**: application/json
 
 
+## biomarkers_biomarker_assay_providers
+
+> <BiomarkerAssayProvidersResponse> biomarkers_biomarker_assay_providers(id, opts)
+
+Biomarker assay providers (from validating papers)
+
+### Examples
+
+```ruby
+require 'time'
+require 'pharmaobservatory'
+# setup authorization
+PharmaObservatory.configure do |config|
+  # Configure Bearer authorization (JWT): ApiBearerJwt
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = PharmaObservatory::BiomarkersApi.new
+id = 'ESR1' # String | 
+opts = {
+  cursor: 'cursor_example', # String | The next_cursor of the previous page. Opaque; it is bound to the filters and the warehouse build that issued it.
+  limit: 56, # Integer | Rows per page, up to 500 (default 50).
+  sort: 'sort_example', # String | Comma separated columns, a leading minus for descending: sort=a,-b.
+  group_by: 'group_by_example', # String | A dimension to group by; a date takes :year, :quarter or :month.
+  measure: 'measure_example' # String | count, sum(col), avg(col), min(col), max(col), median(col) or count_distinct(col).
+}
+
+begin
+  # Biomarker assay providers (from validating papers)
+  result = api_instance.biomarkers_biomarker_assay_providers(id, opts)
+  p result
+rescue PharmaObservatory::ApiError => e
+  puts "Error when calling BiomarkersApi->biomarkers_biomarker_assay_providers: #{e}"
+end
+```
+
+#### Using the biomarkers_biomarker_assay_providers_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<BiomarkerAssayProvidersResponse>, Integer, Hash)> biomarkers_biomarker_assay_providers_with_http_info(id, opts)
+
+```ruby
+begin
+  # Biomarker assay providers (from validating papers)
+  data, status_code, headers = api_instance.biomarkers_biomarker_assay_providers_with_http_info(id, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <BiomarkerAssayProvidersResponse>
+rescue PharmaObservatory::ApiError => e
+  puts "Error when calling BiomarkersApi->biomarkers_biomarker_assay_providers_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  |  |
+| **cursor** | **String** | The next_cursor of the previous page. Opaque; it is bound to the filters and the warehouse build that issued it. | [optional] |
+| **limit** | **Integer** | Rows per page, up to 500 (default 50). | [optional] |
+| **sort** | **String** | Comma separated columns, a leading minus for descending: sort&#x3D;a,-b. | [optional] |
+| **group_by** | **String** | A dimension to group by; a date takes :year, :quarter or :month. | [optional] |
+| **measure** | **String** | count, sum(col), avg(col), min(col), max(col), median(col) or count_distinct(col). | [optional] |
+
+### Return type
+
+[**BiomarkerAssayProvidersResponse**](BiomarkerAssayProvidersResponse.md)
+
+### Authorization
+
+[ApiBearerJwt](../README.md#ApiBearerJwt)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## biomarkers_biomarker_assay_whitespace
 
 > <BiomarkerAssayWhitespaceResponse> biomarkers_biomarker_assay_whitespace(id, opts)
@@ -415,6 +577,85 @@ end
 - **Accept**: application/json
 
 
+## biomarkers_biomarker_evidence_by_year
+
+> <BiomarkerEvidenceByYearResponse> biomarkers_biomarker_evidence_by_year(id, opts)
+
+Biomarker evidence by year (trial and publication mentions)
+
+### Examples
+
+```ruby
+require 'time'
+require 'pharmaobservatory'
+# setup authorization
+PharmaObservatory.configure do |config|
+  # Configure Bearer authorization (JWT): ApiBearerJwt
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = PharmaObservatory::BiomarkersApi.new
+id = 'ESR1' # String | 
+opts = {
+  cursor: 'cursor_example', # String | The next_cursor of the previous page. Opaque; it is bound to the filters and the warehouse build that issued it.
+  limit: 56, # Integer | Rows per page, up to 500 (default 50).
+  sort: 'sort_example', # String | Comma separated columns, a leading minus for descending: sort=a,-b.
+  group_by: 'group_by_example', # String | A dimension to group by; a date takes :year, :quarter or :month.
+  measure: 'measure_example' # String | count, sum(col), avg(col), min(col), max(col), median(col) or count_distinct(col).
+}
+
+begin
+  # Biomarker evidence by year (trial and publication mentions)
+  result = api_instance.biomarkers_biomarker_evidence_by_year(id, opts)
+  p result
+rescue PharmaObservatory::ApiError => e
+  puts "Error when calling BiomarkersApi->biomarkers_biomarker_evidence_by_year: #{e}"
+end
+```
+
+#### Using the biomarkers_biomarker_evidence_by_year_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<BiomarkerEvidenceByYearResponse>, Integer, Hash)> biomarkers_biomarker_evidence_by_year_with_http_info(id, opts)
+
+```ruby
+begin
+  # Biomarker evidence by year (trial and publication mentions)
+  data, status_code, headers = api_instance.biomarkers_biomarker_evidence_by_year_with_http_info(id, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <BiomarkerEvidenceByYearResponse>
+rescue PharmaObservatory::ApiError => e
+  puts "Error when calling BiomarkersApi->biomarkers_biomarker_evidence_by_year_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  |  |
+| **cursor** | **String** | The next_cursor of the previous page. Opaque; it is bound to the filters and the warehouse build that issued it. | [optional] |
+| **limit** | **Integer** | Rows per page, up to 500 (default 50). | [optional] |
+| **sort** | **String** | Comma separated columns, a leading minus for descending: sort&#x3D;a,-b. | [optional] |
+| **group_by** | **String** | A dimension to group by; a date takes :year, :quarter or :month. | [optional] |
+| **measure** | **String** | count, sum(col), avg(col), min(col), max(col), median(col) or count_distinct(col). | [optional] |
+
+### Return type
+
+[**BiomarkerEvidenceByYearResponse**](BiomarkerEvidenceByYearResponse.md)
+
+### Authorization
+
+[ApiBearerJwt](../README.md#ApiBearerJwt)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## biomarkers_biomarker_literature
 
 > <BiomarkerLiteratureResponse> biomarkers_biomarker_literature(id, opts)
@@ -810,6 +1051,85 @@ end
 - **Accept**: application/json
 
 
+## biomarkers_biomarker_traversal_status
+
+> <BiomarkerTraversalStatusResponse> biomarkers_biomarker_traversal_status(id, opts)
+
+Biomarker coverage by traversal
+
+### Examples
+
+```ruby
+require 'time'
+require 'pharmaobservatory'
+# setup authorization
+PharmaObservatory.configure do |config|
+  # Configure Bearer authorization (JWT): ApiBearerJwt
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = PharmaObservatory::BiomarkersApi.new
+id = 'ESR1' # String | 
+opts = {
+  cursor: 'cursor_example', # String | The next_cursor of the previous page. Opaque; it is bound to the filters and the warehouse build that issued it.
+  limit: 56, # Integer | Rows per page, up to 500 (default 50).
+  sort: 'sort_example', # String | Comma separated columns, a leading minus for descending: sort=a,-b.
+  group_by: 'group_by_example', # String | A dimension to group by; a date takes :year, :quarter or :month.
+  measure: 'measure_example' # String | count, sum(col), avg(col), min(col), max(col), median(col) or count_distinct(col).
+}
+
+begin
+  # Biomarker coverage by traversal
+  result = api_instance.biomarkers_biomarker_traversal_status(id, opts)
+  p result
+rescue PharmaObservatory::ApiError => e
+  puts "Error when calling BiomarkersApi->biomarkers_biomarker_traversal_status: #{e}"
+end
+```
+
+#### Using the biomarkers_biomarker_traversal_status_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<BiomarkerTraversalStatusResponse>, Integer, Hash)> biomarkers_biomarker_traversal_status_with_http_info(id, opts)
+
+```ruby
+begin
+  # Biomarker coverage by traversal
+  data, status_code, headers = api_instance.biomarkers_biomarker_traversal_status_with_http_info(id, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <BiomarkerTraversalStatusResponse>
+rescue PharmaObservatory::ApiError => e
+  puts "Error when calling BiomarkersApi->biomarkers_biomarker_traversal_status_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  |  |
+| **cursor** | **String** | The next_cursor of the previous page. Opaque; it is bound to the filters and the warehouse build that issued it. | [optional] |
+| **limit** | **Integer** | Rows per page, up to 500 (default 50). | [optional] |
+| **sort** | **String** | Comma separated columns, a leading minus for descending: sort&#x3D;a,-b. | [optional] |
+| **group_by** | **String** | A dimension to group by; a date takes :year, :quarter or :month. | [optional] |
+| **measure** | **String** | count, sum(col), avg(col), min(col), max(col), median(col) or count_distinct(col). | [optional] |
+
+### Return type
+
+[**BiomarkerTraversalStatusResponse**](BiomarkerTraversalStatusResponse.md)
+
+### Authorization
+
+[ApiBearerJwt](../README.md#ApiBearerJwt)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## biomarkers_biomarker_validation
 
 > <BiomarkerValidationResponse> biomarkers_biomarker_validation(id, opts)