Skip to main content

hra-api-client

This API provides programmatic access to data registered to the Human Reference Atlas (HRA). See the HuBMAP HRA Portal for details.

This Python package is automatically generated by the OpenAPI Generator project:

  • API version: 0.20.0
  • Package version: 0.20.0
  • Generator version: 7.19.0
  • Build package: org.openapitools.codegen.languages.PythonClientCodegen

Requirements.

Python 3.9+

Installation & Usage

pip install

If the python package is hosted on a repository, you can install directly using:

pip install git+https://github.com/x-atlas-consortia/hra-api.git

(you may need to run pip with root permission: sudo pip install git+https://github.com/x-atlas-consortia/hra-api.git)

Then import the package:

import hra_api_client

Setuptools

Install via Setuptools.

python setup.py install --user

(or sudo python setup.py install to install the package for all users)

Then import the package:

import hra_api_client

Tests

Execute pytest to run the tests.

Getting Started

Please follow the installation procedure and then run the following:

import hra_api_client
from hra_api_client.rest import ApiException
from pprint import pprint

# Defining the host is optional and defaults to https://apps.humanatlas.io/api
# See configuration.py for a list of all supported configuration parameters.
configuration = hra_api_client.Configuration(
    host = "https://apps.humanatlas.io/api"
)



# Enter a context with an instance of the API client
with hra_api_client.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = hra_api_client.DsGraphApi(api_client)
    token = 'token_example' # str | Authentication token to use for authenticated searches (optional)

    try:
        # Get Atlas D2K Dataset Graph
        api_response = api_instance.atlas_d2k(token=token)
        print("The response of DsGraphApi->atlas_d2k:\n")
        pprint(api_response)
    except ApiException as e:
        print("Exception when calling DsGraphApi->atlas_d2k: %s\n" % e)

Documentation for API Endpoints

All URIs are relative to https://apps.humanatlas.io/api

Class Method HTTP request Description
DsGraphApi atlas_d2k GET /ds-graph/atlas-d2k Get Atlas D2K Dataset Graph
DsGraphApi gtex GET /ds-graph/gtex Get GTEx Dataset Graph
DsGraphApi hubmap GET /ds-graph/hubmap Get HuBMAP Dataset Graph
DsGraphApi sennet GET /ds-graph/sennet Get SenNet Dataset Graph
HraPopApi cell_summary_report POST /hra-pop/cell-summary-report Given a cell summary in csv format, retrieve a predicted cell summary report from HRApop showing relative anatomical structures, datasets, and rui locations.
HraPopApi rui_location_cell_summary POST /hra-pop/rui-location-cell-summary Given a SpatialEntity already placed relative to a reference SpatialEntity, retrieve a predicted cell summary from HRApop
HraPopApi supported_organs GET /hra-pop/supported-organs Get all organs supported by HRApop
HraPopApi supported_reference_organs GET /hra-pop/supported-reference-organs Get all reference organs supported by HRApop
HraPopApi supported_tools GET /hra-pop/supported-tools Get all tools supported by HRApop
V1Api aggregate_results GET /v1/aggregate-results Get aggregate results / statistics
V1Api anatomical_systems_tree_model GET /v1/anatomical-systems-tree-model Get anatomical systems partonomy tree nodes
V1Api asctb_omap_sheet_config GET /v1/asctb-omap-sheet-config Get OMAP sheet config data for the ASCT+B Reporter
V1Api asctb_sheet_config GET /v1/asctb-sheet-config Get sheet config data for the ASCT+B Reporter
V1Api biomarker_term_occurences GET /v1/biomarker-term-occurences Get number of biomarker type term occurrences for a search
V1Api biomarker_tree_model GET /v1/biomarker-tree-model Get biomarker tree nodes
V1Api cell_type_term_occurences GET /v1/cell-type-term-occurences Get number of cell type term occurrences for a search
V1Api cell_type_tree_model GET /v1/cell-type-tree-model Get cell type tree nodes
V1Api collisions POST /v1/collisions Given an extraction site, get mesh-based collisions with the reference organ.
V1Api consortium_names GET /v1/consortium-names Get consortium names (for filtering)
V1Api corridor POST /v1/corridor Given an extraction site, generate a corridor with the reference organ.
V1Api db_status GET /v1/db-status Get current status of database
V1Api ds_graph GET /v1/ds-graph Get dataset graph
V1Api extraction_site GET /v1/extraction-site Lookup Extraction Site
V1Api ftu_illustrations GET /v1/ftu-illustrations Get 2D FTU Illustration data
V1Api get_spatial_placement POST /v1/get-spatial-placement Given a SpatialEntity already placed relative to a reference SpatialEntity, retrieve a new direct SpatialPlacement to the given SpatialEntity IRI
V1Api gtex_rui_locations GET /v1/gtex/rui_locations.jsonld Get all GTEx rui locations
V1Api hubmap_rui_locations GET /v1/hubmap/rui_locations.jsonld Get all HuBMAP rui locations
V1Api mesh3d_cell_population POST /v1/mesh-3d-cell-population Given a reference organ, 3d scene node, and cell population, generate cells in that distribution to fit in that 3d scene node.
V1Api ontology_term_occurences GET /v1/ontology-term-occurences Get number of ontology term occurrences for a search
V1Api ontology_tree_model GET /v1/ontology-tree-model Get ontology term tree nodes
V1Api provider_names GET /v1/provider-names Get tissue provider names (for filtering)
V1Api reference_organ_scene GET /v1/reference-organ-scene Get all nodes to form the 3D scene for an organ
V1Api reference_organs GET /v1/reference-organs Get all reference organs
V1Api rui_reference_data GET /v1/rui-reference-data Get reference data for the RUI tool
V1Api scene GET /v1/scene Get all nodes to form the 3D scene of reference body, organs, and tissues
V1Api sennet_rui_locations GET /v1/sennet/rui_locations.jsonld Get all SenNet rui locations
V1Api session_token POST /v1/session-token Get a session token
V1Api sparql GET /v1/sparql Run a SPARQL query
V1Api sparql_post POST /v1/sparql Run a SPARQL query (POST)
V1Api technology_names GET /v1/technology-names Get technology names (for filtering)
V1Api tissue_blocks GET /v1/tissue-blocks Get Tissue Block Results

Documentation For Models

Documentation For Authorization

Endpoints do not require authorization.

Author

help@hubmapconsortium.org

Metadata

Release files for hra-api-client 0.20.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for hra-api-client 0.20.0
File Interpreter ABI Platform
hra_api_client-0.20.0-py3-none-any.whl Python 3 none any Details

Release files / hra_api_client-0.20.0-py3-none-any.whl

Download URL hra_api_client-0.20.0-py3-none-any.whl
Size 114.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9399ddcd849db8f0474de0b8f1880e03fe9d3a53cd3aad84b0f7bcecbe0ede66
BLAKE2b-256 checksum
How to use checksums
65b3aca52aaa742ed4ebb32bd95fc25830d925a703122462c275864855f7ef1b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.10.12

Release history Release notifications | RSS feed

This release

0.20.0 This release

1 release file

0.19.0

1 release file

0.17.0

1 release file

0.16.1

1 release file

0.16.0

1 release file

0.15.0

1 release file

0.14.0

1 release file

0.13.0

1 release file

0.12.2

1 release file

0.12.1

1 release file

0.12.0

1 release file

0.11.0

1 release file

0.10.0

1 release file

0.9.0

1 release file

0.8.1

1 release file

0.8.0

1 release file

0.7.0

1 release file

0.6.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page