Reads files from a Camera Trap Data Package (Camtrap DP) into memory.
Assign taxonomic information
Camtrap DP metadata has a taxonomic property that can contain extra
information for each scientificName found in observations.
Such information can include higher taxonomy (family, order, etc.) and
vernacular names in multiple languages.
This function will automatically include this taxonomic information in
observations, as extra columns starting with taxon..
Assign eventIDs
Observations can contain two classifications at two levels:
Media-based observations (observationLevel = "media") are based on a
single media file and are directly linked to it via mediaID.
Event-based observations (observationLevel = "event") are based on an
event, defined as a combination of eventID, eventStart and eventEnd.
This event can consist of one or more media files, but is not directly linked
to these.
This function will automatically assign eventIDs to media, using
media.deploymentID = event.deploymentID and eventStart <= media.timestamp <= eventEnd.
Note that this can result in media being linked to multiple events (and thus
being duplicated), for example when events and sub-events were defined.
Update metadata
Camtrap DP metadata has a spatial and temporal property that contains the
spatial and temporal coverage of the package respectively.
This function will automatically update the spatial and temporal scopes in metadata based on the data.
Examples
file <- "https://raw.githubusercontent.com/tdwg/camtrap-dp/1.0/example/datapackage.json"
x <- read_camtrapdp(file)
x
#> A Camera Trap Data Package "camtrap-dp-example-dataset" with 3 tables:
#> • deployments: 4 rows
#> • media: 423 rows
#> • observations: 549 rows
#>
#> And 1 additional resource:
#> • individuals
#> Use `unclass()` to print the Data Package as a list.