# app.gainforest.ac.deployment

> Published by [gainforest.earth](https://lexicon.garden/identity/did:plc:qoti4acfmc5wg6zzmtix6hse)

✓ This is the authoritative definition for this NSID.

## 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.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:qoti4acfmc5wg6zzmtix6hse/app.gainforest.ac.deployment)
- [Documentation](https://lexicon.garden/lexicon/did:plc:qoti4acfmc5wg6zzmtix6hse/app.gainforest.ac.deployment/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:qoti4acfmc5wg6zzmtix6hse/app.gainforest.ac.deployment/examples)

## Definitions

### `app.gainforest.ac.deployment`

**Type**: `record`

A passive acoustic monitoring device deployment record describing recorder setup, placement, and timing.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `gain` | `string` | No | Gain setting configured on the device (e.g., 'low', 'medium', 'high', 'medium-high', '36dB'). AudioMoth-specific values: low/medium/high/medium-high/medium-low. |
| `name` | `string` | Yes | A short human-readable label for this deployment (e.g., 'Site A North — AudioMoth March 2024'). |
| `habitat` | `string` | No | Brief habitat description at the deployment site (e.g., 'primary rainforest edge, closed canopy ~30m'). Aligns with dwc:habitat. |
| `remarks` | `string` | No | Free-text remarks about the deployment (e.g., notable issues, vegetation around device, signs of disturbance). |
| `siteRef` | `string` (at-uri) | No | AT-URI of the organization site record this deployment belongs to. |
| `altitude` | `string` | No | Altitude of the deployment location in meters above sea level (e.g., '312'). |
| `eventRef` | `string` (at-uri) | No | AT-URI of the dwc.event sampling event this deployment is part of. |
| `createdAt` | `string` (datetime) | Yes | Timestamp of record creation in the ATProto PDS. |
| `deployedAt` | `string` (datetime) | Yes | Date and time the device was placed and activated at the deployment location. |
| `batteryType` | `string` | No | Battery type used (e.g., 'AA alkaline x3', 'AA lithium x3', 'USB power bank', 'solar panel'). |
| `deviceModel` | `string` | Yes | 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. |
| `retrievedAt` | `string` (datetime) | No | Date and time the device was collected and deactivated. Null if still active. |
| `sampleRateHz` | `integer` | No | Sample rate configured on the device in Hz (e.g., 48000, 192000, 384000 for ultrasonic bat detection). |
| `storageMedia` | `string` | No | Storage media type and capacity (e.g., 'microSD 128GB SanDisk Endurance'). |
| `microphoneType` | `string` | No | Microphone type used (e.g., 'built-in MEMS', 'external electret', 'ultrasonic MEMS', 'Knowles SPH0641LU4H-1'). |
| `mountingHeight` | `string` | No | Height above ground at which the device was mounted, in meters (e.g., '1.5'). |
| `decimalLatitude` | `string` | No | Decimal latitude of the deployment location in WGS84 (e.g., '-3.7452'). Aligns with dwc:decimalLatitude. |
| `firmwareVersion` | `string` | No | Firmware version loaded on the device at time of deployment (e.g., '1.8.1'). |
| `decimalLongitude` | `string` | No | Decimal longitude of the deployment location in WGS84 (e.g., '-62.2159'). Aligns with dwc:decimalLongitude. |
| `recordingSchedule` | `string` | No | 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. |
| `deviceSerialNumber` | `string` | No | Device serial number for inventory tracking and cross-referencing recordings. |
| `mountingOrientation` | `string` | No | Orientation of the device microphone (e.g., 'horizontal', 'vertical-facing-up', 'vertical-facing-down', 'angled-45deg'). |

## Raw Schema

```json
{
  "id": "app.gainforest.ac.deployment",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "name",
          "deviceModel",
          "deployedAt",
          "createdAt"
        ],
        "properties": {
          "gain": {
            "type": "string",
            "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
          },
          "name": {
            "type": "string",
            "description": "A short human-readable label for this deployment (e.g., 'Site A North — AudioMoth March 2024').",
            "maxGraphemes": 256
          },
          "habitat": {
            "type": "string",
            "description": "Brief habitat description at the deployment site (e.g., 'primary rainforest edge, closed canopy ~30m'). Aligns with dwc:habitat.",
            "maxGraphemes": 512
          },
          "remarks": {
            "type": "string",
            "description": "Free-text remarks about the deployment (e.g., notable issues, vegetation around device, signs of disturbance).",
            "maxGraphemes": 1024
          },
          "siteRef": {
            "type": "string",
            "format": "at-uri",
            "description": "AT-URI of the organization site record this deployment belongs to."
          },
          "altitude": {
            "type": "string",
            "description": "Altitude of the deployment location in meters above sea level (e.g., '312').",
            "maxGraphemes": 32
          },
          "eventRef": {
            "type": "string",
            "format": "at-uri",
            "description": "AT-URI of the dwc.event sampling event this deployment is part of."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "Timestamp of record creation in the ATProto PDS."
          },
          "deployedAt": {
            "type": "string",
            "format": "datetime",
            "description": "Date and time the device was placed and activated at the deployment location."
          },
          "batteryType": {
            "type": "string",
            "description": "Battery type used (e.g., 'AA alkaline x3', 'AA lithium x3', 'USB power bank', 'solar panel').",
            "maxGraphemes": 64
          },
          "deviceModel": {
            "type": "string",
            "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
          },
          "retrievedAt": {
            "type": "string",
            "format": "datetime",
            "description": "Date and time the device was collected and deactivated. Null if still active."
          },
          "sampleRateHz": {
            "type": "integer",
            "minimum": 1,
            "description": "Sample rate configured on the device in Hz (e.g., 48000, 192000, 384000 for ultrasonic bat detection)."
          },
          "storageMedia": {
            "type": "string",
            "description": "Storage media type and capacity (e.g., 'microSD 128GB SanDisk Endurance').",
            "maxGraphemes": 128
          },
          "microphoneType": {
            "type": "string",
            "description": "Microphone type used (e.g., 'built-in MEMS', 'external electret', 'ultrasonic MEMS', 'Knowles SPH0641LU4H-1').",
            "maxGraphemes": 128
          },
          "mountingHeight": {
            "type": "string",
            "description": "Height above ground at which the device was mounted, in meters (e.g., '1.5').",
            "maxGraphemes": 32
          },
          "decimalLatitude": {
            "type": "string",
            "description": "Decimal latitude of the deployment location in WGS84 (e.g., '-3.7452'). Aligns with dwc:decimalLatitude.",
            "maxGraphemes": 32
          },
          "firmwareVersion": {
            "type": "string",
            "description": "Firmware version loaded on the device at time of deployment (e.g., '1.8.1').",
            "maxGraphemes": 64
          },
          "decimalLongitude": {
            "type": "string",
            "description": "Decimal longitude of the deployment location in WGS84 (e.g., '-62.2159'). Aligns with dwc:decimalLongitude.",
            "maxGraphemes": 32
          },
          "recordingSchedule": {
            "type": "string",
            "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
          },
          "deviceSerialNumber": {
            "type": "string",
            "description": "Device serial number for inventory tracking and cross-referencing recordings.",
            "maxGraphemes": 64
          },
          "mountingOrientation": {
            "type": "string",
            "description": "Orientation of the device microphone (e.g., 'horizontal', 'vertical-facing-up', 'vertical-facing-down', 'angled-45deg').",
            "maxGraphemes": 128
          }
        }
      },
      "description": "A passive acoustic monitoring device deployment record describing recorder setup, placement, and timing."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1,
  "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."
}
```