HuBMAPR

'HuBMAP' data portal (https://portal.hubmapconsortium.org/) provides an open, global bio-molecular atlas of the human body at the cellular level. HuBMAPR package provides an alternative interface to access the data exploration and file retrieval via R.

The HuBMAP Consortium offers several APIs. To achieve the main objectives, HuBMAPR package specifically integrates three APIs:

• Search API: The Search API is primarily searching relevant data information and is referenced to the Elasticsearch API.

• Entity API: The Entity API is specifically utilized in the bulk_data_transfer() function for Globus URL retrieval

• Ontology API: The Ontology API is applied in the organ() function to provide additional information about the abbreviation and corresponding full name of each organ.

Each API serves a distinct purpose with unique query capabilities, tailored to meet various needs. Utilizing the httr2 and rjsoncons packages, HuBMAPR effectively manages, modifies, and executes multiple requests via these APIs, presenting responses in formats such as tibble or character. These outputs are further modified for clarity in the final results from the HuBMAPR functions, and these functions help reflect the data information of HuBMAP Data Portal as much as possible.

HuBMAP Data incorporates three different identifiers:

• HuBMAP ID, e.g. HBM399.VCTL.353

• Universally Unique Identifier (UUID), e.g. 7036a70229eff1a51af965454dddbe7d

• Digital Object Identifiers (DOI), e.g. 10.35079/HBM399.VCTL.353.

The HuBMAPR package utilizes the UUID - a 32-digit hexadecimal number - and the more human-readable HuBMAP ID as two common identifiers in the retrieved results. Considering precision and compatibility with software implementation and data storage, UUID serves as the primary identifier to retrieve data across various functions, with the UUID mapping uniquely to its corresponding HuBMAP ID.

The systematic nomenclature is adopted for functions in the package by appending the entity category prefix to the concise description of the specific functionality. Most of the functions are grouped by entity categories, thereby simplifying the process of selecting the appropriate functions to retrieve the desired information associated with the given UUID from the specific entity category. The structure of these functions is heavily consistent across all entity categories with some exceptions for collection and publication.

Installation

HuBMAPR is a R package available in Bioconductor version $\geq$ 3.20 and R version $\geq$ 4.4.0. You can install HuBMAPR by using the following commands in R session from Bioconductor:

``` r if (!require("BiocManager", quietly = TRUE)) install.packages("BiocManager")

BiocManager::install("HuBMAPR")

Check Bioconductor installation

BiocManager::valid() ```

Additionally, you can install development version from GitHub:

r BiocManager::install_github("christinehou11/HuBMAPR")

Use

$\textbf{Entity Category:}$

• Dataset

• Sample

• Donor

• Collection

• Publication

$\textbf{Available records for [Entity Category]:}$

• datasets()

• samples()

• donors()

• collections()

• publications()

$\textbf{The default columns from Entity Category]:}$

• datasetsdefaultcolumns(as = c(“tibble”, “character”))

• samples defaultcolumns(as = c(“tibble”, “character”)

• donors defaultcolumns(as = c(“tibble”, “character”)

• collections defaultcolumns(as = c(“tibble”, “character”)

• publications defaultcolumns(as = c(“tibble”, “character”)

$\textbf{Single Record Information for [Entity Category] record:}$

• Dataset

  • datasetdetail(datasetuuid)
  • datasetderived(datasetuuid)
  • datasetmetadata(datasetuuid)
  • datasetcontributors(datasetuuid)

• Sample

  • sampledetail(sampleuuid)
  • samplederived(sampleuuid, entity_type = c("Dataset", "Sample"))
  • samplemetadata(sampleuuid)

• Donor

  • donordetail(donoruuid)
  • donor derived(donoruuid, entity_type = c("Dataset", "Sample"))
  • donor metadata(donoruuid)

• Collection

  • collectiondetail(collectionuuid)
  • collectiondata(collectionuuid)
  • collectioncontributors(collectionuuid)
  • collectioncontacts(collectionuuid)
  • collectioninformation(collectionuuid)

• Publication

  • publicationdetail(publicationuuid)
  • publication data(publicationuuid)
  • publicationauthors(publicationuuid)
  • publicationinformation(publicationuuid)

$\textbf{Provenance of a dataset/sample/donor}$:

• uuid_provenance(dataset/sample/donor uuid)

$\textbf{Additional information about organ abbreviation and its full name:}$

• organ()

$\textbf{Retrieve data files from one dataset single record:}$

• bulkdatatransfer(dataset_uuid)

View the article Explore Human BioMelecular Atlas Program Data Portal to read detailed examples.

Preprint

Pre-print: https://www.biorxiv.org/content/10.1101/2024.09.26.615227v1