ExpressionIntegrationAsCuratorApi¶
All URIs are relative to http://localhost
| Method | HTTP request | Description |
|---|---|---|
| CreateExpressionGroupCellGroupLinkAsCurator | POST /api/v1/as-curator/integration/link/expression/group/{sourceId}/to/cell/group/{targetId} | Create a link between a group of cell expression objects and a group of cell metadata. |
| CreateExpressionGroupLibraryGroupLinkAsCurator | POST /api/v1/as-curator/integration/link/expression/group/{sourceId}/to/library/group/{targetId} | Create a link between a group of expression objects and a group of library objects |
| CreateExpressionGroupPreparationGroupLinkAsCurator | POST /api/v1/as-curator/integration/link/expression/group/{sourceId}/to/preparation/group/{targetId} | Create a link between a group of expression objects and a group of preparation objects |
| CreateExpressionGroupSampleGroupLinkAsCurator | POST /api/v1/as-curator/integration/link/expression/group/{sourceId}/to/sample/group/{targetId} | Create a link between a group of expression objects and a group of sample objects |
| CreateExpressionLibraryLinkAsCurator | POST /api/v1/as-curator/integration/link/expression/{sourceId}/to/library/{targetId} | Create a link between an expression object and a library |
| CreateExpressionPreparationLinkAsCurator | POST /api/v1/as-curator/integration/link/expression/{sourceId}/to/preparation/{targetId} | Create a link between an expression object and a preparation |
| CreateExpressionSampleLinkAsCurator | POST /api/v1/as-curator/integration/link/expression/{sourceId}/to/sample/{targetId} | Create a link between an expression object and a sample |
| DeleteExpressionGroupLibraryGroupLinkAsCurator | DELETE /api/v1/as-curator/integration/link/expression/group/{sourceId}/to/library/group/{targetId} | Delete link between a group of expression objects and a group of library objects |
| DeleteExpressionGroupPreparationGroupLinkAsCurator | DELETE /api/v1/as-curator/integration/link/expression/group/{sourceId}/to/preparation/group/{targetId} | Delete link between a group of expression objects and a group of preparation objects |
| DeleteExpressionGroupSampleGroupLinkAsCurator | DELETE /api/v1/as-curator/integration/link/expression/group/{sourceId}/to/sample/group/{targetId} | Delete link between a group of expression objects and a group of sample objects |
| DeleteExpressionLibraryLinkAsCurator | DELETE /api/v1/as-curator/integration/link/expression/{sourceId}/to/library/{targetId} | Delete link between an expression object and a library |
| DeleteExpressionPreparationLinkAsCurator | DELETE /api/v1/as-curator/integration/link/expression/{sourceId}/to/preparation/{targetId} | Delete link between an expression object and a preparation |
| DeleteExpressionSampleLinkAsCurator | DELETE /api/v1/as-curator/integration/link/expression/{sourceId}/to/sample/{targetId} | Delete link between an expression object and a sample |
| GetExpressionByLibraryAsCurator | GET /api/v1/as-curator/integration/link/expression/by/library/{id} | Retrieve expression run-level data by querying related library ID (accession) |
| GetExpressionByPreparation | GET /api/v1/as-curator/integration/link/expression/by/preparation/{id} | Retrieve expression run-level data by querying related preparation ID (accession) |
| GetExpressionBySampleAsCurator | GET /api/v1/as-curator/integration/link/expression/by/sample/{id} | Retrieve expression run-level data by querying related sample ID (accession) |
| GetExpressionGroupsByStudyAsCurator | GET /api/v1/as-curator/integration/link/expression/group/by/study/{id} | Retrieve group metadata by querying study ID (accession) |
| GetExpressionRunToLibraryPairsAsCurator | GET /api/v1/as-curator/integration/link/expression/run-to-libraries/by/group/{id} | Retrieve run-library pairs by group id. Pagination is based on unique runs, not unique pairs. |
| GetExpressionRunToPreparationPairsAsCurator | GET /api/v1/as-curator/integration/link/expression/run-to-preparations/by/group/{id} | Retrieve run-preparation pairs by group id. Pagination is based on unique runs, not unique pairs. |
| GetExpressionRunToSamplePairsAsCurator | GET /api/v1/as-curator/integration/link/expression/run-to-samples/by/group/{id} | Retrieve run-sample pairs by group id. Pagination is based on unique runs, not unique pairs. |
CreateExpressionGroupCellGroupLinkAsCurator¶
CreateExpressionGroupCellGroupLinkAsCurator(source_id, target_id)
Create a link between a group of cell expression objects and a group of cell metadata.
Create a link between a group of cell expression objects and a group of cell metadata. A cell expression object can be linked to one cell metadata object only.
Example¶
library(odmApi)
# Create a link between a group of cell expression objects and a group of cell metadata.
#
# prepare function argument(s)
var_source_id <- "source_id_example" # character | The ID (accession) of the cell expression group object
var_target_id <- "target_id_example" # character | The ID (accession) of the cell metadata group object
api_instance <- ExpressionIntegrationAsCuratorApi$new()
# Configure API key authorization: Access-token
api_instance$api_client$api_keys["Authorization"] <- Sys.getenv("API_KEY")
# Configure API key authorization: Genestack-API-Token
# api_instance$api_client$api_keys["Genestack-API-Token"] <- Sys.getenv("API_KEY")
api_instance$CreateExpressionGroupCellGroupLinkAsCurator(var_source_id, var_target_id)
Parameters¶
| Name | Type | Description | Notes |
|---|---|---|---|
| source_id | character | The ID (accession) of the cell expression group object | |
| target_id | character | The ID (accession) of the cell metadata group object |
Return type¶
void (empty response body)
Authorization¶
Access-token, Genestack-API-Token
HTTP request headers¶
- Content-Type: Not defined
- Accept: Not defined
HTTP response details¶
| Status code | Description | Response headers |
|---|---|---|
| 200 | Some (not all) cell links were created. | - |
| 204 | All links were created. | - |
| 400 | Incorrect Cell or Expression group provided, see error message for details. | - |
| 401 | User is not authenticated. Please supply a valid Access Token in the `Authorization` HTTP header (e.g. Authorization: bearer [token]) or Genestack API token in the `Genestack-API-Token` header (this token may be obtained from the Genestack UI Profile page). | - |
| 500 | An internal server error occurred. This indicates an unexpected failure in the Genestack system, please file a bug report to support@genestack.com, including the error details. | - |
CreateExpressionGroupLibraryGroupLinkAsCurator¶
CreateExpressionGroupLibraryGroupLinkAsCurator(source_id, target_id)
Create a link between a group of expression objects and a group of library objects
Create a link between a group of expression objects and a group of library objects. An expression object can be linked to one object only. If an expression object is already linked to another object, this link will be deleted and a new link with the specified object will be created. Expression objects of the same group can only be linked to objects of the same study.
Example¶
library(odmApi)
# Create a link between a group of expression objects and a group of library objects
#
# prepare function argument(s)
var_source_id <- "source_id_example" # character | The ID (accession) of the group of run-level objects (corresponding to a GCT file)
var_target_id <- "target_id_example" # character | The ID (accession) of the library group object
api_instance <- ExpressionIntegrationAsCuratorApi$new()
# Configure API key authorization: Access-token
api_instance$api_client$api_keys["Authorization"] <- Sys.getenv("API_KEY")
# Configure API key authorization: Genestack-API-Token
# api_instance$api_client$api_keys["Genestack-API-Token"] <- Sys.getenv("API_KEY")
api_instance$CreateExpressionGroupLibraryGroupLinkAsCurator(var_source_id, var_target_id)
Parameters¶
| Name | Type | Description | Notes |
|---|---|---|---|
| source_id | character | The ID (accession) of the group of run-level objects (corresponding to a GCT file) | |
| target_id | character | The ID (accession) of the library group object |
Return type¶
void (empty response body)
Authorization¶
Access-token, Genestack-API-Token
HTTP request headers¶
- Content-Type: Not defined
- Accept: Not defined
HTTP response details¶
| Status code | Description | Response headers |
|---|---|---|
| 200 | Some (not all) sample links created. | - |
| 204 | Link created. | - |
| 400 | Library group, signal group or libraries to link not found | - |
| 401 | User is not authenticated. Please supply a valid Access Token in the `Authorization` HTTP header (e.g. Authorization: bearer [token]) or Genestack API token in the `Genestack-API-Token` header (this token may be obtained from the Genestack UI Profile page). | - |
| 500 | An internal server error occurred. This indicates an unexpected failure in the Genestack system, please file a bug report to support@genestack.com, including the error details. | - |
CreateExpressionGroupPreparationGroupLinkAsCurator¶
CreateExpressionGroupPreparationGroupLinkAsCurator(source_id, target_id)
Create a link between a group of expression objects and a group of preparation objects
Create a link between a group of expression objects and a group of preparation objects. An expression object can be linked to one object only. If an expression object is already linked to another object, this link will be deleted and a new link with the specified object will be created. Expression objects of the same group can only be linked to objects of the same study.
Example¶
library(odmApi)
# Create a link between a group of expression objects and a group of preparation objects
#
# prepare function argument(s)
var_source_id <- "source_id_example" # character | The ID (accession) of the group of run-level objects (corresponding to a GCT file)
var_target_id <- "target_id_example" # character | The ID (accession) of the preparation group object
api_instance <- ExpressionIntegrationAsCuratorApi$new()
# Configure API key authorization: Access-token
api_instance$api_client$api_keys["Authorization"] <- Sys.getenv("API_KEY")
# Configure API key authorization: Genestack-API-Token
# api_instance$api_client$api_keys["Genestack-API-Token"] <- Sys.getenv("API_KEY")
api_instance$CreateExpressionGroupPreparationGroupLinkAsCurator(var_source_id, var_target_id)
Parameters¶
| Name | Type | Description | Notes |
|---|---|---|---|
| source_id | character | The ID (accession) of the group of run-level objects (corresponding to a GCT file) | |
| target_id | character | The ID (accession) of the preparation group object |
Return type¶
void (empty response body)
Authorization¶
Access-token, Genestack-API-Token
HTTP request headers¶
- Content-Type: Not defined
- Accept: Not defined
HTTP response details¶
| Status code | Description | Response headers |
|---|---|---|
| 200 | Some (not all) sample links created. | - |
| 204 | Link created. | - |
| 400 | Preparation group, signal group or preparations to link not found | - |
| 401 | User is not authenticated. Please supply a valid Access Token in the `Authorization` HTTP header (e.g. Authorization: bearer [token]) or Genestack API token in the `Genestack-API-Token` header (this token may be obtained from the Genestack UI Profile page). | - |
| 500 | An internal server error occurred. This indicates an unexpected failure in the Genestack system, please file a bug report to support@genestack.com, including the error details. | - |
CreateExpressionGroupSampleGroupLinkAsCurator¶
CreateExpressionGroupSampleGroupLinkAsCurator(source_id, target_id, linking_attribute = var.linking_attribute)
Create a link between a group of expression objects and a group of sample objects
Create a link between a group of expression objects and a group of sample objects. An expression object can be linked to one object only. If an expression object is already linked to another object, this link will be deleted and a new link with the specified object will be created. Expression objects of the same group can only be linked to objects of the same study. Users can specify a custom metadata field for linking omics data to samples via the “linkingAttribute” parameter, if not specified the “Sample Source ID“ sample metadata attribute will be used by default.
Example¶
library(odmApi)
# Create a link between a group of expression objects and a group of sample objects
#
# prepare function argument(s)
var_source_id <- "source_id_example" # character | The ID (accession) of the group of run-level objects (corresponding to a GCT file)
var_target_id <- "target_id_example" # character | The ID (accession) of the sample group object
var_linking_attribute <- "linking_attribute_example" # character | Metadata field containing sample IDs to link omics data to samples. The template applied to the study must contain this field in the sample section. (Optional)
api_instance <- ExpressionIntegrationAsCuratorApi$new()
# Configure API key authorization: Access-token
api_instance$api_client$api_keys["Authorization"] <- Sys.getenv("API_KEY")
# Configure API key authorization: Genestack-API-Token
# api_instance$api_client$api_keys["Genestack-API-Token"] <- Sys.getenv("API_KEY")
api_instance$CreateExpressionGroupSampleGroupLinkAsCurator(var_source_id, var_target_id, linking_attribute = var_linking_attribute)
Parameters¶
| Name | Type | Description | Notes |
|---|---|---|---|
| source_id | character | The ID (accession) of the group of run-level objects (corresponding to a GCT file) | |
| target_id | character | The ID (accession) of the sample group object | |
| linking_attribute | character | Metadata field containing sample IDs to link omics data to samples. The template applied to the study must contain this field in the sample section. | [optional] |
Return type¶
void (empty response body)
Authorization¶
Access-token, Genestack-API-Token
HTTP request headers¶
- Content-Type: Not defined
- Accept: Not defined
HTTP response details¶
| Status code | Description | Response headers |
|---|---|---|
| 200 | Not all signal data were linked to the samples. | - |
| 204 | All signal data were linked to the samples from the specified sample group. | - |
| 400 | Sample group, signal group or samples to the link were not found, or the specified linking attribute was not found. | - |
| 401 | User is not authenticated. Please supply a valid Access Token in the `Authorization` HTTP header (e.g. Authorization: bearer [token]) or Genestack API token in the `Genestack-API-Token` header (this token may be obtained from the Genestack UI Profile page). | - |
| 500 | An internal server error occurred. This indicates an unexpected failure in the Genestack system, please file a bug report to support@genestack.com, including the error details. | - |
CreateExpressionLibraryLinkAsCurator¶
CreateExpressionLibraryLinkAsCurator(source_id, target_id)
Create a link between an expression object and a library
Create a link between an expression object and a library. An expression object can be linked to one object only. If an expression object is already linked to another object, this link will be deleted and a new link with the specified object will be created. Expression objects of the same group can only be linked to objects of the same study.
Example¶
library(odmApi)
# Create a link between an expression object and a library
#
# prepare function argument(s)
var_source_id <- "source_id_example" # character | The ID (accession) of the run-level object (corresponding to the column in a VCG/GCT file)
var_target_id <- "target_id_example" # character | The ID (accession) of the library object
api_instance <- ExpressionIntegrationAsCuratorApi$new()
# Configure API key authorization: Access-token
api_instance$api_client$api_keys["Authorization"] <- Sys.getenv("API_KEY")
# Configure API key authorization: Genestack-API-Token
# api_instance$api_client$api_keys["Genestack-API-Token"] <- Sys.getenv("API_KEY")
api_instance$CreateExpressionLibraryLinkAsCurator(var_source_id, var_target_id)
Parameters¶
| Name | Type | Description | Notes |
|---|---|---|---|
| source_id | character | The ID (accession) of the run-level object (corresponding to the column in a VCG/GCT file) | |
| target_id | character | The ID (accession) of the library object |
Return type¶
void (empty response body)
Authorization¶
Access-token, Genestack-API-Token
HTTP request headers¶
- Content-Type: Not defined
- Accept: Not defined
HTTP response details¶
| Status code | Description | Response headers |
|---|---|---|
| 204 | Link created. | - |
| 400 | Link cannot be created. | - |
| 401 | User is not authenticated. Please supply a valid Access Token in the `Authorization` HTTP header (e.g. Authorization: bearer [token]) or Genestack API token in the `Genestack-API-Token` header (this token may be obtained from the Genestack UI Profile page). | - |
| 500 | An internal server error occurred. This indicates an unexpected failure in the Genestack system, please file a bug report to support@genestack.com, including the error details. | - |
CreateExpressionPreparationLinkAsCurator¶
CreateExpressionPreparationLinkAsCurator(source_id, target_id)
Create a link between an expression object and a preparation
Create a link between an expression object and a preparation. An expression object can be linked to one object only. If an expression object is already linked to another object, this link will be deleted and a new link with the specified object will be created. Expression objects of the same group can only be linked to objects of the same study.
Example¶
library(odmApi)
# Create a link between an expression object and a preparation
#
# prepare function argument(s)
var_source_id <- "source_id_example" # character | The ID (accession) of the run-level object (corresponding to the column in a VCG/GCT file)
var_target_id <- "target_id_example" # character | The ID (accession) of the preparation object
api_instance <- ExpressionIntegrationAsCuratorApi$new()
# Configure API key authorization: Access-token
api_instance$api_client$api_keys["Authorization"] <- Sys.getenv("API_KEY")
# Configure API key authorization: Genestack-API-Token
# api_instance$api_client$api_keys["Genestack-API-Token"] <- Sys.getenv("API_KEY")
api_instance$CreateExpressionPreparationLinkAsCurator(var_source_id, var_target_id)
Parameters¶
| Name | Type | Description | Notes |
|---|---|---|---|
| source_id | character | The ID (accession) of the run-level object (corresponding to the column in a VCG/GCT file) | |
| target_id | character | The ID (accession) of the preparation object |
Return type¶
void (empty response body)
Authorization¶
Access-token, Genestack-API-Token
HTTP request headers¶
- Content-Type: Not defined
- Accept: Not defined
HTTP response details¶
| Status code | Description | Response headers |
|---|---|---|
| 204 | Link created. | - |
| 400 | Link cannot be created. | - |
| 401 | User is not authenticated. Please supply a valid Access Token in the `Authorization` HTTP header (e.g. Authorization: bearer [token]) or Genestack API token in the `Genestack-API-Token` header (this token may be obtained from the Genestack UI Profile page). | - |
| 500 | An internal server error occurred. This indicates an unexpected failure in the Genestack system, please file a bug report to support@genestack.com, including the error details. | - |
CreateExpressionSampleLinkAsCurator¶
CreateExpressionSampleLinkAsCurator(source_id, target_id)
Create a link between an expression object and a sample
Create a link between an expression object and a sample. An expression object can be linked to one object only. If an expression object is already linked to another object, this link will be deleted and a new link with the specified object will be created. Expression objects of the same group can only be linked to objects of the same study.
Example¶
library(odmApi)
# Create a link between an expression object and a sample
#
# prepare function argument(s)
var_source_id <- "source_id_example" # character | The ID (accession) of the run-level object (corresponding to the column in a VCG/GCT file)
var_target_id <- "target_id_example" # character | The ID (accession) of the sample object
api_instance <- ExpressionIntegrationAsCuratorApi$new()
# Configure API key authorization: Access-token
api_instance$api_client$api_keys["Authorization"] <- Sys.getenv("API_KEY")
# Configure API key authorization: Genestack-API-Token
# api_instance$api_client$api_keys["Genestack-API-Token"] <- Sys.getenv("API_KEY")
api_instance$CreateExpressionSampleLinkAsCurator(var_source_id, var_target_id)
Parameters¶
| Name | Type | Description | Notes |
|---|---|---|---|
| source_id | character | The ID (accession) of the run-level object (corresponding to the column in a VCG/GCT file) | |
| target_id | character | The ID (accession) of the sample object |
Return type¶
void (empty response body)
Authorization¶
Access-token, Genestack-API-Token
HTTP request headers¶
- Content-Type: Not defined
- Accept: Not defined
HTTP response details¶
| Status code | Description | Response headers |
|---|---|---|
| 204 | Link created. | - |
| 400 | Link cannot be created. | - |
| 401 | User is not authenticated. Please supply a valid Access Token in the `Authorization` HTTP header (e.g. Authorization: bearer [token]) or Genestack API token in the `Genestack-API-Token` header (this token may be obtained from the Genestack UI Profile page). | - |
| 500 | An internal server error occurred. This indicates an unexpected failure in the Genestack system, please file a bug report to support@genestack.com, including the error details. | - |
DeleteExpressionGroupLibraryGroupLinkAsCurator¶
DeleteExpressionGroupLibraryGroupLinkAsCurator(source_id, target_id)
Delete link between a group of expression objects and a group of library objects
Delete link between a group of expression objects and a group of library objects
Example¶
library(odmApi)
# Delete link between a group of expression objects and a group of library objects
#
# prepare function argument(s)
var_source_id <- "source_id_example" # character | The ID (accession) of the group of run-level objects (corresponding to a GCT file)
var_target_id <- "target_id_example" # character | The ID (accession) of the library group object
api_instance <- ExpressionIntegrationAsCuratorApi$new()
# Configure API key authorization: Access-token
api_instance$api_client$api_keys["Authorization"] <- Sys.getenv("API_KEY")
# Configure API key authorization: Genestack-API-Token
# api_instance$api_client$api_keys["Genestack-API-Token"] <- Sys.getenv("API_KEY")
api_instance$DeleteExpressionGroupLibraryGroupLinkAsCurator(var_source_id, var_target_id)
Parameters¶
| Name | Type | Description | Notes |
|---|---|---|---|
| source_id | character | The ID (accession) of the group of run-level objects (corresponding to a GCT file) | |
| target_id | character | The ID (accession) of the library group object |
Return type¶
void (empty response body)
Authorization¶
Access-token, Genestack-API-Token
HTTP request headers¶
- Content-Type: Not defined
- Accept: Not defined
HTTP response details¶
| Status code | Description | Response headers |
|---|---|---|
| 204 | Link deleted. | - |
| 400 | Link cannot be deleted. | - |
| 401 | User is not authenticated. Please supply a valid Access Token in the `Authorization` HTTP header (e.g. Authorization: bearer [token]) or Genestack API token in the `Genestack-API-Token` header (this token may be obtained from the Genestack UI Profile page). | - |
| 500 | An internal server error occurred. This indicates an unexpected failure in the Genestack system, please file a bug report to support@genestack.com, including the error details. | - |
DeleteExpressionGroupPreparationGroupLinkAsCurator¶
DeleteExpressionGroupPreparationGroupLinkAsCurator(source_id, target_id)
Delete link between a group of expression objects and a group of preparation objects
Delete link between a group of expression objects and a group of preparation objects
Example¶
library(odmApi)
# Delete link between a group of expression objects and a group of preparation objects
#
# prepare function argument(s)
var_source_id <- "source_id_example" # character | The ID (accession) of the group of run-level objects (corresponding to a GCT file)
var_target_id <- "target_id_example" # character | The ID (accession) of the preparation group object
api_instance <- ExpressionIntegrationAsCuratorApi$new()
# Configure API key authorization: Access-token
api_instance$api_client$api_keys["Authorization"] <- Sys.getenv("API_KEY")
# Configure API key authorization: Genestack-API-Token
# api_instance$api_client$api_keys["Genestack-API-Token"] <- Sys.getenv("API_KEY")
api_instance$DeleteExpressionGroupPreparationGroupLinkAsCurator(var_source_id, var_target_id)
Parameters¶
| Name | Type | Description | Notes |
|---|---|---|---|
| source_id | character | The ID (accession) of the group of run-level objects (corresponding to a GCT file) | |
| target_id | character | The ID (accession) of the preparation group object |
Return type¶
void (empty response body)
Authorization¶
Access-token, Genestack-API-Token
HTTP request headers¶
- Content-Type: Not defined
- Accept: Not defined
HTTP response details¶
| Status code | Description | Response headers |
|---|---|---|
| 204 | Link deleted. | - |
| 400 | Link cannot be deleted. | - |
| 401 | User is not authenticated. Please supply a valid Access Token in the `Authorization` HTTP header (e.g. Authorization: bearer [token]) or Genestack API token in the `Genestack-API-Token` header (this token may be obtained from the Genestack UI Profile page). | - |
| 500 | An internal server error occurred. This indicates an unexpected failure in the Genestack system, please file a bug report to support@genestack.com, including the error details. | - |
DeleteExpressionGroupSampleGroupLinkAsCurator¶
DeleteExpressionGroupSampleGroupLinkAsCurator(source_id, target_id)
Delete link between a group of expression objects and a group of sample objects
Delete link between a group of expression objects and a group of sample objects
Example¶
library(odmApi)
# Delete link between a group of expression objects and a group of sample objects
#
# prepare function argument(s)
var_source_id <- "source_id_example" # character | The ID (accession) of the group of run-level objects (corresponding to a GCT file)
var_target_id <- "target_id_example" # character | The ID (accession) of the sample group object
api_instance <- ExpressionIntegrationAsCuratorApi$new()
# Configure API key authorization: Access-token
api_instance$api_client$api_keys["Authorization"] <- Sys.getenv("API_KEY")
# Configure API key authorization: Genestack-API-Token
# api_instance$api_client$api_keys["Genestack-API-Token"] <- Sys.getenv("API_KEY")
api_instance$DeleteExpressionGroupSampleGroupLinkAsCurator(var_source_id, var_target_id)
Parameters¶
| Name | Type | Description | Notes |
|---|---|---|---|
| source_id | character | The ID (accession) of the group of run-level objects (corresponding to a GCT file) | |
| target_id | character | The ID (accession) of the sample group object |
Return type¶
void (empty response body)
Authorization¶
Access-token, Genestack-API-Token
HTTP request headers¶
- Content-Type: Not defined
- Accept: Not defined
HTTP response details¶
| Status code | Description | Response headers |
|---|---|---|
| 204 | Link deleted. | - |
| 400 | Link cannot be deleted. | - |
| 401 | User is not authenticated. Please supply a valid Access Token in the `Authorization` HTTP header (e.g. Authorization: bearer [token]) or Genestack API token in the `Genestack-API-Token` header (this token may be obtained from the Genestack UI Profile page). | - |
| 500 | An internal server error occurred. This indicates an unexpected failure in the Genestack system, please file a bug report to support@genestack.com, including the error details. | - |
DeleteExpressionLibraryLinkAsCurator¶
DeleteExpressionLibraryLinkAsCurator(source_id, target_id)
Delete link between an expression object and a library
Delete link between an expression object and a library
Example¶
library(odmApi)
# Delete link between an expression object and a library
#
# prepare function argument(s)
var_source_id <- "source_id_example" # character | The ID (accession) of the run-level object (corresponding to the column in a VCG/GCT file)
var_target_id <- "target_id_example" # character | The ID (accession) of the library object
api_instance <- ExpressionIntegrationAsCuratorApi$new()
# Configure API key authorization: Access-token
api_instance$api_client$api_keys["Authorization"] <- Sys.getenv("API_KEY")
# Configure API key authorization: Genestack-API-Token
# api_instance$api_client$api_keys["Genestack-API-Token"] <- Sys.getenv("API_KEY")
api_instance$DeleteExpressionLibraryLinkAsCurator(var_source_id, var_target_id)
Parameters¶
| Name | Type | Description | Notes |
|---|---|---|---|
| source_id | character | The ID (accession) of the run-level object (corresponding to the column in a VCG/GCT file) | |
| target_id | character | The ID (accession) of the library object |
Return type¶
void (empty response body)
Authorization¶
Access-token, Genestack-API-Token
HTTP request headers¶
- Content-Type: Not defined
- Accept: Not defined
HTTP response details¶
| Status code | Description | Response headers |
|---|---|---|
| 204 | Link deleted. | - |
| 400 | Link cannot be deleted. | - |
| 401 | User is not authenticated. Please supply a valid Access Token in the `Authorization` HTTP header (e.g. Authorization: bearer [token]) or Genestack API token in the `Genestack-API-Token` header (this token may be obtained from the Genestack UI Profile page). | - |
| 500 | An internal server error occurred. This indicates an unexpected failure in the Genestack system, please file a bug report to support@genestack.com, including the error details. | - |
DeleteExpressionPreparationLinkAsCurator¶
DeleteExpressionPreparationLinkAsCurator(source_id, target_id)
Delete link between an expression object and a preparation
Delete link between an expression object and a preparation
Example¶
library(odmApi)
# Delete link between an expression object and a preparation
#
# prepare function argument(s)
var_source_id <- "source_id_example" # character | The ID (accession) of the run-level object (corresponding to the column in a VCG/GCT file)
var_target_id <- "target_id_example" # character | The ID (accession) of the preparation object
api_instance <- ExpressionIntegrationAsCuratorApi$new()
# Configure API key authorization: Access-token
api_instance$api_client$api_keys["Authorization"] <- Sys.getenv("API_KEY")
# Configure API key authorization: Genestack-API-Token
# api_instance$api_client$api_keys["Genestack-API-Token"] <- Sys.getenv("API_KEY")
api_instance$DeleteExpressionPreparationLinkAsCurator(var_source_id, var_target_id)
Parameters¶
| Name | Type | Description | Notes |
|---|---|---|---|
| source_id | character | The ID (accession) of the run-level object (corresponding to the column in a VCG/GCT file) | |
| target_id | character | The ID (accession) of the preparation object |
Return type¶
void (empty response body)
Authorization¶
Access-token, Genestack-API-Token
HTTP request headers¶
- Content-Type: Not defined
- Accept: Not defined
HTTP response details¶
| Status code | Description | Response headers |
|---|---|---|
| 204 | Link deleted. | - |
| 400 | Link cannot be deleted. | - |
| 401 | User is not authenticated. Please supply a valid Access Token in the `Authorization` HTTP header (e.g. Authorization: bearer [token]) or Genestack API token in the `Genestack-API-Token` header (this token may be obtained from the Genestack UI Profile page). | - |
| 500 | An internal server error occurred. This indicates an unexpected failure in the Genestack system, please file a bug report to support@genestack.com, including the error details. | - |
DeleteExpressionSampleLinkAsCurator¶
DeleteExpressionSampleLinkAsCurator(source_id, target_id)
Delete link between an expression object and a sample
Delete link between an expression object and a sample
Example¶
library(odmApi)
# Delete link between an expression object and a sample
#
# prepare function argument(s)
var_source_id <- "source_id_example" # character | The ID (accession) of the run-level object (corresponding to the column in a VCG/GCT file)
var_target_id <- "target_id_example" # character | The ID (accession) of the sample object
api_instance <- ExpressionIntegrationAsCuratorApi$new()
# Configure API key authorization: Access-token
api_instance$api_client$api_keys["Authorization"] <- Sys.getenv("API_KEY")
# Configure API key authorization: Genestack-API-Token
# api_instance$api_client$api_keys["Genestack-API-Token"] <- Sys.getenv("API_KEY")
api_instance$DeleteExpressionSampleLinkAsCurator(var_source_id, var_target_id)
Parameters¶
| Name | Type | Description | Notes |
|---|---|---|---|
| source_id | character | The ID (accession) of the run-level object (corresponding to the column in a VCG/GCT file) | |
| target_id | character | The ID (accession) of the sample object |
Return type¶
void (empty response body)
Authorization¶
Access-token, Genestack-API-Token
HTTP request headers¶
- Content-Type: Not defined
- Accept: Not defined
HTTP response details¶
| Status code | Description | Response headers |
|---|---|---|
| 204 | Link deleted. | - |
| 400 | Link cannot be deleted. | - |
| 401 | User is not authenticated. Please supply a valid Access Token in the `Authorization` HTTP header (e.g. Authorization: bearer [token]) or Genestack API token in the `Genestack-API-Token` header (this token may be obtained from the Genestack UI Profile page). | - |
| 500 | An internal server error occurred. This indicates an unexpected failure in the Genestack system, please file a bug report to support@genestack.com, including the error details. | - |
GetExpressionByLibraryAsCurator¶
ListResponse GetExpressionByLibraryAsCurator(id, response_format = var.response_format, page_limit = var.page_limit, page_offset = var.page_offset, use_versions = var.use_versions, returned_metadata_fields = var.returned_metadata_fields)
Retrieve expression run-level data by querying related library ID (accession)
Versioning Specific versions of omics data files (eg. GCT) can be queried via the useVersions parameter. Different versions of an omics data file are associated via their CHAIN_ID metadata value. This CHAIN_ID can be supplied to the useVersions parameter along with the version number or specific omics data file accessions to include them in the query. If nothing is supplied to the useVersions parameter then only the active version (which is usually the last one imported) is queried. This acts as a filter before the rest of the query is carried out. Example usage: useVersions=* (query all versions, including those without CHAIN_IDs) useVersions=v2 (query the second version. If there is no second version then the data file is not queried) useVersions=v1,v0 (query the first version and any data files without CHAIN_IDs(v0) ) useVersions=GSVC002:v3 (for omics data files with a CHAIN_ID of GSCV002 query the third version) useVersions=GSVC002:GSF00494,GSF000496 (for omics data files with a CHAIN_ID of GSCV002 query only the specific accessions GSF00494 and GSF000496) Rules for multiple CHAIN_IDs can be supplied to the parameter using the ; separator. ## Paging For performance reasons this endpoint returns results in \"pages\" of limited size. In order to retrieve all matching results the client needs to request multiple pages starting from an offset to the first result. You can do this using the pageOffset query parameter. A value of 0 (the default) instructs the server to return the first page of results, 100 would return a page of results starting from the 101st result and so on. To retrieve all results, iterate through pages using pageOffset values of n * pageLimit until a page returns fewer results than the page limit, which indicates there are no more results.¶
Example¶
library(odmApi)
# Retrieve expression run-level data by querying related library ID (accession)
#
# prepare function argument(s)
var_id <- "id_example" # character | Unique identifier (accession) of the object.
var_response_format <- ResponseFormat$new() # ResponseFormat | Supply this parameter with the value `term_id` as part of the query to return extended information including IDs for values and dictionaries. (Optional)
var_page_limit <- 56 # integer | Maximum number of results to return. This value must be between 0 and 2000 (inclusive). (Optional)
var_page_offset <- 56 # integer | Show the page {pageOffset+1} results from the start of the results. E.g. 100 will show a page of results starting from the 101st result. The default value is 0. (Optional)
var_use_versions <- "use_versions_example" # character | Specify which versions of omics data files are used in the query. By default the active version is used. See Versioning above. Syntax: \\* or `v<version number>` or `<CHAIN_ID>`:`v<version number>` or `<CHAIN_ID>`:`<accession1,accession2,..>` (Optional)
var_returned_metadata_fields <- "returned_metadata_fields_example" # character | The parameter defines amount of metadata attributes to return: 1. `minimal_data` - return metadata attributes according to the default template. 2. `extended_data_included` - return metadata attributes according to applied template, if object doesn’t have applied template default template will be used. This is the default for User endpoints. 3. `original_data_included` - return all metadata attributes with values and null attributes, if they are present in the applied template. This is the default for Curator endpoints. (Optional)
api_instance <- ExpressionIntegrationAsCuratorApi$new()
# Configure API key authorization: Access-token
api_instance$api_client$api_keys["Authorization"] <- Sys.getenv("API_KEY")
# Configure API key authorization: Genestack-API-Token
# api_instance$api_client$api_keys["Genestack-API-Token"] <- Sys.getenv("API_KEY")
# to save the result into a file, simply add the optional `data_file` parameter, e.g.
# result <- api_instance$GetExpressionByLibraryAsCurator(var_id, response_format = var_response_format, page_limit = var_page_limit, page_offset = var_page_offset, use_versions = var_use_versions, returned_metadata_fields = var_returned_metadata_fieldsdata_file = "result.txt")
result <- api_instance$GetExpressionByLibraryAsCurator(var_id, response_format = var_response_format, page_limit = var_page_limit, page_offset = var_page_offset, use_versions = var_use_versions, returned_metadata_fields = var_returned_metadata_fields)
dput(result)
Parameters¶
| Name | Type | Description | Notes |
|---|---|---|---|
| id | character | Unique identifier (accession) of the object. | |
| response_format | ResponseFormat | Supply this parameter with the value `term_id` as part of the query to return extended information including IDs for values and dictionaries. | [optional] |
| page_limit | integer | Maximum number of results to return. This value must be between 0 and 2000 (inclusive). | [optional] |
| page_offset | integer | Show the page {pageOffset+1} results from the start of the results. E.g. 100 will show a page of results starting from the 101st result. The default value is 0. | [optional] |
| use_versions | character | Specify which versions of omics data files are used in the query. By default the active version is used. See Versioning above. Syntax: \* or `v<version number>` or `<CHAIN_ID>`:`v<version number>` or `<CHAIN_ID>`:`<accession1,accession2,..>` | [optional] |
| returned_metadata_fields | Enum [minimal_data, extended_data_included, original_data_included] | The parameter defines amount of metadata attributes to return: 1. `minimal_data` - return metadata attributes according to the default template. 2. `extended_data_included` - return metadata attributes according to applied template, if object doesn’t have applied template default template will be used. This is the default for User endpoints. 3. `original_data_included` - return all metadata attributes with values and null attributes, if they are present in the applied template. This is the default for Curator endpoints. | [optional] |
Return type¶
Authorization¶
Access-token, Genestack-API-Token
HTTP request headers¶
- Content-Type: Not defined
- Accept: application/json, text/tab-separated-values
HTTP response details¶
| Status code | Description | Response headers |
|---|---|---|
| 200 | The request was successful. The returned value is a list of objects. | - |
| 400 | Entities cannot be retrieved. | - |
| 401 | User is not authenticated. Please supply a valid Access Token in the `Authorization` HTTP header (e.g. Authorization: bearer [token]) or Genestack API token in the `Genestack-API-Token` header (this token may be obtained from the Genestack UI Profile page). | - |
| 500 | An internal server error occurred. This indicates an unexpected failure in the Genestack system, please file a bug report to support@genestack.com, including the error details. | - |
GetExpressionByPreparation¶
ListResponse GetExpressionByPreparation(id, response_format = var.response_format, page_limit = var.page_limit, page_offset = var.page_offset, use_versions = var.use_versions, returned_metadata_fields = var.returned_metadata_fields)
Retrieve expression run-level data by querying related preparation ID (accession)
Versioning Specific versions of omics data files (eg. GCT) can be queried via the useVersions parameter. Different versions of an omics data file are associated via their CHAIN_ID metadata value. This CHAIN_ID can be supplied to the useVersions parameter along with the version number or specific omics data file accessions to include them in the query. If nothing is supplied to the useVersions parameter then only the active version (which is usually the last one imported) is queried. This acts as a filter before the rest of the query is carried out. Example usage: useVersions=* (query all versions, including those without CHAIN_IDs) useVersions=v2 (query the second version. If there is no second version then the data file is not queried) useVersions=v1,v0 (query the first version and any data files without CHAIN_IDs(v0) ) useVersions=GSVC002:v3 (for omics data files with a CHAIN_ID of GSCV002 query the third version) useVersions=GSVC002:GSF00494,GSF000496 (for omics data files with a CHAIN_ID of GSCV002 query only the specific accessions GSF00494 and GSF000496) Rules for multiple CHAIN_IDs can be supplied to the parameter using the ; separator. ## Paging For performance reasons this endpoint returns results in \"pages\" of limited size. In order to retrieve all matching results the client needs to request multiple pages starting from an offset to the first result. You can do this using the pageOffset query parameter. A value of 0 (the default) instructs the server to return the first page of results, 100 would return a page of results starting from the 101st result and so on. To retrieve all results, iterate through pages using pageOffset values of n * pageLimit until a page returns fewer results than the page limit, which indicates there are no more results.¶
Example¶
library(odmApi)
# Retrieve expression run-level data by querying related preparation ID (accession)
#
# prepare function argument(s)
var_id <- "id_example" # character | Unique identifier (accession) of the object.
var_response_format <- ResponseFormat$new() # ResponseFormat | Supply this parameter with the value `term_id` as part of the query to return extended information including IDs for values and dictionaries. (Optional)
var_page_limit <- 56 # integer | Maximum number of results to return. This value must be between 0 and 2000 (inclusive). (Optional)
var_page_offset <- 56 # integer | Show the page {pageOffset+1} results from the start of the results. E.g. 100 will show a page of results starting from the 101st result. The default value is 0. (Optional)
var_use_versions <- "use_versions_example" # character | Specify which versions of omics data files are used in the query. By default the active version is used. See Versioning above. Syntax: \\* or `v<version number>` or `<CHAIN_ID>`:`v<version number>` or `<CHAIN_ID>`:`<accession1,accession2,..>` (Optional)
var_returned_metadata_fields <- "returned_metadata_fields_example" # character | The parameter defines amount of metadata attributes to return: 1. `minimal_data` - return metadata attributes according to the default template. 2. `extended_data_included` - return metadata attributes according to applied template, if object doesn’t have applied template default template will be used. This is the default for User endpoints. 3. `original_data_included` - return all metadata attributes with values and null attributes, if they are present in the applied template. This is the default for Curator endpoints. (Optional)
api_instance <- ExpressionIntegrationAsCuratorApi$new()
# Configure API key authorization: Access-token
api_instance$api_client$api_keys["Authorization"] <- Sys.getenv("API_KEY")
# Configure API key authorization: Genestack-API-Token
# api_instance$api_client$api_keys["Genestack-API-Token"] <- Sys.getenv("API_KEY")
# to save the result into a file, simply add the optional `data_file` parameter, e.g.
# result <- api_instance$GetExpressionByPreparation(var_id, response_format = var_response_format, page_limit = var_page_limit, page_offset = var_page_offset, use_versions = var_use_versions, returned_metadata_fields = var_returned_metadata_fieldsdata_file = "result.txt")
result <- api_instance$GetExpressionByPreparation(var_id, response_format = var_response_format, page_limit = var_page_limit, page_offset = var_page_offset, use_versions = var_use_versions, returned_metadata_fields = var_returned_metadata_fields)
dput(result)
Parameters¶
| Name | Type | Description | Notes |
|---|---|---|---|
| id | character | Unique identifier (accession) of the object. | |
| response_format | ResponseFormat | Supply this parameter with the value `term_id` as part of the query to return extended information including IDs for values and dictionaries. | [optional] |
| page_limit | integer | Maximum number of results to return. This value must be between 0 and 2000 (inclusive). | [optional] |
| page_offset | integer | Show the page {pageOffset+1} results from the start of the results. E.g. 100 will show a page of results starting from the 101st result. The default value is 0. | [optional] |
| use_versions | character | Specify which versions of omics data files are used in the query. By default the active version is used. See Versioning above. Syntax: \* or `v<version number>` or `<CHAIN_ID>`:`v<version number>` or `<CHAIN_ID>`:`<accession1,accession2,..>` | [optional] |
| returned_metadata_fields | Enum [minimal_data, extended_data_included, original_data_included] | The parameter defines amount of metadata attributes to return: 1. `minimal_data` - return metadata attributes according to the default template. 2. `extended_data_included` - return metadata attributes according to applied template, if object doesn’t have applied template default template will be used. This is the default for User endpoints. 3. `original_data_included` - return all metadata attributes with values and null attributes, if they are present in the applied template. This is the default for Curator endpoints. | [optional] |
Return type¶
Authorization¶
Access-token, Genestack-API-Token
HTTP request headers¶
- Content-Type: Not defined
- Accept: application/json, text/tab-separated-values
HTTP response details¶
| Status code | Description | Response headers |
|---|---|---|
| 200 | The request was successful. The returned value is a list of objects. | - |
| 400 | Entities cannot be retrieved. | - |
| 401 | User is not authenticated. Please supply a valid Access Token in the `Authorization` HTTP header (e.g. Authorization: bearer [token]) or Genestack API token in the `Genestack-API-Token` header (this token may be obtained from the Genestack UI Profile page). | - |
| 500 | An internal server error occurred. This indicates an unexpected failure in the Genestack system, please file a bug report to support@genestack.com, including the error details. | - |
GetExpressionBySampleAsCurator¶
ListResponse GetExpressionBySampleAsCurator(id, response_format = var.response_format, page_limit = var.page_limit, page_offset = var.page_offset, use_versions = var.use_versions, returned_metadata_fields = var.returned_metadata_fields)
Retrieve expression run-level data by querying related sample ID (accession)
Versioning Specific versions of omics data files (eg. GCT) can be queried via the useVersions parameter. Different versions of an omics data file are associated via their CHAIN_ID metadata value. This CHAIN_ID can be supplied to the useVersions parameter along with the version number or specific omics data file accessions to include them in the query. If nothing is supplied to the useVersions parameter then only the active version (which is usually the last one imported) is queried. This acts as a filter before the rest of the query is carried out. Example usage: useVersions=* (query all versions, including those without CHAIN_IDs) useVersions=v2 (query the second version. If there is no second version then the data file is not queried) useVersions=v1,v0 (query the first version and any data files without CHAIN_IDs(v0) ) useVersions=GSVC002:v3 (for omics data files with a CHAIN_ID of GSCV002 query the third version) useVersions=GSVC002:GSF00494,GSF000496 (for omics data files with a CHAIN_ID of GSCV002 query only the specific accessions GSF00494 and GSF000496) Rules for multiple CHAIN_IDs can be supplied to the parameter using the ; separator. ## Paging For performance reasons this endpoint returns results in \"pages\" of limited size. In order to retrieve all matching results the client needs to request multiple pages starting from an offset to the first result. You can do this using the pageOffset query parameter. A value of 0 (the default) instructs the server to return the first page of results, 100 would return a page of results starting from the 101st result and so on. To retrieve all results, iterate through pages using pageOffset values of n * pageLimit until a page returns fewer results than the page limit, which indicates there are no more results.¶
Example¶
library(odmApi)
# Retrieve expression run-level data by querying related sample ID (accession)
#
# prepare function argument(s)
var_id <- "id_example" # character | Unique identifier (accession) of the object.
var_response_format <- ResponseFormat$new() # ResponseFormat | Supply this parameter with the value `term_id` as part of the query to return extended information including IDs for values and dictionaries. (Optional)
var_page_limit <- 56 # integer | Maximum number of results to return. This value must be between 0 and 2000 (inclusive). (Optional)
var_page_offset <- 56 # integer | Show the page {pageOffset+1} results from the start of the results. E.g. 100 will show a page of results starting from the 101st result. The default value is 0. (Optional)
var_use_versions <- "use_versions_example" # character | Specify which versions of omics data files are used in the query. By default the active version is used. See Versioning above. Syntax: \\* or `v<version number>` or `<CHAIN_ID>`:`v<version number>` or `<CHAIN_ID>`:`<accession1,accession2,..>` (Optional)
var_returned_metadata_fields <- "returned_metadata_fields_example" # character | The parameter defines amount of metadata attributes to return: 1. `minimal_data` - return metadata attributes according to the default template. 2. `extended_data_included` - return metadata attributes according to applied template, if object doesn’t have applied template default template will be used. This is the default for User endpoints. 3. `original_data_included` - return all metadata attributes with values and null attributes, if they are present in the applied template. This is the default for Curator endpoints. (Optional)
api_instance <- ExpressionIntegrationAsCuratorApi$new()
# Configure API key authorization: Access-token
api_instance$api_client$api_keys["Authorization"] <- Sys.getenv("API_KEY")
# Configure API key authorization: Genestack-API-Token
# api_instance$api_client$api_keys["Genestack-API-Token"] <- Sys.getenv("API_KEY")
# to save the result into a file, simply add the optional `data_file` parameter, e.g.
# result <- api_instance$GetExpressionBySampleAsCurator(var_id, response_format = var_response_format, page_limit = var_page_limit, page_offset = var_page_offset, use_versions = var_use_versions, returned_metadata_fields = var_returned_metadata_fieldsdata_file = "result.txt")
result <- api_instance$GetExpressionBySampleAsCurator(var_id, response_format = var_response_format, page_limit = var_page_limit, page_offset = var_page_offset, use_versions = var_use_versions, returned_metadata_fields = var_returned_metadata_fields)
dput(result)
Parameters¶
| Name | Type | Description | Notes |
|---|---|---|---|
| id | character | Unique identifier (accession) of the object. | |
| response_format | ResponseFormat | Supply this parameter with the value `term_id` as part of the query to return extended information including IDs for values and dictionaries. | [optional] |
| page_limit | integer | Maximum number of results to return. This value must be between 0 and 2000 (inclusive). | [optional] |
| page_offset | integer | Show the page {pageOffset+1} results from the start of the results. E.g. 100 will show a page of results starting from the 101st result. The default value is 0. | [optional] |
| use_versions | character | Specify which versions of omics data files are used in the query. By default the active version is used. See Versioning above. Syntax: \* or `v<version number>` or `<CHAIN_ID>`:`v<version number>` or `<CHAIN_ID>`:`<accession1,accession2,..>` | [optional] |
| returned_metadata_fields | Enum [minimal_data, extended_data_included, original_data_included] | The parameter defines amount of metadata attributes to return: 1. `minimal_data` - return metadata attributes according to the default template. 2. `extended_data_included` - return metadata attributes according to applied template, if object doesn’t have applied template default template will be used. This is the default for User endpoints. 3. `original_data_included` - return all metadata attributes with values and null attributes, if they are present in the applied template. This is the default for Curator endpoints. | [optional] |
Return type¶
Authorization¶
Access-token, Genestack-API-Token
HTTP request headers¶
- Content-Type: Not defined
- Accept: application/json, text/tab-separated-values
HTTP response details¶
| Status code | Description | Response headers |
|---|---|---|
| 200 | The request was successful. The returned value is a list of objects. | - |
| 400 | Entities cannot be retrieved. | - |
| 401 | User is not authenticated. Please supply a valid Access Token in the `Authorization` HTTP header (e.g. Authorization: bearer [token]) or Genestack API token in the `Genestack-API-Token` header (this token may be obtained from the Genestack UI Profile page). | - |
| 500 | An internal server error occurred. This indicates an unexpected failure in the Genestack system, please file a bug report to support@genestack.com, including the error details. | - |
GetExpressionGroupsByStudyAsCurator¶
array[MetadataWithId] GetExpressionGroupsByStudyAsCurator(id, response_format = var.response_format, use_versions = var.use_versions, returned_metadata_fields = var.returned_metadata_fields)
Retrieve group metadata by querying study ID (accession)
Versioning Specific versions of omics data files (eg. GCT) can be queried via the useVersions parameter. Different versions of an omics data file are associated via their CHAIN_ID metadata value. This CHAIN_ID can be supplied to the useVersions parameter along with the version number or specific omics data file accessions to include them in the query. If nothing is supplied to the useVersions parameter then only the active version (which is usually the last one imported) is queried. This acts as a filter before the rest of the query is carried out. Example usage: useVersions=* (query all versions, including those without CHAIN_IDs) useVersions=v2 (query the second version. If there is no second version then the data file is not queried) useVersions=v1,v0 (query the first version and any data files without CHAIN_IDs(v0) ) useVersions=GSVC002:v3 (for omics data files with a CHAIN_ID of GSCV002 query the third version) useVersions=GSVC002:GSF00494,GSF000496 (for omics data files with a CHAIN_ID of GSCV002 query only the specific accessions GSF00494 and GSF000496) Rules for multiple CHAIN_IDs can be supplied to the parameter using the ; separator.¶
Example¶
library(odmApi)
# Retrieve group metadata by querying study ID (accession)
#
# prepare function argument(s)
var_id <- "id_example" # character | Unique identifier (accession) of the object.
var_response_format <- ResponseFormat$new() # ResponseFormat | Supply this parameter with the value `term_id` as part of the query to return extended information including IDs for values and dictionaries. (Optional)
var_use_versions <- "use_versions_example" # character | Specify which versions of omics data files are used in the query. By default the active version is used. See Versioning above. Syntax: \\* or `v<version number>` or `<CHAIN_ID>`:`v<version number>` or `<CHAIN_ID>`:`<accession1,accession2,..>` (Optional)
var_returned_metadata_fields <- "returned_metadata_fields_example" # character | The parameter defines amount of metadata attributes to return: 1. `minimal_data` - return metadata attributes according to the default template. 2. `extended_data_included` - return metadata attributes according to applied template, if object doesn’t have applied template default template will be used. This is the default for User endpoints. 3. `original_data_included` - return all metadata attributes with values and null attributes, if they are present in the applied template. This is the default for Curator endpoints. (Optional)
api_instance <- ExpressionIntegrationAsCuratorApi$new()
# Configure API key authorization: Access-token
api_instance$api_client$api_keys["Authorization"] <- Sys.getenv("API_KEY")
# Configure API key authorization: Genestack-API-Token
# api_instance$api_client$api_keys["Genestack-API-Token"] <- Sys.getenv("API_KEY")
# to save the result into a file, simply add the optional `data_file` parameter, e.g.
# result <- api_instance$GetExpressionGroupsByStudyAsCurator(var_id, response_format = var_response_format, use_versions = var_use_versions, returned_metadata_fields = var_returned_metadata_fieldsdata_file = "result.txt")
result <- api_instance$GetExpressionGroupsByStudyAsCurator(var_id, response_format = var_response_format, use_versions = var_use_versions, returned_metadata_fields = var_returned_metadata_fields)
dput(result)
Parameters¶
| Name | Type | Description | Notes |
|---|---|---|---|
| id | character | Unique identifier (accession) of the object. | |
| response_format | ResponseFormat | Supply this parameter with the value `term_id` as part of the query to return extended information including IDs for values and dictionaries. | [optional] |
| use_versions | character | Specify which versions of omics data files are used in the query. By default the active version is used. See Versioning above. Syntax: \* or `v<version number>` or `<CHAIN_ID>`:`v<version number>` or `<CHAIN_ID>`:`<accession1,accession2,..>` | [optional] |
| returned_metadata_fields | Enum [minimal_data, extended_data_included, original_data_included] | The parameter defines amount of metadata attributes to return: 1. `minimal_data` - return metadata attributes according to the default template. 2. `extended_data_included` - return metadata attributes according to applied template, if object doesn’t have applied template default template will be used. This is the default for User endpoints. 3. `original_data_included` - return all metadata attributes with values and null attributes, if they are present in the applied template. This is the default for Curator endpoints. | [optional] |
Return type¶
Authorization¶
Access-token, Genestack-API-Token
HTTP request headers¶
- Content-Type: Not defined
- Accept: application/json
HTTP response details¶
| Status code | Description | Response headers |
|---|---|---|
| 200 | The request was successful. The returned value is the object. | - |
| 400 | The supplied object ID is invalid. | - |
| 401 | User is not authenticated. Please supply a valid Access Token in the `Authorization` HTTP header (e.g. Authorization: bearer [token]) or Genestack API token in the `Genestack-API-Token` header (this token may be obtained from the Genestack UI Profile page). | - |
| 500 | An internal server error occurred. This indicates an unexpected failure in the Genestack system, please file a bug report to support@genestack.com, including the error details. | - |
GetExpressionRunToLibraryPairsAsCurator¶
ListResponse GetExpressionRunToLibraryPairsAsCurator(id, page_limit = var.page_limit, page_offset = var.page_offset)
Retrieve run-library pairs by group id. Pagination is based on unique runs, not unique pairs.
Paging For performance reasons this endpoint returns results in \"pages\" of limited size. In order to retrieve all matching results the client needs to request multiple pages starting from an offset to the first result. You can do this using the pageOffset query parameter. A value of 0 (the default) instructs the server to return the first page of results, 100 would return a page of results starting from the 101st result and so on. To retrieve all results, iterate through pages using pageOffset values of n * pageLimit until a page returns fewer results than the page limit, which indicates there are no more results.¶
Example¶
library(odmApi)
# Retrieve run-library pairs by group id. Pagination is based on unique runs, not unique pairs.
#
# prepare function argument(s)
var_id <- "id_example" # character | Unique identifier (accession) of the object.
var_page_limit <- 56 # integer | Maximum number of results to return. This value must be between 0 and 2000 (inclusive). (Optional)
var_page_offset <- 56 # integer | Show the page {pageOffset+1} results from the start of the results. E.g. 100 will show a page of results starting from the 101st result. The default value is 0. (Optional)
api_instance <- ExpressionIntegrationAsCuratorApi$new()
# Configure API key authorization: Access-token
api_instance$api_client$api_keys["Authorization"] <- Sys.getenv("API_KEY")
# Configure API key authorization: Genestack-API-Token
# api_instance$api_client$api_keys["Genestack-API-Token"] <- Sys.getenv("API_KEY")
# to save the result into a file, simply add the optional `data_file` parameter, e.g.
# result <- api_instance$GetExpressionRunToLibraryPairsAsCurator(var_id, page_limit = var_page_limit, page_offset = var_page_offsetdata_file = "result.txt")
result <- api_instance$GetExpressionRunToLibraryPairsAsCurator(var_id, page_limit = var_page_limit, page_offset = var_page_offset)
dput(result)
Parameters¶
| Name | Type | Description | Notes |
|---|---|---|---|
| id | character | Unique identifier (accession) of the object. | |
| page_limit | integer | Maximum number of results to return. This value must be between 0 and 2000 (inclusive). | [optional] |
| page_offset | integer | Show the page {pageOffset+1} results from the start of the results. E.g. 100 will show a page of results starting from the 101st result. The default value is 0. | [optional] |
Return type¶
Authorization¶
Access-token, Genestack-API-Token
HTTP request headers¶
- Content-Type: Not defined
- Accept: application/json
HTTP response details¶
| Status code | Description | Response headers |
|---|---|---|
| 200 | The request was successful. The returned value is a list of objects. | - |
| 400 | Entities cannot be retrieved. | - |
| 401 | User is not authenticated. Please supply a valid Access Token in the `Authorization` HTTP header (e.g. Authorization: bearer [token]) or Genestack API token in the `Genestack-API-Token` header (this token may be obtained from the Genestack UI Profile page). | - |
| 404 | No object exists with the given ID. | - |
| 500 | An internal server error occurred. This indicates an unexpected failure in the Genestack system, please file a bug report to support@genestack.com, including the error details. | - |
GetExpressionRunToPreparationPairsAsCurator¶
ListResponse GetExpressionRunToPreparationPairsAsCurator(id, page_limit = var.page_limit, page_offset = var.page_offset)
Retrieve run-preparation pairs by group id. Pagination is based on unique runs, not unique pairs.
Paging For performance reasons this endpoint returns results in \"pages\" of limited size. In order to retrieve all matching results the client needs to request multiple pages starting from an offset to the first result. You can do this using the pageOffset query parameter. A value of 0 (the default) instructs the server to return the first page of results, 100 would return a page of results starting from the 101st result and so on. To retrieve all results, iterate through pages using pageOffset values of n * pageLimit until a page returns fewer results than the page limit, which indicates there are no more results.¶
Example¶
library(odmApi)
# Retrieve run-preparation pairs by group id. Pagination is based on unique runs, not unique pairs.
#
# prepare function argument(s)
var_id <- "id_example" # character | Unique identifier (accession) of the object.
var_page_limit <- 56 # integer | Maximum number of results to return. This value must be between 0 and 2000 (inclusive). (Optional)
var_page_offset <- 56 # integer | Show the page {pageOffset+1} results from the start of the results. E.g. 100 will show a page of results starting from the 101st result. The default value is 0. (Optional)
api_instance <- ExpressionIntegrationAsCuratorApi$new()
# Configure API key authorization: Access-token
api_instance$api_client$api_keys["Authorization"] <- Sys.getenv("API_KEY")
# Configure API key authorization: Genestack-API-Token
# api_instance$api_client$api_keys["Genestack-API-Token"] <- Sys.getenv("API_KEY")
# to save the result into a file, simply add the optional `data_file` parameter, e.g.
# result <- api_instance$GetExpressionRunToPreparationPairsAsCurator(var_id, page_limit = var_page_limit, page_offset = var_page_offsetdata_file = "result.txt")
result <- api_instance$GetExpressionRunToPreparationPairsAsCurator(var_id, page_limit = var_page_limit, page_offset = var_page_offset)
dput(result)
Parameters¶
| Name | Type | Description | Notes |
|---|---|---|---|
| id | character | Unique identifier (accession) of the object. | |
| page_limit | integer | Maximum number of results to return. This value must be between 0 and 2000 (inclusive). | [optional] |
| page_offset | integer | Show the page {pageOffset+1} results from the start of the results. E.g. 100 will show a page of results starting from the 101st result. The default value is 0. | [optional] |
Return type¶
Authorization¶
Access-token, Genestack-API-Token
HTTP request headers¶
- Content-Type: Not defined
- Accept: application/json
HTTP response details¶
| Status code | Description | Response headers |
|---|---|---|
| 200 | The request was successful. The returned value is a list of objects. | - |
| 400 | Entities cannot be retrieved. | - |
| 401 | User is not authenticated. Please supply a valid Access Token in the `Authorization` HTTP header (e.g. Authorization: bearer [token]) or Genestack API token in the `Genestack-API-Token` header (this token may be obtained from the Genestack UI Profile page). | - |
| 404 | No object exists with the given ID. | - |
| 500 | An internal server error occurred. This indicates an unexpected failure in the Genestack system, please file a bug report to support@genestack.com, including the error details. | - |
GetExpressionRunToSamplePairsAsCurator¶
ListResponse GetExpressionRunToSamplePairsAsCurator(id, page_limit = var.page_limit, page_offset = var.page_offset)
Retrieve run-sample pairs by group id. Pagination is based on unique runs, not unique pairs.
Paging For performance reasons this endpoint returns results in \"pages\" of limited size. In order to retrieve all matching results the client needs to request multiple pages starting from an offset to the first result. You can do this using the pageOffset query parameter. A value of 0 (the default) instructs the server to return the first page of results, 100 would return a page of results starting from the 101st result and so on. To retrieve all results, iterate through pages using pageOffset values of n * pageLimit until a page returns fewer results than the page limit, which indicates there are no more results.¶
Example¶
library(odmApi)
# Retrieve run-sample pairs by group id. Pagination is based on unique runs, not unique pairs.
#
# prepare function argument(s)
var_id <- "id_example" # character | Unique identifier (accession) of the object.
var_page_limit <- 56 # integer | Maximum number of results to return. This value must be between 0 and 2000 (inclusive). (Optional)
var_page_offset <- 56 # integer | Show the page {pageOffset+1} results from the start of the results. E.g. 100 will show a page of results starting from the 101st result. The default value is 0. (Optional)
api_instance <- ExpressionIntegrationAsCuratorApi$new()
# Configure API key authorization: Access-token
api_instance$api_client$api_keys["Authorization"] <- Sys.getenv("API_KEY")
# Configure API key authorization: Genestack-API-Token
# api_instance$api_client$api_keys["Genestack-API-Token"] <- Sys.getenv("API_KEY")
# to save the result into a file, simply add the optional `data_file` parameter, e.g.
# result <- api_instance$GetExpressionRunToSamplePairsAsCurator(var_id, page_limit = var_page_limit, page_offset = var_page_offsetdata_file = "result.txt")
result <- api_instance$GetExpressionRunToSamplePairsAsCurator(var_id, page_limit = var_page_limit, page_offset = var_page_offset)
dput(result)
Parameters¶
| Name | Type | Description | Notes |
|---|---|---|---|
| id | character | Unique identifier (accession) of the object. | |
| page_limit | integer | Maximum number of results to return. This value must be between 0 and 2000 (inclusive). | [optional] |
| page_offset | integer | Show the page {pageOffset+1} results from the start of the results. E.g. 100 will show a page of results starting from the 101st result. The default value is 0. | [optional] |
Return type¶
Authorization¶
Access-token, Genestack-API-Token
HTTP request headers¶
- Content-Type: Not defined
- Accept: application/json
HTTP response details¶
| Status code | Description | Response headers |
|---|---|---|
| 200 | The request was successful. The returned value is a list of objects. | - |
| 400 | Entities cannot be retrieved. | - |
| 401 | User is not authenticated. Please supply a valid Access Token in the `Authorization` HTTP header (e.g. Authorization: bearer [token]) or Genestack API token in the `Genestack-API-Token` header (this token may be obtained from the Genestack UI Profile page). | - |
| 404 | No object exists with the given ID. | - |
| 500 | An internal server error occurred. This indicates an unexpected failure in the Genestack system, please file a bug report to support@genestack.com, including the error details. | - |