Metadata

On this page

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
path *

Path or URL to the data file.
profile *

Profile of the resource.

Constraints
  • enum: 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 and restricts role values. Can include people and organizations.

Name Definition Type
role

Role of the contributor. Defaults to contributor.

Constraints
  • enum: contact, principalInvestigator, rightsHolder, publisher, contributor

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), 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: simpleRandom, systematicRandom, clusteredRandom, experimental, targeted, opportunistic
Narrower than http://rs.tdwg.org/eco/terms/inventoryTypes 		string
captureMethod *

Method(s) used to capture the media files.

Constraints
  • enum: activityDetection, timeLapse
 array
individualAnimals *

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

 boolean
observationLevel *

Level at which observations are provided. See also observations.observationLevel.

Constraints
  • enum: media, event
 array

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
scientificName *

Scientific name of the taxon.

Example: Canis lupus

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

Unique identifier of the taxon. Preferably a global unique identifier issued by an authoritative checklist.

Example: https://www.checklistbank.org/dataset/COL2023/taxon/QLXL

Same as http://rs.tdwg.org/dwc/terms/taxonID 		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 693-3 (e.g. eng for English).

Example: {'eng': 'wolf', 'fra': '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.