Metadata

Metadata in Camtrap DP are expressed in a datapackage.json file. It follows the Data Package specifications and includes generic Data Package properties and specific Camtrap DP properties. Properties indicated with * are required (i.e. cannot be empty).

Source: camtrap-dp-profile.json

resources

See Data Package specification. Camtrap DP further requires each object to be a Tabular Data Resource with a specific name and schema. See Data for the requirements for those resources.

Name Definition Type
name

Identifier of the resource.

Constraints
  • enum: deployments, media, observations
profile * Constraints
  • const: tabular-data-resource
schema *

URL of the used Camtrap DP Table Schema version (e.g. https://raw.githubusercontent.com/tdwg/camtrap-dp/1.0/deployments-table-schema.json).

profile *

See Data Package specification. Camtrap DP further requires this to be the URL of the used Camtrap DP Profile version (e.g. https://raw.githubusercontent.com/tdwg/camtrap-dp/1.0/camtrap-dp-profile.json).

name

See Data Package specification.

id

See Data Package specification.

created *

See Data Package specification. Camtrap DP makes this a required property.

title

See Data Package specification. Not to be confused with the title of the project that originated the package (package.project.title).

contributors *

See Data Package specification. Camtrap DP makes this a required property. Can include people and organizations.

description

See Data Package specification. Not to be confused with the description of the project that originated the package (package.project.description).

version

See Data Package specification.

keywords

See Data Package specification.

image

See Data Package specification.

homepage

See Data Package specification.

sources

See Data Package specification. Can include the data management platform from which the package was derived (e.g. Agouti, Trapper, Wildlife Insights).

Name Definition Type
version

Version of the source.

string

licenses

See Data Package specification. If provided, Camtrap DP further requires at least a license for the content of the package and one for the media files.

Name Definition Type
scope *

Scope of the license. data applies to the content of the package and resources, media to the (locally or externally hosted) media files referenced in media.filePath.

Constraints
  • enum: data, media
string

bibliographicCitation

Bibliographic/recommended citation for the package.

Same as http://purl.org/dc/terms/bibliographicCitation

project *

Camera trap project or study that originated the package.

Name Definition Type
id

Unique identifier of the project.

string
title *

Title of the project. Not to be confused with the title of the package (package.title).

string
acronym

Project acronym.

string
description

Description of the project. Preferably formatted as Markdown. Not to be confused with the description of the package (package.description).

string
path

Project website.

string
samplingDesign *

Type of a sampling design/layout. The values are based on Wearn & Glover-Kapfer (2017, https://doi.org/10.13140/RG.2.2.23409.17767), pages 80-82: simple random: random distribution of sampling locations; systematic random: random distribution of sampling locations, but arranged in a regular pattern; clustered random: random distribution of sampling locations, but clustered in arrays; experimental: non-random distribution aimed to study an effect, including the before-after control-impact (BACI) design; targeted: non-random distribution optimized for capturing specific target species (often using various bait types); opportunistic: opportunistic camera trapping (usually with a small number of cameras).

Constraints
  • enum: simple random, systematic random, clustered random, experimental, targeted, opportunistic
string
captureMethod *

Method(s) used to capture the media files.

Constraints
  • enum: motion detection, time lapse
array
individualAnimals *

true if the project includes marked or recognizable individuals. See also observations.individualID.

boolean
classificationLevel *

Information about a focal level of the classification process. sequence: classifications (i.e. rows in the observations resource) are provided at a sequence level (multiple media files can be part of one sequence); media: classifications are available for each single media file.

Constraints
  • enum: sequence, media
string
sequenceInterval *

Maximum number of seconds between timestamps of successive media files to be considered part of a single sequence and be assigned the same media.sequenceID.

integer

coordinatePrecision

Least precise coordinate precision of the deployments.latitude and deployments.longitude (e.g. 0.01 for coordinates with a precision of 0.01 and 0.001 degree). Especially relevant when coordinates have been rounded to protect sensitive species.

Same as http://rs.tdwg.org/dwc/terms/coordinatePrecision

spatial *

Spatial coverage of the package, expressed as GeoJSON.

Same as http://purl.org/dc/terms/spatial

temporal *

Temporal coverage of the package.

Same as http://purl.org/dc/terms/temporal

Name Definition Type
start *

Start date of the first deployment. Formatted as an ISO 8601 string (YYYY-MM-DD).

string
end *

End date of the last (completed) deployment. Formatted as an ISO 8601 string (YYYY-MM-DD).

string

taxonomic *

Taxonomic coverage of the package, based on the unique observations.scientificName.

Name Definition Type
taxonID *

Unique identifier of the taxon according to the taxonomic reference list defined by taxonIDReference.

Example: QLXL

Same as http://rs.tdwg.org/dwc/terms/taxonID
string
taxonIDReference *

URL of the source (reference list) of the taxonID.

Example: https://www.catalogueoflife.org

string
scientificName *

Scientific name of the taxon.

Example: Canis lupus

Same as http://rs.tdwg.org/dwc/terms/scientificName
string
taxonRank

Taxonomic rank of the scientific name.

Constraints
  • enum: kingdom, phylum, class, order, family, genus, species, subspecies

Example: species

Same as http://rs.tdwg.org/dwc/terms/taxonRank
string
kingdom

Kingdom in which the taxon is classified.

Example: Animalia

Same as http://rs.tdwg.org/dwc/terms/kingdom
string
phylum

Phylum or division in which the taxon is classified

Example: Chordata

Same as http://rs.tdwg.org/dwc/terms/phylum
string
class

Class in which the taxon is classified.

Example: Mammalia

Same as http://rs.tdwg.org/dwc/terms/class
string
order

Order in which the taxon is classified.

Example: Carnivora

Same as http://rs.tdwg.org/dwc/terms/order
string
family

Family in which the taxon is classified.

Example: Canidae

Same as http://rs.tdwg.org/dwc/terms/family
string
genus

Genus in which the taxon is classified.

Example: Canis

Same as http://rs.tdwg.org/dwc/terms/genus
string
vernacularNames

Common or vernacular names of the taxon, as languageCode: vernacular name pairs. Language codes should follow ISO 639-1 (e.g. en for English).

Example: {'en': 'wolf', 'fr': 'loup gris'}

object

relatedIdentifiers

Identifiers of resources related to the package (e.g. papers, project pages, derived datasets, APIs, etc.).

Name Definition Type
relationType *

Description of the relationship between the resource (the package) and the related resource.

Constraints
  • enum: IsCitedBy, Cites, IsSupplementTo, IsSupplementedBy, IsContinuedBy, Continues, IsNewVersionOf, IsPreviousVersionOf, IsPartOf, HasPart, IsPublishedIn, IsReferencedBy, References, IsDocumentedBy, Documents, IsCompiledBy, Compiles, IsVariantFormOf, IsOriginalFormOf, IsIdenticalTo, HasMetadata, IsMetadataFor, Reviews, IsReviewedBy, IsDerivedFrom, IsSourceOf, Describes, IsDescribedBy, HasVersion, IsVersionOf, Requires, IsRequiredBy, Obsoletes, IsObsoletedBy
Same as https://schema.datacite.org/meta/kernel-4.4/include/datacite-relationType-v4.xsd
string
relatedIdentifier *

Unique identifier of the related resource (e.g. a DOI or URL).

string
resourceTypeGeneral

General type of the related resource.

Constraints
  • enum: Audiovisual, Book, BookChapter, Collection, ComputationalNotebook, ConferencePaper, ConferenceProceeding, DataPaper, Dataset, Dissertation, Event, Image, InteractiveResource, Journal, JournalArticle, Model, OutputManagementPlan, PeerReview, PhysicalObject, Preprint, Report, Service, Software, Sound, Standard, Text, Workflow, Other
Same as https://schema.datacite.org/meta/kernel-4.4/include/datacite-resourceType-v4.xsd
string
relatedIdentifierType *

Type of the RelatedIdentifier.

Constraints
  • enum: ARK, arXiv, bibcode, DOI, EAN13, EISSN, Handle, IGSN, ISBN, ISSN, ISTC, LISSN, LSID, PMID, PURL, UPC, URL, URN, w3id
Same as https://schema.datacite.org/meta/kernel-4.4/include/datacite-relatedIdentifierType-v4.xsd
string

references

List of references related to the package (e.g. references cited in package.project.description). References preferably include a DOI.