deployments-table-schema.json

{
  "name": "deployments",
  "title": "Deployments",
  "description": "Table with camera trap placements (deployments). Includes `deploymentID`, start, end, location and camera setup information.",
  "fields": [
    {
      "name": "deploymentID",
      "description": "Unique identifier of the deployment.",
      "skos:broadMatch": "http://rs.tdwg.org/dwc/terms/eventID",
      "type": "string",
      "constraints": {
        "required": true,
        "unique": true
      },
      "example": "dep1"
    },
    {
      "name": "locationID",
      "description": "Identifier of the deployment location.",
      "skos:exactMatch": "http://rs.tdwg.org/dwc/terms/locationID",
      "type": "string",
      "constraints": {
        "required": false
      },
      "example": "loc1"
    },
    {
      "name": "locationName",
      "description": "Name given to the deployment location.",
      "skos:exactMatch": "http://rs.tdwg.org/dwc/terms/locality",
      "type": "string",
      "constraints": {
        "required": false
      },
      "example": "Białowieża MRI 01"
    },
    {
      "name": "latitude",
      "description": "Latitude of the deployment location in decimal degrees, using the WGS84 datum.",
      "skos:broadMatch": "http://rs.tdwg.org/dwc/terms/decimalLatitude",
      "type": "number",
      "constraints": {
        "required": true,
        "minimum": -90,
        "maximum": 90
      },
      "example": 52.70442
    },
    {
      "name": "longitude",
      "description": "Longitude of the deployment location in decimal degrees, using the WGS84 datum.",
      "skos:broadMatch": "http://rs.tdwg.org/dwc/terms/decimalLongitude",
      "type": "number",
      "constraints": {
        "required": true,
        "minimum": -180,
        "maximum": 180
      },
      "example": 23.84995
    },
    {
      "name": "coordinateUncertainty",
      "description": "Horizontal distance from the given `latitude` and `longitude` describing the smallest circle containing the deployment location. Expressed in meters. Especially relevant when coordinates are rounded to protect sensitive species.",
      "skos:exactMatch": "http://rs.tdwg.org/dwc/terms/coordinateUncertaintyInMeters",
      "type": "integer",
      "constraints": {
        "required": false,
        "minimum": 1
      },
      "unit": "m",
      "example": 100
    },
    {
      "name": "deploymentStart",
      "description": "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`).",
      "skos:broadMatch": "http://rs.tdwg.org/dwc/terms/eventDate",
      "type": "datetime",
      "format": "%Y-%m-%dT%H:%M:%S%z",
      "constraints": {
        "required": true
      },
      "example": "2020-03-01T22:00:00Z"
    },
    {
      "name": "deploymentEnd",
      "description": "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`).",
      "skos:broadMatch": "http://rs.tdwg.org/dwc/terms/eventDate",
      "type": "datetime",
      "format": "%Y-%m-%dT%H:%M:%S%z",
      "constraints": {
        "required": true
      },
      "example": "2020-04-01T22:00:00Z"
    },
    {
      "name": "setupBy",
      "description": "Name or identifier of the person or organization that deployed the camera.",
      "skos:broadMatch": "http://rs.tdwg.org/eco/terms/samplingPerformedBy",
      "type": "string",
      "constraints": {
        "required": false
      },
      "example": "Jakub Bubnicki"
    },
    {
      "name": "cameraID",
      "description": "Identifier of the camera used for the deployment (e.g. the camera device serial number).",
      "type": "string",
      "constraints": {
        "required": false
      },
      "example": "P800HG08192031"
    },
    {
      "name": "cameraModel",
      "description": "Manufacturer and model of the camera. Formatted as `manufacturer-model`.",
      "skos:broadMatch": "http://rs.tdwg.org/ac/terms/captureDevice",
      "type": "string",
      "constraints": {
        "required": false
      },
      "example": "Reconyx-PC800"
    },
    {
      "name": "cameraDelay",
      "description": "Predefined duration after detection when further activity is ignored. Expressed in seconds.",
      "type": "integer",
      "constraints": {
        "required": false,
        "minimum": 0
      },
      "example": 120
    },
    {
      "name": "cameraHeight",
      "description": "Height at which the camera was deployed. Expressed in meters. Not to be combined with `cameraDepth`.",
      "skos:narrowMatch": [
        "http://rs.tdwg.org/dwc/terms/minimumDistanceAboveSurfaceInMeters",
        "http://rs.tdwg.org/dwc/terms/maximumDistanceAboveSurfaceInMeters"
      ],
      "type": "number",
      "constraints": {
        "required": false,
        "minimum": 0
      },
      "unit": "m",
      "example": 1.2
    },
    {
      "name": "cameraDepth",
      "description": "Depth at which the camera was deployed. Expressed in meters. Not to be combined with `cameraHeight`.",
      "skos:narrowMatch": [
        "http://rs.tdwg.org/dwc/terms/minimumDepthInMeters",
        "http://rs.tdwg.org/dwc/terms/maximumDepthInMeters"
      ],
      "type": "number",
      "constraints": {
        "required": false,
        "minimum": 0
      },
      "unit": "m",
      "example": 4.8
    },
    {
      "name": "cameraTilt",
      "description": "Angle at which the camera was deployed in the vertical plane. Expressed in degrees, with `-90` facing down, `0` horizontal and `90` facing up.",
      "type": "integer",
      "constraints": {
        "required": false,
        "minimum": -90,
        "maximum": 90
      },
      "unit": "°",
      "example": -90
    },
    {
      "name": "cameraHeading",
      "description": "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.",
      "type": "integer",
      "constraints": {
        "required": false,
        "minimum": 0,
        "maximum": 360
      },
      "unit": "°",
      "example": 225
    },
    {
      "name": "detectionDistance",
      "description": "Maximum distance at which the camera can reliably detect activity. Expressed in meters. Typically measured by having a human move in front of the camera.",
      "type": "number",
      "constraints": {
        "required": false,
        "minimum": 0
      },
      "unit": "m",
      "example": 9.5
    },
    {
      "name": "timestampIssues",
      "description": "`true` if timestamps in the `media` resource for the deployment are known to have (unsolvable) issues (e.g. unknown timezone, am/pm switch).",
      "type": "boolean",
      "constraints": {
        "required": false
      },
      "example": false
    },
    {
      "name": "baitUse",
      "description": "`true` if bait was used for the deployment. More information can be provided in `tags` or `comments`.",
      "type": "boolean",
      "constraints": {
        "required": false
      },
      "example": true
    },
    {
      "name": "featureType",
      "description": "Type of the feature (if any) associated with the deployment.",
      "type": "string",
      "constraints": {
        "required": false,
        "enum": [
          "roadPaved",
          "roadDirt",
          "trailHiking",
          "trailGame",
          "roadUnderpass",
          "roadOverpass",
          "roadBridge",
          "culvert",
          "burrow",
          "nestSite",
          "carcass",
          "waterSource",
          "fruitingTree"
        ]
      },
      "example": "culvert"
    },
    {
      "name": "habitat",
      "description": "Short characterization of the habitat at the deployment location.",
      "skos:exactMatch": "http://rs.tdwg.org/dwc/terms/habitat",
      "type": "string",
      "constraints": {
        "required": false
      },
      "example": "Mixed temperate low-land forest"
    },
    {
      "name": "deploymentGroups",
      "description": "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.",
      "type": "string",
      "constraints": {
        "required": false
      },
      "example": "season:winter 2020 | grid:A1"
    },
    {
      "name": "deploymentTags",
      "description": "Tag(s) associated with the deployment. Formatted as a pipe (`|`) separated list for multiple values, with values optionally formatted as `key:value` pairs.",
      "skos:exactMatch": "http://rs.tdwg.org/ac/terms/tag",
      "type": "string",
      "constraints": {
        "required": false
      },
      "example": "forest edge | bait:food"
    },
    {
      "name": "deploymentComments",
      "description": "Comments or notes about the deployment.",
      "skos:exactMatch": "http://rs.tdwg.org/dwc/terms/eventRemarks",
      "type": "string",
      "constraints": {
        "required": false
      },
      "example": ""
    }
  ],
  "missingValues": [
    ""
  ],
  "primaryKey": "deploymentID"
}