app.gainforest.ac.deployment

{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "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"
    }
  },
  "description": "Bioacoustics recorder deployment record. Describes a passive acoustic monitoring (PAM) device — such as an AudioMoth, Song Meter, or Swift — placed at a fixed location for a period of time. One deployment produces many audio recordings; each ac.audio record references its deployment via deploymentRef. Captures the device configuration, placement details, and duty cycle that are constant across all recordings from that deployment.",
  "id": "app.gainforest.ac.deployment",
  "lexicon": 1
}