One audio window associated with microphone position and provenance. More...
#include <earcam_core.h>
Data Fields | |
| uint64_t | timestamp_ms |
| int32_t | shot_nr |
| double | lat_deg |
| double | lon_deg |
| double | agl_m |
| double | alt_m |
| double | level_db |
| double | trend_db |
| double | contrast_db |
| double | frequency_hz |
| bool | alarm |
| bool | clipped |
| bool | pose_aligned |
| double | pose_uncertainty_m |
| uint64_t | window_earliest_us |
| uint64_t | window_latest_us |
| uint64_t | window_sequence |
| int32_t | request_lat |
| int32_t | request_lon |
| bool | classifier |
| double | classifier_score |
| unsigned | classifier_class |
Detailed Description
One audio window associated with microphone position and provenance.
Keep gain fixed across a session: relative level differences drive localization. False pose_aligned preserves legacy arrival-time association; it must not be reported as exposure/audio-window synchronization.
Definition at line 55 of file earcam_core.h.
Field Documentation
◆ agl_m
| double ear_sample::agl_m |
Height above the supplied ground reference, metres.
Definition at line 60 of file earcam_core.h.
◆ alarm
| bool ear_sample::alarm |
Capture detector's tone-like alarm flag, not solver confidence.
Definition at line 66 of file earcam_core.h.
◆ alt_m
| double ear_sample::alt_m |
Microphone navigation altitude, metres; datum supplied by caller.
Definition at line 61 of file earcam_core.h.
◆ classifier
| bool ear_sample::classifier |
Distinguish PCM model acceptance from the native tone detector's alarm rule.
Definition at line 74 of file earcam_core.h.
◆ classifier_class
| unsigned ear_sample::classifier_class |
Model-owned class index; compare only within a fixed assignment.
Definition at line 76 of file earcam_core.h.
◆ classifier_score
| double ear_sample::classifier_score |
Model probability, never the acoustic level or localization confidence.
Definition at line 75 of file earcam_core.h.
◆ clipped
| bool ear_sample::clipped |
ADC saturation makes level comparisons unreliable.
Definition at line 67 of file earcam_core.h.
◆ contrast_db
| double ear_sample::contrast_db |
Tone prominence against the capture detector's background estimate.
Definition at line 64 of file earcam_core.h.
◆ frequency_hz
| double ear_sample::frequency_hz |
Dominant detector-bank frequency, hertz.
Definition at line 65 of file earcam_core.h.
◆ lat_deg
| double ear_sample::lat_deg |
Microphone latitude from associated navigation evidence, degrees.
Definition at line 58 of file earcam_core.h.
◆ level_db
| double ear_sample::level_db |
Band loudness, dBFS or calibrated dB SPL; never mix conventions.
Definition at line 62 of file earcam_core.h.
◆ lon_deg
| double ear_sample::lon_deg |
Microphone longitude from associated navigation evidence, degrees.
Definition at line 59 of file earcam_core.h.
◆ pose_aligned
| bool ear_sample::pose_aligned |
Pose association used bounded audio-window timing evidence.
Definition at line 68 of file earcam_core.h.
◆ pose_uncertainty_m
| double ear_sample::pose_uncertainty_m |
Adapter-supplied spatial uncertainty, metres; not solver error.
Definition at line 69 of file earcam_core.h.
◆ request_lat
| int32_t ear_sample::request_lat |
Original FC coordinates in 1e7 degrees, retained for timing/pose diagnostics.
Definition at line 73 of file earcam_core.h.
◆ request_lon
| int32_t ear_sample::request_lon |
Definition at line 73 of file earcam_core.h.
◆ shot_nr
| int32_t ear_sample::shot_nr |
Associated FC photo/request number; not the audio sequence.
Definition at line 57 of file earcam_core.h.
◆ timestamp_ms
| uint64_t ear_sample::timestamp_ms |
Producer monotonic report timestamp, milliseconds; capture bounds are separate.
Definition at line 56 of file earcam_core.h.
◆ trend_db
| double ear_sample::trend_db |
Fast-minus-slow envelope level used to favor approaching evidence.
Definition at line 63 of file earcam_core.h.
◆ window_earliest_us
| uint64_t ear_sample::window_earliest_us |
Audio-window bounds in host monotonic microseconds, followed by producer sequence.
Definition at line 71 of file earcam_core.h.
◆ window_latest_us
| uint64_t ear_sample::window_latest_us |
Definition at line 71 of file earcam_core.h.
◆ window_sequence
| uint64_t ear_sample::window_sequence |
Definition at line 71 of file earcam_core.h.
The documentation for this struct was generated from the following file:
- modules/ear_cam/earcam_core.h