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