samples: HCA Sample Querying

In Bioconductor/hca: Exploring the Human Cell Atlas Data Coordinating Platform

HCA Sample Querying

Description

samples() takes a list of user provided project titles to be used to query the HCA API for information about available samples.

samples_detail() takes a unique sample_id and catalog for the sample, and returns details about the specified sample as a list-of-lists

Usage

samples(
  filters = NULL,
  size = 1000L,
  sort = "projectTitle",
  order = c("asc", "desc"),
  catalog = NULL,
  as = c("tibble", "lol", "list", "tibble_expanded"),
  columns = samples_default_columns("character")
)

samples_facets(facet = character(), catalog = NULL)

samples_default_columns(as = c("tibble", "character"))

samples_detail(uuid, catalog = NULL)

Arguments

filters	filter object created by filters(), or NULL (default; all projects).
size	integer(1) maximum number of results to return; default: all projects matching filter. The default (10000) is meant to be large enough to return all results.
sort	character(1) project facet (see facet_options()) to sort result; default: "projectTitle".
order	character(1) sort order. One of "asc" (ascending) or "desc" (descending).
catalog	character(1) source of data. Use catalogs() for possible values.
as	character(1) return format. One of "tibble" (default), "lol", "list", or "tibble_expanded", as described in the Details and Value sections of ?projects.
columns	named character() indicating the paths to be used for parsing the 'lol' returned from the HCA to a tibble. The names of columns are used as column names in the returned tibble. If the columns are unnamed, a name is derived from the elements of path by removing ⁠hits[*]⁠ and all ⁠[*]⁠, e.g., a path ⁠hits[*].donorOrganisms[*].biologicalSex[*]⁠ is given the name donorOrganisms.biologicalSex.
facet	character() of valid facet names. Summary results (see 'Value', below) are returned when missing or length greater than 1; details are returned when a single facet is specified.
uuid	character() unique identifier (e.g., projectId) of the object.

Value

samples_detail() returns a list-of-lists containing relevant details about the sample

Examples

title <- paste(
    "Tabula Muris: Transcriptomic characterization of 20 organs and",
    "tissues from Mus musculus at single cell resolution"
)
filters <- filters( projectTitle = list(is = title) )
samples(filters = filters)

samples_facets()

sample <- samples(size = 1, as = "list")
sample_uuid <- sample[["hits"]][[1]][["entryId"]]
samples_detail(uuid = sample_uuid)

Bioconductor/hca documentation built on March 27, 2024, 3:15 a.m.