app.gainforest.ac.deployment

{
  "description": "A passive acoustic monitoring device deployment record describing recorder setup, placement, and timing.",
  "key": "tid",
  "record": {
    "properties": {
      "altitude": {
        "description": "Altitude of the deployment location in meters above sea level (e.g., '312').",
        "maxGraphemes": 32,
        "type": "string"
      },
      "batteryType": {
        "description": "Battery type used (e.g., 'AA alkaline x3', 'AA lithium x3', 'USB power bank', 'solar panel').",
        "maxGraphemes": 64,
        "type": "string"
      },
      "createdAt": {
        "description": "Timestamp of record creation in the ATProto PDS.",
        "format": "datetime",
        "type": "string"
      },
      "decimalLatitude": {
        "description": "Decimal latitude of the deployment location in WGS84 (e.g., '-3.7452'). Aligns with dwc:decimalLatitude.",
        "maxGraphemes": 32,
        "type": "string"
      },
      "decimalLongitude": {
        "description": "Decimal longitude of the deployment location in WGS84 (e.g., '-62.2159'). Aligns with dwc:decimalLongitude.",
        "maxGraphemes": 32,
        "type": "string"
      },
      "deployedAt": {
        "description": "Date and time the device was placed and activated at the deployment location.",
        "format": "datetime",
        "type": "string"
      },
      "deviceModel": {
        "description": "Recording device model name (e.g., 'AudioMoth 1.2.0', 'AudioMoth 1.1.0', 'Wildlife Acoustics Song Meter SM4', 'Cornell Lab Swift'). Aligns with AC ac:captureDevice.",
        "maxGraphemes": 128,
        "type": "string"
      },
      "deviceSerialNumber": {
        "description": "Device serial number for inventory tracking and cross-referencing recordings.",
        "maxGraphemes": 64,
        "type": "string"
      },
      "equipmentRef": {
        "description": "AT-URI of the app.gainforest.equipment inventory record for the physical unit used in this deployment. Prefer this link over the freeform deviceModel/deviceSerialNumber strings when the unit is registered.",
        "format": "at-uri",
        "type": "string"
      },
      "eventRef": {
        "description": "AT-URI of the dwc.event sampling event this deployment is part of.",
        "format": "at-uri",
        "type": "string"
      },
      "firmwareVersion": {
        "description": "Firmware version loaded on the device at time of deployment (e.g., '1.8.1').",
        "maxGraphemes": 64,
        "type": "string"
      },
      "gain": {
        "description": "Gain setting configured on the device (e.g., 'low', 'medium', 'high', 'medium-high', '36dB'). AudioMoth-specific values: low/medium/high/medium-high/medium-low.",
        "maxGraphemes": 32,
        "type": "string"
      },
      "habitat": {
        "description": "Brief habitat description at the deployment site (e.g., 'primary rainforest edge, closed canopy ~30m'). Aligns with dwc:habitat.",
        "maxGraphemes": 512,
        "type": "string"
      },
      "microphoneType": {
        "description": "Microphone type used (e.g., 'built-in MEMS', 'external electret', 'ultrasonic MEMS', 'Knowles SPH0641LU4H-1').",
        "maxGraphemes": 128,
        "type": "string"
      },
      "mountingHeight": {
        "description": "Height above ground at which the device was mounted, in meters (e.g., '1.5').",
        "maxGraphemes": 32,
        "type": "string"
      },
      "mountingOrientation": {
        "description": "Orientation of the device microphone (e.g., 'horizontal', 'vertical-facing-up', 'vertical-facing-down', 'angled-45deg').",
        "maxGraphemes": 128,
        "type": "string"
      },
      "name": {
        "description": "A short human-readable label for this deployment (e.g., 'Site A North — AudioMoth March 2024').",
        "maxGraphemes": 256,
        "type": "string"
      },
      "recordingSchedule": {
        "description": "Human-readable description of the recording duty cycle and schedule (e.g., '5 min on / 10 min off, 18:00–06:00 UTC+0'). For AudioMoth, this reflects the schedule configured via the AudioMoth app.",
        "maxGraphemes": 512,
        "type": "string"
      },
      "remarks": {
        "description": "Free-text remarks about the deployment (e.g., notable issues, vegetation around device, signs of disturbance).",
        "maxGraphemes": 1024,
        "type": "string"
      },
      "retrievedAt": {
        "description": "Date and time the device was collected and deactivated. Null if still active.",
        "format": "datetime",
        "type": "string"
      },
      "sampleRateHz": {
        "description": "Sample rate configured on the device in Hz (e.g., 48000, 192000, 384000 for ultrasonic bat detection).",
        "minimum": 1,
        "type": "integer"
      },
      "siteRef": {
        "description": "AT-URI of the organization site record this deployment belongs to.",
        "format": "at-uri",
        "type": "string"
      },
      "storageMedia": {
        "description": "Storage media type and capacity (e.g., 'microSD 128GB SanDisk Endurance').",
        "maxGraphemes": 128,
        "type": "string"
      }
    },
    "required": [
      "name",
      "deviceModel",
      "deployedAt",
      "createdAt"
    ],
    "type": "object"
  },
  "type": "record"
}