app.gainforest.ac.deployment
Schema Diff
+7 -1
Compatibility Analysis
Backward Compatible
Backward compatible. 2 non-breaking changes.
Non-Breaking Changes (2)
- AddedVertex AddedVertex { vertex_id: "app.gainforest.ac.deployment:body.equipmentRef" }
- AddedEdge AddedEdge { src: "app.gainforest.ac.deployment:body", tgt: "app.gainforest.ac.deployment:body.equipmentRef", kind: "prop", name: Some("equipmentRef") }
Migration Guidance
Added Elements
AddedVertex { vertex_id: "app.gainforest.ac.deployment:body.equipmentRef" }
Additional Notes
- Non-breaking: AddedEdge { src: "app.gainforest.ac.deployment:body", tgt: "app.gainforest.ac.deployment:body.equipmentRef", kind: "prop", name: Some("equipmentRef") }
1
1
{
2
2
"id": "app.gainforest.ac.deployment",
3
3
"defs": {
4
4
"main": {
5
5
"key": "tid",
6
6
"type": "record",
7
7
"record": {
8
8
"type": "object",
9
9
"required": [
10
10
"name",
11
11
"deviceModel",
12
12
"deployedAt",
13
13
"createdAt"
14
14
],
15
15
"properties": {
16
16
"gain": {
17
17
"type": "string",
18
18
"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.",
19
19
"maxGraphemes": 32
20
20
},
21
21
"name": {
22
22
"type": "string",
23
23
"description": "A short human-readable label for this deployment (e.g., 'Site A North — AudioMoth March 2024').",
24
24
"maxGraphemes": 256
25
25
},
26
26
"habitat": {
27
27
"type": "string",
28
28
"description": "Brief habitat description at the deployment site (e.g., 'primary rainforest edge, closed canopy ~30m'). Aligns with dwc:habitat.",
29
29
"maxGraphemes": 512
30
30
},
31
31
"remarks": {
32
32
"type": "string",
33
33
"description": "Free-text remarks about the deployment (e.g., notable issues, vegetation around device, signs of disturbance).",
34
34
"maxGraphemes": 1024
35
35
},
36
36
"siteRef": {
37
37
"type": "string",
38
38
"format": "at-uri",
39
39
"description": "AT-URI of the organization site record this deployment belongs to."
40
40
},
41
41
"altitude": {
42
42
"type": "string",
43
43
"description": "Altitude of the deployment location in meters above sea level (e.g., '312').",
44
44
"maxGraphemes": 32
45
45
},
46
46
"eventRef": {
47
47
"type": "string",
48
48
"format": "at-uri",
49
49
"description": "AT-URI of the dwc.event sampling event this deployment is part of."
50
50
},
51
51
"createdAt": {
52
52
"type": "string",
53
53
"format": "datetime",
54
54
"description": "Timestamp of record creation in the ATProto PDS."
55
55
},
56
56
"deployedAt": {
57
57
"type": "string",
58
58
"format": "datetime",
59
59
"description": "Date and time the device was placed and activated at the deployment location."
60
60
},
61
61
"batteryType": {
62
62
"type": "string",
63
63
"description": "Battery type used (e.g., 'AA alkaline x3', 'AA lithium x3', 'USB power bank', 'solar panel').",
64
64
"maxGraphemes": 64
65
65
},
66
66
"deviceModel": {
67
67
"type": "string",
68
68
"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.",
69
69
"maxGraphemes": 128
70
70
},
71
71
"retrievedAt": {
72
72
"type": "string",
73
73
"format": "datetime",
74
74
"description": "Date and time the device was collected and deactivated. Null if still active."
75
75
},
76
+
"equipmentRef": {
77
+
"type": "string",
78
+
"format": "at-uri",
79
+
"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."
80
+
},
76
81
"sampleRateHz": {
77
82
"type": "integer",
78
83
"minimum": 1,
79
84
"description": "Sample rate configured on the device in Hz (e.g., 48000, 192000, 384000 for ultrasonic bat detection)."
80
85
},
81
86
"storageMedia": {
82
87
"type": "string",
83
88
"description": "Storage media type and capacity (e.g., 'microSD 128GB SanDisk Endurance').",
84
89
"maxGraphemes": 128
85
90
},
86
91
"microphoneType": {
87
92
"type": "string",
88
93
"description": "Microphone type used (e.g., 'built-in MEMS', 'external electret', 'ultrasonic MEMS', 'Knowles SPH0641LU4H-1').",
89
94
"maxGraphemes": 128
90
95
},
91
96
"mountingHeight": {
92
97
"type": "string",
93
98
"description": "Height above ground at which the device was mounted, in meters (e.g., '1.5').",
94
99
"maxGraphemes": 32
95
100
},
96
101
"decimalLatitude": {
97
102
"type": "string",
98
103
"description": "Decimal latitude of the deployment location in WGS84 (e.g., '-3.7452'). Aligns with dwc:decimalLatitude.",
99
104
"maxGraphemes": 32
100
105
},
101
106
"firmwareVersion": {
102
107
"type": "string",
103
108
"description": "Firmware version loaded on the device at time of deployment (e.g., '1.8.1').",
104
109
"maxGraphemes": 64
105
110
},
106
111
"decimalLongitude": {
107
112
"type": "string",
108
113
"description": "Decimal longitude of the deployment location in WGS84 (e.g., '-62.2159'). Aligns with dwc:decimalLongitude.",
109
114
"maxGraphemes": 32
110
115
},
111
116
"recordingSchedule": {
112
117
"type": "string",
113
118
"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.",
114
119
"maxGraphemes": 512
115
120
},
116
121
"deviceSerialNumber": {
117
122
"type": "string",
118
123
"description": "Device serial number for inventory tracking and cross-referencing recordings.",
119
124
"maxGraphemes": 64
120
125
},
121
126
"mountingOrientation": {
122
127
"type": "string",
123
128
"description": "Orientation of the device microphone (e.g., 'horizontal', 'vertical-facing-up', 'vertical-facing-down', 'angled-45deg').",
124
129
"maxGraphemes": 128
125
130
}
126
131
}
127
-
}
132
+
},
133
+
"description": "A passive acoustic monitoring device deployment record describing recorder setup, placement, and timing."
128
134
}
129
135
},
130
136
"$type": "com.atproto.lexicon.schema",
131
137
"lexicon": 1,
132
138
"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."
133
139
}