Occurrences

pbdb_occurrence(id; kwargs...)

Get information about a single fossil occurrence record from the Paleobiology Database.

Arguments

• id: Identifier of the occurrence (required).
• kwargs...: Additional query parameters. Common options include:
  • vocab: "pbdb" to use full field names instead of compact 3-letter codes.
  • show: Extra information blocks to return (e.g. "class", "coords", "loc", "stratext", "lithext").

Returns

A DataFrame with information about the specified occurrence.

Examples

pbdb_occurrence("occ:1001")
pbdb_occurrence("occ:1001"; show = "full")
pbdb_occurrence(1001)
pbdb_occurrence(1001; show = ["class", "coords"])

pbdb_occurrences(; kwargs...)

Get information about fossil occurrence records stored in the Paleobiology Database.

Arguments

• kwargs...: Filtering and output parameters. Common options include:
  • limit: Maximum number of records to return (Int or "all").
  • taxon_name: Return only records with the specified taxonomic name(s).
  • base_name: Return records for the specified name(s) and all descendant taxa.
  • lngmin, lngmax, latmin, latmax: Geographic bounding box.
  • min_ma, max_ma: Minimum and maximum age in millions of years.
  • interval: Named geologic interval (e.g. "Miocene").
  • cc: Country/continent codes (ISO two-letter or three-letter).
  • show: Extra information blocks ("coords", "classext", "ident", etc.). show = "full" for everything.
  • extids: Set extids = true to show the newer string identifiers.
  • vocab: Vocabulary for field names ("pbdb" for full names, "com" for short codes).

Returns

A DataFrame with fossil occurrence records matching the query.

Examples

# `taxon_name` retrieves *only* units of this rank
occs = pbdb_occurrences(
	taxon_name = "Canis",
	show = "full", # all columns
	limit = 100,
)

# `base_name` retrieves units of this and nested rank
occs = pbdb_occurrences(
	base_name = "Canis",
	show = ["coords", "classext"],
	limit = 100,
)

pbdb_ref_occurrences(; kwargs...)

Get bibliographic references associated with fossil occurrence records.

Arguments

• kwargs...: Filtering parameters. Common options include:
  • base_name: Restrict references to occurrences of a given taxon and descendants.
  • ref_author: Filter by author name.
  • ref_pubyr: Filter by publication year.
  • pub_title: Filter by publication title.

Returns

A DataFrame with references linked to occurrence records.

Examples

pbdb_ref_occurrences(base_name = "Canis"; ref_pubyr = 2000)