Data - Camtrap DP

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

On this page

Deployments

Media

Observations