IoT-Enabled Field Acquisition#
The pycsamt.iot subpackage documents and audits IoT-enabled AMT,
MT, CSAMT, and CSEM acquisition. It does not replace the normal impedance,
quality-control, dimensionality, or inversion workflow. Instead, it records
the operational layer around those data: devices, stations, packets, edge
QC decisions, power, clock synchronisation, security configuration, and
provenance. It also bridges back into the science API, turning edge
impedance estimates into a pycsamt.z.z.Z and a preliminary EDI,
and seeding a re-occupation session from an existing EDI survey.
Use this guide to configure and audit the operational layer of an IoT-enabled field survey: telemetry, edge QC, monitoring, power, synchronisation, security, and provenance.
Guide Sections#
Build a FieldSession from devices, stations, telemetry packets,
station tables, and pipeline hand-off metadata.
Reduce live windows, score finite coverage and spikes, and encode edge QC decisions as telemetry.
Check SNR, powerline harmonics, frequency coverage, sensor dropout, contact resistance, and impedance stability.
Create canonical packets, use dry-run transports, write JSONL logs, replay messages, and inspect packet tables.
Turn telemetry packets into survey status, packet success rates, latency checks, and issue lists.
Plot dashboards, edge-QC summaries, power budgets, and clock quality panels from IoT sessions and packets.
Estimate load, harvest, runtime, autonomy, power state, and power telemetry for field devices.
Assess clock offset, drift, jitter, reference support, GPS lock, and synchronisation quality.
Record acquisition manifests, file hashes, QC decisions, station audits, and reproducibility bundles.
Configure credentials, TLS settings, authentication modes, secret redaction, and deployment security summaries.
Generate deterministic AMT-like channels, stations, networks, packet loss, GPS drift, and battery decay for demos and tests.
Core Concepts#
DeviceConfigA recorder, gateway, remote-reference node, or sensor node. It stores protocol, sample rate, station assignment, channels, and role.
StationConfigA field occupation location. It stores coordinates, profile chainage, channel list, dipole geometry, orientation, operator, and attached devices.
TelemetryPacketA timestamped message with a canonical topic and payload. Packet kinds include
data,qc,health,sync,power,event, andsource(controlled-source transmitter telemetry).FieldSessionA stateful survey container that links devices, stations, packets, monitoring, station tables, pipeline inputs, and provenance manifests.
MethodProfileCanonical acquisition characteristics for an
EMMethod(AMT, MT, CSAMT, CSEM, TDEM/TEM): frequency band, required channels, nominal sample rate, and controlled-source / powerline-sensitivity flags. Profiles drive method-aware QC.
Scope Note#
The IoT layer records operational evidence around acquisition. It does not change the electromagnetic inversion itself.
Edge packets can record finite-data coverage, spike and harmonic contamination indicators, frequency coverage, channel health, and accept/reject decisions. These metrics help identify poor acquisition windows and operational faults before downstream AMT/CSAMT processing.