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