Data

Data in Camtrap DP are organized as three related resources (CSV files): deployments, media and observations. These Tabular Data Resources are described as resources in the datapackage.json file (see Metadata). The descriptions of their fields follow the Table Schema specifications and are presented below in human-readable form. Fields indicated with * are required (i.e. cannot be empty).

Deployments

Source: deployments-table-schema.json

Table with camera trap deployments. Includes deploymentID, start, end, location and camera setup information.

Name Definition Type
deploymentID *

Unique identifier of the deployment.

Constraints
  • required: true
  • unique: true

Example: dep1

Broader than http://rs.tdwg.org/dwc/terms/eventID
string
locationID

Unique identifier of the deployment location.

Constraints
  • required: false

Example: loc1

Same as http://rs.tdwg.org/dwc/terms/locationID
string
locationName

Name given to the deployment location.

Constraints
  • required: false

Example: Białowieża MRI 01

Same as http://rs.tdwg.org/dwc/terms/locality
string
longitude *

Longitude of the deployment location in decimal degrees, using the WGS84 datum.

Constraints
  • required: true
  • minimum: -180
  • maximum: 180

Example: 23.84995

Same as http://rs.tdwg.org/dwc/terms/decimalLongitude
number
latitude *

Latitude of the deployment location in decimal degrees, using the WGS84 datum.

Constraints
  • required: true
  • minimum: -90
  • maximum: 90

Example: 52.70442

Same as http://rs.tdwg.org/dwc/terms/decimalLatitude
number
coordinateUncertainty

Horizontal distance in meters from the given latitude and longitude describing the smallest circle containing the deployment location. Especially relevant when coordinates are rounded to protect sensitive species.

Constraints
  • required: false
  • minimum: 1

Example: 100

Same as http://rs.tdwg.org/dwc/terms/coordinateUncertaintyInMeters
integer
start *

Date and time at which the deployment was started. Formatted as an ISO 8601 string with timezone designator (YYYY-MM-DDThh:mm:ssZ or YYYY-MM-DDThh:mm:ss±hh:mm).

Constraints
  • required: true

Example: 2020-03-01T22:00:00Z

Same as http://rs.tdwg.org/dwc/terms/eventDate
datetime
end *

Date and time at which the deployment was ended. Formatted as an ISO 8601 string with timezone designator (YYYY-MM-DDThh:mm:ssZ or YYYY-MM-DDThh:mm:ss±hh:mm).

Constraints
  • required: true

Example: 2020-04-01T22:00:00Z

Same as http://rs.tdwg.org/dwc/terms/eventDate
datetime
setupBy

Name or unique identifier of the person that deployed the camera.

Constraints
  • required: false

Example: Jakub Bubnicki

string
cameraID

Unique identifier of the camera used for the deployment (e.g. the camera device serial number).

Constraints
  • required: false

Example: P800HG08192031

string
cameraModel

Manufacturer and model of the camera. Formatted as manufacturer-model.

Constraints
  • required: false

Example: Reconyx-PC800

Broader than http://rs.tdwg.org/ac/terms/captureDevice
string
cameraInterval

Time specified between shutter triggers when activity in the sensor will not trigger the shutter. Expressed in seconds.

Constraints
  • required: false
  • minimum: 0

Example: 120

integer
cameraHeight

Height at which the camera was deployed. Expressed in meters.

Constraints
  • required: false
  • minimum: 0

Example: 1.2

number
cameraTilt

Angle at which the camera was deployed in the vertical plane. Expressed in degrees, with -90 facing down, 0 horizontal and 90 facing up.

Constraints
  • required: false
  • minimum: -90
  • maximum: 90

Example: -90

integer
cameraHeading

Angle at which the camera was deployed in the horizontal plane. Expressed in decimal degrees clockwise from north, with values ranging from 0 to 360: 0 = north, 90 = east, 180 = south, 270 = west.

Constraints
  • required: false
  • minimum: 0
  • maximum: 360

Example: 225

integer
detectionDistance

Furthest distance at which the camera detected a human during setup.

Constraints
  • required: false
  • minimum: 0

Example: 9.5

number
timestampIssues

true if timestamps in the media and observations resources for the deployment are known to have (unsolvable) issues (e.g. unknown timezone, am/pm switch).

Constraints
  • required: false
boolean
baitUse

true if bait was used for the deployment. More information can be provided in tags or comments.

Constraints
  • required: false

Example: true

boolean
featureType

Type of the feature (if any) associated with the deployment.

Constraints
  • required: false
  • enum: road paved, road dirt, trail hiking, trail game, road underpass, road overpass, road bridge, culvert, burrow, nest site, carcass, water source, fruiting tree

Example: culvert

string
habitat

Short characterization of the habitat at the deployment location.

Constraints
  • required: false

Example: Mixed temperate low-land forest

Same as http://rs.tdwg.org/dwc/terms/habitat
string
deploymentGroup

Deployment group(s) associated with the deployment. Deployment groups can have a spatial (arrays, grids, clusters), temporal (sessions, seasons, months, years) or other context. Formatted as a pipe (|) separated list for multiple values, with values preferably formatted as key:value pairs.

Constraints
  • required: false

Example: season:winter 2020 | grid:A1

string
tags

Tag(s) associated with the deployment. Formatted as a pipe (|) separated list for multiple values, with values optionally formatted as key:value pairs.

Constraints
  • required: false

Example: forest edge | bait:food

Narrower than http://rs.tdwg.org/ac/terms/tag
string
comments

Comments or notes about the deployment.

Constraints
  • required: false
Same as http://rs.tdwg.org/dwc/terms/eventRemarks
string
_id

Unique identifier of the deployment as assigned by the data management system.

Constraints
  • required: false
string

Media

Source: media-table-schema.json

Table with media files (images/videos) captured by the camera traps. Associated with deployments (deploymentID) and organized in sequences (sequenceID). Includes timestamp and file path.

Name Definition Type
mediaID *

Unique identifier of the media file.

Constraints
  • required: true
  • unique: true

Example: m1

Broader than http://purl.org/dc/terms/identifier
string
deploymentID *

Unique identifier of the deployment the media file belongs to. Foreign key to deployments.deploymentID.

Constraints
  • required: true

Example: dep1

Broader than http://rs.tdwg.org/dwc/terms/eventID
string
sequenceID *

Unique identifier of the sequence the media file belongs to. Sequences contain one or more media files (e.g. a single image or video or a sequence of successive images or videos) and are defined by package.project.sequenceInterval.

Constraints
  • required: true

Example: seq1

Broader than http://rs.tdwg.org/dwc/terms/eventID
string
captureMethod

Method used to capture the media file.

Constraints
  • required: false
  • enum: motion detection, time lapse

Example: motion detection

Broader than http://rs.tdwg.org/ac/terms/resourceCreationTechnique
string
timestamp *

Date and time at which the media file was recorded. Formatted as an ISO 8601 string with timezone designator (YYYY-MM-DDThh:mm:ssZ or YYYY-MM-DDThh:mm:ss±hh:mm).

Constraints
  • required: true

Example: 2020-03-24T11:21:46Z

Same as http://ns.adobe.com/xap/1.0/CreateDate
datetime
filePath *

URL or relative path to the media file, respectively for externally hosted files or files that are part of the package.

Constraints
  • required: true
  • pattern: ^(?=^[^./~])(^((?!\.{2}).)*$).*$

Example: https://multimedia.agouti.eu/assets/6d65f3e4-4770-407b-b2bf-878983bf9872/file

Broader than http://rs.tdwg.org/ac/terms/accessURI
string
fileName

Name of the media file. If provided, one should be able to sort media files chronologically within a deployment on timestamp (first) and fileName (second).

Constraints
  • required: false

Example: IMG0001.jpg

string
fileMediatype *

Mediatype of the media file.

Constraints
  • required: true

Example: image/jpeg

string
exifData

EXIF data of the media file. Formatted as a valid JSON object.

Constraints
  • required: false

Example: {"EXIF":{"ISO":200,"Make":"RECONYX"}}

object
favourite

true if the media file is deemed of interest (e.g. an exemplar image of an individual).

Constraints
  • required: false

Example: true

boolean
comments

Comments or notes about the media file.

Constraints
  • required: false

Example: corrupted file

Same as http://rs.tdwg.org/ac/terms/comments
string
_id

Unique identifier of the media file as assigned by the data management system.

Constraints
  • required: false
Same as http://rs.tdwg.org/ac/terms/providerManagedID
string

Observations

Source: observations-table-schema.json

Table with observations based on the media files. Associated with deployments (deploymentID), sequences (sequenceID) and optionally individual media files (mediaID). Observations can mark non-animal events (camera setup, human, blank) or one or more animal observations (observationType = animal) of a certain taxon, count, life stage, sex, behaviour and/or individual.

Name Definition Type
observationID *

Unique identifier of the observation.

Constraints
  • required: true
  • unique: true

Example: obs1

Same as http://rs.tdwg.org/dwc/terms/occurrenceID
string
deploymentID *

Unique identifier of the deployment the observation belongs to. Foreign key to deployments.deploymentID.

Constraints
  • required: true

Example: dep1

Broader than http://rs.tdwg.org/dwc/terms/eventID
string
sequenceID *

Unique identifier of the sequence (collection of media files grouped by a predefined package.project.sequenceInterval) that is the source of the observation. Foreign key to media.sequenceID.

Constraints
  • required: true

Example: seq1

Broader than http://rs.tdwg.org/dwc/terms/eventID
string
mediaID

Unique identifier of the media file that is the source of the observation. Foreign key to media.mediaID. Leave empty for sequence-based observations.

Constraints
  • required: false

Example: m1

Broader than http://purl.org/dc/terms/identifier
string
timestamp *

Date and time of the observation. Formatted as an ISO 8601 string with timezone designator (YYYY-MM-DDThh:mm:ssZ or YYYY-MM-DDThh:mm:ss±hh:mm). For file-based observations this is the media.timestamp of the associated media file (in mediaID), for sequence-based observations the media.timestamp of the first media file in the associated sequence (in sequenceID).

Constraints
  • required: true

Example: 2020-03-24T11:21:46Z

Same as http://rs.tdwg.org/dwc/terms/eventDate
datetime
observationType *

Type of the observation. All categories in this vocabulary have to be understandable from an AI point of view. unknown describes classifications with a confidence level below some predefined threshold i.e. neither humans nor AI can say what was recorded.

Constraints
  • required: true
  • enum: animal, human, vehicle, blank, unknown, unclassified

Example: animal

string
cameraSetup

true if the observation is part of the camera setup process (camera deployment, pickup, maintenance).

Constraints
  • required: false
boolean
taxonID

Unique identifier of the scientificName as defined in package.taxonomic.taxonID for that scientific name.

Constraints
  • required: false

Example: QLXL

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

Scientific name of the observed individual(s).

Constraints
  • required: false

Example: Canis lupus

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

Number of observed individuals (optionally of given life stage, sex and behaviour).

Constraints
  • required: false
  • minimum: 1

Example: 5

Same as http://rs.tdwg.org/dwc/terms/individualCount
integer
countNew

Number of new (= previously uncounted) individuals in the associated media file (mediaID) taking into account the entire sequence (sequenceID) (optionally of given life stage, sex and behaviour).

Constraints
  • required: false
  • minimum: 0

Example: 2

integer
lifeStage

Age class or life stage of the observed individual(s).

Constraints
  • required: false
  • enum: adult, subadult, juvenile

Example: adult

Same as http://rs.tdwg.org/dwc/terms/lifeStage
string
sex

Sex of the observed individual(s)

Constraints
  • required: false
  • enum: female, male

Example: female

Same as http://rs.tdwg.org/dwc/terms/sex
string
behaviour

Dominant behaviour of the observed individual(s), preferably expressed as controlled values (e.g. grazing, browsing, rooting, vigilance, running, walking). Formatted as a pipe (|) separated list for multiple values, with the dominant behaviour listed first.

Constraints
  • required: false

Example: vigilance

Same as http://rs.tdwg.org/dwc/terms/behavior
string
individualID

Unique identifier of the observed individual.

Constraints
  • required: false

Example: RD213

Same as http://rs.tdwg.org/dwc/terms/organismID
string
classificationMethod

Classification method.

Constraints
  • required: false
  • enum: human, machine

Example: human

string
classifiedBy

Name or unique identifier of the person or AI algorithm that classified the observation.

Constraints
  • required: false

Example: MegaDetector V5

Same as http://rs.tdwg.org/dwc/terms/identifiedBy
string
classificationTimestamp

Date and time of the classification. Formatted as an ISO 8601 string with timezone designator (YYYY-MM-DDThh:mm:ssZ or YYYY-MM-DDThh:mm:ss±hh:mm).

Constraints
  • required: false

Example: 2020-08-22T10:25:19Z

Same as http://rs.tdwg.org/dwc/terms/dateIdentified
datetime
classificationConfidence

Accuracy confidence of the classification. Expressed as a probability, with 1 being maximum confidence. Provide an approximate value for human classifications.

Constraints
  • required: false
  • minimum: 0
  • maximum: 1

Example: 0.95

number
comments

Comments or notes about the observation.

Constraints
  • required: false
Same as http://rs.tdwg.org/dwc/terms/occurrenceRemarks
string
_id

Unique identifier of the observation as assigned by the data management system.

Constraints
  • required: false
string