Skip to contents

Search MorphoSource for 3D media or physical objects

Source: R/taphonomy.R
morie_taphonomy_morphosource_search.Rd

Queries the open MorphoSource repository (CT / micro-CT / 3D scans of skeletal and occasionally mummified remains) – real bioarchaeology comparanda for the taphonomy pipeline. Public search needs no key; a key (for restricted records) is read from api_key or the MORPHOSOURCE_API_KEY environment variable, sent in an Authorization header (never the URL).

Usage

morie_taphonomy_morphosource_search(
  query = NULL,
  type = c("media", "physical-objects"),
  media_type = NULL,
  taxonomy_gbif = NULL,
  visibility = NULL,
  media_tag = NULL,
  per_page = 10L,
  page = 1L,
  api_key = NULL
)

Source

https://www.morphosource.org; API verified against https://github.com/Imageomics/pyMorphoSource.

Arguments

query

Free-text query (searches all fields).

type

"media" (default) or "physical-objects".

media_type, taxonomy_gbif, visibility, media_tag

Optional facet filters.

per_page, page

Pagination (default 10 / 1).

api_key

Optional key; else MORPHOSOURCE_API_KEY. Never hard-code it.

Value

A list: items (raw records), n, total_pages, and df (a data.frame of id + title where present).

See also

morie_taphonomy_morphosource_fetch

Examples

# \donttest{
# res <- morie_taphonomy_morphosource_search("Homo sapiens cranium")
# }