Compare commits

..

15 Commits
v2330 ... main

Author SHA1 Message Date
ruv
db5a898372 docs(readme): move animated hero GIF to top banner position 2026-09-02 01:31:51 -04:00
ruv
b11422459e docs(readme): add animated hero GIF
Real-time-style animated visualization illustrating RuView's pose
estimation, breathing, and heart-rate sensing capability, generated
via MiniMax H3 image-to-video from the existing hero graphic.
2026-09-02 01:27:34 -04:00
rUv
e5bf0d4892 feat(forecast): add independent Rust multivariate training stack (#1766)
* feat(forecast): add independent Rust training stack

Signed-off-by: Codex <codex@openai.com>

* docs(forecast): record informal HPO exploration note (unaccepted)

Records an exploratory Darwin Mode numeric-genome hyperparameter search
against the tiny_ci synthetic accuracy protocol: WQL improved 0.257 -> 0.161
-> 0.153 over two search rounds, staying ahead of both baselines throughout.
Explicitly scoped as informal/exploratory (not a frozen leakage-free report,
not eligible for the evidence ledger, not validated for large_linux or any
real dataset) per this doc's own evidence-tagging discipline.

* feat(forecast-core): add per-horizon weighted quantile loss

weighted_quantile_loss collapses the whole horizon into one aggregate
number, hiding whether error grows with lead time. Add a sibling
function using the identical per-cell pinball formula and domain
checks, just reduced per horizon step instead of globally. A unit
test reconstructs the aggregate from the per-step numerators/
denominators to prove the two functions agree exactly, not just
approximately.

* feat(forecast-model): add evaluation-only local activation

Adds activate_for_evaluation and build_eval_input, gated behind the
cpu feature. activate_for_evaluation self-signs an unsigned candidate
with a fixed, publicly-known, non-secret Ed25519 key so a CLI operator
can run inference against their own just-trained candidate without a
real release signature -- explicitly never a production trust path,
documented as such in the module doc comment. The schema-digest check
in ArtifactActivationPolicy still applies in full; only signing is
relaxed. build_eval_input constructs a single-window ModelInput for
CPU inference from raw context-major values/mask arrays, matching the
training batch builders exact time-feature/descriptor encoding.

Six unit tests cover: malformed-candidate rejection, digest-mismatch
rejection (proving the schema check has teeth even on this relaxed
path), getting past the policy gate with a matching digest, and
eval-input shape validation.

* feat(forecast-train): add evaluate and prepare-synthetic-dataset CLI

Turns this sessions throwaway HPO scripts into real, tested CLI
surfaces, replacing two example binaries that bypassed the CLI/TOML
training path entirely.

prepare-synthetic-dataset generates a larger, configurable synthetic
training shard (default 24 windows) plus a matching train-local.toml
with the given OptimizerSpec hyperparameters baked in, and a separate
held-out test.jsonl -- the same synthetic-only, local-validation-only
posture as prepare-local-example, just bigger and configurable.

evaluate scores a trained (unsigned) candidate against held-out
windows and the LastValue/SeasonalNaive baselines: overall weighted
quantile loss, a per-horizon breakdown, 80% interval coverage, and
missingness, for the model and both baselines. Explicitly lists what
docs/benchmarks/ruforecast.mds full accuracy protocol additionally
asks for that this does not cover (abstention coverage, selective
risk, site/device slices, interference regime, RuVector-retrieval
ablation) rather than silently omitting them -- each needs
infrastructure a single-entity synthetic fixture does not have.

Together the three real commands (prepare-synthetic-dataset,
train-local, evaluate) reproduce the exact WQL numbers the old
library-bypassing example scripts produced for the same
hyperparameters, confirmed by re-running the harness/ruview HPO
dry-run end to end against the new CLI path.

New integration test trains a real candidate via smoke, evaluates it
against held-out synthetic windows, and asserts the full report shape
and an empty-input rejection.

* feat(forecast-train): add prepare-synthetic-dataset --seed + Autogenous bridge

--seed (default 0, backward compatible) makes prepare-synthetic-dataset's
generator deterministic per offset: same seed -> byte-identical corpus
across runs (needed to train two genomes on the SAME corpus for a fair
comparison); different seeds -> genuinely independent corpora (needed for
honest multi-seed/multi-judge evaluation upstream, both in
harness/ruview/flywheel/ruforecast/gate.mjs's fitness function and in the
new v2/crates/ruforecast-autogenous-bridge crate added here).

ruforecast-autogenous-bridge is a LOCAL-DEV-ONLY (excluded from the v2
workspace, publish = false) bridge from this crate's real evaluate CLI
into ruvnet/autogenous's new regression-candidate promotion path (separate,
unpushed branch feat/regression-candidate-kind): runs N independent
train+evaluate judges on genuinely distinct synthetic corpora, signs
receipts, and gets a real cryptographically-verified PROMOTE/REJECT
decision -- defense in depth on top of, not a replacement for, Darwin's own
promotion gate. Path-depends on a sibling autogenous checkout that does not
exist in CI; build/run directly via `cargo build --manifest-path
crates/ruforecast-autogenous-bridge/Cargo.toml`.

cargo test -p ruview-forecast-train --no-default-features --features
cpu,cli: all green (unaffected existing tests + this backward-compatible
addition).

* docs(forecast): retract round-2 HPO result, record honest multi-seed finding

The earlier "Informal HPO exploration note" claimed a real improvement
(WQL 0.257 -> 0.153) from a 3-round hyperparameter search. That search
evaluated every candidate against one fixed synthetic corpus (seed 0) for
every round -- textbook overfitting. Independent verification against two
fresh corpora (via the new ruforecast-autogenous-bridge crate) showed the
"winner" losing to the baseline on both.

Fixed the root cause in harness/ruview/flywheel/ruforecast/gate.mjs:
candidates are now scored against three independent corpora, worst-case
across them, not one fixed corpus.

Re-ran the search under the fix. It found a new winner that genuinely beat
baseline on all three of its own search seeds -- and that winner ALSO lost
independent verification on fresh seeds. Two independent search rounds,
pre- and post-fix, both produced an illusory "winner." The honest reading:
at this dataset scale (24 synthetic windows) held-out WQL varies enormously
by which corpus is drawn, regardless of hyperparameters -- confirmed
directly by the baseline genome's own primary swinging from 0.83 to a full
regression across the three fixed search seeds with unchanged
hyperparameters. No RuForecast hyperparameter configuration has been shown
to reliably beat the trivial baselines out-of-sample at this scale.

Also fixes a real design inconsistency surfaced by this exploration: the
Autogenous regression-candidate promotion verifier
(envelope::regression::verify_regression_promotion, separate unpushed
ruvnet/autogenous branch feat/regression-candidate-kind) required all
judges to share one corpus_id, which conflicts with this kind's
intentional cross-corpus judge design. Corrected there (commit bfa4c48);
did not change either REJECT verdict, which were already driven by the
real NotBetterThanParent signal on their own.

Append-only: the original round-2 row is kept, read together with this
new amendment section, per this doc's own evidence-ledger discipline.

* refactor(forecast): extract RuForecast to ruvnet/RuForecast submodule

Mirrors the v2/crates/worldgraph pattern: RuForecast becomes its own
independent public repo/workspace (ruforecast-core/model/train), mounted
at v2/crates/ruforecast as a git submodule, with v2/Cargo.toml path-depping
into its sub-crates and excluding the submodule from the v2 workspace.

Full v2 --workspace check passes; the ruforecast CLI builds and runs
correctly from its new location. Real git history for the extracted
crates (7 commits) was preserved via git-filter-repo, not squashed.

* feat(autogenous-bridge): real-data independent verification tool

real_data_verify.rs: signs two real, temporally-independent judge
measurements (different train/test split boundaries on the same real
household vitals corpus, not synthetic seeds) through the real
Autogenous regression-candidate promotion path, and gets a genuine
cryptographically-checked PROMOTE/REJECT verdict.

Result recorded (see docs/benchmarks/ruforecast.md): REJECT. One judge
nominally beat the trivial baseline but by less than the 0.01
non-inferiority margin; the other judge lost outright. Consistent with
every synthetic-data search this session -- no configuration has yet
been shown to reliably beat trivial baselines out-of-sample, now
including a real 6390-sample household corpus.

Bumps the ruforecast submodule to pick up the evaluate real-gap fix.

* docs(forecast): record real-household-data result (REJECT, signed)

6390 real vital-signs samples, two independent temporal splits,
independently verified via the real Autogenous regression-candidate
promotion path. Signed verdict: REJECT -- neither split cleared the
non-inferiority margin. Same conclusion as every synthetic search this
session, now confirmed with real data too: more real data is the
credible next lever, not further search on this scale of fixture.

* chore(forecast): point ruforecast submodule at published main (post gap-tolerance fix)

* ci(forecast): fix ruforecast-ci.yml for the new v2/crates/ruforecast submodule layout

The RuForecast crates were extracted into a standalone submodule (v2/crates/ruforecast, mirroring the existing v2/crates/worldgraph pattern) and are no longer members of the v2 workspace. The CI workflow still referenced the old in-tree package names/paths (ruview-forecast-core/model/train under v2/), which broke every forecast job with "cannot specify features for packages outside of workspace".

Fixed every job to target the submodule: working-directory -> v2/crates/ruforecast, -p ruview-forecast-* -> -p ruforecast-*, all hardcoded Cargo.toml/source paths in the Python assertion and clean-room-scan blocks, the Swatinem/rust-cache workspaces input, the artifact-tree output paths, and the two levels of relative path (../ -> ../../) in the informational-benchmark steps whose working directory moved one level deeper.

Also collapsed the paths: trigger filters internal-crate globs (v2/crates/ruview-forecast-*/**) down to the single v2/crates/ruforecast path, since GitHub Actions path filters only ever see a submodule gitlink change as one entry in the parent tree, never its internal file paths -- the old globs could never have matched anything.

Includes a real cargo fmt fix (submodule commit d9902f9) for formatting drift left over from the earlier real-data gap-tolerance fix, which the contract job's fmt --check step would otherwise have failed on.

All four forecast CI jobs' real commands verified locally before push: cargo test/check for CPU, CUDA/WGPU compile-check, the contract job's Python assertion block, the hosted-boundaries clean-room scan, and cargo fmt --check.

* docs(forecast): record real BIDMC cross-entity holdout result (REJECT)

Two independent real-patient partitions (34/16 and 24/26 splits, 53 total
ICU patients from PhysioNet BIDMC, Open Data Commons Attribution License
v1.0) both show the model losing to trivial baselines by a decisive margin
(+69% and +601% worse WQL). First genuine cross-entity real-data test this
project has run; same conclusion as every prior synthetic and single-household
test. Full Autogenous signed verification was not run for this entry -
flagged explicitly in the note.

* chore(forecast): point ruforecast submodule at published main (example feature-gate fix)

* chore(forecast): point ruforecast submodule at published main (clippy fix)

---------

Signed-off-by: Codex <codex@openai.com>
2026-09-01 23:35:42 -04:00
rUv
e04f269f1a Merge pull request #1762 from ruvnet/codex/zone-aware-calibration
firmware: fail closed occupancy and stabilize C6 temporal sensing
2026-08-31 14:41:43 -04:00
ruv
12a61c16e8 docs(firmware): prepare 0.8.8 release 2026-08-31 14:14:08 -04:00
ruv
a70803fe31 fix(security): update wasmtime to 36.0.14 2026-08-31 14:14:08 -04:00
ruv
4b295b1b4d docs(firmware): qualify second ESP32 C6 node 2026-08-31 13:57:21 -04:00
ruv
615e2d419b docs(firmware): qualify ESP32 S3 transport 2026-08-31 13:31:19 -04:00
ruv
f85896cccb feat(firmware): stabilize rate-aware ESP32 sensing 2026-08-31 12:56:32 -04:00
ruv
0a0b3411f8 fix: fail closed contradictory ESP32 occupancy evidence 2026-08-31 12:56:32 -04:00
rUv
08210b02c9 Update README.md
removed promo imgs.
2026-08-31 12:42:10 -04:00
ruv
27f5540663 feat(server): advertise local RuView installations 2026-08-27 15:52:10 -04:00
rUv
b742eae7d6 fix(sensing): fuse only coherent frame cohorts (#1726) 2026-08-27 10:10:31 -04:00
rUv
d42c5581f3 feat(rufield): ultrasonic as the field surface's second modality (#1716)
ADR-262 §8 question 5 left the second modality open, asking whether it should
be rvcsi. This answers ultrasonic instead, because the cost collapsed:
rufield-adapters now ships UltrasonicReplayAdapter, the first adapter for
Modality::Ultrasonic (registry code 7, empty since v0.1), which parses,
validates and signs BatVu range profiles upstream. RuView only has to decide
what it will put on a wire.

Bumps vendor/rufield 43b1df3 -> 9955672. Two struct literals in bridge.rs gain
fields added upstream (Observation: track_id, attributes, identity_evidence,
channel_sounding_provenance; SensorDescriptor: coordinate_frame, position_m,
orientation_xyzw). All left empty, each for a stated reason rather than a
convenient default — the pose fields in particular, because a CSI link has no
boresight and §6 makes no validated room-coordinate claim. The nine existing
P1 gates pass unchanged.

The decision this module makes is structural rather than a runtime refusal.
The adapter's full per-bin frame is P0 and would be dropped by the egress gate
after all the work of parsing and signing it; its 32-bin coarse reduction is
P1 and egress-safe. So the module does not offer the choice — it configures
the coarse mode, because a consumer cannot un-coarsen a coarse profile whereas
a check can be reordered. The gate still runs and is asserted to drop nothing.

12 gates in tests/ultrasonic_gates.rs, including the honest negative result: an
ultrasonic scan produces no fused inferences at all, and both independent
reasons are pinned. The adapter declines to populate `presence` — one
transducer pair cannot distinguish a person from a coat over the back of a
chair — and the engine's feature vocabulary is entirely statements about a
body, so range_m has nothing to drive.

The fixture is BatVu's own emitter output, byte-identical to the one in
ruvnet/rufield, so schema drift fails a build in one of three repositories
rather than an ingest in a deployment.

Not wired into the running server; P1 shipped as a library before P3 wired it
in, and this follows the same staging.
2026-08-25 21:40:53 -04:00
rUv
0df48df7b2 feat: add native iPhone LiDAR sensor and web viewer (#1684)
* feat(ios): add RuView LiDAR frame protocol

* feat(ios): capture ARKit scene depth for RuView

* feat(ios): stream compact LiDAR frames over websocket

* feat(ios): add native LiDAR capture UI

* feat(ios): add RuView LiDAR app entrypoint

* feat(web): add LiDAR bridge web package

* feat(web): decode RuView LiDAR wire frames

* feat(web): add local LiDAR websocket relay

* feat(web): add LiDAR browser viewer

* feat(web): render live LiDAR point cloud

* fix(ios): use wall clock time for LiDAR provenance

* feat(web): style LiDAR viewer

* test(web): add LiDAR codec tests

* docs: add iPhone LiDAR integration guide

* docs(adr): define iPhone LiDAR sensor bridge

* fix(ios): harden and validate LiDAR bridge

* fix(ios): qualify LiDAR wire depth type
2026-08-22 18:06:16 -04:00
77 changed files with 9336 additions and 224 deletions

View File

@@ -162,10 +162,14 @@ jobs:
mkdir -p release-staging
cp build/esp32-csi-node.bin release-staging/${{ matrix.artifact_app }}
cp build/partition_table/partition-table.bin release-staging/${{ matrix.artifact_pt }}
if [ "${{ matrix.variant }}" = "8mb" ]; then
cp build/bootloader/bootloader.bin release-staging/bootloader.bin
cp build/ota_data_initial.bin release-staging/ota_data_initial.bin
fi
cp build/bootloader/bootloader.bin release-staging/bootloader.bin
cp build/ota_data_initial.bin release-staging/ota_data_initial.bin
cp version.txt release-staging/version.txt
(cd release-staging && sha256sum \
"${{ matrix.artifact_app }}" \
"${{ matrix.artifact_pt }}" \
bootloader.bin ota_data_initial.bin version.txt \
> SHA256SUMS.txt)
ls -la release-staging/
- name: Check QEMU ESP32-S3 support status

70
.github/workflows/iphone-lidar.yml vendored Normal file
View File

@@ -0,0 +1,70 @@
name: iPhone LiDAR integration
on:
push:
branches: [main]
paths:
- 'integrations/iphone-lidar/**'
- 'docs/adr/ADR-340-iphone-lidar-sensor-bridge.md'
- '.github/workflows/iphone-lidar.yml'
pull_request:
paths:
- 'integrations/iphone-lidar/**'
- 'docs/adr/ADR-340-iphone-lidar-sensor-bridge.md'
- '.github/workflows/iphone-lidar.yml'
permissions:
contents: read
jobs:
web:
name: Node relay and codec
runs-on: ubuntu-latest
defaults:
run:
working-directory: integrations/iphone-lidar/web
steps:
- name: Checkout code
uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262
- name: Set up Node
uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020
with:
node-version: '22'
cache: npm
cache-dependency-path: integrations/iphone-lidar/web/package-lock.json
- name: Install dependencies
run: npm ci --ignore-scripts
- name: Run tests
run: npm test
- name: Audit runtime dependencies
run: npm audit --omit=optional --audit-level=high
ios:
name: iOS 17 compile
runs-on: macos-15
steps:
- name: Checkout code
uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262
- name: Compile native sources with strict concurrency
shell: bash
run: |
set -euo pipefail
sdk="$(xcrun --sdk iphoneos --show-sdk-path)"
build_dir="$RUNNER_TEMP/ruview-lidar-build"
mkdir -p "$build_dir"
cd "$build_dir"
xcrun swiftc \
-parse-as-library \
-target arm64-apple-ios17.0 \
-sdk "$sdk" \
-module-name RuViewLiDAR \
-strict-concurrency=complete \
-warnings-as-errors \
-emit-module \
-emit-module-path "$build_dir/RuViewLiDAR.swiftmodule" \
-c "$GITHUB_WORKSPACE"/integrations/iphone-lidar/native/RuViewLiDAR/*.swift

627
.github/workflows/ruforecast-ci.yml vendored Normal file
View File

@@ -0,0 +1,627 @@
name: RuForecast Rust CI
on:
push:
branches: [main, develop, 'feat/*', 'feature/*']
paths:
- 'v2/crates/ruforecast'
- 'v2/Cargo.toml'
- 'v2/Cargo.lock'
- 'v2/rust-toolchain.toml'
- 'scripts/csi-data-policy-check.sh'
- 'scripts/run-ruforecast-benchmarks.sh'
- 'docs/adr/ADR-348-*.md'
- 'docs/adr/ADR-349-*.md'
- 'docs/adr/ADR-350-*.md'
- 'docs/adr/README.md'
- 'docs/benchmarks/ruforecast.md'
- 'docs/huggingface/RUVIEW_FORECAST_MODEL_CARD_TEMPLATE.md'
- 'docs/security/ruview-forecast-*'
- 'docs/validation/ruforecast-requirements-evidence.md'
- '.github/workflows/ruforecast-ci.yml'
pull_request:
branches: [main, develop]
paths:
- 'v2/crates/ruforecast'
- 'v2/Cargo.toml'
- 'v2/Cargo.lock'
- 'v2/rust-toolchain.toml'
- 'scripts/csi-data-policy-check.sh'
- 'scripts/run-ruforecast-benchmarks.sh'
- 'docs/adr/ADR-348-*.md'
- 'docs/adr/ADR-349-*.md'
- 'docs/adr/ADR-350-*.md'
- 'docs/adr/README.md'
- 'docs/benchmarks/ruforecast.md'
- 'docs/huggingface/RUVIEW_FORECAST_MODEL_CARD_TEMPLATE.md'
- 'docs/security/ruview-forecast-*'
- 'docs/validation/ruforecast-requirements-evidence.md'
- '.github/workflows/ruforecast-ci.yml'
workflow_dispatch:
permissions:
contents: read
concurrency:
group: ruforecast-${{ github.workflow }}-${{ github.ref }}
cancel-in-progress: true
env:
CARGO_TERM_COLOR: always
CARGO_PROFILE_DEV_DEBUG: '0'
CARGO_PROFILE_TEST_DEBUG: '0'
CARGO_PROFILE_BENCH_DEBUG: '0'
CARGO_PROFILE_RELEASE_DEBUG: '0'
jobs:
contract-rust-189:
name: Forecast contract and feature-off boundary (Rust 1.89)
runs-on: ubuntu-latest
timeout-minutes: 45
steps:
- name: Checkout recursively
uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262
with:
persist-credentials: false
submodules: recursive
- name: Install Rust 1.89 with lint components
uses: dtolnay/rust-toolchain@4cda84d5c5c54efe2404f9d843567869ab1699d4
with:
toolchain: 1.89.0
components: rustfmt,clippy
- name: Cache Cargo artifacts
uses: Swatinem/rust-cache@e18b497796c12c097a38f9edb9d0641fb99eee32
with:
workspaces: v2/crates/ruforecast
key: ruforecast-rust-189
- name: Validate benchmark runner and evidence contract
shell: bash
run: |
set -euo pipefail
bash -n scripts/run-ruforecast-benchmarks.sh
test -x scripts/run-ruforecast-benchmarks.sh
test -f docs/benchmarks/ruforecast.md
test -f docs/huggingface/RUVIEW_FORECAST_MODEL_CARD_TEMPLATE.md
test -f docs/security/ruview-forecast-clean-room.md
test -f docs/security/ruview-forecast-threat-model.md
test -f docs/validation/ruforecast-requirements-evidence.md
for adr_number in 348 349 350; do
mapfile -t adr_files < <(
find docs/adr -maxdepth 1 -type f -name "ADR-${adr_number}-*.md" -print
)
if [[ "${#adr_files[@]}" -ne 1 ]]; then
echo "Expected exactly one ADR-${adr_number} file, found ${#adr_files[@]}" >&2
exit 1
fi
grep -q "^# ADR-${adr_number}:" "${adr_files[0]}"
grep -Eq '^[-*] \*\*Status\*\*: (Proposed|Accepted|Superseded|Deprecated)( |$|—)|^## Status' "${adr_files[0]}"
done
grep -q '^## Requirements' docs/adr/ADR-348-*.md
grep -q '^## Acceptance gates' docs/adr/ADR-348-*.md
grep -q '^## Requirements and acceptance' docs/adr/ADR-349-*.md
grep -q '^## Requirements and acceptance' docs/adr/ADR-350-*.md
for adr_number in 348 349 350; do
grep -q "| \[ADR-${adr_number}\](ADR-${adr_number}-" docs/adr/README.md \
|| { echo "ADR-${adr_number} is missing from the ADR index" >&2; exit 1; }
done
for number in $(seq 1 12); do
requirement="$(printf 'RF-%03d' "$number")"
grep -q "| ${requirement} |" docs/validation/ruforecast-requirements-evidence.md \
|| { echo "Missing evidence row for ${requirement}" >&2; exit 1; }
done
for number in $(seq 1 8); do
requirement="$(printf 'FT-%03d' "$number")"
grep -q "| ${requirement} |" docs/validation/ruforecast-requirements-evidence.md \
|| { echo "Missing evidence row for ${requirement}" >&2; exit 1; }
done
for number in $(seq 1 9); do
requirement="$(printf 'PM-%03d' "$number")"
grep -q "| ${requirement} |" docs/validation/ruforecast-requirements-evidence.md \
|| { echo "Missing evidence row for ${requirement}" >&2; exit 1; }
done
python3 - <<'PY'
from pathlib import Path
import tomllib
root = Path("v2/crates/ruforecast/crates")
core = tomllib.loads((root / "ruforecast-core/Cargo.toml").read_text())
model = tomllib.loads((root / "ruforecast-model/Cargo.toml").read_text())
train = tomllib.loads((root / "ruforecast-train/Cargo.toml").read_text())
assert core.get("features", {}).get("default", []) == []
assert model["features"]["default"] == [], "model defaults must stay backend-free"
assert train["features"]["default"] == [], "train defaults must stay backend-free"
assert {"model", "cpu", "cuda", "wgpu", "ruvector"} <= model["features"].keys()
assert {"cpu", "cuda", "training", "cli", "server", "fal-client"} <= train["features"].keys()
assert {"model", "dep:burn-ndarray"} <= set(model["features"]["cpu"])
assert {"model", "dep:burn-cuda"} <= set(model["features"]["cuda"])
assert {"model", "dep:burn-wgpu"} <= set(model["features"]["wgpu"])
assert "dep:ruvector-core" in model["features"]["ruvector"]
assert {"ruforecast-model/cpu", "training"} <= set(train["features"]["cpu"])
assert {"ruforecast-model/cuda", "training"} <= set(train["features"]["cuda"])
bins = {entry["name"]: entry for entry in train.get("bin", [])}
assert bins["ruforecast"]["required-features"] == ["cli"]
model_benches = {entry["name"]: entry for entry in model.get("bench", [])}
train_benches = {entry["name"]: entry for entry in train.get("bench", [])}
assert model_benches["forecast_inference"]["harness"] is False
assert model_benches["forecast_inference"]["required-features"] == ["cpu"]
assert train_benches["data_pipeline"]["harness"] is False
assert train_benches["data_pipeline"]["required-features"] == ["cpu"]
PY
- name: Check formatting for forecast packages only
working-directory: v2/crates/ruforecast
run: >-
cargo +1.89.0 fmt
-p ruforecast-core
-p ruforecast-model
-p ruforecast-train
-- --check
- name: Prove feature-off graph excludes Burn and CubeCL
working-directory: v2/crates/ruforecast
shell: bash
run: |
set -euo pipefail
: > forecast-feature-off-tree.txt
for package in ruforecast-core ruforecast-model ruforecast-train; do
cargo +1.89.0 tree --locked -e normal,build -p "$package" --no-default-features \
>> forecast-feature-off-tree.txt
done
if grep -Eiq '(^|[[:space:]])(burn|cubecl)(-|[[:space:]])' forecast-feature-off-tree.txt; then
echo 'Burn/CubeCL entered the Rust 1.89 feature-off dependency graph.' >&2
cat forecast-feature-off-tree.txt >&2
exit 1
fi
- name: Check feature-off packages
working-directory: v2/crates/ruforecast
run: >-
cargo +1.89.0 check --locked
-p ruforecast-core
-p ruforecast-model
-p ruforecast-train
--no-default-features --all-targets
- name: Test model-neutral core
working-directory: v2/crates/ruforecast
run: >-
cargo +1.89.0 test --locked
-p ruforecast-core
--no-default-features --lib --tests
- name: Test model contracts without a model backend
working-directory: v2/crates/ruforecast
run: >-
cargo +1.89.0 test --locked
-p ruforecast-model
--no-default-features --lib --tests
- name: Test RuVector retrieval boundary without a model backend
working-directory: v2/crates/ruforecast
run: >-
cargo +1.89.0 test --locked
-p ruforecast-model
--no-default-features --features ruvector --lib --tests
- name: Clippy RuVector retrieval boundary
working-directory: v2/crates/ruforecast
run: >-
cargo +1.89.0 clippy --locked
-p ruforecast-model
--no-default-features --features ruvector --all-targets -- -D warnings
- name: Clippy forecast packages without backend features
working-directory: v2/crates/ruforecast
run: >-
cargo +1.89.0 clippy --locked
-p ruforecast-core
-p ruforecast-model
-p ruforecast-train
--no-default-features --all-targets -- -D warnings
- name: Upload feature-off dependency tree
if: always()
uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02
with:
name: ruforecast-feature-off-tree
path: v2/crates/ruforecast/forecast-feature-off-tree.txt
if-no-files-found: error
hosted-boundaries-rust-189:
name: Forecast hosted boundaries and privacy contract (Rust 1.89)
runs-on: ubuntu-latest
timeout-minutes: 45
steps:
- name: Checkout recursively
uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262
with:
persist-credentials: false
submodules: recursive
- name: Install Rust 1.89 with Clippy
uses: dtolnay/rust-toolchain@4cda84d5c5c54efe2404f9d843567869ab1699d4
with:
toolchain: 1.89.0
components: clippy
- name: Cache Cargo artifacts
uses: Swatinem/rust-cache@e18b497796c12c097a38f9edb9d0641fb99eee32
with:
workspaces: v2/crates/ruforecast
key: ruforecast-hosted-rust-189
- name: Enforce clean-room source, secret, and hosted-wire boundary
shell: bash
run: |
set -euo pipefail
python3 - <<'PY'
from pathlib import Path
import re
import sys
roots = [
Path("v2/crates/ruforecast/crates/ruforecast-core"),
Path("v2/crates/ruforecast/crates/ruforecast-model"),
Path("v2/crates/ruforecast/crates/ruforecast-train"),
]
text_suffixes = {".json", ".py", ".rs", ".sh", ".toml", ".yaml", ".yml"}
forbidden_source = re.compile(r"(?i)\b(?:times[ _-]?fm|google[ _/-]?research)\b")
secret_patterns = {
"private key": re.compile(r"-----BEGIN (?:RSA |EC |OPENSSH )?PRIVATE KEY-----"),
"AWS access key": re.compile(r"\bAKIA[0-9A-Z]{16}\b"),
"JWT": re.compile(r"\beyJ[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}\b"),
"presigned URL": re.compile(r"(?i)[?&](?:X-Amz-Signature|X-Goog-Signature)="),
"literal FAL_KEY": re.compile(r"(?i)\bFAL_KEY\b\s*[:=]\s*['\"][^'$<{\"\n]{8,}['\"]"),
}
forbidden_blobs = {".ckpt", ".mpk", ".npy", ".npz", ".onnx", ".pt", ".pth", ".safetensors"}
errors = []
for root in roots:
for path in root.rglob("*"):
if not path.is_file() or "target" in path.parts:
continue
if path.suffix.lower() in forbidden_blobs:
errors.append(f"forbidden checked-in model/data blob: {path}")
continue
if path.suffix.lower() not in text_suffixes:
continue
text = path.read_text(encoding="utf-8")
if forbidden_source.search(text):
errors.append(f"forbidden clean-room source/import reference: {path}")
for label, pattern in secret_patterns.items():
if pattern.search(text):
errors.append(f"possible {label} in {path}")
fal_source = Path("v2/crates/ruforecast/crates/ruforecast-train/src/fal.rs").read_text()
for struct_name in ("HostedOptimizer", "HostedBudget", "HostedSyntheticPayload"):
match = re.search(
rf"pub struct {struct_name}\s*\{{(?P<body>.*?)^\}}",
fal_source,
flags=re.MULTILINE | re.DOTALL,
)
if match is None:
errors.append(f"missing hosted wire struct: {struct_name}")
continue
body = match.group("body")
fields = re.findall(r"^\s*pub\s+([A-Za-z0-9_]+)\s*:", body, re.MULTILINE)
forbidden_fields = (
"account", "data_policy", "dataset", "device", "identity", "path",
"person", "room", "session", "site", "split", "subject", "tenant",
"workspace",
)
for field in fields:
lowered = field.lower()
if any(fragment in lowered for fragment in forbidden_fields):
errors.append(f"forbidden hosted field {struct_name}.{field}")
if "bytes" in lowered and field not in {
"max_artifact_bytes",
"max_memory_bytes",
}:
errors.append(f"unapproved hosted byte field {struct_name}.{field}")
if "DataPolicy" in body:
errors.append(f"DataPolicy entered hosted wire struct {struct_name}")
if errors:
print("\n".join(errors), file=sys.stderr)
raise SystemExit(1)
PY
- name: Enforce tracked-data policy
run: |
set -euo pipefail
bash scripts/csi-data-policy-check.sh --self-test
bash scripts/csi-data-policy-check.sh --tracked
- name: Validate minimal fal deployment archive policy
run: >-
python3
v2/crates/ruforecast/crates/ruforecast-train/deploy/fal/deploy.py
self-test
- name: Prove hosted feature graph excludes Burn and CubeCL
working-directory: v2/crates/ruforecast
shell: bash
run: |
set -euo pipefail
cargo +1.89.0 tree --locked -e normal,build \
-p ruforecast-train \
--no-default-features --features cli,server,fal-client \
> forecast-hosted-feature-tree.txt
if grep -Eiq '(^|[[:space:]])(burn|cubecl)(-|[[:space:]])' \
forecast-hosted-feature-tree.txt; then
echo 'Burn/CubeCL entered the Rust 1.89 hosted dependency graph.' >&2
cat forecast-hosted-feature-tree.txt >&2
exit 1
fi
- name: Require named hosted boundary regressions
working-directory: v2/crates/ruforecast
shell: bash
env:
FAL_KEY: ''
run: |
set -euo pipefail
cargo +1.89.0 test --locked \
-p ruforecast-train \
--no-default-features --features cli,server,fal-client \
--lib --bins --tests -- --list \
| tee hosted-boundary-tests.txt
for regression in \
fal_app_rejects_path_and_host_confusion \
fal_urls_require_exact_origin_path_and_no_query \
fal_submit_headers_disable_retry_and_omit_store_io \
hosted_payload_dto_has_no_customer_fields \
queue_status_discards_provider_error_body \
result_url_accepts_exact_response_suffix \
artifact_file_url_uses_expected_api_path \
fal_key_debug_is_redacted \
hosted_payload_rejects_app_field \
hosted_reservation_cannot_exceed_source_retention \
artifact_handoff_expiry_boundary_is_fail_closed \
fal_result_enforces_cumulative_artifact_budget_boundary \
fal_download_rejects_over_budget_without_writing \
direct_server_train_requires_request_id_header \
request_id_rejects_path_injection \
unknown_cancel_is_not_success \
privacy_external_dataset_payload_is_denied; do
grep -q "$regression" hosted-boundary-tests.txt \
|| { echo "Missing hosted boundary regression: $regression" >&2; exit 1; }
done
- name: Exercise hosted external-data rejection
working-directory: v2/crates/ruforecast
env:
FAL_KEY: ''
run: >-
cargo +1.89.0 test --locked
-p ruforecast-train
--no-default-features --features cli,server,fal-client
privacy_external_dataset_payload_is_denied
- name: Test server and fal client with mock integrations
working-directory: v2/crates/ruforecast
env:
FAL_KEY: ''
run: >-
cargo +1.89.0 test --locked
-p ruforecast-train
--no-default-features --features cli,server,fal-client
--lib --bins --tests
- name: Clippy server and fal client boundaries
working-directory: v2/crates/ruforecast
env:
FAL_KEY: ''
run: >-
cargo +1.89.0 clippy --locked
-p ruforecast-train
--no-default-features --features cli,server,fal-client
--all-targets -- -D warnings
- name: Clippy standalone CLI feature boundary
working-directory: v2/crates/ruforecast
env:
FAL_KEY: ''
run: >-
cargo +1.89.0 clippy --locked
-p ruforecast-train
--no-default-features --features cli
--bin ruforecast -- -D warnings
- name: Upload hosted dependency tree
if: always()
uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02
with:
name: ruforecast-hosted-feature-tree
path: v2/crates/ruforecast/forecast-hosted-feature-tree.txt
if-no-files-found: error
burn-cpu-rust-192:
name: Forecast Burn CPU tests and bench compile (Rust 1.92)
runs-on: ubuntu-latest
timeout-minutes: 90
steps:
- name: Checkout recursively
uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262
with:
persist-credentials: false
submodules: recursive
- name: Install Rust 1.92 with Clippy
uses: dtolnay/rust-toolchain@4cda84d5c5c54efe2404f9d843567869ab1699d4
with:
toolchain: 1.92.0
components: clippy
- name: Cache Cargo artifacts
uses: Swatinem/rust-cache@e18b497796c12c097a38f9edb9d0641fb99eee32
with:
workspaces: v2/crates/ruforecast
key: ruforecast-rust-192-cpu
- name: Test model with Burn CPU backend
working-directory: v2/crates/ruforecast
run: >-
cargo +1.92.0 test --locked
-p ruforecast-model
--no-default-features --features cpu --lib --tests
- name: Test trainer and CLI with Burn CPU backend
working-directory: v2/crates/ruforecast
run: >-
cargo +1.92.0 test --locked
-p ruforecast-train
--no-default-features --features cpu,cli --lib --bins
- name: Run one-step local JSONL training smoke
working-directory: v2/crates/ruforecast
run: >-
cargo +1.92.0 test --locked
-p ruforecast-train
--no-default-features --features cpu
--test local_jsonl_smoke --
--exact local_hash_addressed_jsonl_executes_one_real_optimizer_step
- name: Run idempotent synthetic CLI training smoke
working-directory: v2/crates/ruforecast
run: >-
cargo +1.92.0 test --locked
-p ruforecast-train
--no-default-features --features cpu,cli
--test cli_smoke --
--exact cli_smoke_trains_and_writes_the_complete_candidate_set
- name: Test combined CPU and hosted feature surface
working-directory: v2/crates/ruforecast
env:
FAL_KEY: ''
run: >-
cargo +1.92.0 test --locked
-p ruforecast-train
--no-default-features --features cpu,cli,server,fal-client
--lib --bins
- name: Clippy model with Burn CPU backend
working-directory: v2/crates/ruforecast
run: >-
cargo +1.92.0 clippy --locked
-p ruforecast-model
--no-default-features --features cpu --all-targets -- -D warnings
- name: Clippy trainer and CLI with Burn CPU backend
working-directory: v2/crates/ruforecast
env:
FAL_KEY: ''
run: >-
cargo +1.92.0 clippy --locked
-p ruforecast-train
--no-default-features --features cpu,cli,server,fal-client
--all-targets -- -D warnings
- name: Compile forecast inference benchmark
working-directory: v2/crates/ruforecast
run: >-
cargo +1.92.0 bench --locked
-p ruforecast-model
--no-default-features --features cpu
--bench forecast_inference --no-run
- name: Compile forecast data-pipeline benchmark
working-directory: v2/crates/ruforecast
run: >-
cargo +1.92.0 bench --locked
-p ruforecast-train
--no-default-features --features cpu
--bench data_pipeline --no-run
- name: Run quick inference benchmark for trend visibility
continue-on-error: true
timeout-minutes: 15
working-directory: v2/crates/ruforecast
run: |
set -o pipefail
mkdir -p ../../bench-out/ruforecast
cargo +1.92.0 bench --locked \
-p ruforecast-model \
--no-default-features --features cpu \
--bench forecast_inference -- \
--warm-up-time 1 --measurement-time 2 --sample-size 10 \
| tee ../../bench-out/ruforecast/forecast-inference.txt
- name: Run quick data-pipeline benchmark for trend visibility
continue-on-error: true
timeout-minutes: 15
working-directory: v2/crates/ruforecast
run: |
set -o pipefail
mkdir -p ../../bench-out/ruforecast
cargo +1.92.0 bench --locked \
-p ruforecast-train \
--no-default-features --features cpu \
--bench data_pipeline -- \
--warm-up-time 1 --measurement-time 2 --sample-size 10 \
| tee ../../bench-out/ruforecast/data-pipeline.txt
- name: Upload informational benchmark logs
if: always()
uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02
with:
name: ruforecast-informational-cpu-benchmarks
path: bench-out/ruforecast/
if-no-files-found: warn
burn-cuda-compile-rust-192:
name: Forecast Burn CUDA/WGPU compile checks only (Rust 1.92)
runs-on: ubuntu-latest
timeout-minutes: 60
steps:
- name: Checkout recursively
uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262
with:
persist-credentials: false
submodules: recursive
- name: Install Rust 1.92
uses: dtolnay/rust-toolchain@4cda84d5c5c54efe2404f9d843567869ab1699d4
with:
toolchain: 1.92.0
- name: Cache Cargo artifacts
uses: Swatinem/rust-cache@e18b497796c12c097a38f9edb9d0641fb99eee32
with:
workspaces: v2/crates/ruforecast
key: ruforecast-rust-192-cuda-check
- name: Check model CUDA feature
working-directory: v2/crates/ruforecast
run: >-
cargo +1.92.0 check --locked
-p ruforecast-model
--no-default-features --features cuda --lib
- name: Check model WGPU feature
working-directory: v2/crates/ruforecast
run: >-
cargo +1.92.0 check --locked
-p ruforecast-model
--no-default-features --features wgpu --lib
- name: Check trainer CUDA and hosted-server feature combination
working-directory: v2/crates/ruforecast
env:
FAL_KEY: ''
run: >-
cargo +1.92.0 check --locked
-p ruforecast-train
--no-default-features --features cuda,cli,server
--lib --bins

4
.gitmodules vendored
View File

@@ -33,3 +33,7 @@
path = vendor/metaharness
url = https://github.com/ruvnet/metaharness
branch = main
[submodule "v2/crates/ruforecast"]
path = v2/crates/ruforecast
url = https://github.com/ruvnet/RuForecast.git
branch = main

View File

@@ -2,20 +2,11 @@
<p align="center">
<a href="https://cognitum.one/seed">
<img src="assets/ruview-seed.png" alt="RuView - WiFi DensePose" width="100%">
</a>
</p>
<p align="center">
<a href="https://cognitum.one/marketplace">
<img src="assets/musica-promo.png" alt="Cognitum Musica" width="100%">
</a>
</p>
<p align="center">
<a href="https://github.com/ruvnet/RuCelium">
<img src="assets/rucelium-hero.png" alt="RuCelium — environmental intelligence" width="100%">
<img src="assets/ruview-hero-h3-v3.gif" alt="RuView - WiFi DensePose — animated visualization of real-time pose estimation, breathing, and heart-rate sensing through WiFi" width="100%">
</a>
</p>
## **See through walls with WiFi** ##
**Turn ordinary WiFi into a spatial intelligence / sensing system.** Detect people, measure breathing and heart rate, track movement, and monitor rooms — through walls, in the dark, with no cameras or wearables. Just physics.

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.5 MiB

View File

@@ -139,6 +139,32 @@ Implement the §3.3 mapping: `effective_class → PrivacyClass`, `cog-ha-matter`
Add an opt-in `/ws/field` endpoint (or a `field_events` array on `SensingUpdate` behind a flag) carrying the signed `FieldEvent` + a privacy badge. Add an ingest route to `rufield-viewer` (it has none today — `server.rs:63-72`) so it can replay RuView's live feed instead of only `SyntheticSim`. **Gate:** a WS integration test asserting a connected client receives a privacy-badged, signature-verifiable `FieldEvent`; a viewer test asserting the new ingest route renders a live event. The `cognitum` appliance can speak RuField by consuming this endpoint (it already runs `ruview-vitals-worker`); deferred to its own ADR.
**P4 — fusion composition + multi-modality (ARCHITECTURE, optional).**
> **Update — second modality landed as a library.** Open question 5 below asked
> whether the second modality should be `rvcsi`. It is **ultrasonic**, because
> the cost collapsed: `rufield-adapters` now ships `UltrasonicReplayAdapter`,
> the first adapter for `Modality::Ultrasonic` (registry code 7, empty since
> v0.1), which parses, validates and signs [BatVu](https://github.com/ruvnet/batvu)
> range profiles upstream. RuView only has to decide what it will put on a wire.
>
> `wifi-densepose-rufield::ultrasonic` is that decision, and it is expressed
> structurally: the adapter is configured for its 32-bin coarse output (`P1`,
> egress-safe) rather than its full per-bin frame (`P0`, edge-local), because a
> consumer cannot un-coarsen a coarse profile whereas a runtime check can be
> reordered. The `network_egress_allowed` gate still runs and is asserted to
> drop nothing.
>
> Gates: `tests/ultrasonic_gates.rs`, 12 tests — round-trip, signature-verify,
> fusion ingest, P1 on **both** tensor and observation, structural unreachability
> of P4/P5, trust-tier refusal in both directions, determinism, whole-file
> rejection of a malformed recording. Plus one asserting the honest negative
> result: **an ultrasonic scan produces no fused inferences at all**, because the
> adapter declines to populate `presence` (one transducer pair cannot tell a
> person from a coat on a chair) and the engine's feature vocabulary is entirely
> statements about a body. RuField v0.1 has no predicate for static geometry.
>
> Not wired into the running server. P1 shipped as a library before P3 wired it
> in; this follows the same staging.
Wire a second modality (cheapest: an `rvcsi`-sourced event, or recorded mmWave) into `RuFieldFusion` alongside the WiFi event, proving cross-modality fusion above ruvsense. **Gate:** a fusion test with two modalities producing ≥1 cross-modal inference, with provenance coverage 100%.
---

View File

@@ -0,0 +1,59 @@
# ADR 340: iPhone LiDAR Sensor Bridge
Status: Proposed
## Context
RuView needs a low cost mobile geometry sensor that can contribute calibrated spatial observations without coupling the perception substrate to Apple frameworks.
ARKit exposes rear LiDAR scene depth through `ARFrame.sceneDepth` and `smoothedSceneDepth` on supported devices. Ordinary mobile web pages do not receive this ARKit depth surface directly, so native capture and web visualization must be separated.
## Decision
Use a two layer architecture.
1. Native Swift and ARKit perform acquisition.
2. A modality neutral wire frame transports geometry into browser tools and, next, the RuView HAL.
The native client will capture depth, confidence, camera intrinsics, and world tracking pose. RGB imagery is excluded from the default transport.
The protocol identifier is `ruview.lidar.depth.v1`.
Depth samples are quantized to UInt16 millimeters for transport. Confidence remains UInt8. The default sender downsamples by two spatially and caps transmission at 15 FPS. Full fidelity depth remains available locally for future on device inference.
## RuView integration boundary
The transport must not become a second world model. The production receiver converts each packet into the canonical `ruview-hal::Observation`, then passes it through authenticated sensor identity, provenance, OOD gating, uncertainty aware fusion, spatial memory, and WorldGraph adapters.
Rules:
1. `source=live` is valid only for frames produced by an active ARKit session.
2. Sequence numbers are monotonic per sensor session.
3. Wall clock timestamp is separate from ARKit monotonic frame timing.
4. RGB is off by default and requires an explicit higher privacy capability.
5. Browser clients consume geometry but are not treated as authoritative sensors.
6. Unsupported devices fail closed rather than substituting simulated depth.
## Performance target
`[SYNTHETIC]` A 256 x 192 Float32 depth map is about 196 KB before confidence and metadata. Downsampling to 128 x 96 and encoding each sample as two byte depth plus one byte confidence yields about 36.9 KB raw. At 15 FPS the raw sensor payload is about 553 KB/s. Base64 raises this to roughly 737 KB/s before JSON metadata. These values are arithmetic sizing estimates, not device measurements.
The `[CLAIMED target]` for local network latency is below 150 ms p95. A later binary WebSocket or QUIC transport can remove base64 overhead; the exact end-to-end reduction must be measured before it is claimed.
## Security
The development relay is LAN-facing, requires a random per-run bearer token, bounds message size, and restricts the files it serves. Its default `ws://` transport is not encrypted, so it is not a production trust boundary.
Production requires WSS, authenticated sensor identity, replay protection, message size limits, per tenant authorization, provenance receipts, and explicit retention policy before persistence.
## Consequences
Benefits include commodity hardware, metric depth, tracked camera pose, rapid room scanning, calibration support for RF sensing, and a practical ground truth source for RuView experiments.
The main limitation is that Apple provides processed scene depth rather than the underlying raw transient LiDAR waveform. Therefore this implementation supports direct geometry and sensor fusion now, but does not reproduce research systems that require raw multipath time of flight transients for non line of sight reconstruction.
## Acceptance criteria
A physical LiDAR capable iPhone must stream live geometry to the browser viewer with monotonically increasing sequence numbers, no RGB payload, valid confidence maps, and below 150 ms p95 local network latency over a 60 second run.
CI type-checking and simulator runs do not satisfy this criterion. Until a captured physical-device run records the environment and results, the hardware behavior and latency remain unverified.

View File

@@ -0,0 +1,93 @@
# ADR-344: Adaptive local installation discovery
## Status
Accepted — local advertisement and mobile discovery implemented; physical
peer-link and hosted-relay qualification pending.
## Context
RuView installations previously depended on a manually stored IP address.
DHCP changes, access-point changes, and client isolation could therefore leave
a healthy sensing installation unreachable from the mobile app. Repeated
authentication-policy log entries did not prove that the selected endpoint was
reachable.
Discovery must make commissioning recoverable without turning a service name
into authentication, leaking sensor data, scanning arbitrary subnets, or
silently moving private spatial data to a hosted service.
## Decision
The sensing server advertises one bounded `_ruview._tcp.local.` service when it
is bound to a routable interface. Loopback-only instances do not advertise,
and operators can disable advertisement with `--no-mdns`.
The TXT contract is deliberately small:
| Key | Required | Meaning |
|---|---:|---|
| `schema=ruview.installation.v1` | yes | Fail-closed protocol discriminator |
| `tls=0|1` | yes | HTTP or HTTPS origin construction |
| `installation=<opaque id>` | no | Bounded routing hint, never authentication |
The advertisement contains no node inventory, room identifier, SSID,
credentials, CSI, vital estimates, pose, identity, or learning data. The
hostname is bounded and sanitized before registration. Advertisement failure
is recoverable and does not stop sensing.
RuView Mobile resolves only the matching service and schema, validates the
resulting origin under its private-LAN/HTTPS policy, and requires an application
health probe before selection. Its adaptive broker retains the configured
origin preference and requires two failed configured probes plus two healthy
fallback probes before switching. Credentials remain scoped to their saved
origin.
The recovery ladder is:
1. configured private-LAN or HTTPS origin;
2. verified Bonjour local origin;
3. physically qualified Apple peer-to-peer local path;
4. explicit, authenticated HTTPS relay for bounded derived frames only;
5. optional administrator-managed WireGuard/Tailscale access.
Only levels 1 and 2 are implemented and software-validated by this decision.
Peer-to-peer browsing is enabled on Apple platforms, but it is not a qualified
peer-link data plane. This repository does not provide a hosted relay and must
fail closed when no local endpoint is healthy.
## Security and privacy consequences
- Service discovery is routing evidence, not installation authentication.
- Public HTTP origins, credentials in URLs, malformed records, and records with
the wrong schema are rejected before use.
- Raw CSI, RSSI streams, camera/LiDAR frames, room geometry, pose labels,
identity data, and training examples remain local.
- Future relay work requires a separate consent, authentication, revocation,
minimization, and physical evidence review.
- ESP32-S3/C6 nodes remain provisioned to the sensing installation. This ADR
does not claim direct phone-to-node discovery or invent a firmware protocol.
## Validation
Software acceptance requires:
- unit tests for bounded advertisement construction and hostname sanitation;
- mobile parser rejection, route scoring, anti-flapping, and Settings UI tests;
- Rust, TypeScript, lint, security, metaharness, Expo, and native compile gates;
- a real Bonjour resolve of the TXT contract followed by a successful
`/api/v1/status` probe.
Physical qualification additionally requires installation discovery on an
iPhone, live frame and node-inventory receipt, DHCP-change recovery without
flapping, and a five-to-ten-minute zero-fusion-error burn-in. Simulator and
host-only results remain `MEASURED_SOFTWARE`; peer-link, relay, and physical
reconnection claims remain `NOT_MEASURED` until those captures exist.
## Implementation references
- `v2/crates/wifi-densepose-sensing-server/src/discovery.rs`
- `v2/crates/wifi-densepose-sensing-server/src/main.rs`
- Mobile companion decision: `cognitum-one/ruview-mobile`,
`docs/adr/ADR-026-adaptive-local-installation-discovery-and-transport-recovery.md`
- Related decisions: ADR-034, ADR-054, ADR-296

View File

@@ -0,0 +1,52 @@
# ADR 346: Fail closed ESP32 occupancy evidence
## Status
Accepted and implemented. Physical qualification is required after each firmware build.
## Date
2026 08 31
## Context
The ESP32 Tier 2 pipeline produces two different signals. Presence is a debounced room level decision. Person count is a bounded subcarrier diversity heuristic. A live four node installation emitted packets with `presence=false` and `n_persons=3` or `4`. The server eventually gated the aggregate room count, but raw WebSocket consumers and diagnostics could still treat the contradictory count as occupancy evidence.
That contradiction is more dangerous than a missed optional count. It can contaminate empty room calibration, train a room model on false labels, and encourage a product claim that the firmware cannot support. The count is not identity, pose, or a validated multi person estimator.
## Decision
1. Firmware person slots are subordinate to the debounced presence gate.
2. When presence is false, the firmware clears slot activity, slot history, candidate count, persistence streak, and stable count.
3. The serialized person count is always zero when presence is false and is clamped to `EDGE_MAX_PERSONS` when presence is true.
4. The sensing server repeats the invariant for older firmware. A contradictory or out of range count becomes zero and carries `person_count_valid=false`.
5. Fused CSI plus mmWave packets use either CSI presence or mmWave presence as the supporting presence condition.
6. The node inventory and WebSocket diagnostics expose person count validity. Consumers must not infer a person from an invalid count.
7. No count accuracy claim is created by this change. The firmware output remains a heuristic until a leakage free, held out physical dataset demonstrates otherwise.
8. OTA admission uses the selected update partition size rather than a stale fixed 900 KB ceiling. The status endpoint reports that same hardware bound, while image validation and authenticated OTA remain mandatory.
## Security and privacy
The change retains no raw CSI or personal data. It reduces authority by preventing a secondary heuristic from asserting occupancy after the primary gate has closed. The host validates packet length, magic, range, and logical consistency before using count evidence.
## Consequences
Older firmware remains wire compatible. Invalid count evidence becomes visibly unavailable instead of silently affecting calibration. A true multi person event can still be undercounted when the presence gate is false, which is the intended fail closed behavior. Current C6 images larger than 900 KB can use the installed 1,900,544 byte OTA slots after one serial upgrade, without weakening the OTA authentication gate.
The largest uncertainty is whether the current presence gate itself generalizes across the installed rooms. The fix path is a room bound empty baseline plus the fixed room selective held out protocol, not a global threshold reduction.
## Evidence and acceptance
MEASURED before implementation on 2026 08 31: four live nodes streamed for 86 seconds with zero transport errors, while edge packets repeatedly contradicted `presence=false` with counts of three or four.
Software acceptance requires:
1. Host firmware tests prove absent plus four active slots serializes zero.
2. Rust parser tests prove contradictory and out of range counts fail closed.
3. The node API exposes count validity without breaking older firmware.
Physical acceptance requires the updated firmware on a confirmed board, a captured boot log, five minutes of live packets, zero logical count contradictions, and no increase in transport errors. Accuracy remains unmeasured until labelled held out sequences are recorded.
Physical occupancy qualification completed for ESP32 C6 node 4 on 2026 08 31. The five minute run observed 242 edge packets, including 61 absent packets, with zero logical count contradictions and zero parse errors. See `docs/validation/2026-08-31-esp32-c6-occupancy-integrity.md`.
ESP32 C6 node 7 was subsequently identified, upgraded to firmware 0.8.8, and transport qualified for five minutes with zero fused presence count contradictions and zero steady state transport errors. Its controlled empty room sequence remains required before occupancy qualification. See `docs/validation/2026-08-31-esp32-c6-node7-rate-aware-sensing.md`. Other nodes remain unqualified until separately identified and upgraded.

View File

@@ -0,0 +1,85 @@
# ADR 347: Rate aware ESP32 temporal sensing
## Status
Accepted. Implemented in firmware 0.8.8. The timing and transport path is
physically qualified on ESP32 C6. The independent raw transport path is also
physically qualified on an ESP32 S3 running Tier 0. Held out inference accuracy
remains required.
## Context
The ESP32 firmware creates CSI opportunities by sending one byte ICMP probes to
the connected access point. The traffic source is configured for 50 Hz, but the
delivered CSI cadence varies with channel contention and callback safety gates.
A physical ESP32 C6 produced 28 to 37 callbacks per second during the baseline
capture. Firmware 0.8.5 then exposed that the old per-interval estimator saw
only 12 to 16 Hz because WiFi replies arrived in short bursts separated by
longer gaps. The filters still consumed those burst frames, so excluding them
from the clock estimate was incorrect.
The edge DSP estimates its sample rate from timestamps so that breathing,
heartbeat, motion, and future Doppler features stay in physical Hertz. That
estimator was capped at 30 Hz. Once the actual cadence exceeded the cap, every
temporal feature was scaled against the wrong clock.
Physical firmware 0.8.5 validation corrected that initial diagnosis. Although
the callback path received 26 to 40 frames per second, Tier 2 on the unicore C6
processed an irregular subset that converged toward the 8 Hz estimator floor.
The right design is not to force the edge DSP to match raw capture. The paths
need independent, explicit cadence contracts.
The device free gesture preprint at
`https://www.preprints.org/manuscript/202602.0018` reinforces the importance of
timestamp correct Doppler features, but its 100 Hz controlled link is not a
safe firmware default for RuView. Existing S3 and C6 evidence records WiFi ISR
and packet buffer failures under sustained callback pressure above 50 Hz.
## Decision
1. Make the connected STA probe rate a build time setting from 10 through 50
Hz, with a default and hard ceiling of 50 Hz.
2. Track the delivered DSP cadence by counting every processed frame interval
over one second timestamp windows, then smooth successive windows in an 8
through 60 Hz estimator range. The 60 Hz estimator ceiling accommodates
timestamp jitter; it does not authorize more than 50 Hz callback processing.
3. Reject incomplete windows below one second and stalled windows above three
seconds. Do not discard valid burst frames from the estimated clock.
4. Surface the DSP rate in the one second controller diagnostic so hardware
validation can compare callback yield with the clock used by temporal
filters.
5. Keep raw CSI on the wire at the independent network cadence. Rate-limit the
C6 on-device Tier 1 and Tier 2 DSP input to a uniform 8 Hz. Physical 0.8.7
evidence showed that a requested 10 Hz input still converged to 8.0 through
8.4 Hz under Tier 2 load, while raw delivery remained 30 through 40 pps.
Eight hertz retains a 4 Hz Nyquist limit for the 0.1 through 2.0 Hz vital
bands without creating a backlog. The S3 default remains 20 Hz.
6. STFT, spectrogram gating, and learned temporal
classification remain host or iPhone responsibilities where memory,
rollback, and held out evaluation are stronger.
## Consequences
Heartbeat, respiration, and motion features receive a stable timestamped clock
instead of an accidental subset determined by C6 backlog. Operators can lower
the probe or DSP load for constrained networks without editing source. The host
still receives the higher-rate raw stream for richer Doppler processing.
This does not prove vital sign accuracy or gesture recognition. Higher temporal
fidelity only improves the representation available to a separately validated
model. The 50 Hz ceiling also means the paper's 100 Hz results are not directly
transferable.
## Acceptance test
On a physical C6, run at least five minutes after flashing. Pass when the boot
log reports the configured probe and DSP rates, the controller converges within
one hertz of the configured DSP cadence, raw callback yield remains at least 20
pps, no steady-state ENOMEM, watchdog, panic, or reboot occurs, and the fail
closed occupancy invariant remains zero contradictions for at least 30 absent
packets.

View File

@@ -0,0 +1,336 @@
# ADR-348: Independent Rust multivariate forecasting for RuView
- **Status**: Proposed
- **Date**: 2026-09-01
- **Deciders**: ruv
- **Owners**: RuView perception, model, security, and data-governance maintainers
- **Tags**: forecasting, rust, ruvector, temporal, uncertainty, clean-room, provenance
- **Extends**: ADR-016, ADR-020, ADR-145, ADR-273, ADR-282, ADR-295,
ADR-298, ADR-302, ADR-304, ADR-317, ADR-318, ADR-319
- **Supersedes**: None
## Executive decision
RuView will develop an independently specified and independently trained Rust
multivariate forecasting subsystem. It will forecast bounded, versioned
temporal feature streams, publish calibrated quantiles and an explicit
abstention state, optionally use a split-safe RuVector analogue index, and
remain advisory until all release gates in this ADR pass.
This is not a port, compatibility layer, distillation, or behavioural clone of
Google TimesFM. The implementation API is derived from RuView requirements.
Its weights must descend from an approved random initialization and approved
training data only.
**Evidence status at proposal:** the forecasting accuracy, false-alert
reduction, calibration, CPU latency, memory use, cross-building generalization,
and operational value described below are all **UNMEASURED targets**. This ADR
authorizes implementation and evaluation; it makes no `MEASURED` capability
claim and approves no production model.
## Context
RuView currently observes present and recent RF state. Forecasting could add a
separate answer to questions such as whether a feature trajectory is consistent
with real occupancy, whether motion is likely to transition between zones, or
whether a radio link is degrading. A forecast is not a sensor observation. It
is derived evidence with uncertainty and must never overwrite the immutable
observation that produced it.
TimesFM 3 is useful research context because its public description discusses
multivariate targets, past covariates, known-future covariates, probabilistic
outputs, temporal patching, and cross-series attention. Its licensing creates
two distinct surfaces:
- the Google TimesFM source repository states that source code is Apache-2.0;
- the TimesFM 3 pretrained weights are distributed under a separate
non-commercial, non-production license that also restricts commercial
training, fine-tuning, and distillation from the model.
An Apache-compliant Rust port would be a permissible but attributed derivative
source path, subject to its exact license obligations. It would not support the
strongest independent-development claim. Using the restricted TimesFM 3 model
or its outputs to create a RuView commercial model is outside this ADR. The
project therefore chooses the stricter clean-room protocol in
[`../security/ruview-forecast-clean-room.md`](../security/ruview-forecast-clean-room.md).
Clean-room controls reduce copyright, contract, and provenance risk. They do
not establish freedom to operate against patents, clear trademarks, approve a
dataset, or replace legal review in a launch jurisdiction.
## Options considered
1. **Use the TimesFM 3 checkpoint in RuView.** Rejected for commercial and
production use under the current checkpoint license.
2. **Translate the Apache-licensed implementation into Rust.** Not selected.
This can be evaluated under a separate ADR, with attribution and license
compliance, but must not be mixed with the independent-development path.
3. **Build an independent Rust forecasting specialist for RuView.** Chosen.
This narrows model scope, keeps inference native, controls provenance, and
makes RF-specific evaluation the source of authority.
4. **Do not add forecasting.** Retained as the deployment baseline. Forecasting
must beat simpler deterministic and statistical baselines before acquiring
runtime authority.
## Requirements
| ID | Requirement | Verification authority |
|---|---|---|
| RF-001 | No TimesFM 3 code, configuration, weights, parameters, outputs, activations, or derivatives enter specification, implementation, training, evaluation feedback, or release artifacts. | Clean-room manifest, contributor attestations, repository and artifact scans |
| RF-002 | Every contributor, reference, dependency, dataset, transform, training job, and checkpoint has immutable provenance. | Signed provenance manifests and review receipts |
| RF-003 | Every training byte has documented rights for commercial machine-learning use and applicable privacy approval. | Dataset licensing gate and data-steward approval |
| RF-004 | The default runtime is native Rust, bounded, offline, deterministic for a fixed artifact/input within the declared platform class, and free of runtime model download. | Unit, property, fuzz, replay, and dependency tests |
| RF-005 | Inputs and outputs are versioned, finite, bounded, timestamped, mask-aware, and provenance-labelled. Invalid, stale, insufficient, or OOD inputs abstain. | Contract tests and malformed-input corpus |
| RF-006 | Forecasts remain derived evidence. They cannot rewrite observations, silently increase observation confidence, or be relabelled `MEASURED`. | Schema invariants and evidence-engine tests |
| RF-007 | Quantile ordering, interval calibration, missing-data behaviour, and abstention are evaluated on leakage-free site/session/device holdouts. | Frozen evaluation manifest and reproducible report |
| RF-008 | RuVector retrieval is optional, split-scoped, provenance-recorded, and evaluated against the same model without retrieval. | Retrieval isolation tests and paired ablation |
| RF-009 | RuVLLM may explain or summarize a signed forecast but cannot alter numeric forecasts, bypass policy, spend money, or trigger medical, emergency, access-control, or life-safety action. | Capability tests and downstream policy review |
| RF-010 | Training on local Linux or a hosted accelerator uses identical signed code, container, data, and configuration identities; the provider is an untrusted processor. | Training receipts and digest comparison |
| RF-011 | Accuracy, latency, memory, power, and operational claims remain `UNMEASURED` or `CLAIMED` until a named reproducer satisfies the repository evidence contract. | Documentation and release review |
| RF-012 | Rollout is reversible and cannot advance from offline evaluation to shadow or advisory operation without the mapped gates below. | Signed mode transition and rollback drill |
## Architecture boundary
The initial implementation is split across three crates:
| Crate | Owned responsibility | Dependency/runtime rule |
|---|---|---|
| `ruview-forecast-core` | Backend-neutral schemas, invariants, metrics, forecast receipts, and the `Forecaster` trait | No Burn, CUDA, WGPU, provider SDK, sensing-server, or network dependency |
| `ruview-forecast-model` | Independent Burn 0.21 patch-mixer architecture and artifact execution | CPU, CUDA, and WGPU are explicit optional features; every backend feature is off by default |
| `ruview-forecast-train` | Dataset manifests/splits, trainer, evaluator, the `ruforecast` CLI, and Linux/fal.ai training assets | Training-only authority; no production activation or sensing-server mutation |
This PR does not connect the forecaster to the sensing server. A shadow bridge
requires a follow-up change after the core contract and evidence receipt have
stabilized. Landing crates or passing synthetic tests therefore creates no
live RuView forecasting capability.
Version one activates only the exact reviewed `tiny_ci` and `large_linux`
architecture profiles. The model and training boundaries enforce checked
dimension, parameter, activation-cell, input-cell, and forward multiply-add
limits per batch. Adding or changing a profile is therefore a reviewed code and
artifact-schema decision, not untrusted request configuration.
The proposed logical pipeline is:
```text
authenticated RF observations
|
v
versioned one-second feature windows
|
+----> split-scoped RuVector analogue retrieval (optional)
|
v
independent Rust temporal model
|
v
point forecast + ordered quantiles + validity mask + abstention
|
v
signed derived-evidence record
|
+----> RuView policy/evidence engine
+----> RuVLLM explanation with no numeric mutation authority
```
The initial feature contract should favour compact one-second summaries rather
than feeding an unbounded raw CSI stream. Candidate fields include motion
energy, Doppler summary, amplitude/phase dispersion, coherence, RSSI, packet
loss, channel utilization, current detector confidence, device temperature,
and source-validity masks. Each field needs a schema version, physical unit,
aggregation rule, validity semantics, and provenance. Adding a field is a
schema change, not an implicit positional extension.
The model may independently combine normalization, temporal patch encoding,
temporal mixing, cross-stream fusion, and quantile heads. This is a functional
design space, not permission to reproduce protected source expression,
checkpoint dimensions, constants, tests, diagrams, or API choices. Exact
architecture and parameter count remain implementation decisions recorded in
the model card and training receipt.
## Forecast contract
For each request the runtime returns one typed result, including abstention and
error paths. The result must identify:
- input schema, feature-window, model, configuration, and calibration digests;
- source time range, requested horizon, cadence, target streams, and masks;
- point estimate and declared quantiles for each target/horizon cell;
- whether quantiles were corrected for crossing and which method was used;
- OOD, insufficient-context, stale-input, and non-finite dispositions;
- optional RuVector index version, neighbour identifiers, distances, and
leakage-scope receipt;
- runtime platform class, duration, and peak-memory measurement when enabled;
- evidence label `DERIVED_FORECAST`, never `MEASURED_OBSERVATION`;
- deterministic content hash and optional RVF signature.
The runtime rejects non-finite values, duplicate or non-monotonic timestamps,
unsupported schema versions, unbounded dimensions, invalid quantile requests,
future covariates without an allowed source, and payloads above configured
limits. It abstains rather than imputing an authoritative state when history or
validity coverage is below the model-card threshold.
## RuVector integration
RuVector supplies temporal memory, not ground truth. During training and
evaluation, each split has a separate index built only from records permitted
for that split. A test query may retrieve training analogues, but it may never
retrieve a window from the same subject/session/site holdout, an overlapping
target horizon, or any test record. Fitted normalizers and retrieval thresholds
come from training data only.
Every release reports three comparable rows on identical examples:
1. deterministic/statistical baseline;
2. forecasting model without retrieval;
3. forecasting model with RuVector retrieval.
This prevents retrieval from hiding a weak model or leaking future state.
## RuVLLM and action authority
RuVLLM consumes an immutable, signed forecast record and may produce an
explanation referencing its uncertainty and provenance. Its prose is not the
forecast and receives no higher evidence grade. Numeric values exposed to APIs
come from the forecasting record, not regenerated text.
No forecast or LLM explanation independently triggers a health alert, emergency
response, access decision, actuator, firmware change, model promotion, or
commercial spend. Such actions require a separate governed policy, explicit
capability, and appropriate observed evidence.
## Training and artifact boundary
Training jobs run from a pinned container or reproducible local environment.
The receipt binds the source commit, lockfile, compiler, container, datasets,
transforms, architecture, hyperparameters, seeds, hardware, provider job ID,
start/end time, and every emitted checkpoint. Hosted workers receive only the
least data and credentials necessary. Provider caches, logs, retention, and
reuse rights must pass security and data review before customer-derived data is
uploaded.
A release artifact is immutable and hash addressed. It is loaded locally after
signature, schema, size, and compatibility verification. The inference process
does not fetch models, execute embedded code, accept arbitrary operators, or
contact the training provider.
## Leakage and evaluation protocol
- Split by deployment/site first, then subject, session, device, and contiguous
time block as applicable. No overlapping raw sequence or derived window may
cross a split.
- Freeze test manifests before tuning. A failed test result does not become a
new training target; material architecture changes require a new untouched
holdout.
- Fit normalization, calibration, feature selection, thresholds, and RuVector
index parameters on training/validation data only.
- Report missingness, abstention coverage, selective risk, per-horizon errors,
interval coverage, quantile loss, and results by site/device/interference
regime. Pooled performance cannot hide a failed domain.
- Compare against last value, seasonal naive, and at least one small classical
or recurrent baseline. TimesFM 3 output is not an acceptance oracle.
- Forecast evaluation does not prove presence, pose, fall, respiration, or
medical accuracy. Any downstream claim requires its own labelled protocol.
## Acceptance gates and requirement mapping
Targets below are release criteria, not current results.
| Gate | Requirements | Pass condition | Current state |
|---|---|---|---|
| G0 independent-authoring boundary | RF-001, RF-002 | Approved source allowlist; 100% current contributor attestations; zero restricted artifacts or outputs; all similarity findings adjudicated by the clean-room custodian. | **OPEN / UNMEASURED** |
| G1 data and lineage | RF-002, RF-003, RF-010 | 100% of training/evaluation bytes resolve to approved manifests; zero unknown, noncommercial, research-only, no-ML, or no-derivatives sources; checkpoint lineage reaches approved random initialization; local/hosted receipts bind identical governed inputs. | **OPEN / UNMEASURED** |
| G2 bounded Rust contract | RF-004, RF-005, RF-006 | Unit/property/fuzz tests cover dimensions, non-finite values, timestamp order, masks, quantile order, stale/OOD/insufficient context, deterministic hashes, offline loading, evidence labels, and resource caps; 24-hour accelerated replay has no panic or unbounded growth. | **OPEN / UNMEASURED** |
| G3 leakage-free model evidence | RF-007, RF-008, RF-011 | Frozen site/session/device-disjoint report; all baseline and ablation rows present; nominal 80% interval coverage target is 75%-85%; weighted quantile loss target is at least 10% better than seasonal naive; every metric has a reproducer. | **OPEN / TARGETS UNMEASURED** |
| G4 RuView shadow value | RF-006, RF-007, RF-008, RF-009 | At least 14 days shadow-only; empty-room false-alert target is at least 50% relative reduction without more than 2 percentage points occupied-room recall loss; no safety-critical action authority; drift and abstention reported by deployment. | **OPEN / TARGETS UNMEASURED** |
| G5 deployment fitness | RF-004, RF-009, RF-010, RF-011, RF-012 | CPU p95 target is at most 1 second for 32 declared streams with peak process memory at most 4 GiB; signed model card/SBOM/provenance; privacy, security, trademark, dataset, and patent reviews; rollback drill; no open severity 1/2 issue. | **OPEN / TARGETS UNMEASURED** |
Failure at any gate keeps the model offline or shadow-only. Passing a software
gate is not real-hardware evidence and does not convert an accuracy target into
a measurement.
## Rollout and rollback
The only permitted progression is:
```text
OFF -> OFFLINE_EVAL -> SHADOW -> ADVISORY
```
This ADR does not authorize autonomous action. Each transition records actor,
old/new mode, artifact and configuration digests, evidence report, and reason.
Regression, provenance failure, calibration drift, security incident, or
licensing uncertainty returns immediately to `OFF` or `SHADOW` while observed
RuView sensing continues unchanged.
Rollback deactivates the forecast artifact atomically, clears ephemeral model
and retrieval state, preserves signed aggregate evidence and incident records,
and never downgrades or rewrites the raw observation stream.
## Security and privacy
Forecasting can infer routines from occupancy and movement even without raw
CSI. Feature windows, neighbour identifiers, forecasts, and explanations are
therefore deployment data subject to purpose limitation, tenant isolation,
retention, deletion, access control, and audit.
Model artifacts, feature schemas, calibration, indexes, and manifests are
untrusted until their signature and digest verify. Cardinality, dimensions,
horizon, context, allocations, execution time, and concurrent requests are
bounded. Metrics use allowlisted aggregate values and exclude raw CSI, precise
room coordinates, persistent person identifiers, and unrestricted feature
payloads.
The detailed authoring, data, AI-tool, incident, trademark, and patent controls
are normative in
[`../security/ruview-forecast-clean-room.md`](../security/ruview-forecast-clean-room.md).
## Consequences
### Positive
- RuView gains a provider-neutral predictive evidence primitive with explicit
uncertainty and abstention.
- Rust-native inference can be evaluated on CPU without requiring a Python or
cloud runtime in production.
- RuVector retrieval becomes a measurable ablation rather than an implicit
memory claim.
- Signed provenance supports reproducible Linux and hosted training.
### Negative
- Independent training needs substantial diverse, correctly licensed temporal
data and untouched deployment holdouts.
- Strict source separation and manifests increase contributor and review cost.
- A plausible forecast can make weak sensing look more authoritative unless
downstream evidence labels remain intact.
- Clean-room development does not remove patent, trademark, privacy, or dataset
risk.
### Neutral
- This ADR does not repair an inaccurate upstream presence or pose estimator.
- It does not approve TimesFM 3 for RuView use.
- It does not select a final model size, training budget, or hosted provider.
- No production checkpoint or measured benchmark is created by this decision.
## References
- [TimesFM 3 public research article](https://research.google/blog/timesfm-3-a-zero-shot-foundation-model-for-multivariate-forecasting/)
- [Google TimesFM repository and source-license notice](https://github.com/google-research/timesfm)
- [TimesFM 3 checkpoint license](https://huggingface.co/google/timesfm-3.0-pytorch/blob/main/LICENSE)
- [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0)
- [17 U.S.C. section 102](https://www.copyright.gov/title17/92chap1.html)
- [USPTO Patent Public Search](https://www.uspto.gov/patents/search/patent-public-search)
- [USPTO comprehensive trademark clearance](https://www.uspto.gov/trademarks/search/comprehensive-clearance-search-similar-trademarks)
- [RuView Forecast clean-room protocol](../security/ruview-forecast-clean-room.md)
- [RuView Forecast model-card template](../huggingface/RUVIEW_FORECAST_MODEL_CARD_TEMPLATE.md)
- [ADR-145](./ADR-145-ablation-eval-harness-privacy-leakage.md)
- [ADR-282](./ADR-282-ruview-ecosystem-positioning.md)
- [ADR-295](./ADR-295-source-provenance-state-machine.md)
- [ADR-298](./ADR-298-model-release-sanity-gates.md)
- [ADR-302](./ADR-302-out-of-distribution-detection.md)
- [ADR-304](./ADR-304-evidence-engine.md)
- [ADR-317](./ADR-317-benchmark-multi-domain-scorecard.md)
- [ADR-318](./ADR-318-capability-certificates.md)
- [ADR-319](./ADR-319-witness-chain.md)

View File

@@ -0,0 +1,231 @@
# ADR-349: Governed local and fal.ai forecast training
- **Status**: Proposed
- **Date**: 2026-09-01
- **Deciders**: ruv
- **Owners**: RuView forecast training, security, and release maintainers
- **Tags**: forecasting, training, fal, rust, receipts, idempotency, cost-control
- **Parent**: ADR-348
- **Extends**: ADR-010, ADR-145, ADR-298, ADR-319, ADR-348
- **Supersedes**: None
## Decision
RuView Forecast will use one Rust training engine behind two deliberately
different request boundaries. The local Linux request may bind a governed,
hash-addressed RuView JSONL shard. Hosted v1 accepts only a bounded,
deterministic synthetic generator recipe. It cannot serialize a local
`TrainSpec`, `DataPolicy`, path, dataset bytes, tenant/account/workspace/site/
device/session identity, split receipt, or RuVector namespace.
The fal.ai path is a bounded execution adapter, not a remote shell. It may
train the fixed synthetic profile and export fixed artifact kinds, but it may
not choose an arbitrary command, executable, container, URL, environment
variable, output path, or release action. A later real-data hosted path needs a
new accepted ADR, provider/privacy review, and an operator-signed export grant;
it is intentionally not implemented here.
Every hosted result is untrusted and quarantined until it is exported with a
complete receipt, downloaded through the authenticated provider channel,
re-hashed locally, scanned, and bound to the original request. Only the local
release boundary may sign or activate it. Signing keys never enter fal.ai.
This ADR delegates dataset rights, clean-room evidence, model-card, patent,
trademark, and production gates to [ADR-348](./ADR-348-independent-rust-multivariate-forecasting.md)
and the [clean-room protocol](../security/ruview-forecast-clean-room.md).
**Evidence status:** typed local and hosted configuration, root-confined file
verification, atomic fixed-kind artifact publication, and cooperative
cancellation source surfaces exist. End-to-end local training and mock hosted
transport are software-testable in this change. Real fal.ai execution,
provider cancellation, cost reconciliation, quarantine promotion, and local
signature verification remain **UNMEASURED and unapproved** until their named
acceptance evidence exists.
## Context
The same training engine needs to run on a 128 GiB Linux workstation and on an
optional hosted accelerator without creating two architecture lineages. A
generic remote-command interface would allow request data to become executable
authority, make cost difficult to bound, and weaken cancellation. Sending a
general local request to fal would also expose governance and customer
identifiers that the hosted smoke path does not need.
The initial `ruview-forecast-train` crate already separates three relevant
modules:
| Module | Current contract |
|---|---|
| [`config.rs`](../../v2/crates/ruview-forecast-train/src/config.rs) | `TrainingRequest`, `ValidatedTrainingRequest`, bounded `JobId`, root-relative dataset path, exact size/SHA-256, named model profiles, typed CPU/CUDA choice, and bounded optimizer values; unknown fields are denied |
| [`artifact.rs`](../../v2/crates/ruview-forecast-train/src/artifact.rs) | verified open dataset handle, root confinement, fixed `Model`/`Manifest`/`Receipt`/`Checkpoint` kinds, atomic writes, content descriptors, and conflict-on-different-bytes idempotency |
| [`cancel.rs`](../../v2/crates/ruview-forecast-train/src/cancel.rs) | `Cancellation`, `CancelToken`, and cooperative cancellation checks for batch/checkpoint boundaries |
The training crate features keep `cli`, `server`, `fal-client`, `cpu`, and
`cuda` explicit, with default features empty. WGPU remains a model-crate
inference backend and is not advertised as a training runner. The `ruforecast`
binary requires the `cli` feature. Source presence is not execution evidence.
## Typed execution contracts
The non-serializable trusted `TrainingRequest` is built locally from a
size-bounded `LocalTrainingRequestWire`. It contains:
- stable job identity;
- a constructor-validated local split/horizon/normalization `TrainSpec`;
- either a root-relative dataset identity with exact byte count and SHA-256,
or a deterministic synthetic recipe;
- one allowlisted model capacity profile and compiled-in local backend;
- bounded optimizer, checkpoint cadence, seed, memory, step, time, checkpoint,
and artifact budgets.
Local JSON and TOML deny unknown fields. Dataset paths resolve below an
operator-configured root, and the exact regular file remains open after
size/hash verification to avoid replacement between validation and use. JSONL
windows are decoded incrementally with per-line and per-window caps rather
than loading the full shard into memory.
The distinct `HostedSyntheticRequestV1` contains only a schema version,
idempotency/request digests, a fixed model profile, deterministic generator
parameters and seed, bounded optimizer/resource caps, and public build
identities. Its constructor needs a non-serializable core governance authority
proving that the synthetic recipe is the approved hosted source. Hosted v1 has
no external dataset field.
Neither request contains a shell string, argument vector, executable path,
container/image selector, package installer, arbitrary URL, callback URL,
environment map, secret, source fragment, or unrestricted output name.
The local client maps `HostedSyntheticRequestV1` to one allowlisted,
process-configured fal app and pre-deployed content-addressed worker image. The
caller cannot override the app, machine, worker entry point, or artifact
destination. The endpoint returns typed status or artifact descriptors only.
Provider paths are derived from validated job identity and fixed artifact
kinds, then downloaded through the authenticated fal Platform Files API; they
are not accepted as remote URLs or local paths.
The deploy wrapper builds from an allowlisted `git archive`, selects the exact
`fal_app.py::run_server` symbol, and passes `--auth private` for both `fal run`
and `fal deploy`; ephemeral Fal runs otherwise default to public. Hosted v1
retains only bounded synthetic request/result metadata so its typed queue result
can be reconciled. It sets `X-Fal-No-Retry: 1` and a bounded timeout rather than
claiming that `X-Fal-Store-IO: 0` or an unverified lifecycle header protects
the result. A live unauthenticated 401/403 probe and provider retention/deletion
reconciliation remain blocking operational evidence.
## Idempotency and cost authority
The local effective idempotency identity is:
```text
job_id + canonical request digest + source commit + lockfile digest
+ container digest + dataset/split digest + initial-weight digest
```
Hosted v1 replaces `dataset/split digest` with the canonical synthetic-recipe
digest. No local governance identifier is part of, or derivable from, the
hosted payload.
Repeating an identical completed request returns the existing verified receipt
and descriptors. Reusing `job_id` with any different governed input fails as a
conflict. A retry after an ambiguous network failure must first query the same
provider job; it must not silently create a second billable run.
Before hosted submission, the caller sets explicit maximum steps, wall-clock
time, memory, checkpoint count, export bytes, and billable units. Submission
also requires an explicit local spend-approval record bound to the request
digest and maximum units. The adapter rejects a request when its configured
cap exceeds that approval. The final receipt records estimated and actual
provider units/cost when the provider supplies them, the price source/time,
and whether the amount is final or provider-reported. A provider estimate is
`CLAIMED`, never `MEASURED`, until reconciled against a bill.
No automatic retry may increase the approved budget. Budget changes create a
new signed authorization record. The initial wire carries operator ceilings
for wall time, billable seconds, and micro-USD, but it does not yet bind a
provider price quote or reconcile a final provider ledger. Monetary enforcement
therefore remains an operator/Fal-account control and the production hosted
spend gate stays open.
## Cancellation and checkpoints
Cancellation is cooperative and idempotent:
1. Local signal or authenticated hosted cancel marks one `job_id` cancelled.
2. Training checks `Cancellation` at every batch boundary and before/after each
checkpoint/export boundary.
3. A cancellation checkpoint is committed atomically when safe and within the
artifact budget; a partial file never becomes a valid artifact.
4. The terminal receipt records `cancelled`, the last completed epoch/step,
checkpoint digest, provider state, elapsed resource units, and final known
cost.
5. Repeating cancel returns the same terminal state.
Cancellation does not promise immediate GPU termination. Cancellation latency,
checkpoint durability, and residual provider billing are **UNMEASURED** until a
real fal.ai run supplies a receipt. A timeout or lost cancellation response
keeps the job and any output quarantined.
## Export, quarantine, and local signing
The worker may emit only the fixed artifact set from `ArtifactKind`:
| Kind | Required purpose |
|---|---|
| `Model` | Burn model record bytes |
| `Manifest` | architecture, data/split, seed, build, and clean-room identity |
| `Receipt` | request, environment, metrics, cost, status, and export lineage |
| `Checkpoint` | final or cancellation-time model weights; v1 does not claim optimizer/cursor resume |
Every descriptor includes kind, size, and SHA-256. Export acceptance requires
all mandatory descriptors, bounded lengths, exact hashes, the expected job and
request digest, no duplicate kind, and a terminal status consistent with the
artifact set.
Downloaded files enter a non-executable quarantine outside the model search
path. Local verification repeats envelope/schema/size/hash checks, SBOM and
malware/policy scans, clean-room declarations, dataset/split lineage, metric
labels, and parent-checkpoint validation. No provider output may update a
symlink, current-model pointer, RuVector index, sensing server, or release tag.
After quarantine passes, an authorized local signer binds the exact export
receipt and artifact digests to an `ArtifactReceipt` and release manifest. The
signature records algorithm, public key ID, signer capability, and time. Fal.ai
receives no private signing material and cannot promote its own output. The
current core supplies canonical digests and receipts, not a complete release
signature implementation; signature-backed activation remains open.
## Requirements and acceptance
| ID | Requirement | ADR-348 gate | Acceptance evidence | Current state |
|---|---|---|---|---|
| FT-001 | Local and hosted adapters invoke the same model/trainer implementation while using intentionally separate local-data and hosted-synthetic request schemas. | G1 | Shared-engine tests plus hosted DTO exclusion and recipe-digest binding tests | **OPEN / UNMEASURED** |
| FT-002 | No request field or endpoint can select arbitrary code, command, image, URL, environment, or output path. | G2 | Schema negatives, endpoint capability test, dependency review | **OPEN / UNMEASURED** |
| FT-003 | Job/request idempotency prevents duplicate execution and conflicts on changed governed input. | G1, G5 | Concurrent/retry/lost-response tests with provider job query | **OPEN / UNMEASURED** |
| FT-004 | Hosted execution has explicit non-escalating resource and monetary caps with estimated/actual cost receipts. | G5 | Over-budget rejection and reconciled provider-bill fixture plus real-run receipt | **OPEN / UNMEASURED** |
| FT-005 | Cancellation is authenticated, cooperative, idempotent, checkpoint-safe, and terminally receipted. | G2, G5 | Local property tests and a real hosted cancellation drill | **OPEN / UNMEASURED** |
| FT-006 | Export is fixed-kind, bounded, complete, hash-verified, and bound to request/job/environment. | G1, G2 | Missing/duplicate/truncated/tampered export tests | **OPEN / UNMEASURED** |
| FT-007 | Hosted outputs remain quarantined until local verification and local-only signing succeed. | G1, G5 | Promotion-denial tests, signing-key absence check, rollback drill | **OPEN / UNMEASURED** |
| FT-008 | Hosted v1 receives synthetic inputs only; provider credentials, logs, retention, region, output reuse, and deletion satisfy ADR-348 privacy/security approval before any real run. | G1, G5 | Hosted DTO exclusion tests, provider review, and deletion/export receipts | **OPEN / UNMEASURED** |
No successful unit test closes a hosted gate. G5 requires one bounded real
fal.ai run, one cancellation drill, one ambiguous-retry/idempotency drill, cost
reconciliation, quarantine rejection of a tampered export, and local signature
verification over the accepted artifact. Until then fal.ai support is a typed
software surface, not an operational capability claim.
## Consequences
The design gives local and hosted training one auditable lineage and keeps
provider output below local release authority. It adds receipt, budget,
quarantine, and signing work, and cooperative cancellation may still incur
provider cost. If a hosted provider cannot support bounded idempotent status,
export, cancellation, and deletion, the Linux path remains the only approved
training environment.
## References
- [ADR-348](./ADR-348-independent-rust-multivariate-forecasting.md)
- [RuView Forecast clean-room protocol](../security/ruview-forecast-clean-room.md)
- [`ruview-forecast-train` manifest](../../v2/crates/ruview-forecast-train/Cargo.toml)
- [`ruview-forecast-core` receipts](../../v2/crates/ruview-forecast-core/src/receipt.rs)
- [`ruview-forecast-model` public artifact boundary](../../v2/crates/ruview-forecast-model/src/lib.rs)

View File

@@ -0,0 +1,217 @@
# ADR-350: RuVector predictive memory and RuVLLM authority boundary
- **Status**: Proposed
- **Date**: 2026-09-01
- **Deciders**: ruv
- **Owners**: RuView forecast, RuVector, evidence, and RuVLLM integration maintainers
- **Tags**: forecasting, ruvector, ruvllm, retrieval, memory, receipts, authority
- **Parent**: ADR-348
- **Extends**: ADR-004, ADR-010, ADR-016, ADR-145, ADR-261, ADR-295,
ADR-304, ADR-319, ADR-348
- **Supersedes**: None
## Decision
RuVector may augment RuView Forecast by retrieving analogous historical
feature/forecast states from a tenant- and split-scoped predictive-memory
index. Retrieval is optional context, never ground truth. Every release must
report the same frozen examples with retrieval disabled and enabled so its
incremental value and leakage risk remain visible.
Each forecast is published in an immutable, locally signed envelope binding the
model artifact, request, output, source evidence, and retrieval receipt. RuVLLM
may read that envelope to explain uncertainty and analogous history. It may not
rewrite numeric forecasts, create a stronger evidence class, select a model,
promote an artifact, spend money, invoke an actuator, or make medical,
emergency, access-control, or life-safety decisions.
This child ADR delegates forecasting, clean-room, data, and general production
gates to [ADR-348](./ADR-348-independent-rust-multivariate-forecasting.md). It
does not authorize a sensing-server bridge.
**Evidence status:** canonical forecast/receipt types and an indexable latent
state exist in source. A RuVector adapter, retrieval receipt, signature wrapper,
outcome reconciler, RuVLLM explanation adapter, paired retrieval evaluation,
latency, storage cost, accuracy lift, and operational value are all
**UNMEASURED and unapproved**.
## Existing implementation boundary
The current crates establish only the preconditions:
| Module | Implemented surface used by this ADR |
|---|---|
| [`ruview-forecast-core/src/forecast.rs`](../../v2/crates/ruview-forecast-core/src/forecast.rs) | validated `ForecastRequest`, backend-neutral `Forecaster`, ordered finite `Forecast`, canonical output digest, and receipt verification |
| [`ruview-forecast-core/src/receipt.rs`](../../v2/crates/ruview-forecast-core/src/receipt.rs) | `SourceState`, `ArtifactReceipt`, and `ForecastReceipt`; derived forecasts cannot retain `MEASURED` merely because measured input existed |
| [`ruview-forecast-core/src/series.rs`](../../v2/crates/ruview-forecast-core/src/series.rs) | bounded feature schema, masked time series, canonical series digest, and training-only scaler fit |
| [`ruview-forecast-model/src/network.rs`](../../v2/crates/ruview-forecast-model/src/network.rs) | `ForecastModelOutput.state` with shape `[batch, variates, d_model]`, intended as a bounded representation candidate for indexing |
`ForecastReceipt` is content-addressed but not itself a digital signature.
`ForecastModelOutput.state` is indexable but not automatically safe, private,
stable across model versions, or useful. Those distinctions remain release
gates.
## Predictive-memory record
RuVector stores a versioned `PredictiveMemoryRecord` containing:
- tenant and index namespace;
- model/artifact/config/feature-schema digests;
- source series and forecast-request digests;
- split, site, subject-class, session, device, calibration, and bounded time
scope using pseudonymous identifiers;
- bounded latent-state or engineered-feature digest plus the approved vector;
- forecast envelope digest and horizon;
- observed validity mask and evidence class;
- optional reconciled outcome digest added only after the forecast horizon;
- retention/deletion class and creation/expiry time.
Raw CSI, unrestricted feature windows, precise room coordinates, persistent
person identity, RuVLLM prompts, and explanation prose are excluded by default.
The vector is still potentially sensitive because it can encode routines or
location. Tenant isolation, encryption, access control, retention, deletion,
and membership-inference review apply.
An outcome is appended through a new immutable record linked to the original;
the historical forecast is never rewritten. Outcome reconciliation can measure
forecast quality but cannot retroactively turn the forecast into a measured
observation.
## Split-scoped analogue retrieval
Every index is bound to an immutable corpus manifest, model version, feature
schema, preprocessing configuration, and split policy. These rules are
mandatory:
1. Tenants never share an index or query result without a separately authorized
privacy-preserving federation protocol.
2. Training, validation, calibration, and test records have distinct
namespaces. A test query may retrieve approved training analogues only; it
may not retrieve test examples or validation/calibration records used to set
thresholds.
3. The same site, subject, session, device, calibration episode, overlapping
context, or overlapping target horizon is excluded when that dimension is a
holdout.
4. Index construction, distance metric, normalization, filter policy, `k`, and
score threshold are fitted on training data and frozen before test.
5. Missing, stale, mismatched, unauthorized, or unverifiable indexes disable
retrieval and return the no-retrieval forecast or abstention according to
the model card. They never trigger an implicit global-index fallback.
6. Every query returns a bounded `RetrievalReceipt` even when zero neighbours
qualify.
The retrieval receipt binds query digest, index/corpus/policy digests,
namespace, exclusion filter, neighbour record IDs and distances, `k`, latency,
and disposition. It excludes raw neighbour payloads from ordinary logs.
## Paired ablation
Retrieval has no deployment authority without a paired evaluation on identical
frozen requests:
| Row | Model and examples | Retrieval |
|---|---|---|
| A | exact candidate artifact and frozen examples | disabled |
| B | exact candidate artifact and frozen examples | enabled with frozen index/policy |
The report includes weighted quantile loss, interval coverage/width,
abstention, per-horizon error, per-site/device/interference slices, retrieval
hit/filtered/empty rates, latency, and memory/storage overhead. It reports both
aggregate and paired deltas with uncertainty. A gain on pooled error cannot
hide a failed deployment domain, calibration regression, or neighbour leakage.
The no-retrieval row remains a supported fallback. Retrieval is removed when
its lower confidence bound does not show useful improvement, when it weakens
calibration beyond the ADR-348 gate, or when its privacy/latency/storage cost
exceeds its measured value. No uplift is claimed today.
## Immutable signed forecast envelope
The signed envelope covers:
```text
envelope schema/version
+ ArtifactReceipt canonical digest
+ ForecastRequest canonical digest
+ Forecast payload/output digest
+ ForecastReceipt canonical digest
+ RetrievalReceipt digest or explicit retrieval-disabled marker
+ policy/calibration/index digests
+ creation/expiry time and tenant namespace
```
Signing occurs at the trusted local boundary after artifact and retrieval
verification. The wrapper records algorithm, public key ID, signer capability,
and signature. Private keys never enter model artifacts, RuVector, RuVLLM, or a
hosted training worker.
Consumers verify signature, expiry, tenant, schemas, every nested digest, and
the `Forecast::verify_receipt` invariant before using numeric values. Any
failure yields unavailable/abstain. Unsigned content-addressed receipts remain
useful for local tests but are not described as signed and cannot cross the
production trust boundary.
## RuVLLM explanation boundary
RuVLLM receives a read-only projection of the verified envelope:
- exact point and quantile values as structured fields;
- units, horizons, calibration/OOD/abstention state;
- bounded analogue summaries and retrieval receipt references;
- evidence labels, model/version, and envelope digest;
- approved explanation policy and audience.
Explanation prose is stored separately and linked to the envelope digest. It
is `CLAIMED_EXPLANATION`, not a replacement forecast. Numeric API fields are
copied from the verified envelope after generation, never parsed back from LLM
text. If prose contradicts a structured number, evidence state, unit, or
disposition, the response fails validation and the numeric envelope remains
authoritative.
The explanation capability exposes no tools for artifact activation, model
promotion, retraining, spending, messaging, emergency dispatch, access control,
or actuation. A separate downstream policy may consume a forecast only under
its own ADR, capabilities, approvals, and observed-evidence requirements. The
LLM cannot grant itself that authority or lower an approval threshold.
## Requirements and acceptance
| ID | Requirement | ADR-348 gate | Acceptance evidence | Current state |
|---|---|---|---|---|
| PM-001 | Every predictive-memory query is tenant-, model-, schema-, corpus-, split-, and time-scope bound. | G3, G5 | Cross-tenant/split/version negative tests and signed index manifest | **OPEN / UNMEASURED** |
| PM-002 | Holdout identities, overlapping contexts, and target horizons cannot appear as neighbours. | G3 | Property tests plus frozen leakage report | **OPEN / UNMEASURED** |
| PM-003 | Every query, including disabled/empty/error, produces a bounded retrieval receipt. | G2, G3 | Receipt round-trip, tamper, bound, and zero-result tests | **OPEN / UNMEASURED** |
| PM-004 | Retrieval-disabled and retrieval-enabled rows use identical artifact/examples and report paired metrics and overhead. | G3 | Frozen paired ablation with reproducer | **OPEN / UNMEASURED** |
| PM-005 | Forecast envelope signatures bind all nested forecast/retrieval identities and fail closed on mutation, expiry, tenant, or key error. | G2, G5 | Signature/tamper/replay/cross-tenant tests and local signing receipt | **OPEN / UNMEASURED** |
| PM-006 | Derived forecast and explanation can never become `MEASURED_OBSERVATION` or exceed source evidence. | G2, G4 | Evidence-monotonicity schema/property tests | **OPEN / UNMEASURED** |
| PM-007 | RuVLLM cannot mutate structured numbers; contradictions fail validation and explanations remain separately labelled. | G4 | Numeric/unit/evidence mutation corpus and fail-closed integration tests | **OPEN / UNMEASURED** |
| PM-008 | RuVLLM explanation has no spending, promotion, messaging, safety, access-control, or actuator capability. | G4, G5 | Default-deny capability and attempted-escalation tests | **OPEN / UNMEASURED** |
| PM-009 | Vector/explanation privacy, retention, deletion, extraction, and membership risks are approved and operationally tested. | G5 | Privacy review, tenant deletion drill, and access audit | **OPEN / UNMEASURED** |
G3 additionally requires the paired retrieval ablation to satisfy ADR-348's
forecast and calibration gates. G4 requires shadow evidence that retrieval and
explanation improve operator comprehension or forecast value without changing
numeric/action authority. G5 requires signed-envelope verification, rollback,
tenant deletion, and key-rotation drills. None has passed.
## Consequences
RuVector can evolve from retrospective search into outcome-linked predictive
memory while preserving a measurable no-retrieval baseline. RuVLLM can make
forecasts understandable without becoming the numeric or action authority. The
cost is additional index isolation, storage, signature, deletion, evaluation,
and policy complexity. If paired evidence does not justify that cost, the
correct release keeps retrieval and explanation disabled.
## References
- [ADR-348](./ADR-348-independent-rust-multivariate-forecasting.md)
- [ADR-349](./ADR-349-governed-local-and-fal-forecast-training.md)
- [RuView Forecast clean-room protocol](../security/ruview-forecast-clean-room.md)
- [RuView Forecast model-card template](../huggingface/RUVIEW_FORECAST_MODEL_CARD_TEMPLATE.md)
- [RuForecast benchmark protocol](../benchmarks/ruforecast.md)
- [ADR-016](./ADR-016-ruvector-integration.md)
- [ADR-145](./ADR-145-ablation-eval-harness-privacy-leakage.md)
- [ADR-261](./ADR-261-ruvector-graph-ann-index.md)
- [ADR-304](./ADR-304-evidence-engine.md)
- [ADR-319](./ADR-319-witness-chain.md)

View File

@@ -92,6 +92,9 @@ Statuses: **Proposed** (under discussion), **Accepted** (approved and/or impleme
| [ADR-150](ADR-150-rf-foundation-encoder.md) | RF Foundation Encoder: pose-preserving, subject/room/device-invariant CSI embedding | Proposed |
| [ADR-151](ADR-151-room-calibration-specialist-training.md) | Per-Room Calibration & Specialized Model Training (room-first → bank of small ruVector specialists) | Proposed |
| [ADR-152](ADR-152-wifi-pose-sota-2026-intake.md) | WiFi-Pose SOTA 2026 Intake: geometry-conditioned calibration, external benchmarks, foundation-encoder recipe | Proposed |
| [ADR-348](ADR-348-independent-rust-multivariate-forecasting.md) | Independent Rust multivariate forecasting for RuView | Proposed |
| [ADR-349](ADR-349-governed-local-and-fal-forecast-training.md) | Governed local and fal.ai forecast training | Proposed |
| [ADR-350](ADR-350-ruvector-predictive-memory-and-ruvllm-boundary.md) | RuVector predictive memory and RuVLLM authority boundary | Proposed |
### Platform and UI
@@ -105,6 +108,9 @@ Statuses: **Proposed** (under discussion), **Accepted** (approved and/or impleme
| [ADR-035](ADR-035-live-sensing-ui-accuracy.md) | Live Sensing UI Accuracy and Data Transparency | Accepted |
| [ADR-036](ADR-036-rvf-training-pipeline-ui.md) | Training Pipeline UI Integration | Proposed |
| [ADR-043](ADR-043-sensing-server-ui-api-completion.md) | Sensing Server UI API Completion (14 endpoints) | Accepted |
| [ADR-344](ADR-344-adaptive-local-installation-discovery.md) | Adaptive Local Installation Discovery | Accepted (local software path) |
| [ADR-346](ADR-346-fail-closed-edge-occupancy-evidence.md) | Fail closed ESP32 occupancy evidence | Accepted (C6 occupancy integrity qualified) |
| [ADR-347](ADR-347-rate-aware-esp32-temporal-sensing.md) | Rate aware ESP32 temporal sensing | Accepted (C6 timing and transport qualified) |
| [ADR-115](ADR-115-home-assistant-integration.md) | Home Assistant integration via MQTT auto-discovery + Matter bridge (HA-DISCO + HA-FABRIC + HA-MIND) | Accepted (MQTT track) / Proposed (Matter SDK P8b) |
| [ADR-169](ADR-169-adam-mode-light-theme.md) | adam-mode — light theme toggle for the three.js realtime demo | Proposed |
| [ADR-170](ADR-170-yoga-mode-pose-system.md) | yoga-mode — yoga pose detection, classification, and scoring for the three.js realtime demo | Proposed |

View File

@@ -0,0 +1,380 @@
# RuForecast benchmark protocol
## Evidence status
No RuForecast runtime, accuracy, calibration, memory, or operational result is
recorded here yet. Every threshold below is an ADR-348 target, not a measured
claim. The first accepted row must identify a clean commit, the `Cargo.lock`
digest, the exact Rust toolchain, host, backend, model/configuration digest,
fixture or corpus digest, command, and evidence label.
## Benchmark boundaries
RuForecast uses two different forms of evidence:
1. Deterministic correctness evidence comes from Rust unit, property, replay,
split-isolation, and artifact-tamper tests. A fixed input and artifact must
produce the same output within its declared platform class.
2. Runtime evidence comes from Criterion on a named host. Criterion inputs are
generated from fixed checked-in code and seeds, but elapsed time is not
deterministic. Timing from shared GitHub runners is informational only.
The benchmark implementation must not download a model or dataset, read raw
CSI, use a hosted model output, or enable CUDA implicitly. CPU benchmarks use
the explicit `cpu` feature and the Burn ndarray backend. CUDA validation belongs
to a separately governed Linux or hosted-accelerator receipt.
## Required benchmark targets
| Package | Target | Purpose | CI authority |
|---|---|---|---|
| `ruview-forecast-model` | `forecast_inference` | Fixed-seed forward pass, batch and shape scaling, ordered-quantile output | Compile gate; shared-runner timing is informational |
| `ruview-forecast-train` | `data_pipeline` | Fixed generated records through validation, windowing, masking and batching | Compile gate; shared-runner timing is informational |
Both targets must use code-generated synthetic inputs, fixed seeds, bounded
allocations, `criterion::black_box`, and `required-features = ["cpu"]`. Setup,
artifact construction, and dataset generation stay outside the timed region
unless a benchmark name explicitly says they are included.
The model implementation owns structural parameter-count assertions. The
currently reviewed design values are 35,700 parameters for the tiny CI preset
and 20,285,108 for the large preset. These are design invariants, not benchmark
results, and must be derived by a test from the actual module graph before they
are quoted in a model card.
## Local Linux reproducer
Run from a clean checkout after installing Rust 1.92.0:
```bash
RUFORECAST_CPUSET=0-7 \
RUFORECAST_THREADS=8 \
scripts/run-ruforecast-benchmarks.sh
```
The runner executes the focused contract/model/training tests, one real
optimizer step over a local hash-addressed synthetic JSONL shard, and the
idempotent synthetic CLI smoke. It then compile-checks both Criterion targets,
runs the targets, captures the CPU and toolchain metadata, and hashes every
output. A failed run retains its partial logs with `status=FAILED` and its exit
code rather than looking like a complete report. Results go under
`target/ruforecast-evidence/`, which is excluded from source control.
For a conservative single-thread reproducibility check, omit both environment
variables. To run against an uncommitted tree for diagnosis only, set
`RUFORECAST_ALLOW_DIRTY=1`; the resulting metadata is labelled `SYNTHETIC`
with scope `DIRTY_WORKTREE_DIAGNOSTIC_ONLY` and cannot support a release claim.
A clean run labels its host timing `MEASURED` and its input class `SYNTHETIC`,
but remains `UNREVIEWED`. Only a maintainer may append it to the accepted ledger
after checking the digests, shape, command, Criterion report and host scope.
The runner intentionally has no CUDA option and does not parse Criterion output
into a pass/fail performance verdict. This prevents a noisy host result from
silently acquiring release authority.
To compile the two benchmark targets without measuring them:
```bash
cd v2
cargo +1.92.0 bench --locked -p ruview-forecast-model \
--no-default-features --features cpu --bench forecast_inference --no-run
cargo +1.92.0 bench --locked -p ruview-forecast-train \
--no-default-features --features cpu --bench data_pipeline --no-run
```
For a short informational run, use the same targets without `--no-run`:
```bash
cargo +1.92.0 bench --locked -p ruview-forecast-model \
--no-default-features --features cpu --bench forecast_inference -- \
--warm-up-time 1 --measurement-time 2 --sample-size 10
cargo +1.92.0 bench --locked -p ruview-forecast-train \
--no-default-features --features cpu --bench data_pipeline -- \
--warm-up-time 1 --measurement-time 2 --sample-size 10
```
Running these commands does not add a ledger row automatically. Preserve the
raw report and environment metadata, then have a maintainer assign its evidence
scope before publishing a number.
The inference bench runs only `tiny_ci` by default so a routine CI trend step
cannot accidentally start the very expensive large CPU probe. Set
`RUFORECAST_BENCH_LARGE=1` only on a controlled host when intentionally
measuring the fixed deployment shape:
```bash
RUFORECAST_BENCH_LARGE=1 scripts/run-ruforecast-benchmarks.sh
```
## Deployment measurement shape
The initial CPU deployment probe is batch 1, context 1,024, 32 declared feature
streams, the fixed `large_linux` horizon of 300, and all seven declared
quantiles. Record at least 20 warmup
iterations and 200 measured iterations for a release candidate. Report p50,
p95, p99 or maximum, throughput, and the process peak resident set size.
ADR-348 G5 currently targets p95 at or below one second for 32 declared streams
and peak process memory at or below 4 GiB. A Criterion result alone cannot close
the memory gate because Criterion and Cargo are not the production inference
process. G5 remains open until a standalone inference probe reports its own peak
resident set size.
## Accuracy and calibration protocol
Runtime speed never substitutes for forecasting quality. The frozen evaluation
manifest must report identical examples for:
1. Last-value and seasonal-naive baselines.
2. RuForecast without RuVector retrieval.
3. RuForecast with split-scoped RuVector retrieval.
Required report fields include weighted quantile loss by horizon, nominal 80%
interval coverage, missingness, abstention coverage, selective risk, site and
device slices, interference regime, and retrieval ablation. ADR-348 G3 targets
weighted quantile loss at least 10% better than seasonal naive and 80% interval
coverage between 75% and 85%. Those targets remain unmeasured until a frozen,
leakage-free report is attached.
### Informal HPO exploration note (unaccepted, not a release claim)
**2026-09-01.** An exploratory session ran the accuracy protocol above end to
end against a governed 24-window **synthetic** dataset (`tiny_ci` profile,
context 64 / horizon 12, temporal train/test split, not entity-holdout —
only one synthetic generator was used, so entity holdout does not apply) and
a small `OptimizerSpec` hyperparameter search (learning rate, weight decay,
gradient clip norm, batch size, epochs) using a new Darwin Mode numeric-genome
evolution engine (upstream: `ruvnet/metaharness` PR #260, not yet merged).
This is **exploratory evidence only** — not a frozen, leakage-free,
maintainer-reviewed report, and not eligible for the ledger below until one
is produced.
Prior to this exploration, a **single real household window** (76 real
1&nbsp;Hz vital-signs samples, one physical ESP32 sensor, temporal not entity
holdout) scored **worse than both baselines** (WQL 0.537 vs. last-value
0.106 and seasonal-naive 0.123) — consistent with a single training window
overfitting rather than generalizing.
With a larger (still synthetic, still `tiny_ci`) 24-window training set and
three rounds of hyperparameter search, weighted quantile loss on the held-out
synthetic split improved and stayed ahead of both baselines throughout:
| Round | learning_rate | weight_decay | grad_clip | batch | epochs | WQL (model) | WQL (last-value) | WQL (seasonal-naive) |
|---|---:|---:|---:|---:|---:|---:|---:|---:|
| Default config | 0.0010000 | 1.00e-4 | 1.000 | 8 | 60 | 0.257 | 0.277 | 0.514 |
| Search round 1 | 0.0002356 | 3.05e-6 | 0.100 | 27 | 195 | 0.161 | 0.277 | 0.514 |
| Search round 2 | 0.0000298 | 4.09e-11 | 4.746 | 26 | 356 | **0.153** | 0.277 | 0.514 |
Round-2 gain over round 1 (0.008) was much smaller than round-1's gain over
the default (0.096) — a diminishing-returns signal consistent with a local
optimum for this model size and dataset, not a converged global result.
`gradient_clip_norm` landed at opposite bound extremes across rounds
(0.1 then 4.7), so no directional recommendation on that parameter should be
drawn from this exploration alone.
**Explicit scope limits — do not generalize beyond these:**
- `tiny_ci` only. Nothing here has been run against `large_linux`; its far
larger parameter count and different compute profile mean these
hyperparameters are not a starting point for it without their own search.
- Synthetic dataset only (24 windows, one generator/seed family). Not
validated against any real corpus at this scale.
- Self-signed, evaluation-only model activation (a throwaway local Ed25519
key, not a release signature) was used to run inference for scoring.
- No security/provenance/maintainer-approval gate has passed — the Darwin
Mode promotion rule correctly refused to promote any candidate here.
Reproducer: `harness/ruview/flywheel/ruforecast/` (genome, gate, evaluator,
dry-run/`--confirm` driver) in the `ruvnet/RuView` repo, paired with
`ruvnet/metaharness` PR #260 (`evolve-numeric`) linked locally via
`npm link`. Neither the genome defaults here nor any repo default config
were changed by this note — it is a record of exploratory evidence, not a
committed recommendation.
### Amendment (2026-09-01, later same day): the round-2 result above did not generalize -- retracted
**The "Search round 2" row above (WQL 0.153, learning_rate=0.0000298 etc.) is
RETRACTED as a claim of improvement.** It is kept in the table (append-only,
never silently edit a prior measurement) but must be read together with this
amendment: independent verification, run the same day using a new
regression-candidate promotion path (`ruvnet/autogenous` PR-in-progress,
branch `feat/regression-candidate-kind`, not yet merged/pushed --
`v2/crates/ruforecast-autogenous-bridge` in this worktree) against TWO FRESH
synthetic corpora that were never part of that search (seeds 1000/1097, vs.
the search's single fixed seed 0), showed that "winner" genome performing
**WORSE than the baseline on both**:
| Judge corpus | Candidate WQL | Baseline WQL | Candidate beats baseline by |
|---|---:|---:|---:|
| seed 1000 | 0.155 | **0.099** | -0.056 (worse) |
| seed 1097 | 0.219 | **0.109** | -0.110 (worse) |
**Root cause**: every evaluation in the three search rounds above (default,
round 1, round 2) trained and scored every candidate against the exact same
fixed synthetic corpus (`prepare-synthetic-dataset`'s implicit `--seed 0`
default). The search had learned to exploit that one corpus's specific
random windows -- textbook overfitting -- not found a genuinely better
hyperparameter configuration. This is a real, measured failure mode, not a
hypothetical caveat.
**Fix applied**: `harness/ruview/flywheel/ruforecast/gate.mjs`'s
`evaluateGenome` now trains and scores every candidate against THREE
independent synthetic corpora (`DEFAULT_SEARCH_SEEDS = [11, 23, 47]`, none
of which overlap the retracted search's seed 0 or the verification seeds
1000/1097) and takes the WORST CASE `primary` across them, not an average --
a candidate only counts as a win if it beats both baselines on every corpus.
See `harness/ruview/flywheel/ruforecast/README.md`'s "Multi-seed fitness"
section for the full account.
**Re-running the search with the fix, still no verified improvement.** A
fresh search under the corrected multi-seed fitness (2 generations x 2
children, cleared `.metaharness-numeric` archive so no stale pre-fix state
leaked in) found a genuine winner ON ITS OWN THREE SEARCH SEEDS --
`learning_rate=0.008012, weight_decay=0.000159, gradient_clip_norm=0.267,
batch_size=24, epochs=20`, beating the baseline on all three (primary
0.099 / 0.556 / 0.576, worst-case 0.099). Independent verification against
the same fresh seeds 1000/1097 (never part of this candidate's own search)
again showed it losing to the baseline on both:
| Judge corpus | Candidate WQL | Baseline WQL | Candidate beats baseline by |
|---|---:|---:|---:|
| seed 1000 | 0.178 | **0.099** | -0.079 (worse) |
| seed 1097 | 0.314 | **0.109** | -0.205 (worse) |
**Honest conclusion**: two independent search rounds (pre- and post- the
multi-seed fitness fix) both produced a genome that looked like a real
improvement on its own search data and both failed independent out-of-sample
verification. This converges on a different, deeper explanation than "the
search methodology was broken" (that part IS fixed): at this dataset scale
(24 synthetic training windows), held-out WQL varies enormously by which
corpus is drawn REGARDLESS of hyperparameters -- the baseline genome itself,
evaluated with the corrected multi-seed fitness function, swings from
primary 0.83 (a strong win) to a full regression (primary 0, WQL worse than
last-value) purely from which of the three fixed search seeds was used, with
identical hyperparameters throughout. The corpus-noise floor at n=24
windows appears to dominate any real hyperparameter effect. No RuForecast
hyperparameter configuration has been shown, by this exploration, to
reliably beat the trivial baselines out-of-sample at this scale. A larger
training corpus (more windows, ideally real governed data under the
`large_linux` profile) is the more promising next lever than further
hyperparameter search on this fixture.
A related implementation-only fix: the promotion verifier
(`envelope::regression::verify_regression_promotion` in the Autogenous
branch above) initially required all judges' receipts to share one
`corpus_id`, inherited unreviewed from a same-evidence review model that
does not fit this kind's intentionally cross-corpus judge design. This was
corrected (`ReceiptCorpusMismatch` is no longer produced by that function);
it did not change either REJECT verdict above, both of which were already
correctly driven by the real `NotBetterThanParent` signal.
Reproducer for both verification runs above: same as below, plus
`v2/crates/ruforecast-autogenous-bridge` (`cargo +1.92.0 run --manifest-path
crates/ruforecast-autogenous-bridge/Cargo.toml -- --ruforecast-bin
./target/debug/ruforecast --candidate-genome <genome>.json --parent-genome
<baseline>.json --judges 2 --work-dir <scratch>`) against the unpushed
`ruvnet/autogenous` branch `feat/regression-candidate-kind`.
### Real-household-data result (2026-09-01, MEASURED, unaccepted, not a release claim)
Following the informal HPO exploration above, this session also collected
**6,390 real 1&nbsp;Hz vital-signs samples** (heart rate, breathing rate,
signal quality) from a real, live, ESP32-sourced household sensing
deployment over a continuous 2-hour window (88.75% real sample coverage;
gaps handled honestly via `observed_mask=0`, never fabricated
interpolation) — the "more real training data" lever flagged as the
credible next step in the note above. This directly answers that open
question.
Two genuinely independent temporal splits of the same real corpus (not
synthetic seeds — real data has no seed to vary, so independence here
means two different train/test boundary choices on the same timeline,
each with its own 90s embargo gap) were trained (default, untuned
`OptimizerSpec`: `lr=0.001, weight_decay=0.0001, gradient_clip_norm=1.0,
batch_size=8, epochs=60`) and scored via the real `evaluate` CLI, then
independently, cryptographically verified through
`ruforecast-autogenous-bridge`'s real signed regression-candidate
promotion path (`ruvnet/autogenous`, `envelope::regression`):
| Judge | Split | Real test windows | Model WQL | Best trivial baseline WQL | Model beats baseline by |
|---|---|---:|---:|---:|---:|
| 1 | 70% train / 90s embargo / 30% test | 27 | 0.0514 | 0.0563 (last-value) | +0.0049 |
| 2 | 50% train / 90s embargo / 50% test | 46 | 0.0670 | 0.0543 (seasonal-naive) | 0.0128 |
**Signed verdict: REJECT.** Judge 1's nominal win (+0.0049) is below the
0.01 non-inferiority margin, so it doesn't clear the promotion bar even
on its own; Judge 2 lost outright. Both rejections are recorded as
`NotBetterThanParent` in the signed promotion envelope.
**Honest conclusion:** even with a real household corpus (n=6,390 real
samples, not synthetic), the result is exactly the same shape as every
synthetic search this session — a result that looks like a win on one
split does not hold up on an independently verified second split. This
is not evidence that real data can't help; it is evidence that this
scale of real data (6,390 samples, one household, one physical sensor)
is not yet enough to distinguish a genuine effect from split-dependent
noise. The credible next lever remains more real data — more households,
longer collection windows, or the `large_linux` profile — not further
hyperparameter search on any fixture this small, synthetic or real.
Reproducer: `v2/crates/ruforecast-autogenous-bridge/examples/real_data_verify.rs`
and `v2/crates/ruforecast/crates/ruforecast-train/examples/real_data_windows.rs`
in this worktree (`train/ruforecast-rust` branch, commits `130f547` in the
`ruforecast` submodule and `788401c5` in this repo — both local, not yet
pushed). Raw real vitals data never left the collecting/training hosts and
was never written to any git-tracked or pushed path.
## Append-only evidence ledger
Never replace a prior measurement. Append a row and retain the failed or stale
row when code, model, configuration, corpus, hardware, or methodology changes.
| Date | Commit | Lock SHA-256 | Host/toolchain | Backend/config | Shape | Samples | p50 | p95 | p99/max | Peak RSS | Evidence | Reproducer |
|---|---|---|---|---|---|---:|---:|---:|---:|---:|---|---|
No rows have been accepted.
### Real public dataset: BIDMC PPG/Respiration (2026-09-02, cross-entity holdout)
Every real-data test up to this point used a single household/entity with only
a **temporal** holdout (same physical sensor, different time windows). This
test is the first with a genuine **cross-entity** holdout: 53 real ICU
patients from the BIDMC PPG and Respiration Dataset (PhysioNet, Open Data
Commons Attribution License v1.0, public and openly licensed — no
credentialing, https://physionet.org/content/bidmc/1.0.0/), splitting by
*patient*, not by time, so the held-out test set contains real people the
model never saw during training.
25,546 real 1 Hz rows across 53 recordings (~8 minutes each), heart rate +
respiratory rate + SpO2. 3 of 53 patients' windows were excluded honestly
(genuine sensor-dropout `NaN` values in the source recordings, not
fabricated/interpolated). Two independent, disjoint patient-partition splits:
| Judge | Train patients | Test patients | Test windows | Model WQL | Best baseline WQL | Result |
|---|---:|---:|---:|---:|---:|---|
| A (contiguous split) | 34 | 16 | 16 | 0.01964 | 0.01159 (last-value) | worse, +69% |
| B (interleaved split) | 24 | 26 | 26 | 0.07022 | 0.01002 (last-value) | worse, +601% |
**Same conclusion as every prior test this session**, now on real, public,
multi-subject clinical data with genuine cross-entity generalization: the
model does not beat trivial forecasting baselines. The margin is decisive on
both independent splits, not a near-miss — the earlier hypothesis that a
larger, genuinely diverse real dataset (many different people, not one
household) might change the picture does not hold at this scale/model
configuration either.
**Honest scope note on verification**: prior real-data tests in this document
were independently checked through Autogenous's signed regression-candidate
promotion path. That additional cryptographic-signing step was **not** run
for this test — the result is reported directly from the `evaluate` CLI's
real output on two genuinely disjoint, real patient-holdout splits, which is
itself real, independent, out-of-sample evidence, but it does not carry a
signed promotion-gate verdict the way the earlier entries do. Flagging this
explicitly rather than presenting it with the same evidentiary weight.
Reproducer: `v2/crates/ruforecast/crates/ruforecast-train/examples/bidmc_prepare.rs`
(untracked scratch example, worktree `train/ruforecast-rust`) — downloads
`bidmc_NN_Numerics.csv` for patients 01-53 directly from PhysioNet, builds
one 76-row (context 64 + horizon 12) window per eligible patient, and writes
governed `train.jsonl`/`test.jsonl`/`train-local.toml` per judge split. Raw
data cached at `/tmp/bidmc-raw/` on the training host only.

View File

@@ -0,0 +1,616 @@
# RuView Forecast model card template
> **Template only. Do not publish or treat this file as a model release.** Copy
> it for one immutable candidate, replace every `<REQUIRED>` field, and retain
> every unresolved item as an explicit blocker. Deleting a placeholder does not
> satisfy it.
This template implements the model-card requirements in
[ADR-348](../adr/ADR-348-independent-rust-multivariate-forecasting.md) and the
[RuView Forecast clean-room protocol](../security/ruview-forecast-clean-room.md).
It does not imply that source, training, evaluation, clean-room, security,
privacy, trademark, patent, or production gates have passed.
## Completion rules
1. Create one card per exact weight digest. Do not reuse a card across retrains.
2. Label every numeric claim `MEASURED`, `SYNTHETIC`, `CLAIMED`, or
`UNMEASURED` under the repository evidence policy.
3. A `MEASURED` value needs an immutable dataset/split, artifact digest,
configuration, hardware/environment, metric definition, and reproducer.
4. Use `UNMEASURED` when evidence does not exist. Do not substitute an estimate.
5. State source-code, weight, dataset, and service terms separately.
6. Do not publish raw CSI, customer data, precise room coordinates, identities,
secrets, private contracts, or private contributor records in this card.
7. A completed card documents evidence; it cannot waive an ADR-348 gate.
## Suggested Hugging Face metadata
Copy and complete this front matter in the release card:
```yaml
---
license: <REQUIRED exact weight-license identifier>
tags:
- time-series-forecasting
- multivariate-forecasting
- wifi-sensing
- rust
- ruvector
- probabilistic-forecasting
- edge-ai
language:
- en
library_name: burn
pipeline_tag: time-series-forecasting
---
```
`license: other` is acceptable only when the card links the complete exact
license. Do not infer the weight license from the Rust source license.
## Candidate identity
Replace the template title with `<REQUIRED model name and version>` in the
release copy.
## Release decision and evidence status
| Field | Required value |
|---|---|
| Release candidate ID | `<REQUIRED>` |
| Weight SHA-256 | `<REQUIRED>` |
| Git commit | `<REQUIRED>` |
| Model-card SHA-256 | `<REQUIRED after finalization>` |
| Proposed mode | `OFFLINE_EVAL`, `SHADOW`, or `ADVISORY`; `<REQUIRED>` |
| ADR-348 highest gate passed | `G0` through `G5`, or `NONE`; `<REQUIRED>` |
| Accuracy status | `UNMEASURED` until a qualifying report exists; `<REQUIRED>` |
| Calibration status | `UNMEASURED` until a qualifying report exists; `<REQUIRED>` |
| CPU latency status | `UNMEASURED` until a named CPU reproducer exists; `<REQUIRED>` |
| Memory status | `UNMEASURED` until a named runtime reproducer exists; `<REQUIRED>` |
| Cross-site generalization status | `UNMEASURED` until untouched site holdouts exist; `<REQUIRED>` |
| Clean-room status | `OPEN`, `PASS`, or `FAIL`; `<REQUIRED>` |
| Production approval | `NOT APPROVED` unless all G5 receipts are signed; `<REQUIRED>` |
### Release summary
`<REQUIRED: State what this exact artifact does, what evidence exists, which
mode is requested, and the most important unresolved limitation in no more
than 150 words. Do not copy competitor marketing language.>`
## Model details
| Field | Value |
|---|---|
| Developer/owner | `<REQUIRED>` |
| Model family | `RuView Forecast` |
| Model version | `<REQUIRED immutable version>` |
| Artifact format | `<REQUIRED, including RVF/safetensors/version>` |
| Parameter count | `<REQUIRED or UNMEASURED>` |
| Numeric precision | `<REQUIRED>` |
| Architecture/config digest | `<REQUIRED>` |
| Input schema version | `<REQUIRED>` |
| Output schema version | `<REQUIRED>` |
| Maximum context | `<REQUIRED with cadence and units>` |
| Supported horizons | `<REQUIRED with cadence and units>` |
| Declared quantiles | `<REQUIRED>` |
| Training framework | `<REQUIRED exact Rust crate/features/version>` |
| Inference runtime | `<REQUIRED exact Rust crate/features/version>` |
| Source license | `<REQUIRED SPDX expression>` |
| Weight license | `<REQUIRED exact license and URL>` |
### Rust implementation boundary
Describe the exact code surfaces used by this candidate:
| Crate or binary | Version/digest | Responsibility | Enabled features |
|---|---|---|---|
| `ruview-forecast-core` | `<REQUIRED>` | Backend-neutral schemas, invariants, metrics, receipts, and `Forecaster` trait | `<REQUIRED; expected default only>` |
| `ruview-forecast-model` | `<REQUIRED>` | Independent Burn 0.21 patch mixer and artifact execution | `<REQUIRED; CPU/CUDA/WGPU are opt-in and default off>` |
| `ruview-forecast-train` / `ruforecast` | `<REQUIRED>` | Dataset splits, trainer, evaluator, training receipt, and Linux/fal.ai assets | `<REQUIRED>` |
| `<optional service/runtime>` | `<REQUIRED or NONE>` | `<REQUIRED>` | `<REQUIRED>` |
State whether inference is offline and whether any runtime network capability
exists. The expected production answer is no runtime model download and no
network requirement:
`<REQUIRED>`
State whether a sensing-server bridge exists. For the initial ADR-348 PR the
required answer is `NO: contracts/training only; a separately reviewed shadow
bridge is deferred`:
`<REQUIRED>`
## Intended use
### Approved candidate use
`<REQUIRED: identify the exact RuView feature streams, deployment class,
forecast horizons, mode, users, and decision support purpose.>`
### Out-of-scope and prohibited use
This artifact must not be used unless a later approved card explicitly changes
the boundary:
- as a sensor observation or ground-truth label;
- as the sole source for medical, emergency, fall-response, industrial-safety,
access-control, policing, insurance, employment, or autonomous-actuation
decisions;
- to infer identity or protected characteristics;
- outside the feature schema, cadence, hardware, site, population, and horizon
validated by this card;
- after calibration, feature schema, source provenance, or OOD checks fail;
- to train another model unless the weight, dataset, and output licenses and a
new provenance review explicitly permit it;
- to claim TimesFM compatibility, affiliation, endorsement, or equivalence.
Add candidate-specific exclusions:
`<REQUIRED>`
## Functional architecture
Describe independently implemented components without reproducing external
source expression, diagrams, identifiers, or constants:
```text
<REQUIRED: compact original diagram of feature windows, optional split-safe
retrieval, normalization, temporal/cross-stream model, quantile heads,
abstention, receipt, and policy boundary>
```
| Component | Candidate implementation | Security/resource bound |
|---|---|---|
| Feature validation | `<REQUIRED>` | `<REQUIRED>` |
| Normalization | `<REQUIRED>` | `<REQUIRED>` |
| Temporal encoding/mixing | `<REQUIRED>` | `<REQUIRED>` |
| Cross-stream fusion | `<REQUIRED>` | `<REQUIRED>` |
| Missing-data handling | `<REQUIRED>` | `<REQUIRED>` |
| Point/quantile head | `<REQUIRED>` | `<REQUIRED>` |
| Quantile crossing policy | `<REQUIRED>` | `<REQUIRED>` |
| OOD/abstention | `<REQUIRED>` | `<REQUIRED>` |
| RuVector retrieval | `<REQUIRED or NONE>` | `<REQUIRED>` |
| Artifact verification | `<REQUIRED>` | `<REQUIRED>` |
## Input contract
### Feature schema
| Field | Unit | Cadence/aggregation | Range | Missing/invalid semantics | Source provenance |
|---|---|---|---|---|---|
| `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
State:
- minimum and maximum context length;
- maximum targets, covariates, horizon, and batch;
- timestamp monotonicity and duplicate policy;
- whether any future-known covariate is permitted and how its authority is
verified;
- finite/range checks and allocation limits;
- minimum validity coverage before abstention;
- treatment of cadence gaps, resets, device changes, and calibration changes;
- OOD input behaviour.
`<REQUIRED>`
### Data not accepted
`<REQUIRED: include raw/unbounded payloads, unknown schema, non-finite values,
untrusted future covariates, stale data, unsupported cadence, and candidate
specific exclusions.>`
## Output contract
| Output | Shape/unit | Meaning | Evidence class |
|---|---|---|---|
| Point forecast | `<REQUIRED>` | `<REQUIRED>` | `DERIVED_FORECAST` |
| Quantile forecast | `<REQUIRED>` | `<REQUIRED>` | `DERIVED_FORECAST` |
| Validity mask | `<REQUIRED>` | `<REQUIRED>` | `DERIVED_METADATA` |
| Abstention/disposition | `<REQUIRED>` | `<REQUIRED>` | `DERIVED_METADATA` |
| OOD score/state | `<REQUIRED>` | `<REQUIRED>` | `DERIVED_METADATA` |
| Receipt/provenance | `<REQUIRED>` | `<REQUIRED>` | `SIGNED_METADATA` if signed |
The output must bind model, configuration, input schema, calibration, source
time range, optional retrieval index, and content hashes. Explain whether and
how quantile crossing is corrected:
`<REQUIRED>`
## RuVector retrieval
| Field | Value |
|---|---|
| Enabled | `<REQUIRED true/false>` |
| Index artifact/version/digest | `<REQUIRED or NONE>` |
| Allowed retrieval corpus | `<REQUIRED>` |
| Split-isolation receipt | `<REQUIRED>` |
| Neighbour exclusion rules | `<REQUIRED>` |
| Maximum neighbours/search budget | `<REQUIRED>` |
| Behaviour when index is absent/stale | `<REQUIRED>` |
Report identical-dataset ablations for no retrieval and retrieval. If these do
not exist, state `UNMEASURED`.
## RuVLLM integration
State whether RuVLLM consumes this artifact's signed forecast records. It may
explain results but must not rewrite point/quantile values or acquire action
authority from prose.
| Control | Evidence |
|---|---|
| Numeric outputs originate only from signed forecast record | `<REQUIRED or NOT INTEGRATED>` |
| Explanation cites artifact and forecast receipt | `<REQUIRED or NOT INTEGRATED>` |
| No model promotion, spending, actuation, or safety-critical authority | `<REQUIRED or NOT INTEGRATED>` |
| Prompt/data retention and tenant policy | `<REQUIRED or NOT INTEGRATED>` |
## Independent-development record
| Record | Digest/approval |
|---|---|
| Approved source allowlist | `<REQUIRED>` |
| Specification digest | `<REQUIRED>` |
| Contributor exposure manifest | `<REQUIRED>` |
| Contributor attestation bundle | `<REQUIRED>` |
| AI-tool prompt/session manifest | `<REQUIRED>` |
| Prohibited-artifact scan | `<REQUIRED>` |
| Source-similarity review | `<REQUIRED>` |
| Clean-room custodian approval | `<REQUIRED>` |
| Legal release approval | `<REQUIRED for production>` |
Declaration:
`<REQUIRED: State exactly what was independently authored and trained. Do not
state that clean room eliminates patent, trademark, dataset, privacy, or
jurisdiction risk.>`
Prior exposure disclosures and dispositions, without private details:
`<REQUIRED or NONE>`
## Training data
Do not list a dataset until its licensing/privacy gate passes.
| Dataset ID/version | Role | Origin/owner | License or contract ID | Commercial ML | Privacy class | Records/windows | Source/transform/split digests |
|---|---|---|---|---|---|---:|---|
| `<REQUIRED>` | train/validation/calibration | `<REQUIRED>` | `<REQUIRED>` | `YES` required | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
### Excluded data
Explicitly state that TimesFM 3 weights, outputs, activations, generated labels,
and derivatives were excluded, then list all other exclusions:
`<REQUIRED>`
### Collection, consent, minimization, and retention
`<REQUIRED: collection authority, purpose, consent/contract, controller and
processor, sensitive inferences, pseudonymization, fields removed, geographic
scope, retention, deletion, access, and incident contact.>`
### Synthetic data
| Generator/version | Seed-data rights | Provider/output terms | Seeds/config digest | Proportion | Use |
|---|---|---|---|---:|---|
| `<REQUIRED or NONE>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
## Split and leakage protocol
| Split | Sites | Subjects | Sessions | Devices | Time blocks | Windows | Manifest digest |
|---|---:|---:|---:|---:|---:|---:|---|
| Train | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
| Validation | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
| Calibration | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
| Test | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
Required leakage checks:
- parent raw record and derived-window overlap;
- contiguous sequence/session overlap;
- subject/site/device/calibration leakage;
- target-horizon overlap;
- fitted preprocessing or threshold leakage;
- RuVector neighbour/index leakage;
- duplicate and near-duplicate leakage;
- test-informed architecture or hyperparameter changes.
Report and digest:
`<REQUIRED>`
## Training procedure
| Field | Value |
|---|---|
| Random initialization | `true` required for this model family |
| Parent checkpoint | `NONE` or approved RuView artifact and digest |
| Source commit | `<REQUIRED>` |
| Cargo.lock digest | `<REQUIRED>` |
| Rust toolchain | `<REQUIRED exact>` |
| Build/training container | `<REQUIRED digest>` |
| Training config digest | `<REQUIRED>` |
| Seeds | `<REQUIRED>` |
| Optimizer/schedule/loss | `<REQUIRED>` |
| Batch/epochs/stopping | `<REQUIRED>` |
| Hardware | `<REQUIRED exact CPU/GPU/RAM>` |
| Provider | `<REQUIRED local Linux or approved provider>` |
| Provider job ID | `<REQUIRED non-secret identifier>` |
| Wall time | `<REQUIRED and evidence label>` |
| Peak host/GPU memory | `<REQUIRED and evidence label>` |
| Estimated/actual cost | `<REQUIRED and evidence label>` |
| Emitted checkpoint digests | `<REQUIRED>` |
| Training receipt digest | `<REQUIRED>` |
If local and hosted runs are compared, list numerical-determinism differences
and prove that governed code, data, config, and parent identities match:
`<REQUIRED or NOT APPLICABLE>`
## Evaluation
### Baselines and ablations
Every row uses the same frozen examples and metric implementation.
| Model | Artifact/version | Retrieval | Parameters | Evidence label | Notes |
|---|---|---|---:|---|---|
| Last value | `<REQUIRED>` | no | n/a | `<REQUIRED>` | deterministic baseline |
| Seasonal naive | `<REQUIRED>` | no | n/a | `<REQUIRED>` | `<REQUIRED period>` |
| Small classical/recurrent baseline | `<REQUIRED>` | no | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
| RuView Forecast | `<REQUIRED>` | no | `<REQUIRED>` | `<REQUIRED>` | required ablation |
| RuView Forecast | `<REQUIRED>` | yes | `<REQUIRED>` | `<REQUIRED>` | required if retrieval is enabled |
Do not use TimesFM 3 as an implementation oracle, label source, tuning signal,
or required acceptance baseline.
### Forecast metrics
Report per horizon and per site/device/interference regime, plus pooled values.
| Metric/domain/horizon | Result | 95% interval | Evidence label | Reproducer |
|---|---:|---:|---|---|
| Weighted quantile loss | `<REQUIRED or UNMEASURED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
| MAE or scaled error | `<REQUIRED or UNMEASURED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
| Nominal 80% interval coverage | `<REQUIRED or UNMEASURED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
| Interval width | `<REQUIRED or UNMEASURED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
| Quantile crossing before/after policy | `<REQUIRED or UNMEASURED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
| Abstention coverage/selective risk | `<REQUIRED or UNMEASURED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
ADR-348 G3 targets are at least 10% weighted-quantile-loss improvement over
seasonal naive and 75%-85% measured coverage for a nominal 80% interval. These
remain `UNMEASURED targets` until populated by qualifying evidence.
### RuView shadow outcomes
| Metric | Baseline | Candidate | Delta/CI | Evidence label | Reproducer |
|---|---:|---:|---:|---|---|
| Empty-room false alerts | `<REQUIRED or UNMEASURED>` | `<REQUIRED or UNMEASURED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
| Occupied-room recall | `<REQUIRED or UNMEASURED>` | `<REQUIRED or UNMEASURED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
| Abstention by deployment | `<REQUIRED or UNMEASURED>` | `<REQUIRED or UNMEASURED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
| Drift/OOD rate | `<REQUIRED or UNMEASURED>` | `<REQUIRED or UNMEASURED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
ADR-348 G4 targets at least 50% relative empty-room false-alert reduction with
no more than 2 percentage points occupied-room recall loss over at least 14
shadow days. These are `UNMEASURED targets`, not current capabilities.
### Runtime measurements
| Platform | Build/features | Batch/streams | Context/horizon | p50/p95/p99 | Peak RSS | Evidence label | Reproducer |
|---|---|---:|---|---|---:|---|---|
| `<REQUIRED named CPU>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED or UNMEASURED>` | `<REQUIRED or UNMEASURED>` | `<REQUIRED>` | `<REQUIRED>` |
| `<optional GPU>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED or UNMEASURED>` | `<REQUIRED or UNMEASURED>` | `<REQUIRED>` | `<REQUIRED>` |
ADR-348 G5 CPU targets are at most 1 second p95 for 32 declared streams and at
most 4 GiB peak process memory. They are `UNMEASURED targets` until this table
contains a qualifying named-platform reproducer.
## Calibration, OOD, and abstention
| Control | Fit data | Frozen parameters/digest | Test result | Evidence label |
|---|---|---|---|---|
| Input normalization | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
| Quantile calibration | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
| OOD threshold | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
| Minimum validity/context | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
| Drift threshold | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
List all typed abstention reasons and demonstrate that unknown schema, missing
calibration, stale data, insufficient history, invalid masks, non-finite input,
OOD state, and artifact failure do not produce an authoritative forecast:
`<REQUIRED>`
## Robustness and failure analysis
Report at minimum:
- unseen site and unseen device;
- empty room and low-motion occupancy;
- burst loss, cadence change, clock reset, and sensor restart;
- interference, channel change, and calibration drift;
- long missing runs and adversarial non-finite/range inputs;
- corrupted/truncated/oversized model and input artifacts;
- absent or stale RuVector index;
- concurrent-load resource caps and timeout;
- false confidence from narrow intervals during distribution shift.
| Scenario | Expected safe behaviour | Observed result | Evidence label | Open risk/owner |
|---|---|---|---|---|
| `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED or UNMEASURED>` | `<REQUIRED>` | `<REQUIRED>` |
## Security and privacy
### Threat model summary
| Threat | Control | Evidence | Residual risk/owner |
|---|---|---|---|
| Malicious/corrupt model artifact | Signature, digest, schema and size verification; no embedded code | `<REQUIRED>` | `<REQUIRED>` |
| Oversized/malformed request | Dimension, allocation, horizon, context, batch and deadline caps | `<REQUIRED>` | `<REQUIRED>` |
| Poisoned data or split leakage | Approved manifests, immutable transforms, lineage and overlap checks | `<REQUIRED>` | `<REQUIRED>` |
| Cross-tenant analogue retrieval | Tenant and split-scoped RuVector indexes | `<REQUIRED>` | `<REQUIRED>` |
| Routine/location inference | Minimization, purpose, retention, deletion, access and audit | `<REQUIRED>` | `<REQUIRED>` |
| Model extraction/membership inference | Rate/access control and privacy evaluation | `<REQUIRED>` | `<REQUIRED>` |
| Hosted-worker data retention | Approved provider terms, least data, deletion receipt | `<REQUIRED>` | `<REQUIRED>` |
| LLM numeric mutation or overclaim | Signed numeric record and capability policy | `<REQUIRED or NOT INTEGRATED>` | `<REQUIRED>` |
### Data handling
`<REQUIRED: tenant isolation, encryption, keys, access roles, logs, metrics
allowlist, retention, deletion, export, incident handling, and whether feature
or forecast persistence is enabled.>`
## Deployment
| Field | Value |
|---|---|
| Supported mode | `<REQUIRED>` |
| Supported platform/CPU/GPU | `<REQUIRED>` |
| Minimum RAM/storage | `<REQUIRED and evidence-labelled>` |
| Offline artifact source | `<REQUIRED>` |
| Signature/trust root | `<REQUIRED public key ID>` |
| Configuration/calibration artifact | `<REQUIRED digest>` |
| RuVector index requirement | `<REQUIRED>` |
| Startup self-test | `<REQUIRED>` |
| Health/drift metrics | `<REQUIRED allowlisted fields>` |
| Timeout/backpressure policy | `<REQUIRED>` |
| Rollback artifact/mode | `<REQUIRED>` |
No deployment may fetch an unpinned model at runtime. Describe exact startup
failure and fail-closed behaviour:
`<REQUIRED>`
## Monitoring, rollback, and retirement
| Signal | Threshold | Window | Response | Owner |
|---|---:|---|---|---|
| Calibration/coverage drift | `<REQUIRED>` | `<REQUIRED>` | shadow/off | `<REQUIRED>` |
| OOD/abstention rate | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
| Latency/resource regression | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
| Empty/occupied outcome regression | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
| Provenance/signature failure | any | immediate | disable artifact | `<REQUIRED>` |
| Security/privacy incident | any material incident | immediate | isolate, preserve evidence, disable | `<REQUIRED>` |
Rollback drill receipt and result:
`<REQUIRED>`
Retirement and data/index/checkpoint deletion policy:
`<REQUIRED>`
## Limitations and largest uncertainty
`<REQUIRED: List observed and unmeasured limitations. The default largest
uncertainty is whether training diversity supports unseen-room and unseen-device
generalization without suppressing legitimate occupied states. State the
specific data/evaluation fix path.>`
## Cost, energy, and operational burden
| Item | Value | Evidence label | Method |
|---|---:|---|---|
| Training accelerator hours | `<REQUIRED or UNMEASURED>` | `<REQUIRED>` | `<REQUIRED>` |
| Training cost | `<REQUIRED or UNMEASURED>` | `<REQUIRED>` | `<REQUIRED>` |
| Training energy/emissions | `<REQUIRED or UNMEASURED>` | `<REQUIRED>` | `<REQUIRED>` |
| CPU inference cost/energy | `<REQUIRED or UNMEASURED>` | `<REQUIRED>` | `<REQUIRED>` |
| Storage/index overhead | `<REQUIRED or UNMEASURED>` | `<REQUIRED>` | `<REQUIRED>` |
| Operator/calibration burden | `<REQUIRED or UNMEASURED>` | `<REQUIRED>` | `<REQUIRED>` |
## Licenses and notices
| Surface | Exact license/terms | URL/file | Obligations | Approval |
|---|---|---|---|---|
| Rust source | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
| Weights | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
| Each dataset | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
| Dependencies/SBOM | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
| Training provider | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
Trademark clearance ID and scope:
`<REQUIRED for public production release>`
Patent freedom-to-operate disposition and launch jurisdictions:
`<REQUIRED for production; keep privileged analysis outside this public card>`
## Provenance and reproducibility
| Artifact | Digest/signature/location |
|---|---|
| Source allowlist | `<REQUIRED>` |
| Specification | `<REQUIRED>` |
| Source commit | `<REQUIRED>` |
| Cargo.lock | `<REQUIRED>` |
| SBOM | `<REQUIRED>` |
| Dataset manifest | `<REQUIRED>` |
| Split/leakage report | `<REQUIRED>` |
| Training config | `<REQUIRED>` |
| Training receipt | `<REQUIRED>` |
| Evaluation report | `<REQUIRED>` |
| Clean-room report | `<REQUIRED>` |
| Model weights | `<REQUIRED>` |
| RVF signature | `<REQUIRED or NONE with blocker>` |
| Reproducer | `<REQUIRED>` |
Reproduction commands must use pinned artifacts and must not contain secrets or
download restricted material:
```bash
<REQUIRED safe, exact commands>
```
## ADR-348 gate traceability
| Gate | Requirements | Evidence in this card/bundle | Result |
|---|---|---|---|
| G0 independent-authoring boundary | RF-001, RF-002 | allowlist, exposure, attestation, scans, similarity review | `<OPEN, PASS, or FAIL>` |
| G1 data and lineage | RF-002, RF-003, RF-010 | dataset approvals, lineage, local/hosted receipts | `<OPEN, PASS, or FAIL>` |
| G2 bounded Rust contract | RF-004, RF-005, RF-006 | contract/fuzz/replay/resource/dependency reports | `<OPEN, PASS, or FAIL>` |
| G3 leakage-free model evidence | RF-007, RF-008, RF-011 | frozen split, baselines, ablations, calibration, reproducers | `<OPEN, PASS, or FAIL>` |
| G4 RuView shadow value | RF-006, RF-007, RF-008, RF-009 | 14-day outcomes, drift, abstention, no action authority | `<OPEN, PASS, or FAIL>` |
| G5 deployment fitness | RF-004, RF-009, RF-010, RF-011, RF-012 | runtime, approvals, signed bundle, rollback | `<OPEN, PASS, or FAIL>` |
Highest permitted deployment mode from these results:
`<REQUIRED>`
## Approvals
Signatures cover this exact model-card digest and weight digest.
| Role | Approver/receipt | Decision | Timestamp |
|---|---|---|---|
| Model owner | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
| Clean-room custodian | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
| Data steward/privacy | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
| Security owner | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
| Runtime owner | `<REQUIRED>` | `<REQUIRED>` | `<REQUIRED>` |
| Legal release owner | `<REQUIRED for production>` | `<REQUIRED>` | `<REQUIRED>` |
## Citation
Use the final public model name, exact version, weight digest, repository commit,
and model-card URL:
```bibtex
@software{<REQUIRED citation key>,
title = {<REQUIRED>},
author = {<REQUIRED>},
year = {<REQUIRED>},
version = {<REQUIRED>},
url = {<REQUIRED>},
note = {Weights SHA-256: <REQUIRED>; source commit: <REQUIRED>}
}
```
## Change history
| Card version | Weight digest | Change | Gate impact | Date |
|---|---|---|---|---|
| `<REQUIRED>` | `<REQUIRED>` | Initial candidate | All gates evaluated independently | `<REQUIRED>` |

View File

@@ -0,0 +1,111 @@
# RuView ESP32 firmware 0.8.8
Firmware 0.8.8 is a reliability and correctness release for ESP32-S3 and
ESP32-C6 RuView nodes. It makes the timing used by signal processing explicit,
prevents contradictory occupancy output, and improves update diagnostics.
## What changed
### Empty means zero people
Older firmware could report `presence=false` and a nonzero person count in the
same edge packet. That was internally contradictory and could contaminate an
empty-room calibration. Firmware 0.8.8 clears the count whenever the presence
gate is closed. The sensing server repeats the same check when it receives data
from older nodes.
This is a consistency fix, not proof that the heuristic can count multiple
people accurately. See
[ADR 346](../adr/ADR-346-fail-closed-edge-occupancy-evidence.md).
### Stable time scale on ESP32-C6
Raw CSI and on-device signal processing now have separate clocks. The C6 keeps
raw CSI moving over the network while its Tier 2 filters process a stable 8 Hz
sample stream. The S3 retains its 20 Hz DSP default. A phase-preserving sampler
keeps callback jitter from shifting those clocks.
The result is a correct time base for motion and vital-band features. It does
not by itself prove that heartbeat, respiration, gesture, or pose estimates are
more accurate. See
[ADR 347](../adr/ADR-347-rate-aware-esp32-temporal-sensing.md).
### Better diagnostics and safer updates
The one-second controller log now shows both raw callback yield and DSP rate.
The OTA status endpoint reports the actual selected application partition size
instead of a fixed 900 KB assumption. Firmware upload remains fail closed when
the node has no provisioned OTA signing secret.
## Measured hardware validation
All results below are physical measurements from 2026-08-31. They are not
simulator claims.
| Board | Duration | Raw CSI mean | DSP clock | Live coverage | Steady-state transport errors |
|-------|---------:|-------------:|----------:|--------------:|------------------------------:|
| ESP32-C6 node 4 | 300.64 s | 34.92 pps | 8.00 Hz | 97.62% | 0 |
| ESP32-C6 node 7 | 300.70 s | 36.32 pps | 8.00 Hz | 97.40% | 0 |
| ESP32-S3 node 1 | 300 s | 28.03 pps | Tier 0 | 100.00% | 0 |
The first C6 empty-room qualification observed 61 absent packets with zero
nonzero counts. The second C6 was transport-qualified in an occupied room and
still needs its own controlled empty-room sequence. Full evidence is recorded
in:
1. [C6 timing and transport](../validation/2026-08-31-esp32-c6-rate-aware-sensing.md)
2. [C6 occupancy integrity](../validation/2026-08-31-esp32-c6-occupancy-integrity.md)
3. [Second C6 timing and transport](../validation/2026-08-31-esp32-c6-node7-rate-aware-sensing.md)
4. [S3 transport](../validation/2026-08-31-esp32-s3-rate-aware-transport.md)
## Choose the correct download
| Release file | Target |
|--------------|--------|
| `esp32-csi-node-v0.8.8-s3-8mb-flash-bundle.zip` | ESP32-S3 with 8 MB flash |
| `esp32-csi-node-v0.8.8-s3-4mb-flash-bundle.zip` | ESP32-S3 with 4 MB flash |
| `esp32-csi-node-v0.8.8-c6-4mb-flash-bundle.zip` | ESP32-C6 using the supported 4 MB partition layout |
| `esp32-csi-node-v0.8.8-s3-8mb.bin` | S3 8 MB application only |
| `esp32-csi-node-v0.8.8-s3-4mb.bin` | S3 4 MB application only |
| `esp32-csi-node-v0.8.8-c6-4mb.bin` | C6 application only |
Never mix S3 and C6 images. Confirm the chip and physical flash before writing.
## Install or update
For a fresh installation, extract the matching bundle and follow its included
`FLASHING.md`. The standard offsets are:
| Image | Offset |
|-------|-------:|
| Bootloader | `0x0000` |
| Partition table | `0x8000` |
| OTA metadata | `0xf000` |
| Application | `0x20000` |
For an existing provisioned node:
1. Back up the current application partition.
2. Confirm the exact chip, flash layout, logical node, and serial port.
3. Read `http://DEVICE_IP:8032/ota/status`.
4. Use an application-only serial update at `0x20000` only when the running
partition is `ota_0` and the image matches the board.
5. Reboot and confirm version 0.8.8, the preserved node identity, channel, and
sensing-server target.
6. Run a five-minute burn-in before returning the node to calibration duty.
The full bundle does not contain an NVS image. A four-offset install therefore
preserves the existing WiFi and node settings, but operators should still keep
a backup before changing firmware.
## What this release does not prove
Firmware 0.8.8 does not prove medical-grade vital signs, accurate person
counting, identity, dense pose, through-wall video, or room separation. Those
claims require synchronized references and leakage-free held-out sequences.
The practical next acceptance test is a controlled empty-room capture with at
least 30 absent edge packets per updated node, zero absent packets carrying a
nonzero count, and zero transport or parser errors. Accuracy evaluation then
needs held-out occupied, movement, heartbeat-reference, and adjacent-room
sequences.

View File

@@ -0,0 +1,511 @@
# RuView Forecast clean-room, data, and release protocol
**Status:** Proposed and mandatory for any artifact claiming independent
development under ADR-348.
**Evidence status:** This document defines controls. It does not assert that the
controls have passed, that a trained model exists, or that any forecasting
capability is measured. Every ADR-348 gate remains **OPEN / UNMEASURED** until a
signed evidence bundle proves otherwise.
## 1. Purpose and authority
This protocol governs the specification, implementation, training, evaluation,
hosting, and release of the independent Rust multivariate forecaster defined by
[ADR-348](../adr/ADR-348-independent-rust-multivariate-forecasting.md).
It applies to source, issue and review text, prompts, dependencies, datasets,
intermediate tensors, checkpoints, containers, CI caches, RuVector indexes,
fal.ai jobs, benchmark results, model cards, and published artifacts.
The protocol is intentionally stricter than the minimum conditions for using
Apache-licensed source. Its purpose is to preserve evidence that the RuView
implementation and weights were independently created. It is not a legal
opinion. The legal release owner must approve the current licenses, contributor
exposure record, patent review, trademark review, datasets, and intended launch
jurisdictions before production.
## 2. License boundary as of 2026-09-01
The authoritative public materials state two different license surfaces:
1. The [Google TimesFM repository](https://github.com/google-research/timesfm)
identifies its source code as Apache-2.0.
2. The [TimesFM 3 checkpoint license](https://huggingface.co/google/timesfm-3.0-pytorch/blob/main/LICENSE)
permits non-commercial, non-production use and restricts commercial use,
distribution, and use to train, fine-tune, or distill another commercial
model.
The checkpoint license defines a derivative broadly enough that relying on its
logic, parameters, or model-generated material creates avoidable contractual
risk. No contributor may accept gated model terms on behalf of the project or
its owner without written authorization.
The [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0) permits
source reproduction and derivative works subject to its conditions, including
license delivery, change notices, retention of applicable notices, and NOTICE
handling. Apache also provides a limited contributor patent grant and no general
trademark grant. If maintainers ever choose an Apache-derived port, it must use
a separate branch, attribution path, artifact name, and superseding ADR. It
must not be described as the clean-room implementation.
Publicly described ideas, procedures, processes, systems, and methods are not
the same as copied expression. United States copyright law states the
idea-expression boundary in [17 U.S.C. section 102(b)](https://www.copyright.gov/title17/92chap1.html).
That does not settle contract, patent, trademark, database-right, trade-secret,
or non-U.S. law questions.
## 3. Non-mixing rule
Only one of these paths may govern a source tree:
| Path | Source basis | Required representation |
|---|---|---|
| Independent implementation | Approved abstract specification, public papers/articles, general literature, RuView requirements, approved data | "Independently developed and independently trained" after all gates pass |
| Apache-derived port | Apache-licensed Google source with full license and notice compliance | "Apache-derived Rust port" with attribution |
There is no hybrid path. A permissive source license makes porting possible; it
does not make a port independent. If exposure cannot be bounded, maintainers
must either quarantine and rewrite the affected component or reclassify the
whole affected component under the Apache-derived path.
## 4. Roles and separation
| Role | May access | Must not access or do |
|---|---|---|
| Clean-room custodian | Exposure records, allowlist, scan reports, quarantined evidence | Contribute core model implementation after reviewing prohibited source fragments |
| Specification reviewer | Frozen public-paper/article allowlist, RuView requirements, generic literature | Google TimesFM implementation, tests, configs, checkpoint files, model outputs; contribute implementation |
| Rust implementer | Approved independent specification, RuView schemas, approved generic dependencies | TimesFM source, tests, configs, weights, outputs, line-by-line/API translation, reference differential testing |
| Data steward | Dataset source, contracts, consent, privacy and transformation records | Approve unknown or incompatible rights; infer that a software license covers data |
| Training operator | Signed code/container/config and approved dataset manifests | Change code/data/config outside a new receipt; add an unapproved parent checkpoint |
| Independent evaluator | Frozen candidate, frozen evaluation manifests, approved baselines | Return reference predictions or implementation hints to developers; tune against the test set |
| Legal release owner | Complete evidence bundle and private legal analysis | Treat clean-room checks as patent clearance or dataset approval by implication |
One person may hold multiple roles only where the forbidden-access rules remain
true. The strongest separation uses different people for public specification
and implementation. A specification reviewer who has inspected prohibited
source cannot become a core implementer for the independent path.
## 5. Source classification
### 5.1 Allowed
- The public TimesFM research articles and peer-reviewed papers, frozen by URL,
retrieval date, and SHA-256 digest.
- General time-series, transformer, probabilistic forecasting, normalization,
missing-data, and calibration literature.
- RuView requirements, independently written feature schemas, and existing
RuView contracts whose provenance already satisfies repository policy.
- Generic Rust dependencies whose license, source, and purpose are recorded and
approved.
- Public benchmark specifications and datasets after the dataset gate passes.
- Published aggregate competitor results used only as contextual background.
### 5.2 Conditional
- Code implementing generic algorithms may be used only after license review
and must be declared as a dependency or attributed source. It cannot be used
to claim that every line was independently authored.
- TimesFM versions up to 2.5 may have permissively licensed code or weights, but
they remain outside the independent implementation and training path. An
evaluator may use an approved permissive baseline only after the candidate
is frozen, and its output cannot become training data or implementation
feedback.
- A contributor with prior exposure to TimesFM code must disclose the exact
material and date. The custodian and legal owner decide whether the person is
limited to non-implementation work or the affected component must be
reclassified.
- Synthetic data is allowed only when source data, generator code/model,
provider terms, output rights, and intended commercial use all pass review.
### 5.3 Prohibited
- TimesFM 3 weights, parameters, checkpoints, tensor dumps, checkpoint
configuration, hidden activations, embeddings, gradients, or derived
fingerprints.
- TimesFM 3 forecasts, quantiles, scores, probabilities, recommendations, or
synthetic labels in development, training, tuning, or release evidence.
- Fine-tuning, distillation, imitation, teacher-student learning, differential
testing, behavioural cloning, or hyperparameter search against TimesFM 3.
- Manual, mechanical, or AI-assisted translation of Google source, tests,
comments, constants, APIs, file layout, or diagrams.
- Third-party code, datasets, or checkpoints whose origin may contain copied or
distilled TimesFM material without documented permission.
- Model, dataset, or service terms labelled non-commercial, research-only,
evaluation-only, no-derivatives, no-ML, no-production, or unknown.
- Confidential third-party information or material obtained under an agreement
that does not authorize this implementation and commercial use.
## 6. Exposure intake and contributor attestation
Before receiving implementation access, every contributor completes an
exposure intake covering:
- TimesFM repositories, model cards, gated checkpoint files, local caches,
notebooks, issues, tutorials, and generated outputs viewed or downloaded;
- whether gated terms were accepted and for which individual or entity;
- source or output material placed in an LLM, IDE assistant, retrieval index,
prompt, or code-generation session;
- prior work for Google, a competitor, customer, or other party involving
confidential forecasting implementation;
- datasets, pretrained models, and external code expected in the contribution.
Each pull request also carries a signed attestation:
```text
RuView Forecast clean-room attestation v1
Contributor:
Employer or represented entity:
Role:
Covered commits:
Prior TimesFM exposure: NONE or complete disclosure
Approved sources used:
Datasets introduced:
AI tools used:
Prompt/session manifest digest:
I attest that the covered contribution was created from the approved
specification and listed sources. I did not access, copy, translate, decompile,
query, distill, or use TimesFM 3 implementation material, configuration,
weights, parameters, outputs, or internal representations. I did not place
prohibited material in an AI tool context. I disclosed all contrary facts
above. Every dependency and dataset I introduced has documented rights for its
stated use.
Signature:
Timestamp:
```
A DCO `Signed-off-by` line does not replace this attestation. The attestation
digest, not private identity material, is referenced from the public release
manifest.
## 7. Specification controls
The custodian freezes an allowlist before implementation begins. Every entry
records title, canonical URL or DOI, publication date, retrieval time, content
digest, license or access terms, reviewer, and the abstract requirement it
supports.
The specification may state mathematical functions, tensor roles, input/output
invariants, resource bounds, and RuView-specific requirements. It must not
include copied source, comments, tests, distinctive identifiers, constants,
checkpoint dimensions extracted from files, API compatibility requirements, or
Google diagrams. RuView API names must be derived from the local domain.
Changes to the specification after test evaluation receive a new version and
must not encode held-out answers. A material architecture revision consumes a
new untouched holdout or remains labelled exploratory.
## 8. AI coding-tool controls
An AI assistant can unintentionally defeat source separation by retrieving or
reproducing reference code. For sessions contributing implementation:
1. Disable web retrieval and repository indexing outside the approved local
tree where the tool supports it.
2. If a user describes the goal as a port, clone, reproduction, or emulation,
stop and restate the task as independently authored RuView functional
requirements. Record that wording in the exposure manifest; do not use it
as permission to retrieve reference implementation material or pursue
behavioral equivalence.
3. Do not attach Google code, checkpoint metadata, outputs, screenshots, or
detailed third-party implementation summaries.
4. State the independent specification and prohibited-source boundary in the
session instructions.
5. Retain a bounded prompt and tool-source manifest digest without committing
raw private transcripts.
6. Record the model/tool version and whether retrieval was enabled.
7. Treat unexplained code that resembles a prohibited implementation as an
incident, not as a harmless generated suggestion.
AI-generated code receives the same authorship, license, security, and
similarity review as human-authored code.
## 9. Dataset licensing and privacy gate
No dataset enters preprocessing, a RuVector index, training, calibration, or
evaluation until a data steward records affirmative answers to every applicable
gate:
| Gate | Required evidence | Automatic rejection examples |
|---|---|---|
| Origin | Named owner/provider, acquisition method, immutable source digest | Scrape or file of unknown origin |
| Training rights | Written right to use for ML training and the intended commercial purpose | Research-only, NC, no-ML, evaluation-only |
| Derivatives | Right to transform, derive windows/features, and create model artifacts | No-derivatives or ambiguous custom terms |
| Redistribution | Whether raw, transformed, manifests, and weights may be redistributed separately | Assumption that public access means redistribution |
| Attribution | Exact attribution and notice obligations | Missing author/source/version |
| Database rights | Jurisdiction and database-right review where applicable | Unreviewed EU database extraction |
| Consent and contract | Collection authority, participant/customer consent, purpose, controller/processor roles | Customer telemetry without explicit model-training authority |
| Sensitive inference | Classification of occupancy, routines, location, health-adjacent and biometric implications | Unbounded identity or health inference |
| Minimization | Required fields only, pseudonymization, retention and deletion schedule | Raw CSI/person identifiers retained without need |
| Split integrity | Site/subject/session/device/time-block lineage and overlap report | Contiguous or derived-window leakage across splits |
| Synthetic lineage | Generator, seed data, service terms, output rights, seeds/config digest | Restricted teacher or prohibited source data |
Typical disposition guidance:
- Owned data, CC0/public-domain data, and data under an explicit commercial ML
contract may pass after privacy and provenance review.
- CC BY data requires attribution plus database and downstream-weight review.
- MIT and Apache are software licenses and do not automatically license nearby
data.
- NC, ND, research-only, evaluation-only, no-ML, no-production, and unknown
terms fail unless a separate written commercial grant is obtained.
Every transform is content-addressed. Normalizers, feature selectors,
calibrators, thresholds, and RuVector indexes fit training data only. Raw
sequence overlap and derived-window overlap are both checked. A parent record
in one split makes all overlapping descendants ineligible for another split.
## 10. Hosted training boundary
The Linux machine and fal.ai are execution environments, not sources of
authority. A hosted job is accepted only when:
- the exact source commit, Cargo lockfile, compiler, container digest, data
manifests, configuration, seeds, and parent checkpoint digest are signed
before upload;
- provider terms, retention, region, subprocessors, logs, cache deletion,
confidentiality, output ownership, and provider-training reuse have been
reviewed for the data classification;
- credentials are short-lived, least-privilege, excluded from images and logs,
and rotated after suspected exposure;
- customer-derived data is not uploaded before controller/processor and
transfer requirements pass;
- emitted checkpoints and logs are hashed immediately and compared with the job
receipt;
- the downloaded artifact is scanned before entering the trusted release
boundary;
- a hosted provider cannot promote, sign, or activate a model.
Hosted and local runs are comparable only when their governed input identities
match. Numerical nondeterminism must be documented; it does not permit an
unrecorded dependency, data, or configuration change.
## 11. Provenance manifest
The release bundle contains a machine-readable manifest with at least:
```yaml
schema_version: <required>
artifact:
id: <required>
version: <required>
git_commit: <sha>
source_spec_digest: <sha256>
cargo_lock_digest: <sha256>
rust_toolchain: <exact>
target_triple: <exact>
build_container_digest: <digest>
sbom_digest: <sha256>
contributors:
- pseudonymous_id: <stable id>
role: <role>
exposure_class: <unexposed|disclosed-reviewed>
attestation_digest: <sha256>
signed_at: <rfc3339>
references:
- title: <title>
canonical_uri: <url-or-doi>
publication_date: <date>
retrieved_at: <rfc3339>
content_digest: <sha256>
license_or_terms: <identifier>
allowed_use: <purpose>
reviewer: <id>
datasets:
- dataset_id: <id>
version: <version>
owner: <owner>
origin: <uri-or-contract-id>
license_or_contract: <identifier>
commercial_ml_allowed: <true>
redistribution_allowed: <true|false>
consent_basis: <identifier>
privacy_class: <class>
jurisdictions: [<jurisdiction>]
retention_policy: <policy-id>
source_digest: <sha256-or-merkle-root>
transform_digest: <sha256>
split_digest: <sha256>
record_count: <count>
training:
random_initialization: true
parent_checkpoint: null
code_commit: <sha>
config_digest: <sha256>
rng_seeds: [<seed>]
hardware: <inventory>
provider: <local-linux|approved-provider>
provider_job_id: <non-secret-id>
environment_digest: <sha256>
started_at: <rfc3339>
ended_at: <rfc3339>
forbidden_artifact_scan_digest: <sha256>
leakage_scan_digest: <sha256>
evaluation:
frozen_manifest_digest: <sha256>
baseline_artifacts: [<id-and-digest>]
metric_schema: <version>
report_digest: <sha256>
calibration_report_digest: <sha256>
domain_holdouts: [<site|subject|session|device>]
release:
weights_digest: <sha256>
model_card_digest: <sha256>
clean_room_report_digest: <sha256>
signature_key_id: <public-key-id>
rvf_signature: <signature>
source_license: <spdx-expression>
weights_license: <exact-identifier>
data_steward_approval: <signed-receipt>
security_approval: <signed-receipt>
legal_approval: <signed-receipt>
```
Secrets, raw personal identifiers, contract text, raw customer data, and
private contributor identities stay outside the public manifest. The manifest
references controlled records by digest or approval ID.
## 12. Source, dependency, and artifact checks
The custodian records tool versions, rules, timestamps, and complete findings.
At minimum:
- search the working tree and Git history for prohibited model IDs, URLs,
filenames, license strings, binary signatures, and unexpected large files;
- scan source similarity against the prohibited implementation in an isolated
custodian environment; implementation contributors do not receive reference
fragments from the report;
- manually adjudicate every material similarity match and record independent
origin, generic necessity, rewrite, or reclassification;
- run dependency license, source, duplicate-version, and vulnerability policy
checks and generate a CycloneDX or SPDX SBOM;
- inspect container layers, CI and provider caches, mounted volumes, model/data
buckets, notebooks, logs, and local tool indexes for restricted artifacts;
- verify that every checkpoint parent is an approved RuView artifact or the
declared random initialization;
- verify that model loading performs no network access and accepts no embedded
executable operator or arbitrary path;
- verify that public packages, endpoints, docs, and metadata do not use Google
trademarks as a product identity.
Keyword scans are a tripwire, not proof of independence. References in this
governance document are expected and must be path allowlisted. The final result
depends on provenance, exposure records, review, and the absence of prohibited
material in implementation/training paths.
## 13. Model card and claim gate
Every candidate copies and completes
[`../huggingface/RUVIEW_FORECAST_MODEL_CARD_TEMPLATE.md`](../huggingface/RUVIEW_FORECAST_MODEL_CARD_TEMPLATE.md).
No placeholder, `UNMEASURED`, unknown license, missing digest, or missing
approval may be silently deleted. It must instead be resolved or retained as an
explicit release blocker.
All accuracy, latency, memory, power, cost, and generalization values are
labelled `MEASURED`, `SYNTHETIC`, `CLAIMED`, or `UNMEASURED` under repository
policy. `MEASURED` requires a reproducer, immutable inputs, exact artifact, and
named hardware/environment. A model-card benchmark does not create authority
for a medical, emergency, security, or autonomous-action claim.
## 14. Naming, trademark, and comparative statements
Approved project identities include `RuView Forecast` and crate names derived
from the RuView domain. Do not use `TimesFM`, `Google`, or a confusingly similar
mark in crate names, binaries, model slugs, endpoints, logos, icons, or product
headlines. Do not copy diagrams or visual branding.
Comparative documentation may accurately identify an external model and its
version when necessary, with a statement that RuView Forecast is independently
developed and not affiliated with or endorsed by Google. Comparative claims
need identical datasets, metric definitions, permitted model use, and evidence
labels.
Before public naming or commercial release, complete a professional trademark
clearance that includes federal, state, common-law, domain, and relevant
international sources. The [USPTO clearance guidance](https://www.uspto.gov/trademarks/search/comprehensive-clearance-search-similar-trademarks)
is a starting point, not a complete legal opinion.
## 15. Residual patent and jurisdiction risk
Clean-room evidence does not prevent patent infringement. Before production,
patent counsel performs a claim-level freedom-to-operate review covering at
least temporal patching, multivariate/variate attention or mixing, masked
horizon prediction, known-future covariates, probabilistic heads, normalization,
retrieval augmentation, and relevant training procedures. Searches include
assignees, inventors, continuations, unpublished timing uncertainty, and launch
jurisdictions. The [USPTO Patent Public Search](https://www.uspto.gov/patents/search/patent-public-search)
supports preliminary searching but is not a freedom-to-operate opinion.
The Apache patent grant applies only within its stated scope. An independent
implementation must not assume it inherits that grant. Public papers may be
prior art yet still coexist with earlier, pending, territorial, or narrower
claims.
## 16. Contamination incident response
Treat any prohibited source, output, model, data, or unreviewed exposure as a
provenance incident:
1. Stop affected implementation, training, evaluation feedback, and release.
2. Preserve hashes, timestamps, actors, locations, access records, and affected
lineage. Do not erase the audit trail.
3. Quarantine the material and revoke it from build, data, model, cache, and
retrieval paths.
4. Identify every affected commit, specification revision, dataset transform,
RuVector index, checkpoint, benchmark, and descendant artifact.
5. Rotate credentials if a provider, cache, or secret may be exposed.
6. Have the custodian and legal owner choose one disposition: proven
non-impact, clean rewrite by unexposed contributors, full retraining from the
last clean ancestor, or explicit Apache-derived reclassification.
7. Repeat all affected ADR-348 gates and record the incident and closure
receipts.
If prohibited output becomes a label or tuning signal, all descendant weights
are affected. Code deletion alone cannot repair model lineage; retraining from
an approved clean initialization is required.
## 17. Requirement-mapped acceptance checklist
| Check | ADR-348 requirements | Gate | Acceptance condition |
|---|---|---|---|
| CR-01 source allowlist | RF-001, RF-002 | G0 | 100% of specification sources frozen, hashed, licensed/termed, and approved |
| CR-02 contributor exposure | RF-001, RF-002 | G0 | 100% of contributors have current intake and signed attestation; every disclosure has a disposition |
| CR-03 prohibited-artifact scan | RF-001 | G0 | Zero unresolved prohibited artifacts or outputs across source, history, caches, containers, jobs, data, indexes, and checkpoints |
| CR-04 similarity review | RF-001, RF-002 | G0 | Every material match adjudicated without exposing implementers to reference fragments |
| CR-05 dependency/SBOM | RF-002, RF-004 | G1, G2 | Zero unknown or denied dependency licenses; vulnerability policy passes; signed SBOM exists |
| CR-06 dataset rights | RF-003 | G1 | 100% of bytes map to approved manifests; zero NC, ND, research-only, no-ML, no-production, or unknown terms |
| CR-07 privacy | RF-003, RF-009 | G1, G5 | Consent/contract, minimization, tenant, retention, deletion, transfer, and sensitive-inference review approved |
| CR-08 checkpoint lineage | RF-001, RF-002, RF-010 | G1 | Every checkpoint reaches approved random initialization with no prohibited parent or label |
| CR-09 split isolation | RF-007, RF-008 | G3 | Zero raw/derived overlap across frozen site/subject/session/device/time splits; split-scoped RuVector indexes verified |
| CR-10 hosted parity | RF-010 | G1, G5 | Local/hosted receipts bind identical governed inputs; provider terms and deletion evidence approved |
| CR-11 model card | RF-002, RF-007, RF-011 | G3-G5 | Template complete; every value evidence-labelled and reproducible; all blockers explicit |
| CR-12 trademark and patent | RF-001, RF-011 | G5 | Naming clearance and claim-level freedom-to-operate disposition signed for launch jurisdictions |
| CR-13 rollback | RF-012 | G5 | Contamination and runtime rollback drills preserve observations and evidence while disabling forecast authority |
| CR-14 bounded forecast contract | RF-004, RF-005, RF-006 | G2 | Property/fuzz/replay evidence proves finite bounded inputs, abstention, offline execution, immutable observation linkage, and derived-only evidence labels |
| CR-15 downstream authority | RF-006, RF-009, RF-012 | G4, G5 | No sensing-server hook in the initial PR; any later bridge proves forecast/LLM output cannot mutate observations or acquire prohibited action authority |
| CR-16 claims and rollout | RF-011, RF-012 | G3-G5 | Every claim has an allowed evidence label and reproducer; mode transitions cannot outrun the highest passed gate |
Any failed or missing check blocks the mapped gate. A maintainer waiver cannot
convert a prohibited license into permission or an unmeasured capability into a
measured claim.
## 18. Release record
The legal, data, security, model, and runtime owners sign the same immutable
release digest. Their approval covers the exact source, data, configuration,
weights, model card, SBOM, intended use, deployment mode, and jurisdictions.
Changing any governed input creates a new candidate and invalidates inherited
approval.
The first production review must also answer one explicit question: does the
business value of the measured forecast exceed the added privacy, operational,
compute, and legal burden compared with deterministic baselines? If not, the
correct outcome is to keep forecasting offline.

File diff suppressed because it is too large Load Diff

View File

@@ -0,0 +1,120 @@
# ESP32 C6 node 7 rate aware sensing qualification
## Scope
This record qualifies the firmware 0.8.8 timing and transport path on a second
physically attached ESP32 C6. It measures raw callback cadence, edge DSP
cadence, process stability, and end to end sensing delivery. It does not
qualify heartbeat, respiration, pose, identity, room separation, or person
count accuracy against labelled ground truth.
## Hardware and firmware
| Field | Measured value |
|---|---|
| Board | ESP32 C6 QFN40 revision 0.2 |
| Logical node | 7 |
| Firmware before | 0.8.4 |
| Firmware after | 0.8.8 development build |
| App image | 1,051,552 bytes |
| App SHA 256 | `eab7561d65e302dc33e9331ac591763a46f92fb3fa9f824fef0e9b541daddb3f` |
| OTA slot size | 1,900,544 bytes |
| OTA headroom | 848,992 bytes, 45 percent |
Only the application partition at offset `0x20000` was flashed. WiFi
credentials, logical node identity, sensing server target, channel, edge tier,
bootloader, partition table, OTA metadata, and NVS were preserved. The pre
update application was copied to a private recovery file outside the
repository. Its SHA 256 is
`f5ebc5e0142425adae16e9180bf298ef444ea8862ba0d8809c310a39fe45721d`.
The device partition table was also read before the update and had SHA 256
`0a8d2f192a8fff209d6c75ab639fcf8aa2f43c64abb732c6e74596fbd6971dca`.
The post update boot log reported firmware 0.8.8, node 7, channel 10, Tier 2,
an 8 Hz edge DSP cadence, and the preserved sensing server target. The OTA
status endpoint reported firmware 0.8.8 running from `ota_0`, with `ota_1` as
the next partition and the correct 1,900,544 byte limit. The sensing server
health endpoint remained ready with ESP32 input.
## Before and after
The pre update baseline was a 20 second observation on the same attached board.
The post update observation was a five minute steady state run after boot.
| Observation | Before 0.8.4 | After 0.8.8 |
|---|---:|---:|
| Raw callback mean | 39.05 pps | 36.32 pps |
| Raw callback range | 35 through 42 pps | 24 through 42 pps |
| Server CSI FPS mean | 46.23 Hz | 48.88 Hz |
| WebSocket parser errors | 0 | 0 |
| WebSocket reconnects | 0 | 0 |
Raw callback mean changed by negative 7.0 percent while the server CSI FPS
estimate changed by positive 5.7 percent. Both remain above the 20 pps
transport floor. The result is transport neutral rather than an accuracy lift;
the room and WiFi traffic were not controlled between the two windows.
Firmware 0.8.4 did not expose the edge DSP cadence used by the temporal
filters. Firmware 0.8.8 held that separately governed clock at exactly 8.0 Hz
for every controller sample while preserving the higher rate raw network path.
## Five minute physical result
MEASURED on 2026 08 31 after flashing firmware 0.8.8:
| Device observation | Result |
|---|---:|
| Duration | 300.70 seconds |
| Controller samples | 300 |
| Raw callback mean | 36.32 pps |
| Raw callback range | 24 through 42 pps |
| Edge DSP mean | 8.00 Hz |
| Edge DSP range | 8.00 through 8.00 Hz |
| ENOMEM events | 0 |
| UDP send failures | 0 |
| ESP NOW nonzero failure lines | 0 |
| Other steady state errors | 0 |
| Watchdogs, panics, or reboots | 0 |
| End to end WebSocket observation | Result |
|---|---:|
| Duration | 300.06 seconds |
| Sensing frames | 36,254 |
| JSON parse errors | 0 |
| WebSocket errors or reconnects | 0 |
| Frames containing node 7 | 35,313 |
| Node 7 frame coverage | 97.40 percent |
| Node 7 stale frames | 0 |
| Maximum node 7 staleness | 972 ms |
| Maximum node 7 inference age | 483 ms |
| Maximum WebSocket frame gap | 108 ms |
| Nodes per frame | 0 through 5 |
| Fused presence count contradictions | 0 |
One ENOMEM backoff occurred during startup and recovered in 210 ms. No memory
backoff or send failure recurred in the separate five minute steady state
window. The boot log also reported the documented fail closed OTA behavior:
the status service was available, but image upload remained rejected because
this node has no provisioned OTA signing secret.
## Result and limitation
The node 7 timing and transport update passes. Its configuration survived, the
edge DSP clock remained phase stable at the measured sustainable C6 rate, and
the live service received fresh node 7 data throughout the run. This does not
complete the ADR 346 occupancy qualification for node 7 because the room was
not held empty and the live aggregate did not expose 30 absent edge packets.
The largest uncertainty remains inference accuracy. Timing stability cannot
prove better vital, motion, room separation, or multi person estimates without
synchronized held out labels and a controlled empty room sequence.
## Acceptance test
Repeat this five minute procedure after timing, WiFi, filter, or scheduling
changes. Pass transport only when raw callback yield remains at least 20 pps,
DSP cadence stays within one hertz of the configured target, the device has
zero steady state memory backoff, send failure, watchdog, panic, and reboot
events, the server has zero parse failures and reconnects, and the updated node
stays fresh. Complete occupancy qualification separately with at least 30
absent edge packets and zero absent packets carrying a nonzero person count.

View File

@@ -0,0 +1,60 @@
# ESP32 C6 occupancy evidence qualification
## Scope
This record qualifies the fail closed person count invariant in ADR 346 on one physically attached ESP32 C6. It does not qualify person counting accuracy, identity, pose, room separation, or vital sign accuracy.
## Hardware and firmware
| Field | Measured value |
|---|---|
| Board | ESP32 C6 QFN40 revision 0.2 |
| Logical node | 4 |
| Firmware before | 0.7.0 |
| Firmware after | 0.8.4 development build |
| App image | 1,051,168 bytes |
| App SHA 256 | `f9470a31b82612f1740f0cf0943ddb78917cd58784ba16d2e9d57cc8fb39364c` |
| OTA slot size | 1,900,544 bytes |
| CSI stream target | Preserved from NVS |
The device partition table was read before the update. NVS, OTA metadata, bootloader, and partition table were not overwritten. A private recovery copy was created outside the repository and excluded from version control.
## Software gates
| Gate | Result |
|---|---|
| Firmware host tests | PASS, 54 assertions across encoding, vital evidence, and mmWave detection |
| Rust sensing server package | PASS, 532 library tests plus all package integration and documentation tests |
| Mobile Jest suite | PASS, 164 suites and 1,223 tests |
| Mobile TypeScript | PASS |
| Mobile ESLint | PASS |
| Mobile security verifier | PASS |
| Repository wide Rust formatting | PREEXISTING DRIFT outside this change; changed code builds and package tests pass |
## Physical result
MEASURED on 2026 08 31 from the live local sensing WebSocket for 300 seconds:
| Node | Firmware state | Edge packets | Absent packets | Absent with nonzero count | Result |
|---|---|---:|---:|---:|---|
| 4 | Updated | 242 | 61 | 0 | PASS |
| 3 | Unupdated control | 216 | 216 | 216 | Expected control failure |
| 7 | Unupdated control | 280 | 278 | 278 | Expected control failure |
Node 4 reduced the targeted logical contradiction from observed to zero, a 100 percent reduction for this invariant during this run. This is not a person count accuracy result.
The WebSocket run had zero JSON parse errors and one expected client close at completion. The sensing server remained ready with `engine_error_count=0`. A separate 45 second serial observation recorded 120 log lines, 17 CSI callback markers, zero ENOMEM backoffs, and zero other error lines.
The updated OTA status endpoint reports the selected 1,900,544 byte partition rather than the stale 921,600 byte constant. The 1,051,168 byte image therefore fits with 849,376 bytes of partition headroom.
## Remaining qualification
Nodes 3 and 7 still demonstrate the old contradictory behavior and must be upgraded only after their network identity, OTA credential, and rollback path are verified. The current run had no labelled ground truth, so multi person fidelity and adjacent room rejection remain unmeasured.
## Subsequent node 7 status
Later on 2026 08 31, node 7 was separately identified, backed up, upgraded to firmware 0.8.8, and transport qualified for five minutes. That later occupied room run had zero fused presence count contradictions but did not produce the 30 absent edge packets required to supersede the historical control result above. See `docs/validation/2026-08-31-esp32-c6-node7-rate-aware-sensing.md`.
## Acceptance test
Repeat a five minute capture after every firmware change. Pass only when every updated node has at least 30 absent packets, zero packets where `presence=false` and `n_persons>0`, zero parser errors, and a ready sensing server with zero engine errors.

View File

@@ -0,0 +1,124 @@
# ESP32 C6 rate aware sensing qualification
## Scope
This record qualifies ADR 347 on one physically attached ESP32 C6 and verifies
that the same source compiles for ESP32 S3. It measures transport cadence, edge
DSP cadence, process stability, and end to end sensing delivery. It does not
qualify heartbeat, respiration, gesture, pose, identity, or person count
accuracy against labelled ground truth.
## Hardware and firmware
| Field | Measured value |
|---|---|
| Board | ESP32 C6 QFN40 revision 0.2 |
| Logical node | 4 |
| Firmware before | 0.8.4 |
| Firmware after | 0.8.8 development build |
| C6 app image | 1,051,552 bytes |
| C6 app SHA 256 | `f2ea422c9b99ec13c7a168afc2b019229642769ffabfd8f29a85978770236e87` |
| OTA slot size | 1,900,544 bytes |
| OTA headroom | 848,992 bytes, 45 percent |
| S3 compile image | 1,127,104 bytes |
| S3 compile SHA 256 | `63e4f0c484d79e7dd37eb28275951c8beb924e6908942f7fec0b90d92109129c` |
Only the application partition at offset `0x20000` was flashed. WiFi
credentials, node identity, sensing server target, bootloader, partition table,
OTA metadata, and NVS were preserved. The pre update OTA application was read
to a private recovery file outside the repository. Its SHA 256 is
`a2e503f1622b2f3f9c1cfce0a07ba34b9fc5d6a413b6346311622af1fe18a6d8`.
The OTA status endpoint reported firmware 0.8.8 running from `ota_0` after the
update. The sensing server health endpoint remained ready with ESP32 input.
## Software gates
| Gate | Result |
|---|---|
| Rate estimator and occupancy host tests | PASS, 30 assertions |
| ADR 110 encoding host tests | PASS, 21 assertions |
| mmWave frame predicate host tests | PASS, 8 assertions |
| ESP32 C6 IDF 5.4 ARM64 build | PASS |
| ESP32 S3 IDF 5.4 ARM64 build | PASS, compile only |
| Image checksum and validation hash | PASS |
| Repository diff whitespace check | PASS |
| Local libFuzzer aggregate | NOT RUN, local Xcode toolchain lacks `libclang_rt.fuzzer_osx.a` |
For this C6 record, the S3 result was source and toolchain validation only and
no S3 runtime claim is made here. The later physical S3 Tier 0 transport run is
recorded separately in
`docs/validation/2026-08-31-esp32-s3-rate-aware-transport.md`.
## Measured rate correction
The pre update 20 second C6 baseline delivered a mean 34.05 raw callbacks per
second, median 34.5, and range 28 through 37. An intermediate 0.8.7 physical
run requested 10 Hz edge DSP but converged to 8.0 through 8.4 Hz while raw CSI
remained 30 through 40 packets per second. This proved that C6 Tier 2 compute,
not the raw transport, was the limiting path.
Firmware 0.8.8 therefore keeps the 50 Hz probe and independent raw network
path, but sets the C6 Tier 2 DSP clock to its measured sustainable 8 Hz. The
phase preserving sampler prevents callback jitter from shifting the configured
clock, and the filter estimator follows processed timestamps rather than raw
probe intent.
## Five minute physical result
MEASURED on 2026 08 31 after flashing firmware 0.8.8:
| Device observation | Result |
|---|---:|
| Duration | 300.64 seconds |
| Controller ticks | 300 |
| Raw callback mean | 34.92 pps |
| Raw callback range | 22 through 41 pps |
| Edge DSP mean | 8.00 Hz |
| Edge DSP range | 8.00 through 8.00 Hz |
| ENOMEM events | 0 |
| UDP send failures | 0 |
| Other steady state errors | 0 |
| Watchdogs, panics, or reboots | 0 |
| End to end WebSocket observation | Result |
|---|---:|
| Duration | 300.01 seconds |
| Sensing frames | 26,786 |
| JSON parse errors | 0 |
| Reconnects | 0 |
| Frames containing node 4 | 26,148 |
| Node 4 frame coverage | 97.62 percent |
| Node 4 stale frames | 0 |
| Maximum node 4 inference age | 176 ms |
| Maximum WebSocket frame gap | 110 ms |
| Nodes per frame | 0 through 4 |
| Fused `presence=false` with nonzero count contradictions | 0 |
The boot log emitted one expected iTWT negotiation error because the access
point rejected the requested target wake time parameters. Firmware immediately
selected its documented opportunistic CSI fallback. No iTWT or other error
recurred during the five minute steady state window.
## Result and limitation
ADR 347 timing and transport acceptance passes on the attached C6. Raw
throughput did not regress relative to the short baseline, the edge clock now
matches the rate the temporal filters actually receive, and node 4 was never
stale when present in the live sensing service. The separate occupancy
qualification recorded 61 absent node 4 packets with zero contradictions for
the unchanged fail closed invariant. This run did not repeat an empty room
sequence because the room was occupied during qualification.
The largest remaining uncertainty is inference accuracy. Stable timing removes
one source of feature distortion but cannot prove better heartbeat, respiration,
gesture, or multi person classification without synchronized held out labels.
## Acceptance test
Repeat this five minute procedure after any timing, WiFi, filter, or task
scheduling change. Pass only when raw callback yield remains at least 20 pps,
DSP cadence remains within one hertz of the configured target, the device has
zero steady state ENOMEM, send failure, watchdog, panic, and reboot events, the
server has zero parse failures and reconnects, node 4 stays fresh, and fused
presence count contradictions remain zero.

View File

@@ -0,0 +1,126 @@
# ESP32 S3 rate aware transport qualification
## Scope
This record qualifies the firmware 0.8.8 raw transport path on one physically
attached ESP32 S3. The node retained its existing Tier 0 configuration, so this
run does not qualify the S3 edge DSP rate, temporal filters, heartbeat,
respiration, gesture, pose, identity, person count, or localization accuracy.
## Hardware and firmware
| Field | Measured value |
|---|---|
| Board | ESP32 S3 QFN56 revision 0.2 with 2 MB embedded PSRAM |
| Logical node | 1 |
| Firmware before | 0.8.4 |
| Firmware after | 0.8.8 development build |
| Edge tier | 0, raw passthrough |
| App image | 1,127,104 bytes |
| App SHA 256 | `b531c76900c07d0d6f6e864a5f28afff3e71f124777af97358bb405b34e339a2` |
| OTA slot size | 2,097,152 bytes |
| OTA headroom | 970,048 bytes, 46 percent |
The production partition table was read from the device before the update.
Only the application partition at offset `0x20000` was flashed. WiFi
credentials, logical node identity, channel, sensing server target, bootloader,
partition table, OTA metadata, and NVS were preserved. A private recovery copy
of the prior 2 MB application partition was saved outside the repository. Its
SHA 256 is
`14e72c060c4f1a465f739949b873f6aade5b8899a8909f6c5bb591ee49837c1b`.
The post update boot log reported firmware 0.8.8, logical node 1, channel 4,
the preserved UDP target, Tier 0 raw passthrough, and successful CSI streaming.
The OTA status endpoint reported firmware 0.8.8 running from `ota_0` with the
correct 2,097,152 byte update limit. The sensing server health endpoint remained
ready with ESP32 input.
## Software and image gates
| Gate | Result |
|---|---|
| Firmware encoding, vitals, occupancy, and mmWave host tests | PASS, 59 assertions |
| Firmware provisioning Python tests | PASS, 14 tests |
| ESP32 S3 IDF 5.4 ARM64 clean build | PASS |
| Image target detection | PASS, ESP32 S3 |
| Image checksum | PASS |
| Image validation hash | PASS |
| Application partition fit | PASS, 46 percent free |
| Physical flash write verification | PASS |
| Preserved runtime configuration | PASS |
The build excluded the optional WASM3 source because it was not present in the
firmware checkout. The boot log therefore reported WASM Tier 3 disabled. That
is not a regression introduced by this update and is outside this transport
qualification.
## Before and after comparison
The pre update baseline was a 20 second serial and WebSocket capture on firmware
0.8.4. The post update stability observation was 300 seconds on firmware 0.8.8.
| Observation | Before 0.8.4 | After 0.8.8 | Change |
|---|---:|---:|---:|
| Raw CSI yield mean | 27.80 pps | 28.03 pps | plus 0.83 percent |
| Server CSI FPS mean | 39.58 | 39.13 | minus 1.15 percent |
| Node frame coverage | 100 percent | 100 percent | unchanged |
| Maximum node staleness | 1,571 ms | 1,565 ms | minus 0.38 percent |
| Maximum WebSocket frame gap | 111 ms | 112 ms | plus 0.90 percent |
| Device or parser errors | 0 | 0 | unchanged |
These small movements are operationally neutral and within uncontrolled room
and WiFi variation. Firmware 0.8.8 did not regress the raw transport. Because
Tier 0 bypasses the DSP task, this run provides no evidence that temporal
features or inference accuracy improved.
## Five minute physical result
MEASURED on 2026 08 31 after flashing firmware 0.8.8:
| Device observation | Result |
|---|---:|
| Duration | 300 seconds |
| Controller yield samples | 300 |
| Raw CSI yield mean | 28.03 pps |
| Raw CSI yield range | 22 through 34 pps |
| ENOMEM or stack errors | 0 |
| UDP send failures | 0 |
| ESP NOW send failures | 0 |
| Unexpected resets | 0 |
| Watchdogs or panics | 0 |
| End to end WebSocket observation | Result |
|---|---:|
| Duration | 300.03 seconds |
| Sensing frames | 10,559 |
| Frames containing node 1 | 10,559 |
| Node 1 frame coverage | 100 percent |
| Source offline frames | 0 |
| JSON parse errors | 0 |
| WebSocket errors | 0 |
| Early closes | 0 |
| Maximum node staleness | 1,565 ms |
| Maximum WebSocket frame gap | 112 ms |
## Result and limitation
The ESP32 S3 raw transport acceptance passes. Firmware 0.8.8 booted from the
existing slot, retained the installation configuration, sustained the prior raw
CSI delivery rate, and completed the burn with zero transport or runtime
errors. The result extends ADR 347 physical coverage to the S3 transport path.
The largest remaining uncertainty is S3 Tier 2 behavior and inference accuracy.
The log line reporting the configured 20 Hz DSP cadence is not proof that DSP
ran because the preserved Tier 0 setting explicitly disables the DSP task. A
separate, rollback protected Tier 2 qualification with synchronized held out
labels is required before making heartbeat, respiration, motion, or accuracy
claims.
## Acceptance test
Repeat this five minute procedure after any S3 timing, WiFi, transport, or task
scheduling change. Pass only when raw callback yield remains at least 20 pps,
node frame coverage remains at least 99 percent, and the device and server have
zero send failures, offline frames, parser errors, WebSocket errors, watchdogs,
panics, and unexpected resets. Qualify Tier 2 separately and require its
measured DSP cadence to stay within one hertz of the configured target.

View File

@@ -0,0 +1,206 @@
# RuForecast requirement to evidence matrix
## Authority and current state
This matrix operationalizes ADR-348 and its ADR-349/350 children without
changing them. The ADRs own the requirements and gates. Rust tests, immutable
reports, signed receipts, and explicit human approvals supply evidence. A
checked box or green build is not permission to deploy, publish a checkpoint,
upload customer-derived data, or advance the rollout mode.
Current state: all release and operational gates are open. No benchmark result,
trained checkpoint, external training receipt, or production authority is
recorded by this document.
## Focused verification commands
The feature-off contract remains on the workspace Rust 1.89 line:
```bash
cd v2
cargo +1.89.0 test --locked -p ruview-forecast-core --no-default-features --lib --tests
cargo +1.89.0 test --locked -p ruview-forecast-model --no-default-features --lib --tests
cargo +1.89.0 check --locked -p ruview-forecast-model -p ruview-forecast-train --no-default-features --all-targets
cargo +1.89.0 test --locked -p ruview-forecast-model --no-default-features --features ruvector --lib --tests
cargo +1.89.0 clippy --locked -p ruview-forecast-core -p ruview-forecast-model -p ruview-forecast-train --no-default-features --all-targets -- -D warnings
cargo +1.89.0 clippy --locked -p ruview-forecast-model --no-default-features --features ruvector --all-targets -- -D warnings
```
Burn 0.21 CPU activation uses the explicitly separate Rust 1.92 line:
```bash
cd v2
cargo +1.92.0 test --locked -p ruview-forecast-model --no-default-features --features cpu --lib --tests
cargo +1.92.0 test --locked -p ruview-forecast-train --no-default-features --features cpu,cli --lib --bins
cargo +1.92.0 test --locked -p ruview-forecast-train --no-default-features --features cpu --test local_jsonl_smoke -- --exact local_hash_addressed_jsonl_executes_one_real_optimizer_step
cargo +1.92.0 test --locked -p ruview-forecast-train --no-default-features --features cpu,cli --test cli_smoke -- --exact cli_smoke_trains_and_writes_the_complete_candidate_set
cargo +1.92.0 test --locked -p ruview-forecast-train --no-default-features --features cpu,cli,server,fal-client --lib --bins
cargo +1.92.0 clippy --locked -p ruview-forecast-model --no-default-features --features cpu --all-targets -- -D warnings
cargo +1.92.0 clippy --locked -p ruview-forecast-train --no-default-features --features cpu,cli,server,fal-client --all-targets -- -D warnings
```
The CUDA line is compile-only. It proves that the explicitly gated types build
on Rust 1.92; it is not a GPU execution, training, latency, or compatibility
claim:
```bash
cd v2
cargo +1.92.0 check --locked -p ruview-forecast-model --no-default-features --features cuda --lib
cargo +1.92.0 check --locked -p ruview-forecast-train --no-default-features --features cuda,cli,server --lib --bins
```
The hosted boundary stays backend-free and is exercised on Rust 1.89 with no
provider credential. Tests must use local mocks; compiling these features does
not authorize network use or a hosted training run:
```bash
cd v2
cargo +1.89.0 tree --locked -e normal,build -p ruview-forecast-train --no-default-features --features cli,server,fal-client > forecast-hosted-feature-tree.txt
! grep -Eiq '(^|[[:space:]])(burn|cubecl)(-|[[:space:]])' forecast-hosted-feature-tree.txt
FAL_KEY='' cargo +1.89.0 test --locked -p ruview-forecast-train --no-default-features --features cli,server,fal-client --lib --bins --tests
FAL_KEY='' cargo +1.89.0 test --locked -p ruview-forecast-train --no-default-features --features cli,server,fal-client privacy_external_dataset_payload_is_denied
FAL_KEY='' cargo +1.89.0 clippy --locked -p ruview-forecast-train --no-default-features --features cli,server,fal-client --all-targets -- -D warnings
```
The broader repository gate remains:
```bash
cd v2
cargo +1.89.0 test --locked --workspace --no-default-features
cargo +1.89.0 bench --locked --workspace --no-default-features --no-run
```
No CUDA runtime result is implied by these commands. CUDA execution needs a
separately identified GPU, driver, toolkit, source commit, container digest,
and signed training or inference receipt.
The repository-wide security workflow separately hard-gates the checked-in
lockfile with `cargo audit --file v2/Cargo.lock --json`. The forecast workflow
also runs both modes of `scripts/csi-data-policy-check.sh`, rejects forbidden
clean-room source/import names and model blobs, checks the hosted DTO field
surface, and blocks common literal private-key, FAL-key, JWT, cloud-key and
presigned-URL patterns. These focused checks do not close dependency-license or
complete secret-scanning evidence: the repository has no committed
`v2/deny.toml`, inherited advisory/yanked-version debt needs an
owner/date/expiry baseline, and the existing general secret scanners are
non-blocking. Until dedicated retained reports exist, those parts of G0, G1,
and G5 remain open.
### Supply-chain and secret release prerequisites
| Check | Reproducer | Present authority |
|---|---|---|
| Advisory database | `cargo audit --file v2/Cargo.lock --json` | Existing blocking workflow; report retained |
| Advisory warnings | `cargo audit --file v2/Cargo.lock --deny warnings` | Not green by assertion; inherited warning debt needs an expiring reviewed baseline |
| Rust sources/licenses/bans | `cargo deny --manifest-path v2/Cargo.toml --config v2/deny.toml check advisories bans licenses sources` | Blocked until a reviewed `v2/deny.toml` is committed and CI pins `cargo-deny` |
| Forecast-path secrets | `gitleaks detect --no-banner --redact --source .` | Focused CI blocks common literal patterns; the broader GitLeaks job/report is still non-blocking |
| Tracked sensing data | `bash scripts/csi-data-policy-check.sh --self-test && bash scripts/csi-data-policy-check.sh --tracked` | Blocking in the focused hosted-boundary job |
`cargo vet check` becomes a release prerequisite only if the project commits a
vet policy and review process; listing it without that policy would be a false
supply-chain claim.
### Existing baseline debt and scope
- [`../benchmarks/physics-pose-refinement.md`](../benchmarks/physics-pose-refinement.md)
records unrelated workspace rustfmt/warning debt, an incomplete full-workspace
test run on that authoring host, existing RustSec debt, and yanked
`spin 0.9.8` in the optional Burn graph. Forecast CI therefore uses focused
warnings-denied gates and does not describe the whole workspace as green.
- [`.github/workflows/bench-regression.yml`](../../.github/workflows/bench-regression.yml)
records an upstream stable-Rust failure in optional `ruvector-crv`; the
focused forecast benchmarks neither enable nor inherit a CRV claim.
- The current ADR corpus contains pre-existing duplicate ADR-263 and ADR-264
numbers. The focused contract rejects a duplicate ADR-348, ADR-349 or ADR-350
without falsely asserting that the historic corpus already passes a global
uniqueness lint.
- Shared GitHub-hosted timing is noisy by repository policy. Only benchmark
compilation gates the PR; timing logs are informational until repeated on a
named, controlled host.
## Requirements
| Requirement | Machine evidence | Human or external evidence | Acceptance authority | Current state |
|---|---|---|---|---|
| RF-001 | Forecast-path source and artifact scan; forbidden model/blob fixture scan; clean-room manifest schema and tamper tests | Current contributor attestations and clean-room custodian adjudication | ADR-348 G0 | OPEN |
| RF-002 | Canonical receipt round trip; digest/signature tamper negatives; source, config, dataset and checkpoint identifiers required | Reviewer verifies every dependency, reference, job and checkpoint lineage | ADR-348 G0 and G1 | OPEN |
| RF-003 | Dataset manifest rejects missing license, incompatible use, unknown privacy class and unresolved bytes | Data steward and legal approval for every immutable dataset digest | ADR-348 G1 | OPEN |
| RF-004 | Feature-off dependency boundary excludes Burn/CubeCL; fixed artifact/input CPU replay; offline load tests; bounded property and fuzz corpus | Named platform-class review and 24-hour accelerated replay | ADR-348 G2 | OPEN |
| RF-005 | Shape/product overflow, finite-value, timestamp, mask, schema, horizon, quantile and resource-limit tests | Review of production input caps and abstention thresholds | ADR-348 G2 | OPEN |
| RF-006 | Forecast evidence label is immutable; observation hash round trips; confidence cannot increase; derived values cannot overwrite observations | Evidence-engine and downstream schema review | ADR-348 G2 and G4 | OPEN |
| RF-007 | Frozen split manifest; train-only normalization/calibration; quantile order; interval coverage and loss by horizon/domain | Independent evaluation report on untouched site/session/device holdouts | ADR-348 G3 | OPEN |
| RF-008 | Per-split RuVector index isolation; no overlapping horizon or holdout neighbour; paired retrieval-off/retrieval-on report | Reviewer verifies index manifest and ablation comparability | ADR-348 G3 | OPEN |
| RF-009 | Capability tests prove the forecast and RuVLLM explanation have no actuator, spending, access-control, emergency or model-promotion authority | Downstream policy owner approves any advisory consumer | ADR-348 G4 | OPEN |
| RF-010 | Local and hosted receipts compare source, lock, container, data, config and initial-weight digests; provider result is untrusted until verified | Provider retention, log, credential and data-processing review | ADR-348 G1 and G5 | OPEN |
| RF-011 | Benchmark report binds commit, lock, toolchain, host, backend, config, corpus, command and evidence label | Maintainer adjudicates claim label and model card language | ADR-348 G3 through G5 | OPEN |
| RF-012 | Mode transition and rollback state-machine tests; failed activation retains the prior artifact; raw sensing continues | Signed rollback drill and authorized mode-transition record | ADR-348 G5 | OPEN |
## Governed training requirements
These rows trace ADR-349. A mock-backed test can close a software subcondition,
but cannot close the hosted operational evidence named in the ADR.
| Requirement | Machine evidence | Human or external evidence | Acceptance authority | Current state |
|---|---|---|---|---|
| FT-001 | Synthetic hosted DTO and reconstructed local request bind the same generator, model, optimizer and build identities; external manifests are rejected | Reviewer compares immutable local and provider receipts | ADR-349 and G1 | OPEN |
| FT-002 | Unknown-field and arbitrary command/image/URL/environment/path negatives | Endpoint capability and worker-image review | ADR-349 and G2 | OPEN |
| FT-003 | Concurrent/retry/lost-response idempotency state-machine tests | Real provider ambiguous-retry drill and cost reconciliation | ADR-349 and G1/G5 | OPEN |
| FT-004 | Budget boundary and over-budget rejection tests | Provider price/bill fixture review and bounded real-run receipt | ADR-349 and G5 | OPEN |
| FT-005 | Authenticated cancellation, checkpoint and terminal-state property tests | Real hosted cancellation and orphan-job drill | ADR-349 and G2/G5 | OPEN |
| FT-006 | Missing/duplicate/truncated/tampered fixed-kind export matrix | Quarantine/export receipt review | ADR-349 and G1/G2 | OPEN |
| FT-007 | Hosted-signing denial, local verification and atomic promotion/rollback tests | Release-key isolation approval and rollback drill | ADR-349 and G1/G5 | OPEN |
| FT-008 | Captured egress and log-redaction tests for credentials/privacy/retention fields | Provider DPA, region, retention, reuse and deletion review | ADR-349 and G1/G5 | OPEN |
## Predictive-memory and explanation requirements
These rows trace ADR-350. This PR creates no sensing-server, RuVector or RuVLLM
runtime authority; the rows remain open until a separately reviewed bridge
provides the evidence.
| Requirement | Machine evidence | Human or external evidence | Acceptance authority | Current state |
|---|---|---|---|---|
| PM-001 | Cross-tenant/split/version/time-scope query negatives | Signed index-manifest and tenancy review | ADR-350 and G3/G5 | OPEN |
| PM-002 | Property tests reject holdout identities and overlapping contexts/horizons | Frozen leakage-report review | ADR-350 and G3 | OPEN |
| PM-003 | Bounded zero/error/success retrieval receipts and tamper tests | Retrieval receipt schema approval | ADR-350 and G2/G3 | OPEN |
| PM-004 | Same-example, same-artifact paired retrieval-off/on evaluator | Frozen paired ablation and overhead report | ADR-350 and G3 | OPEN |
| PM-005 | Envelope signature mutation, expiry, tenant, key and replay negatives | Local signing/key-rotation receipt | ADR-350 and G2/G5 | OPEN |
| PM-006 | Evidence-monotonicity property tests reject measured-observation promotion | Evidence-engine owner review | ADR-350 and G2/G4 | OPEN |
| PM-007 | Numeric/unit/provenance mutation corpus fails closed | RuVLLM adapter review | ADR-350 and G4 | OPEN |
| PM-008 | Default-deny capability and attempted-escalation tests | Downstream policy/capability review | ADR-350 and G4/G5 | OPEN |
| PM-009 | Tenant deletion, retention and access-audit tests | Privacy and membership/extraction-risk approval | ADR-350 and G5 | OPEN |
## Threat-model contract coverage
The IDs below are defined by
[`../security/ruview-forecast-threat-model.md`](../security/ruview-forecast-threat-model.md).
The feature job compiles and runs the current mock-backed suite, but an ID stays
open until the named negative test and its retained CI report exist.
| Contract IDs | Required machine evidence | Current state |
|---|---|---|
| PRIV-001 through PRIV-009 | Egress-denial, tenant-isolation, log-redaction, nonce-isolation and tracked-data-policy negatives | OPEN |
| AUTH-001 through AUTH-005; STATE-001 through STATE-004 | Fail-closed identity/scope/service-auth tests and property-tested idempotent transition machine | OPEN |
| BOUND-001 through BOUND-007 | Boundary/property cases, parser fuzzing, cumulative resource limits and bounded accelerated replay | OPEN |
| RVEC-001 through RVEC-006 | Scope-authority construction denial, identifier/privacy bounds, isolation, cancellation and non-persistence evidence | OPEN |
| FAL-001 through FAL-012; SSRF-001; PATH-001 through PATH-003 | Mock request capture, exact-body webhook/replay cases, app/build/expiry binding, URL/DNS/redirect denial and filesystem escape negatives | OPEN |
| ART-001 through ART-005; DE-001; EVID-001 through EVID-002 | Artifact tamper/rollback/crash matrix, trusted-type construction denial and evidence-authority invariants | OPEN |
## Gate evidence bundles
| Gate | Minimum bundle before review | Status |
|---|---|---|
| G0 | Clean-room manifest, contributor attestations, repository/artifact scan report, adjudication log | OPEN |
| G1 | Dataset rights manifests, byte-level lineage report, random-initialization receipt, local/hosted digest comparison | OPEN |
| G2 | Focused tests, property/fuzz reports, deterministic replay hash, dependency-boundary tree, 24-hour replay report | OPEN |
| G3 | Frozen split manifest, baseline/model/retrieval rows, weighted quantile loss, interval calibration, reproducer and report digests | OPEN |
| G4 | Fourteen-day shadow report, empty-room/occupied-room confusion matrices, drift/abstention slices, authority audit | OPEN |
| G5 | Dedicated-host latency and process-RSS report, signed model card, SBOM/provenance, rollback drill, security/privacy/legal approvals | OPEN |
## Evidence record template
Copy one row per immutable evidence artifact. Never replace a failed result.
| Evidence ID | Requirement/gate | Commit | Lock/config/data digest | Environment | Command | Result | Evidence label | Artifact digest | Reviewer/date |
|---|---|---|---|---|---|---|---|---|---|
No evidence artifacts have been accepted.

View File

@@ -7,40 +7,81 @@ This firmware captures WiFi Channel State Information (CSI) from an ESP32-S3 (pr
[![ESP-IDF v5.4](https://img.shields.io/badge/ESP--IDF-v5.4-blue.svg)](https://docs.espressif.com/projects/esp-idf/en/v5.4/)
[![Target: ESP32-S3 / ESP32-C6](https://img.shields.io/badge/target-ESP32--S3%20%7C%20ESP32--C6-purple.svg)](https://www.espressif.com/en/products/socs/esp32-s3)
[![License: MIT OR Apache-2.0](https://img.shields.io/badge/license-MIT%20OR%20Apache--2.0-green.svg)](../../LICENSE)
[![Binary: ~943 KB](https://img.shields.io/badge/binary-~943%20KB-orange.svg)](#memory-budget)
[![Binary: up to 1.1 MB](https://img.shields.io/badge/binary-up%20to%201.1%20MB-orange.svg)](#memory-budget)
[![CI: Docker Build](https://img.shields.io/badge/CI-Docker%20Build-brightgreen.svg)](../../.github/workflows/firmware-ci.yml)
> | Capability | Method | Performance |
> |------------|--------|-------------|
> | **CSI streaming** | Per-subcarrier I/Q capture over UDP | ~20 Hz, ADR-018 binary format |
> | **Breathing detection** | Bandpass 0.1-0.5 Hz, zero-crossing BPM | 6-30 BPM |
> | **Heart rate** | Bandpass 0.8-2.0 Hz, zero-crossing BPM | 40-120 BPM |
> | **Presence indicator** (heuristic) | Phase variance + adaptive threshold (60 s ambient learning) | < 1 ms latency, false-positives under strong RF interference — see [Tier 2 caveats](#what-this-firmware-does-not-do-tier-2-caveats) |
> | Capability | Method | Current contract |
> |------------|--------|------------------|
> | **CSI streaming** | Per-subcarrier I/Q capture over UDP | Radio-dependent cadence with a 20 packets-per-second hardware acceptance floor, ADR-018 binary format |
> | **Breathing estimate** | Bandpass 0.1-0.5 Hz, zero-crossing BPM | Experimental 6-30 BPM output; calibrate against a reference before use |
> | **Heart-rate estimate** | Bandpass 0.8-2.0 Hz, zero-crossing BPM | Experimental 40-120 BPM output; not a medical measurement |
> | **Presence indicator** (heuristic) | Phase variance + adaptive threshold (60 s ambient learning) | Fast local indicator; strong RF interference can cause false positives — see [Tier 2 caveats](#what-this-firmware-does-not-do-tier-2-caveats) |
> | **Fall detection** | Phase acceleration threshold | Configurable sensitivity |
> | **Programmable sensing** | WASM modules loaded over HTTP | Hot-swap, no reflash |
## Firmware 0.8.8 in plain language
Release 0.8.8 makes the sensing stream more internally consistent and easier
to diagnose:
1. An empty-room decision can no longer carry a nonzero person count. Older
firmware could expose those two contradictory values at the same time.
2. ESP32-C6 signal processing now uses a stable 8 Hz clock while raw CSI keeps
streaming at the faster radio-dependent rate. This prevents temporal
filters from silently using the wrong time scale.
3. The one-second diagnostic reports both raw callback yield and the DSP rate,
making slow or overloaded nodes visible.
4. OTA reports the application slot selected by the board instead of assuming
a fixed 900 KB limit.
Two ESP32-C6 boards and one ESP32-S3 completed five-minute physical transport
runs. The updated nodes had zero steady-state send failures, parser failures,
watchdogs, panics, or reboots. These results prove timing and transport
stability, not better heartbeat, pose, identity, or person-count accuracy.
See the [0.8.8 release notes](../../docs/releases/v0.8.8-esp32.md) and
[ADR 347](../../docs/adr/ADR-347-rate-aware-esp32-temporal-sensing.md) for the
measured evidence and limitations.
---
## Quick Start
For users who want to get running fast. Detailed explanations follow in later sections.
### 0. Pre-built binaries (v0.6.5 — skip the build step)
### 0. Download the 0.8.8 release
Pre-built binaries are in `firmware/esp32-csi-node/release_bins/` (version: see `release_bins/version.txt`).
Flash them directly:
Use the versioned source tag and binaries on the
[v0.8.8 ESP32 release page](https://github.com/ruvnet/RuView/releases/tag/v0.8.8-esp32).
Choose the package that names both your chip and flash size:
| Package | Use it for |
|---------|------------|
| `esp32-csi-node-v0.8.8-s3-8mb-flash-bundle.zip` | Fresh ESP32-S3 installation with 8 MB flash |
| `esp32-csi-node-v0.8.8-s3-4mb-flash-bundle.zip` | Fresh ESP32-S3 installation with 4 MB flash |
| `esp32-csi-node-v0.8.8-c6-4mb-flash-bundle.zip` | Fresh ESP32-C6 installation using the supported 4 MB layout |
Each bundle contains the matching bootloader, partition table, OTA metadata,
application, checksums, and a short flashing guide. Never flash an S3 bundle
onto a C6, or a C6 bundle onto an S3.
Example for an 8 MB ESP32-S3 after extracting its bundle:
```bash
python -m esptool --chip esp32s3 --port COM7 --baud 460800 \
write_flash --flash_mode dio --flash_size 8MB \
0x0 firmware/esp32-csi-node/release_bins/bootloader.bin \
0x8000 firmware/esp32-csi-node/release_bins/partition-table.bin \
0xf000 firmware/esp32-csi-node/release_bins/ota_data_initial.bin \
0x20000 firmware/esp32-csi-node/release_bins/esp32-csi-node.bin
0x0 bootloader.bin \
0x8000 partition-table.bin \
0xf000 ota_data_initial.bin \
0x20000 esp32-csi-node.bin
```
For 4 MB boards use `release_bins/esp32-csi-node-4mb.bin` and `release_bins/partition-table-4mb.bin`
with `--flash_size 4MB`.
For an existing provisioned node, back up its current application and inspect
`http://DEVICE_IP:8032/ota/status` before choosing an application-only update.
Writing only offset `0x20000` is safe only when the status endpoint reports
`running_partition` as `ota_0` and the downloaded image matches the board.
The full bundles do not include NVS, so the documented four-offset install
preserves WiFi and node configuration while replacing the boot and application
images.
### 1. Build (Docker -- the only reliable method)
@@ -111,7 +152,7 @@ curl http://<ESP32_IP>:8032/wasm/list
| **Recommended boards** | ESP32-S3-DevKitC-1, XIAO ESP32-S3 | Any ESP32-S3 with 8 MB flash works |
| **Deployment** | 3-6 nodes per room | Multistatic mesh for 360-degree coverage |
> **Tip:** A single node provides presence and vital signs along its line of sight. Multiple nodes (3-6) create a multistatic mesh that resolves 3D pose with <30 mm jitter and zero identity swaps.
> **Tip:** A single node is mainly useful for presence and motion along one RF link. Three or more spatially separated links improve geometry and track separation. Location, pose, and multi-person accuracy still require room-specific calibration and held-out ground-truth evaluation.
> **⚠️ Thermal warning — compact boards (ESP32-S3-Zero, SuperMini, other coin-sized clones):** This firmware runs the WiFi radio with modem sleep disabled (`WIFI_PS_NONE`, required for continuous CSI capture) plus a full edge-processing DSP pipeline on Core 1 (`edge_tier=2`) plus, on ADR-183 builds, a continuous 40 Hz onboard LED driver. That's sustained high current draw with no duty-cycling. Full-size dev boards (DevKitC-1, XIAO) have more copper pour and thermal mass around the regulator and tolerate this fine. Coin-sized clones with minimal PCB area and budget regulators may run hot to the touch during normal operation, and in at least one field report, boards that ran hot during a session failed to power on afterward (regulator damage suspected — see issue tracker). Give these boards airflow, don't stack or enclose them, and check them by touch during the first several minutes of a new deployment. If a board is uncomfortably hot (not just warm), power it down and let it cool before continuing.

View File

@@ -39,6 +39,17 @@ menu "CSI Node Configuration"
help
WiFi channel to listen on for CSI data.
config CSI_SELF_PING_HZ
int "Connected-STA CSI probe rate (Hz)"
default 50
range 10 50
help
Rate of the one-byte ICMP probes used to create a stable OFDM
CSI source on quiet networks. Fifty hertz is the measured safety
ceiling for the current ESP-IDF WiFi callback path. Higher rates
are intentionally rejected because sustained callback load above
50 Hz has caused WiFi ISR and packet-buffer failures on S3 and C6.
endmenu
menu "Edge Intelligence (ADR-039)"
@@ -66,6 +77,18 @@ menu "Edge Intelligence (ADR-039)"
help
Number of highest-variance subcarriers to use for DSP.
config EDGE_DSP_SAMPLE_HZ
int "On-device edge DSP sample rate (Hz)"
default 8 if IDF_TARGET_ESP32C6
default 20
range 8 50
help
Uniform rate at which CSI callbacks enter the Tier 1 and Tier 2
edge DSP. Raw CSI transmission keeps its independent full-rate
path. Eight hertz is the hardware-measured sustainable C6 Tier 2
setting and preserves a 4 Hz Nyquist limit for the 0.1-2.0 Hz
vital bands.
config EDGE_FALL_THRESH
int "Fall detection threshold (x1000)"
default 15000

View File

@@ -248,9 +248,10 @@ static void medium_loop_cb(TimerHandle_t t)
portEXIT_CRITICAL(&s_obs_lock);
if (s_obs_valid) {
ESP_LOGI(TAG, "medium tick: state=%u yield=%upps motion=%.2f presence=%.2f rssi=%d",
ESP_LOGI(TAG, "medium tick: state=%u yield=%upps dsp=%.1fHz motion=%.2f presence=%.2f rssi=%d",
(unsigned)s_state,
(unsigned)obs.pkt_yield_per_sec,
(double)edge_get_sample_rate_hz(),
(double)obs.motion_score,
(double)obs.presence_score,
(int)obs.rssi_median_dbm);

View File

@@ -63,6 +63,32 @@ static uint32_t s_send_ok = 0;
static uint32_t s_send_fail = 0;
static uint32_t s_rate_skip = 0;
#ifndef CONFIG_CSI_SELF_PING_HZ
#define CONFIG_CSI_SELF_PING_HZ 50
#endif
#if CONFIG_CSI_SELF_PING_HZ < 10 || CONFIG_CSI_SELF_PING_HZ > 50
#error "CONFIG_CSI_SELF_PING_HZ must stay within the hardware-qualified 10-50 Hz range"
#endif
#define CSI_SELF_PING_INTERVAL_MS (1000U / CONFIG_CSI_SELF_PING_HZ)
#ifndef CONFIG_EDGE_DSP_SAMPLE_HZ
#if CONFIG_IDF_TARGET_ESP32C6
#define CONFIG_EDGE_DSP_SAMPLE_HZ 8
#else
#define CONFIG_EDGE_DSP_SAMPLE_HZ 20
#endif
#endif
#if CONFIG_EDGE_DSP_SAMPLE_HZ < 8 || CONFIG_EDGE_DSP_SAMPLE_HZ > 50
#error "CONFIG_EDGE_DSP_SAMPLE_HZ must stay within the supported 8-50 Hz range"
#endif
#define EDGE_DSP_MIN_INTERVAL_US (1000000U / CONFIG_EDGE_DSP_SAMPLE_HZ)
static int64_t s_next_edge_enqueue_us = 0;
static uint32_t s_edge_rate_skip = 0;
/**
* Minimum interval between UDP sends in microseconds.
* CSI callbacks can fire hundreds of times per second in promiscuous mode.
@@ -300,10 +326,31 @@ static void wifi_csi_callback(void *ctx, wifi_csi_info_t *info)
}
}
/* ADR-039: Enqueue raw I/Q into edge processing ring buffer. */
/* ADR-039 / ADR-347: Raw CSI stays at the independent network cadence,
* while the on-device Tier 1/2 pipeline receives a uniform, sustainable
* stream. Enqueuing every burst frame overloaded the unicore C6 DSP and
* turned 30-40 callback pps into an irregular approximately 8 Hz subset. */
if (info->buf && info->len > 0) {
edge_enqueue_csi((const uint8_t *)info->buf, (uint16_t)info->len,
(int8_t)info->rx_ctrl.rssi, info->rx_ctrl.channel);
if (s_next_edge_enqueue_us == 0) {
s_next_edge_enqueue_us = now_us;
}
if (now_us >= s_next_edge_enqueue_us) {
(void)edge_enqueue_csi((const uint8_t *)info->buf, (uint16_t)info->len,
(int8_t)info->rx_ctrl.rssi, info->rx_ctrl.channel);
/* Preserve the configured sample clock instead of resetting it to
* each irregular callback. With roughly 35 raw callbacks per
* second, a last-seen 100 ms gate selected every fourth callback
* and drifted to roughly 8 Hz. Advancing the deadline by complete
* periods alternates the available callbacks around the configured
* phase and prevents both drift and catch-up bursts. */
int64_t periods = ((now_us - s_next_edge_enqueue_us) /
EDGE_DSP_MIN_INTERVAL_US) + 1;
s_next_edge_enqueue_us += periods * EDGE_DSP_MIN_INTERVAL_US;
} else {
s_edge_rate_skip++;
}
}
/* ADR-110 §A0.11/§A0.12 — Emit a sync-packet every N CSI frames so the
@@ -411,7 +458,7 @@ static void csi_start_self_ping(void)
esp_ping_config_t cfg = ESP_PING_DEFAULT_CONFIG();
cfg.target_addr = target;
cfg.count = ESP_PING_COUNT_INFINITE;
cfg.interval_ms = 20; /* 50 Hz -> ~50 received OFDM replies/sec */
cfg.interval_ms = CSI_SELF_PING_INTERVAL_MS;
cfg.data_size = 1;
cfg.task_stack_size = 4096;
@@ -424,7 +471,8 @@ static void csi_start_self_ping(void)
if (esp_ping_new_session(&cfg, &cbs, &s_self_ping) == ESP_OK && s_self_ping != NULL) {
esp_ping_start(s_self_ping);
ESP_LOGI(TAG, "self-ping started -> %s @50Hz (CSI OFDM source, fix #521/#954)", gw_str);
ESP_LOGI(TAG, "self-ping started -> %s @%dHz (CSI OFDM source, fix #521/#954)",
gw_str, CONFIG_CSI_SELF_PING_HZ);
} else {
ESP_LOGW(TAG, "self-ping: esp_ping_new_session failed");
s_self_ping = NULL;
@@ -592,6 +640,8 @@ void csi_collector_init(void)
ESP_LOGI(TAG, "CSI collection initialized (node_id=%u, channel=%u)",
(unsigned)s_node_id, (unsigned)csi_channel);
ESP_LOGI(TAG, "edge DSP cadence=%dHz; raw CSI network cadence remains independent",
CONFIG_EDGE_DSP_SAMPLE_HZ);
/* RuView#521/#954: start the connected-STA traffic source so the CSI engine
* receives a guaranteed OFDM unicast floor even when promiscuous capture is

View File

@@ -38,6 +38,16 @@ extern nvs_config_t g_nvs_config;
static const char *TAG = "edge_proc";
#ifndef CONFIG_EDGE_DSP_SAMPLE_HZ
#if CONFIG_IDF_TARGET_ESP32C6
#define CONFIG_EDGE_DSP_SAMPLE_HZ 8
#else
#define CONFIG_EDGE_DSP_SAMPLE_HZ 20
#endif
#endif
#define EDGE_CONFIGURED_SAMPLE_RATE_HZ ((float)CONFIG_EDGE_DSP_SAMPLE_HZ)
/* ======================================================================
* SPSC Ring Buffer (lock-free, single-producer single-consumer)
* ====================================================================== */
@@ -355,11 +365,12 @@ static float s_heartrate_filtered[EDGE_PHASE_HISTORY_LEN];
/** Measured CSI sample rate (Hz), smoothed from frame timestamps.
* #985's self-ping raised the callback rate above the old ~10 Hz beacon
* assumption and made it variable (~13-19 Hz); a fixed rate scaled BPM wrong
* and made HR swing with CSI yield. See update in process_csi_frame(). */
static float s_sample_rate_hz = 15.0f;
static float s_filter_design_fs = 20.0f; /* fs the biquads were last designed at */
static uint32_t s_last_frame_ts_us = 0;
* assumption and made it variable. A fixed rate scales BPM and Doppler bins
* incorrectly. Start from the filter design rate, then follow measured time. */
static float s_sample_rate_hz = EDGE_CONFIGURED_SAMPLE_RATE_HZ;
static float s_filter_design_fs = EDGE_CONFIGURED_SAMPLE_RATE_HZ; /* fs the biquads were last designed at */
static uint32_t s_rate_window_start_us = 0;
static uint32_t s_rate_window_intervals = 0;
/** Latest vitals state. */
static float s_breathing_bpm;
@@ -409,6 +420,21 @@ static edge_biquad_t s_person_bq_hr[EDGE_MAX_PERSONS];
static float s_person_br_filt[EDGE_MAX_PERSONS][EDGE_PHASE_HISTORY_LEN];
static float s_person_hr_filt[EDGE_MAX_PERSONS][EDGE_PHASE_HISTORY_LEN];
/** Clear person slots whenever the room-level presence gate is closed. */
static void reset_person_count_state(void)
{
s_person_count_candidate = 0;
s_person_count_streak = 0;
s_person_count_stable = 0;
for (uint8_t p = 0; p < EDGE_MAX_PERSONS; p++) {
s_persons[p].active = false;
s_persons[p].history_len = 0;
s_persons[p].history_idx = 0;
s_persons[p].breathing_bpm = 0.0f;
s_persons[p].heartrate_bpm = 0.0f;
}
}
/** Latest vitals packet (thread-safe via volatile copy). */
static volatile edge_vitals_pkt_t s_latest_pkt;
static volatile bool s_pkt_valid;
@@ -898,7 +924,10 @@ static void send_vitals_packet(void)
for (uint8_t p = 0; p < EDGE_MAX_PERSONS; p++) {
if (s_persons[p].active) n_active++;
}
pkt.n_persons = n_active;
/* Fail closed: the slot heuristic cannot assert occupants while the
* debounced presence gate is false. The host repeats this invariant for
* backward compatibility with older firmware. */
pkt.n_persons = edge_evidence_person_count(s_presence_detected, n_active);
pkt.motion_energy = s_motion_energy;
pkt.presence_score = s_presence_score;
@@ -1038,20 +1067,27 @@ static void process_frame(const edge_ring_slot_t *slot)
s_frame_count++;
s_latest_rssi = slot->rssi;
/* Measure the REAL CSI sample rate from inter-frame timestamps. #985's
* self-ping made the callback rate variable (~13-19 Hz); the old fixed
* 10 Hz both scaled BPM wrong (true ~87 BPM read as ~45) and made HR swing
* as CSI yield fluctuated. EMA-smooth and clamp to a plausible band. */
if (s_last_frame_ts_us != 0 && slot->timestamp_us > s_last_frame_ts_us) {
float dt = (float)(slot->timestamp_us - s_last_frame_ts_us) * 1e-6f;
if (dt > 0.02f && dt < 0.5f) { /* 2-50 Hz plausible; reject gaps/hops */
float inst = 1.0f / dt;
s_sample_rate_hz += 0.05f * (inst - s_sample_rate_hz);
if (s_sample_rate_hz < 8.0f) s_sample_rate_hz = 8.0f;
if (s_sample_rate_hz > 30.0f) s_sample_rate_hz = 30.0f;
/* Measure the real CSI sample rate over one-second timestamp windows. WiFi
* replies arrive in bursts, so filtering individual short intervals made
* a 35 pps stream look like 12-16 Hz. Counting all processed intervals in
* the window preserves the clock actually seen by the temporal filters. */
if (s_rate_window_start_us == 0) {
s_rate_window_start_us = slot->timestamp_us;
s_rate_window_intervals = 0;
} else if (slot->timestamp_us > s_rate_window_start_us) {
s_rate_window_intervals++;
uint32_t elapsed_us = slot->timestamp_us - s_rate_window_start_us;
if (elapsed_us >= EDGE_SAMPLE_RATE_WINDOW_MIN_US) {
s_sample_rate_hz = edge_sample_rate_window_update(
s_sample_rate_hz, s_rate_window_intervals, elapsed_us);
s_rate_window_start_us = slot->timestamp_us;
s_rate_window_intervals = 0;
}
} else {
/* Timer wrap or reset. Start a fresh evidence window. */
s_rate_window_start_us = slot->timestamp_us;
s_rate_window_intervals = 0;
}
s_last_frame_ts_us = slot->timestamp_us;
/* Re-tune the biquads if the measured rate has drifted from their design fs,
* so the breathing (0.1-0.5 Hz) and HR (0.8-2.0 Hz) passbands stay in real
@@ -1202,8 +1238,15 @@ static void process_frame(const edge_ring_slot_t *slot)
}
}
/* --- Step 11: Multi-person vitals --- */
update_multi_person_vitals(slot->iq_data, n_subcarriers, sample_rate);
/* --- Step 11: Multi-person vitals ---
* Person slots are subordinate to the room presence gate. Processing or
* retaining slots while absent produced contradictory packets such as
* presence=false with n_persons=4. */
if (s_presence_detected) {
update_multi_person_vitals(slot->iq_data, n_subcarriers, sample_rate);
} else {
reset_person_count_state();
}
/* Yield after multi-person DSP so IDLE1 can feed Core 1 watchdog (#683). */
if (s_cfg.tier >= 2) vTaskDelay(1);
@@ -1314,6 +1357,11 @@ bool edge_get_vitals(edge_vitals_pkt_t *pkt)
return true;
}
float edge_get_sample_rate_hz(void)
{
return s_sample_rate_hz;
}
void edge_get_multi_person(edge_person_vitals_t *persons, uint8_t *n_active)
{
uint8_t active = 0;
@@ -1373,6 +1421,10 @@ esp_err_t edge_processing_init(const edge_config_t *cfg)
s_fall_detected = false;
s_latest_rssi = 0;
s_frame_count = 0;
s_sample_rate_hz = EDGE_CONFIGURED_SAMPLE_RATE_HZ;
s_filter_design_fs = EDGE_CONFIGURED_SAMPLE_RATE_HZ;
s_rate_window_start_us = 0;
s_rate_window_intervals = 0;
s_prev_phase_velocity = 0.0f;
s_fall_consec_count = 0;
s_fall_last_alert_us = 0;
@@ -1397,9 +1449,9 @@ esp_err_t edge_processing_init(const edge_config_t *cfg)
s_person_count_streak = 0;
s_person_count_stable = 0;
/* Design biquad bandpass filters.
* Sampling rate ~20 Hz (typical ESP32 CSI callback rate). */
const float fs = 20.0f;
/* Design biquad bandpass filters against the configured DSP clock. The
* measured timestamp estimator then follows sustained hardware drift. */
const float fs = EDGE_CONFIGURED_SAMPLE_RATE_HZ;
biquad_bandpass_design(&s_bq_breathing, fs, 0.1f, 0.5f);
biquad_bandpass_design(&s_bq_heartrate, fs, 0.8f, 2.0f);

View File

@@ -35,9 +35,56 @@
#define EDGE_TOP_K 8 /**< Top-K subcarriers to track. */
#define EDGE_MAX_SUBCARRIERS 128 /**< Max subcarriers per frame. */
/* ---- Measured sample-rate tracking ----
*
* The connected-STA probe produces up to 50 CSI opportunities per second,
* while contention and callback gating make the delivered cadence variable.
* Temporal filters must follow measured time rather than a fixed frame-rate
* assumption. The 60 Hz estimator ceiling leaves jitter headroom above the
* qualified 50 Hz callback limit. A one-second frame-count window represents
* bursty but valid WiFi arrivals more accurately than averaging only selected
* inter-frame intervals. */
#define EDGE_SAMPLE_RATE_MIN_HZ 8.0f
#define EDGE_SAMPLE_RATE_MAX_HZ 60.0f
#define EDGE_SAMPLE_RATE_EMA_ALPHA 0.25f
#define EDGE_SAMPLE_RATE_WINDOW_MIN_US 1000000U
#define EDGE_SAMPLE_RATE_WINDOW_MAX_US 3000000U
static inline float edge_sample_rate_window_update(float current_hz,
uint32_t frame_intervals,
uint32_t elapsed_us)
{
if (frame_intervals == 0 || elapsed_us < EDGE_SAMPLE_RATE_WINDOW_MIN_US ||
elapsed_us > EDGE_SAMPLE_RATE_WINDOW_MAX_US) {
return current_hz;
}
float instant_hz = (float)frame_intervals * 1000000.0f / (float)elapsed_us;
if (instant_hz < EDGE_SAMPLE_RATE_MIN_HZ) instant_hz = EDGE_SAMPLE_RATE_MIN_HZ;
if (instant_hz > EDGE_SAMPLE_RATE_MAX_HZ) instant_hz = EDGE_SAMPLE_RATE_MAX_HZ;
float next_hz = current_hz + EDGE_SAMPLE_RATE_EMA_ALPHA * (instant_hz - current_hz);
if (next_hz < EDGE_SAMPLE_RATE_MIN_HZ) return EDGE_SAMPLE_RATE_MIN_HZ;
if (next_hz > EDGE_SAMPLE_RATE_MAX_HZ) return EDGE_SAMPLE_RATE_MAX_HZ;
return next_hz;
}
/* ---- Multi-person ---- */
#define EDGE_MAX_PERSONS 4 /**< Max simultaneous persons. */
/**
* Enforce the wire-level occupancy invariant.
*
* A subcarrier slot estimate is supporting evidence only. It cannot assert an
* occupant when the independently debounced presence gate is false. Keeping
* this helper in the public firmware header lets host tests exercise the exact
* function used by the device build.
*/
static inline uint8_t edge_evidence_person_count(bool presence, uint8_t active_count)
{
if (!presence) return 0;
return active_count > EDGE_MAX_PERSONS ? EDGE_MAX_PERSONS : active_count;
}
/* ---- Multi-person counting gates (issue #998) ----
*
* Over-counting root cause: the multi-person path used to split the top-K
@@ -238,6 +285,12 @@ bool edge_enqueue_csi(const uint8_t *iq_data, uint16_t iq_len,
*/
bool edge_get_vitals(edge_vitals_pkt_t *pkt);
/**
* Return the timestamp-derived CSI cadence used to design temporal filters.
* This is diagnostic evidence, not the raw callback or network delivery rate.
*/
float edge_get_sample_rate_hz(void);
/**
* Get multi-person vitals array.
*

View File

@@ -23,9 +23,6 @@ static const char *TAG = "ota_update";
/** OTA HTTP server port. */
#define OTA_PORT 8032
/** Maximum firmware size (900 KB — matches CI binary size gate). */
#define OTA_MAX_SIZE (900 * 1024)
/** NVS namespace and key for the OTA pre-shared key. */
#define OTA_NVS_NAMESPACE "security"
#define OTA_NVS_KEY "ota_psk"
@@ -95,11 +92,11 @@ static esp_err_t ota_status_handler(httpd_req_t *req)
int len = snprintf(response, sizeof(response),
"{\"version\":\"%s\",\"date\":\"%s\",\"time\":\"%s\","
"\"running_partition\":\"%s\",\"next_partition\":\"%s\","
"\"max_size\":%d}",
"\"max_size\":%lu}",
app->version, app->date, app->time,
running ? running->label : "unknown",
update ? update->label : "none",
OTA_MAX_SIZE);
(unsigned long)(update ? update->size : 0));
httpd_resp_set_type(req, "application/json");
httpd_resp_send(req, response, len);
@@ -121,12 +118,6 @@ static esp_err_t ota_upload_handler(httpd_req_t *req)
ESP_LOGI(TAG, "OTA update started, content_length=%d", req->content_len);
if (req->content_len <= 0 || req->content_len > OTA_MAX_SIZE) {
httpd_resp_send_err(req, HTTPD_400_BAD_REQUEST,
"Invalid firmware size (must be 1B - 900KB)");
return ESP_FAIL;
}
const esp_partition_t *update_partition = esp_ota_get_next_update_partition(NULL);
if (update_partition == NULL) {
httpd_resp_send_err(req, HTTPD_500_INTERNAL_SERVER_ERROR,
@@ -134,6 +125,15 @@ static esp_err_t ota_upload_handler(httpd_req_t *req)
return ESP_FAIL;
}
if (req->content_len <= 0 || (size_t)req->content_len > update_partition->size) {
ESP_LOGW(TAG, "OTA rejected: content_length=%d exceeds partition '%s' size=%lu",
req->content_len, update_partition->label,
(unsigned long)update_partition->size);
httpd_resp_send_err(req, HTTPD_400_BAD_REQUEST,
"Invalid firmware size for OTA partition");
return ESP_FAIL;
}
esp_ota_handle_t ota_handle;
esp_err_t err = esp_ota_begin(update_partition, OTA_WITH_SEQUENTIAL_WRITES, &ota_handle);
if (err != ESP_OK) {

View File

@@ -58,6 +58,10 @@ CONFIG_ULP_COPROC_RESERVE_MEM=8192
# CONFIG_DISPLAY_ENABLE is not set
# CONFIG_WASM_ENABLE is not set
# Physical Tier 2 qualification on ESP32-C6 rev 0.2 converges at 8 Hz while
# leaving the raw network CSI stream independent at roughly 30-40 pps.
CONFIG_EDGE_DSP_SAMPLE_HZ=8
# ── Compiler ──
CONFIG_COMPILER_OPTIMIZATION_SIZE=y

View File

@@ -266,6 +266,19 @@ static void test_debounce_flapping_stays_stable(void)
CHECK_EQ_U8("flapping count stays at 1", out, 1);
}
/* The packet count is evidence subordinated to presence, never an independent
* occupancy assertion. This guards the field failure where a node emitted
* presence=false with n_persons=3 or 4. */
static void test_person_count_fails_closed_without_presence(void)
{
CHECK_EQ_U8("absent with four active slots -> zero",
edge_evidence_person_count(false, 4), 0);
CHECK_EQ_U8("present preserves a bounded count",
edge_evidence_person_count(true, 3), 3);
CHECK_EQ_U8("present count clamps to protocol maximum",
edge_evidence_person_count(true, 255), EDGE_MAX_PERSONS);
}
/* ──────────────────────────────────────────────────────────────────────
* #996 — presence_flag_update: dithering score must NOT flicker the flag
* ────────────────────────────────────────────────────────────────────── */
@@ -357,6 +370,36 @@ static void test_presence_dead_band_holds_state(void)
CHECK_TRUE("dead band does not clear from true", flag);
}
/* The physical C6 delivered 28-37 CSI frames/s while the former estimator was
* capped at 30 Hz. A 34 Hz stream must converge above that old ceiling. */
static void test_sample_rate_tracks_above_thirty_hz(void)
{
float rate = 20.0f;
for (int i = 0; i < 12; i++) {
rate = edge_sample_rate_window_update(rate, 34U, 1000000U);
}
CHECK_TRUE("sample rate follows measured 34 Hz cadence", rate > 33.0f && rate < 35.0f);
}
static void test_sample_rate_requires_complete_window(void)
{
float rate = 34.0f;
CHECK_TRUE("short window rejected",
edge_sample_rate_window_update(rate, 10U, 200000U) == rate);
CHECK_TRUE("stalled window rejected",
edge_sample_rate_window_update(rate, 10U, 4000000U) == rate);
}
static void test_sample_rate_is_bounded(void)
{
float rate = EDGE_SAMPLE_RATE_MAX_HZ;
CHECK_TRUE("sample rate upper bound holds",
edge_sample_rate_window_update(rate, 1000U, 1000000U) <= EDGE_SAMPLE_RATE_MAX_HZ);
rate = EDGE_SAMPLE_RATE_MIN_HZ;
CHECK_TRUE("sample rate lower bound holds",
edge_sample_rate_window_update(rate, 1U, 1000000U) >= EDGE_SAMPLE_RATE_MIN_HZ);
}
/* ──────────────────────────────────────────────────────────────────────
* main
* ────────────────────────────────────────────────────────────────────── */
@@ -375,6 +418,7 @@ int main(void)
test_debounce_rejects_transient_spike();
test_debounce_accepts_sustained_change();
test_debounce_flapping_stays_stable();
test_person_count_fails_closed_without_presence();
/* #996 presence hysteresis */
test_presence_no_flicker_on_dither();
@@ -382,6 +426,11 @@ int main(void)
test_presence_genuine_departure_clears();
test_presence_dead_band_holds_state();
/* Timestamp-derived temporal calibration */
test_sample_rate_tracks_above_thirty_hz();
test_sample_rate_requires_complete_window();
test_sample_rate_is_bounded();
printf("\n%d passed, %d failed\n", g_passed, g_failed);
return g_failed == 0 ? 0 : 1;
}

View File

@@ -1 +1 @@
0.8.4
0.8.8

View File

@@ -0,0 +1,78 @@
# RuView iPhone LiDAR
This experimental integration provides the native and browser components needed to use a LiDAR-capable iPhone as a RuView geometry sensor. The native source is type-checked against the iOS SDK in CI; physical-device validation is tracked separately below.
## Architecture
```text
iPhone LiDAR
-> ARKit sceneDepth
-> depth + confidence + camera intrinsics + device pose
-> compact u16 millimeter wire frame
-> WebSocket relay
-> browser point cloud
-> future RuView HAL / fusion ingest
```
The native path is the sensor. The web path is a receiver and visualization surface. Mobile Safari does not expose ARKit scene depth directly to ordinary web pages, so the browser cannot replace the native capture layer on iPhone today.
## Native iPhone path
Create an iOS SwiftUI app target in Xcode, deployment target iOS 17 or newer, then add the files under `native/RuViewLiDAR/` to the target.
Add this Info.plist value:
```xml
<key>NSCameraUsageDescription</key>
<string>RuView uses the camera and LiDAR scanner to capture local depth geometry.</string>
```
Run on a physical LiDAR capable iPhone or iPad. The simulator does not provide LiDAR scene depth.
The app requests `ARWorldTrackingConfiguration` with `.sceneDepth`, checks `supportsFrameSemantics`, extracts `ARDepthData.depthMap` and `confidenceMap`, and never transmits RGB camera frames.
## Browser path
```bash
cd integrations/iphone-lidar/web
npm ci
npm test
npm start
```
The relay prints a random per-run access token. Open the printed browser URL and set the iPhone endpoint to the printed native URL. They have this form:
```text
http://HOST:8787/?token=TOKEN
ws://HOST:8787/ws/lidar?token=TOKEN
```
Set `RUVIEW_LIDAR_TOKEN` to supply the token explicitly. The token only prevents unauthenticated peers from joining the development relay; because `ws://` does not encrypt it, production use requires TLS and `wss://`.
## Wire format
Schema: `ruview.lidar.depth.v1`
Depth is downsampled by 2 in each dimension by default and streamed at a maximum of 15 FPS. Each depth sample is encoded as little endian UInt16 millimeters plus one UInt8 confidence value. `[SYNTHETIC]` Arithmetic sizing reduces the depth payload from roughly 196 KB per 256 x 192 Float32 frame to roughly 37 KB per 128 x 96 frame before base64 and JSON overhead.
`[SYNTHETIC]` At 15 FPS that is approximately 0.75 MB/s after base64 overhead, versus roughly 8 MB/s for uncompressed Float32 JSON at full resolution. These are sizing estimates, not device or network measurements.
## Privacy and governance
The initial implementation labels provenance as `source=live` and `privacyClass=geometry-only`. It sends depth geometry, confidence, camera intrinsics, pose, sequence, and wall clock timestamp. It does not send RGB imagery.
The development relay requires an ephemeral token and bounds each WebSocket message, but it is not a production trust boundary. Production integration should terminate the WebSocket inside RuView, authenticate the device using the existing sensor identity path, convert each frame into `ruview-hal::Observation`, and attach witness receipts before fusion or persistence.
## Validation status
- `[MEASURED]` The committed Node tests cover wire decoding, malformed inputs, relay authentication, static-file restrictions, and live WebSocket forwarding.
- `[MEASURED]` GitHub Actions type-checks the native sources with strict concurrency against the iOS 17 SDK.
- Physical iPhone capture, end-to-end rendering, confidence-map behavior, and the latency target are not yet measured. A simulator or CI compile does not satisfy the hardware acceptance test.
## Acceptance test
1. Run the relay and browser viewer.
2. Run the native app on a LiDAR capable iPhone.
3. Start LiDAR capture and enable streaming.
4. Move the phone through a room.
5. Verify the browser shows a changing point cloud, sequence increases monotonically, latency stays below the `[CLAIMED target]` of 150 ms p95 on a local WiFi network, and no RGB payload is present in captured WebSocket frames.

View File

@@ -0,0 +1,121 @@
import SwiftUI
struct ContentView: View {
@StateObject private var capture = LiDARCaptureManager()
@State private var endpoint = "ws://HOST:8787/ws/lidar?token=TOKEN"
@State private var streaming = false
@State private var status = "Idle"
private let streamer = WebSocketStreamer()
var body: some View {
NavigationStack {
Form {
Section("Sensor") {
HStack {
Text("State")
Spacer()
Text(stateText)
.foregroundStyle(stateColor)
}
HStack {
Text("Capture FPS")
Spacer()
Text(capture.framesPerSecond.formatted(.number.precision(.fractionLength(1))))
}
if let frame = capture.lastFrame {
HStack {
Text("Depth")
Spacer()
Text("\(frame.depth.width) x \(frame.depth.height)")
}
HStack {
Text("Sequence")
Spacer()
Text("\(frame.provenance.sequence)")
}
}
Button("Start LiDAR") {
capture.start(smoothed: false)
}
.disabled(capture.state == .running)
Button("Stop") {
capture.stop()
}
.disabled(capture.state != .running)
}
Section("RuView Stream") {
TextField("ws://host:port/ws/lidar", text: $endpoint)
.textInputAutocapitalization(.never)
.autocorrectionDisabled()
Toggle("Stream geometry", isOn: $streaming)
.onChange(of: streaming) { _, enabled in
Task {
if enabled {
do {
try await streamer.connect(to: endpoint)
status = "Connected"
} catch {
streaming = false
status = error.localizedDescription
}
} else {
await streamer.disconnect()
status = "Disconnected"
}
}
}
Text(status)
.font(.caption)
.foregroundStyle(.secondary)
}
Section("Privacy") {
Text("This implementation transmits depth geometry, confidence, camera intrinsics, and device pose. RGB camera frames are not transmitted.")
.font(.footnote)
}
}
.navigationTitle("RuView LiDAR")
.onAppear {
capture.onFrame = { frame in
guard streaming else { return }
Task {
do {
try await streamer.send(frame, maxFPS: 15, sampleStep: 2)
} catch {
await MainActor.run {
status = error.localizedDescription
}
}
}
}
}
.onDisappear {
capture.stop()
Task { await streamer.disconnect() }
}
}
}
private var stateText: String {
switch capture.state {
case .idle: return "Idle"
case .unsupported: return "No LiDAR"
case .running: return "Live"
case .failed(let message): return "Error: \(message)"
}
}
private var stateColor: Color {
switch capture.state {
case .running: return .green
case .failed, .unsupported: return .red
case .idle: return .secondary
}
}
}

View File

@@ -0,0 +1,138 @@
import ARKit
import CoreVideo
import Foundation
@MainActor
final class LiDARCaptureManager: NSObject, ObservableObject {
enum State: Equatable {
case idle
case unsupported
case running
case failed(String)
}
@Published private(set) var state: State = .idle
@Published private(set) var lastFrame: RuViewLiDARFrame?
@Published private(set) var framesPerSecond: Double = 0
let session = ARSession()
var onFrame: (@MainActor @Sendable (RuViewLiDARFrame) -> Void)?
private var sequence: UInt64 = 0
private var lastTimestamp: TimeInterval?
private let processingQueue = DispatchQueue(label: "one.ruv.lidar.capture", qos: .userInitiated)
override init() {
super.init()
session.delegate = self
session.delegateQueue = processingQueue
}
func start(smoothed: Bool = false) {
let configuration = ARWorldTrackingConfiguration()
let semantic: ARConfiguration.FrameSemantics = smoothed ? .smoothedSceneDepth : .sceneDepth
guard ARWorldTrackingConfiguration.supportsFrameSemantics(semantic) else {
state = .unsupported
return
}
configuration.frameSemantics.insert(semantic)
configuration.worldAlignment = .gravity
session.run(configuration, options: [.resetTracking, .removeExistingAnchors])
state = .running
}
func stop() {
session.pause()
state = .idle
}
nonisolated private func makeFrame(from frame: ARFrame) -> RuViewLiDARFrame? {
guard let sceneDepth = frame.sceneDepth ?? frame.smoothedSceneDepth else { return nil }
let depthMap = sceneDepth.depthMap
let confidenceMap = sceneDepth.confidenceMap
guard CVPixelBufferLockBaseAddress(depthMap, .readOnly) == kCVReturnSuccess else {
return nil
}
defer { CVPixelBufferUnlockBaseAddress(depthMap, .readOnly) }
guard CVPixelBufferGetPixelFormatType(depthMap) == kCVPixelFormatType_DepthFloat32,
let depthBase = CVPixelBufferGetBaseAddress(depthMap) else {
return nil
}
let width = CVPixelBufferGetWidth(depthMap)
let height = CVPixelBufferGetHeight(depthMap)
let stride = CVPixelBufferGetBytesPerRow(depthMap) / MemoryLayout<Float>.size
let pointer = depthBase.assumingMemoryBound(to: Float.self)
var meters = [Float]()
meters.reserveCapacity(width * height)
for y in 0..<height {
let row = pointer.advanced(by: y * stride)
for x in 0..<width {
let value = row[x]
meters.append(value.isFinite && value > 0 ? value : 0)
}
}
var confidence = [UInt8](repeating: 0, count: width * height)
if let confidenceMap,
CVPixelBufferGetPixelFormatType(confidenceMap) == kCVPixelFormatType_OneComponent8,
CVPixelBufferGetWidth(confidenceMap) == width,
CVPixelBufferGetHeight(confidenceMap) == height,
CVPixelBufferLockBaseAddress(confidenceMap, .readOnly) == kCVReturnSuccess {
defer { CVPixelBufferUnlockBaseAddress(confidenceMap, .readOnly) }
if let confidenceBase = CVPixelBufferGetBaseAddress(confidenceMap) {
let confidenceStride = CVPixelBufferGetBytesPerRow(confidenceMap)
let confidencePointer = confidenceBase.assumingMemoryBound(to: UInt8.self)
for y in 0..<height {
let row = confidencePointer.advanced(by: y * confidenceStride)
for x in 0..<width {
confidence[y * width + x] = row[x]
}
}
}
}
return RuViewLiDARFrame(
intrinsics: frame.camera.intrinsics,
imageResolution: frame.camera.imageResolution,
cameraTransform: frame.camera.transform,
depthWidth: width,
depthHeight: height,
depthMeters: meters,
confidence: confidence,
sequence: 0,
timestamp: Date().timeIntervalSince1970
)
}
}
extension LiDARCaptureManager: ARSessionDelegate {
nonisolated func session(_ session: ARSession, didUpdate frame: ARFrame) {
guard let base = makeFrame(from: frame) else { return }
let frameTimestamp = frame.timestamp
Task { @MainActor in
sequence &+= 1
let corrected = base.assigningSequence(sequence)
if let previous = lastTimestamp {
let delta = frameTimestamp - previous
if delta > 0 { framesPerSecond = 1.0 / delta }
}
lastTimestamp = frameTimestamp
lastFrame = corrected
onFrame?(corrected)
}
}
nonisolated func session(_ session: ARSession, didFailWithError error: Error) {
Task { @MainActor in
state = .failed(error.localizedDescription)
}
}
}

View File

@@ -0,0 +1,118 @@
import Foundation
import simd
struct RuViewLiDARFrame: Codable, Sendable {
struct Intrinsics: Codable, Sendable {
let fx: Float
let fy: Float
let cx: Float
let cy: Float
let imageWidth: Int
let imageHeight: Int
}
struct Pose: Codable, Sendable {
let matrix: [Float]
}
struct Depth: Codable, Sendable {
let width: Int
let height: Int
let meters: [Float]
let confidence: [UInt8]
}
struct Provenance: Codable, Sendable {
let sensor: String
let source: String
let privacyClass: String
let sequence: UInt64
let timestampNs: UInt64
let schema: String
}
let type: String
let intrinsics: Intrinsics
let pose: Pose
let depth: Depth
let provenance: Provenance
init(
intrinsics: simd_float3x3,
imageResolution: CGSize,
cameraTransform: simd_float4x4,
depthWidth: Int,
depthHeight: Int,
depthMeters: [Float],
confidence: [UInt8],
sequence: UInt64,
timestamp: TimeInterval
) {
self.type = "ruview.lidar.depth.v1"
self.intrinsics = Intrinsics(
fx: intrinsics.columns.0.x,
fy: intrinsics.columns.1.y,
cx: intrinsics.columns.2.x,
cy: intrinsics.columns.2.y,
imageWidth: Int(imageResolution.width),
imageHeight: Int(imageResolution.height)
)
self.pose = Pose(matrix: cameraTransform.columnMajorArray)
self.depth = Depth(
width: depthWidth,
height: depthHeight,
meters: depthMeters,
confidence: confidence
)
self.provenance = Provenance(
sensor: "apple-arkit-scene-depth",
source: "live",
privacyClass: "geometry-only",
sequence: sequence,
timestampNs: UInt64(max(0, timestamp) * 1_000_000_000),
schema: "ruview.lidar.depth.v1"
)
}
func assigningSequence(_ sequence: UInt64) -> RuViewLiDARFrame {
RuViewLiDARFrame(
type: type,
intrinsics: intrinsics,
pose: pose,
depth: depth,
provenance: Provenance(
sensor: provenance.sensor,
source: provenance.source,
privacyClass: provenance.privacyClass,
sequence: sequence,
timestampNs: provenance.timestampNs,
schema: provenance.schema
)
)
}
private init(
type: String,
intrinsics: Intrinsics,
pose: Pose,
depth: Depth,
provenance: Provenance
) {
self.type = type
self.intrinsics = intrinsics
self.pose = pose
self.depth = depth
self.provenance = provenance
}
}
private extension simd_float4x4 {
var columnMajorArray: [Float] {
[
columns.0.x, columns.0.y, columns.0.z, columns.0.w,
columns.1.x, columns.1.y, columns.1.z, columns.1.w,
columns.2.x, columns.2.y, columns.2.z, columns.2.w,
columns.3.x, columns.3.y, columns.3.z, columns.3.w
]
}
}

View File

@@ -0,0 +1,10 @@
import SwiftUI
@main
struct RuViewLiDARApp: App {
var body: some Scene {
WindowGroup {
ContentView()
}
}
}

View File

@@ -0,0 +1,93 @@
import Foundation
actor WebSocketStreamer {
enum StreamError: Error {
case invalidURL
}
struct WirePacket: Codable {
struct Depth: Codable {
let width: Int
let height: Int
let encoding: String
let millimetersBase64: String
let confidenceBase64: String
}
let type: String
let intrinsics: RuViewLiDARFrame.Intrinsics
let pose: RuViewLiDARFrame.Pose
let depth: Depth
let provenance: RuViewLiDARFrame.Provenance
}
private var task: URLSessionWebSocketTask?
private let encoder = JSONEncoder()
private var lastSentNs: UInt64 = 0
func connect(to endpoint: String) throws {
guard let url = URL(string: endpoint),
url.scheme == "ws" || url.scheme == "wss" else {
throw StreamError.invalidURL
}
task?.cancel(with: .goingAway, reason: nil)
let socket = URLSession.shared.webSocketTask(with: url)
socket.resume()
task = socket
}
func disconnect() {
task?.cancel(with: .goingAway, reason: nil)
task = nil
}
func send(_ frame: RuViewLiDARFrame, maxFPS: UInt64 = 15, sampleStep: Int = 2) async throws {
guard let task else { return }
let timestamp = frame.provenance.timestampNs
let minDelta = 1_000_000_000 / max(1, maxFPS)
guard timestamp >= lastSentNs + minDelta else { return }
lastSentNs = timestamp
let packet = Self.makeWirePacket(frame, sampleStep: max(1, sampleStep))
let data = try encoder.encode(packet)
guard let string = String(data: data, encoding: .utf8) else { return }
try await task.send(.string(string))
}
static func makeWirePacket(_ frame: RuViewLiDARFrame, sampleStep: Int) -> WirePacket {
let step = max(1, sampleStep)
let sourceWidth = frame.depth.width
let sourceHeight = frame.depth.height
let width = (sourceWidth + step - 1) / step
let height = (sourceHeight + step - 1) / step
var millimeters = Data(capacity: width * height * 2)
var confidence = Data(capacity: width * height)
for y in stride(from: 0, to: sourceHeight, by: step) {
for x in stride(from: 0, to: sourceWidth, by: step) {
let index = y * sourceWidth + x
let meters = frame.depth.meters[index]
let mm = UInt16(clamping: Int((meters * 1000).rounded()))
var littleEndian = mm.littleEndian
withUnsafeBytes(of: &littleEndian) { millimeters.append(contentsOf: $0) }
confidence.append(frame.depth.confidence[index])
}
}
return WirePacket(
type: frame.type,
intrinsics: frame.intrinsics,
pose: frame.pose,
depth: WirePacket.Depth(
width: width,
height: height,
encoding: "u16le-mm+u8-confidence",
millimetersBase64: millimeters.base64EncodedString(),
confidenceBase64: confidence.base64EncodedString()
),
provenance: frame.provenance
)
}
}

View File

@@ -0,0 +1,108 @@
import { decodeLiDARPacket, depthToPointCloud } from './codec.mjs';
const canvas = document.querySelector('#view');
const ctx = canvas.getContext('2d');
const status = document.querySelector('#status');
const fpsEl = document.querySelector('#fps');
const pointsEl = document.querySelector('#points');
const seqEl = document.querySelector('#seq');
const latencyEl = document.querySelector('#latency');
const sensorEl = document.querySelector('#sensor');
let lastFrameAt = performance.now();
let yaw = 0.3;
let pitch = -0.15;
let scale = 120;
function connect() {
const token = new URLSearchParams(location.search).get('token');
if (!token) {
status.textContent = 'TOKEN REQUIRED';
status.dataset.state = 'warn';
return;
}
const protocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
const socket = new WebSocket(`${protocol}//${location.host}/ws/lidar?token=${encodeURIComponent(token)}`);
socket.addEventListener('open', () => {
status.textContent = 'LIVE';
status.dataset.state = 'live';
});
socket.addEventListener('close', () => {
status.textContent = 'RECONNECTING';
status.dataset.state = 'warn';
setTimeout(connect, 1000);
});
socket.addEventListener('message', (event) => {
try {
const raw = JSON.parse(event.data);
const frame = decodeLiDARPacket(raw);
const points = depthToPointCloud(frame, 1);
render(points);
const now = performance.now();
const delta = now - lastFrameAt;
lastFrameAt = now;
fpsEl.textContent = delta > 0 ? (1000 / delta).toFixed(1) : '0.0';
pointsEl.textContent = points.length.toLocaleString();
seqEl.textContent = frame.provenance.sequence;
latencyEl.textContent = Math.max(0, Date.now() - Number(frame.provenance.timestampNs / 1_000_000)).toFixed(0);
sensorEl.textContent = frame.provenance.sensor;
} catch (error) {
console.error(error);
status.textContent = 'FRAME ERROR';
status.dataset.state = 'warn';
}
});
}
function resize() {
const dpr = Math.min(devicePixelRatio || 1, 2);
const rect = canvas.getBoundingClientRect();
canvas.width = Math.max(1, Math.floor(rect.width * dpr));
canvas.height = Math.max(1, Math.floor(rect.height * dpr));
ctx.setTransform(dpr, 0, 0, dpr, 0, 0);
}
function render(points) {
resize();
const w = canvas.clientWidth;
const h = canvas.clientHeight;
ctx.clearRect(0, 0, w, h);
ctx.fillStyle = '#091018';
ctx.fillRect(0, 0, w, h);
const cy = Math.cos(yaw);
const sy = Math.sin(yaw);
const cp = Math.cos(pitch);
const sp = Math.sin(pitch);
ctx.fillStyle = '#58e0d2';
for (let i = 0; i < points.length; i += 1) {
let [x, y, z] = points[i];
const rx = x * cy - z * sy;
const rz = x * sy + z * cy;
const ry = y * cp - rz * sp;
const rz2 = y * sp + rz * cp;
const perspective = 1 / Math.max(0.35, 1.8 - rz2 * 0.12);
const px = w / 2 + rx * scale * perspective;
const py = h / 2 + ry * scale * perspective;
if (px >= 0 && px < w && py >= 0 && py < h) ctx.fillRect(px, py, 1.4, 1.4);
}
}
canvas.addEventListener('pointermove', (event) => {
if (!event.buttons) return;
yaw += event.movementX * 0.006;
pitch += event.movementY * 0.006;
});
canvas.addEventListener('wheel', (event) => {
event.preventDefault();
scale = Math.max(40, Math.min(400, scale - event.deltaY * 0.2));
}, { passive: false });
connect();

View File

@@ -0,0 +1,121 @@
export function decodeLiDARPacket(packet) {
if (!packet || packet.type !== 'ruview.lidar.depth.v1') {
throw new Error('Unsupported LiDAR packet type');
}
const { depth } = packet;
if (!depth || depth.encoding !== 'u16le-mm+u8-confidence') {
throw new Error('Unsupported depth encoding');
}
assertPositiveInteger(depth.width, 'depth.width');
assertPositiveInteger(depth.height, 'depth.height');
assertIntrinsics(packet.intrinsics);
if (!packet.pose || !Array.isArray(packet.pose.matrix) || packet.pose.matrix.length !== 16
|| packet.pose.matrix.some((value) => !Number.isFinite(value))) {
throw new Error('Invalid camera pose');
}
const mmBytes = base64ToBytes(depth.millimetersBase64, 'millimetersBase64');
const confidence = base64ToBytes(depth.confidenceBase64, 'confidenceBase64');
const expectedPixels = depth.width * depth.height;
if (!Number.isSafeInteger(expectedPixels) || expectedPixels > 1_000_000) {
throw new Error('Depth dimensions exceed the supported pixel limit');
}
if (mmBytes.byteLength !== expectedPixels * 2) {
throw new Error(`Depth payload length mismatch: expected ${expectedPixels * 2}, got ${mmBytes.byteLength}`);
}
if (confidence.byteLength !== expectedPixels) {
throw new Error(`Confidence payload length mismatch: expected ${expectedPixels}, got ${confidence.byteLength}`);
}
const view = new DataView(mmBytes.buffer, mmBytes.byteOffset, mmBytes.byteLength);
const meters = new Float32Array(expectedPixels);
for (let i = 0; i < expectedPixels; i += 1) {
meters[i] = view.getUint16(i * 2, true) / 1000;
}
return {
...packet,
depth: {
width: depth.width,
height: depth.height,
meters,
confidence,
},
};
}
export function depthToPointCloud(frame, confidenceThreshold = 1) {
const { width, height, meters, confidence } = frame.depth;
const { fx, fy, cx, cy, imageWidth, imageHeight } = frame.intrinsics;
assertPositiveInteger(width, 'depth.width');
assertPositiveInteger(height, 'depth.height');
assertIntrinsics(frame.intrinsics);
if (meters.length !== width * height || confidence.length !== width * height) {
throw new Error('Decoded depth array length mismatch');
}
if (!Number.isFinite(confidenceThreshold) || confidenceThreshold < 0 || confidenceThreshold > 255) {
throw new Error('Invalid confidence threshold');
}
const sx = width / imageWidth;
const sy = height / imageHeight;
const scaledFx = fx * sx;
const scaledFy = fy * sy;
const scaledCx = cx * sx;
const scaledCy = cy * sy;
const points = [];
for (let v = 0; v < height; v += 1) {
for (let u = 0; u < width; u += 1) {
const index = v * width + u;
const z = meters[index];
if (!Number.isFinite(z) || z <= 0 || confidence[index] < confidenceThreshold) continue;
const x = ((u - scaledCx) / scaledFx) * z;
const y = ((v - scaledCy) / scaledFy) * z;
points.push([x, y === 0 ? 0 : -y, -z]);
}
}
return points;
}
function assertPositiveInteger(value, name) {
if (!Number.isSafeInteger(value) || value <= 0) {
throw new Error(`${name} must be a positive integer`);
}
}
function assertIntrinsics(intrinsics) {
if (!intrinsics
|| !Number.isFinite(intrinsics.fx) || intrinsics.fx <= 0
|| !Number.isFinite(intrinsics.fy) || intrinsics.fy <= 0
|| !Number.isFinite(intrinsics.cx)
|| !Number.isFinite(intrinsics.cy)) {
throw new Error('Invalid camera intrinsics');
}
assertPositiveInteger(intrinsics.imageWidth, 'intrinsics.imageWidth');
assertPositiveInteger(intrinsics.imageHeight, 'intrinsics.imageHeight');
}
function base64ToBytes(value, name) {
if (typeof value !== 'string' || value.length === 0 || value.length % 4 !== 0
|| !/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/.test(value)) {
throw new Error(`${name} must be canonical base64`);
}
if (typeof Buffer !== 'undefined') {
return Uint8Array.from(Buffer.from(value, 'base64'));
}
const binary = atob(value);
const bytes = new Uint8Array(binary.length);
for (let i = 0; i < binary.length; i += 1) {
bytes[i] = binary.charCodeAt(i);
}
return bytes;
}

View File

@@ -0,0 +1,69 @@
import test from 'node:test';
import assert from 'node:assert/strict';
import { decodeLiDARPacket, depthToPointCloud } from './codec.mjs';
function b64(bytes) {
return Buffer.from(bytes).toString('base64');
}
test('decodes u16 millimeter depth and confidence', () => {
const packet = {
type: 'ruview.lidar.depth.v1',
intrinsics: { fx: 100, fy: 100, cx: 1, cy: 1, imageWidth: 2, imageHeight: 2 },
pose: { matrix: Array(16).fill(0) },
depth: {
width: 2,
height: 2,
encoding: 'u16le-mm+u8-confidence',
millimetersBase64: b64([0xe8,0x03,0xd0,0x07,0xb8,0x0b,0xa0,0x0f]),
confidenceBase64: b64([2,2,1,0]),
},
provenance: { sensor: 'test', source: 'live', privacyClass: 'geometry-only', sequence: 1, timestampNs: 1, schema: 'ruview.lidar.depth.v1' },
};
const frame = decodeLiDARPacket(packet);
assert.deepEqual(Array.from(frame.depth.meters), [1,2,3,4]);
assert.deepEqual(Array.from(frame.depth.confidence), [2,2,1,0]);
});
test('rejects malformed payload length', () => {
assert.throws(() => decodeLiDARPacket({
type: 'ruview.lidar.depth.v1',
intrinsics: { fx: 100, fy: 100, cx: 1, cy: 1, imageWidth: 2, imageHeight: 2 },
pose: { matrix: Array(16).fill(0) },
depth: { width: 2, height: 2, encoding: 'u16le-mm+u8-confidence', millimetersBase64: b64([1,2]), confidenceBase64: b64([1,1,1,1]) },
}), /length mismatch/);
});
test('rejects invalid dimensions, intrinsics, pose, and base64', () => {
const valid = {
type: 'ruview.lidar.depth.v1',
intrinsics: { fx: 100, fy: 100, cx: 0, cy: 0, imageWidth: 1, imageHeight: 1 },
pose: { matrix: Array(16).fill(0) },
depth: {
width: 1,
height: 1,
encoding: 'u16le-mm+u8-confidence',
millimetersBase64: b64([0xe8, 0x03]),
confidenceBase64: b64([2]),
},
};
assert.throws(() => decodeLiDARPacket({ ...valid, depth: { ...valid.depth, width: 0 } }), /positive integer/);
assert.throws(() => decodeLiDARPacket({ ...valid, intrinsics: { ...valid.intrinsics, fx: 0 } }), /intrinsics/);
assert.throws(() => decodeLiDARPacket({ ...valid, pose: { matrix: [1] } }), /pose/);
assert.throws(() => decodeLiDARPacket({
...valid,
depth: { ...valid.depth, millimetersBase64: '!!!!' },
}), /canonical base64/);
});
test('projects depth into a point cloud and honors confidence', () => {
const frame = {
intrinsics: { fx: 100, fy: 100, cx: 0, cy: 0, imageWidth: 2, imageHeight: 2 },
depth: { width: 2, height: 2, meters: Float32Array.from([1,1,1,1]), confidence: Uint8Array.from([2,0,2,0]) },
};
const points = depthToPointCloud(frame, 1);
assert.equal(points.length, 2);
assert.deepEqual(points[0], [0, 0, -1]);
});

View File

@@ -0,0 +1,36 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width,initial-scale=1,viewport-fit=cover" />
<title>RuView iPhone LiDAR</title>
<link rel="stylesheet" href="./styles.css" />
</head>
<body>
<main>
<header>
<div>
<p class="eyebrow">RUVIEW SENSOR BRIDGE</p>
<h1>iPhone LiDAR</h1>
</div>
<span id="status">CONNECTING</span>
</header>
<section class="metrics">
<div><strong id="fps">0.0</strong><span>FPS</span></div>
<div><strong id="points">0</strong><span>POINTS</span></div>
<div><strong id="seq">0</strong><span>SEQ</span></div>
<div><strong id="latency">0</strong><span>MS</span></div>
</section>
<canvas id="view"></canvas>
<footer>
<span>Geometry only</span>
<span>No RGB upload</span>
<span id="sensor">Waiting for sensor</span>
</footer>
</main>
<script type="module" src="./app.mjs"></script>
</body>
</html>

View File

@@ -0,0 +1,39 @@
{
"name": "@ruview/iphone-lidar-web",
"version": "0.1.0",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "@ruview/iphone-lidar-web",
"version": "0.1.0",
"dependencies": {
"ws": "^8.18.3"
},
"engines": {
"node": ">=20"
}
},
"node_modules/ws": {
"version": "8.21.3",
"resolved": "https://registry.npmjs.org/ws/-/ws-8.21.3.tgz",
"integrity": "sha512-201TZ/kPWxoPr/OKWjquZR1SWKXcvxdH+e1xrx89b3YbmzLMFCLfnaG1HFIgWzJOEWZ7MvpK++odZufgYR50Rw==",
"license": "MIT",
"engines": {
"node": ">=10.0.0"
},
"peerDependencies": {
"bufferutil": "^4.0.1",
"utf-8-validate": ">=5.0.2"
},
"peerDependenciesMeta": {
"bufferutil": {
"optional": true
},
"utf-8-validate": {
"optional": true
}
}
}
}
}

View File

@@ -0,0 +1,16 @@
{
"name": "@ruview/iphone-lidar-web",
"private": true,
"version": "0.1.0",
"type": "module",
"scripts": {
"start": "node relay.mjs",
"test": "node --test"
},
"engines": {
"node": ">=20"
},
"dependencies": {
"ws": "^8.18.3"
}
}

View File

@@ -0,0 +1,166 @@
import { randomBytes, timingSafeEqual } from 'node:crypto';
import http from 'node:http';
import { readFile } from 'node:fs/promises';
import { extname, join } from 'node:path';
import { fileURLToPath, pathToFileURL } from 'node:url';
import { WebSocket, WebSocketServer } from 'ws';
const root = fileURLToPath(new URL('.', import.meta.url));
const staticFiles = new Set(['index.html', 'app.mjs', 'codec.mjs', 'styles.css']);
const maxPayloadBytes = 2_000_000;
function constantTimeEqual(left, right) {
const leftBytes = Buffer.from(left, 'utf8');
const rightBytes = Buffer.from(right, 'utf8');
return leftBytes.length === rightBytes.length && timingSafeEqual(leftBytes, rightBytes);
}
function rejectUpgrade(socket, status, message) {
const body = `${message}\n`;
socket.end(
`HTTP/1.1 ${status}\r\nConnection: close\r\nContent-Type: text/plain; charset=utf-8\r\nContent-Length: ${Buffer.byteLength(body)}\r\n\r\n${body}`,
);
}
export function createLiDARRelay({ token, rootDirectory = root } = {}) {
const accessToken = token || randomBytes(24).toString('hex');
const clients = new Set();
const server = http.createServer(async (req, res) => {
if (req.method !== 'GET' && req.method !== 'HEAD') {
res.writeHead(405, { allow: 'GET, HEAD' }).end();
return;
}
let pathname;
try {
pathname = decodeURIComponent(new URL(req.url || '/', 'http://localhost').pathname);
} catch {
res.writeHead(400).end('bad path');
return;
}
const filename = pathname === '/' ? 'index.html' : pathname.slice(1);
if (!staticFiles.has(filename)) {
res.writeHead(404).end('not found');
return;
}
try {
const data = await readFile(join(rootDirectory, filename));
const contentType = {
'.html': 'text/html; charset=utf-8',
'.mjs': 'text/javascript; charset=utf-8',
'.css': 'text/css; charset=utf-8',
}[extname(filename)] || 'application/octet-stream';
res.writeHead(200, {
'content-type': contentType,
'cache-control': 'no-store',
'content-security-policy': "default-src 'self'; connect-src 'self' ws: wss:; img-src 'self'; style-src 'self'; base-uri 'none'; frame-ancestors 'none'",
'referrer-policy': 'no-referrer',
'x-content-type-options': 'nosniff',
});
if (req.method === 'HEAD') res.end();
else res.end(data);
} catch {
res.writeHead(404).end('not found');
}
});
const wss = new WebSocketServer({ noServer: true, maxPayload: maxPayloadBytes });
server.on('upgrade', (req, socket, head) => {
let url;
try {
url = new URL(req.url || '/', 'http://localhost');
} catch {
rejectUpgrade(socket, '400 Bad Request', 'bad websocket URL');
return;
}
if (url.pathname !== '/ws/lidar') {
rejectUpgrade(socket, '404 Not Found', 'not found');
return;
}
const suppliedToken = url.searchParams.get('token') || '';
if (!constantTimeEqual(suppliedToken, accessToken)) {
rejectUpgrade(socket, '401 Unauthorized', 'valid LiDAR relay token required');
return;
}
wss.handleUpgrade(req, socket, head, (websocket) => {
wss.emit('connection', websocket, req);
});
});
wss.on('connection', (socket) => {
clients.add(socket);
socket.on('close', () => clients.delete(socket));
socket.on('error', () => socket.terminate());
socket.on('message', (data, isBinary) => {
if (isBinary) return;
let packet;
try {
packet = JSON.parse(data.toString());
} catch {
return;
}
if (packet?.type !== 'ruview.lidar.depth.v1') return;
for (const peer of clients) {
if (peer !== socket && peer.readyState === WebSocket.OPEN) {
peer.send(data.toString());
}
}
});
});
return {
accessToken,
server,
async listen(port = 0, host = '127.0.0.1') {
await new Promise((resolve, reject) => {
server.once('error', reject);
server.listen(port, host, () => {
server.off('error', reject);
resolve();
});
});
return server.address();
},
async close() {
for (const peer of clients) peer.terminate();
await new Promise((resolve) => wss.close(resolve));
if (server.listening) {
await new Promise((resolve, reject) => {
server.close((error) => (error ? reject(error) : resolve()));
});
}
},
};
}
function configuredPort(value) {
const parsed = Number(value);
if (!Number.isSafeInteger(parsed) || parsed < 1 || parsed > 65_535) {
throw new Error(`PORT must be an integer from 1 to 65535; received ${value}`);
}
return parsed;
}
const directInvocation = process.argv[1]
&& pathToFileURL(process.argv[1]).href === import.meta.url;
if (directInvocation) {
const port = configuredPort(process.env.PORT || '8787');
const host = process.env.HOST || '0.0.0.0';
const relay = createLiDARRelay({ token: process.env.RUVIEW_LIDAR_TOKEN });
await relay.listen(port, host);
const encodedToken = encodeURIComponent(relay.accessToken);
console.log(`RuView iPhone LiDAR relay listening on ${host}:${port}`);
console.log(`Browser: http://<host>:${port}/?token=${encodedToken}`);
console.log(`Native endpoint: ws://<host>:${port}/ws/lidar?token=${encodedToken}`);
}

View File

@@ -0,0 +1,73 @@
import assert from 'node:assert/strict';
import http from 'node:http';
import test from 'node:test';
import { WebSocket } from 'ws';
import { createLiDARRelay } from './relay.mjs';
function connect(url) {
return new Promise((resolve, reject) => {
const socket = new WebSocket(url);
socket.once('open', () => resolve(socket));
socket.once('error', reject);
});
}
function request(url) {
return new Promise((resolve, reject) => {
http.get(url, (response) => {
response.resume();
response.once('end', () => resolve(response));
}).once('error', reject);
});
}
test('relay requires a token, limits static files, and forwards LiDAR frames', async (t) => {
const token = 'test-token-for-relay';
const relay = createLiDARRelay({ token });
const address = await relay.listen(0, '127.0.0.1');
const httpBase = `http://127.0.0.1:${address.port}`;
const wsBase = `ws://127.0.0.1:${address.port}/ws/lidar`;
const sockets = [];
t.after(async () => {
for (const socket of sockets) socket.terminate();
await relay.close();
});
const indexResponse = await request(`${httpBase}/?token=${token}`);
assert.equal(indexResponse.statusCode, 200);
assert.match(indexResponse.headers['content-security-policy'], /frame-ancestors 'none'/);
const sourceResponse = await request(`${httpBase}/relay.mjs`);
assert.equal(sourceResponse.statusCode, 404);
await new Promise((resolve, reject) => {
const unauthorized = new WebSocket(wsBase);
unauthorized.once('unexpected-response', (_request, response) => {
assert.equal(response.statusCode, 401);
response.resume();
resolve();
});
unauthorized.once('open', () => reject(new Error('unauthorized websocket opened')));
unauthorized.once('error', () => {});
});
const sender = await connect(`${wsBase}?token=${encodeURIComponent(token)}`);
const receiver = await connect(`${wsBase}?token=${encodeURIComponent(token)}`);
sockets.push(sender, receiver);
const received = new Promise((resolve, reject) => {
const timer = setTimeout(() => reject(new Error('timed out waiting for relayed frame')), 2_000);
receiver.once('message', (data, isBinary) => {
clearTimeout(timer);
resolve({ data, isBinary });
});
});
const frame = { type: 'ruview.lidar.depth.v1', provenance: { sequence: 7 } };
sender.send(JSON.stringify(frame));
const message = await received;
assert.equal(message.isBinary, false);
assert.deepEqual(JSON.parse(message.data.toString()), frame);
});

View File

@@ -0,0 +1 @@
*{box-sizing:border-box}body{margin:0;background:#05080d;color:#e8f1f5;font-family:ui-monospace,SFMono-Regular,Menlo,monospace}main{min-height:100vh;padding:18px;display:grid;grid-template-rows:auto auto 1fr auto;gap:14px}header{display:flex;align-items:end;justify-content:space-between}h1{margin:0;font-size:clamp(28px,6vw,54px)}.eyebrow{margin:0 0 6px;color:#58e0d2;font-size:11px;letter-spacing:.16em}#status{border:1px solid #2a3946;border-radius:999px;padding:7px 11px;font-size:11px}#status[data-state=live]{color:#58e0d2;border-color:#58e0d2}.metrics{display:grid;grid-template-columns:repeat(4,1fr);gap:8px}.metrics div{background:#0b1219;border:1px solid #17222d;border-radius:10px;padding:10px}.metrics strong{display:block;font-size:18px}.metrics span,footer{font-size:10px;color:#8aa0af}canvas{width:100%;height:100%;min-height:55vh;border-radius:14px;border:1px solid #17222d;background:#091018;touch-action:none}footer{display:flex;gap:16px;flex-wrap:wrap}@media(max-width:640px){.metrics{grid-template-columns:repeat(2,1fr)}canvas{min-height:58vh}}

View File

@@ -0,0 +1,288 @@
#!/usr/bin/env bash
# Reproducible CPU benchmark evidence runner for ADR-348.
#
# This script never downloads a model or dataset and never enables CUDA. The
# benchmark fixtures are generated by the checked-in Rust benches, so the
# source commit and Cargo.lock digest identify the fixture implementation.
set -Eeuo pipefail
SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd -P)"
REPO_ROOT="$(cd -- "${SCRIPT_DIR}/.." && pwd -P)"
TOOLCHAIN="${RUFORECAST_TOOLCHAIN:-1.92.0}"
THREADS="${RUFORECAST_THREADS:-1}"
WARM_UP_SECONDS="${RUFORECAST_WARM_UP_SECONDS:-3}"
MEASUREMENT_SECONDS="${RUFORECAST_MEASUREMENT_SECONDS:-10}"
SAMPLE_SIZE="${RUFORECAST_SAMPLE_SIZE:-30}"
CPUSET="${RUFORECAST_CPUSET:-}"
ALLOW_DIRTY="${RUFORECAST_ALLOW_DIRTY:-0}"
INCLUDE_LARGE="${RUFORECAST_BENCH_LARGE:-0}"
die() {
printf 'ruforecast benchmark: %s\n' "$*" >&2
exit 1
}
require_command() {
command -v "$1" >/dev/null 2>&1 || die "required command not found: $1"
}
require_uint() {
local name="$1"
local value="$2"
[[ "$value" =~ ^[0-9]+$ ]] || die "${name} must be an unsigned integer"
}
[[ "$TOOLCHAIN" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]] \
|| die "RUFORECAST_TOOLCHAIN must be an exact Rust release such as 1.92.0"
require_uint RUFORECAST_THREADS "$THREADS"
require_uint RUFORECAST_WARM_UP_SECONDS "$WARM_UP_SECONDS"
require_uint RUFORECAST_MEASUREMENT_SECONDS "$MEASUREMENT_SECONDS"
require_uint RUFORECAST_SAMPLE_SIZE "$SAMPLE_SIZE"
(( THREADS >= 1 )) || die "RUFORECAST_THREADS must be at least 1"
(( WARM_UP_SECONDS >= 1 )) || die "RUFORECAST_WARM_UP_SECONDS must be at least 1"
(( MEASUREMENT_SECONDS >= 1 )) || die "RUFORECAST_MEASUREMENT_SECONDS must be at least 1"
(( SAMPLE_SIZE >= 10 )) || die "RUFORECAST_SAMPLE_SIZE must be at least 10 for Criterion"
[[ "$ALLOW_DIRTY" == "0" || "$ALLOW_DIRTY" == "1" ]] \
|| die "RUFORECAST_ALLOW_DIRTY must be 0 or 1"
[[ "$INCLUDE_LARGE" == "0" || "$INCLUDE_LARGE" == "1" ]] \
|| die "RUFORECAST_BENCH_LARGE must be 0 or 1"
if [[ -n "$CPUSET" ]]; then
[[ "$CPUSET" =~ ^[0-9,-]+$ ]] || die "RUFORECAST_CPUSET contains unsupported characters"
require_command taskset
fi
for command_name in cargo rustc git jq sha256sum; do
require_command "$command_name"
done
cd "$REPO_ROOT"
for manifest in \
v2/crates/ruview-forecast-core/Cargo.toml \
v2/crates/ruview-forecast-model/Cargo.toml \
v2/crates/ruview-forecast-train/Cargo.toml; do
[[ -f "$manifest" ]] || die "forecast crate is missing: $manifest"
done
WORKTREE_CLEAN=true
if [[ -n "$(git status --porcelain)" ]]; then
WORKTREE_CLEAN=false
[[ "$ALLOW_DIRTY" == "1" ]] \
|| die "worktree changes detected; commit them or set RUFORECAST_ALLOW_DIRTY=1 for diagnostic evidence"
fi
COMMIT="$(git rev-parse HEAD)"
SHORT_COMMIT="$(git rev-parse --short=12 HEAD)"
LOCK_SHA256="$(sha256sum v2/Cargo.lock | awk '{print $1}')"
RUN_UTC="$(date -u +'%Y%m%dT%H%M%SZ')"
SOURCE_DATE_EPOCH="$(git show -s --format=%ct HEAD)"
DEFAULT_OUTPUT="${REPO_ROOT}/target/ruforecast-evidence/${RUN_UTC}-${SHORT_COMMIT}"
OUTPUT_DIR="${RUFORECAST_OUTPUT_DIR:-$DEFAULT_OUTPUT}"
if [[ "$OUTPUT_DIR" != /* ]]; then
OUTPUT_DIR="${REPO_ROOT}/${OUTPUT_DIR}"
fi
if [[ -d "$OUTPUT_DIR" && -n "$(find "$OUTPUT_DIR" -mindepth 1 -maxdepth 1 -print -quit)" ]]; then
die "output directory is not empty: $OUTPUT_DIR"
fi
mkdir -p "$OUTPUT_DIR"
finalize_evidence() {
local exit_status=$?
local sums_status=0
local sums_tmp=""
trap - EXIT
set +e
if [[ -d "${OUTPUT_DIR:-}" ]]; then
if (( exit_status == 0 )); then
printf 'status=PASSED\nexit_code=0\n' >"${OUTPUT_DIR}/run-status.txt"
else
printf 'status=FAILED\nexit_code=%d\n' "$exit_status" \
>"${OUTPUT_DIR}/run-status.txt"
fi
sums_tmp="$(mktemp "${OUTPUT_DIR}.SHA256SUMS.XXXXXX")" || sums_status=$?
if (( sums_status == 0 )); then
(
cd "$OUTPUT_DIR" || exit
find . -maxdepth 1 -type f ! -name SHA256SUMS -printf '%P\0' \
| sort -z \
| xargs -0 sha256sum
) >"$sums_tmp" || sums_status=$?
fi
if (( sums_status == 0 )); then
mv "$sums_tmp" "${OUTPUT_DIR}/SHA256SUMS" || sums_status=$?
elif [[ -n "$sums_tmp" ]]; then
rm -f "$sums_tmp"
fi
fi
if (( exit_status == 0 && sums_status != 0 )); then
exit_status=$sums_status
fi
exit "$exit_status"
}
trap finalize_evidence EXIT
export RAYON_NUM_THREADS="$THREADS"
export OMP_NUM_THREADS="$THREADS"
export OPENBLAS_NUM_THREADS="$THREADS"
export MKL_NUM_THREADS="$THREADS"
export NUMEXPR_NUM_THREADS="$THREADS"
export CARGO_PROFILE_BENCH_DEBUG=0
export CARGO_PROFILE_RELEASE_DEBUG=0
export CARGO_INCREMENTAL=0
export RUST_BACKTRACE=1
export SOURCE_DATE_EPOCH
export TZ=UTC
export LC_ALL=C
export RUFORECAST_BENCH_LARGE="$INCLUDE_LARGE"
CARGO=(cargo "+${TOOLCHAIN}")
if [[ -n "$CPUSET" ]]; then
CARGO=(taskset -c "$CPUSET" cargo "+${TOOLCHAIN}")
fi
"${CARGO[@]}" --version >"${OUTPUT_DIR}/cargo-version.txt"
if [[ -n "$CPUSET" ]]; then
taskset -c "$CPUSET" rustc "+${TOOLCHAIN}" -vV >"${OUTPUT_DIR}/rustc-version.txt"
else
rustc "+${TOOLCHAIN}" -vV >"${OUTPUT_DIR}/rustc-version.txt"
fi
if command -v lscpu >/dev/null 2>&1; then
lscpu -J >"${OUTPUT_DIR}/cpu.json"
fi
uname -srmo >"${OUTPUT_DIR}/kernel.txt"
if [[ -r /etc/os-release ]]; then
cp /etc/os-release "${OUTPUT_DIR}/os-release.txt"
fi
if command -v free >/dev/null 2>&1; then
free -b >"${OUTPUT_DIR}/memory.txt"
fi
printf \
'RUFORECAST_TOOLCHAIN=%q RUFORECAST_THREADS=%q RUFORECAST_CPUSET=%q RUFORECAST_WARM_UP_SECONDS=%q RUFORECAST_MEASUREMENT_SECONDS=%q RUFORECAST_SAMPLE_SIZE=%q RUFORECAST_ALLOW_DIRTY=%q RUFORECAST_BENCH_LARGE=%q scripts/run-ruforecast-benchmarks.sh\n' \
"$TOOLCHAIN" \
"$THREADS" \
"$CPUSET" \
"$WARM_UP_SECONDS" \
"$MEASUREMENT_SECONDS" \
"$SAMPLE_SIZE" \
"$ALLOW_DIRTY" \
"$INCLUDE_LARGE" \
>"${OUTPUT_DIR}/reproducer.txt"
EVIDENCE_LABEL="MEASURED"
EVIDENCE_SCOPE="LOCAL_CPU_SYNTHETIC_FIXTURE"
if [[ "$WORKTREE_CLEAN" != "true" ]]; then
EVIDENCE_LABEL="SYNTHETIC"
EVIDENCE_SCOPE="DIRTY_WORKTREE_DIAGNOSTIC_ONLY"
fi
jq -n \
--arg schema_version "1" \
--arg evidence_label "$EVIDENCE_LABEL" \
--arg evidence_scope "$EVIDENCE_SCOPE" \
--arg commit "$COMMIT" \
--arg lock_sha256 "$LOCK_SHA256" \
--arg toolchain "$TOOLCHAIN" \
--arg run_utc "$RUN_UTC" \
--argjson source_date_epoch "$SOURCE_DATE_EPOCH" \
--arg cpuset "$CPUSET" \
--argjson include_large "$INCLUDE_LARGE" \
--argjson worktree_clean "$WORKTREE_CLEAN" \
--argjson threads "$THREADS" \
--argjson warm_up_seconds "$WARM_UP_SECONDS" \
--argjson measurement_seconds "$MEASUREMENT_SECONDS" \
--argjson sample_size "$SAMPLE_SIZE" \
'{
schema_version: ($schema_version | tonumber),
evidence_label: $evidence_label,
evidence_scope: $evidence_scope,
claim_status: "UNREVIEWED",
input_class: "SYNTHETIC",
backend: "burn-ndarray-cpu",
cuda_enabled: false,
source: {
commit: $commit,
cargo_lock_sha256: $lock_sha256,
worktree_clean: $worktree_clean,
source_date_epoch: $source_date_epoch
},
environment: {
rust_toolchain: $toolchain,
threads: $threads,
cpuset: (if $cpuset == "" then null else $cpuset end)
},
criterion: {
warm_up_seconds: $warm_up_seconds,
measurement_seconds: $measurement_seconds,
sample_size: $sample_size,
include_large_profile: ($include_large == 1)
},
run_utc: $run_utc,
caveat: "Criterion timing is host-specific. This report is not a RuView capability claim until reviewed against ADR-348."
}' >"${OUTPUT_DIR}/metadata.json"
run_logged() {
local log_name="$1"
shift
"$@" 2>&1 | tee "${OUTPUT_DIR}/${log_name}.log"
}
run_logged core-tests \
"${CARGO[@]}" test --manifest-path v2/Cargo.toml --locked \
-p ruview-forecast-core --no-default-features --lib --tests
run_logged model-cpu-tests \
"${CARGO[@]}" test --manifest-path v2/Cargo.toml --locked \
-p ruview-forecast-model --no-default-features --features cpu --lib --tests
run_logged train-cpu-tests \
"${CARGO[@]}" test --manifest-path v2/Cargo.toml --locked \
-p ruview-forecast-train --no-default-features --features cpu,cli --lib --bins
run_logged local-jsonl-training-smoke \
"${CARGO[@]}" test --manifest-path v2/Cargo.toml --locked \
-p ruview-forecast-train --no-default-features --features cpu \
--test local_jsonl_smoke -- \
--exact local_hash_addressed_jsonl_executes_one_real_optimizer_step
run_logged cli-smoke-idempotency \
"${CARGO[@]}" test --manifest-path v2/Cargo.toml --locked \
-p ruview-forecast-train --no-default-features --features cpu,cli \
--test cli_smoke -- \
--exact cli_smoke_trains_and_writes_the_complete_candidate_set
run_logged forecast-inference-compile \
"${CARGO[@]}" bench --manifest-path v2/Cargo.toml --locked \
-p ruview-forecast-model --no-default-features --features cpu \
--bench forecast_inference --no-run
run_logged data-pipeline-compile \
"${CARGO[@]}" bench --manifest-path v2/Cargo.toml --locked \
-p ruview-forecast-train --no-default-features --features cpu \
--bench data_pipeline --no-run
run_logged forecast-inference \
"${CARGO[@]}" bench --manifest-path v2/Cargo.toml --locked \
-p ruview-forecast-model --no-default-features --features cpu \
--bench forecast_inference -- \
--warm-up-time "$WARM_UP_SECONDS" \
--measurement-time "$MEASUREMENT_SECONDS" \
--sample-size "$SAMPLE_SIZE"
run_logged data-pipeline \
"${CARGO[@]}" bench --manifest-path v2/Cargo.toml --locked \
-p ruview-forecast-train --no-default-features --features cpu \
--bench data_pipeline -- \
--warm-up-time "$WARM_UP_SECONDS" \
--measurement-time "$MEASUREMENT_SECONDS" \
--sample-size "$SAMPLE_SIZE"
printf 'RuForecast CPU outputs collected; finalizing hashes in %s\n' "$OUTPUT_DIR"
printf 'Review metadata.json and the two Criterion logs before accepting or publishing evidence.\n'

169
v2/Cargo.lock generated
View File

@@ -1553,7 +1553,7 @@ version = "3.1.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "faf9468729b8cbcea668e36183cb69d317348c2e08e994829fb56ebfdfbaac34"
dependencies = [
"windows-sys 0.48.0",
"windows-sys 0.61.2",
]
[[package]]
@@ -1791,36 +1791,36 @@ dependencies = [
[[package]]
name = "cranelift-assembler-x64"
version = "0.123.13"
version = "0.123.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "5f8e1303ae2128891cb59691a74de4547dd208bc8511a2f287cca2b93bb3c728"
checksum = "6835dba958b2ab7ab523e7e99296e0524317f60430a00cf5850562ef78ea7001"
dependencies = [
"cranelift-assembler-x64-meta",
]
[[package]]
name = "cranelift-assembler-x64-meta"
version = "0.123.13"
version = "0.123.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "58b2740a5936332028d9a1e8f29a199de2fd386e426d44da5fea70cf8e3f8e75"
checksum = "0b6e4ce8ee6d899381fbdd9e6561336c651189d46cecaeee09b29e8d80aa786e"
dependencies = [
"cranelift-srcgen",
]
[[package]]
name = "cranelift-bforest"
version = "0.123.13"
version = "0.123.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "37fd128d3629fb105e433bda09744c5a2959cd1da04617a455c4cc17dff1ebef"
checksum = "0cb6d37015df7ea4b60450c1229ad5f5819a1fb27434b063f8e6216dfbd0c42a"
dependencies = [
"cranelift-entity",
]
[[package]]
name = "cranelift-bitset"
version = "0.123.13"
version = "0.123.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "24a88f6d5a6cf6fcbc6386415d48948094721dfa4585d6615938b11ca938f20a"
checksum = "986bea0b0858b55192782120032ce9c15943fa073f186f6e479653c59e62c329"
dependencies = [
"serde",
"serde_derive",
@@ -1828,9 +1828,9 @@ dependencies = [
[[package]]
name = "cranelift-codegen"
version = "0.123.13"
version = "0.123.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "daa4a357d030bdd586d8fe3da56b394f7f6b6ded506e59f945e7b32b1e126b71"
checksum = "9f30aeb2de7f97d6f26b4a1642615834daad58e2e4d7c027810010a3a32f22be"
dependencies = [
"bumpalo",
"cranelift-assembler-x64",
@@ -1855,9 +1855,9 @@ dependencies = [
[[package]]
name = "cranelift-codegen-meta"
version = "0.123.13"
version = "0.123.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "4121e36a8757dea6fb237435ee5095eba25bc13ecc2eaee57eb9bffd4b27784f"
checksum = "cd5dd137fcdedef33b6fd40edf1ced024460d764ceb75833e8198a843395945c"
dependencies = [
"cranelift-assembler-x64-meta",
"cranelift-codegen-shared",
@@ -1868,24 +1868,24 @@ dependencies = [
[[package]]
name = "cranelift-codegen-shared"
version = "0.123.13"
version = "0.123.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "5173265fc30b9e42205cf06dfca9a272ee949667ce4115d975ed2c08d466e2f8"
checksum = "ab54b260ef23a8f0f536679b9fc3b3b3e05353e8d1448f3ab83df02078e8be9b"
[[package]]
name = "cranelift-control"
version = "0.123.13"
version = "0.123.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "9b6ca8a393e66dc13f915c6f456bdcf496d78fac4995792f7022b7806352d7a4"
checksum = "3f3e569779ad70537f34a670d444ee3d75ae583b2023913f4682814b0979f7e8"
dependencies = [
"arbitrary",
]
[[package]]
name = "cranelift-entity"
version = "0.123.13"
version = "0.123.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "e609d9ba416bc26d774f343295a1d411515248a6a6d83d5f7492a0dd919569fa"
checksum = "2ff53acc85f5c5f7d9315ff133a6671d329a0f04aa2d1a8a2e81d59709ccddcb"
dependencies = [
"cranelift-bitset",
"serde",
@@ -1894,9 +1894,9 @@ dependencies = [
[[package]]
name = "cranelift-frontend"
version = "0.123.13"
version = "0.123.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "90a3a277b1a0aff1123f6bae61c080a4bcb6df964829ed427f98e18dff14257f"
checksum = "ab5976c0ff5bfadf61cd8bda81fea78ee5a07018b9cd03e66c0952c56684928b"
dependencies = [
"cranelift-codegen",
"log",
@@ -1906,15 +1906,15 @@ dependencies = [
[[package]]
name = "cranelift-isle"
version = "0.123.13"
version = "0.123.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "be53dd9b3a4cbeb9ced45c4a543ea8417ccfb334c3ba1cbb2233f4b25fb2531f"
checksum = "77b4f73d2288e9480fd2d1d9ab576394dce4805443d6148c6d819dbf78865ce4"
[[package]]
name = "cranelift-native"
version = "0.123.13"
version = "0.123.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "ca62ab1d9f48cad97da5843b913ccf96c3dfde935af5d750cb5a6d367ccfb262"
checksum = "fe9650c2baf22fa1e2542a5bdd8152616ec2023d929c4cbb450ff677ad8d9c21"
dependencies = [
"cranelift-codegen",
"libc",
@@ -1923,9 +1923,9 @@ dependencies = [
[[package]]
name = "cranelift-srcgen"
version = "0.123.13"
version = "0.123.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "a13b72860f54a2a19d3756bd47575fd8bddeafd6e5bbbf16372cdfebc482628a"
checksum = "4ad4f61ae701d73c326d3df08c366b29ad10f1ba06c245092f217b8d2306746b"
[[package]]
name = "crc"
@@ -2900,7 +2900,7 @@ dependencies = [
"libc",
"option-ext",
"redox_users 0.5.2",
"windows-sys 0.59.0",
"windows-sys 0.61.2",
]
[[package]]
@@ -3333,7 +3333,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "39cab71617ae0d63f51a36d69f866391735b51691dbda63cf6f96d042b63efeb"
dependencies = [
"libc",
"windows-sys 0.52.0",
"windows-sys 0.61.2",
]
[[package]]
@@ -5280,7 +5280,7 @@ dependencies = [
"libc",
"percent-encoding",
"pin-project-lite",
"socket2 0.5.10",
"socket2 0.6.2",
"system-configuration",
"tokio",
"tower-service",
@@ -5549,7 +5549,7 @@ checksum = "3640c1c38b8e4e43584d8df18be5fc6b0aa314ce6ebf51b53313d4306cca8e46"
dependencies = [
"hermit-abi",
"libc",
"windows-sys 0.52.0",
"windows-sys 0.61.2",
]
[[package]]
@@ -6719,7 +6719,7 @@ version = "0.50.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "7957b9740744892f114936ab4a57b3f487491bbeafaf8083688b16841a4240e5"
dependencies = [
"windows-sys 0.59.0",
"windows-sys 0.61.2",
]
[[package]]
@@ -7272,7 +7272,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "7d8fae84b431384b68627d0f9b3b1245fcf9f46f6c0e3dc902e9dce64edd1967"
dependencies = [
"libc",
"windows-sys 0.45.0",
"windows-sys 0.61.2",
]
[[package]]
@@ -8088,9 +8088,9 @@ dependencies = [
[[package]]
name = "pulley-interpreter"
version = "36.0.13"
version = "36.0.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "2662666315cb90dfb4d99a652ee053d4d8598f71c474209e84da031ca56ae5a4"
checksum = "eb0a4b56042e461cc64456650182938e2d1ede98fa0c8a975027416a2809c414"
dependencies = [
"cranelift-bitset",
"log",
@@ -8100,9 +8100,9 @@ dependencies = [
[[package]]
name = "pulley-macros"
version = "36.0.13"
version = "36.0.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "bb9a7d9ed2618f94b6d054aba3eb2768c9b489fe16b4ef8847fbc6ed41b707bb"
checksum = "244667bea2e214273442a71f26adb12b88a41f66718fb2c6eea47c00f0dc325f"
dependencies = [
"proc-macro2",
"quote",
@@ -8199,7 +8199,7 @@ dependencies = [
"quinn-udp",
"rustc-hash 2.1.1",
"rustls",
"socket2 0.5.10",
"socket2 0.6.2",
"thiserror 2.0.18",
"tokio",
"tracing",
@@ -8238,9 +8238,9 @@ dependencies = [
"cfg_aliases",
"libc",
"once_cell",
"socket2 0.5.10",
"socket2 0.6.2",
"tracing",
"windows-sys 0.52.0",
"windows-sys 0.60.2",
]
[[package]]
@@ -8968,6 +8968,17 @@ dependencies = [
"unicode-ident",
]
[[package]]
name = "rufield-adapters"
version = "0.1.0"
dependencies = [
"rufield-core",
"rufield-provenance",
"serde",
"serde_json",
"sha2 0.10.9",
]
[[package]]
name = "rufield-core"
version = "0.1.0"
@@ -9093,7 +9104,7 @@ dependencies = [
"errno",
"libc",
"linux-raw-sys",
"windows-sys 0.52.0",
"windows-sys 0.61.2",
]
[[package]]
@@ -9151,7 +9162,7 @@ dependencies = [
"security-framework",
"security-framework-sys",
"webpki-root-certs",
"windows-sys 0.52.0",
"windows-sys 0.61.2",
]
[[package]]
@@ -11105,7 +11116,7 @@ dependencies = [
"getrandom 0.4.1",
"once_cell",
"rustix",
"windows-sys 0.52.0",
"windows-sys 0.61.2",
]
[[package]]
@@ -12471,9 +12482,9 @@ dependencies = [
[[package]]
name = "wasmtime"
version = "36.0.13"
version = "36.0.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "93d881c5dcff5f230368d84fcf110ca25fe47badc694e7d559c3891492159916"
checksum = "7d05c745dc0978e589ef295958f3130122afc33d96af6bad3f0f06dbe7ac43a8"
dependencies = [
"addr2line",
"anyhow",
@@ -12526,9 +12537,9 @@ dependencies = [
[[package]]
name = "wasmtime-environ"
version = "36.0.13"
version = "36.0.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "a4b25534a3ff9dd844701c2bc997f76cb1f97bf2af0546a7066ae96f49c2e068"
checksum = "9fd1d43cfaa1a0859d2f4fccc15e7e571e2a88b357e81bc88ba6c501b83d925d"
dependencies = [
"anyhow",
"cpp_demangle",
@@ -12553,18 +12564,18 @@ dependencies = [
[[package]]
name = "wasmtime-internal-asm-macros"
version = "36.0.13"
version = "36.0.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "1d02832d760351fb3a1aa99eb8f7b95596c0f4e4e52df1547fcdb295ea5c780c"
checksum = "515dd7158bf1719b41290cd2e6a2a46ec944484146816992f195af3720e49b3f"
dependencies = [
"cfg-if",
]
[[package]]
name = "wasmtime-internal-cache"
version = "36.0.13"
version = "36.0.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "651f8a16b51cde3ee8bd5b775bcedc24b66040d7dca1f13ad855b10c660e1d01"
checksum = "12a53145473629ea40f445235ed95182b76940f00a67c3c9c6c4857dae0ad823"
dependencies = [
"anyhow",
"base64 0.22.1",
@@ -12582,9 +12593,9 @@ dependencies = [
[[package]]
name = "wasmtime-internal-component-macro"
version = "36.0.13"
version = "36.0.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "ba2ed6dbe24607573f7bcc59222f3bc2e7f7d31609466055c67b9484045a374a"
checksum = "dfca017b7daa80ff217c66f105ee20e674d87b7c11dca85bbb9d0146e9f443fb"
dependencies = [
"anyhow",
"proc-macro2",
@@ -12597,15 +12608,15 @@ dependencies = [
[[package]]
name = "wasmtime-internal-component-util"
version = "36.0.13"
version = "36.0.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "e21aadbf677ee3503ef2580ce3c6955508e90a2810e961739b30f79585af254c"
checksum = "1c3e218b51d2ef9eb181499e42c691512c1bc11dd6dc7746807a9b2b9290369c"
[[package]]
name = "wasmtime-internal-cranelift"
version = "36.0.13"
version = "36.0.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "65821bab751956cddfc6ee957beb13a0e2a6cf682050d75dfb7a0228db2ed499"
checksum = "5ba1736927b58e50e741e407da7c037c0250f3e213833a09c89dcd8f73ae2eac"
dependencies = [
"anyhow",
"cfg-if",
@@ -12630,9 +12641,9 @@ dependencies = [
[[package]]
name = "wasmtime-internal-fiber"
version = "36.0.13"
version = "36.0.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "18cf73e5e8d28a2b30d86454430c7dea3b593598dcbbc0ebb927ca2716222d41"
checksum = "7b238e4c20bddb900ec0cb380252d63e8d0644fd94de001119574f5921e895d9"
dependencies = [
"anyhow",
"cc",
@@ -12646,9 +12657,9 @@ dependencies = [
[[package]]
name = "wasmtime-internal-jit-debug"
version = "36.0.13"
version = "36.0.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "4279dc3147ddaa21e5b3d2c0eaff117881c4f937747bdd2379eb361665843bd3"
checksum = "8f259b13685ad51e3dcf58cb69031279ed0d79c25bc3ccc8b50e7160ed04fbfe"
dependencies = [
"cc",
"object",
@@ -12658,9 +12669,9 @@ dependencies = [
[[package]]
name = "wasmtime-internal-jit-icache-coherence"
version = "36.0.13"
version = "36.0.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "a8eb677944201839c0be19b39b0f19dcd663efbcbc05a09c73f26fec7bdf0331"
checksum = "41fed85537936b16460bac352ad149052c025db50467c7bc539dd47b31439374"
dependencies = [
"anyhow",
"cfg-if",
@@ -12670,24 +12681,24 @@ dependencies = [
[[package]]
name = "wasmtime-internal-math"
version = "36.0.13"
version = "36.0.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "db9a153e184878df396a11f8912444531c2e4d0c7a1d9e9a52b30d9853d89cb9"
checksum = "82fff10da41d0d15d90ebba70946a0aa16ed0957ae7b77e0b6d2a46e8221e555"
dependencies = [
"libm",
]
[[package]]
name = "wasmtime-internal-slab"
version = "36.0.13"
version = "36.0.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "b771494bead25e1f0c4c89a9476dd0b65eacca314ed82125f1e197fbc3f0396b"
checksum = "e44a8c097bab08d349d57dce1ab818859fefbe261ab3632b38fe127b1b551108"
[[package]]
name = "wasmtime-internal-unwinder"
version = "36.0.13"
version = "36.0.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "90199caed6925420434a923861d8ad813689ca8533d2c679f805d12e35b40a4b"
checksum = "7f40a57d5e7c221ce56391d7dca0a918ba17ea00185462c7facbf534d7745184"
dependencies = [
"anyhow",
"cfg-if",
@@ -12698,9 +12709,9 @@ dependencies = [
[[package]]
name = "wasmtime-internal-versioned-export-macros"
version = "36.0.13"
version = "36.0.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "ae71687aa834f9cc9eb5b0f97c85184d7dc70b84d32fd8927af0887998a1ba35"
checksum = "e085bfce1cb2089dbeef6e280a5d598666923d3dcd308712fe429fe43c9d19f5"
dependencies = [
"proc-macro2",
"quote",
@@ -12709,9 +12720,9 @@ dependencies = [
[[package]]
name = "wasmtime-internal-winch"
version = "36.0.13"
version = "36.0.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "5d0ba45c0d766dd56257d97702d3284b6f69efdd4c53ca981a0754cc0a139df0"
checksum = "c4916cd526e1ce294984cc5b70264cfc0ca103b41ca665b58728bde250b6b82f"
dependencies = [
"anyhow",
"cranelift-codegen",
@@ -12726,9 +12737,9 @@ dependencies = [
[[package]]
name = "wasmtime-internal-wit-bindgen"
version = "36.0.13"
version = "36.0.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "41a64d5112c06f9d54b41e61f0b757d3a5a52361bf359f01131cc7cb8551ac73"
checksum = "39ad2f9d9c3baa70ee4d157b55b4c08e5dc00f1d80aad3692b1e0806393914ea"
dependencies = [
"anyhow",
"bitflags 2.11.0",
@@ -13377,6 +13388,7 @@ version = "0.1.0"
name = "wifi-densepose-rufield"
version = "0.3.0"
dependencies = [
"rufield-adapters",
"rufield-core",
"rufield-fusion",
"rufield-privacy",
@@ -13430,6 +13442,7 @@ dependencies = [
"futures-util",
"hmac",
"jsonwebtoken",
"mdns-sd",
"midstreamer-attractor",
"midstreamer-temporal-compare",
"opentelemetry-appender-tracing",
@@ -13611,7 +13624,7 @@ version = "0.1.11"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "c2a7b1c03c876122aa43f3020e6c3c3ee5c05081c9a00739faf7503aeba10d22"
dependencies = [
"windows-sys 0.48.0",
"windows-sys 0.61.2",
]
[[package]]
@@ -13622,9 +13635,9 @@ checksum = "712e227841d057c1ee1cd2fb22fa7e5a5461ae8e48fa2ca79ec42cfc1931183f"
[[package]]
name = "winch-codegen"
version = "36.0.13"
version = "36.0.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "82ea9625459ce35d6a4188cf0f07c9095cbb0e5afd86f711d63955bfc4216e64"
checksum = "e826c012c68403725e77adf6b904c2ea809e5d464aaf25aa6eda14559300b3df"
dependencies = [
"anyhow",
"cranelift-assembler-x64",

View File

@@ -123,6 +123,8 @@ members = [
# ADR-324 — clean-room Kooima off-axis (head-coupled perspective) projection.
# Dependency-free native core; wasm-bindgen surface only on wasm32.
"crates/ruview-offaxis",
# ADR-348 — RuForecast extracted to the ruvnet/RuForecast submodule
# (see crates/ruforecast in the exclude list below); path-deps only.
]
# ADR-040: WASM edge crate targets wasm32-unknown-unknown (no_std),
# excluded from workspace to avoid breaking `cargo test --workspace`.
@@ -135,6 +137,12 @@ exclude = [
"crates/wifi-densepose-wasm-edge",
"crates/homecore-plugin-example",
"crates/worldgraph", # ruvnet/worldgraph submodule — its own workspace (geo/worldgraph/worldmodel)
"crates/ruforecast", # ruvnet/RuForecast submodule — its own workspace (ruforecast-core/model/train)
# LOCAL-DEV-ONLY: path-depends on an absolute, unpublished ruvnet/autogenous
# checkout that does not exist in CI. Build directly with
# `cargo build --manifest-path crates/ruforecast-autogenous-bridge/Cargo.toml`
# on a host with that checkout present. See its Cargo.toml/README.
"crates/ruforecast-autogenous-bridge",
]
[workspace.package]
@@ -220,6 +228,7 @@ walkdir = "2.4"
# Hashing (for proof)
sha2 = "0.10"
ed25519-dalek = "2.1"
# CSV logging
csv = "1.3"
@@ -278,6 +287,9 @@ wifi-densepose-wasm = { version = "0.3.0", path = "crates/wifi-densepose-wasm" }
wifi-densepose-mat = { version = "0.3.0", path = "crates/wifi-densepose-mat" }
wifi-densepose-ruvector = { version = "0.3.0", path = "crates/wifi-densepose-ruvector" }
wifi-densepose-worldmodel = { version = "0.3.0", path = "crates/worldgraph/wifi-densepose-worldmodel" }
ruforecast-core = { version = "0.1.0", path = "crates/ruforecast/crates/ruforecast-core" }
ruforecast-model = { version = "0.1.0", path = "crates/ruforecast/crates/ruforecast-model" }
ruforecast-train = { version = "0.1.0", path = "crates/ruforecast/crates/ruforecast-train" }
[profile.release]
lto = true

1
v2/crates/ruforecast Submodule

Submodule v2/crates/ruforecast added at 448c035cc1

View File

@@ -0,0 +1,577 @@
# This file is automatically @generated by Cargo.
# It is not intended for manual editing.
version = 4
[[package]]
name = "agl-types"
version = "0.1.0"
dependencies = [
"serde",
"serde_json",
]
[[package]]
name = "anstream"
version = "1.0.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "824a212faf96e9acacdbd09febd34438f8f711fb84e09a8916013cd7815ca28d"
dependencies = [
"anstyle",
"anstyle-parse",
"anstyle-query",
"anstyle-wincon",
"colorchoice",
"is_terminal_polyfill",
"utf8parse",
]
[[package]]
name = "anstyle"
version = "1.0.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "940b3a0ca603d1eade50a4846a2afffd5ef57a9feac2c0e2ec2e14f9ead76000"
[[package]]
name = "anstyle-parse"
version = "1.0.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "52ce7f38b242319f7cabaa6813055467063ecdc9d355bbb4ce0c68908cd8130e"
dependencies = [
"utf8parse",
]
[[package]]
name = "anstyle-query"
version = "1.1.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "40c48f72fd53cd289104fc64099abca73db4166ad86ea0b4341abe65af83dadc"
dependencies = [
"windows-sys",
]
[[package]]
name = "anstyle-wincon"
version = "3.0.11"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "291e6a250ff86cd4a820112fb8898808a366d8f9f58ce16d1f538353ad55747d"
dependencies = [
"anstyle",
"once_cell_polyfill",
"windows-sys",
]
[[package]]
name = "antibody"
version = "0.1.0"
dependencies = [
"agl-types",
"serde",
"serde_json",
"witness",
]
[[package]]
name = "anyhow"
version = "1.0.104"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "330a5ed07fa54e4702c9d6c4174f74427fc0ef6e214bbd677ae50a5099946470"
[[package]]
name = "base64ct"
version = "1.8.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "2af50177e190e07a26ab74f8b1efbfe2ef87da2116221318cb1c2e82baf7de06"
[[package]]
name = "block-buffer"
version = "0.10.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "3078c7629b62d3f0439517fa394996acacc5cbc91c5a20d8c658e77abd503a71"
dependencies = [
"generic-array",
]
[[package]]
name = "cfg-if"
version = "1.0.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
[[package]]
name = "clap"
version = "4.6.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "473c7e07f409a8d772161724aa8db6a765a2532a70f9667eeb7b49d3d02fbdca"
dependencies = [
"clap_builder",
"clap_derive",
]
[[package]]
name = "clap_builder"
version = "4.6.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "7b48fea5a88e9ae728a2dcbedbfc0e730f7d60da42e1cb049a83c9fb8b789889"
dependencies = [
"anstream",
"anstyle",
"clap_lex",
"strsim",
]
[[package]]
name = "clap_derive"
version = "4.6.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "d012d2b9d65aca7f18f4d9878a045bc17899bba951561ba5ec3c2ba1eed9a061"
dependencies = [
"heck",
"proc-macro2",
"quote",
"syn 3.0.4",
]
[[package]]
name = "clap_lex"
version = "1.1.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "c8d4a3bb8b1e0c1050499d1815f5ab16d04f0959b233085fb31653fbfc9d98f9"
[[package]]
name = "colorchoice"
version = "1.0.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "1d07550c9036bf2ae0c684c4297d503f838287c83c53686d05370d0e139ae570"
[[package]]
name = "const-oid"
version = "0.9.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "c2459377285ad874054d797f3ccebf984978aa39129f6eafde5cdc8315b612f8"
[[package]]
name = "constitution"
version = "0.1.0"
dependencies = [
"agl-types",
"serde",
"serde_json",
"sha2",
]
[[package]]
name = "cpufeatures"
version = "0.2.17"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "59ed5838eebb26a2bb2e58f6d5b5316989ae9d08bab10e0e6d103e656d1b0280"
dependencies = [
"libc",
]
[[package]]
name = "crypto-common"
version = "0.1.7"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "78c8292055d1c1df0cce5d180393dc8cce0abec0a7102adb6c7b1eef6016d60a"
dependencies = [
"generic-array",
"typenum",
]
[[package]]
name = "curve25519-dalek"
version = "4.1.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "97fb8b7c4503de7d6ae7b42ab72a5a59857b4c937ec27a3d4539dba95b5ab2be"
dependencies = [
"cfg-if",
"cpufeatures",
"curve25519-dalek-derive",
"digest",
"fiat-crypto",
"rustc_version",
"subtle",
"zeroize",
]
[[package]]
name = "curve25519-dalek-derive"
version = "0.1.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "f46882e17999c6cc590af592290432be3bce0428cb0d5f8b6715e4dc7b383eb3"
dependencies = [
"proc-macro2",
"quote",
"syn 2.0.119",
]
[[package]]
name = "der"
version = "0.7.10"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "e7c1832837b905bbfb5101e07cc24c8deddf52f93225eee6ead5f4d63d53ddcb"
dependencies = [
"const-oid",
"zeroize",
]
[[package]]
name = "digest"
version = "0.10.7"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "9ed9a281f7bc9b7576e61468ba615a66a5c8cfdff42420a70aa82701a3b1e292"
dependencies = [
"block-buffer",
"crypto-common",
]
[[package]]
name = "ed25519"
version = "2.2.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "115531babc129696a58c64a4fef0a8bf9e9698629fb97e9e40767d235cfbcd53"
dependencies = [
"pkcs8",
"signature",
]
[[package]]
name = "ed25519-dalek"
version = "2.2.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "70e796c081cee67dc755e1a36a0a172b897fab85fc3f6bc48307991f64e4eca9"
dependencies = [
"curve25519-dalek",
"ed25519",
"serde",
"sha2",
"subtle",
"zeroize",
]
[[package]]
name = "envelope"
version = "0.1.0"
dependencies = [
"agl-types",
"antibody",
"constitution",
"evaluator",
"serde",
"serde_json",
"sha2",
"witness",
]
[[package]]
name = "evaluator"
version = "0.1.0"
dependencies = [
"agl-types",
"antibody",
"serde",
]
[[package]]
name = "fiat-crypto"
version = "0.2.9"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "28dea519a9695b9977216879a3ebfddf92f1c08c05d984f8996aecd6ecdc811d"
[[package]]
name = "generic-array"
version = "0.14.7"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "85649ca51fd72272d7821adaf274ad91c288277713d9c18820d8499a7ff69e9a"
dependencies = [
"typenum",
"version_check",
]
[[package]]
name = "getrandom"
version = "0.2.17"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "ff2abc00be7fca6ebc474524697ae276ad847ad0a6b3faa4bcb027e9a4614ad0"
dependencies = [
"cfg-if",
"libc",
"wasi",
]
[[package]]
name = "heck"
version = "0.5.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"
[[package]]
name = "is_terminal_polyfill"
version = "1.70.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "a6cb138bb79a146c1bd460005623e142ef0181e3d0219cb493e02f7d08a35695"
[[package]]
name = "itoa"
version = "1.0.18"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "8f42a60cbdf9a97f5d2305f08a87dc4e09308d1276d28c869c684d7777685682"
[[package]]
name = "libc"
version = "0.2.189"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "3eaf3ede3fee6db1a4c2ee091bf8a8b4dccdc6d17f656fb07896ee72867612f2"
[[package]]
name = "memchr"
version = "2.8.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "cf8baf1c55e62ffcace7a9f06f4bd9cd3f0c4beb022d3b367256b91b87513d98"
[[package]]
name = "once_cell_polyfill"
version = "1.70.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "384b8ab6d37215f3c5301a95a4accb5d64aa607f1fcb26a11b5303878451b4fe"
[[package]]
name = "pkcs8"
version = "0.10.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "f950b2377845cebe5cf8b5165cb3cc1a5e0fa5cfa3e1f7f55707d8fd82e0a7b7"
dependencies = [
"der",
"spki",
]
[[package]]
name = "proc-macro2"
version = "1.0.107"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "985e7ec9bb745e6ce6535b544d84d6cd6f7ad8bd711c398938ae983b91a766d9"
dependencies = [
"unicode-ident",
]
[[package]]
name = "quote"
version = "1.0.47"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "1fbf4db142a473a8d80c26bbf18454ed458bf8d26c8219c331daecfdbd079001"
dependencies = [
"proc-macro2",
]
[[package]]
name = "rand_core"
version = "0.6.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "ec0be4795e2f6a28069bec0b5ff3e2ac9bafc99e6a9a7dc3547996c5c816922c"
dependencies = [
"getrandom",
]
[[package]]
name = "ruforecast-autogenous-bridge"
version = "0.1.0"
dependencies = [
"agl-types",
"anyhow",
"clap",
"constitution",
"envelope",
"serde",
"serde_json",
"sha2",
"witness",
]
[[package]]
name = "rustc_version"
version = "0.4.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "cfcb3a22ef46e85b45de6ee7e79d063319ebb6594faafcf1c225ea92ab6e9b92"
dependencies = [
"semver",
]
[[package]]
name = "semver"
version = "1.0.28"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "8a7852d02fc848982e0c167ef163aaff9cd91dc640ba85e263cb1ce46fae51cd"
[[package]]
name = "serde"
version = "1.0.229"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "4148590afebada386688f18773da617792bf2ef03ffc1e4cbd2b1d45b023e0ba"
dependencies = [
"serde_core",
"serde_derive",
]
[[package]]
name = "serde_core"
version = "1.0.229"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "67dca2c9c51e58a4791a4b1ed58308b39c64224d349a935ab5039aa360942a48"
dependencies = [
"serde_derive",
]
[[package]]
name = "serde_derive"
version = "1.0.229"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "e7a5d71263a5a7d47b41f6b3f06ba276f10cc18b0931f1799f710578e2309348"
dependencies = [
"proc-macro2",
"quote",
"syn 3.0.4",
]
[[package]]
name = "serde_json"
version = "1.0.151"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "c841b55ecdae098c80dcae9cf767f6f8a0c2cdb3416bbef72181df4d0fe73f14"
dependencies = [
"itoa",
"memchr",
"serde",
"serde_core",
"zmij",
]
[[package]]
name = "sha2"
version = "0.10.9"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "a7507d819769d01a365ab707794a4084392c824f54a7a6a7862f8c3d0892b283"
dependencies = [
"cfg-if",
"cpufeatures",
"digest",
]
[[package]]
name = "signature"
version = "2.2.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "77549399552de45a898a580c1b41d445bf730df867cc44e6c0233bbc4b8329de"
dependencies = [
"rand_core",
]
[[package]]
name = "spki"
version = "0.7.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "d91ed6c858b01f942cd56b37a94b3e0a1798290327d1236e4d9cf4eaca44d29d"
dependencies = [
"base64ct",
"der",
]
[[package]]
name = "strsim"
version = "0.11.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "7da8b5736845d9f2fcb837ea5d9e2628564b3b043a70948a3f0b778838c5fb4f"
[[package]]
name = "subtle"
version = "2.6.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "13c2bddecc57b384dee18652358fb23172facb8a2c51ccc10d74c157bdea3292"
[[package]]
name = "syn"
version = "2.0.119"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "872831b642d1a07999a962a351ed35b955ea2cfc8f3862091e2a240a84f17297"
dependencies = [
"proc-macro2",
"quote",
"unicode-ident",
]
[[package]]
name = "syn"
version = "3.0.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "e6275cddf4610d1775e6d1fe9469b2e77d0f39fd98fb7450901b821e0c53649f"
dependencies = [
"proc-macro2",
"quote",
"unicode-ident",
]
[[package]]
name = "typenum"
version = "1.20.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "b6f5e870be6c3b371b77fe0ee0bafb859fa4964b4404c27de1d380043c4dda20"
[[package]]
name = "unicode-ident"
version = "1.0.24"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"
[[package]]
name = "utf8parse"
version = "0.2.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "06abde3611657adf66d383f00b093d7faecc7fa57071cce2578660c9f1010821"
[[package]]
name = "version_check"
version = "0.9.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "0b928f33d975fc6ad9f86c8f283853ad26bdd5b10b7f1542aa2fa15e2289105a"
[[package]]
name = "wasi"
version = "0.11.1+wasi-snapshot-preview1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "ccf3ec651a847eb01de73ccad15eb7d99f80485de043efb2f370cd654f4ea44b"
[[package]]
name = "windows-link"
version = "0.2.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5"
[[package]]
name = "windows-sys"
version = "0.61.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "ae137229bcbd6cdf0f7b80a31df61766145077ddf49416a728b02cb3921ff3fc"
dependencies = [
"windows-link",
]
[[package]]
name = "witness"
version = "0.1.0"
dependencies = [
"ed25519-dalek",
"serde",
"serde_json",
"sha2",
]
[[package]]
name = "zeroize"
version = "1.9.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "e13c156562582aa81c60cb29407084cdb54c4164760106ab78e6c5b0858cf64e"
[[package]]
name = "zmij"
version = "1.0.23"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "29666d0abbfad1e3dc4dcf6144730dd3a3ab225bbbdac83319345b1b44ccfc1b"

View File

@@ -0,0 +1,25 @@
[package]
name = "ruforecast-autogenous-bridge"
version = "0.1.0"
edition = "2021"
publish = false
description = "LOCAL-DEV-ONLY bridge: signs/verifies a Darwin-found RuForecast hyperparameter candidate through Autogenous's regression-candidate promotion path (ruvnet/autogenous, not yet published/vendored). Path-dependency on a sibling local checkout; not part of any release build."
[[bin]]
name = "ruforecast-autogenous-bridge"
path = "src/main.rs"
[dependencies]
anyhow = "1"
clap = { version = "4", features = ["derive"] }
serde = { version = "1", features = ["derive"] }
serde_json = "1"
sha2 = "0.10"
# LOCAL-DEV-ONLY path deps into a sibling, unpublished autogenous checkout.
# Not vendored/submoduled yet; this only builds on a host with this exact
# absolute checkout location (currently: ruvultra). See README.md.
envelope = { path = "/home/ruvultra/projects/autogenous/crates/envelope" }
agl-types = { path = "/home/ruvultra/projects/autogenous/crates/agl-types" }
constitution = { path = "/home/ruvultra/projects/autogenous/crates/constitution" }
witness = { path = "/home/ruvultra/projects/autogenous/crates/witness" }

View File

@@ -0,0 +1,182 @@
//! Independently verify the real-household-data WQL results (two real,
//! differently-split judges) through Autogenous's real regression-candidate
//! promotion path -- a genuine signed verdict, not a self-reported number.
//! LOCAL-DEV-ONLY, mirrors ruforecast-autogenous-bridge/src/main.rs's real
//! envelope::regression usage exactly, but consumes already-measured real
//! WQL numbers instead of running its own synthetic train_and_score.
use agl_types::{Applicability, Authority, Genome, HardGates, Mutation, MutationScope};
use anyhow::Result;
use constitution::{Constitution, RoleKeys};
use envelope::regression::{
artifact_hash, sign_regression_promotion, sign_regression_receipt, verify_regression_promotion,
MetricDirection, RegressionCandidateManifest,
};
use witness::{content_hash, SigningAuthority};
struct RealJudge {
label: &'static str,
corpus_id: String,
sample_count: usize,
candidate_wql: f64,
parent_wql: f64,
}
fn now_unix() -> u64 {
std::time::SystemTime::now()
.duration_since(std::time::UNIX_EPOCH)
.unwrap()
.as_secs()
}
fn main() -> Result<()> {
// Real numbers from two genuinely independent temporal splits of the
// same 6390-sample real household vitals corpus (train_fraction 0.70
// vs 0.50, both with a 90s embargo). "candidate" = the trained model's
// WQL; "parent" = the better of the two trivial baselines on that same
// judge's held-out set (min(last_value, seasonal_naive)), matching this
// session's established `primary` convention throughout.
let judges = vec![
RealJudge {
label: "split-70-30",
corpus_id: "ruforecast-real-home-lab-split-70".into(),
sample_count: 27,
candidate_wql: 0.0513991104899006,
parent_wql: 0.05630054057848733_f64.min(0.10253572536393343),
},
RealJudge {
label: "split-50-50",
corpus_id: "ruforecast-real-home-lab-split-50".into(),
sample_count: 46,
candidate_wql: 0.06704526404505064,
parent_wql: 0.0618358588096424_f64.min(0.054265071040759255),
},
];
let now = now_unix();
let candidate_bytes = b"real-home-lab-default-optimizer-spec-v1".to_vec();
let parent_bytes = b"trivial-baseline-min-last-value-seasonal-naive".to_vec();
let parent_genome_hash = artifact_hash(&parent_bytes);
let judge_keys: Vec<SigningAuthority> = (0..judges.len() as u64)
.map(|i| {
let mut seed = [0u8; 32];
seed[0] = 2;
seed[1..9].copy_from_slice(&i.to_le_bytes());
SigningAuthority::from_seed(&format!("ruforecast-real-judge-{i}"), seed)
})
.collect();
let controller_key = SigningAuthority::from_seed("ruforecast-real-controller", [8u8; 32]);
let constitution = Constitution {
identity: "ruforecast-real-data-promotion".into(),
version: 1,
authority_ceiling: Authority::Governed,
prohibited_effects: vec!["pii_egress".into()],
hard_gates: HardGates::default(),
signers: vec!["ruforecast-real-bridge-operator".into()],
pinned_keys: RoleKeys {
judges: judge_keys.iter().map(SigningAuthority::public_hex).collect(),
controllers: vec![controller_key.public_hex()],
},
effective_at: now.saturating_sub(1),
};
let parent_genome = Genome {
hash: parent_genome_hash.clone(),
identity: "ruforecast-real-data-parent".into(),
constitution: constitution.hash(),
capability_ceiling: Authority::Governed,
hard_invariants: vec![],
lineage: vec![],
};
let mutation = Mutation {
id: format!("ruforecast-real-data-candidate-{now}"),
parent_genome_hash: parent_genome.hash.clone(),
scope: MutationScope::ApplicationCode,
requested_authority: Authority::Governed,
applicability: Applicability::default(),
preserved_invariants: vec![],
rollback_target: Some(parent_genome.hash.clone()),
expires_at: Some(now + 3600),
signature: None,
};
let manifest = RegressionCandidateManifest::from_parts(
mutation,
&candidate_bytes,
"weighted_quantile_loss",
MetricDirection::LowerIsBetter,
vec![],
vec![],
vec![],
);
let candidate_hash = manifest.candidate_hash();
let parent_hash_for_receipts = content_hash(&parent_genome.hash);
let receipts: Vec<_> = judges
.iter()
.zip(judge_keys.iter())
.map(|(j, judge)| {
sign_regression_receipt(
judge,
&candidate_hash,
&parent_hash_for_receipts,
&j.corpus_id,
j.sample_count,
j.candidate_wql,
j.parent_wql,
"ruforecast-real-data-verify-v1",
now,
)
})
.collect();
let promotion_envelope = sign_regression_promotion(
&controller_key,
&constitution.hash(),
&candidate_hash,
&receipts,
&format!("ruforecast-real-data-{now}"),
now,
3600,
);
let min_samples = judges.iter().map(|j| j.sample_count).min().unwrap_or(1);
let margin = 0.01_f64;
let rejections = verify_regression_promotion(
&constitution,
&parent_genome,
&manifest,
&receipts,
&promotion_envelope,
&[],
judges.len(),
min_samples,
margin,
now,
);
let decision = if rejections.is_empty() { "PROMOTE" } else { "REJECT" };
let report = serde_json::json!({
"decision": decision,
"candidate_hash": candidate_hash,
"constitution_hash": constitution.hash(),
"judges": judges.iter().map(|j| serde_json::json!({
"label": j.label,
"corpus_id": j.corpus_id,
"sample_count": j.sample_count,
"candidate_wql": j.candidate_wql,
"parent_wql": j.parent_wql,
"candidate_beats_parent_by": j.parent_wql - j.candidate_wql,
})).collect::<Vec<_>>(),
"min_judges": judges.len(),
"min_samples": min_samples,
"non_inferiority_margin": margin,
"rejections": rejections.iter().map(|r| format!("{r:?}")).collect::<Vec<_>>(),
});
println!("{}", serde_json::to_string_pretty(&report)?);
Ok(())
}

View File

@@ -0,0 +1 @@
{"learning_rate": 0.0009293, "weight_decay": 0.01, "gradient_clip_norm": 0.1, "batch_size": 1, "epochs": 1}

View File

@@ -0,0 +1 @@
{"learning_rate": 0.001, "weight_decay": 0.0001, "gradient_clip_norm": 1.0, "batch_size": 8, "epochs": 60}

View File

@@ -0,0 +1 @@
{"learning_rate": 0.00002977567315122687, "weight_decay": 4.0937479376727585e-11, "gradient_clip_norm": 4.745827605560193, "batch_size": 26, "epochs": 356}

View File

@@ -0,0 +1,383 @@
//! LOCAL-DEV-ONLY bridge from RuForecast's `evaluate` CLI into Autogenous's
//! regression-candidate promotion path (`envelope::regression`).
//!
//! Not a production path: it path-depends on a sibling, unpublished
//! `ruvnet/autogenous` checkout (see Cargo.toml), and the "judges" here are
//! real independent train+evaluate replays over genuinely distinct synthetic
//! corpora (different `--seed` per judge), not independent human/adversarial
//! review — see the module doc in `envelope::regression` for why that
//! distinction matters and why `min_judges`/`min_samples`/margin are passed
//! explicitly rather than assumed.
//!
//! Darwin's own promotion gate (`harness/ruview/flywheel/ruforecast/gate.mjs`)
//! still runs first and is unchanged; this is an additional, stronger,
//! cryptographically-checked verification step layered on top of a candidate
//! Darwin already found — defense in depth, not a gate replacement.
use std::{
path::{Path, PathBuf},
process::Command,
time::{SystemTime, UNIX_EPOCH},
};
use agl_types::{Applicability, Authority, Genome, HardGates, Mutation, MutationScope};
use anyhow::{bail, Context, Result};
use clap::Parser;
use constitution::{Constitution, RoleKeys};
use envelope::regression::{
artifact_hash, sign_regression_promotion, sign_regression_receipt, verify_regression_promotion,
MetricDirection, RegressionCandidateManifest,
};
use serde::{Deserialize, Serialize};
use witness::{content_hash, SigningAuthority};
#[derive(Parser, Debug)]
#[command(
name = "ruforecast-autogenous-bridge",
about = "LOCAL-DEV-ONLY: sign/verify a RuForecast hyperparameter candidate through Autogenous's regression-candidate promotion path"
)]
struct Cli {
/// Path to the built `ruforecast` binary (ruforecast-train's CLI).
#[arg(long)]
ruforecast_bin: PathBuf,
/// Candidate hyperparameter genome, JSON: {learning_rate, weight_decay, gradient_clip_norm, batch_size, epochs}.
#[arg(long)]
candidate_genome: PathBuf,
/// Parent (baseline) hyperparameter genome, same JSON shape.
#[arg(long)]
parent_genome: PathBuf,
/// Independent judges: full train+evaluate replays on genuinely distinct synthetic corpora.
#[arg(long, default_value_t = 2)]
judges: u64,
/// Synthetic training windows per corpus.
#[arg(long, default_value_t = 24)]
train_windows: u64,
/// Synthetic held-out windows per corpus.
#[arg(long, default_value_t = 8)]
test_windows: u64,
/// Scratch directory for per-judge corpora/artifacts (created fresh; must not already exist).
#[arg(long)]
work_dir: PathBuf,
/// Non-inferiority margin on weighted quantile loss (lower-is-better; a candidate must
/// beat its parent by at least this much on every judge's receipt to be admissible).
#[arg(long, default_value_t = 0.01)]
margin: f64,
/// Minimum held-out samples a receipt must report (floor stated honestly for this
/// fixture's scale, not the detector domain's unrelated 1000-sample bar).
#[arg(long, default_value_t = 4)]
min_samples: usize,
}
#[derive(Clone, Debug, Serialize, Deserialize)]
struct HyperparamGenome {
learning_rate: f64,
weight_decay: f64,
gradient_clip_norm: f64,
batch_size: u16,
epochs: u16,
}
struct JudgeMeasurement {
seed: u64,
corpus_id: String,
sample_count: usize,
candidate_metric: f64,
parent_metric: f64,
}
fn now_unix() -> Result<u64> {
Ok(SystemTime::now().duration_since(UNIX_EPOCH)?.as_secs())
}
fn run_ruforecast(bin: &Path, args: &[&str], label: &str) -> Result<String> {
let output = Command::new(bin)
.args(args)
.output()
.with_context(|| format!("spawning ruforecast for {label}"))?;
if !output.status.success() {
bail!(
"ruforecast {label} failed (exit {:?}):\nstdout: {}\nstderr: {}",
output.status.code(),
String::from_utf8_lossy(&output.stdout),
String::from_utf8_lossy(&output.stderr)
);
}
Ok(String::from_utf8_lossy(&output.stdout).into_owned())
}
/// Prepare a synthetic corpus + train + evaluate one hyperparameter genome
/// against it, returning (weighted_quantile_loss, n_test_windows).
fn train_and_score(
bin: &Path,
genome: &HyperparamGenome,
corpus_dir: &Path,
seed: u64,
train_windows: u64,
test_windows: u64,
) -> Result<(f64, usize)> {
std::fs::create_dir_all(corpus_dir.parent().unwrap_or(corpus_dir))?;
run_ruforecast(
bin,
&[
"prepare-synthetic-dataset",
"--directory",
corpus_dir.to_str().context("non-utf8 path")?,
"--seed",
&seed.to_string(),
"--train-windows",
&train_windows.to_string(),
"--test-windows",
&test_windows.to_string(),
"--learning-rate",
&genome.learning_rate.to_string(),
"--weight-decay",
&genome.weight_decay.to_string(),
"--gradient-clip-norm",
&genome.gradient_clip_norm.to_string(),
"--batch-size",
&genome.batch_size.to_string(),
"--epochs",
&genome.epochs.to_string(),
],
"prepare-synthetic-dataset",
)?;
let artifacts_dir = corpus_dir.join("artifacts");
run_ruforecast(
bin,
&[
"train-local",
"--request",
corpus_dir.join("train-local.toml").to_str().context("non-utf8 path")?,
"--dataset-root",
corpus_dir.to_str().context("non-utf8 path")?,
"--output",
artifacts_dir.to_str().context("non-utf8 path")?,
],
"train-local",
)?;
let candidate_mpk = artifacts_dir.join("synthetic-dataset").join("model.mpk");
let eval_stdout = run_ruforecast(
bin,
&[
"evaluate",
"--candidate",
candidate_mpk.to_str().context("non-utf8 path")?,
"--test-jsonl",
corpus_dir.join("test.jsonl").to_str().context("non-utf8 path")?,
"--seasonal-period",
"12",
],
"evaluate",
)?;
let report: serde_json::Value =
serde_json::from_str(&eval_stdout).context("parsing evaluate JSON output")?;
let wql = report["model"]["weighted_quantile_loss"]
.as_f64()
.context("evaluate output missing model.weighted_quantile_loss")?;
let n = report["n_test_windows"]
.as_u64()
.context("evaluate output missing n_test_windows")? as usize;
Ok((wql, n))
}
fn main() -> Result<()> {
let cli = Cli::parse();
if cli.work_dir.exists() {
bail!(
"--work-dir {} already exists; pass a fresh directory",
cli.work_dir.display()
);
}
if cli.judges == 0 {
bail!("--judges must be at least 1 (state min_judges: 1 honestly rather than 0)");
}
std::fs::create_dir_all(&cli.work_dir)?;
let candidate: HyperparamGenome = serde_json::from_str(
&std::fs::read_to_string(&cli.candidate_genome).context("reading --candidate-genome")?,
)
.context("parsing --candidate-genome JSON")?;
let parent: HyperparamGenome = serde_json::from_str(
&std::fs::read_to_string(&cli.parent_genome).context("reading --parent-genome")?,
)
.context("parsing --parent-genome JSON")?;
let mut measurements = Vec::with_capacity(cli.judges as usize);
for judge_index in 0..cli.judges {
// Genuine corpus independence: each judge trains+evaluates BOTH
// genomes against its own freshly-generated synthetic corpus (same
// seed for candidate/parent within a judge, so the comparison is
// apples-to-apples on that judge's held-out set; different seed
// ACROSS judges, so disagreement between judges is a real signal
// about generalization, not a re-run of identical arithmetic).
let seed = 1000 + judge_index * 97;
let judge_dir = cli.work_dir.join(format!("judge-{judge_index}"));
let (candidate_wql, candidate_n) = train_and_score(
&cli.ruforecast_bin,
&candidate,
&judge_dir.join("candidate"),
seed,
cli.train_windows,
cli.test_windows,
)
.with_context(|| format!("judge {judge_index}: scoring candidate genome"))?;
let (parent_wql, parent_n) = train_and_score(
&cli.ruforecast_bin,
&parent,
&judge_dir.join("parent"),
seed,
cli.train_windows,
cli.test_windows,
)
.with_context(|| format!("judge {judge_index}: scoring parent genome"))?;
if candidate_n != parent_n {
bail!(
"judge {judge_index}: candidate/parent test-window counts disagree ({candidate_n} vs {parent_n}) — corpus was not actually shared"
);
}
measurements.push(JudgeMeasurement {
seed,
corpus_id: format!("ruforecast-synthetic-seed-{seed}"),
sample_count: candidate_n,
candidate_metric: candidate_wql,
parent_metric: parent_wql,
});
}
let now = now_unix()?;
let candidate_bytes = serde_json::to_vec(&candidate)?;
let parent_bytes = serde_json::to_vec(&parent)?;
let parent_genome_hash = artifact_hash(&parent_bytes);
let judge_keys: Vec<SigningAuthority> = (0..cli.judges)
.map(|i| {
let mut seed = [0u8; 32];
seed[0] = 1;
seed[1..9].copy_from_slice(&i.to_le_bytes());
SigningAuthority::from_seed(&format!("ruforecast-judge-{i}"), seed)
})
.collect();
let controller_key = SigningAuthority::from_seed("ruforecast-controller", [9u8; 32]);
let constitution = Constitution {
identity: "ruforecast-hpo-promotion".into(),
version: 1,
authority_ceiling: Authority::Governed,
prohibited_effects: vec!["pii_egress".into()],
hard_gates: HardGates::default(),
signers: vec!["ruforecast-bridge-operator".into()],
pinned_keys: RoleKeys {
judges: judge_keys.iter().map(SigningAuthority::public_hex).collect(),
controllers: vec![controller_key.public_hex()],
},
effective_at: now.saturating_sub(1),
};
let parent_genome = Genome {
hash: parent_genome_hash.clone(),
identity: "ruforecast-hyperparameter-genome".into(),
constitution: constitution.hash(),
capability_ceiling: Authority::Governed,
hard_invariants: vec![],
lineage: vec![],
};
let mutation = Mutation {
id: format!("ruforecast-hpo-candidate-{now}"),
parent_genome_hash: parent_genome.hash.clone(),
scope: MutationScope::ApplicationCode,
requested_authority: Authority::Governed,
applicability: Applicability::default(),
preserved_invariants: vec![],
rollback_target: Some(parent_genome.hash.clone()),
expires_at: Some(now + 3600),
signature: None,
};
let manifest = RegressionCandidateManifest::from_parts(
mutation,
&candidate_bytes,
"weighted_quantile_loss",
MetricDirection::LowerIsBetter,
vec![],
vec![],
vec![],
);
let candidate_hash = manifest.candidate_hash();
let parent_hash_for_receipts = content_hash(&parent_genome.hash);
let receipts: Vec<_> = measurements
.iter()
.zip(judge_keys.iter())
.map(|(m, judge)| {
sign_regression_receipt(
judge,
&candidate_hash,
&parent_hash_for_receipts,
&m.corpus_id,
m.sample_count,
m.candidate_metric,
m.parent_metric,
"ruforecast-autogenous-bridge-v1",
now,
)
})
.collect();
let promotion_envelope = sign_regression_promotion(
&controller_key,
&constitution.hash(),
&candidate_hash,
&receipts,
&format!("ruforecast-hpo-{now}"),
now,
3600,
);
let min_samples = cli.min_samples.min(
measurements
.iter()
.map(|m| m.sample_count)
.min()
.unwrap_or(cli.min_samples),
);
let rejections = verify_regression_promotion(
&constitution,
&parent_genome,
&manifest,
&receipts,
&promotion_envelope,
&[],
cli.judges as usize,
min_samples,
cli.margin,
now,
);
let decision = if rejections.is_empty() { "PROMOTE" } else { "REJECT" };
let report = serde_json::json!({
"decision": decision,
"candidate_hash": candidate_hash,
"constitution_hash": constitution.hash(),
"judges": measurements.iter().map(|m| serde_json::json!({
"seed": m.seed,
"corpus_id": m.corpus_id,
"sample_count": m.sample_count,
"candidate_wql": m.candidate_metric,
"parent_wql": m.parent_metric,
"candidate_beats_parent_by": m.parent_metric - m.candidate_metric,
})).collect::<Vec<_>>(),
"min_judges": cli.judges,
"min_samples": min_samples,
"non_inferiority_margin": cli.margin,
"rejections": rejections.iter().map(|r| format!("{r:?}")).collect::<Vec<_>>(),
});
println!("{}", serde_json::to_string_pretty(&report)?);
if decision == "REJECT" {
std::process::exit(1);
}
Ok(())
}

View File

@@ -19,6 +19,10 @@ rufield-core = { version = "0.1.0", path = "../../../vendor/rufield/crates/rufie
rufield-provenance = { version = "0.1.0", path = "../../../vendor/rufield/crates/rufield-provenance" }
rufield-privacy = { version = "0.1.0", path = "../../../vendor/rufield/crates/rufield-privacy" }
rufield-fusion = { version = "0.1.0", path = "../../../vendor/rufield/crates/rufield-fusion" }
# ADR-262 P4 second modality: UltrasonicReplayAdapter parses, validates and
# signs BatVu range profiles upstream, so RuView only has to decide what it is
# willing to put on a wire. Same pure-Rust constraint as the four above.
rufield-adapters = { version = "0.1.0", path = "../../../vendor/rufield/crates/rufield-adapters" }
serde = { workspace = true }
serde_json = { workspace = true }

View File

@@ -145,6 +145,21 @@ pub fn snapshot_to_field_event(snap: &SensingSnapshot, signer: &Signer) -> Field
features: build_features(snap, range_m),
labels: build_labels(snap),
privacy_class: class,
// ── fields added upstream since the previous submodule pin ─────────
//
// Each empty for its own reason rather than because a default was
// convenient. `track_id`: this bridge emits per-cycle snapshots, not
// tracks, and a stable per-person identifier is exactly what §3.3
// warns about. `attributes`: nothing `features` and `labels` do not
// already carry, and an empty map is omitted from the wire.
// `identity_evidence` / `channel_sounding_provenance`: both are
// structurally BLE-only — `validate_evidence_at` rejects either on any
// other modality — so for `wifi_csi` they are not unset, they are
// unrepresentable.
track_id: None,
attributes: Default::default(),
identity_evidence: None,
channel_sounding_provenance: None,
};
// ── 3. Provenance (real sha256 over the tensor bytes) ───────────────────
@@ -166,6 +181,15 @@ pub fn snapshot_to_field_event(snap: &SensingSnapshot, signer: &Signer) -> Field
vendor: "esp32".to_string(),
device_id: snap.node_id.clone(),
placement: "unknown".to_string(),
// Optional sensor pose, added upstream. Left unset on purpose: a CSI
// link has no boresight and no surveyed position here, and §6 is
// explicit that this surface makes no validated room-coordinate claim
// (`field_localize`). A placeholder pose would be inventing exactly
// that claim. The ultrasonic path DOES set these, because a handheld
// scanner genuinely knows where it was pointing.
coordinate_frame: None,
position_m: None,
orientation_xyzw: None,
clock_domain: "local".to_string(),
};

View File

@@ -71,12 +71,14 @@
pub mod bridge;
pub mod privacy;
pub mod snapshot;
pub mod ultrasonic;
pub use bridge::{snapshot_egress_class, snapshot_to_field_event};
pub use privacy::{apply_demotion_floor, egress_class, map_privacy};
pub use snapshot::{
RuViewPrivacyClass, SensingClass, SensingFeatures, SensingSnapshot, SignalField,
};
pub use ultrasonic::{ScanError, ScanSource, UltrasonicScan, ULTRASONIC_EGRESS_CLASS};
// Re-export the rufield surface a bridge consumer needs, so callers depend on
// one crate.

View File

@@ -0,0 +1,233 @@
//! ADR-262 **P4, second modality**: ultrasonic range profiles on the field
//! surface.
//!
//! Until now RuView's `/api/field` and `/ws/field` have carried exactly one
//! modality — WiFi CSI, through [`crate::bridge`]. ADR-262 §4 lists multi-
//! modality as P4 and leaves the choice of the second one open (§8 question 5
//! asks whether it should be `rvcsi`, "making RuField the convergence point for
//! both vendored sensing runtimes").
//!
//! This is a different answer to that question, and the reason is that it costs
//! almost nothing: `rufield-adapters` now ships
//! [`UltrasonicReplayAdapter`](rufield_adapters::UltrasonicReplayAdapter), the
//! first adapter for `Modality::Ultrasonic` — registry code 7, which had sat in
//! the §8 registry since v0.1 with nothing implementing it. It parses, validates
//! and **signs** BatVu recordings upstream. RuView does not have to build any of
//! that; it has to decide what it is willing to put on a wire.
//!
//! # What BatVu is, in one paragraph
//!
//! [BatVu](https://github.com/ruvnet/batvu) is a handheld sonar that runs in a
//! phone browser: a 17.520.5 kHz chirp out of the speaker, a matched filter
//! over the microphone, and a **range profile** — echo amplitude against
//! distance along one beam. One microphone, so it measures range and infers
//! bearing only from where the operator was pointing. That asymmetry is why the
//! beam is carried as sensor *pose* rather than as an angle axis.
//!
//! # Why this module exists at all, given the adapter does the work
//!
//! Because RuView's egress rule is **stricter** than RuField's default guard,
//! and the difference has to be structural rather than a runtime refusal.
//!
//! The adapter offers two output modes. [`UltrasonicOutput::RangeProfile`] is
//! the full per-bin frame, classified `P0`, which
//! [`network_egress_allowed`](crate::network_egress_allowed) holds edge-local —
//! correctly, but *silently*, as a dropped event at the end of a pipeline that
//! did all the parsing and signing first.
//! [`UltrasonicOutput::CoarseProfile`] is a 32-bin max-pooled reduction,
//! classified `P1`, which is egress-safe.
//!
//! So this module does not offer the choice. It configures the adapter for the
//! coarse mode and says why, because a consumer cannot un-coarsen a coarse
//! profile and a policy expressed in the *shape of the data* cannot be
//! misconfigured later. The egress gate still runs — belt and braces, and it is
//! asserted by a test — but by then there is nothing left for it to catch.
//!
//! # Honesty (ADR-262 §0 / §6)
//!
//! Same posture as P1, plus one more caveat that is BatVu's rather than ours:
//!
//! 1. **Replay, not live.** A file, not a streaming phone.
//! 2. **Every current BatVu recording is its own simulator's output**, so the
//! events carry `synthetic: true` and are fusable only under
//! [`TrustPolicy::simulation`](rufield_provenance::TrustPolicy::simulation).
//! `captured_replay()` and `production()` reject them outright, as they
//! should. When a real device recording exists it declares
//! `device_capture` and this module refuses it unless the caller has asked
//! for that source explicitly — a recording cannot talk its way up a trust
//! tier by relabelling itself.
//! 3. **No accuracy is claimed.** The detections are CFAR outputs at a
//! documented false-alarm rate. That is an operating point, not validated
//! accuracy against surveyed ground truth.
//! 4. **Nothing here says a person is present.** The adapter deliberately
//! declines to populate the `presence` feature that would light up the
//! shipped `person_present` rule: one transducer pair cannot distinguish a
//! person from a coat over the back of a chair. The visible consequence is
//! that ultrasonic events currently produce no fused inferences at all, and
//! `ultrasonic_gates.rs` asserts that rather than papering over it.
//!
//! # What this does NOT do
//!
//! It does not touch the running server. P1 shipped as a library before P3
//! wired it in, and this follows the same staging: a tested translation with
//! its own gates, reviewable on its own, with the surface change as a separate
//! change once the shape is agreed. [`UltrasonicScan::egress_events`] returns
//! exactly what `FieldSurface::emit` would need to broadcast.
use rufield_adapters::{
UltrasonicConfig, UltrasonicOutput, UltrasonicReplayAdapter, UltrasonicSource,
};
use rufield_core::{FieldEvent, PrivacyClass};
use crate::network_egress_allowed;
/// Which recordings a deployment is willing to accept.
///
/// Mirrors [`UltrasonicSource`] rather than re-exporting it, so a caller does
/// not have to depend on `rufield-adapters` to make the choice — the bridge
/// stays the single coupling point (ADR-262 §5.4).
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum ScanSource {
/// Rendered by BatVu's acoustic simulator. Events are `synthetic: true`.
/// The safe default: it cannot be mistaken for a measurement.
Simulated,
/// Captured from a real phone microphone. Events are `synthetic: false`
/// and are eligible for captured-replay trust once the sensor key is
/// enrolled.
DeviceCapture,
}
impl From<ScanSource> for UltrasonicSource {
fn from(s: ScanSource) -> Self {
match s {
ScanSource::Simulated => UltrasonicSource::Simulated,
ScanSource::DeviceCapture => UltrasonicSource::DeviceCapture,
}
}
}
/// Errors from loading a BatVu recording.
#[derive(Debug, Clone, PartialEq)]
pub enum ScanError {
/// The recording failed the adapter's parser. Carries its message, which
/// names the offending line.
Parse(String),
/// Calibration could not be established.
Calibrate(String),
}
impl std::fmt::Display for ScanError {
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
match self {
ScanError::Parse(m) => write!(f, "ultrasonic recording rejected: {m}"),
ScanError::Calibrate(m) => write!(f, "ultrasonic calibration failed: {m}"),
}
}
}
impl std::error::Error for ScanError {}
/// A loaded BatVu scan, ready to put on the field surface.
#[derive(Debug)]
pub struct UltrasonicScan {
adapter: UltrasonicReplayAdapter,
calibration_id: String,
}
impl UltrasonicScan {
/// Load a `.ultrasonic.jsonl` recording.
///
/// `zone_id` is the room the scan was taken in and lands on every
/// observation. `accept` declares which source the deployment will take; a
/// recording declaring anything else is **refused**, in both directions, so
/// neither is a silent reinterpretation.
///
/// Calibration runs here rather than being optional. The receipt id ends up
/// on every tensor, so an event that skipped it would be one nobody could
/// later ask "under what calibration was this measured".
pub fn load(text: &str, zone_id: &str, accept: ScanSource) -> Result<Self, ScanError> {
let config = UltrasonicConfig {
accept: accept.into(),
zone_id: zone_id.to_string(),
placement: "handheld".to_string(),
// Not a caller's choice. See the module docs: the raw per-bin frame
// is P0 and would be dropped by the egress gate after all the work
// of parsing and signing it. Coarsening at the source makes the
// policy a property of the data instead of a property of a check
// somebody could later reorder.
output: UltrasonicOutput::CoarseProfile,
};
let mut adapter = UltrasonicReplayAdapter::from_jsonl_with(text, config)
.map_err(|e| ScanError::Parse(e.to_string()))?;
let receipt = adapter
.calibrate(zone_id)
.map_err(|e| ScanError::Calibrate(e.to_string()))?;
Ok(UltrasonicScan {
adapter,
calibration_id: receipt.calibration_id,
})
}
/// Pings in the recording.
#[must_use]
pub fn ping_count(&self) -> usize {
self.adapter.ping_count()
}
/// The sensor identity the whole recording belongs to.
///
/// This is the key RuField's replay watermark and trust registry are both
/// keyed on, so it has to be stable across scans — the adapter refuses a
/// recording whose device changes midway.
#[must_use]
pub fn device_id(&self) -> &str {
self.adapter.device_id()
}
/// The calibration receipt every tensor in this scan cites.
#[must_use]
pub fn calibration_id(&self) -> &str {
&self.calibration_id
}
/// Every event in the recording, signed and validated by the adapter.
///
/// Includes events that the egress gate would refuse. Use this for an
/// edge-local consumer; use [`egress_events`](Self::egress_events) for
/// anything that reaches a network.
pub fn events(&mut self) -> Result<Vec<FieldEvent>, ScanError> {
self.adapter
.collect_events()
.map_err(|e| ScanError::Parse(e.to_string()))
}
/// Only the events RuView will put on the wire.
///
/// Runs the same [`network_egress_allowed`] gate the CSI path runs, with
/// `identity_bound: false` — an ultrasonic scan has no identity to bind, and
/// hard-coding it rather than plumbing a flag means there is no argument a
/// caller can pass that turns the P4/P5 consent exception on. There is no
/// consent story for a room scan.
///
/// In the coarse mode configured by [`load`](Self::load) this should drop
/// nothing, and `coarse_scan_passes_the_egress_gate_intact` asserts it. The
/// gate stays because a policy that is only enforced where it never fires
/// is a policy nobody notices removing.
pub fn egress_events(&mut self) -> Result<Vec<FieldEvent>, ScanError> {
Ok(self
.events()?
.into_iter()
.filter(|e| network_egress_allowed(e.observation.privacy_class, false))
.filter(|e| network_egress_allowed(e.tensor.privacy_class, false))
.collect())
}
}
/// The privacy class every event from [`UltrasonicScan`] carries.
///
/// `P1` — a derived non-identity feature. Stated as a constant so a test can
/// pin it: if the adapter's default output mode ever changes upstream, that is
/// a submodule bump which silently moves data from edge-local to network-eligible
/// or back, and it should fail a build here rather than change behaviour in a
/// deployment.
pub const ULTRASONIC_EGRESS_CLASS: PrivacyClass = PrivacyClass::P1;

View File

@@ -0,0 +1,72 @@
{"timestamp":1756162800,"source":"simulated","device_id":"batvu-reference-01","beam":[0,-0.9063078,-0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000181,0.0000199,0.0000296,0.0000423,0.0000753,0.0000649,0.0000353,0.0000546,0.0000678,0.0000341,0.0000214,0.0000261,0.0000025,0,0.0000408,0.0000561,0.0000694,0.000075,0.0000335,0.0000171,0.0000264,0.0000162,0.0000437,0.0000641,0.0000422,0.0000274,0.0000622,0.0000561,0.0000389,0.0000256,0.0000256,0.0000336,0.0000499,0.0000442,0.000032,0.0000312,0.000026,1e-7,0.0000226,0.0000252,0.0000028,0.0000261,0.0000394,0.0000286,0.0000096,0.0000236,0.0000383,0.0000509,0.0000553,0.0000331,0.0000366,0.0000671,0.0000645,0.0000557,0.0000436,0.0000296,0.000048,0.0000668,0.000063,0.0000546,0.0000595,0.0000492,0.0000152,0.0000373,0.0000449,0.0000455,0.0000443,0.0000361,0,0,0.0000078,0.0000151,0.0000314,0.000043,0.0000475,0.0000642,0.0000715,0.0000608,0.0000681,0.0000857,0.0000821,0.000071,0.0000648,0.0000468,0.000028,0.0000339,0.0000276,0.0000145,0.0000421,0.0000414,0.0000401,0.0000571,0.0000586,0.000055,0.0000516,0.0000447,0.0000028,0.0000136,0.0000216,0.0000224,0.0000319,0.000039,0.0000351,0.0000387,0.0000407,0.0000267,0.0000305,0.0000395,0.0000837,0.0002284,0.0005318,0.0008717,0.0012896,0.0017333,0.0021146,0.0023917,0.002502,0.0024966,0.0022837,0.0019285,0.0014871,0.0010271,0.0006496,0.0003871,0.0002045,0.0001008,0.000048,0.0000215,0.0000333,0.000042,0.0000393,0.0000339,0.0000273,0.0000061,0.0000087,0.0000163,0.0000142,0.000024,0.0000383,0.0000374,0.0000325,0.0000312,0.0000253,0.000021,0.000034,0.0000338,0.0000267,0.0000299,0.0000287,0.0000189,0.0000248,0.0000286,0.0000259,0.0000201,0.0000126,0.0000194,0.000028,0.0000307,0.0000208,0.0000246,0.0000386,0.0000424,0.0000538,0.0000652,0.0000682,0.000071,0.0000711,0.0000604,0.0000396,0.0000518,0.0000507,0.0000421,0.0000445,0.0000523,0.0000613,0.0000637,0.0000625,0.000031,0.0000224,0.0000334,0.0000361,0.000036,0.0000328,0.0000176,0.0000346,0.0000436,0.0000489,0.0000621,0.0000721,0.0000706,0.0000654,0.0000587,0.0000371,0.0000126,0.0000276,0.0000282,0.0000264,0.0000287,0.0000309,0.0000343,0.0000343,0.0000291,0.0000099,0.0000091,0.0000197,0.00004,0.0000807,0.0001038,0.0001159,0.0001184,0.0001168,0.0000931,0.000065,0.0000468,0.0000272,0.0000153,0.0000089,0.0000039,0.0000154,0.0000304,0.0000358,0.0000466,0.0000534,0.0000501,0.0000388,0.0000299,0.000022,0.0000039,0.000011,0.0000115,0.0000082,0.0000154,0.0000285,0.0000404,0.0000538,0.0000608,0.0000715,0.0000906,0.0001001,0.0000993],"detections":[{"range_m":2.738708,"snr_db":27.6382,"width_m":0.171607}],"noise_floor":0.000035574,"blast_amplitude":0.2699276,"saturated":false}
{"timestamp":1756162800.0666666,"source":"simulated","device_id":"batvu-reference-01","beam":[-0.2345697,-0.8754261,-0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.000015,0.0000089,0,0,0.000089,0.0000914,0.0000789,0.0000676,0.0000659,0.0000243,0.0000868,0.0001153,0.000114,0.0001099,0.000106,0.0000423,0.0000332,0.0000434,0.0000195,0.0000231,0.0000387,0.0000207,0.0000158,0.0000348,0.0000244,0.000021,0.0000282,0.0000132,0.0000135,0.0000372,0.0000279,0.0000311,0.0000595,0.0000549,0.000041,0.0000647,0.0000696,0.0000486,0.0000368,0.0000261,0,0.000009,0.0000247,0.0000214,0.0000195,0.0000208,3e-7,0.0000031,0.0000266,0.0000293,0.0000309,0.0000322,0.0000096,0.0000074,0.0000165,0.0000075,0,0.000014,0.0000135,0.0000094,0.0000145,0.0000164,0.0000259,0.0000441,0.0000457,0.000042,0.0000543,0.0000535,0.00003,0.0000227,0.0000283,0.0000249,0.0000316,0.0000368,0.0000249,0.0000226,0.0000224,0.0000139,0.0000704,0.0001232,0.0001372,0.0001373,0.0001306,0.0001013,0.0000682,0.0000659,0.0000625,0.0000553,0.0000557,0.0000444,0.0000153,0.0000205,0.0000213,0.0000153,0.0000236,0.0000257,0.0000023,0.0000282,0.0000495,0.000053,0.0000524,0.0000455,0.0000169,0.0000103,0.0000215,0.0000288,0.0000394,0.0000453,0.0000356,0.0000184,0.0000387,0.0001307,0.000308,0.0005791,0.000915,0.0013178,0.001738,0.0021372,0.0023362,0.0023766,0.002347,0.0021355,0.0017912,0.0013838,0.0009609,0.0006085,0.0003179,0.0001483,0.0000463,0.0000625,0.0000754,0.0000766,0.000074,0.0000525,0.0000623,0.0000756,0.0000733,0.0000667,0.0000621,0.0000499,0.0000173,0.0000342,0.0000408,0.0000422,0.000045,0.0000433,0.0000375,0.0000514,0.0000515,0.0000467,0.0000439,0.0000416,0.0000231,0.0000308,0.0000393,0.0000365,0.0000301,0.0000232,0.0000115,0.0000125,0.0000128,0.0000031,0.0000106,0.0000192,0.0000168,0.0000104,0.0000114,0.000015,0.0000168,0.0000167,0.0000096,0.0000121,0.0000199,0.0000185,0.0000086,0.000019,0.0000235,0.0000232,0.0000212,0.0000162,0,0,0.0000065,0.0000182,0.0000374,0.0000434,0.0000399,0.0000356,0.0000352,0.0000236,0.0000175,0.000039,0.0000387,0.0000281,0.0000186,0.0000464,0.0000682,0.0000816,0.0000806,0.00007,0.0000621,0.0000568,0.0000361,0.0000274,0.0000427,0.0000524,0.0000542,0.0000517,0.0000304,0.000031,0.0000406,0.0000476,0.0000588,0.0000662,0.0000636,0.0000658,0.0000712,0.0000694,0.0000719,0.0000738,0.0000683,0.0000537,0.0000446,0.000036,0.0000185,0.000034,0.0000521,0.0000737,0.0001029,0.0001097,0.0001134,0.0001164,0.0001167,0.0001012,0.0000801,0.000053,0.0000265,0.000049,0.0000546,0.0000478],"detections":[{"range_m":2.789841,"snr_db":24.6641,"width_m":0.175182}],"noise_floor":0.000036094,"blast_amplitude":0.2699713,"saturated":false}
{"timestamp":1756162800.1333332,"source":"simulated","device_id":"batvu-reference-01","beam":[-0.4531539,-0.7848856,-0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000107,0.0000092,0.0000054,0.0000319,0.0000529,0.0000336,0.0000449,0.0000597,0.0000454,0.0000401,0.000043,0,0,0.0000292,0.0000302,0.0000299,0.0000274,0,0,0.000014,8e-7,0,0.0000325,0.000039,0.0000403,0.0000393,0.0000075,0.0000057,0.0000261,0.0000191,0.0000126,0.0000664,0.000079,0.000078,0.0000689,0.0000493,0,0.0000153,0.000019,0,0.0000342,0.0000674,0.0000892,0.0001157,0.0001282,0.0001137,0.0001122,0.0001335,0.0001255,0.0001118,0.0000959,0.0000562,0.0000098,0.000025,0.0000228,0.0000331,0.0000731,0.0000778,0.0000782,0.0000753,0.0000614,0.0000131,0.0000275,0.0000358,0.0000444,0.0000561,0.0000588,0.000043,0.000052,0.0000589,0.0000449,0.0000388,0.0000413,0.0000237,0.0000217,0.0000372,0.0000333,0.0000229,0.0000342,0.0000412,0.0000566,0.0000728,0.0000704,0.0000707,0.0000838,0.0000782,0.0000584,0.0000621,0.0000617,0.0000469,0.0000328,0.0000216,0.0000049,0.0000102,0.0000112,0,0.0000096,0.0000256,0.0000288,0.0000363,0.0000415,0.0000355,0.0000397,0.0000463,0.0000396,0.0000304,0.0000322,0.0000244,0.0000394,0.0000893,0.000175,0.0003531,0.0006367,0.0010626,0.0014721,0.0018693,0.0021585,0.0023104,0.0023256,0.0022716,0.0020312,0.0016707,0.0011803,0.0007773,0.0004581,0.0002469,0.000115,0.0000542,0.0000392,0.0000269,0.0000174,0.0000149,0.000013,0.0000306,0.000053,0.0000531,0.0000464,0.0000314,0.0000103,0.0000248,0.0000304,0.0000274,0.0000101,0.0000289,0.0000291,0.0000235,0.0000273,0.0000287,0.000017,0.0000193,0.0000246,0.0000178,0.0000099,0.0000147,0.0000209,0.0000316,0.0000399,0.0000377,0.0000526,0.0000684,0.0000689,0.0000678,0.0000634,0.000051,0.0000343,0.0000511,0.0000521,0.0000523,0.0000521,0.0000483,0.0000339,0.0000492,0.0000545,0.0000544,0.0000532,0.0000516,0.0000331,0.0000192,0.000009,0.0000197,0.0000524,0.0000672,0.0000673,0.0000621,0.000049,0.0000233,0.0000015,0.0000075,0.0000162,0.0000336,0.0000514,0.0000519,0.0000516,0.0000505,0.0000463,0.0000303,0.0000298,0.0000294,0.0000366,0.0000527,0.0000569,0.0000561,0.0000535,0.000047,0.0000228,0.0000187,0.0000312,0.0000341,0.0000399,0.0000501,0.0000566,0.0000621,0.0000627,0.0000511,0.0000294,0.0000211,0.0000385,0.000067,0.0000843,0.0000838,0.0000753,0.0000635,0.0000583,0.000073,0.0000972,0.0000997,0.0001034,0.000113,0.0001155,0.0001154,0.0001202,0.0001221,0.000113,0.000096,0.0000862,0.0000761],"detections":[{"range_m":2.839001,"snr_db":26.9682,"width_m":0.171607}],"noise_floor":0.000039797,"blast_amplitude":0.2699136,"saturated":false}
{"timestamp":1756162800.1999998,"source":"simulated","device_id":"batvu-reference-01","beam":[-0.6408564,-0.6408564,-0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000059,0.000016,0.0000391,0.0000304,0.0000275,0.0000405,0.000048,0.0000092,0.0000051,0.0000066,0,0.0000055,0.0000304,0.0000319,0.0000407,0.0000451,3e-7,0.0000369,0.0000846,0.0000844,0.0000774,0.0000648,0.0000099,0,0.00002,0.0000104,0,0.0000102,0.0000085,2e-7,0.0000284,0.0000443,0.000056,0.0000602,0.000058,0.0000048,0.0000181,0.0000194,0,0.0000252,0.0000429,0.0000409,0.0000365,0.0000312,0,0.0000189,0.0000338,0.0000216,0.0000338,0.0000826,0.000098,0.0001114,0.0001178,0.0001017,0.0000797,0.0000945,0.0000892,0.0000525,0.0000229,0.0000059,0.0000072,0.0000175,0.0000204,0.000022,0.0000273,0.0000273,0.0000273,0.0000342,0.0000354,0.0000102,0.0000249,0.0000448,0.0000448,0.0000432,0.000039,0.0000135,0.0000305,0.0000573,0.0000639,0.0000747,0.0000839,0.000077,0.0000657,0.0000614,0.0000493,0.0000233,0.0000468,0.0000464,0.000045,0.0000457,0.0000426,0.0000261,0.0000548,0.0000645,0.0000598,0.0000451,0.0000241,0.0000105,0.0000201,0.0000226,0.0000128,0.0000289,0.0000381,0.0000341,0.0000409,0.0000601,0.0000702,0.0000791,0.0000799,0.0000692,0.0001842,0.0004023,0.000701,0.0011004,0.0015592,0.0020509,0.0023468,0.0024764,0.0024758,0.002352,0.0020757,0.0017056,0.0012796,0.0008843,0.0005136,0.0002869,0.0001566,0.0000978,0.0000556,0.000042,0.0000503,0.0000451,0.0000501,0.0000558,0.0000467,0.0000262,0.0000108,0.0000227,0.0000289,0.0000303,0.0000224,0.0000043,0.0000173,0.0000172,0.0000087,0.0000096,0.0000207,0.0000358,0.0000543,0.000058,0.0000518,0.0000429,0.0000407,0.0000408,0.0000493,0.0000521,0.0000413,0.0000354,0.0000405,0.0000344,0.0000235,0.0000409,0.0000549,0.0000699,0.0000794,0.0000756,0.0000604,0.0000456,0.0000257,0.0000083,0.0000085,0.0000142,0.0000285,0.0000431,0.0000453,0.000032,0.0000254,0.0000276,0.0000318,0.0000433,0.0000512,0.0000554,0.0000614,0.0000619,0.0000464,0.0000273,0.0000166,0.0000114,0.0000275,0.0000437,0.0000424,0.0000355,0.0000273,0.000019,0.0000143,0.0000168,0.0000146,0.000001,0.0000028,0.0000024,0,0.0000174,0.0000235,0.0000234,0.0000203,0.0000184,0.0000159,0.0000256,0.0000324,0.000037,0.0000502,0.0000657,0.0000689,0.0000689,0.0000647,0.0000445,0.0000181,0.0000122,0.0000264,0.0000448,0.0000553,0.0000538,0.0000478,0.0000516,0.0000509,0.0000509,0.0000625,0.0000625,0.0000623,0.0000666,0.0000674,0.0000574,0.0000558,0.0000597,0.0000654,0.0000764,0.0000807,0.0000761],"detections":[{"range_m":2.797382,"snr_db":24.5471,"width_m":0.175182}],"noise_floor":0.000036665,"blast_amplitude":0.2699939,"saturated":false}
{"timestamp":1756162800.2666664,"source":"simulated","device_id":"batvu-reference-01","beam":[-0.7848856,-0.4531539,-0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000405,0.0000231,0.0000103,0.0000028,0.0000041,0.0000017,0,0.0000034,0.0000293,0.0000222,0.0000178,0.0000242,0.0000077,0,0.0000552,0.000076,0.0000849,0.0000848,0.0000213,0,0.0000214,0.000009,0,0.0000174,0.0000185,0.0000219,0.0000331,0.00002,0.0000323,0.0000675,0.0000642,0.0000616,0.0000635,0.0000518,0.0000168,0.0000491,0.0000584,0.000075,0.0001006,0.0001033,0.0000741,0.0000642,0.0000677,0.0000406,0.0000064,0.0000445,0.0000639,0.0000773,0.0000807,0.000053,0.000022,0.0000346,0.0000334,0.0000402,0.0000523,0.0000466,0.0000554,0.0000668,0.0000606,0.0000492,0.0000742,0.000072,0.0000618,0.0000683,0.0000684,0.0000527,0.0000467,0.0000431,0.0000118,0.000024,0.0000317,0.0000222,0.0000089,0.000025,0.0000304,0.0000314,0.0000312,0.0000105,0.0000197,0.0000338,0.0000299,0.0000422,0.000056,0.0000502,0.0000317,0.0000157,0.0000346,0.0000485,0.0000514,0.0000372,7e-7,0.0000405,0.0000515,0.0000675,0.0000931,0.0000997,0.0000903,0.0000864,0.000088,0.0000721,0.0000858,0.0001071,0.0001094,0.0001033,0.0000795,0.0001798,0.0003957,0.0007041,0.0010949,0.0015653,0.0021246,0.002463,0.0026268,0.0026347,0.0025376,0.0022396,0.0018326,0.0013884,0.0008683,0.0005239,0.0002748,0.0001002,0.0000493,0.0000559,0.0000494,0.0000388,0.0000329,0.0000086,0.0000336,0.0000601,0.0000669,0.0000671,0.0000633,0.000037,0.0000306,0.0000409,0.000038,0.0000391,0.0000605,0.0000635,0.0000623,0.0000514,0.0000224,0.000021,0.0000405,0.00004,0.0000279,0.0000247,0.0000227,0.0000077,0,0.0000012,0.0000069,0.0000337,0.0000526,0.0000531,0.0000503,0.000042,0.0000182,0.000005,0.0000157,0.0000158,0.0000158,0.0000166,0.0000098,0.0000129,0.0000215,0.0000201,0.0000246,0.0000409,0.0000407,0.0000443,0.0000547,0.0000545,0.0000509,0.0000552,0.0000573,0.0000645,0.0000759,0.000078,0.0000703,0.0000651,0.0000619,0.0000409,0.0000154,0.0000106,0.0000115,0.0000111,0.0000148,0.0000149,0.0000265,0.0000444,0.0000451,0.0000443,0.0000406,0.0000312,0.0000191,0.0000212,0.0000204,0.0000229,0.0000319,0.0000311,0.0000224,0.0000142,0.0000099,0.0000075,0.0000259,0.0000382,0.0000448,0.0000464,0.0000463,0.0000392,0.0000515,0.0000587,0.0000527,0.0000476,0.000058,0.0000638,0.0000718,0.0000799,0.0000789,0.0000866,0.0001,0.0001043,0.0001094,0.0001105,0.0001067,0.000087,0.0000742,0.0000669,0.000048,0.00003,0.0000198,0.0000291,0.0000408,0.0000454,0.0000567,0.0000821,0.0001006,0.0001033],"detections":[{"range_m":2.672119,"snr_db":22.7478,"width_m":0.171607}],"noise_floor":0.000041468,"blast_amplitude":0.2700291,"saturated":false}
{"timestamp":1756162800.333333,"source":"simulated","device_id":"batvu-reference-01","beam":[-0.8754261,-0.2345697,-0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000563,0.0000578,0.000044,0.0000295,0.0000313,0.0000237,0.0000392,0.0000435,0.0000057,0.0000116,0.0000399,0.0000364,0.0000344,0.0000486,0.0000576,0.0000779,0.0000925,0.0000674,0.0000542,0.0000651,0.0000383,0.0000125,0.0000111,0.0000016,0.0000089,0.0000346,0.0000246,0.0000092,0.000031,0.0000265,0.0000068,0.0000284,0.0000578,0.0000677,0.0000727,0.0000714,0.0000348,0.0000561,0.0000682,0.0000589,0.0000535,0.0000532,0.0000168,0.0000267,0.000047,0.000042,0.0000348,0.0000347,0.0000202,0.0000217,0.000032,0.0000242,0.0000148,0.000015,0.0000071,0.0000178,0.0000556,0.0000605,0.000065,0.0000685,0.0000656,0.0000385,0.0000675,0.0000707,0.000062,0.0000498,0.0000368,0.000009,0.0000328,0.0000477,0.0000429,0.0000371,0.000034,0.0000297,0.0000481,0.0000615,0.0000564,0.0000707,0.0000894,0.0000869,0.0000808,0.0000763,0.000063,0.0000368,0.0000444,0.0000401,0.0000356,0.0000795,0.0000975,0.0000997,0.0000947,0.0000684,0.0000912,0.0002457,0.0004662,0.0007986,0.0012554,0.0017706,0.0023533,0.0027192,0.0028794,0.0028824,0.0027701,0.0024729,0.0020279,0.0015114,0.0010175,0.00052,0.0002222,0.000065,0.0000863,0.0000996,0.0001088,0.0001068,0.0000827,0.0000711,0.0000641,0.0000403,0.0000384,0.0000432,0.0000479,0.0000577,0.0000593,0.0000454,0.0000503,0.0000573,0.000053,0.0000465,0.0000514,0.0000549,0.0000641,0.0000689,0.0000602,0.000047,0.000045,0.0000391,0.000028,0.0000362,0.0000343,0.0000454,0.0000655,0.0000661,0.0000587,0.0000501,0.000041,0.0000286,0.0000529,0.00006,0.0000573,0.0000437,0.0000246,0.0000126,0.0000164,0.0000186,0.0000248,0.0000374,0.0000438,0.0000384,0.0000447,0.0000603,0.0000658,0.0000725,0.0000761,0.0000697,0.000049,0.0000314,0.0000226,0.0000425,0.0000716,0.0000842,0.0000954,0.0001046,0.000106,0.0000927,0.0000948,0.0000963,0.0000852,0.0000725,0.0000603,0.0000365,0.0000238,0.00003,0.0000386,0.0000583,0.0000731,0.0000728,0.000066,0.0000526,0.0000244,0.0000032,0.0000131,0.0000125,0.0000099,0.0000096,0.0000157,0.0000293,0.0000395,0.0000385,0.0000307,0.0000378,0.00004,0.0000339,0.000025,0.0000235,0.00004,0.0000513,0.0000523,0.0000356,0.0000105,0.0000268,0.0000342,0.0000393,0.0000406,0.0000318,0.000021,0.0000292,0.0000277,0.0000204,0.0000139,0.0000089,1e-7,0.0000082,0.0000079,0.0000019,0.0000208,0.0000284,0.0000374,0.0000503,0.0000549,0.000062,0.0000767,0.0000841,0.0000841,0.0000893,0.0000932,0.0000916],"detections":[{"range_m":2.523483,"snr_db":23.0173,"width_m":0.171607}],"noise_floor":0.000043196,"blast_amplitude":0.2700235,"saturated":false}
{"timestamp":1756162800.3999996,"source":"simulated","device_id":"batvu-reference-01","beam":[-0.9063078,0,-0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000048,0.0000161,0.000028,0.0000519,0.0000378,0,0.0000459,0.0000792,0.0000638,0.0000399,0.000042,0.000055,0.0000621,0.0000623,0,0.0000502,0.0000767,0.0000709,0.0000859,0.0001049,0.0000837,0.0000495,0.000024,0.0000267,0.0000541,0.0000746,0.0000596,0.0000723,0.0001127,0.00011,0.0001169,0.0001289,0.0001188,0.0000697,0.0000364,0.0000378,0.0000422,0.0000699,0.0000751,0.0000653,0.0000665,0.0000672,0.0000293,0.0000143,0.0000262,0.0000211,0.0000262,0.0000396,0.0000346,0.0000328,0.0000309,4e-7,0,0.0000042,1e-7,0.0000065,0.0000157,0.0000111,0.0000163,0.0000382,0.0000353,0.0000326,0.0000596,0.0000626,0.0000527,0.0000405,0.0000312,0.0000024,0.000028,0.0000385,0.0000349,0.0000275,0.0000204,0.0000166,0.0000351,0.0000491,0.0000545,0.0000708,0.0000835,0.0000768,0.0000564,0.0000403,0.0000109,0.0000141,0.000032,0.0000305,0.0000373,0.0000502,0.0000453,0.000046,0.0000766,0.000081,0.0001334,0.0003069,0.0006491,0.0010525,0.0015427,0.0020397,0.0024858,0.0028079,0.0029123,0.0029008,0.0026483,0.0022399,0.00172,0.0012037,0.0007759,0.0004453,0.0002076,0.0000613,0.0000752,0.000095,0.0001005,0.000092,0.000069,0.0000682,0.0000662,0.000039,0.0000157,0.0000122,0.0000193,0.0000268,0.0000288,0.0000189,0.0000412,0.0000547,0.000057,0.0000564,0.0000521,0.0000454,0.0000743,0.000104,0.0001103,0.0001111,0.0001091,0.0000872,0.0000564,0.0000387,0.000025,0.000005,0.0000037,0,0.0000038,0.0000272,0.0000302,0.0000299,0.0000319,0.0000381,0.0000669,0.0001117,0.0001414,0.0001557,0.0001576,0.000154,0.0001145,0.0000837,0.0000751,0.0000674,0.0000631,0.0000616,0.0000484,0.0000346,0.0000424,0.0000396,0.0000307,0.0000206,0.0000125,0.0000246,0.0000537,0.0000647,0.0000735,0.0000819,0.0000812,0.0000787,0.0000817,0.000082,0.0000618,0.000051,0.0000445,0.0000211,0.0000049,0.0000097,0.0000197,0.0000432,0.0000555,0.0000571,0.0000571,0.0000553,0.0000398,0.0000192,0.0000134,0.0000209,0.0000413,0.0000648,0.0000689,0.0000689,0.0000648,0.0000532,0.0000339,0.0000425,0.000041,0.0000256,0.0000132,0.0000168,0.0000164,0.0000119,0.0000071,0.0000108,0.0000175,0.0000276,0.000037,0.0000439,0.0000448,0.0000303,0.000027,0.0000406,0.0000435,0.0000468,0.0000507,0.0000472,0.0000387,0.0000327,0.000024,0.0000107,0.0000071,0.0000048,0,0.0000128,0.0000143,0.0000247,0.0000423,0.0000466,0.000045,0.0000394,0.0000357,0.0000269,0.000035,0.0000458,0.0000541],"detections":[{"range_m":2.461116,"snr_db":25.0505,"width_m":0.171607}],"noise_floor":0.000041282,"blast_amplitude":0.2699688,"saturated":false}
{"timestamp":1756162800.4666662,"source":"simulated","device_id":"batvu-reference-01","beam":[-0.8754261,0.2345697,-0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0001007,0.0000987,0.0000863,0.0000664,0.0000462,0.0000233,0.000014,0.0000355,0.0000505,0.0000225,0.0000574,0.0000811,0.0000748,0.0000674,0.0000721,0.0000359,0.0000279,0.0000252,0,0,0.0000171,0.0000287,0.0000334,0.0000335,0,0,0.0000156,0.0000138,0.0000228,0.0000401,0.0000254,0.0000021,0.0000262,0.0000278,0.000028,0.0000266,0.0000229,0.0000187,0.0000321,0.0000328,0.0000129,0.0000322,0.0000392,0.000023,0.0000597,0.0000762,0.0000726,0.0000639,0.0000518,0.0000103,0.0000154,0.0000309,0.0000185,0.0000383,0.0000663,0.0000626,0.0000502,0.0000658,0.0000714,0.0000785,0.0000822,0.0000719,0.0000444,0.0000501,0.0000493,0.0000259,0.0000577,0.0000703,0.0000764,0.0000806,0.0000814,0.0000564,0.000048,0.0000512,0.0000283,0.0000093,0.0000202,0.0000317,0.000041,0.0000445,0.0000293,0.000005,0.0000072,0.0000016,0,0.0000518,0.0001501,0.0003633,0.0007963,0.0012585,0.0017948,0.0023257,0.0027246,0.0029443,0.0029718,0.0029149,0.0025351,0.0020552,0.0015256,0.0010027,0.0005828,0.0002979,0.0001144,0.0000195,0.000023,0.0000117,0.0000076,0.0000454,0.0000672,0.0000908,0.0001135,0.0001143,0.0001181,0.0001189,0.000107,0.0000708,0.0000399,0.0000183,0.0000111,0.000021,0.0000201,0.0000156,0.0000345,0.0000428,0.0000455,0.0000506,0.0000517,0.0000375,0.0000402,0.0000447,0.0000351,0.0000199,0.0000275,0.0000462,0.0000667,0.0000795,0.0000783,0.000089,0.0001034,0.0001022,0.0000989,0.0001091,0.000108,0.0001048,0.0001032,0.0000984,0.0000762,0.0000626,0.0000538,0.0000339,0.0000272,0.0000286,0.0000185,0.0000298,0.0000573,0.0000733,0.0000842,0.0000869,0.0000755,0.0000655,0.0000631,0.0000504,0.0000307,0.0000195,0.0000106,0.0000035,0.0000053,7e-7,0.0000022,0.000021,0.0000362,0.0000724,0.0001204,0.0001428,0.0001485,0.0001474,0.0001341,0.0000883,0.0000644,0.0000613,0.0000497,0.0000403,0.0000339,0.0000185,0.0000276,0.0000417,0.0000463,0.0000475,0.0000473,0.0000359,0.0000257,0.0000362,0.0000353,0.0000325,0.0000273,0.0000146,0,0.0000145,0.0000239,0.0000357,0.0000405,0.0000381,0.0000219,0.0000202,0.0000221,0.0000185,0.000024,0.0000252,0.0000157,0.0000086,0.0000049,0.0000092,0.0000199,0.0000264,0.0000215,0.0000203,0.0000301,0.0000359,0.0000443,0.000051,0.0000483,0.000044,0.0000488,0.0000451,0.0000321,0.0000288,0.0000343,0.0000425,0.0000535,0.0000531,0.0000524,0.0000588,0.0000601,0.0000501,0.0000384,0.0000284,0.0000297,0.0000517,0.0000616,0.0000608],"detections":[{"range_m":2.325592,"snr_db":24.8955,"width_m":0.171607}],"noise_floor":0.000040942,"blast_amplitude":0.2700495,"saturated":false}
{"timestamp":1756162800.5333328,"source":"simulated","device_id":"batvu-reference-01","beam":[-0.7848856,0.4531539,-0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000015,0,4e-7,0.0000093,0.0000231,0.0000069,0,0,0.000029,0.0000325,0.0000378,0.0000391,0,0.0000227,0.0000617,0.0000691,0.0000763,0.0000785,0.0000259,0.0000252,0.0000582,0.0000476,0.0000217,0.0000349,0.0000511,0.0000657,0.000074,0.000052,0.0000216,0.0000521,0.0000434,0.0000286,0.0000362,0.0000344,0.000063,0.0001062,0.0001126,0.0000889,0.0000725,0.0000611,0.0000074,0.0000146,0.0000344,0.0000323,0.0000211,0.0000245,0.0000323,0.0000386,0.0000396,0.0000091,0,0.0000081,0,0.0000106,0.0000498,0.0000529,0.0000527,0.000049,0.0000318,0,0.0000018,0,0,0.000023,0.0000426,0.0000644,0.0000845,0.000085,0.0000693,0.0000757,0.0000774,0.0000475,0.0000147,0.0000487,0.0000679,0.0000868,0.0000938,0.0000795,0.000057,0.0000913,0.0002564,0.0005318,0.0009276,0.0014055,0.0019416,0.0024494,0.0028096,0.0029862,0.0029954,0.0028453,0.0024681,0.0019665,0.0014301,0.0009187,0.0005256,0.0002656,0.0000589,0.0000545,0.0000766,0.000077,0.0000729,0.0000626,0.0000304,0.0000129,0.0000177,0.0000125,0.0000446,0.000079,0.0000853,0.000085,0.0000749,0.0000339,0.0000344,0.0000609,0.0000604,0.0000557,0.0000569,0.0000539,0.000036,0.0000662,0.0000709,0.0000701,0.0000639,0.0000576,0.000037,0.000047,0.0000508,0.0000453,0.0000425,0.0000465,0.0000493,0.0000676,0.0000832,0.000082,0.0000822,0.0000871,0.0000816,0.0000739,0.0000677,0.0000517,0.0000213,0.000025,0.0000242,0.0000216,0.0000202,0.0000173,0.0000095,0.0000373,0.0000395,0.0000371,0.000026,0.0000086,0.0000214,0.0000265,0.0000265,0.000011,0.0000218,0.0000258,0.0000168,0.0000087,0.0000177,0.0000209,0.0000267,0.000029,0.0000198,0.0000125,0.0000313,0.0000368,0.0000413,0.0000451,0.0000406,0.0000397,0.0000496,0.0000486,0.0000389,0.0000423,0.0000446,0.0000411,0.0000408,0.0000394,0.0000177,0.0000283,0.00005,0.0000625,0.000075,0.0000782,0.0000701,0.0000626,0.0000627,0.000055,0.0000497,0.0000589,0.0000613,0.0000727,0.0000828,0.0000798,0.0000632,0.000042,0.00004,0.0000668,0.000085,0.000085,0.0000773,0.0000679,0.0000568,0.0000269,0.0000254,0.0000333,0.0000333,0.0000335,0.0000354,0.0000279,0.0000178,0.0000081,0.0000022,0.0000017,0.0000136,0.000025,0.0000351,0.0000405,0.0000367,0.0000301,0.0000359,0.0000327,0.0000211,0.0000246,0.0000295,0.0000304,0.0000292,0.0000183,0,0.0000065,0.0000077,0.0000039,0.0000126,0.0000166,0.0000163,0.0000313,0.0000417,0.0000426],"detections":[{"range_m":2.211216,"snr_db":24.445,"width_m":0.175182}],"noise_floor":0.000037341,"blast_amplitude":0.2700116,"saturated":false}
{"timestamp":1756162800.5999994,"source":"simulated","device_id":"batvu-reference-01","beam":[-0.6408564,0.6408564,-0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.000077,0.0000774,0.0000539,0.0000356,0.0000518,0.0000537,0.0000735,0.0000783,0.0000395,0.0000436,0.0000563,0.0000131,0.0000342,0.0000668,0.0000634,0.0000477,0.0000287,0.0000554,0.0000808,0.0000915,0.0000581,0.0000258,0.0000518,0.0000413,0.0000187,0.0000031,0,0,0.0000574,0.0000707,0.0000767,0.0000769,0.0000725,0.0000139,0.0000462,0.0000531,0.0000444,0.0000404,0.0000454,0.0000324,0.0000324,0.0000346,0.0000261,0.0000373,0.0000415,0.0000185,0.0000191,0.0000472,0.0000436,0.0000362,0.000028,4e-7,1e-7,0.0000254,0.0000269,0.0000333,0.0000392,0.0000303,0.0000136,0.0000469,0.0000533,0.0000591,0.0000661,0.0000639,0.000037,0.0000453,0.000051,0.0000412,0.000056,0.0000701,0.000065,0.0000589,0.0000548,0.0000294,0.000017,0.00005,0.0000639,0.00007,0.0000707,0.0000532,0.0000385,0.0000837,0.000169,0.000367,0.0007705,0.0011934,0.0016805,0.0021657,0.0025404,0.0027689,0.0028171,0.0027894,0.0024745,0.0020375,0.0015322,0.0010193,0.0006042,0.0003234,0.0001384,0.0000265,0.0000519,0.0000531,0.0000508,0.0000451,0.0000323,0.0000367,0.0000542,0.0000525,0.0000494,0.0000475,0.0000383,0.0000218,0.0000378,0.0000392,0.0000431,0.0000493,0.0000476,0.0000425,0.0000593,0.0000632,0.0000549,0.0000421,0.000027,0.0000146,0.0000277,0.0000328,0.0000259,0.0000358,0.0000458,0.0000401,0.0000317,0.0000386,0.0000369,0.0000353,0.000033,0.0000204,0,0.000003,7e-7,0.000013,0.0000434,0.0000532,0.0000564,0.000057,0.0000545,0.0000472,0.0000547,0.0000559,0.0000414,0.0000456,0.0000515,0.0000457,0.0000395,0.0000369,0.0000222,0.0000269,0.0000397,0.0000384,0.0000325,0.0000417,0.0000469,0.0000515,0.0000534,0.0000472,0.0000365,0.0000509,0.0000502,0.0000451,0.0000373,0.0000255,0.000005,0.0000077,0.0000167,0.0000301,0.0000464,0.0000496,0.0000464,0.0000516,0.0000538,0.0000411,0.0000194,0.0000212,0.0000319,0.0000365,0.0000378,0.0000295,0.000019,0.0000183,0.00003,0.0000526,0.0000748,0.0000766,0.0000759,0.0000703,0.0000576,0.000032,0.0000312,0.0000408,0.0000546,0.000065,0.0000661,0.0000515,0.0000519,0.0000558,0.0000542,0.000048,0.0000386,0.0000185,0.0000095,0.000013,0.0000073,0.0000053,0.000008,0.0000053,0.0000119,0.0000192,0.0000171,0.000015,0.000023,0.0000215,0.0000146,0.0000073,0.0000017,0,0.0000274,0.0000523,0.0000796,0.0001026,0.0001064,0.0001017,0.0000916,0.000081,0.0000522,0.0000302,0.0000338,0.0000388],"detections":[{"range_m":2.328964,"snr_db":25.6745,"width_m":0.171607}],"noise_floor":0.000037396,"blast_amplitude":0.269958,"saturated":false}
{"timestamp":1756162800.666666,"source":"simulated","device_id":"batvu-reference-01","beam":[-0.4531539,0.7848856,-0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000223,0.0000222,0.0000191,0.0000163,0.0000189,0.0000106,0.0000046,0.0000086,0.0000323,0.0000401,0.0000561,0.0000623,0.0000353,0.0000418,0.0000479,0,0.0000179,0.0000599,0.0000685,0.0000752,0.0000779,0.0000388,0.0000346,0.0000668,0.0000577,0.0000416,0.0000261,0.0000049,0.0000219,0.0000433,0.0000298,0.0000247,0.000063,0.0000602,0.0000461,0.0000322,0.0000412,0.0000749,0.0001205,0.0001274,0.0001166,0.0001093,0.0001075,0.0000635,0.0000197,0.000036,0.0000565,0.0000785,0.0000878,0.0000696,0.0000467,0.0000483,0.0000357,0.0000218,0.0000087,0.0000159,0.0000226,0.0000241,0.0000139,0.0000202,0.000038,0.000034,0.0000169,0.0000095,0.0000153,0.0000297,0.0000438,0.0000429,0.0000275,0.0000569,0.0000674,0.0000606,0.0000447,0.0000251,0.0000169,0.0000284,0.0000328,0.0000201,0.0000379,0.0000675,0.0000819,0.0000951,0.0001018,0.0000906,0.0000799,0.0000913,0.0000866,0.0000657,0.0000481,0.0000285,0.0000025,0.0000318,0.0000532,0.0000655,0.0000663,0.0000555,0.0001433,0.0003896,0.0007306,0.0011688,0.0016709,0.0021404,0.0025433,0.0026819,0.0026838,0.0025411,0.0022067,0.0017629,0.0012745,0.0008196,0.0004659,0.000175,0.0000294,0.0000558,0.0000554,0.0000438,0.0000278,0.0000185,0.0000532,0.0000947,0.0001053,0.0001072,0.0001069,0.0001021,0.0000665,0.0000291,0.0000327,0.0000577,0.0000806,0.000089,0.0000837,0.0000734,0.0000617,0.000027,0.0000139,0.0000269,0.0000251,0.0000362,0.0000556,0.0000554,0.0000507,0.0000443,0.0000316,0.0000138,0.0000127,0.0000107,0.0000045,0.0000232,0.0000288,0.0000423,0.0000602,0.0000633,0.0000535,0.0000389,0.0000301,0.0000177,0.0000138,0.0000121,0.0000049,0.0000169,0.000028,0.0000278,0.0000376,0.0000472,0.000046,0.0000443,0.0000465,0.0000418,0.0000404,0.0000534,0.0000514,0.000041,0.0000366,0.0000413,0.0000534,0.0000656,0.0000676,0.0000566,0.000055,0.000056,0.000043,0.0000285,0.0000139,0.000014,0.0000353,0.0000476,0.0000548,0.0000633,0.0000673,0.0000603,0.0000516,0.0000601,0.0000586,0.0000561,0.0000562,0.0000511,0.0000451,0.0000588,0.0000595,0.0000588,0.0000573,0.0000531,0.0000395,0.000044,0.0000457,0.0000397,0.0000495,0.0000519,0.0000474,0.0000443,0.0000469,0.000045,0.0000507,0.0000558,0.0000521,0.0000567,0.0000594,0.0000513,0.0000339,0.0000184,0.0000189,0.0000322,0.0000407,0.0000386,0.0000316,0.0000348,0.0000343,0.0000303,0.0000291,0.0000271,0.0000172,0.0000224,0.0000245,0.0000209,0.0000213,0.0000312,0.0000365,0.000038,0.0000375,0.0000231],"detections":[{"range_m":2.505157,"snr_db":22.8011,"width_m":0.171607}],"noise_floor":0.000042351,"blast_amplitude":0.2700065,"saturated":false}
{"timestamp":1756162800.7333326,"source":"simulated","device_id":"batvu-reference-01","beam":[-0.2345697,0.8754261,-0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000646,0.0000708,0.0000702,0.0000625,0.0000487,0,0.0000278,0.0000379,0.0000119,0.0000468,0.0000708,0.0000532,0.0000471,0.0000603,0.0000502,0.0000693,0.0000868,0.0000632,0.0000677,0.0001022,0.0000973,0.0000858,0.0000704,0.000029,0,0.0000409,0.0000407,0.0000392,0.0000402,0.0000319,0.000024,0.0000555,0.0000628,0.0000677,0.0000779,0.0000776,0.0000407,0.0000584,0.0000723,0.0000655,0.0000597,0.0000593,0.0000255,0.0000511,0.0000801,0.0000803,0.0000768,0.0000661,0.0000246,0.0000281,0.00004,0.0000291,0.000014,0.000035,0.0000322,0.0000214,0.0000391,0.0000366,0.000025,0.0000107,0.0000264,0.0000506,0.0000678,0.0000672,0.0000469,0.0000675,0.0000761,0.0000708,0.000068,0.0000686,0.0000388,0.0000225,0.0000265,0.0000137,0.0000458,0.0000834,0.0000873,0.0000853,0.0000748,0.0000429,0.0000096,0.0000257,0.0000232,0.0000084,0.0000219,0.0000255,0.0000251,0.0000181,0.0000084,0.0000217,0.0000313,0.0000327,0.00001,0.0000304,0.0000398,0.0000398,0.0000383,0.0000346,0.0000091,0.0000689,0.0001882,0.0003849,0.0006922,0.0010882,0.0015227,0.0019577,0.0023614,0.0025066,0.0025136,0.0024362,0.0021764,0.0017757,0.0013307,0.000907,0.0004715,0.000226,0.0000787,0.0000342,0.000051,0.0000528,0.0000347,0.0000194,0.0000175,0.0000186,0.0000283,0.0000339,0.0000303,0.0000323,0.0000333,0.0000167,0.0000111,0.0000217,0.0000215,0.000035,0.0000571,0.0000625,0.0000677,0.0000711,0.0000647,0.00005,0.0000604,0.0000595,0.0000454,0.0000286,0.0000113,0.0000096,0.0000183,0.000021,0.0000189,0.0000199,0.0000205,0.0000073,0.0000112,0.0000156,0.0000116,0.0000157,0.0000227,0.0000207,0.0000248,0.0000299,0.000026,0.0000369,0.0000535,0.0000533,0.0000493,0.0000418,0.0000236,5e-7,0.0000033,0.0000032,0.0000055,0.000028,0.0000422,0.0000475,0.0000501,0.0000502,0.0000334,0.0000312,0.0000403,0.000046,0.0000544,0.0000569,0.0000483,0.000049,0.0000562,0.000054,0.0000487,0.0000435,0.0000262,0.0000228,0.0000364,0.0000356,0.0000285,0.0000278,0.0000266,0.0000178,0.0000327,0.0000423,0.0000478,0.0000489,0.0000486,0.0000334,0.0000521,0.0000643,0.0000688,0.0000692,0.0000676,0.0000504,0.0000342,0.000026,0.0000091,0.000012,0.0000218,0.0000205,0.0000145,0.0000084,0.0000072,0.0000177,0.0000311,0.0000312,0.0000292,0.000023,0.0000129,0.0000167,0.000036,0.0000378,0.0000403,0.0000456,0.0000469,0.0000393,0.0000319,0.0000243,0.0000079,0.0000077,0.000017,0.0000293],"detections":[{"range_m":2.654324,"snr_db":29.6705,"width_m":0.171607}],"noise_floor":0.000034262,"blast_amplitude":0.2699895,"saturated":false}
{"timestamp":1756162800.7999992,"source":"simulated","device_id":"batvu-reference-01","beam":[0,0.9063078,-0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000114,0.0000655,0.0000602,0.0000322,0.0000366,0.0000486,0.0000144,0.0000124,0.0000438,0.0000467,0.0000465,0.0000418,0,0,0.0000047,0,0.0000313,0.0000683,0.0000651,0.00006,0.0000588,0.0000249,0.000016,0.0000315,0.0000168,0.0000307,0.0000814,0.000077,0.000063,0.0000555,0.0000479,0.0000353,0.0000529,0.0000563,0.000034,0.0000279,0.0000238,0,0.0000045,0.0000137,0.0000072,0.00001,0.0000118,0.000002,0.0000112,0.0000162,0,0.0000093,0.0000394,0.0000363,0.0000469,0.0000712,0.000069,0.0000632,0.0000557,0.0000405,0.0000176,0.0000291,0.0000255,0.00002,0.0000294,0.0000283,0.0000016,0.0000329,0.0000524,0.0000653,0.0000793,0.0000826,0.0000707,0.0000844,0.0000918,0.0000743,0.0000525,0.0000338,0.0000097,0.0000189,0.0000243,0.0000142,0.0000214,0.000037,0.0000342,0.0000382,0.000054,0.0000524,0.0000529,0.0000639,0.0000606,0.0000576,0.0000689,0.0000682,0.0000583,0.0000668,0.0000686,0.0000465,0.000064,0.0000722,0.0000738,0.0000939,0.0001544,0.0003357,0.000616,0.0009919,0.0014357,0.0019098,0.002325,0.0025929,0.0026825,0.0026763,0.0024565,0.0020777,0.0016175,0.001148,0.0007292,0.0004237,0.0002268,0.0000729,0.0000324,0.0000358,0.0000332,0.0000253,0.0000441,0.0000644,0.00008,0.0000811,0.0000607,0.0000513,0.0000551,0.0000449,0.0000293,0.0000229,0.0000448,0.0000728,0.0000922,0.000096,0.0001054,0.0001124,0.0001055,0.0000687,0.0000334,0.0000236,0.0000376,0.0000487,0.000048,0.0000416,0.0000408,0.0000375,0.0000188,0.0000159,0.0000175,0.0000104,0.0000181,0.0000232,0.0000298,0.000051,0.0000641,0.0000645,0.0000639,0.0000621,0.0000512,0.0000404,0.0000381,0.000022,0.0000186,0.0000556,0.0000681,0.0000703,0.0000687,0.0000495,0.0000222,0.0000181,0.0000169,0.0000115,0.0000253,0.0000294,0.0000272,0.0000242,0.0000202,0.0000221,0.0000527,0.0000764,0.0000895,0.0000998,0.0001002,0.0000802,0.0000454,0.0000209,0.0000446,0.0000579,0.000063,0.0000588,0.000078,0.0001001,0.0001011,0.0000988,0.000091,0.0000795,0.0000594,0.0000719,0.0000772,0.0000779,0.0000748,0.0000595,0.0000196,0.0000324,0.0000386,0.0000376,0.0000354,0.0000368,0.0000307,0.0000453,0.0000633,0.0000699,0.0000771,0.0000813,0.0000761,0.0000686,0.0000685,0.0000637,0.0000489,0.0000304,0.0000148,0.0000247,0.0000312,0.0000291,0.0000144,0.0000355,0.0000404,0.0000404,0.000036,0.0000273,0.0000466,0.0000784,0.0000972,0.0001037,0.0001045,0.0001029,0.0000813],"detections":[{"range_m":2.608981,"snr_db":23.7218,"width_m":0.171607}],"noise_floor":0.000045694,"blast_amplitude":0.2700531,"saturated":false}
{"timestamp":1756162800.8666658,"source":"simulated","device_id":"batvu-reference-01","beam":[0.2345697,0.8754261,-0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000024,0.0000115,0.0000208,0.0000283,0.0000384,0.0000206,0,0,0.0000202,0.0000123,0.0000089,0.0000179,0.0000088,0.0000037,0.0000163,0.0000308,0.0000562,0.0000728,0.0000569,0.0000539,0.000054,0.00001,0.0000119,0.0000454,0.000038,0.0000286,0.0000252,0,4e-7,0.0000496,0.0000457,0.0000316,0.0000411,0.0000546,0.0000698,0.0000766,0.0000749,0.0000268,0.0000553,0.0000595,0.0000386,0.0000263,0.000026,0.0000024,0.0000068,0.0000136,0,0.0000069,0.0000404,0.0000463,0.0000492,0.0000508,0.000026,0.0000122,0.00002,0.00001,0,0.0000367,0.0000453,0.0000487,0.000049,0.000037,0.0000073,0.0000273,0.0000297,0.0000191,0.0000076,0.0000065,0.0000117,0.0000223,0.000029,0.0000391,0.0000568,0.0000653,0.0000529,0.000048,0.0000516,0.0000385,0.0000348,0.0000408,0.0000306,0.000012,0.0000054,0.000002,0.0000133,0.000044,0.0000563,0.0000709,0.000082,0.0000745,0.000052,0.0000518,0.0000498,0.0000246,0.0000252,0.0000543,0.0000703,0.0000836,0.0000858,0.0000706,0.0000768,0.000085,0.0001454,0.000315,0.0005826,0.0009421,0.0013838,0.0018382,0.0022176,0.0024715,0.0025457,0.0025016,0.002276,0.0019127,0.0014712,0.0010164,0.0006324,0.0003449,0.0001056,0.0000441,0.0000519,0.0000508,0.0000424,0.0000318,0.0000066,0.0000422,0.0000589,0.0000666,0.000072,0.0000735,0.0000598,0.0000647,0.0000794,0.0000784,0.0000744,0.0000662,0.0000413,0.0000183,0.0000381,0.0000387,0.0000417,0.0000504,0.0000493,0.0000505,0.0000513,0.0000475,0.0000251,0.00002,0.0000197,0.0000273,0.0000428,0.0000462,0.0000413,0.0000409,0.0000436,0.0000361,0.0000529,0.0000685,0.0000773,0.0000879,0.0000944,0.0000899,0.0000936,0.0001005,0.0000942,0.0000748,0.0000476,0.0000249,0.0000491,0.0000633,0.0000585,0.0000413,0.0000335,0.000032,0.0000241,0.0000276,0.0000289,0.0000199,0.0000261,0.0000275,0.0000157,0.0000046,0.0000152,0.0000313,0.0000593,0.0000691,0.0000663,0.0000519,0.0000304,0.0000261,0.0000369,0.0000379,0.0000226,0.0000021,0.0000152,0.0000175,0.0000255,0.0000335,0.0000319,0.0000189,0.0000174,0.000017,0.0000254,0.0000443,0.0000547,0.0000659,0.0000853,0.0000887,0.0000852,0.0000799,0.0000767,0.0000638,0.0000529,0.0000476,0.0000269,0.0000155,0.0000373,0.0000427,0.000043,0.0000421,0.0000351,0.0000231,0.0000172,0.0000102,0.0000203,0.0000445,0.0000548,0.000063,0.0000702,0.0000687,0.0000589,0.0000588,0.0000593,0.0000438,0.000023,0.0000235,0.0000448,0.000055,0.0000565,0.0000447],"detections":[{"range_m":2.624386,"snr_db":22.9517,"width_m":0.175182}],"noise_floor":0.000038604,"blast_amplitude":0.2700422,"saturated":false}
{"timestamp":1756162800.9333324,"source":"simulated","device_id":"batvu-reference-01","beam":[0.4531539,0.7848856,-0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000026,0,0,0,0.0000225,0.0000271,0.0000224,0.0000159,0.0000119,0,0,0.0000127,0.0000126,0.0000103,0.0000098,0.0000049,0.0000161,0.0000348,0.0000432,0.0000526,0.000056,0.0000178,0,0.0000118,0.0000076,0.0000331,0.0000706,0.0000655,0.000068,0.0000908,0.000078,0.0000563,0.0000495,0.0000371,0,0.0000261,0.0000348,0.0000259,0.0000306,0.0000355,0.0000318,0.0000342,0.0000361,0.0000198,0.0000261,0.0000275,0,0.0000016,0.0000176,0.0000126,0.0000139,0.0000369,0.0000423,0.0000474,0.0000487,0.0000276,0,0.0000216,0.0000252,0.0000438,0.0000737,0.0000727,0.0000776,0.0000886,0.000087,0.000055,0.0000301,0.0000282,0.000011,6e-7,0.0000203,0.0000278,0.0000302,0.0000299,0,0.0000213,0.0000344,0.0000374,0.0000645,0.0000883,0.0000856,0.0000656,0.0000402,0.000007,0.0000255,0.000037,0.0000329,0.0000395,0.000065,0.0000631,0.000053,0.0000511,0.0000493,0.0000357,0.0000531,0.0000595,0.0000554,0.0000584,0.0000595,0.0000405,0.0000314,0.0000349,0.0000243,0.0000146,0.0000172,0.0000186,0.0000467,0.0000744,0.000076,0.0000736,0.000086,0.0001982,0.0004095,0.0007136,0.0010783,0.0015014,0.0019219,0.0022778,0.0024012,0.0024036,0.0022981,0.0020036,0.0016099,0.001189,0.0007758,0.000441,0.0001793,0.000064,0.0000474,0.0000405,0.0000063,0.0000219,0.0000304,0.0000207,0.000018,0.000026,0.0000218,0.000014,0.0000153,0.0000105,0,0.0000179,0.0000181,0.0000162,0.0000192,0.0000261,0.0000413,0.0000645,0.000065,0.0000595,0.0000534,0.0000475,0.0000219,0.000014,0.0000363,0.0000476,0.0000577,0.000061,0.000051,0.0000408,0.0000372,0.0000232,0.0000314,0.0000559,0.0000573,0.0000531,0.0000374,0.0000156,0.0000193,0.0000197,0.0000061,0.0000168,0.0000335,0.0000335,0.000028,0.0000283,0.0000294,0.0000198,0.0000176,0.0000168,8e-7,0,0.0000022,0.0000073,0.0000225,0.0000303,0.0000329,0.00004,0.000046,0.0000428,0.0000412,0.0000438,0.0000354,0.0000263,0.0000432,0.0000488,0.0000527,0.0000551,0.0000528,0.0000394,0.0000438,0.0000432,0.0000335,0.0000184,0.0000241,0.0000427,0.0000556,0.0000568,0.0000479,0.0000566,0.0000606,0.0000545,0.0000485,0.0000535,0.0000525,0.0000562,0.0000588,0.0000527,0.0000493,0.0000572,0.000056,0.0000537,0.0000577,0.0000544,0.0000455,0.0000374,0.0000256,0.0000098,0.0000314,0.0000325,0.000035,0.0000465,0.0000533,0.0000586,0.000064,0.0000659,0.0000589,0.0000688,0.0000776,0.0000808],"detections":[{"range_m":2.78081,"snr_db":26.2487,"width_m":0.171607}],"noise_floor":0.000034262,"blast_amplitude":0.269969,"saturated":false}
{"timestamp":1756162800.999999,"source":"simulated","device_id":"batvu-reference-01","beam":[0.6408564,0.6408564,-0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000813,0.0000769,0.0000585,0.000039,0.0000726,0.0000664,0.0000402,0.0000452,0.0000583,0.0000287,0.0000308,0.0000457,0.0000338,0.0000275,0.0000322,0.0000259,0.0000431,0.0000514,0.0000133,0,0.0000264,0.0000328,0.0000476,0.0000635,0.0000417,0.0000168,0.0000168,0.0000208,0.0000243,0.0000298,0.0000146,0.0000143,0.0000311,0.0000245,0.0000061,0.0000267,0.000032,0.0000149,0.0000117,0.0000295,0.000046,0.0000632,0.0000669,0.0000397,0.0000642,0.0000863,0.0000929,0.0000992,0.0001013,0.0000753,0.0000702,0.000092,0.0000832,0.0000698,0.0000632,0.000048,0.00005,0.0000733,0.0000704,0.0000648,0.0000817,0.0000779,0.0000605,0.0000456,0.0000291,0,0.0000087,0.0000077,0,0.0000266,0.0000389,0.0000375,0.0000416,0.000048,0.0000357,0.0000259,0.0000352,0.00004,0.0000501,0.0000598,0.0000542,0.0000503,0.0000547,0.0000429,0.0000222,0.0000075,0.0000211,0.000031,0.0000394,0.0000344,0.0000333,0.0000417,0.0000396,0.0000213,0.0000387,0.0000427,0.0000255,0.0000169,0.0000352,0.0000458,0.0000543,0.0000574,0.0000442,0.0000652,0.0000807,0.0000802,0.0000742,0.0000623,0.0000341,0.0000073,0.000012,0.000055,0.0001692,0.0003761,0.0006684,0.0010684,0.0015341,0.0020401,0.0023499,0.0024909,0.0024918,0.0023697,0.0020836,0.0016931,0.001242,0.0008239,0.0004343,0.0001976,0.000063,0.0000426,0.0000519,0.000072,0.0000907,0.0000909,0.0000921,0.0000942,0.0000847,0.0000724,0.0000696,0.000063,0.0000452,0.0000398,0.0000361,0.0000527,0.000075,0.0000759,0.0000711,0.0000666,0.0000605,0.0000371,0.000034,0.000041,0.0000427,0.0000449,0.0000471,0.0000407,0.000052,0.0000587,0.0000565,0.0000541,0.0000523,0.0000398,0.0000289,0.0000386,0.0000397,0.0000404,0.0000401,0.0000302,0.0000124,0.0000251,0.0000252,0.0000271,0.0000272,0.0000229,0.0000306,0.0000628,0.0000792,0.0000847,0.0000893,0.0000899,0.0000735,0.0000578,0.0000466,0.0000246,0.0000091,0.0000288,0.000041,0.0000536,0.0000604,0.0000561,0.000048,0.0000456,0.0000383,0.0000371,0.00005,0.0000524,0.0000586,0.0000667,0.0000655,0.000055,0.0000476,0.0000434,0.0000249,0.0000085,0.0000151,0.0000221,0.0000355,0.0000406,0.0000492,0.0000668,0.0000779,0.0000789,0.0000786,0.0000756,0.0000567,0.0000398,0.0000402,0.0000417,0.0000431,0.000043,0.0000345,0.0000169,0.0000076,0.0000012,0.0000168,0.000038,0.0000394,0.0000363,0.0000267,0.0000247,0.0000297,0.0000363,0.0000404,0.0000475,0.0000532,0.0000539,0.0000417,0.0000251,0.0000227,0.0000269],"detections":[{"range_m":2.79791,"snr_db":23.0872,"width_m":0.175182}],"noise_floor":0.000038573,"blast_amplitude":0.2700266,"saturated":false}
{"timestamp":1756162801.0666656,"source":"simulated","device_id":"batvu-reference-01","beam":[0.7848856,0.4531539,-0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000372,0.0000365,0.0000382,0.0000425,0.0000496,0.0000298,0,0.0000137,0.0000379,0.0000219,0.0000079,0.0000244,0.0000283,0.0000382,0.0000473,0.0000154,0.000019,0.0000358,0.0000325,0.0000366,0.0000377,0,0,0.0000287,0.0000226,0.000038,0.0000681,0.0000596,0.0000483,0.0000714,0.0000635,0.0000493,0.0000409,0.000048,0.0000762,0.0001014,0.0001032,0.0000606,0.0000645,0.0000658,0.0000302,0.0000013,0.0000219,0.0000222,0.0000183,0.0000233,0.0000183,0.0000207,0.000027,0.0000255,0.0000349,0.0000392,0.0000124,0.0000027,0.0000294,0.0000268,0.0000261,0.000044,0.0000407,0.0000227,0.000041,0.0000497,0.0000536,0.0000531,0.0000411,0,0.0000178,0.0000186,0.0000119,0.0000423,0.0000534,0.0000486,0.0000358,0.0000237,0.0000358,0.0000466,0.0000498,0.0000327,0.0000228,0.0000251,0.0000093,0.0000098,0.0000396,0.0000424,0.0000423,0.0000378,0.000016,0.0000125,0.0000385,0.0000379,0.0000568,0.0000886,0.0000912,0.0000843,0.0000714,0.0000621,0.0000603,0.0000778,0.0000806,0.0000655,0.0000749,0.0000862,0.0000813,0.0000566,0.0000701,0.0002105,0.0004354,0.0007465,0.0011345,0.001597,0.0021432,0.0024714,0.0026279,0.0026347,0.002533,0.0022302,0.0018162,0.0013626,0.0008314,0.0004821,0.0002353,0.0000687,0.0000213,0.0000321,0.0000407,0.0000535,0.0000552,0.0000395,0.0000455,0.0000546,0.0000512,0.0000413,0.0000272,0.0000162,0.0000314,0.0000396,0.0000348,0.0000429,0.0000664,0.0000761,0.0000853,0.0000912,0.0000856,0.00007,0.0000639,0.0000592,0.0000297,0.0000344,0.0000583,0.0000689,0.0000695,0.0000651,0.0000341,0.0000124,0.0000106,0.0000056,0.0000131,0.0000176,0.0000121,0.0000121,0.0000228,0.0000225,0.0000197,0.0000099,0.0000339,0.0000632,0.0000875,0.0000895,0.0000919,0.0000942,0.0000867,0.0000612,0.0000348,0.000012,0.0000101,0.0000103,0.0000107,0.0000185,0.0000219,0.0000218,0.000003,0,0.0000085,0.0000178,0.0000322,0.000036,0.0000275,0.0000172,0.0000159,0.0000184,0.0000421,0.0000712,0.0000756,0.0000754,0.0000703,0.000053,0.0000335,0.0000605,0.0000743,0.0000836,0.0000845,0.0000794,0.0000529,0.0000272,0.0000114,0.0000317,0.0000578,0.0000667,0.0000746,0.0000857,0.0000895,0.0000815,0.0000669,0.0000534,0.0000313,0.000018,0.0000359,0.0000528,0.0000705,0.0000831,0.0000825,0.0000803,0.0000798,0.0000692,0.0000438,0.0000517,0.0000749,0.0000944,0.0001023,0.0000985,0.0000706,0.0000391,0.0000138,0.0000364,0.0000629,0.0000786,0.0000795,0.0000784,0.0000738,0.0000577],"detections":[{"range_m":2.671687,"snr_db":24.1381,"width_m":0.175182}],"noise_floor":0.000039462,"blast_amplitude":0.2699971,"saturated":false}
{"timestamp":1756162801.1333323,"source":"simulated","device_id":"batvu-reference-01","beam":[0.8754261,0.2345697,-0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000076,0.0000163,0.0000241,0.0000026,0,0,0.000004,0,0.0000258,0.0000574,0.0000596,0.0000596,0.0000572,0,0.0000349,0.000058,0.0000424,0.0000243,0.0000149,0,0.0000449,0.0000914,0.0000934,0.000093,0.0000887,0.0000553,0.0000406,0.000089,0.0000887,0.000084,0.0000749,0.0000541,0.0000179,0.0000315,0.0000325,0.0000097,0.0000574,0.0000657,0.0000583,0.0000431,0.0000312,0.0000283,0.0000339,0.0000344,0,0.0000115,0.0000327,0.0000295,0.0000256,0.0000229,0,0.0000036,0.0000199,0.0000132,0.0000153,0.0000567,0.0000593,0.0000576,0.0000481,0.0000226,0,0.0000124,0.0000171,0.0000229,0.0000307,0.0000294,0.0000128,0.0000313,0.0000392,0.0000332,0.0000285,0.0000327,0.0000255,0.0000268,0.0000275,0.0000092,0.0000298,0.0000575,0.0000602,0.00006,0.0000557,0.0000302,0.000002,0.0000085,0.0000069,0.0000069,0.0000127,0.0000058,0.0000033,0.000038,0.0000441,0.0000436,0.0000519,0.0001603,0.0003423,0.0006287,0.001004,0.0014732,0.0019973,0.0024653,0.0028171,0.002881,0.002856,0.0026166,0.0022054,0.0017232,0.001234,0.0007997,0.0004696,0.0001975,0.000058,0.0000214,0.0000222,0.0000327,0.0000553,0.0000566,0.0000501,0.0000461,0.0000451,0.0000556,0.0000691,0.000071,0.0000534,0.0000393,0.0000365,0.0000175,0.0000246,0.0000359,0.0000355,0.0000341,0.0000362,0.0000266,0.0000282,0.000033,0.0000264,0.0000356,0.0000599,0.0000657,0.000067,0.0000664,0.0000529,0.0000267,0.000039,0.0000435,0.0000505,0.0000618,0.0000601,0.0000433,0.0000381,0.0000434,0.0000462,0.0000468,0.0000462,0.0000256,0.0000188,0.0000203,0.0000075,0.0000044,0.00002,0.0000244,0.0000344,0.000039,0.0000297,0.000008,0.000032,0.0000438,0.0000491,0.0000524,0.0000479,0.0000404,0.0000397,0.0000353,0.0000142,0.0000119,0.0000146,0.0000138,0.0000306,0.0000408,0.0000459,0.0000488,0.0000495,0.000038,0.000038,0.0000407,0.0000308,0.0000166,0.0000056,0.0000061,0.0000115,0.0000168,0.0000119,0.0000118,0.0000222,0.0000218,0.0000206,0.0000208,0.0000182,0.0000034,0.0000098,0.0000102,0.0000092,0.0000164,0.000019,0.0000246,0.0000461,0.0000558,0.0000591,0.0000594,0.0000583,0.0000434,0.0000353,0.0000408,0.0000361,0.0000259,0.0000119,0.0000401,0.0000671,0.0000814,0.0000793,0.0000647,0.0000437,0.0000267,0.0000422,0.0000673,0.0000708,0.0000702,0.0000653,0.000053,0.0000304,0.000016,0.0000073,0.0000205,0.0000442,0.0000534,0.0000506,0.0000412,0.0000458,0.0000531],"detections":[{"range_m":2.49792,"snr_db":27.1549,"width_m":0.171607}],"noise_floor":0.000031168,"blast_amplitude":0.270043,"saturated":false}
{"timestamp":1756162801.1999989,"source":"simulated","device_id":"batvu-reference-01","beam":[0.9063078,0,-0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,8e-7,0,0,0.0000014,0.0000921,0.0000951,0.0000991,0.0001027,0.0001033,0.0000388,0.0000728,0.0001004,0.0000973,0.0000904,0.0000824,0.0000067,0.0000118,0.0000362,0.0000279,0.0000152,0.000012,0.0000208,0.0000245,0.0000275,0.0000021,0.0000043,0.0000093,0,0,0.0000395,0.0000397,0.0000385,0.0000333,0.000015,0.0000095,0.0000351,0.000041,0.0000485,0.0000704,0.0000734,0.0000547,0.0000662,0.0000692,0.0000385,0.0000052,0.0000249,0.0000305,0.0000347,0.0000371,0.0000165,0.0000086,0.0000128,0,0,0.0000075,0.0000118,0.0000208,0.0000307,0.0000241,0.0000114,0.0000398,0.0000385,0.0000309,0.0000231,0.0000193,0.0000188,0.0000301,0.0000291,0.0000143,0.0000437,0.0000561,0.0000561,0.0000566,0.000057,0.000028,0.0000259,0.0000398,0.0000374,0.0000337,0.0000307,0.000015,0.0000073,0.0000156,0.0000091,0,0.0000308,0.0000438,0.0000494,0.0000502,0.0001099,0.0002816,0.0005713,0.0009581,0.0014625,0.0020337,0.0026333,0.0029591,0.0030588,0.0030487,0.0028297,0.0024275,0.0019317,0.0014014,0.0008381,0.0004895,0.0002386,0.0000943,0.0000443,0.0000249,0.0000063,0.0000074,0.0000098,0.0000359,0.0000718,0.0000809,0.0000845,0.0000848,0.0000804,0.0000541,0.0000715,0.0000753,0.000082,0.0000906,0.0000922,0.0000772,0.0000691,0.0000688,0.0000427,0.0000241,0.0000342,0.0000341,0.0000359,0.0000522,0.000067,0.0000854,0.0000952,0.0000906,0.000083,0.0000913,0.0000892,0.0000824,0.0000809,0.0000735,0.0000591,0.0000776,0.0000817,0.000085,0.000088,0.0000854,0.0000691,0.0000748,0.0000774,0.0000711,0.0000662,0.0000642,0.0000426,0.0000258,0.0000165,0.0000042,0.000016,0.000025,0.0000276,0.0000498,0.0000634,0.0000611,0.0000482,0.0000303,0.0000109,0.0000109,0.0000146,0.0000094,0.0000046,0.000019,0.0000226,0.0000354,0.0000553,0.0000594,0.0000494,0.0000401,0.0000613,0.00008,0.0000881,0.0000882,0.0000691,0.000047,0.000032,0.0000073,0.0000327,0.0000586,0.0000602,0.0000546,0.0000323,0.0000372,0.0000659,0.0000811,0.0000801,0.0000813,0.0000948,0.0000953,0.0000966,0.0001012,0.0000994,0.000086,0.000076,0.0000698,0.0000501,0.000044,0.0000464,0.0000441,0.0000397,0.0000315,0.0000102,0.0000128,0.0000183,0.000011,0.0000035,0.0000067,0.0000022,0.000001,0.000017,0.0000371,0.0000835,0.0001231,0.0001354,0.0001357,0.0001269,0.0001031,0.0000641,0.0000366,0.0000186,0,0.000018,0.000027,0.0000346,0.0000481,0.0000579,0.0000629,0.0000716,0.0000758,0.000073],"detections":[{"range_m":2.389984,"snr_db":26.5278,"width_m":0.171607}],"noise_floor":0.000036572,"blast_amplitude":0.2700389,"saturated":false}
{"timestamp":1756162801.2666655,"source":"simulated","device_id":"batvu-reference-01","beam":[0.8754261,-0.2345697,-0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000413,0.0000498,0.0000508,0.0000489,0.0000414,0.000015,0,0,0.0000372,0.0000404,0.0000403,0.0000352,0,0.0000059,0.0000127,0,0.0000029,0.0000079,0,8e-7,0.0000464,0.0000469,0.0000489,0.0000619,0.0000537,0.0000719,0.0000896,0.0000733,0.0000483,0.0000511,0.0000295,0,0.0000367,0.0000329,0.0000089,0.0000338,0.0000634,0.0000686,0.0000683,0.0000589,0.0000023,0.0000071,0.0000208,0.0000182,0.0000276,0.0000319,0.0000158,0.0000277,0.0000407,0.0000314,0.0000229,0.0000195,0,0,0.0000016,0,0,0.000009,0.0000049,0.0000042,0.0000404,0.0000403,0.0000359,0.0000268,0.0000154,0.0000045,0.0000079,0.0000058,0,0.0000015,0.0000066,0.0000105,0.0000237,0.0000333,0.000027,0.00004,0.0000499,0.0000443,0.0000523,0.0000647,0.0000601,0.000066,0.0000776,0.0000711,0.0000531,0.0000388,0.0000433,0.0000589,0.000079,0.0000788,0.0001104,0.000207,0.0003738,0.0006645,0.001086,0.0016886,0.0022178,0.0026817,0.0029551,0.0030048,0.0029674,0.0027241,0.0022836,0.0016488,0.0011477,0.0007086,0.000372,0.0001497,0.000028,0.000049,0.0000492,0.0000206,0.0000075,0.0000255,0.0000261,0.0000375,0.0000525,0.0000517,0.0000319,0.0000166,0.0000137,0.0000228,0.0000282,0.0000287,0.0000088,0.0000134,0.0000177,0.0000214,0.0000405,0.0000598,0.0000773,0.0001021,0.0001184,0.0001157,0.0001081,0.0000993,0.0000752,0.0000435,0.0000389,0.0000508,0.0000644,0.0000745,0.0000711,0.0000627,0.0000747,0.0000743,0.0000617,0.0000405,0.0000227,0.000052,0.0000694,0.000071,0.0000529,0.0000368,0.0000324,0.0000132,0.0000277,0.0000482,0.0000555,0.0000581,0.0000582,0.0000467,0.0000614,0.0000854,0.0000912,0.0000917,0.0000893,0.0000739,0.0000476,0.0000342,0.0000241,0.0000206,0.0000461,0.0000502,0.0000497,0.0000419,0.0000266,0.0000149,0.0000305,0.0000327,0.0000226,0.0000141,0.0000136,0.0000034,0.0000231,0.0000426,0.0000543,0.000065,0.00007,0.0000635,0.0000525,0.0000481,0.00004,0.0000335,0.0000399,0.000037,0.000027,0.000023,0.000022,0.0000152,0.0000276,0.000042,0.0000544,0.0000613,0.000062,0.0000485,0.0000494,0.0000516,0.000047,0.0000403,0.0000308,0.0000083,0,0.0000017,4e-7,0.0000089,0.0000158,0.0000142,0.0000186,0.0000372,0.00005,0.0000653,0.0000708,0.000066,0.000051,0.0000408,0.0000328,0.0000126,0.0000271,0.0000374,0.0000434,0.0000494,0.0000527,0.0000666,0.0000885,0.000103,0.0001096,0.0001177,0.0001202,0.0001111],"detections":[{"range_m":2.421122,"snr_db":25.9909,"width_m":0.171607}],"noise_floor":0.000039479,"blast_amplitude":0.2700178,"saturated":false}
{"timestamp":1756162801.333332,"source":"simulated","device_id":"batvu-reference-01","beam":[0.7848856,-0.4531539,-0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000178,0.0000242,0.0000253,0.0000249,0.0000216,0.0000018,0.0000159,0.0000339,0.0000417,0.000012,0.0000827,0.0001163,0.000117,0.0001181,0.00012,0.0000605,0.0000689,0.0000842,0.0000574,0.0000364,0.0000545,0.0000407,0.0000231,0.0000082,0.0000171,0.0000238,0.0000251,0.0000025,0.0000093,0.0000219,0.0000055,0,0.0000415,0.0000406,0.0000333,0.0000222,0.000017,0.000028,0.0000381,0.0000382,0.0000127,0.0000222,0.0000242,0,5e-7,0.0000142,0.000007,0.0000222,0.0000447,0.0000452,0.0000474,0.000049,0.0000206,0.0000016,0.0000378,0.0000432,0.0000543,0.0000758,0.0000734,0.0000783,0.0000963,0.0000927,0.0000769,0.0000631,0.0000472,0.0000156,0.0000269,0.0000256,0.0000042,0.0000287,0.0000395,0.0000385,0.000037,0.0000352,0.0000123,0.0000197,0.0000244,0.0000113,0.0000282,0.0000566,0.0000624,0.0000666,0.0000701,0.0000592,0.0000667,0.0000919,0.0000913,0.0000889,0.0000876,0.000075,0.0000496,0.0000646,0.0000653,0.0000563,0.0000578,0.00006,0.0000454,0.0000378,0.0000289,0.0000793,0.0002027,0.0003949,0.0007627,0.001207,0.0017121,0.0022001,0.0025975,0.0028137,0.0028329,0.0027688,0.0025159,0.0020095,0.001501,0.0010163,0.0006052,0.0002919,0.0001058,0.0000276,0.0000346,0.0000423,0.0000399,0.0000168,0.0000223,0.000037,0.0000407,0.0000411,0.0000405,0.0000183,0.0000185,0.0000267,0.0000277,0.0000382,0.000047,0.0000409,0.0000388,0.0000461,0.0000421,0.0000331,0.000024,0.0000089,0.0000192,0.0000429,0.0000486,0.0000559,0.0000656,0.0000646,0.0000547,0.000051,0.0000476,0.0000264,0.0000208,0.0000256,0.00003,0.0000383,0.0000421,0.0000321,0.0000297,0.0000339,0.0000299,0.0000273,0.0000279,0.0000174,0.0000174,0.0000395,0.0000471,0.0000515,0.0000525,0.0000454,0.0000287,0.0000406,0.0000405,0.0000411,0.0000439,0.0000418,0.0000288,0.000026,0.0000283,0.0000458,0.0000752,0.0000898,0.0000933,0.0000933,0.00009,0.0000693,0.0000501,0.0000418,0.0000295,0.0000485,0.0000685,0.0000699,0.0000685,0.0000634,0.0000518,0.0000417,0.0000395,0.0000355,0.0000416,0.000062,0.0000682,0.0000692,0.0000686,0.0000618,0.0000428,0.0000437,0.0000458,0.0000437,0.0000589,0.0000665,0.0000701,0.0000707,0.0000695,0.0000514,0.0000331,0.0000249,0.0000122,0.0000012,0.0000072,0.0000132,0.0000333,0.0000608,0.0000698,0.0000702,0.0000607,0.0000338,0.0000286,0.0000491,0.0000491,0.0000377,0.0000203,0.0000158,0.0000263,0.0000371,0.0000392,0.0000352,0.0000348,0.0000366,0.0000285,0.0000206,0.0000116,0.0000208],"detections":[{"range_m":0.852904,"snr_db":6.1874,"width_m":0.132281},{"range_m":2.581617,"snr_db":25.3381,"width_m":0.171607}],"noise_floor":0.0000376,"blast_amplitude":0.2699973,"saturated":false}
{"timestamp":1756162801.3999987,"source":"simulated","device_id":"batvu-reference-01","beam":[0.6408564,-0.6408564,-0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,8e-7,0.000001,0,0.0000101,0.0000398,0.0000385,0.0000576,0.000071,0.0000659,0.0000786,0.0000831,0.0000203,0.000029,0.0000501,0.0000333,0.0000131,0.0000243,0.0000314,0.0000403,0.0000474,0.0000166,0.000028,0.0000846,0.0000904,0.0000945,0.0000963,0.0000721,0.0000408,0.0000859,0.0000851,0.0000805,0.0000722,0.0000574,0.0000144,0.0000432,0.0000463,0.0000189,0.0000285,0.0000416,0.0000314,0.0000147,0.0000093,0.0000096,0.0000095,0.0000097,0,0,0.000024,0.0000369,0.0000514,0.0000617,0.0000523,0.0000568,0.0000741,0.0000689,0.0000383,0.0000349,0.0000313,0.0000252,0.0000521,0.0000559,0.0000514,0.0000419,0.0000305,0.0000166,0.0000455,0.0000564,0.00006,0.0000768,0.0000895,0.000084,0.0000773,0.0000648,0.0000209,0.0000148,0.0000358,0.0000343,0.0000556,0.0000782,0.0000768,0.0000689,0.0000564,0.0000318,0,0.0000109,0.000007,0,0.000014,0.0000209,0.0000284,0.000041,0.000044,0.0000338,0.0000525,0.0000584,0.0000506,0.0000361,0.0000191,0.0000074,0.0000108,0.0000107,4e-7,0.0000084,0.0000115,0.000015,0.0000765,0.0002316,0.000449,0.0007877,0.0012215,0.0016686,0.0020809,0.0023825,0.0024913,0.002483,0.0023419,0.0020495,0.0016364,0.001198,0.0007999,0.0004627,0.0002355,0.0000988,0.000034,0.000004,0.0000191,0.0000266,0.0000376,0.0000458,0.0000441,0.000062,0.0000776,0.0000761,0.0000669,0.0000517,0.0000255,0.0000111,0.0000306,0.0000302,0.0000368,0.0000573,0.0000603,0.0000606,0.0000602,0.0000528,0.0000265,0.0000093,0.0000088,0.0000307,0.0000629,0.0000784,0.0000765,0.0000639,0.0000522,0.0000589,0.0000745,0.0000834,0.0000811,0.000086,0.0000911,0.0000847,0.0000746,0.0000798,0.0000779,0.0000732,0.0000697,0.0000587,0.0000426,0.0000397,0.0000373,0.0000229,0.0000257,0.0000279,0.0000201,0.0000239,0.0000269,0.0000349,0.0000565,0.0000747,0.0000806,0.0000808,0.0000737,0.0000452,0.0000174,0.0000079,0.000015,0.0000337,0.000058,0.0000628,0.0000648,0.0000657,0.0000605,0.0000543,0.0000597,0.0000575,0.0000392,0.0000173,0.0000109,0.0000132,0.0000158,0.0000169,0.0000137,0.0000286,0.0000356,0.000037,0.0000365,0.0000301,0.0000075,0.0000257,0.000036,0.0000332,0.0000285,0.0000299,0.000024,0.0000226,0.0000342,0.0000347,0.0000396,0.0000476,0.0000468,0.0000445,0.0000459,0.0000445,0.00004,0.0000427,0.0000405,0.0000267,0.00002,0.00002,0.0000068,0.0000334,0.0000703,0.0001007,0.0001298,0.0001404,0.0001389],"detections":[{"range_m":2.757947,"snr_db":26.4476,"width_m":0.175182}],"noise_floor":0.000038272,"blast_amplitude":0.2700154,"saturated":false}
{"timestamp":1756162801.4666653,"source":"simulated","device_id":"batvu-reference-01","beam":[0.4531539,-0.7848856,-0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000173,0.0000063,0,0,0.000055,0.0000592,0.0000512,0.0000335,0.000015,0.0000135,0.0000221,0.0000231,0,0,0.0000132,0.000008,0.0000097,0.0000184,0.0000065,0.000027,0.0000558,0.0000563,0.0000855,0.0001107,0.0000931,0.0000639,0.0000408,0.0000236,0.0000341,0.0000396,0.0000195,0.0000217,0.0000805,0.0000879,0.0000944,0.0000987,0.000097,0.0000445,0.0000747,0.0000803,0.0000611,0.0000347,0.0000215,0.0000504,0.0000624,0.0000632,0.0000215,0.0000097,0.0000295,0.0000259,0.0000319,0.0000401,0.0000232,0.000012,0.0000321,0.0000291,0.0000234,0.0000193,0.0000103,0.0000065,0.0000312,0.0000317,0.0000372,0.0000443,0.0000422,0.0000135,0.0000283,0.0000298,0.0000141,0.0000272,0.0000527,0.0000666,0.0000775,0.0000809,0.0000573,0.0000716,0.0000909,0.0000909,0.0000871,0.0000755,0.0000397,0.0000016,0.000017,0.0000131,0.0000315,0.0000635,0.0000653,0.0000668,0.0000719,0.000065,0.0000478,0.0000556,0.0000557,0.000047,0.0000447,0.0000443,0.0000109,0.0000094,0.0000216,0.0000249,0.0000337,0.0000403,0.0000359,0.0000384,0.0000412,0.0000302,0.0000315,0.0000353,0.0000227,0.0000075,0.0000269,0.0000231,0.0000043,0.0000762,0.0001693,0.0003327,0.0005886,0.0009894,0.0014031,0.0018314,0.0021677,0.0023661,0.0024007,0.0023664,0.0021422,0.0017866,0.0012878,0.0008633,0.0005092,0.0002557,0.0000834,0.0000211,0.0000378,0.0000337,0.0000251,0.0000161,0.0000018,0.0000101,0.0000168,0.000017,0.0000355,0.0000546,0.0000538,0.0000462,0.0000371,0.0000274,0.0000049,0.0000141,0.0000151,0.0000125,0.0000266,0.0000324,0.0000319,0.0000272,0.0000205,0.0000092,0.0000174,0.0000237,0.0000301,0.0000526,0.0000803,0.0000938,0.0000994,0.0000986,0.000078,0.0000486,0.0000468,0.0000513,0.0000552,0.0000556,0.0000472,0.0000293,0.0000212,0.0000138,0.0000104,0.0000275,0.0000327,0.000041,0.0000554,0.0000581,0.0000496,0.0000351,0.0000215,0.0000329,0.000054,0.0000591,0.0000516,0.0000399,0.0000389,0.0000357,0.0000352,0.0000359,0.0000269,0.0000218,0.0000352,0.000039,0.000047,0.0000573,0.0000566,0.0000496,0.0000525,0.000051,0.000038,0.0000232,0.0000155,0.0000339,0.0000542,0.0000569,0.0000525,0.0000539,0.0000561,0.0000473,0.0000359,0.0000296,0.0000212,0.0000365,0.0000547,0.0000659,0.0000841,0.0001043,0.0001064,0.0001056,0.0000957,0.0000776,0.0000569,0.0000554,0.000054,0.0000454,0.0000492,0.0000489,0.0000501,0.0000571,0.0000588,0.000059,0.0000679,0.0000706,0.0000549,0.0000274,0.0000309,0.0000534],"detections":[{"range_m":2.842285,"snr_db":28.1564,"width_m":0.171607}],"noise_floor":0.00003805,"blast_amplitude":0.2699913,"saturated":false}
{"timestamp":1756162801.5333319,"source":"simulated","device_id":"batvu-reference-01","beam":[0.2345697,-0.8754261,-0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000303,0.0000253,0.0000054,0,0.0000054,0.0000046,0.0000048,0.0000137,0.000014,0.000019,0.000022,0,0.0000073,0.0000141,0,0.0000096,0.000055,0.0000535,0.0000409,0.0000259,6e-7,0.000023,0.0000644,0.0000703,0.0000813,0.0000866,0.0000654,0.0000329,0.0000416,0.0000335,0.0000068,0.0000341,0.0000409,0.0000339,0.000037,0.0000352,0,0.0000384,0.000055,0.0000499,0.000057,0.0000619,0.0000411,0.0000243,0.0000241,0.0000126,0.0000049,0.0000238,0.0000219,0.0000319,0.0000591,0.0000679,0.0000775,0.0000839,0.0000747,0.000044,0.0000402,0.000031,0.0000189,0.000053,0.0000576,0.000056,0.0000501,0.000036,0.0000023,0.0000397,0.0000519,0.0000561,0.000076,0.0000911,0.0000882,0.0000855,0.0000813,0.000051,0.0000328,0.0000461,0.0000414,0.0000294,0.0000237,0.000003,0.0000168,0.0000545,0.0000602,0.000065,0.0000771,0.0000748,0.0000853,0.0001106,0.0001125,0.0001073,0.0001009,0.000092,0.0000472,0.000024,0.000018,0,0.0000217,0.0000506,0.000063,0.0000649,0.0000633,0.0000341,0.000007,0.0000199,0.0000212,0.0000309,0.0000626,0.0001315,0.0002843,0.0005303,0.0008524,0.0012662,0.0017246,0.0021912,0.0024461,0.0025224,0.0025092,0.0023259,0.0019959,0.0015854,0.0011378,0.0007403,0.0003856,0.0001772,0.0000659,0.0000428,0.0000428,0.0000564,0.0000651,0.0000536,0.000031,0.0000304,0.0000388,0.0000414,0.0000412,0.0000312,0.000018,0.0000345,0.0000343,0.0000322,0.0000286,0.0000256,0.0000171,0.0000173,0.0000129,4e-7,0.0000175,0.0000256,0.000032,0.0000408,0.0000446,0.0000389,0.0000561,0.0000683,0.0000699,0.0000718,0.0000747,0.0000694,0.0000873,0.0001006,0.0000999,0.0000972,0.0000953,0.0000874,0.0000705,0.0000629,0.000056,0.0000442,0.0000524,0.0000513,0.0000385,0.0000238,0.0000159,0.000031,0.0000476,0.0000511,0.0000482,0.0000525,0.0000559,0.0000539,0.0000737,0.0000844,0.0000844,0.0000819,0.0000763,0.0000589,0.0000383,0.0000282,0.0000167,0.0000122,0.0000393,0.0000558,0.0000702,0.0000788,0.0000769,0.0000612,0.0000484,0.0000446,0.0000332,0.0000318,0.0000325,0.0000209,0.0000178,0.0000193,0.0000103,0.0000154,0.0000345,0.0000412,0.0000415,0.0000367,0.000006,0.0000319,0.0000497,0.00005,0.0000471,0.0000409,0.0000284,0.0000084,0.0000103,0.0000103,0.0000168,0.000035,0.0000379,0.0000377,0.0000392,0.0000401,0.0000426,0.0000426,0.0000389,0.0000184,0.0000101,0.0000273,0.0000432,0.000061,0.00007,0.0000752],"detections":[{"range_m":2.793585,"snr_db":26.3236,"width_m":0.171607}],"noise_floor":0.000039334,"blast_amplitude":0.2699779,"saturated":false}
{"timestamp":1756162801.5999985,"source":"simulated","device_id":"batvu-reference-01","beam":[0.258819,-0.9659258,0],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000117,0.0000102,0.0000064,0.0000275,0.0000464,0.0000267,0.0000209,0.0000241,0,0.0000159,0.0000423,0.0000363,0.0000332,0.0000427,0.0000258,0.0000257,0.0000273,0,0,0.0000298,0.000025,0.0000133,0.0000272,0.0000464,0.0000654,0.0000718,0.0000499,0.0000209,0.000049,0.0000435,0.0000166,0.0000236,0.0000477,0.0000524,0.0000523,0.0000436,0,0,0.0000104,0.0000188,0.0000335,0.0000368,0.000011,0.0000092,0.0000285,0.0000255,0.000033,0.000042,0.0000261,0.0000258,0.0000475,0.0000429,0.0000301,0.000018,0.0000063,0.0000017,0.0000119,0.0000212,0.0000322,0.0000401,0.0000375,0.0000045,0.0000097,0.0000109,0,0.0000203,0.0000337,0.0000338,0.0000335,0.000033,0.0000026,6e-7,0.0000099,0.0000102,0.0000446,0.0000809,0.0000839,0.0000821,0.0000758,0.0000567,0.0000367,0.0000432,0.0000558,0.000082,0.0001072,0.0001044,0.0000914,0.0000991,0.0000976,0.0000753,0.0000565,0.0000449,0.0000123,0.0000256,0.000031,0.0000246,0.000019,0.0000195,0.0000076,0.0000334,0.0000475,0.0000441,0.0000316,0.0000173,3e-7,0,0.0000335,0.0000469,0.0000549,0.0000568,0.0000475,0.0000208,0.0000098,0.0000202,0.0000252,0.000027,0.0000238,0.0000043,0.0000118,0.000014,0.0000128,0.0000439,0.000053,0.0000526,0.0000471,0.0000371,0.0000081,0.000012,0.0000256,0.0000311,0.0000517,0.0000653,0.00006,0.0000282,0.0001362,0.000342,0.000586,0.0008849,0.0011987,0.001511,0.0017627,0.0018705,0.0018737,0.0017978,0.0015257,0.0011899,0.0008472,0.0005485,0.0002956,0.0001175,0.0000515,0.0000649,0.0000646,0.000055,0.0000285,0.0000366,0.0000467,0.0000439,0.0000414,0.0000478,0.0000451,0.0000422,0.0000459,0.0000421,0.0000347,0.0000336,0.0000257,0.0000235,0.0000504,0.0000541,0.0000533,0.0000464,0.0000359,0.0000044,0.0000168,0.0000284,0.0000311,0.000031,0.0000271,0.0000092,0.0000364,0.0000521,0.0000596,0.000069,0.0000742,0.0000674,0.0000525,0.0000446,0.0000394,0.0000306,0.0000196,0.0000275,0.000037,0.0000403,0.000038,0.0000408,0.0000596,0.0000617,0.0000642,0.0000686,0.0000695,0.0000579,0.0000501,0.0000481,0.0000345,0.0000366,0.0000425,0.0000413,0.000038,0.000035,0.0000332,0.0000503,0.0000673,0.0000721,0.000073,0.0000716,0.0000583,0.0000341,0.0000245,0.0000221,0.0000146,0.0000095,0.0000198,0.0000293,0.000035,0.0000328,0.0000201,0.0000218,0.0000234,0.0000179,0.0000193,0.0000233,0.0000219,0.0000215,0.0000209,0.0000095],"detections":[{"range_m":3.27492,"snr_db":23.9076,"width_m":0.171607}],"noise_floor":0.000032543,"blast_amplitude":0.2699602,"saturated":false}
{"timestamp":1756162801.666665,"source":"simulated","device_id":"batvu-reference-01","beam":[0.5,-0.8660254,0],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.000019,0,0,0,0.0000652,0.0000679,0.0000514,0.0000287,0.0000146,0.0000044,0.0000127,0.0000193,0.0000025,0,0.0000168,0.0000115,0.0000016,0.0000272,0.0000401,0.000047,0.0000523,0.0000343,0.0000673,0.0000893,0.0000674,0.0000421,0.0000709,0.0000653,0.0000581,0.0000614,0.0000426,0.0000193,0.0000549,0.0000538,0.0000563,0.0000573,0.0000551,0.0000145,0.0000493,0.0000547,0.0000399,0.0000632,0.0000754,0.0000624,0.0000416,0.0000352,0.0000212,0.0000173,0.0000107,0.0000119,0.0000191,0.0000213,0,0.000006,0.0000299,0.0000262,0.0000168,0.0000318,0.000039,0.0000462,0.0000503,0.0000403,0.0000122,0.0000333,0.0000436,0.0000541,0.0000672,0.0000656,0.0000381,0.0000294,0.0000321,0.0000235,0.0000384,0.000049,0.0000429,0.0000627,0.0000786,0.0000772,0.0000741,0.0000686,0.0000449,0.0000251,0.0000353,0.0000289,0.0000163,0.000038,0.0000436,0.0000531,0.0000673,0.0000643,0.0000566,0.000068,0.0000678,0.0000593,0.0000661,0.0000677,0.0000461,0.0000598,0.0000676,0.000067,0.0000647,0.0000595,0.0000346,0.000034,0.0000407,0.0000331,0.000024,0.0000256,0.000016,0.0000096,0.0000414,0.0000517,0.0000582,0.0000595,0.0000498,0.0000252,0.0000219,0.00002,0,0.0000165,0.0000181,0.0000127,0.0000152,0.0000261,0.0000325,0.0000441,0.0000467,0.0000386,0.0000315,0.000024,0,0.0000137,0.0000248,0.00002,0.0000197,0.0000336,0.0000356,0.0000359,0.0000353,0.0000261,0.0000663,0.0001539,0.0002863,0.0005058,0.0008086,0.0011371,0.0014617,0.0017678,0.0018749,0.0018799,0.0018252,0.001647,0.0013535,0.0010161,0.0006912,0.0003549,0.0001635,0.0000578,0.0000216,0.000041,0.0000528,0.0000506,0.0000427,0.0000356,0.0000257,0.000016,0.0000206,0.0000191,0.0000189,0.0000236,0.0000197,0.0000198,0.0000363,0.0000368,0.0000306,0.0000191,0.0000068,0.0000161,0.000024,0.0000257,0.0000297,0.0000516,0.0000631,0.0000624,0.0000527,0.0000413,0.0000656,0.0000898,0.0000996,0.0000961,0.0000877,0.000084,0.0000712,0.000052,0.0000414,0.0000366,0.0000389,0.0000521,0.0000521,0.0000471,0.0000463,0.0000451,0.0000387,0.000037,0.0000366,0.0000206,0.000008,0.0000083,0.0000111,0.0000114,0.0000102,0.0000019,0.0000112,0.000016,0.0000086,0.0000016,0.0000096,0.0000199,0.0000407,0.0000615,0.0000652,0.0000735,0.0000839,0.0000832,0.0000752,0.0000602,0.0000395,0.0000119,0.0000143,0.0000238,0.0000292,0.0000298,0.000028,0.00001,0.0000049,0.0000264,0.0000548,0.0000803,0.0000896,0.0000879],"detections":[{"range_m":3.333622,"snr_db":26.3499,"width_m":0.171607}],"noise_floor":0.000036678,"blast_amplitude":0.2700387,"saturated":false}
{"timestamp":1756162801.7333317,"source":"simulated","device_id":"batvu-reference-01","beam":[0.7071068,-0.7071068,0],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000137,0.000012,0.0000168,0.0000282,0.0000413,0.0000205,0,0.0000011,0.0000302,0.0000157,0.0000444,0.0000702,0.0000689,0.0000694,0.0000756,0.0000398,0.0000389,0.00004,0,0,0.000034,0.0000294,0.0000148,0.0000136,0.0000243,0.0000266,0.0000248,0.0000064,0.0000365,0.0000531,0.0000358,0.0000138,0.0000392,0.000033,0.0000022,0.0000256,0.0000384,0.0000361,0.0000251,0.0000082,0.0000105,0.0000134,0.0000139,0.0000089,0.0000327,0.0000453,0.0000434,0.0000446,0.0000441,0.0000099,0.0000069,0.0000191,0.0000011,0.0000112,0.0000458,0.000046,0.0000463,0.0000519,0.0000449,0.0000374,0.0000677,0.0000672,0.0000653,0.0000623,0.0000543,0.0000187,0.0000449,0.0000526,0.0000819,0.0001493,0.0002163,0.0002835,0.0003488,0.0003746,0.0003668,0.0003385,0.0002987,0.0002248,0.0001454,0.0000853,0.0000306,5e-7,0.0000299,0.0000353,0.0000362,0.0000348,0.0000174,0,0.000014,0.0000133,0.0000284,0.0000596,0.0000672,0.000073,0.0000774,0.0000779,0.0000488,0.0000523,0.0000564,0.0000491,0.000054,0.0000606,0.0000546,0.000047,0.0000471,0.0000319,0.0000185,0.0000322,0.0000422,0.0000491,0.0000495,0.0000291,0,0.0000144,0.0000151,0.0000304,0.0000583,0.0000607,0.0000572,0.0000487,0.0000336,0.0000013,0.0000108,0.0000142,0.0000085,0.00002,0.0000232,0.0000158,0.0000284,0.0000533,0.0000673,0.0000746,0.0000749,0.0000522,0.0000326,0.000052,0.000062,0.0000683,0.0000683,0.0000493,0.0000675,0.0001936,0.0003584,0.0005937,0.0008879,0.0011807,0.0014459,0.00166,0.0016919,0.0016765,0.0015576,0.0013459,0.0010596,0.0007694,0.0005193,0.0002829,0.000163,0.0001076,0.0000769,0.0000655,0.0000681,0.0000602,0.0000546,0.0000609,0.0000563,0.0000461,0.0000365,0.0000233,0.000007,0.0000026,0.0000049,0.0000082,0.0000189,0.0000214,0.0000284,0.000043,0.0000546,0.0000659,0.0000753,0.0000765,0.0000625,0.0000529,0.0000542,0.000044,0.0000327,0.0000248,0.0000079,0.0000087,0.0000285,0.0000341,0.0000386,0.0000459,0.0000505,0.0000616,0.0000703,0.0000679,0.0000655,0.0000768,0.0000766,0.0000691,0.0000543,0.0000364,0.0000246,0.0000408,0.0000437,0.0000397,0.0000422,0.0000433,0.0000309,0.0000175,0.0000298,0.0000469,0.0000656,0.0000779,0.000081,0.0000888,0.0000936,0.0000878,0.0000734,0.0000582,0.00004,0.000022,0.0000253,0.0000256,0.0000312,0.00004,0.0000394,0.0000332,0.0000256,0.0000074,0.0000297,0.0000488,0.0000515,0.0000443,0.0000323,0.0000266,0.0000329,0.0000435,0.0000465,0.000038],"detections":[{"range_m":1.942919,"snr_db":9.2414,"width_m":0.150156},{"range_m":3.323008,"snr_db":20.8997,"width_m":0.171607}],"noise_floor":0.000040071,"blast_amplitude":0.2700149,"saturated":false}
{"timestamp":1756162801.7999983,"source":"simulated","device_id":"batvu-reference-01","beam":[0.8660254,-0.5,0],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0001062,0.0001065,0.0001062,0.0001054,0.0001035,0.0000774,0,0.0000038,0.0000446,0.0000358,0.0000228,0.0000188,0.0000324,0.0000519,0.0000599,0.0000109,0.0000363,0.0000586,0.0000449,0.0000293,0.0000307,0.0000318,0.0000525,0.0000678,0.0000445,0.0000548,0.0000929,0.000085,0.0000593,0.0000318,0.0000402,0.0000567,0.0000664,0.0000562,0.0000174,0.0000288,0.0000332,0.0000123,0.0000106,0.0000139,0.0000035,0,0.0000173,0.0000226,0.0000251,0.0000259,0.0000126,0.0000417,0.0000605,0.0000518,0.0000438,0.0000643,0.0000617,0.0000607,0.0000581,0.000036,0.0000151,0.0000263,0.0000216,0.0000122,0.0000449,0.0000498,0.0000545,0.0000555,0.0000508,0.0000114,0.0000396,0.000046,0.0000726,0.0001508,0.0002531,0.0003889,0.0005567,0.000723,0.0008033,0.0008289,0.0008266,0.0007529,0.0006294,0.0004972,0.0003537,0.0001926,0.0001037,0.0000394,0.0000046,0.0000149,0.0000135,0.0000097,0.0000153,0.0000132,0.0000091,0.0000153,0.0000152,0.0000157,0.0000251,0.0000274,0.0000331,0.0000723,0.0000891,0.0000892,0.0000812,0.0000621,0.0000252,0.0000387,0.0000448,0.0000338,0.0000388,0.0000603,0.0000634,0.0000641,0.0000639,0.0000492,0.0000398,0.0000517,0.0000491,0.0000382,0.0000506,0.000052,0.0000525,0.0000575,0.0000566,0.0000609,0.0000729,0.000075,0.0000599,0.0000477,0.0000493,0.0000489,0.0000585,0.000063,0.0000565,0.0000639,0.0000699,0.0001042,0.0002353,0.0004372,0.0006797,0.0009529,0.0012115,0.0014189,0.0014911,0.0014927,0.0014249,0.0012436,0.0010042,0.0007468,0.0004932,0.0002947,0.0001383,0.0000569,0.0000483,0.0000505,0.000041,0.0000453,0.0000498,0.0000391,0.0000273,0.0000221,0.0000211,0.0000362,0.0000481,0.0000466,0.0000408,0.0000331,0.0000181,0.0000288,0.0000647,0.0000819,0.0000887,0.0000886,0.0000719,0.000047,0.0000426,0.0000398,0.0000186,0.0000078,0.0000232,0.0000355,0.0000504,0.0000536,0.0000555,0.0000689,0.0000756,0.0000729,0.0000676,0.0000636,0.0000498,0.0000443,0.0000492,0.0000442,0.0000355,0.0000311,0.0000196,0.0000301,0.0000653,0.0000827,0.0000916,0.0000928,0.0000884,0.0000655,0.0000453,0.0000344,0.0000264,0.000049,0.0000607,0.0000624,0.0000614,0.0000521,0.0000273,0.0000173,0.0000188,0.0000093,0,0.0000153,0.0000302,0.0000515,0.0000691,0.0000772,0.0000878,0.0000941,0.0000891,0.0000676,0.000035,0.0000134,0.0000333,0.0000525,0.0000584,0.0000704,0.0000929,0.0000983,0.0001041,0.0001082,0.0001082,0.0000887,0.0000649,0.0000452,0.0000246,0.0000367,0.0000536,0.0000613],"detections":[{"range_m":1.986331,"snr_db":17.0724,"width_m":0.171607},{"range_m":3.184895,"snr_db":20.1425,"width_m":0.171607}],"noise_floor":0.00004538,"blast_amplitude":0.2699941,"saturated":false}
{"timestamp":1756162801.866665,"source":"simulated","device_id":"batvu-reference-01","beam":[0.9659258,-0.258819,0],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000103,0.0000375,0.0000249,0,0.000012,0.0000755,0.0000843,0.0000889,0.0000893,0.0000262,0.0000417,0.0000676,0.0000523,0.000036,0.0000222,0,0.0000025,0.0000144,0.0000047,0,0.0000209,0.0000333,0.0000441,0.0000492,0.0000253,0.0000013,0.000041,0.0000347,0.0000228,0.000048,0.0000449,0.0000375,0.0000354,0.0000339,0,0.0000052,0.000013,0.0000102,0.0000274,0.0000459,0.0000601,0.0000711,0.0000726,0.0000363,0.0000179,0.0000302,0.0000207,0.0000182,0.0000364,0.000032,0.0000416,0.0000509,0.000039,0.0000255,0.0000666,0.0000699,0.0000686,0.0000591,0.0000325,0,1e-7,2e-7,0,0.0000236,0.0000384,0.0000929,0.0002118,0.0003516,0.0005071,0.0006679,0.0007945,0.0008294,0.0008301,0.0008018,0.0006985,0.0005622,0.0004353,0.0003131,0.0001889,0.0001283,0.0000804,0.0000445,0.0000419,0.0000383,0.0000532,0.0000996,0.000111,0.0001182,0.0001197,0.000115,0.0000808,0.0000637,0.0000655,0.0000474,0.0000374,0.0000353,0.0000195,0.000026,0.0000305,0.0000196,0.0000226,0.0000292,0.0000219,0.0000103,0.0000076,0.0000066,0.0000116,0.0000225,0.000018,0.0000747,0.0002016,0.0003768,0.0006297,0.0009458,0.0013221,0.0016017,0.0017941,0.0018352,0.0018208,0.0016935,0.0014603,0.0011435,0.0008274,0.0005176,0.0003147,0.000184,0.0001121,0.0000585,0.000026,0.0000343,0.0000368,0.0000392,0.0000416,0.0000336,0.0000423,0.0000669,0.0000732,0.0000739,0.000072,0.0000559,0.0000272,0.0000231,0.0000228,0.0000166,0.000019,0.0000216,0.0000333,0.000049,0.0000525,0.0000569,0.0000739,0.0000806,0.0000703,0.0000511,0.0000363,0.0000369,0.0000415,0.0000417,0.0000272,0.0000113,0.0000198,0.000017,0.0000092,0.0000239,0.0000319,0.0000421,0.0000552,0.0000539,0.0000492,0.0000482,0.0000455,0.000029,0.0000303,0.00004,0.0000445,0.0000475,0.0000483,0.0000443,0.0000579,0.0000644,0.0000626,0.0000725,0.0000777,0.0000748,0.0000687,0.0000591,0.0000366,0.0000248,0.0000377,0.0000363,0.0000322,0.000029,0.0000175,0.0000091,0.0000367,0.000043,0.0000434,0.0000429,0.000041,0.0000384,0.0000503,0.000054,0.0000601,0.0000768,0.0000806,0.0000796,0.0000784,0.0000761,0.0000589,0.0000419,0.0000369,0.0000284,0.0000207,0.0000238,0.0000209,0.0000155,0.0000113,0.0000188,0.0000289,0.0000349,0.0000331,0.0000445,0.0000613,0.0000619,0.0000577,0.000049,0.0000333,0.0000117,0.0000293,0.0000461,0.0000596,0.0000693,0.0000713,0.0000613,0.0000485,0.0000457,0.0000343],"detections":[{"range_m":1.972917,"snr_db":13.4923,"width_m":0.168032},{"range_m":2.809088,"snr_db":23.5471,"width_m":0.171607}],"noise_floor":0.000036602,"blast_amplitude":0.2699966,"saturated":false}
{"timestamp":1756162801.9333315,"source":"simulated","device_id":"batvu-reference-01","beam":[1,0,0],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000647,0.0000395,0,0,0.0000399,0.0000476,0.0000476,0.0000455,0.0000474,0.0000077,0.0000181,0.0000302,0.0000192,0.0000244,0.0000281,0,0,0.0000116,0,0.0000155,0.000066,0.0000795,0.000084,0.0000838,0.000037,0.0000062,0.0000486,0.0000462,0.0000483,0.0000513,0.0000274,0,0.0000252,0.0000213,0.0000034,0.0000018,0.0000097,0.0000045,0.0000417,0.0000545,0.0000593,0.000061,0.0000607,0.0000148,0.000007,0.0000201,0.0000087,0.0000254,0.000058,0.0000614,0.0000613,0.0000587,0.000026,0.0000192,0.0000459,0.0000442,0.0000393,0.0000324,0.0000195,0.0000257,0.0000352,0.000027,0,0.0000208,0.0000247,0.0000183,0.0000244,0.000063,0.0001256,0.0002194,0.0003196,0.0004518,0.0006201,0.0007829,0.0008471,0.0008542,0.0008346,0.0007291,0.0005878,0.00046,0.0003386,0.0002081,0.0001342,0.0000704,0.0000344,0.000063,0.0000632,0.0000649,0.0000708,0.0000645,0.0000671,0.0001017,0.0001058,0.0001028,0.000088,0.0000625,0.0000043,0.0000351,0.0000424,0.0000488,0.0000777,0.000098,0.0000988,0.0000951,0.0000872,0.0001527,0.0003149,0.0005536,0.0008518,0.0012124,0.0016506,0.0019343,0.0021077,0.0021418,0.0021088,0.0019222,0.0016278,0.0012783,0.0008434,0.0005507,0.0003389,0.0001846,0.0001015,0.0000678,0.0000397,0.0000602,0.0000689,0.0000686,0.0000629,0.0000505,0.0000268,0.0000433,0.0000524,0.0000437,0.000038,0.000043,0.0000355,0.0000206,0.0000109,0.0000154,0.0000203,0.0000239,0.0000185,0.0000078,0.0000137,0.0000181,0.0000322,0.0000563,0.0000577,0.0000633,0.0000737,0.0000757,0.0000632,0.0000494,0.0000381,0.0000355,0.0000603,0.0000702,0.000067,0.0000581,0.000051,0.0000388,0.0000605,0.0000851,0.0000909,0.0000917,0.0000908,0.0000778,0.0000506,0.000033,0.000032,0.0000403,0.0000457,0.0000427,0.000016,0.0000312,0.0000547,0.0000614,0.0000691,0.0000713,0.0000673,0.0000645,0.0000598,0.0000395,0.000022,0.0000179,0.0000219,0.0000442,0.000062,0.0000623,0.000057,0.000042,0.0000088,0.0000235,0.0000355,0.0000343,0.0000381,0.0000614,0.0000744,0.0000862,0.0000884,0.000085,0.0000657,0.0000675,0.0000701,0.0000657,0.0000576,0.0000494,0.0000354,0.0000312,0.0000288,0.0000104,0.0000103,0.000028,0.0000363,0.0000484,0.0000558,0.000053,0.0000467,0.0000435,0.0000356,0.0000154,0.0000222,0.0000345,0.0000417,0.0000442,0.0000419,0.0000287,0.000036,0.0000408,0.0000554,0.0000745,0.0000779,0.0000708,0.0000507,0.0000401,0.0000617,0.0000734,0.000074,0.0000585],"detections":[{"range_m":1.977967,"snr_db":15.2254,"width_m":0.168032},{"range_m":2.678728,"snr_db":20.6919,"width_m":0.175182}],"noise_floor":0.000040832,"blast_amplitude":0.2699939,"saturated":false}
{"timestamp":1756162801.999998,"source":"simulated","device_id":"batvu-reference-01","beam":[0.9659258,0.258819,0],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.00002,0.0000234,0.0000197,0.0000269,0.0000337,0,0.0000229,0.000058,0.0000589,0.0000563,0.000045,0,0.0000206,0.000029,0,0.0000038,0.0000388,0.0000339,0.0000199,0.000009,0.0000245,0.0000339,0.0000352,0.0000102,0.0000303,0.0000681,0.0000568,0.000031,0.0000181,0.0000079,0,0.0000465,0.0000559,0.0000517,0.0000453,0.0000441,0.0000162,0.0000185,0.0000297,0.0000371,0.0000446,0.0000461,0.0000158,0.0000388,0.0000682,0.0000743,0.0000786,0.0000789,0.000045,0.0000171,0.0000339,0.0000283,0.0000282,0.0000443,0.0000401,0.0000256,0.0000431,0.0000399,0.0000256,0.0000146,0.0000094,0.0000062,0.0000376,0.00005,0.0000662,0.0000895,0.000095,0.0000787,0.0000568,0.0000403,0.0000085,0.0000079,0.0000427,0.0000613,0.0000755,0.000081,0.0000673,0.0000526,0.0000642,0.0000588,0.0000466,0.0000392,0.000032,0.0000314,0.0000655,0.0000686,0.0000688,0.000066,0.0000534,0.0000165,0.0000133,0.0000179,0.0000129,0.0000146,0.0000154,0.0000148,0.0000475,0.0000744,0.0000878,0.000095,0.0000962,0.0000753,0.0000505,0.0000353,0.0000142,0.0000117,0.0000645,0.0001429,0.0002986,0.0005424,0.0008519,0.0012387,0.0016612,0.0020918,0.0023366,0.0024222,0.0024139,0.0022551,0.0019503,0.001561,0.0011316,0.0007522,0.0004186,0.0002234,0.0001178,0.0000866,0.0000724,0.0000639,0.0000715,0.0000753,0.0000876,0.0000959,0.0000908,0.0000806,0.0000738,0.0000585,0.000025,0.0000212,0.0000175,0.0000011,0.0000439,0.0000635,0.0000694,0.0000689,0.0000535,0.0000264,0.0000466,0.0000523,0.0000581,0.0000742,0.000082,0.0000763,0.0000638,0.0000472,0.0000172,0.0000277,0.0000388,0.000036,0.0000281,0.0000292,0.0000259,0.0000256,0.0000287,0.0000246,0.0000281,0.0000438,0.0000428,0.0000367,0.0000428,0.0000478,0.0000601,0.0000756,0.0000786,0.0000727,0.0000674,0.0000627,0.000043,0.0000404,0.0000466,0.0000514,0.0000648,0.00007,0.0000665,0.000065,0.0000663,0.0000567,0.0000384,0.0000261,0.0000332,0.0000429,0.0000492,0.0000459,0.0000434,0.0000561,0.0000565,0.0000593,0.0000672,0.0000665,0.0000672,0.0000796,0.0000821,0.0000762,0.0000683,0.0000677,0.0000603,0.0000536,0.0000411,0.0000098,0.000024,0.0000371,0.0000361,0.0000377,0.0000431,0.0000475,0.0000654,0.0000855,0.0000869,0.0000856,0.0000757,0.0000555,0.0000248,0.0000167,0.0000278,0.0000372,0.0000483,0.0000476,0.000045,0.0000552,0.0000578,0.0000559,0.0000575,0.0000596,0.0000539,0.0000549,0.0000587,0.0000573],"detections":[{"range_m":2.794828,"snr_db":22.1958,"width_m":0.171607}],"noise_floor":0.000046455,"blast_amplitude":0.2700394,"saturated":false}
{"timestamp":1756162802.0666647,"source":"simulated","device_id":"batvu-reference-01","beam":[0.8660254,0.5,0],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000148,0.0000266,0.0000302,0.0000303,0.000031,0,0.0000012,0.0000146,0.0000089,0.0000074,0.0000054,0.0000031,0.000007,0.0000081,0,0.0000017,0.0000062,0,0,0.0000226,0.0000202,0.0000169,0.0000165,0,0,0.0000567,0.000064,0.0000686,0.0000706,0.0000576,0.0000123,0.0000176,0.0000251,0.0000224,0.0000321,0.0000341,0.0000186,0.0000321,0.0000397,0.0000253,0.0000148,0.0000118,0.0000109,0.0000199,0.0000253,0.0000108,0.0000094,0.0000248,0.0000208,0.0000452,0.0000805,0.0000849,0.0000851,0.0000815,0.0000584,0.0000266,0.0000433,0.0000386,0.0000212,0.0000412,0.0000426,0.0000261,0.0000377,0.0000412,0.0000406,0.00004,0.0000368,0,0.0000159,0.0000336,0.0000298,0.0000262,0.00003,0.0000191,0.0000182,0.0000385,0.0000408,0.0000456,0.0000552,0.000052,0.0000514,0.0000506,0.0000348,0.000009,0.0000313,0.0000292,0.0000178,0.0000168,0.0000243,0.0000325,0.0000388,0.00004,0.0000229,0.0000442,0.0000521,0.0000511,0.000049,0.000044,0.0000176,0.0000229,0.0000349,0.0000369,0.0000433,0.0000468,0.0000337,0.000011,0.0000588,0.0000855,0.0001071,0.000116,0.0001081,0.00008,0.0000598,0.0000482,0.0000201,0.0000128,0.0000102,0,0.0000229,0.0000359,0.0000423,0.0000493,0.0000621,0.0001617,0.0003655,0.0006496,0.0009948,0.0013773,0.0017909,0.0020263,0.0021271,0.0021282,0.0020198,0.0017529,0.0013953,0.0010078,0.0005898,0.0003492,0.0001998,0.0001098,0.0000691,0.0000508,0.0000273,0.0000309,0.0000302,0.0000198,0.0000132,0.0000165,0.0000162,0.0000151,0.0000118,0.0000104,0.0000168,0.0000187,0.0000072,0.0000073,0.0000175,0.0000162,0.0000196,0.0000337,0.0000434,0.0000548,0.0000606,0.0000546,0.0000356,0.0000339,0.0000328,0.0000288,0.0000303,0.000029,0.0000225,0.0000323,0.0000348,0.0000241,0.0000114,0.000031,0.0000442,0.0000523,0.0000546,0.0000445,0.0000318,0.000015,0.0000197,0.0000414,0.0000553,0.0000572,0.0000639,0.0000724,0.0000693,0.0000635,0.0000599,0.0000544,0.0000508,0.0000588,0.0000578,0.0000493,0.0000477,0.0000459,0.0000349,0.000029,0.000027,0.0000153,0.0000302,0.000037,0.0000494,0.0000738,0.0000921,0.0000995,0.0001049,0.0001084,0.0001019,0.0000973,0.0000956,0.0000831,0.0000632,0.0000486,0.0000403,0.0000505,0.0000565,0.0000523,0.0000376,0.0000245,0.0000126,0.0000211,0.0000422,0.0000427,0.0000382,0.00003,0.0000198,0.0000065,0.0000254,0.000039,0.00005,0.0000656,0.0000711,0.0000664],"detections":[{"range_m":3.073406,"snr_db":23.4035,"width_m":0.175182}],"noise_floor":0.00003081,"blast_amplitude":0.2699623,"saturated":false}
{"timestamp":1756162802.1333313,"source":"simulated","device_id":"batvu-reference-01","beam":[0.7071068,0.7071068,0],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000179,0.0000468,0.0000735,0.0000897,0.0000917,0.0000641,0,0.0000099,0.0000424,0.0000334,0.0000369,0.000039,0,0,0.0000125,0.0000095,0.000033,0.0000515,0.000037,0.0000369,0.0000553,0.0000404,0.0000259,0.0000308,0.0000228,0.00003,0.0000328,0.000008,0,0.0000146,0.000009,0.0000037,0.0000224,0.0000188,0.0000229,0.000055,0.0000618,0.0000558,0.0000638,0.0000638,0.0000337,0.0000588,0.0000706,0.0000586,0.0000485,0.0000485,0.0000162,0.0000363,0.0000565,0.0000476,0.0000266,0.0000265,0.0000353,0.0000361,0.0000339,0.0000158,0.0000257,0.0000391,0.0000344,0.0000218,0.0000253,0.0000156,0.0000157,0.0000559,0.0000618,0.0000615,0.0000586,0.0000508,0.0000138,0.0000107,0.0000218,0.000033,0.0000511,0.0000586,0.000043,0.0000501,0.0000694,0.0000744,0.0000775,0.0000775,0.0000567,0.0000286,0.0000413,0.0000361,0.0000224,0.0000205,0.0000193,0.0000184,0.0000177,0.000017,0.0000321,0.0000509,0.0000513,0.0000489,0.0000702,0.0000771,0.0000719,0.0000699,0.0000706,0.0000519,0.0000705,0.0000852,0.0000848,0.0000794,0.0000701,0.0000387,0.0000155,0.0000238,0.0000191,0.0000096,0.0000222,0.00003,0.0000489,0.0000751,0.0000786,0.0000792,0.000078,0.0000686,0.0000418,0.0000576,0.0000573,0.0000447,0.0000441,0.0000463,0.0000328,0.0000154,0.0000086,0.000009,0.0000212,0.0000475,0.0000617,0.0000648,0.0000625,0.0000291,0.0000236,0.0000364,0.00004,0.000088,0.0001989,0.000411,0.0006833,0.0010174,0.0013495,0.001646,0.0018497,0.0018988,0.0018876,0.0017634,0.0014618,0.0011188,0.0007763,0.0004859,0.0002579,0.0001271,0.0000833,0.000076,0.00009,0.0000953,0.0000876,0.0000749,0.0000654,0.0000489,0.0000461,0.000057,0.0000547,0.0000448,0.0000322,0.000018,0.0000221,0.0000321,0.0000285,0.0000185,0.0000208,0.0000189,0.0000043,0.0000108,0.0000156,0.0000122,0.0000084,0.0000105,0.0000188,0.0000407,0.0000587,0.0000671,0.0000757,0.0000781,0.0000684,0.0000582,0.0000581,0.0000542,0.0000654,0.0000827,0.0000852,0.000086,0.0000856,0.000075,0.0000514,0.0000348,0.0000268,0.0000221,0.0000325,0.0000321,0.000025,0.0000222,0.0000233,0.0000152,0.0000261,0.0000334,0.0000341,0.0000337,0.0000341,0.0000258,0.0000178,0.0000172,0.0000313,0.0000424,0.0000447,0.0000346,0.0000138,0.0000167,0.000033,0.0000572,0.0000731,0.0000727,0.0000667,0.0000612,0.0000597,0.0000521,0.0000472,0.0000429,0.0000342,0.0000321,0.0000293,0.0000107,0.0000377,0.0000594,0.0000611,0.0000581,0.0000448,0.000037],"detections":[{"range_m":3.26781,"snr_db":21.9042,"width_m":0.171607}],"noise_floor":0.000039872,"blast_amplitude":0.2699689,"saturated":false}
{"timestamp":1756162802.199998,"source":"simulated","device_id":"batvu-reference-01","beam":[0.5,0.8660254,0],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.000009,0.0000061,4e-7,0,0.0000175,0.0000255,0.0000304,0.0000352,0.0000399,0,0.0000337,0.0000607,0.0000608,0.0000593,0.0000554,0,0.0000124,0.0000517,0.0000651,0.0000774,0.0000828,0.0000455,0.0000376,0.0000733,0.0000706,0.0000686,0.0000671,0.0000362,0,0.0000313,0.000023,0.0000028,0.000028,0.0000315,0.0000318,0.0000306,0.000024,0,0.0000053,0.0000056,0,0.0000334,0.0000516,0.0000478,0.0000367,0.0000306,0,0.0000328,0.0000801,0.0001036,0.0001503,0.0002442,0.0003295,0.0004269,0.0005005,0.0005198,0.0005278,0.0005281,0.0005042,0.0004084,0.0003189,0.0002186,0.000109,0.0000472,0.0000229,0,0.0000109,0.00001,0,0.0000293,0.0000486,0.0000578,0.0000679,0.0000714,0.0000474,0.0000512,0.0000612,0.0000513,0.000032,0.0000233,0.0000193,0.0000094,0.0000283,0.0000446,0.0000543,0.0000566,0.0000465,0.0000268,0.0000613,0.0000665,0.0000674,0.0000649,0.0000487,0.0000029,0.0000298,0.000042,0.0000567,0.0000859,0.0000998,0.0001079,0.0001159,0.0001175,0.0000969,0.0000721,0.0000689,0.0000494,0.0000297,0.0000524,0.0000614,0.0000665,0.0000675,0.0000531,0.000033,0.0000296,0.0000227,0.0000064,0.0000304,0.0000354,0.0000366,0.0000401,0.0000381,0.0000264,0.0000408,0.0000459,0.0000436,0.0000403,0.0000336,0.0000097,0.0000114,0.0000141,0.0000024,0.0000091,0.0000274,0.0000304,0.0000321,0.0000322,0.0000192,0.0000176,0.0000345,0.0000336,0.0000244,0.0000333,0.0000652,0.0001371,0.0002642,0.0004341,0.0006711,0.0010202,0.0012919,0.0015116,0.0016357,0.0016479,0.0015996,0.0014403,0.0012047,0.0008586,0.0005831,0.0003582,0.0001789,0.0000593,0.0000266,0.0000412,0.0000539,0.0000588,0.0000509,0.0000365,0.0000301,0.0000244,0.0000108,0.0000241,0.0000283,0.0000289,0.0000273,0.0000193,0.0000174,0.0000325,0.0000353,0.0000325,0.0000397,0.0000412,0.0000299,0.0000199,0.000018,0.0000131,0.0000411,0.0000654,0.0000796,0.0000894,0.0000932,0.0000862,0.0000772,0.0000779,0.0000685,0.0000491,0.0000284,0.000017,0.000039,0.0000563,0.0000562,0.0000494,0.0000454,0.0000429,0.0000274,0.0000205,0.0000232,0.0000315,0.0000497,0.0000537,0.0000534,0.0000537,0.000053,0.0000345,0.0000098,0.0000313,0.0000407,0.0000444,0.0000446,0.0000346,0.0000215,0.0000238,0.0000215,0.0000156,0.0000138,0.0000106,0.0000197,0.0000442,0.0000605,0.0000775,0.0000924,0.0000913,0.0000794,0.0000673,0.000057,0.0000322,0.0000174,0.0000278,0.0000307,0.000031,0.000031,0.0000204],"detections":[{"range_m":1.640507,"snr_db":13.9003,"width_m":0.171607},{"range_m":3.370651,"snr_db":25.5498,"width_m":0.175182}],"noise_floor":0.000034518,"blast_amplitude":0.2699966,"saturated":false}
{"timestamp":1756162802.2666645,"source":"simulated","device_id":"batvu-reference-01","beam":[0.258819,0.9659258,0],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000394,0.000043,0.0000309,0.0000135,0.0000092,0.000012,0.0000115,0.0000088,0.0000246,0.0000385,0.0000428,0,0.000001,0.0000068,0,0.000034,0.0000698,0.000061,0.00004,0.0000339,0.0000137,0.0000112,0.0000216,0.0000091,0,0.0000247,0.0000229,0.000021,0.0000173,0,0.0000054,0.0000145,0.0000143,0,0.0000145,0.00002,0.0000066,0.0000071,0.0000389,0.0000598,0.000078,0.0000819,0.0000572,0.0000691,0.0000981,0.0001263,0.0001913,0.0002943,0.0003882,0.0005154,0.0006329,0.000683,0.0006911,0.0006816,0.0006154,0.0004661,0.0003577,0.0002628,0.0001628,0.0000983,0.0000639,0.0000187,0.0000294,0.0000385,0.0000398,0.0000396,0.0000374,0.0000058,0.0000041,0.0000158,0.0000128,0.0000208,0.0000265,0.0000168,0.0000223,0.0000395,0.0000365,0.000026,0.0000187,0.0000176,0.0000242,0.0000272,0.0000176,0,0.0000232,0.0000213,0.0000195,0.0000505,0.0000553,0.0000541,0.0000434,0.0000242,0.0000347,0.0000556,0.0000588,0.0000451,0.0000468,0.0000519,0.0000384,0.0000097,0.0000258,0.0000347,0.000036,0.0000354,0.0000214,0.000036,0.0000682,0.0000775,0.000091,0.0001075,0.0001067,0.0001079,0.0001105,0.0001072,0.000078,0.0000663,0.0000634,0.0000512,0.0000677,0.0000718,0.0000635,0.0000514,0.0000515,0.0000532,0.0000581,0.0000598,0.0000457,0.0000319,0.0000351,0.0000451,0.0000576,0.000063,0.0000534,0.0000371,0.0000598,0.0001108,0.0002009,0.0003442,0.0005346,0.0007944,0.0010935,0.0013541,0.0015428,0.0016226,0.0016151,0.0015021,0.0013026,0.0010569,0.00078,0.0005289,0.0003322,0.0001663,0.0001041,0.0000867,0.0000629,0.000037,0.0000181,0.0000094,0.0000186,0.0000242,0.0000251,0.0000368,0.0000479,0.0000462,0.0000443,0.0000529,0.0000494,0.0000378,0.0000285,0.0000191,0.0000012,0.0000231,0.0000295,0.0000281,0.0000224,0.0000182,0.0000202,0.000027,0.0000288,0.0000177,0.0000124,0.0000157,0.0000091,5e-7,0.0000091,0.0000099,0.0000096,0.0000081,0.0000047,0.0000168,0.00004,0.0000537,0.0000669,0.0000752,0.0000735,0.0000613,0.0000639,0.0000626,0.0000502,0.0000365,0.0000249,0.0000143,0.000026,0.0000279,0.0000253,0.0000384,0.000048,0.0000526,0.0000604,0.0000657,0.0000599,0.0000568,0.0000609,0.0000573,0.0000593,0.0000734,0.0000802,0.00009,0.0000945,0.0000898,0.0000751,0.0000617,0.0000474,0.0000235,0.0000264,0.0000262,0.0000174,0.0000235,0.0000537,0.0000802,0.000102,0.0001094,0.0001075,0.0001057,0.0001056,0.0000928],"detections":[{"range_m":1.629893,"snr_db":16.9165,"width_m":0.171607},{"range_m":3.30911,"snr_db":20.815,"width_m":0.175182}],"noise_floor":0.000040869,"blast_amplitude":0.2699916,"saturated":false}
{"timestamp":1756162802.333331,"source":"simulated","device_id":"batvu-reference-01","beam":[0,1,0],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000313,0.000023,0.0000081,0,0.0000527,0.0000721,0.0000841,0.0000858,0.0000841,0.00001,0.0000109,0.0000316,0.0000181,0.0000289,0.0000514,0.0000456,0.0000475,0.0000482,0,2e-7,0.0000377,0.0000328,0.0000291,0.0000448,0.0000299,0.0000473,0.0000937,0.0000939,0.0000921,0.000078,0.0000295,0,0.0000317,0.0000277,0.0000331,0.000062,0.0000664,0.0000392,0.000031,0.0000301,0,0.0000194,0.0000379,0.0000339,0.0000168,0.0000206,0.0000348,0.0000379,0.0000354,0.0000265,0.0000977,0.0001994,0.0002905,0.0004165,0.0005346,0.0005874,0.0005984,0.0005926,0.0005343,0.0003968,0.000299,0.0002134,0.0001178,0.0000488,0.0000182,0.0000374,0.0000446,0.0000418,0.0000112,0.0000269,0.0000365,0.0000328,0.0000281,0.0000223,0.0000045,0.0000186,0.0000241,0.0000098,0,0.0000133,0.000011,0.0000138,0.0000309,0.0000346,0.0000437,0.0000569,0.0000547,0.0000578,0.0000663,0.0000582,0.0000332,0.0000301,0.0000286,0.000008,0.000005,0.0000143,0.0000121,0.0000086,0.0000083,0,0.0000104,0.000021,0.0000175,0.0000294,0.0000434,0.0000434,0.0000415,0.0000366,0.0000233,0.0000312,0.0000425,0.0000359,0.0000291,0.0000449,0.0000443,0.0000427,0.0000421,0.0000385,0.0000164,0.0000381,0.000043,0.0000476,0.0000531,0.0000542,0.0000415,0.000066,0.0000733,0.000073,0.0000713,0.0000687,0.000048,0.0000312,0.0000293,0.000023,0.0001326,0.000307,0.0005341,0.0008192,0.0011287,0.0014517,0.0016511,0.0017366,0.0017334,0.0016363,0.0014251,0.0011409,0.0008236,0.0005486,0.0003074,0.0001608,0.0000743,0.0000369,0.000017,0.0000302,0.0000374,0.0000302,0.0000151,0.0000172,0.0000284,0.0000375,0.0000444,0.0000423,0.0000475,0.0000512,0.0000445,0.0000489,0.0000652,0.0000649,0.0000605,0.0000529,0.000036,0.0000137,0.0000193,0.00002,0.0000162,0.0000264,0.0000433,0.0000502,0.0000512,0.0000498,0.0000281,0.0000132,0.0000191,0.0000246,0.000037,0.0000432,0.0000423,0.0000423,0.0000407,0.0000268,0.0000241,0.0000418,0.0000423,0.0000418,0.0000382,0.0000255,0.0000091,0.0000289,0.0000382,0.0000543,0.0000707,0.0000713,0.0000749,0.0000868,0.0000901,0.0000882,0.0000854,0.0000803,0.000061,0.000056,0.00006,0.000057,0.000055,0.0000572,0.0000529,0.0000631,0.00007,0.0000656,0.0000522,0.0000358,0.0000131,0.0000204,0.0000401,0.0000465,0.0000554,0.0000643,0.0000629,0.0000483,0.0000292,0.0000225,0.0000334,0.0000378,0.0000376,0.0000186,0.0000076,0.000031,0.0000466,0.0000637,0.00007,0.0000672],"detections":[{"range_m":1.631952,"snr_db":17.1802,"width_m":0.168032},{"range_m":3.199946,"snr_db":22.4903,"width_m":0.175182}],"noise_floor":0.000040592,"blast_amplitude":0.2699973,"saturated":false}
{"timestamp":1756162802.3999977,"source":"simulated","device_id":"batvu-reference-01","beam":[-0.258819,0.9659258,0],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000321,0.0000152,0,0,0.0000349,0.0000405,0.0000357,0.0000229,0.0000286,0.0000224,0.0000289,0.0000307,0,0.0000313,0.0000777,0.0000858,0.0000874,0.0000865,0.0000281,0.0000218,0.0000509,0.0000403,0.0000247,0.0000228,0.0000054,0.0000094,0.0000211,0.0000086,1e-7,0.0000447,0.0000513,0.0000558,0.0000559,0.0000396,0.0000135,0.0000487,0.0000538,0.0000268,0.0000112,0.0000038,0,0.0000015,0.000008,0,0.0000327,0.0000612,0.0000743,0.0000929,0.0001121,0.000163,0.0002922,0.0005003,0.0006666,0.0008208,0.0009145,0.0009201,0.0009045,0.0008458,0.000739,0.0005447,0.0003912,0.0002496,0.0001192,0.0000523,0.0000338,0.0000024,0.0000181,0.0000304,0.0000513,0.0000833,0.0000918,0.0000793,0.0000567,0.0000363,0.0000395,0.0000516,0.0000537,0.000029,0.0000052,0.0000206,0.0000169,0.0000153,0.0000352,0.000037,0.0000388,0.0000419,0.0000359,0.0000525,0.0000853,0.0000838,0.0000695,0.0000494,0.0000269,0.0000149,0.000031,0.0000341,0.0000151,0.0000117,0.0000409,0.0000629,0.0000834,0.0000904,0.0000819,0.0000812,0.0000851,0.0000714,0.0000543,0.0000459,0.0000311,0.0000177,0.0000536,0.000068,0.0000762,0.0000768,0.0000641,0.0000324,0.0000227,0.0000216,0.0000223,0.0000482,0.0000506,0.0000495,0.0000449,0.0000383,0.0000111,0.0000169,0.000025,0.0000346,0.0000531,0.0000631,0.0000643,0.0000726,0.0000773,0.0000762,0.0001728,0.0003356,0.0005298,0.000752,0.0009733,0.0011795,0.0012975,0.0013377,0.0013278,0.0012339,0.0010635,0.0008454,0.0006047,0.0004028,0.0002297,0.0001161,0.0000404,0.0000204,0.0000231,0.0000194,0.0000252,0.000053,0.0000767,0.000084,0.0000794,0.0000755,0.0000782,0.0000688,0.0000503,0.0000352,0.0000311,0.0000373,0.0000406,0.0000339,0.0000135,0.0000151,0.000022,0.000025,0.0000251,0.0000192,0.0000045,0.0000291,0.0000371,0.000037,0.0000365,0.0000363,0.0000174,0.0000101,0.0000278,0.0000353,0.0000413,0.000043,0.000033,0.000025,0.0000245,0.0000167,0.0000114,0.0000176,0.0000119,0.0000059,0.0000219,0.0000217,0.0000161,0.0000251,0.0000312,0.0000314,0.0000242,0.0000173,0.0000276,0.0000302,0.0000291,0.0000077,0.0000089,0.0000114,0.000023,0.0000509,0.0000745,0.0000861,0.0000895,0.0000888,0.0000676,0.000054,0.000064,0.0000648,0.0000647,0.0000639,0.0000569,0.0000512,0.0000669,0.0000707,0.0000716,0.0000709,0.000063,0.0000388,0.0000241,0.0000322,0.0000459,0.0000649,0.0000747,0.0000797,0.0000806,0.0000791,0.0000599,0.0000361,0.000027,0.0000122],"detections":[{"range_m":1.609424,"snr_db":17.6228,"width_m":0.171607},{"range_m":3.196794,"snr_db":19.0956,"width_m":0.171607}],"noise_floor":0.000036313,"blast_amplitude":0.2699793,"saturated":false}
{"timestamp":1756162802.4666643,"source":"simulated","device_id":"batvu-reference-01","beam":[-0.5,0.8660254,0],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.000044,0.0000375,0.0000229,0.0000042,0.0000483,0.0000644,0.0000718,0.0000713,0.0000608,0,0.0000347,0.0000452,0.0000166,0.0000607,0.0000884,0.0000763,0.0000607,0.0000441,0,0.0000102,0.0000349,0.0000255,0.0000327,0.0000494,0.0000325,0.0000329,0.0000661,0.0000621,0.0000571,0.0000494,0.0000225,0.0000278,0.0000438,0.0000349,0.0000102,0.000053,0.0000612,0.0000484,0.0000272,0.0000825,0.0001961,0.0003637,0.0005474,0.0008145,0.0010672,0.0012471,0.0013251,0.0013288,0.0012856,0.0011168,0.0008888,0.0006749,0.0004371,0.0002737,0.0001652,0.0000788,0.0000173,0.000029,0.0000253,0.0000227,0.0000499,0.0000479,0.000035,0.0000199,0.0000071,0.0000054,0.0000093,0.0000105,0.0000146,0.0000155,0.0000145,0.0000015,0.0000139,0.0000186,0,0.0000206,0.0000382,0.0000392,0.0000443,0.0000495,0.000039,0.0000515,0.0000747,0.0000736,0.0000657,0.0000514,0.0000238,0.000018,0.0000407,0.0000379,0.0000246,0.0000271,0.0000259,0.0000085,0.0000091,0.0000225,0.0000247,0.0000262,0.0000266,0.0000058,0.0000131,0.0000269,0.0000295,0.0000352,0.0000398,0.0000377,0.0000498,0.0000583,0.000052,0.000051,0.0000609,0.0000515,0.0000291,0.0000425,0.0000482,0.0000495,0.0000551,0.0000542,0.0000458,0.0000419,0.0000319,0.0000058,0.0000124,0.0000158,0.0000152,0.0000245,0.0000265,0.0000229,0.0000497,0.0000737,0.0000847,0.0000916,0.0000932,0.0000763,0.0000634,0.0000699,0.0000656,0.0000717,0.0001141,0.0002093,0.0003579,0.0005584,0.0007687,0.0009797,0.0011544,0.0012367,0.0012455,0.0012217,0.0010832,0.0008764,0.0006454,0.0004299,0.0002392,0.0001164,0.0000667,0.0000473,0.0000415,0.0000421,0.000036,0.0000531,0.0000733,0.000082,0.0000892,0.0000894,0.0000721,0.0000388,0.0000408,0.0000643,0.0000821,0.00009,0.0000834,0.000063,0.0000499,0.0000425,0.0000234,0.0000254,0.0000361,0.0000432,0.0000516,0.0000535,0.0000537,0.000073,0.000084,0.0000834,0.0000749,0.0000532,0.0000215,0.0000136,0.0000249,0.0000423,0.0000683,0.0000884,0.0000881,0.0000848,0.0000826,0.0000725,0.0000462,0.0000207,0.0000129,0.0000206,0.0000256,0.0000244,0.0000186,0.0000184,0.0000194,0.0000185,0.0000254,0.0000267,0.0000215,0.000033,0.0000426,0.0000506,0.0000635,0.0000726,0.0000747,0.0000835,0.00009,0.0000872,0.0000823,0.0000836,0.0000798,0.0000721,0.0000696,0.0000623,0.0000461,0.0000445,0.000044,0.0000412,0.0000424,0.0000402,0.0000284,0.0000375,0.0000515,0.0000712,0.0000926,0.0000993,0.0000929,0.0000789,0.0000637,0.0000384],"detections":[{"range_m":1.460104,"snr_db":22.5978,"width_m":0.171607},{"range_m":3.279398,"snr_db":16.6055,"width_m":0.171607}],"noise_floor":0.000042944,"blast_amplitude":0.270032,"saturated":false}
{"timestamp":1756162802.533331,"source":"simulated","device_id":"batvu-reference-01","beam":[-0.7071068,0.7071068,0],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000313,0.0000315,0.0000294,0.0000261,0.0000226,9e-7,0,0,0.0000275,0.0000221,0.0000153,0.000012,0.000018,0.0000337,0.0000466,0.0000325,0.0000501,0.0000613,0.0000356,0.0000647,0.0000958,0.0000853,0.0000676,0.000058,0.0000189,0.0000099,0.0000214,0.000002,0,0.000048,0.0000476,0.0000424,0.0000339,0.0000217,0.0000208,0.00003,0.0000297,0,0.000024,0.0000601,0.0001198,0.0002267,0.0003594,0.0006087,0.0009033,0.0011824,0.0014051,0.0015468,0.0015759,0.0015369,0.0014007,0.0012082,0.0009033,0.000631,0.0004019,0.0002129,0.000078,0.0000293,0.0000257,0.0000194,0.0000594,0.0000816,0.0001059,0.0001231,0.0001217,0.00009,0.0000871,0.0000874,0.0000688,0.000055,0.0000487,0.000021,0.0000082,0.0000144,0.0000322,0.000058,0.0000712,0.0000699,0.000091,0.0001107,0.0001067,0.0000905,0.0000823,0.0000704,0.0000612,0.0000649,0.0000559,0.0000267,0.000018,0.0000289,0.0000411,0.0000561,0.0000556,0.0000384,0.0000278,0.0000355,0.0000444,0.0000523,0.0000535,0.0000329,0.0000342,0.0000418,0.000035,0.00003,0.0000408,0.0000407,0.0000382,0.0000297,0.0000052,0.0000096,0.0000315,0.0000374,0.000044,0.0000476,0.0000403,0.0000262,0.0000401,0.0000403,0.0000432,0.0000705,0.0000817,0.0000912,0.0000959,0.0000959,0.000069,0.0000453,0.000032,0.000009,0.0000283,0.0000444,0.0000446,0.0000404,0.0000294,0.0000327,0.0000709,0.0001266,0.0002096,0.0003522,0.0005446,0.0007824,0.0009686,0.0011013,0.001138,0.0011359,0.0010807,0.0009559,0.0007644,0.0005603,0.0003393,0.0001842,0.0000923,0.0000585,0.000035,0.0000511,0.0000725,0.0000785,0.0000804,0.0000805,0.0000658,0.0000543,0.0000535,0.000045,0.0000388,0.0000407,0.00003,0.0000119,0.0000121,0.0000098,6e-7,0.0000203,0.0000226,0.0000244,0.0000291,0.0000275,0.0000194,0.0000394,0.0000572,0.000066,0.0000688,0.0000681,0.0000454,0.0000411,0.000058,0.0000698,0.0000839,0.0000878,0.0000808,0.0000725,0.0000675,0.0000504,0.0000217,0.0000373,0.0000647,0.0000878,0.0000998,0.0000967,0.0000816,0.0000678,0.0000599,0.0000533,0.000064,0.0000638,0.0000602,0.0000632,0.0000635,0.0000448,0.000022,0.0000201,0.0000348,0.0000496,0.0000569,0.000063,0.0000776,0.0000869,0.0000823,0.0000665,0.000043,0.0000099,0.0000346,0.0000532,0.0000572,0.0000712,0.0000822,0.0000799,0.0000626,0.0000343,0.00002,0.0000367,0.0000404,0.000037,0.0000344,0.0000542,0.0000604,0.0000604,0.0000593,0.000058,0.0000474,0.0000507,0.0000556,0.0000532],"detections":[{"range_m":1.482792,"snr_db":20.0078,"width_m":0.171607},{"range_m":3.216961,"snr_db":16.8942,"width_m":0.171607}],"noise_floor":0.000047459,"blast_amplitude":0.2699607,"saturated":false}
{"timestamp":1756162802.5999975,"source":"simulated","device_id":"batvu-reference-01","beam":[-0.8660254,0.5,0],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000193,0.0000159,0,0,0.0000648,0.0000622,0.0000294,0,0.0000524,0.0000647,0.0000669,0.0000657,0,0.0000041,0.0000329,0.0000287,0.0000277,0.0000322,0.0000129,0.0000344,0.0000577,0.0000455,0.0000624,0.0000809,0.00006,0.0000431,0.0000707,0.0000645,0.0000576,0.0000551,0.0000285,0,0.0000398,0.0000377,0.0000249,0.000028,0.0000498,0.0000646,0.000073,0.0000708,0.0000151,0.0001279,0.0002777,0.000523,0.0007938,0.0010549,0.001291,0.0014844,0.0015623,0.0015584,0.0014718,0.0012896,0.0009588,0.0006618,0.0004206,0.0002291,0.0000928,0.0000603,0.0000582,0.0000552,0.000064,0.0000576,0.000036,0.0000459,0.0000477,0.0000387,0.0000332,0.00003,0.0000216,0.0000391,0.0000439,0.0000319,0.0000258,0.0000283,0.0000144,0.0000313,0.0000423,0.0000361,0.0000335,0.000038,0.0000253,0.0000058,0.0000426,0.0000595,0.0000795,0.0001001,0.0000985,0.0000993,0.0001113,0.0001058,0.0000845,0.0000677,0.0000544,0.0000265,0.0000283,0.0000312,0.0000327,0.0000598,0.0000691,0.000068,0.0000622,0.0000536,0.0000264,0.0000053,0.0000038,0,0.0000138,0.0000378,0.000044,0.0000449,0.0000424,0.0000381,0.0001105,0.0002237,0.0003659,0.0005728,0.0008284,0.0011058,0.0012841,0.0013755,0.0013778,0.0013191,0.0011794,0.000988,0.0007487,0.0005181,0.0002912,0.0001344,0.0000419,0.0000479,0.0000549,0.0000661,0.0000731,0.0000613,0.000042,0.0000265,0.0000087,0.0000135,0.0000273,0.0000333,0.0000552,0.000081,0.0000818,0.0000794,0.0000708,0.0000559,0.0000262,0.0000404,0.0000448,0.0000469,0.0000519,0.0000536,0.0000523,0.0000673,0.0000745,0.0000687,0.0000583,0.0000465,0.0000255,0.0000377,0.0000459,0.0000389,0.0000335,0.0000648,0.0000758,0.0000761,0.0000679,0.0000396,0.0000245,0.0000544,0.000055,0.000054,0.0000541,0.0000519,0.0000433,0.0000563,0.0000592,0.0000505,0.0000482,0.0000538,0.000058,0.0000598,0.0000599,0.0000456,0.0000286,0.0000208,0.0000355,0.0000472,0.0000516,0.000046,0.0000558,0.0000737,0.0000781,0.0000867,0.0000942,0.0000908,0.0000785,0.0000738,0.0000729,0.0000736,0.0000784,0.0000766,0.0000653,0.0000631,0.0000638,0.0000503,0.0000326,0.0000151,0.0000377,0.0000529,0.000056,0.0000456,0.0000323,0.0000293,0.0000225,0.0000271,0.0000331,0.00003,0.0000241,0.0000229,0.0000188,0.0000104,0.0000102,0.0000071,0.000001,0.0000147,0.0000194,0.0000227,0.0000239,0.0000215,0.0000145,0.0000303,0.0000368,0.0000428,0.0000583,0.0000754,0.0000871,0.0000985,0.0001024,0.0000979],"detections":[{"range_m":1.489718,"snr_db":21.5458,"width_m":0.171607},{"range_m":2.798894,"snr_db":19.9053,"width_m":0.171607}],"noise_floor":0.000042585,"blast_amplitude":0.2699904,"saturated":false}
{"timestamp":1756162802.6666641,"source":"simulated","device_id":"batvu-reference-01","beam":[-0.9659258,0.258819,0],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000442,0.0000476,0.0000506,0.0000507,0.0000469,0.0000152,0,0.0000046,0.0000102,0.0000034,0.0000133,0.0000201,0.0000161,0.0000542,0.0000792,0.0000718,0.0000748,0.0000758,0.0000213,0.0000192,0.0000541,0.0000465,0.0000284,0.0000244,0.0000203,0.0000275,0.0000315,0.0000085,0,0.0000123,0.0000086,0.000004,0.0000299,0.0000274,0.0000303,0.0000674,0.0001286,0.0002635,0.0004806,0.0006923,0.0009043,0.0010915,0.0011806,0.0011884,0.0011628,0.0010759,0.0008878,0.0006699,0.0004676,0.0002719,0.000128,0.0000673,0.0000497,0.0000396,0.000031,0.0000058,0.0000132,0.0000443,0.0000586,0.00008,0.0000976,0.0000929,0.0000762,0.0000938,0.0000945,0.0000756,0.0000692,0.0000687,0.0000656,0.0000894,0.0000965,0.0000856,0.0000807,0.0000887,0.000081,0.000076,0.0000726,0.0000548,0.0000675,0.0000784,0.0000709,0.0000678,0.000078,0.0000701,0.0000503,0.0000437,0.0000416,0.0000434,0.0000569,0.000055,0.0000542,0.0000569,0.0000538,0.00003,0.0000272,0.0000288,0.0000169,0.0000454,0.0000605,0.0000642,0.0000644,0.0000623,0.0000352,0.0000079,0.0000141,0.0000444,0.0001221,0.0002598,0.0004659,0.000766,0.0011942,0.0015249,0.0017874,0.0019265,0.0019322,0.0018751,0.0016961,0.0014258,0.0010178,0.0006926,0.0004183,0.0001994,0.0000794,0.0000598,0.0000542,0.0000552,0.0000561,0.0000359,0.0000162,0.0000047,0,0.0000116,0.0000383,0.0000467,0.0000517,0.0000539,0.0000443,0.0000372,0.0000426,0.0000373,0.0000228,0.0000382,0.0000378,0.0000323,0.0000203,0.0000078,0.0000166,0.0000176,0.0000128,0.0000197,0.0000325,0.0000344,0.0000212,0.0000174,0.0000212,0.0000148,0.0000305,0.0000441,0.0000497,0.0000564,0.0000607,0.0000541,0.0000535,0.0000621,0.0000608,0.0000646,0.0000714,0.0000686,0.0000734,0.0000943,0.0000944,0.0000925,0.0000861,0.0000723,0.0000427,0.0000272,0.0000287,0.0000361,0.0000558,0.0000609,0.000059,0.0000541,0.0000503,0.0000353,0.0000217,0.0000121,0.0000044,0.000022,0.000035,0.0000345,0.0000293,0.0000215,0.0000096,0.0000197,0.000044,0.0000549,0.0000592,0.0000589,0.0000503,0.0000295,0.0000281,0.0000256,0.0000078,0.0000035,0.0000078,0.0000117,0.0000243,0.0000268,0.0000232,0.0000266,0.0000318,0.0000332,0.000035,0.0000353,0.0000241,0.0000279,0.0000408,0.0000465,0.0000539,0.0000583,0.0000537,0.0000425,0.0000608,0.0000755,0.0000928,0.0001075,0.0001072,0.0000992,0.0000913,0.0000832,0.0000662,0.0000613,0.0000634,0.0000657,0.0000676,0.0000676,0.0000535,0.0000341,0.0000378,0.0000483],"detections":[{"range_m":1.38882,"snr_db":18.2941,"width_m":0.171607},{"range_m":2.690172,"snr_db":23.7513,"width_m":0.171607}],"noise_floor":0.000043777,"blast_amplitude":0.270011,"saturated":false}
{"timestamp":1756162802.7333307,"source":"simulated","device_id":"batvu-reference-01","beam":[-1,0,0],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000137,0,0,0.0000026,0.000049,0.0000398,0,0,0.0000286,0.0000201,0.0000125,0.0000371,0.0000431,0.0000466,0.0000478,0,0,0.000019,0.0000139,0.0000221,0.0000375,0.0000154,0,0.0000371,0.0000375,0.0000344,0.000026,0,0,0.0000196,0.0000129,0.0000011,0.000029,0.0000411,0.0000508,0.0000586,0.0000584,0.0000265,0.0000468,0.0000492,0.000022,0.0000222,0.0000319,0.0000197,0.0000391,0.0000545,0.0000509,0.0000398,0.0000239,0.0000198,0.0000267,0.0000272,0,0,0.0000225,0.0000218,0.0000251,0.000028,0.0000176,0.0000403,0.0001052,0.0001351,0.0001588,0.0001711,0.0001685,0.0001325,0.0001324,0.0001327,0.0001116,0.0000894,0.0000673,0.0000185,0.0000159,0.0000286,0.0000246,0.0000336,0.0000404,0.0000328,0.0000312,0.0000338,0.0000193,0.0000123,0.0000367,0.0000427,0.0000495,0.0000528,0.000043,0.000017,0.0000371,0.0000389,0.0000571,0.0000853,0.0000868,0.000073,0.0000525,0.0000347,0.0000147,0.0000235,0.0000255,0.0000164,0.0000455,0.0000698,0.0000731,0.0000702,0.000063,0.000182,0.0004017,0.0007093,0.0010877,0.0015303,0.0020434,0.0023468,0.0024921,0.002499,0.0024107,0.0021386,0.0017626,0.0013422,0.0008333,0.0004859,0.0002299,0.0000497,0.0000544,0.0000603,0.0000503,0.0000406,0.0000422,0.0000302,0.0000207,0.0000132,2e-7,0.0000066,0.0000139,0.0000161,0.0000259,0.0000334,0.0000286,0.0000265,0.0000389,0.000038,0.0000339,0.0000317,0.0000247,0.0000118,0.0000207,0.0000239,0.0000373,0.0000654,0.0000693,0.0000696,0.0000684,0.0000612,0.000028,0.0000272,0.0000549,0.0000727,0.0000937,0.0001022,0.0000989,0.0000914,0.0000855,0.0000711,0.0000625,0.0000731,0.0000723,0.0000704,0.0000729,0.0000679,0.0000621,0.0000884,0.0000988,0.0001026,0.0001021,0.0000909,0.0000601,0.000041,0.0000368,0.0000228,0.000026,0.0000279,0.0000223,0.00002,0.0000177,0.0000101,0.0000357,0.0000448,0.0000428,0.0000358,0.0000305,0.0000222,0.0000135,0.0000083,0.0000105,0.0000279,0.0000493,0.0000551,0.0000579,0.000058,0.0000532,0.0000329,0.0000191,0.0000137,0.0000087,0.0000241,0.0000292,0.0000337,0.0000489,0.0000527,0.0000517,0.0000503,0.0000487,0.0000341,0.0000312,0.0000409,0.0000385,0.0000285,0.0000141,0.000011,0.0000189,0.0000263,0.0000263,0.0000352,0.0000428,0.0000399,0.0000262,0.0000173,0.0000368,0.0000508,0.0000598,0.000059,0.0000738,0.0000947,0.0000988,0.0000943,0.000081,0.0000628,0.0000307,0.0000321,0.0000547,0.0000625],"detections":[{"range_m":2.672074,"snr_db":25.7906,"width_m":0.171607}],"noise_floor":0.000034871,"blast_amplitude":0.2699593,"saturated":false}
{"timestamp":1756162802.7999973,"source":"simulated","device_id":"batvu-reference-01","beam":[-0.9659258,-0.258819,0],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000521,0.0000506,0.0000406,0.0000258,0.0000351,0.0000299,0.0000171,0.0000112,0.0000171,0.0000076,0.000007,0.0000067,0,0,0.000025,0.0000277,0.0000276,0.0000236,0,0.0000105,0.0000206,0.0000059,0.0000283,0.0000497,0.0000325,0.0000204,0.0000546,0.0000519,0.0000498,0.0000652,0.0000631,0.0000836,0.0001015,0.0000922,0.0000498,0.0000645,0.0000722,0.0000678,0.000067,0.0000651,0.0000254,0.000046,0.0000622,0.000065,0.0000659,0.0000649,0.000019,0,0.0000072,0,0.0000023,0.0000187,0.0000092,0,0.0000225,0.000023,0.0000224,0.0000182,0.0000053,0.0000236,0.0000394,0.0000345,0.0000258,0.0000582,0.0000618,0.0000521,0.0000335,0.0000126,0.0000179,0.0000414,0.0000474,0.0000354,0.0000287,0.0000334,0.0000155,0.0000106,0.0000492,0.0000657,0.0000735,0.0000741,0.000055,0.0000322,0.0000453,0.0000407,0.0000281,0.0000397,0.000063,0.0000898,0.0001094,0.0001043,0.000086,0.0000959,0.0000957,0.0000826,0.0000764,0.0000756,0.0000429,0.0000281,0.00003,0.0000168,0.0000165,0.0000356,0.0000463,0.0000518,0.0000525,0.0000312,0.0000152,0.0000289,0.0000298,0.0000464,0.0000936,0.000171,0.0003425,0.000619,0.0009665,0.0013803,0.0018058,0.0022034,0.0023967,0.0024329,0.0023985,0.002178,0.0018246,0.001411,0.0009878,0.0006421,0.0003656,0.0002099,0.0001224,0.0000899,0.0000743,0.000067,0.000066,0.0000506,0.0000351,0.0000271,0.0000173,0.0000212,0.000036,0.000036,0.0000402,0.0000461,0.0000416,0.0000279,0.0000223,0.0000257,0.0000367,0.0000538,0.0000538,0.0000547,0.0000779,0.0000952,0.0001053,0.0001076,0.0001058,0.0000715,0.0000424,0.0000255,0.0000014,0.0000138,0.0000261,0.0000243,0.0000222,0.0000328,0.0000337,0.0000336,0.0000325,0.0000261,0.0000174,0.0000223,0.0000237,0.000038,0.000054,0.0000538,0.0000468,0.0000442,0.0000442,0.0000194,0.0000291,0.0000464,0.0000542,0.0000567,0.0000565,0.0000391,0.0000199,0.0000226,0.0000296,0.0000368,0.0000394,0.0000298,0.0000164,0.000041,0.0000478,0.0000492,0.0000488,0.0000404,0.0000265,0.0000322,0.0000316,0.0000287,0.0000331,0.0000314,0.0000212,0.0000294,0.0000322,0.0000298,0.0000281,0.000028,0.0000133,0.0000042,0.0000052,0.0000185,0.0000431,0.000061,0.0000606,0.000052,0.0000378,0.0000376,0.0000546,0.0000656,0.0000639,0.0000559,0.0000497,0.0000405,0.000021,0.0000061,0.0000014,0.0000014,0.0000374,0.0000605,0.000081,0.0000953,0.000097,0.000087,0.0000759,0.0000682,0.0000471,0.0000339,0.000035,0.0000294],"detections":[{"range_m":2.789088,"snr_db":24.1004,"width_m":0.171607}],"noise_floor":0.000036772,"blast_amplitude":0.2699547,"saturated":false}
{"timestamp":1756162802.866664,"source":"simulated","device_id":"batvu-reference-01","beam":[-0.8660254,-0.5,0],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000269,0.0000276,0.0000106,0.0000101,0.0000381,0.0000332,0.0000387,0.0000411,5e-7,0.0000205,0.0000491,0.00005,0.000052,0.0000533,0.0000035,0.0000151,0.0000511,0.0000456,0.0000325,0.0000319,0.0000203,0.0000305,0.0000423,0.0000251,0.0000065,0.0000345,0.0000277,0.0000172,0.0000106,0,0.0000041,0.0000226,0.0000266,0.0000059,0.0000113,0.0000241,0.0000279,0.00003,0.0000308,0.0000078,0.000028,0.0000364,0.0000217,0.0000106,0.0000196,0.000014,0.0000173,0.000044,0.0000556,0.0000676,0.0000726,0.0000551,0.0000304,0.0000465,0.0000424,0.0000221,0.0000345,0.0000324,0.0000264,0.0000219,0.0000129,0.0000207,0.0000522,0.0000551,0.0000446,0.0000342,0.0000294,0.0000083,0.0000236,0.0000392,0.0000376,0.0000347,0.0000292,0.0000071,0.0000157,0.0000203,0.0000062,0,0.0000064,0.0000026,0.0000028,0.0000212,0.0000194,0.0000097,0.0000326,0.0000407,0.0000455,0.0000461,0.0000415,0.0000126,0.0000365,0.00005,0.0000513,0.0000512,0.000049,0.0000212,0.0000383,0.0000661,0.0000859,0.0000986,0.0001013,0.0000824,0.0000625,0.0000607,0.000048,0.0000232,0.0000191,0.000024,0.0000265,0.0000317,0.0000285,0.0000278,0.0000314,0.0000286,0.0000173,0.0000386,0.0000396,0.000032,0.0000217,0.0000157,0.0000257,0.0000529,0.0000824,0.0001751,0.0003669,0.0006408,0.000978,0.0013535,0.0017582,0.0019858,0.0020814,0.002082,0.0019768,0.0017232,0.0013875,0.0010258,0.000634,0.0004049,0.0002567,0.0001615,0.0001141,0.0000889,0.0000571,0.0000415,0.0000347,0.0000102,0.0000241,0.0000415,0.0000467,0.000047,0.0000452,0.0000231,0.0000348,0.0000474,0.0000481,0.0000472,0.0000411,0.0000194,0.0000171,0.0000249,0.0000198,0.0000133,0.0000211,0.0000188,0.0000168,0.0000319,0.0000314,0.0000325,0.000044,0.0000443,0.0000471,0.0000558,0.0000579,0.0000581,0.0000758,0.000086,0.0000952,0.0001074,0.0001121,0.000106,0.0000979,0.0000952,0.0000858,0.0000877,0.0000919,0.0000847,0.0000697,0.0000584,0.0000411,0.0000224,0.0000248,0.0000255,0.0000255,0.0000237,0.0000189,0.0000061,0.0000204,0.0000223,0.0000231,0.0000233,0.0000234,0.0000095,0.0000091,0.000011,0.0000078,0.0000141,0.000019,0.0000285,0.0000514,0.0000738,0.0000773,0.0000773,0.0000749,0.000062,0.0000494,0.0000548,0.0000527,0.0000475,0.0000574,0.0000616,0.0000684,0.0000736,0.0000715,0.000055,0.0000372,0.0000216,0.0000264,0.0000439,0.0000551,0.0000624,0.0000644,0.0000634,0.0000452,0.0000246,0.0000215,0.0000137],"detections":[{"range_m":3.073217,"snr_db":23.6053,"width_m":0.171607}],"noise_floor":0.000032506,"blast_amplitude":0.2699894,"saturated":false}
{"timestamp":1756162802.9333305,"source":"simulated","device_id":"batvu-reference-01","beam":[-0.7071068,-0.7071068,0],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000567,0.0000616,0.000057,0.0000494,0.0000557,0.0000219,0.0000145,0.0000151,0,0.0000108,0.0000275,0.0000077,0,0.0000185,0.0000193,0.0000244,0.0000383,0.0000292,0.0000551,0.00008,0.0000657,0.0000531,0.0000759,0.000068,0.0000597,0.0000563,0.0000259,0,0.0000123,0.0000108,0.0000034,0.0000178,0.0000246,0.0000188,0.000014,0.0000077,0.0000104,0.0000217,0.0000272,0.0000189,0.0000333,0.0000373,0.0000137,0.0000188,0.0000359,0.0000259,0.0000055,0.0000477,0.0000609,0.0000654,0.0000653,0.0000396,0.0000034,0.0000135,0.0000089,0.0000068,0.000062,0.0000757,0.0000806,0.0000806,0.0000738,0.0000356,0.0000637,0.0000718,0.0000757,0.0000771,0.0000767,0.0000404,0.0000151,0.0000187,0.0000049,0.0000178,0.0000481,0.0000531,0.0000528,0.0000452,0.0000134,0,0.0000042,0,0.0000087,0.0000313,0.0000333,0.0000413,0.000052,0.0000459,0.0000278,0.0000308,0.0000303,0.0000189,0.0000191,0.0000208,0.0000217,0.0000509,0.0000599,0.0000567,0.0000461,0.000033,0.0000059,0.000001,0.0000128,0.0000135,0.0000152,0.0000211,0.0000196,0.0000323,0.0000619,0.0000732,0.0000803,0.0000807,0.0000676,0.0000381,0.0000595,0.000067,0.0000696,0.0000737,0.0000717,0.0000596,0.000064,0.0000651,0.0000483,0.0000532,0.0000569,0.0000517,0.0000453,0.0000369,0.0000112,0.0000152,0.0000235,0.0000225,0.0000434,0.0000564,0.0000506,0.0000421,0.0001785,0.0004188,0.0007006,0.0010328,0.0013598,0.0016563,0.0018673,0.0019242,0.0019163,0.0017967,0.0014947,0.0011528,0.0008165,0.0005336,0.0003035,0.0001506,0.0000631,0.0000099,0.0000253,0.0000294,0.0000199,0.0000203,0.0000292,0.0000261,0.0000147,0.0000258,0.0000418,0.0000557,0.0000648,0.000062,0.0000562,0.0000613,0.0000569,0.0000474,0.0000569,0.0000564,0.0000499,0.0000515,0.0000525,0.0000369,0.000035,0.000042,0.0000497,0.0000593,0.0000631,0.0000554,0.0000439,0.0000305,0.000011,0.0000274,0.0000429,0.000044,0.0000436,0.0000398,0.0000237,0.0000273,0.0000432,0.0000432,0.0000461,0.0000578,0.0000583,0.0000577,0.0000541,0.0000434,0.00002,0.0000217,0.000032,0.0000445,0.0000602,0.0000623,0.0000545,0.0000511,0.0000534,0.0000472,0.0000411,0.0000377,0.0000242,0.0000253,0.0000339,0.0000328,0.0000278,0.0000199,0.000004,0.0000167,0.0000262,0.0000245,0.0000181,0.0000197,0.0000194,0.000021,0.0000224,0.0000194,0.0000022,0.0000187,0.0000299,0.000036,0.0000392,0.0000391,0.0000231,0.0000118,0.0000278,0.0000309],"detections":[{"range_m":3.268919,"snr_db":23.9412,"width_m":0.171607}],"noise_floor":0.000030864,"blast_amplitude":0.2699768,"saturated":false}
{"timestamp":1756162802.9999971,"source":"simulated","device_id":"batvu-reference-01","beam":[-0.5,-0.8660254,0],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000718,0.0000751,0.0000613,0.00004,0.0000203,0.0000108,0.0000191,0.0000198,0,0.0000085,0.000025,0.0000094,0.0000155,0.0000259,0.0000083,0.0000046,0.0000098,0.000001,0.0000185,0.0000425,0.0000323,0.0000278,0.0000365,0.0000176,0,0.0000622,0.0000792,0.0000878,0.0000884,0.0000708,0.0000161,0.0000282,0.000033,0.0000137,0.0000277,0.0000319,0.0000213,0.000024,0.0000249,0,0.0000032,0.0000111,0,0.0000232,0.0000451,0.0000393,0.0000267,0.000026,0.0000178,0.000011,0.0000328,0.0000397,0.000043,0.0000427,0.0000251,0.0000109,0.0000424,0.0000407,0.0000303,0.0000323,0.0000366,0.0000456,0.0000505,0.000048,0.0000306,0.0000527,0.0000587,0.0000459,0.0000337,0.0000292,0.0000011,0.0000099,0.0000285,0.0000283,0.0000265,0.0000275,0.0000157,0.0000084,0.0000256,0.0000276,0.000029,0.0000291,0.0000197,0.0000096,0.000026,0.0000237,0.0000167,0.00003,0.0000328,0.0000455,0.0000612,0.0000636,0.0000338,0.0000105,0.0000383,0.0000501,0.0000572,0.00006,0.0000468,0.0000394,0.0000409,0.0000249,0.0000178,0.0000253,0.0000183,0.0000012,0.0000418,0.0000619,0.000078,0.0000863,0.0000801,0.0000623,0.0000645,0.0000629,0.0000417,0.000026,0.00001,0.0000071,0.0000224,0.0000268,0.0000239,0.000024,0.0000237,0,0.0000285,0.0000499,0.0000554,0.0000567,0.0000564,0.0000371,0.0000307,0.0000427,0.0000419,0.0000445,0.0000532,0.0000645,0.0001044,0.0001783,0.000289,0.0004815,0.0007574,0.0010664,0.0013849,0.0017021,0.0018287,0.0018421,0.0018043,0.0016414,0.0013547,0.0010162,0.0006855,0.0003444,0.0001603,0.0000833,0.0000612,0.0000512,0.0000541,0.0000505,0.0000643,0.000074,0.0000716,0.0000649,0.0000602,0.000051,0.0000345,0.0000382,0.0000363,0.0000399,0.000059,0.0000626,0.000064,0.0000646,0.0000645,0.0000439,0.0000471,0.0000526,0.0000536,0.0000562,0.0000589,0.0000542,0.0000533,0.0000519,0.000033,0.0000244,0.0000431,0.0000497,0.0000506,0.0000482,0.0000241,0.0000127,0.0000301,0.0000301,0.000033,0.000043,0.0000428,0.0000435,0.0000506,0.0000491,0.0000359,0.0000246,0.000023,0.0000159,0.0000118,0.0000102,0.000015,0.0000361,0.0000527,0.0000595,0.0000633,0.0000647,0.0000554,0.0000609,0.0000693,0.0000674,0.0000576,0.0000408,0.0000164,0.0000301,0.0000405,0.0000392,0.0000404,0.0000461,0.000044,0.0000249,0.0000297,0.0000625,0.0000951,0.0001236,0.0001313,0.0001312,0.0001273,0.0001201,0.0000982,0.0000715,0.0000561,0.000033],"detections":[{"range_m":3.336489,"snr_db":21.5684,"width_m":0.171607}],"noise_floor":0.000037665,"blast_amplitude":0.2699642,"saturated":false}
{"timestamp":1756162803.0666637,"source":"simulated","device_id":"batvu-reference-01","beam":[-0.258819,-0.9659258,0],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000311,0.0000106,0,0,0.0000399,0.0000367,0.0000152,0.0000278,0.0000582,0.0000519,0.0000496,0.00005,0.0000047,0.0000368,0.000055,0.000022,0.0000124,0.00005,0.0000561,0.0000577,0.0000576,0.0000129,0.0000191,0.0000633,0.0000627,0.000055,0.0000425,0.0000177,0.0000185,0.0000266,0.0000177,0.0000406,0.0000713,0.0000657,0.0000416,0.0000458,0.0000495,0.0000292,0.0000222,0.0000194,0,0.0000397,0.0000731,0.0000827,0.0000827,0.0000753,0.0000176,6e-7,0.000017,0.0000063,0,0.0000108,0.0000069,3e-7,0.000006,0.0000038,0.000008,0.0000484,0.0000609,0.0000681,0.0000704,0.0000587,0.0000262,0.0000426,0.0000449,0.000034,0.0000255,0.0000213,5e-7,0.0000358,0.0000542,0.0000557,0.0000551,0.0000502,0.0000139,0.0000065,0.0000196,0.0000204,0.0000228,0.0000246,0.0000118,0.0000165,0.00003,0.0000258,0.0000188,0.0000256,0.0000241,0.0000332,0.0000469,0.0000428,0.0000306,0.0000403,0.0000393,0.0000208,0.000007,0.0000074,0.0000043,0.0000287,0.0000452,0.0000481,0.0000475,0.0000401,0.0000083,0.0000045,0.00001,0.0000089,0.0000177,0.000026,0.0000227,0.0000281,0.0000347,0.0000245,0.000013,0.0000242,0.0000211,0.0000055,0.0000282,0.0000441,0.0000482,0.0000482,0.0000427,0.0000283,0.0000433,0.0000465,0.0000399,0.0000518,0.0000557,0.0000646,0.0000868,0.0000964,0.0000913,0.0000786,0.000069,0.0000524,0.0000591,0.0000736,0.0000719,0.0000601,0.0001255,0.0003104,0.0005503,0.0008524,0.0011736,0.0014945,0.001754,0.0018676,0.0018718,0.0017998,0.0015337,0.0012066,0.0008771,0.0005946,0.0003574,0.0001899,0.0000875,0.0000205,0.0000117,0.0000189,0.000041,0.000063,0.0000737,0.0000711,0.0000776,0.0000883,0.0000869,0.0000819,0.0000739,0.0000558,0.0000305,0.0000334,0.0000312,0.0000223,0.0000223,0.0000278,0.0000383,0.000049,0.0000508,0.000041,0.0000478,0.0000501,0.0000555,0.0000808,0.0000991,0.0001007,0.0000981,0.0000815,0.0000496,0.0000278,0.0000269,0.0000186,0.0000059,0.0000055,0.0000099,0.0000246,0.000041,0.000041,0.000044,0.0000618,0.0000733,0.0000893,0.0000997,0.0000984,0.0000853,0.0000725,0.0000627,0.0000404,0.0000258,0.000021,0.0000097,0.0000058,0.0000227,0.0000353,0.0000455,0.0000491,0.0000385,0.0000253,0.0000186,0.000017,0.0000318,0.0000487,0.0000504,0.000057,0.0000726,0.0000828,0.0000928,0.0000959,0.0000928,0.000073,0.0000588,0.0000522,0.0000408,0.000036,0.0000354,0.0000216,0.0000216,0.0000267,0.0000243,0.0000228,0.000025,0.0000211],"detections":[{"range_m":3.27542,"snr_db":20.1394,"width_m":0.171607}],"noise_floor":0.000036342,"blast_amplitude":0.2700173,"saturated":false}
{"timestamp":1756162803.1333303,"source":"simulated","device_id":"batvu-reference-01","beam":[0,-1,0],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000059,9e-7,0,0.0000136,0.0000502,0.0000422,0.0000333,0.0000572,0.0000686,0.0000242,0.0000415,0.000068,0.00007,0.0000729,0.0000745,0.0000113,0.0000088,0.0000229,0,0.0000043,0.0000549,0.0000608,0.0000678,0.0000778,0.0000543,0.0000534,0.0000776,0.0000666,0.0000493,0.0000498,0.0000331,0.0000236,0.0000424,0.0000355,0.0000217,0.0000672,0.0000764,0.0000732,0.0000727,0.0000723,0.000042,0.0000553,0.0000645,0.0000503,0.0000381,0.0000336,0,0,0.000028,0.0000298,0.0000346,0.0000433,0.000031,0.0000232,0.0000277,0.0000155,0,0.0000293,0.0000331,0.0000337,0.0000356,0.0000273,0.0000126,0.0000266,0.0000277,0.0000175,0.0000438,0.0000505,0.0000516,0.0000506,0.0000444,0.0000102,0.0000183,0.0000273,0.0000192,0.0000187,0.0000201,0,0.0000076,0.0000413,0.0000519,0.000056,0.0000568,0.0000417,0.0000417,0.0000631,0.0000616,0.0000549,0.0000513,0.0000371,0.0000066,0.0000097,0.00001,0.0000056,0.0000406,0.0000609,0.000063,0.0000624,0.0000581,0.00003,0.0000398,0.0000562,0.0000601,0.0000605,0.0000587,0.0000355,0.0000346,0.0000443,0.0000374,0.0000204,0.0000239,0.0000387,0.0000576,0.0000732,0.0000713,0.0000693,0.0000824,0.0000814,0.0000568,0.0000333,0.0000486,0.0000687,0.0000822,0.0000841,0.0000711,0.0000823,0.0000852,0.0000771,0.0000871,0.0000955,0.0000908,0.0000723,0.0000692,0.0002192,0.0004484,0.0007454,0.0010862,0.0014539,0.0017828,0.0020088,0.0020403,0.0020124,0.0018334,0.0015236,0.0011676,0.0008224,0.0005128,0.000285,0.0001198,0.0000481,0.0000488,0.0000505,0.0000382,0.0000488,0.0000621,0.0000633,0.0000628,0.000058,0.0000336,0.0000127,0.0000108,0.0000042,0,0.0000112,0.0000117,0.0000138,0.000019,0.0000166,0.0000146,0.0000153,0.000009,0.0000209,0.0000455,0.0000479,0.0000467,0.0000395,0.0000278,0.0000167,0.0000316,0.0000344,0.0000298,0.0000287,0.0000305,0.0000241,0.0000314,0.0000349,0.0000296,0.0000383,0.0000502,0.0000549,0.0000618,0.0000651,0.0000552,0.0000372,0.0000269,0.0000255,0.0000427,0.0000659,0.000068,0.0000671,0.0000674,0.0000661,0.0000577,0.0000491,0.0000345,0.000009,0.0000385,0.0000432,0.0000405,0.0000353,0.0000349,0.0000269,0.0000257,0.0000307,0.0000278,0.0000286,0.0000289,0.0000184,0.0000053,0.0000315,0.0000453,0.0000629,0.0000743,0.0000736,0.0000703,0.0000745,0.0000729,0.0000615,0.0000636,0.0000687,0.0000727,0.0000727,0.000068,0.000044,0.0000256,0.0000181,0.0000213,0.0000367,0.0000425,0.0000403],"detections":[{"range_m":3.175081,"snr_db":21.31,"width_m":0.175182}],"noise_floor":0.00003978,"blast_amplitude":0.2699786,"saturated":false}
{"timestamp":1756162803.199997,"source":"simulated","device_id":"batvu-reference-01","beam":[0,-0.9063078,0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000729,0.0000701,0.0000532,0.0000334,0.000054,0.0000494,0.000031,0.0000151,0.000051,0.0000761,0.0000974,0.0001005,0.0000468,0.0000663,0.0000916,0.0000744,0.0000597,0.0000547,0.0000124,0.0000406,0.0000815,0.000081,0.0000796,0.0000751,0.0000282,0,0.0000122,0.0000071,0.0000021,0.0000055,0,0,0.0000071,0,0,0.0000079,0.0000162,0.0000095,0.0000428,0.0000507,0.0000522,0.0000569,0.0000588,0.0000323,0.0000308,0.0000378,0.0000278,0.0000405,0.0000502,0.0000356,0.0000182,0.0000081,0.0000013,0.0000136,0.0000328,0.0000281,0.0000172,0.0000055,0.0000139,0.0000162,0.000016,0.000006,0.0000105,0.0000153,0.000012,0.0000099,0.0000449,0.0000508,0.0000554,0.0000607,0.0000613,0.0000298,0.0000079,0.0000143,0.0000045,8e-7,0.0000123,0.0000094,0.0000108,0.0000234,0.0000204,0.000021,0.0000314,0.0000275,0.0000224,0.0000212,0.000014,0.0000066,0.0000124,0.0000049,0,0.0000286,0.0000316,0.0000289,0.0000199,0.0000132,0.0000333,0.0000513,0.0000542,0.000039,0.0000357,0.0000395,0.0000237,0.0000263,0.0000515,0.0000536,0.0000523,0.0000544,0.0000896,0.0001913,0.0004234,0.0007117,0.0011041,0.00156,0.0019938,0.0023589,0.0025824,0.0026108,0.0025335,0.0022765,0.0018869,0.0014166,0.0009683,0.0005962,0.0002977,0.0001022,0.0000431,0.0000476,0.0000445,0.0000318,0.0000079,0.0000217,0.0000338,0.0000344,0.0000418,0.0000479,0.0000416,0.0000307,0.0000255,0.0000252,0.0000442,0.0000642,0.0000637,0.000056,0.0000417,0.000021,0.000017,0.0000394,0.0000396,0.0000333,0.0000328,0.000035,0.0000414,0.0000544,0.0000596,0.0000513,0.0000441,0.0000397,0.0000198,0.0000017,0.0000122,0.0000157,0.0000417,0.0000651,0.0000683,0.0000676,0.0000601,0.00004,0.0000121,0.0000196,0.0000279,0.0000531,0.0000919,0.0001097,0.0001146,0.0001133,0.0000982,0.0000442,0.0000244,0.000042,0.0000558,0.0000736,0.000082,0.0000813,0.0000797,0.0000798,0.0000691,0.0000746,0.0000846,0.0000832,0.0000771,0.0000692,0.0000516,0.0000353,0.0000265,0.0000116,0.0000179,0.0000462,0.0000542,0.0000581,0.0000618,0.0000603,0.0000548,0.0000638,0.0000656,0.0000562,0.0000429,0.0000301,0.0000182,0.0000358,0.0000587,0.0000785,0.0000953,0.000102,0.0000952,0.000088,0.000089,0.0000804,0.0000612,0.0000377,0.0000091,0.0000347,0.0000455,0.0000434,0.0000358,0.0000432,0.0000428,0.0000373,0.0000316,0.0000229,0.0000081,0.0000061,0.0000063,0.0000014,0.0000146,0.0000271,0.0000425,0.0000668,0.0000811,0.000082],"detections":[{"range_m":2.747782,"snr_db":26.9263,"width_m":0.171607}],"noise_floor":0.000035007,"blast_amplitude":0.2700119,"saturated":false}
{"timestamp":1756162803.2666636,"source":"simulated","device_id":"batvu-reference-01","beam":[-0.2345697,-0.8754261,0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000636,0.0000623,0.0000491,0.0000614,0.0000684,0.0000168,0.0000251,0.0000502,0.0000446,0.0000354,0.0000271,0.0000015,0.0000256,0.0000426,0.0000229,0.0000022,0.0000354,0.0000527,0.0000671,0.0000811,0.0000615,0.0000537,0.0000556,0.0000292,0,0.0000455,0.0000472,0.0000539,0.0000644,0.0000555,0.0000278,0.0000545,0.0000594,0.0000363,0.0000487,0.0000575,0.0000702,0.0000849,0.0000876,0.0000579,0.0000675,0.0000769,0.0000585,0.0000339,0.0000178,0.0000216,0.0000256,0.0000279,0.0000076,0.0000056,0.0000214,0.0000209,0.0000315,0.0000469,0.0000427,0.0000326,0.0000484,0.0000447,0.0000275,0.0000118,0.0000212,0.0000438,0.0000639,0.0000641,0.0000462,0.0000758,0.000095,0.0001004,0.0001007,0.0000975,0.0000578,0.0000521,0.0000595,0.0000473,0.0000275,0.0000296,0.0000469,0.0000705,0.0000875,0.0000829,0.0000704,0.0000588,0.000037,0,0.0000524,0.0000685,0.0000781,0.0000789,0.0000708,0.000029,0.0000382,0.0000488,0.0000484,0.0000553,0.0000583,0.000058,0.0000705,0.0000764,0.0000683,0.000071,0.0000742,0.0000581,0.0000371,0.0000249,0.0000077,0.0000147,0.0000285,0.0000424,0.0001715,0.0004108,0.000734,0.0011494,0.0016125,0.002105,0.0024068,0.0025434,0.0025433,0.00241,0.0021005,0.0016802,0.0012073,0.0007874,0.0004201,0.0002052,0.0000764,0.0000128,0.0000188,0.0000267,0.0000364,0.0000357,0.000041,0.0000462,0.0000396,0.0000292,0.0000301,0.0000386,0.0000539,0.000065,0.0000618,0.0000527,0.0000633,0.0000629,0.0000552,0.0000602,0.000059,0.0000494,0.0000462,0.0000465,0.0000293,0.0000278,0.0000329,0.0000288,0.0000468,0.000063,0.0000701,0.0000812,0.000092,0.0000914,0.0000914,0.0000899,0.0000741,0.0000549,0.0000572,0.0000557,0.0000609,0.0000684,0.0000623,0.0000393,0.000029,0.0000365,0.0000384,0.0000382,0.0000375,0.0000235,0.0000175,0.0000125,0.0000214,0.0000354,0.0000404,0.0000356,0.0000418,0.0000464,0.0000417,0.0000365,0.0000386,0.0000313,0.0000195,0.0000225,0.0000262,0.0000336,0.0000421,0.0000403,0.000034,0.0000291,0.0000238,0.0000137,0.000027,0.0000274,0.0000264,0.0000358,0.0000421,0.000052,0.000069,0.0000714,0.0000624,0.0000527,0.0000599,0.0000606,0.0000583,0.0000475,0.0000255,0.0000349,0.0000391,0.0000325,0.0000219,0.0000202,0.0000159,0.0000336,0.0000625,0.0000735,0.0000755,0.000074,0.0000632,0.0000398,0.0000282,0.000026,0.0000312,0.0000535,0.0000659,0.0000726,0.00008,0.0000836,0.0000805,0.0000797,0.0000773,0.0000585],"detections":[{"range_m":2.797511,"snr_db":25.2471,"width_m":0.171607}],"noise_floor":0.000042446,"blast_amplitude":0.2700145,"saturated":false}
{"timestamp":1756162803.3333302,"source":"simulated","device_id":"batvu-reference-01","beam":[-0.4531539,-0.7848856,0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000076,0.0000011,0,0,0.0000305,0.0000308,0.0000254,0.0000237,0.0000216,0,0.0000127,0.0000293,0.0000269,0.0000351,0.000041,0.0000033,0.0000134,0.0000185,0,0,0.0000167,0.0000086,0,0.0000307,0.0000337,0.0000392,0.0000508,0.0000349,0.0000151,0.0000162,0,0.0000043,0.00006,0.0000606,0.0000592,0.0000532,0.0000423,0.0000031,0.0000272,0.0000304,0.0000216,0.0000642,0.0000822,0.0000767,0.000058,0.000038,0.0000032,0.0000233,0.0000338,0.0000213,0.00004,0.0000683,0.0000624,0.0000483,0.0000338,0.0000122,0.0000128,0.0000257,0.0000218,0.0000066,0.0000096,0.0000183,0.0000275,0.0000378,0.0000364,0.0000139,0.0000658,0.000083,0.0000904,0.0000931,0.0000933,0.0000631,0.0000694,0.0000845,0.0000783,0.0000654,0.0000503,0.0000245,0.0000311,0.0000372,0.0000258,0.0000121,0.0000224,0.0000184,0.0000136,0.0000289,0.0000278,0.0000228,0.0000132,0.0000206,0.0000359,0.0000474,0.000046,0.0000342,0.0000501,0.0000538,0.0000409,0.0000571,0.0000727,0.0000791,0.0000797,0.000077,0.0000519,0.0000558,0.0000623,0.0000521,0.0000381,0.0000394,0.0000325,0.0000221,0.0000394,0.0000517,0.0000665,0.0000982,0.0001754,0.0003502,0.000625,0.0010354,0.0014368,0.0018381,0.0021464,0.0023293,0.002363,0.002333,0.002122,0.0017783,0.0012874,0.0008679,0.0005213,0.0002743,0.000102,0.0000859,0.0001372,0.0001452,0.0001447,0.0001335,0.0000985,0.0000566,0.0000342,0.0000212,0.0000099,0.0000318,0.0000328,0.0000318,0.0000269,0.0000262,0.0000371,0.0000471,0.0000454,0.0000457,0.000063,0.0000661,0.0000576,0.0000485,0.0000472,0.0000311,0.0000224,0.000027,0.0000271,0.0000346,0.0000417,0.0000388,0.0000372,0.0000391,0.0000297,0.0000147,0.0000087,0.0000173,0.0000322,0.0000508,0.0000508,0.0000599,0.0000758,0.000076,0.0000691,0.0000669,0.0000687,0.0000662,0.0000733,0.0000752,0.0000679,0.0000612,0.0000545,0.0000343,0.0000245,0.0000341,0.0000415,0.0000509,0.0000559,0.0000498,0.0000386,0.0000303,0.0000096,0.0000252,0.0000563,0.0000683,0.0000751,0.0000771,0.0000744,0.0000596,0.0000759,0.0000787,0.0000789,0.0000783,0.0000752,0.0000528,0.0000315,0.0000291,0.0000557,0.0000925,0.0001209,0.0001341,0.0001365,0.0001338,0.0000999,0.0000603,0.0000374,0.0000468,0.0000531,0.0000533,0.0000429,0.000016,0.0000263,0.0000392,0.0000507,0.0000631,0.0000631,0.0000594,0.0000564,0.0000504,0.0000318,0.0000174,0.0000066,0.0000253,0.0000573,0.0000812,0.0000905,0.0000906,0.0000858,0.0000656],"detections":[{"range_m":2.842646,"snr_db":21.2006,"width_m":0.171607}],"noise_floor":0.000039849,"blast_amplitude":0.2699783,"saturated":false}
{"timestamp":1756162803.3999968,"source":"simulated","device_id":"batvu-reference-01","beam":[-0.6408564,-0.6408564,0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000574,0.0000522,0.0000356,0.0000197,0.0000074,0.0000052,0.0000096,0.0000269,0.0000456,0.0000289,0.0000396,0.0000523,0.0000352,0.0000234,0.0000173,0.0000287,0.0000473,0.0000577,0.0000309,0.0000574,0.0000874,0.0000764,0.0000573,0.0000446,0.0000056,0.0000112,0.0000271,0.0000131,0,0.0000406,0.0000506,0.0000596,0.0000636,0.0000505,0.0000052,0.0000416,0.0000496,0.0000413,0.0000346,0.0000266,0,0,0.0000073,4e-7,0.0000026,0.0000131,0.0000156,0.0000258,0.0000333,0.0000186,0.000026,0.0000701,0.0000854,0.0000988,0.0001047,0.0000886,0.0000803,0.0001127,0.0001114,0.0001,0.0000882,0.000066,0.0000316,0.0000672,0.0000778,0.0000817,0.0000815,0.0000715,0.000025,0.0000107,0.0000145,0.0000019,0.0000142,0.0000342,0.0000388,0.0000468,0.0000509,0.0000375,0.0000537,0.0000771,0.0000762,0.0000695,0.0000612,0.0000373,0.0000132,0.0000162,0.0000128,0.0000062,0.0000176,0.0000194,0.0000304,0.0000453,0.0000449,0.0000385,0.0000603,0.0000671,0.0000587,0.0000469,0.0000342,0,0.0000136,0.0000316,0.0000374,0.0000393,0.0000391,0.0000158,0.0000135,0.0000291,0.0000337,0.0000547,0.0000774,0.000073,0.0000876,0.0002546,0.0005144,0.0008796,0.0013194,0.0018325,0.0021931,0.0024181,0.0024504,0.0024101,0.0022015,0.0018613,0.0014359,0.001026,0.0006275,0.0003652,0.0001861,0.0000823,0.0000294,0.000031,0.0000436,0.0000556,0.0000669,0.0000698,0.000057,0.0000355,0.0000297,0.0000246,0.0000107,0.0000095,0.000006,0.0000155,0.0000348,0.0000356,0.0000302,0.0000245,0.0000227,0.0000121,0.000005,0.0000112,0.0000208,0.0000316,0.0000364,0.0000337,0.0000497,0.0000615,0.0000628,0.0000627,0.0000601,0.0000432,0.0000232,0.0000195,0.0000122,0.0000018,0.0000075,0.0000107,0.0000179,0.0000373,0.0000441,0.0000536,0.0000605,0.0000583,0.0000393,0.0000299,0.0000438,0.0000584,0.000072,0.000074,0.0000611,0.0000439,0.0000302,0.0000117,0.000014,0.0000247,0.0000262,0.0000261,0.0000238,0.0000139,0.0000166,0.0000243,0.0000211,0.0000331,0.0000569,0.0000683,0.0000775,0.0000838,0.0000822,0.0000783,0.0000923,0.0000925,0.0000866,0.0000752,0.0000584,0.0000261,0.0000334,0.0000409,0.0000463,0.0000559,0.0000599,0.000054,0.000044,0.0000353,0.000028,0.0000375,0.0000428,0.0000381,0.0000319,0.0000383,0.0000367,0.0000306,0.0000203,0.0000083,0.0000295,0.0000497,0.0000505,0.000047,0.0000412,0.0000355,0.0000217,0.0000113,0.0000156,0.0000246,0.0000327,0.0000356,0.0000299,0.0000262,0.0000265,0.0000149],"detections":[{"range_m":2.805707,"snr_db":26.0194,"width_m":0.171607}],"noise_floor":0.000035575,"blast_amplitude":0.2700244,"saturated":false}
{"timestamp":1756162803.4666634,"source":"simulated","device_id":"batvu-reference-01","beam":[-0.7848856,-0.4531539,0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000115,0.0000065,6e-7,0.0000051,0.0000476,0.0000416,0.0000142,0.0000138,0.0000362,0.0000276,0.0000231,0.0000229,0,0.0000125,0.0000507,0.0000552,0.0000587,0.0000601,0.0000083,0.0000192,0.0000585,0.0000548,0.0000412,0.0000313,0.0000057,0.000001,0.0000326,0.0000405,0.0000493,0.0000539,0.0000297,0,0.0000493,0.0000521,0.0000532,0.0000532,0.0000495,0,0.0000264,0.0000334,0.0000246,0.0000147,0.0000051,0.0000049,0.0000055,0.0000105,0.0000192,0.0000347,0.0000475,0.0000431,0.0000614,0.0000837,0.0000814,0.0000921,0.000099,0.0000829,0.0000558,0.0000666,0.0000616,0.0000304,0.0000114,0.0000281,0.0000456,0.000066,0.0000665,0.0000465,0.0000442,0.0000443,0.0000287,0.0000291,0.0000395,0.0000423,0.0000422,0.0000403,0.0000445,0.0000682,0.0000755,0.0000591,0.0000383,0.0000544,0.0000523,0.0000441,0.0000343,0.0000103,0.0000081,0.000019,0.000015,0.0000198,0.0000578,0.0000585,0.0000561,0.0000464,0.0000295,0,0.0000097,0.0000123,7e-7,0.0000204,0.0000376,0.0000537,0.0000792,0.0000935,0.0000923,0.0000818,0.0000536,0.000115,0.0003241,0.0006256,0.0010044,0.0014564,0.0020008,0.0023515,0.0025571,0.0025903,0.0025409,0.0022969,0.0019187,0.0014759,0.0009395,0.0005839,0.0003321,0.0001572,0.0000709,0.0000536,0.0000434,0.00006,0.0000658,0.0000644,0.0000711,0.0000771,0.0000746,0.0000735,0.0000713,0.0000483,0.0000346,0.0000425,0.0000391,0.0000314,0.0000248,0.0000148,0.0000182,0.0000321,0.0000327,0.0000411,0.0000544,0.000054,0.0000448,0.0000383,0.0000312,0.0000099,0.0000063,0.0000119,0.0000172,0.0000328,0.0000454,0.0000501,0.0000563,0.0000588,0.0000491,0.0000493,0.0000545,0.0000457,0.0000232,0.0000591,0.0000782,0.0000818,0.0000789,0.0000542,0.0000143,0.000034,0.0000426,0.0000577,0.0000757,0.0000757,0.000066,0.0000529,0.000046,0.0000311,0.0000225,0.0000114,0.0000261,0.0000416,0.0000469,0.0000462,0.0000652,0.000075,0.000075,0.0000734,0.0000699,0.0000549,0.0000368,0.0000376,0.0000358,0.0000344,0.000034,0.0000276,0.0000185,0.000034,0.0000381,0.0000445,0.0000518,0.0000509,0.0000518,0.0000668,0.0000699,0.0000634,0.0000468,0.0000434,0.0000643,0.0000753,0.0000757,0.000058,0.0000381,0.0000391,0.0000424,0.0000517,0.0000576,0.0000538,0.000049,0.0000544,0.0000522,0.0000469,0.0000445,0.0000369,0.0000189,0.0000173,0.0000214,0.0000262,0.0000342,0.0000331,0.0000248,0.0000178,0.0000169,0.0000236,0.0000334,0.0000375,0.0000357,0.00004,0.000041,0.0000282],"detections":[{"range_m":2.67729,"snr_db":23.9001,"width_m":0.171607}],"noise_floor":0.0000412,"blast_amplitude":0.2700642,"saturated":false}
{"timestamp":1756162803.53333,"source":"simulated","device_id":"batvu-reference-01","beam":[-0.8754261,-0.2345697,0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000475,0.0000525,0.0000496,0.0000445,0.0000386,0,0,0.0000014,0,0.0000025,0.0000334,0.0000313,0.0000465,0.0000658,0.0000606,0.000064,0.0000671,0.000032,0.0000035,0.0000142,0.0000022,0,0.0000312,0.0000479,0.0000615,0.0000627,0.0000327,0,0.0000039,0,0,0.0000122,0.0000171,0,0.0000117,0.0000216,0.0000241,0.0000345,0.0000392,0.0000188,0.0000204,0.0000292,0.0000192,0.000027,0.000042,0.0000349,0.0000253,0.0000145,0.0000198,0.00004,0.0000555,0.0000475,0.0000437,0.0000648,0.0000618,0.0000539,0.0000736,0.0000716,0.0000696,0.0000784,0.0000771,0.0000508,0.0000305,0.0000182,0.0000055,0.0000306,0.0000416,0.000041,0.000037,0.0000264,0.0000131,0.0000292,0.000034,0.0000168,0.0000011,0.0000068,0.0000016,0,0.0000208,0.0000209,0.0000182,0.0000144,0.0000298,0.0000473,0.0000578,0.0000494,0.0000254,0.0000317,0.0000325,0.0000408,0.000056,0.000058,0.00003,0.0001783,0.0004186,0.0007797,0.0012623,0.0017955,0.0023901,0.0027588,0.0029129,0.0029133,0.0027817,0.0024581,0.0019905,0.0014667,0.0009863,0.0005239,0.0002558,0.0001076,0.0000481,0.0000331,0.0000349,0.0000323,0.0000241,0.0000381,0.0000371,0.000019,0.0000079,0.000018,0.0000184,0.000018,0.0000184,9e-7,0.0000017,0.0000129,0.0000124,0.0000104,0.0000096,0,0.0000232,0.00005,0.0000598,0.000067,0.0000713,0.0000653,0.0000473,0.0000412,0.0000335,0.0000362,0.000064,0.0000682,0.0000679,0.0000635,0.0000567,0.000045,0.0000465,0.0000463,0.0000224,0.0000022,0.000016,0.0000221,0.0000282,0.0000301,0.0000187,0.0000181,0.0000252,0.0000208,0.0000259,0.000041,0.000041,0.0000365,0.0000256,0.0000266,0.000044,0.0000574,0.0000541,0.0000432,0.0000375,0.0000332,0.000017,0.0000205,0.000023,0.0000241,0.000032,0.0000338,0.0000252,0.0000261,0.0000305,0.000028,0.0000298,0.0000304,0.0000176,0.0000058,0.0000132,0.000017,0.0000296,0.0000462,0.0000484,0.0000524,0.0000557,0.0000507,0.0000373,0.0000333,0.0000322,0.0000428,0.0000648,0.0000671,0.0000659,0.0000583,0.0000483,0.0000424,0.0000626,0.0000654,0.0000579,0.0000445,0.0000302,0.0000168,0.0000381,0.0000537,0.0000539,0.0000534,0.0000524,0.0000411,0.0000252,0.0000257,0.0000277,0.0000342,0.0000385,0.0000346,0.000024,0.0000189,0.0000172,0.000022,0.000047,0.0000554,0.0000642,0.0000741,0.000076,0.0000717,0.0000809,0.0000862,0.0000838,0.0000805,0.0000798,0.0000724],"detections":[{"range_m":2.522419,"snr_db":29.933,"width_m":0.175182}],"noise_floor":0.00003173,"blast_amplitude":0.2700129,"saturated":false}
{"timestamp":1756162803.5999966,"source":"simulated","device_id":"batvu-reference-01","beam":[-0.9063078,0,0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000093,0.0000193,0.0000275,0.0000503,0.0000396,0.0000226,0.0000313,0.0000351,0,0.0000018,0.0000141,0.0000059,0.0000316,0.0000491,0.0000186,0.0000276,0.0000651,0.0000706,0.0000713,0.00007,0.0000242,0.0000217,0.0000602,0.0000587,0.0000606,0.0000661,0.0000449,0.0000254,0.0000649,0.0000599,0.0000575,0.0000736,0.0000661,0.0000344,0.0000399,0.0000474,0.0000468,0.000046,0.0000414,0,0.0000292,0.0000451,0.0000426,0.0000516,0.0000555,0.0000341,0.0000173,0.0000079,0.000025,0.0000482,0.0000664,0.0000533,0.0000332,0.0000198,0.0000185,0.0000246,0.0000265,0.0000148,0.0000124,0.0000395,0.0000373,0.0000278,0.0000362,0.0000361,0.0000162,0.0000014,0.0000026,0,0.0000162,0.0000433,0.0000563,0.000068,0.0000731,0.0000603,0.0000883,0.0001098,0.00011,0.0001058,0.0000917,0.0000518,6e-7,0,0,0,0.0000273,0.0000291,0.000032,0.000038,0.0000321,0.0000278,0.000037,0.000033,0.0000864,0.0002958,0.0006725,0.0011035,0.0016185,0.0021337,0.0025895,0.0029129,0.0030132,0.0029981,0.0027304,0.0023054,0.0017667,0.0012316,0.0007879,0.000448,0.0002122,0.000085,0.0000556,0.0000634,0.0000779,0.0000769,0.0000728,0.0000648,0.0000477,0.0000071,0.0000044,0.000009,0.0000172,0.0000264,0.0000281,0.0000155,0.000033,0.0000415,0.0000458,0.0000509,0.0000528,0.0000397,0.0000411,0.0000509,0.0000453,0.0000331,0.0000198,0.0000027,0.0000067,0.0000168,0.0000229,0.0000304,0.0000364,0.0000326,0.0000466,0.0000816,0.0001001,0.0001139,0.0001187,0.0001137,0.0000806,0.0000489,0.0000241,0.000013,0.0000344,0.0000425,0.0000367,0.0000271,0.0000196,0.000003,0.0000094,0.0000372,0.0000521,0.0000619,0.0000622,0.0000481,0.0000278,0.0000276,0.0000239,0.000017,0.000035,0.0000372,0.0000385,0.0000385,0.0000345,0.0000159,0.0000174,0.0000199,0.0000151,0.0000121,0.0000136,0.0000159,0.0000182,0.0000184,0.0000065,0.000011,0.0000132,0.000003,0.0000185,0.000035,0.0000406,0.0000531,0.0000696,0.0000697,0.0000661,0.0000543,0.0000286,0.000019,0.0000411,0.000042,0.0000435,0.0000509,0.0000497,0.0000378,0.0000248,0.0000121,0.0000104,0.0000226,0.0000244,0.0000173,0.0000135,0.0000132,3e-7,0.0000097,0.0000233,0.000032,0.0000515,0.0000684,0.0000697,0.000069,0.0000665,0.0000599,0.000045,0.0000287,0.0000395,0.0000572,0.0000676,0.0000661,0.0000538,0.0000448,0.0000341,0.0000179,0.0000438,0.0000599,0.0000695,0.0000793,0.0000837,0.0000813,0.0000783,0.0000708,0.0000469],"detections":[{"range_m":2.46053,"snr_db":26.8058,"width_m":0.175182}],"noise_floor":0.000037435,"blast_amplitude":0.2699634,"saturated":false}
{"timestamp":1756162803.6666632,"source":"simulated","device_id":"batvu-reference-01","beam":[-0.8754261,0.2345697,0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000262,0.0000363,0.0000413,0.0000414,0.0000711,0.0000657,0.0000896,0.0001134,0.0001206,0.000066,0.0000922,0.000115,0.000103,0.0000881,0.0000757,0,0.0000168,0.0000428,0.0000319,0.0000102,0.0000409,0.0000654,0.0000754,0.0000764,0.0000344,0.0000174,0.0000593,0.0000554,0.0000454,0.0000388,0.0000234,0.0000209,0.0000257,0.0000139,0,0.0000212,0.0000296,0.000026,0.0000468,0.0000522,0.0000511,0.0000621,0.0000677,0.0000576,0.0000741,0.000079,0.0000573,0.0000508,0.0000547,0.0000313,0.0000051,0.0000182,0.0000131,0.000004,0.0000182,0.0000255,0.000035,0.0000477,0.0000432,0.0000274,0.000031,0.0000253,0.0000207,0.0000399,0.0000417,0.0000562,0.0000969,0.0001021,0.0000987,0.0000842,0.0000594,0.000015,0.0000586,0.0000842,0.0000895,0.0001005,0.000106,0.0000921,0.0000762,0.0000738,0.0000626,0.0000478,0.0000436,0.0000245,0,0.0000496,0.0001218,0.0002656,0.0005635,0.0009023,0.0013502,0.0018668,0.0023454,0.0027314,0.0029509,0.0029749,0.0028535,0.0025349,0.0020828,0.001549,0.0010479,0.0006448,0.0003392,0.0001192,0.000047,0.0000358,0.0000408,0.0000442,0.0000339,0.0000357,0.0000566,0.000055,0.0000475,0.0000367,0.0000237,0.0000342,0.0000474,0.0000461,0.0000335,0.0000464,0.0000458,0.0000328,0.000022,0.0000174,0.0000011,0.0000156,0.0000219,0.0000215,0.0000211,0.0000224,0.0000122,0.0000118,0.0000189,0.0000197,0.0000236,0.0000246,0.0000115,0.0000032,0.0000212,0.0000205,0.0000145,0.0000096,0.0000127,0.0000339,0.0000632,0.0000709,0.0000764,0.0000817,0.000079,0.0000577,0.0000412,0.0000338,0.0000138,0.0000079,0.0000356,0.0000493,0.000058,0.0000595,0.0000459,0.0000524,0.0000698,0.0000703,0.0000687,0.0000609,0.0000427,0.000034,0.0000526,0.000061,0.0000732,0.0000835,0.0000788,0.0000632,0.0000555,0.0000531,0.000035,0.0000167,0.0000104,0.0000184,0.0000272,0.0000291,0.0000208,0.0000115,0.0000043,0.0000091,0.0000137,0.0000175,0.0000226,0.0000304,0.000035,0.0000304,0.0000367,0.0000469,0.0000436,0.0000357,0.0000344,0.0000304,0.00002,0.0000132,0.0000127,0.0000128,0.0000123,0.0000085,0.0000089,0.0000289,0.0000471,0.0000655,0.0000841,0.0000861,0.0000758,0.0000654,0.0000631,0.0000547,0.000053,0.0000558,0.0000451,0.0000285,0.0000229,0.0000284,0.0000321,0.000036,0.000035,0.000043,0.0000462,0.0000409,0.0000263,0.0000243,0.0000233,0.000018,0.0000289,0.000029,0.0000332,0.0000401,0.0000408,0.0000239,0.0000173,0.0000415,0.0000491,0.0000487,0.0000413,0.0000188],"detections":[{"range_m":2.341614,"snr_db":24.7451,"width_m":0.175182}],"noise_floor":0.000034277,"blast_amplitude":0.2700113,"saturated":false}
{"timestamp":1756162803.7333298,"source":"simulated","device_id":"batvu-reference-01","beam":[-0.7848856,0.4531539,0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000309,0.0000344,0.0000356,0.0000369,0.000042,0.0000223,0,0,0.0000176,0.0000138,0.0000057,0.0000188,0.0000362,0.0000558,0.0000645,0.000018,0.0000594,0.0000943,0.0000998,0.0001034,0.0001036,0.0000594,0.0000299,0.000056,0.0000438,0.000034,0.0000503,0.0000372,0.0000185,0.0000405,0.0000344,0.0000314,0.000048,0.0000426,0.0000407,0.0000707,0.0000765,0.0000596,0.000053,0.0000536,0.0000523,0.0000744,0.0000799,0.0000538,0.0000451,0.0000503,0.0000284,0.0000178,0.0000412,0.0000434,0.0000435,0.0000426,0.0000109,0,0.0000293,0.0000303,0.0000317,0.0000357,0.0000278,0.0000121,0.000038,0.0000435,0.0000555,0.0000691,0.0000681,0.0000462,0.0000753,0.000079,0.0000754,0.000072,0.0000723,0.0000539,0.0000735,0.0000825,0.0000648,0.0000551,0.0000772,0.0000808,0.0000784,0.0000506,0.0001688,0.0004056,0.0007399,0.0011665,0.0016958,0.0022548,0.0027115,0.003003,0.0030724,0.0030096,0.0027119,0.0022615,0.0017412,0.0012057,0.0007544,0.0004233,0.0001532,0.0000512,0.0000326,0.0000236,0.0000444,0.000057,0.0000534,0.0000415,0.0000306,0.000004,0.0000017,0.0000212,0.0000232,0.000024,0.0000239,0.0000092,0.0000192,0.0000509,0.0000617,0.0000732,0.0000864,0.000086,0.0000817,0.0000885,0.0000861,0.0000638,0.0000473,0.0000383,0.0000098,0.0000247,0.0000319,0.0000294,0.0000216,0.0000187,0.0000314,0.0000491,0.0000598,0.0000548,0.0000491,0.0000514,0.000044,0.0000511,0.0000632,0.0000599,0.0000404,0.0000273,0.0000208,0.0000141,0.0000236,0.0000236,0.0000193,0.0000207,0.0000226,0.0000301,0.0000365,0.0000375,0.0000246,0.0000397,0.0000465,0.0000371,0.0000189,0.0000169,0.0000283,0.0000328,0.0000329,0.0000214,0.0000131,0.0000225,0.0000243,0.0000315,0.0000414,0.0000411,0.0000486,0.0000569,0.0000513,0.0000289,0.0000147,0.0000335,0.0000435,0.000049,0.0000502,0.0000507,0.0000569,0.0000572,0.0000368,0.0000204,0.0000336,0.0000499,0.0000762,0.0000837,0.0000786,0.0000635,0.0000521,0.0000522,0.0000582,0.0000596,0.0000478,0.000028,0.0000172,0.0000114,0.0000122,0.0000313,0.0000338,0.0000345,0.0000411,0.0000408,0.0000407,0.0000472,0.0000489,0.0000436,0.0000401,0.0000394,0.0000358,0.0000453,0.0000492,0.0000446,0.0000461,0.0000507,0.0000443,0.0000348,0.000027,0.0000183,0.000021,0.0000257,0.0000231,0.0000264,0.000032,0.0000288,0.0000206,0.0000242,0.0000234,0.0000187,0.0000269,0.0000266,0.0000283,0.0000388,0.0000417,0.0000451,0.0000551,0.0000597,0.0000559,0.000056,0.0000584,0.0000528],"detections":[{"range_m":2.219249,"snr_db":25.9613,"width_m":0.171607}],"noise_floor":0.000038964,"blast_amplitude":0.270044,"saturated":false}
{"timestamp":1756162803.7999964,"source":"simulated","device_id":"batvu-reference-01","beam":[-0.6408564,0.6408564,0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000682,0.0000653,0.0000411,0.0000602,0.0000809,0.000058,0.0000388,0.0000322,0.0000029,0.000004,0.0000065,0,0.0000314,0.0000618,0.0000634,0.0000633,0.0000592,0.0000125,0.0000018,0.0000184,0.0000046,7e-7,0.0000258,0.0000217,0.0000207,0.0000214,0,0,7e-7,0,0,0.0000122,0.0000204,0.0000141,0.0000228,0.0000264,0.000016,0.0000149,0.0000159,0,0.0000069,0.0000217,0.0000204,0.0000211,0.0000221,0,0.0000017,0.0000357,0.0000357,0.0000355,0.0000366,0.0000182,0.0000118,0.000047,0.0000461,0.0000354,0.0000343,0.0000371,0.0000455,0.0000539,0.0000524,0.0000272,0.0000164,0.0000177,0.0000196,0.0000198,0.0000187,0,0.0000111,0.0000477,0.0000739,0.0000982,0.0001055,0.000091,0.0000864,0.0001038,0.0001034,0.0001122,0.0001198,0.0001112,0.0001084,0.0001182,0.00011,0.0001347,0.0004118,0.0007585,0.001218,0.0017485,0.0022495,0.0026703,0.0029304,0.0029688,0.0028701,0.0025488,0.0020734,0.0015119,0.0009941,0.000589,0.0002873,0.0000636,0.000069,0.0000772,0.0000757,0.0000648,0.0000448,0.0000369,0.0000374,0.0000208,0.0000066,0.0000269,0.0000266,0.0000252,0.0000244,0.0000196,0,0.0000032,0.0000031,0.0000074,0.0000357,0.0000493,0.0000521,0.0000523,0.0000523,0.0000328,0.0000253,0.0000272,0.0000173,0.0000359,0.0000528,0.0000505,0.0000389,0.0000208,0.0000251,0.0000419,0.0000516,0.0000477,0.0000472,0.0000681,0.0000712,0.0000716,0.0000703,0.0000629,0.0000423,0.0000655,0.0000789,0.0000957,0.0001086,0.0001099,0.0000891,0.0000635,0.0000407,0.0000041,0.0000284,0.0000372,0.0000325,0.0000193,0.0000077,0.000017,0.000024,0.0000263,0.0000178,0.0000183,0.000033,0.0000325,0.0000276,0.0000198,0.0000112,0.0000111,0.0000095,0.0000151,0.0000359,0.0000542,0.000057,0.0000478,0.0000467,0.0000479,0.000038,0.0000352,0.0000381,0.0000387,0.0000637,0.0000782,0.0000792,0.0000782,0.0000733,0.0000571,0.0000407,0.0000439,0.0000393,0.0000295,0.0000186,0.0000028,0.000013,0.0000194,0.0000176,0.0000053,0.0000126,0.0000133,0.0000201,0.0000343,0.0000389,0.0000414,0.0000461,0.0000466,0.0000318,0.0000205,0.0000239,0.0000204,0.000015,0.0000139,0.0000163,0.0000189,0.0000198,0.0000119,0.00001,0.0000272,0.000035,0.0000455,0.0000521,0.0000495,0.0000485,0.0000597,0.0000595,0.0000523,0.00004,0.000021,0.0000257,0.0000376,0.0000392,0.0000297,0.0000237,0.0000266,0.0000314,0.0000441,0.0000493,0.0000467],"detections":[{"range_m":2.343495,"snr_db":22.8944,"width_m":0.171607}],"noise_floor":0.000033884,"blast_amplitude":0.2699887,"saturated":false}
{"timestamp":1756162803.866663,"source":"simulated","device_id":"batvu-reference-01","beam":[-0.4531539,0.7848856,0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000112,0.0000041,0,0,0.0000404,0.0000373,0.0000086,0,0.000035,0.0000393,0.0000455,0.0000481,0.000012,0.0000337,0.0000634,0.0000761,0.0000908,0.0000968,0.0000546,0.0000716,0.000105,0.0000962,0.0000813,0.0000832,0.000058,0.0000626,0.0000824,0.0000682,0.0000479,0.0000536,0.0000333,0.000001,0.0000067,0.0000014,0,0.0000287,0.0000441,0.0000552,0.0000698,0.0000703,0.0000361,0.0000388,0.0000454,0.0000248,0.0000071,0.0000063,0,0.000015,0.00005,0.000055,0.0000555,0.0000541,0.0000176,0,0.0000092,0.0000027,8e-7,0.0000153,0.0000113,0.0000135,0.0000443,0.0000425,0.0000288,0.0000102,0.0000246,0.0000387,0.0000496,0.0000486,0.0000299,0.0000501,0.0000592,0.0000587,0.0000641,0.0000671,0.0000469,0.0000542,0.0000638,0.0000566,0.0000525,0.0000572,0.0000461,0.0000264,0.0000178,0.0000028,0.0000204,0.000036,0.0000329,0.0000231,0.0000356,0.0000297,0.0000024,0.0000341,0.0000373,0.0000288,0.0001921,0.0005164,0.0009044,0.0013815,0.0018694,0.0023129,0.0026415,0.0027615,0.0027554,0.0025351,0.0021553,0.001658,0.0011537,0.0007268,0.0003912,0.0001506,0.0000559,0.0000696,0.0000683,0.0000521,0.0000218,0.0000019,0.0000096,0.0000151,0.0000365,0.000064,0.0000657,0.0000619,0.0000576,0.0000577,0.0000384,0.0000353,0.0000487,0.000057,0.0000606,0.0000612,0.0000468,0.0000492,0.000055,0.0000415,0.0000305,0.0000532,0.0000619,0.0000645,0.0000643,0.0000531,0.0000293,0.0000402,0.0000393,0.0000351,0.0000308,0.0000235,0.0000174,0.0000559,0.0000724,0.0000847,0.000091,0.0000913,0.0000714,0.00006,0.0000625,0.0000502,0.0000385,0.0000305,0.0000157,0.0000249,0.0000341,0.0000317,0.0000266,0.0000258,0.000016,0.0000161,0.0000426,0.000051,0.0000537,0.0000535,0.0000426,0.0000218,0.0000169,0.0000168,0.0000217,0.0000297,0.0000315,0.0000277,0.0000462,0.0000534,0.0000532,0.0000478,0.000035,0.0000093,0.000029,0.0000357,0.0000354,0.0000419,0.0000459,0.0000381,0.0000219,0.0000272,0.0000373,0.0000449,0.0000478,0.0000419,0.0000275,0.0000383,0.0000393,0.0000386,0.0000321,0.0000185,0.0000038,0.0000118,0.0000124,7e-7,0.0000235,0.0000321,0.0000389,0.0000497,0.0000543,0.0000502,0.0000443,0.0000395,0.0000238,0.0000297,0.0000392,0.0000372,0.0000272,0.0000137,0.0000093,0.000018,0.0000293,0.0000389,0.0000565,0.0000754,0.0000764,0.000075,0.0000728,0.0000697,0.0000563,0.0000477,0.0000405,0.0000145,0.0000281,0.0000555,0.000064,0.0000675,0.0000683,0.0000592],"detections":[{"range_m":2.462697,"snr_db":27.6475,"width_m":0.175182}],"noise_floor":0.000039104,"blast_amplitude":0.2698932,"saturated":false}
{"timestamp":1756162803.9333296,"source":"simulated","device_id":"batvu-reference-01","beam":[-0.2345697,0.8754261,0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000818,0.0000688,0.0000454,0.0000194,0.0000311,0.0000311,0.0000221,0.0000071,0.0000294,0.0000437,0.0000639,0.0000706,0.0000381,0.0000354,0.0000522,0.00004,0.000044,0.0000457,0,0.000031,0.0000724,0.0000691,0.0000551,0.0000425,0,0,0.0000422,0.0000545,0.0000654,0.0000688,0.0000455,0.0000144,0.0000608,0.000062,0.0000628,0.0000626,0.0000609,0.0000369,0.0000623,0.0000653,0.0000409,0.000059,0.000072,0.0000656,0.0000753,0.0000787,0.0000551,0.000039,0.0000399,0.0000255,0.0000258,0.0000353,0.0000234,0.0000316,0.0000475,0.0000402,0.0000258,0.0000185,0.0000097,0,0.0000291,0.0000349,0.0000374,0.0000426,0.0000418,0.00003,0.0000321,0.0000287,4e-7,0.0000107,0.0000137,0.0000088,0.0000292,0.0000433,0.0000391,0.0000427,0.0000452,0.0000271,0.0000292,0.0000451,0.0000404,0.0000247,0.0000193,0.0000132,0.0000146,0.0000213,0.0000153,0.0000092,0.0000562,0.0000662,0.0000683,0.0000676,0.0000602,0.0000348,0.0000411,0.0000433,0.0000331,0.0000561,0.0000626,0.0000513,0.000041,0.0001884,0.0004723,0.0008233,0.0012484,0.0017136,0.0021705,0.0025173,0.0026628,0.0026664,0.0025565,0.0021691,0.0017199,0.0012678,0.0008631,0.0005262,0.00029,0.0001516,0.0000871,0.0000848,0.0000767,0.0000446,0.0000264,0.0000192,0.0000104,0.0000415,0.0000517,0.0000554,0.00006,0.000062,0.0000506,0.0000576,0.0000671,0.0000623,0.0000683,0.0000785,0.0000762,0.000071,0.0000682,0.0000597,0.0000405,0.000044,0.0000403,0.000034,0.000041,0.0000392,0.0000217,0.0000055,0.0000104,0.0000106,0.0000106,0.0000111,0,0.0000192,0.0000459,0.0000559,0.0000585,0.0000579,0.0000394,0.0000496,0.0000686,0.0000714,0.0000761,0.0000797,0.0000721,0.0000574,0.0000431,0.000022,0.0000025,0.0000167,0.0000153,0.0000147,0.0000255,0.000025,0.0000166,0.0000099,0.0000128,0.0000191,0.0000298,0.000032,0.0000226,0.000008,0.0000249,0.0000379,0.0000444,0.0000446,0.0000299,0.0000193,0.0000248,0.0000245,0.0000306,0.0000371,0.0000327,0.0000392,0.0000534,0.0000532,0.0000505,0.0000464,0.0000406,0.0000266,0.0000332,0.0000328,0.0000359,0.0000533,0.0000601,0.0000602,0.0000578,0.0000504,0.0000323,0.0000257,0.0000241,0.0000109,0.0000258,0.0000419,0.0000471,0.0000542,0.0000586,0.0000535,0.0000462,0.0000438,0.000035,0.0000104,0.0000445,0.0000659,0.0000796,0.0000839,0.0000812,0.0000625,0.0000478,0.0000377,0.0000237,0.0000309,0.0000373,0.000043,0.0000484,0.0000492,0.000032,0.0000134,0.0000269,0.0000338],"detections":[{"range_m":2.595257,"snr_db":24.5685,"width_m":0.175182}],"noise_floor":0.000035931,"blast_amplitude":0.27005,"saturated":false}
{"timestamp":1756162803.9999962,"source":"simulated","device_id":"batvu-reference-01","beam":[0,0.9063078,0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000431,0.0000512,0.0000582,0.000076,0.0000902,0.0000624,0.0000886,0.0001007,0.0000741,0.0000569,0.0000544,0,0.0000184,0.0000599,0.0000623,0.0000619,0.0000577,0.000017,0.0000091,0.000018,0,0.0000168,0.0000383,0.0000238,0.000013,0.0000745,0.0000771,0.0000767,0.0000714,0.0000479,0,0.0000101,0.0000168,0.0000022,0.0000456,0.0000709,0.0000877,0.0000977,0.0000984,0.000055,0.0000531,0.0000671,0.0000601,0.0000502,0.0000432,0.0000269,0.0000482,0.0000675,0.0000568,0.0000488,0.0000557,0.000044,0.0000527,0.0001056,0.0001229,0.0001277,0.0001275,0.0001115,0.0000792,0.0001004,0.0001016,0.0000831,0.0000704,0.000068,0.0000417,0.0000455,0.0000524,0.0000458,0.000039,0.0000378,0.0000407,0.0000521,0.0000549,0.0000325,0.0000094,0.0000094,0,0,0.0000106,0.0000035,0.0000274,0.0000798,0.0000993,0.0001096,0.0001114,0.0000998,0.0000703,0.0000768,0.0000774,0.0000685,0.0000616,0.000055,0.0000146,0.0000112,0.0000263,0.0000288,0.0000447,0.0001202,0.0003343,0.0006511,0.0010659,0.0015391,0.0020205,0.0024136,0.0026314,0.0026696,0.0026341,0.0023397,0.001923,0.0014545,0.001002,0.0006147,0.0003456,0.0001888,0.0000884,0.0000533,0.0000275,0.0000369,0.000047,0.0000471,0.0000186,0.0000147,0.0000189,0.0000157,0.0000372,0.0000526,0.0000529,0.0000512,0.0000467,0.0000317,0.0000473,0.0000585,0.0000555,0.0000497,0.0000543,0.0000493,0.0000386,0.0000562,0.0000602,0.0000629,0.0000632,0.0000587,0.000037,0.0000496,0.0000507,0.0000494,0.0000485,0.0000486,0.0000306,0.0000337,0.000052,0.0000605,0.0000649,0.0000651,0.0000478,0.0000338,0.00004,0.0000359,0.000027,0.0000199,0.0000156,0.0000264,0.0000441,0.0000525,0.0000686,0.0000892,0.0000889,0.0000854,0.0000814,0.0000746,0.0000535,0.0000409,0.0000357,0.0000164,0.0000314,0.0000366,0.0000365,0.0000354,0.000033,0.0000156,0.0000026,0.0000104,0.00002,0.000042,0.000063,0.0000704,0.0000767,0.0000804,0.0000715,0.000054,0.0000411,0.0000324,0.0000229,0.0000164,0.0000068,0.0000181,0.0000372,0.0000429,0.0000477,0.000049,0.0000484,0.0000299,0.0000287,0.0000311,0.0000282,0.0000332,0.0000374,0.0000432,0.000061,0.0000772,0.0000782,0.0000779,0.000076,0.0000697,0.0000888,0.0001087,0.0001086,0.0000986,0.0000701,0.0000409,0.000046,0.0000589,0.0000577,0.0000434,0.0000282,0.0000147,0.000015,0.0000316,0.0000375,0.0000418,0.0000529,0.0000602,0.0000604,0.0000587,0.0000519,0.00003],"detections":[{"range_m":2.60293,"snr_db":23.7083,"width_m":0.175182}],"noise_floor":0.000045183,"blast_amplitude":0.2700521,"saturated":false}
{"timestamp":1756162804.0666628,"source":"simulated","device_id":"batvu-reference-01","beam":[0.2345697,0.8754261,0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000425,0.0000391,0.0000281,0.0000212,0.0000198,0.0000024,0.0000102,0.0000355,0.0000501,0.0000172,0.0000158,0.0000286,0.0000107,0.0000116,0.0000356,0.0000309,0.0000237,0.0000138,0.0000094,0.0000188,0.0000339,0.0000278,0.0000389,0.0000447,0.0000089,0,0.000042,0.0000393,0.000026,0.0000259,0.0000474,0.0000644,0.0000726,0.0000621,0.0000271,0.0000482,0.0000526,0.0000468,0.0000676,0.0000702,0.0000557,0.000094,0.0001105,0.0001035,0.0000869,0.0000756,0.0000564,0.0000793,0.0000888,0.0000709,0.0000696,0.0000931,0.0000854,0.0000723,0.000062,0.0000378,0.0000326,0.0000658,0.0000651,0.0000628,0.0000627,0.0000504,0.000016,0.000007,0.0000059,0.0000059,0.0000347,0.0000378,0.0000308,0.0000253,0.000025,0.0000022,0.0000021,0.0000161,0.0000125,0.0000146,0.0000268,0.0000283,0.0000294,0.0000297,0.000015,0.0000081,0.0000118,0,0,0.0000078,0.0000072,0.0000088,0.0000229,0.0000213,0.0000257,0.0000369,0.0000356,0.000019,0.0000394,0.0000461,0.0000368,0.0000476,0.0000675,0.0000778,0.000079,0.0000751,0.0000385,0.0000326,0.0001259,0.0002957,0.0005846,0.0009738,0.0014133,0.0018656,0.0023098,0.0025071,0.0025432,0.0025141,0.0023154,0.0019567,0.0015265,0.0010938,0.000632,0.0003651,0.0002006,0.000092,0.0000395,0.0000269,0.0000174,0.0000262,0.0000305,0.0000348,0.0000472,0.0000544,0.0000549,0.0000661,0.0000732,0.0000601,0.0000352,0.0000159,0.0000347,0.0000506,0.0000638,0.0000628,0.0000689,0.0000772,0.0000741,0.0000691,0.0000773,0.0000762,0.0000697,0.0000859,0.0000858,0.0000766,0.0000659,0.0000561,0.000031,0.0000286,0.0000362,0.0000417,0.0000569,0.0000672,0.0000736,0.0000873,0.0000962,0.0000918,0.0000794,0.0000855,0.0000941,0.0000989,0.0000987,0.0000837,0.0000528,0.0000338,0.0000216,0.0000088,0.0000252,0.0000268,0.0000286,0.0000377,0.0000486,0.0000696,0.0000989,0.0001113,0.0001138,0.0001141,0.000114,0.0000987,0.0000805,0.0000621,0.0000362,0.0000164,0.0000151,0.0000199,0.0000265,0.0000299,0.0000211,0.0000111,0.0000245,0.0000327,0.0000519,0.0000768,0.0000796,0.0000779,0.0000651,0.0000464,0.0000211,0.0000286,0.0000306,0.0000234,0.0000254,0.0000281,0.0000298,0.0000339,0.0000357,0.0000278,0.00003,0.0000364,0.0000317,0.0000242,0.0000367,0.0000504,0.000064,0.000071,0.000067,0.0000546,0.0000508,0.0000475,0.0000413,0.000049,0.0000489,0.0000516,0.0000552,0.0000522,0.0000289,0.0000273,0.0000551,0.0000696,0.000074,0.0000746,0.0000773,0.0000955,0.0001015,0.0000971],"detections":[{"range_m":2.660501,"snr_db":25.2765,"width_m":0.175182}],"noise_floor":0.000038032,"blast_amplitude":0.2700114,"saturated":false}
{"timestamp":1756162804.1333294,"source":"simulated","device_id":"batvu-reference-01","beam":[0.4531539,0.7848856,0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000041,0.0000043,0.000005,0.0000171,0.0000339,0.0000482,0.0000269,0.0000404,0.0000446,0.0000048,0.0000155,0.0000441,0.0000397,0.0000333,0.000028,0,0,0.0000197,0.0000275,0.0000553,0.0000804,0.000066,0.0000601,0.0000875,0.0000792,0.0000629,0.0000464,0,0,0.0000123,0.0000097,0.0000097,0.000022,0.0000266,0.0000308,0.0000397,0.0000389,0,0.0000073,0.0000224,0.0000164,0.0000064,0.0000116,0.0000206,0.000033,0.0000411,0.0000283,0.0000418,0.000063,0.0000526,0.0000341,0.0000264,0.0000312,0.000041,0.0000557,0.0000527,0.0000679,0.0000872,0.0000834,0.0000687,0.0000742,0.0000733,0.0000492,0.0000356,0.0000332,0.000006,0.0000272,0.0000611,0.0000826,0.0000999,0.0001055,0.0000864,0.0000789,0.0000804,0.0000565,0.0000376,0.0000671,0.000077,0.0000796,0.0000794,0.0000602,0.000038,0.000052,0.0000494,0.0000381,0.0000374,0.0000313,0.0000144,0.0000413,0.0000611,0.0000779,0.0000893,0.0000907,0.0000626,0.0000586,0.0000637,0.0000665,0.000076,0.0000804,0.0000696,0.0000821,0.0000909,0.0000834,0.0000654,0.0000437,0.0000113,0.0000054,0.0000108,0.0000649,0.0001826,0.0003804,0.0006521,0.0010278,0.0014748,0.0019735,0.0022894,0.0024422,0.0024458,0.0023353,0.0020564,0.0016674,0.0012124,0.0007875,0.000392,0.0001574,0.0000316,0.0000155,0.0000087,0.0000234,0.0000568,0.0000759,0.0000943,0.0001016,0.0000916,0.0000661,0.0000405,0.0000131,0.0000028,0.0000044,0,0.0000082,0.0000231,0.0000234,0.0000185,0.0000327,0.0000403,0.0000504,0.0000634,0.0000666,0.0000677,0.0000738,0.0000756,0.0000577,0.0000408,0.0000282,0.0000037,0.0000153,0.0000298,0.0000297,0.0000274,0.0000199,7e-7,0.0000115,0.0000182,0.0000139,0.0000032,0.000021,0.0000272,0.0000333,0.0000357,0.0000328,0.0000154,0.0000278,0.000038,0.0000517,0.0000724,0.000078,0.0000773,0.0000744,0.0000701,0.000052,0.0000416,0.000045,0.000039,0.0000307,0.0000227,0.0000055,0.0000036,0.0000095,0.0000036,0.0000098,0.0000286,0.0000339,0.0000385,0.0000401,0.0000372,0.0000186,0.0000118,0.000014,0.0000249,0.000041,0.0000441,0.0000389,0.0000294,0.0000229,0.0000181,0.0000288,0.0000353,0.0000345,0.0000305,0.0000209,0.0000173,0.0000371,0.000048,0.0000473,0.0000509,0.0000572,0.0000543,0.0000427,0.0000241,0.0000119,0.0000292,0.00004,0.0000388,0.0000293,0.0000444,0.0000464,0.0000519,0.000064,0.0000671,0.0000655,0.0000617,0.0000566,0.0000416,0.0000307,0.0000318,0.0000238],"detections":[{"range_m":2.798828,"snr_db":23.4996,"width_m":0.175182}],"noise_floor":0.000036393,"blast_amplitude":0.27,"saturated":false}
{"timestamp":1756162804.199996,"source":"simulated","device_id":"batvu-reference-01","beam":[0.6408564,0.6408564,0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.000042,0.0000463,0.0000526,0.0000576,0.0000601,0.0000088,0.00003,0.0000426,0.000017,0,0.0000227,0.0000315,0.0000484,0.0000597,0.0000335,0.0000373,0.0000528,0.0000287,0.0000091,0.0000442,0.0000436,0.0000403,0.0000337,0.0000126,0.0000234,0.0000321,0.0000112,0,0.0000448,0.000044,0.0000388,0.0000494,0.000052,0.0000276,0.0000222,0.0000215,0,0.000012,0.0000283,0.0000276,0.000029,0.0000304,0.0000102,0.0000175,0.0000271,0.0000163,0.0000211,0.0000487,0.0000543,0.0000624,0.0000677,0.000052,0.0000266,0.0000166,5e-7,0.0000318,0.0000754,0.0000786,0.0000799,0.0000827,0.0000799,0.000049,0.0000395,0.0000385,0.0000197,0.0000104,0.0000051,0.0000196,0.0000431,0.0000576,0.0000577,0.0000697,0.0000759,0.0000636,0.0000537,0.0000598,0.0000501,0.0000522,0.000079,0.0000805,0.0000788,0.0000682,0.0000428,0.0000402,0.000072,0.0000711,0.0000826,0.0001083,0.0001099,0.000099,0.0000819,0.0000615,0.0000152,0.0000445,0.0000604,0.0000728,0.0000893,0.0000957,0.0000858,0.0000775,0.0000809,0.0000689,0.0000633,0.0000725,0.0000691,0.0000716,0.0000944,0.0001245,0.0002153,0.0003913,0.0006396,0.0009835,0.001398,0.0018853,0.0022342,0.0024565,0.0024892,0.0024486,0.0022334,0.0018752,0.0014222,0.0009835,0.0005633,0.0003003,0.0001334,0.0000459,0.0000039,0.0000059,0.0000102,0.0000036,0.0000088,0.0000394,0.0000523,0.0000588,0.0000607,0.0000538,0.0000435,0.000053,0.0000509,0.0000439,0.0000391,0.0000307,0.000011,0.0000412,0.0000469,0.0000524,0.0000638,0.0000666,0.0000616,0.0000578,0.000058,0.0000446,0.0000503,0.0000549,0.0000472,0.0000388,0.000052,0.0000537,0.0000525,0.0000379,0.0000074,0.0000137,0.0000149,0.0000043,0.00002,0.0000414,0.0000438,0.000053,0.0000634,0.0000621,0.0000493,0.0000512,0.0000537,0.0000474,0.0000414,0.0000366,0.0000188,0.0000239,0.0000304,0.0000275,0.0000183,0.0000138,0.0000253,0.0000315,0.0000326,0.0000238,0.0000316,0.0000638,0.0000818,0.0000947,0.0000971,0.0000885,0.0000631,0.0000457,0.0000374,0.0000205,0.0000061,0.0000093,0.0000189,0.0000314,0.0000349,0.0000409,0.0000528,0.0000545,0.0000455,0.0000387,0.000041,0.0000408,0.0000514,0.0000579,0.0000513,0.00004,0.0000309,0.0000162,0.0000144,0.0000261,0.0000249,0.0000149,0.0000197,0.0000277,0.0000302,0.0000315,0.0000303,0.0000415,0.0000568,0.000056,0.0000455,0.0000354,0.0000329,0.0000332,0.0000465,0.0000563,0.0000642,0.0000755,0.000079,0.0000704],"detections":[{"range_m":2.805746,"snr_db":22.5491,"width_m":0.171607}],"noise_floor":0.00004025,"blast_amplitude":0.2700157,"saturated":false}
{"timestamp":1756162804.2666626,"source":"simulated","device_id":"batvu-reference-01","beam":[0.7848856,0.4531539,0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000042,0.0000021,0,0,0.0000034,0,0,0.0000311,0.0000769,0.0000752,0.0000929,0.0001051,0.0000942,0.000106,0.00011,0.0000436,0.0000491,0.0000731,0.0000629,0.0000505,0.0000439,0.0000045,0.0000186,0.0000592,0.0000576,0.0000486,0.0000348,0.0000043,0.0000047,0.0000242,0.0000194,0.0000203,0.0000202,0.0000025,0.0000034,0.0000216,0.0000245,0.0000015,0.0000182,0.000024,0.0000181,0.0000151,0.0000166,0.0000255,0.0000459,0.0000519,0.0000311,0.0000303,0.0000455,0.000038,0.0000291,0.0000341,0.0000343,0.0000492,0.000061,0.0000507,0.0000308,0.0000204,0.0000108,0.0000198,0.0000384,0.0000355,0.0000384,0.0000574,0.0000576,0.0000324,0.0000256,0.0000361,0.000043,0.000052,0.0000542,0.0000337,0.0000257,0.000042,0.0000462,0.0000496,0.0000515,0.0000346,0.0000262,0.0000295,0.0000172,0.0000132,0.000033,0.0000337,0.0000349,0.000036,0.0000269,0.000008,0.0000119,0.0000052,0.000004,0.0000359,0.0000423,0.0000441,0.0000445,0.000044,0.0000088,0.000026,0.0000438,0.0000461,0.0000451,0.0000375,0.000009,0.0000323,0.0000868,0.0001951,0.0003941,0.0006831,0.0010463,0.0014809,0.0020055,0.0023443,0.0025447,0.0025784,0.0025318,0.0022959,0.0019269,0.0014908,0.0009558,0.0005947,0.0003327,0.000145,0.000046,0.0000361,0.0000357,0.0000328,0.0000355,0.0000442,0.0000579,0.0000637,0.0000567,0.0000466,0.0000385,0.0000158,0.0000165,0.000039,0.000045,0.0000467,0.000047,0.0000406,0.0000293,0.000027,0.0000134,0,0.0000062,0.0000035,0.000008,0.0000264,0.0000263,0.0000225,0.0000327,0.0000352,0.0000262,0.0000201,0.0000257,0.0000237,0.0000184,0.0000185,0.0000396,0.0000617,0.0000744,0.0000747,0.000084,0.0000888,0.0000806,0.0000644,0.0000538,0.0000426,0.0000264,0.0000285,0.0000255,0.0000202,0.0000311,0.0000312,0.0000279,0.0000289,0.0000305,0.0000432,0.0000602,0.0000634,0.0000595,0.0000667,0.0000719,0.0000695,0.0000725,0.000075,0.0000669,0.000059,0.000056,0.0000454,0.0000316,0.0000362,0.0000363,0.0000397,0.0000442,0.0000411,0.0000427,0.0000561,0.0000561,0.0000498,0.0000405,0.000035,0.0000258,0.0000269,0.0000281,0.0000342,0.000051,0.0000535,0.0000487,0.0000502,0.0000539,0.0000514,0.0000537,0.0000548,0.0000429,0.0000307,0.0000263,0.0000173,0.0000049,0.0000012,0.0000051,0.0000321,0.0000647,0.0000831,0.0000964,0.0001021,0.0000998,0.0000825,0.0000672,0.0000509,0.000026,0.000008,0.0000072,0.0000105,0.0000177,0.0000226,0.0000288,0.0000392,0.0000432,0.000038],"detections":[{"range_m":2.677521,"snr_db":26.6231,"width_m":0.171607}],"noise_floor":0.000034531,"blast_amplitude":0.2700238,"saturated":false}
{"timestamp":1756162804.3333292,"source":"simulated","device_id":"batvu-reference-01","beam":[0.8754261,0.2345697,0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000153,0.0000089,0,0.0000011,0.0000486,0.0000431,0.0000107,0,0.0000459,0.0000517,0.000054,0.0000556,0.000023,0.0000494,0.0000655,0.0000384,0.0000488,0.0000608,0.0000305,0.0000068,0.000047,0.0000569,0.0000616,0.0000642,0.0000305,0.0000322,0.0000702,0.0000652,0.0000544,0.0000446,0.0000158,0.0000136,0.0000249,0.0000158,0,0.0000232,0.0000321,0.0000302,0.0000296,0.0000293,0.0000195,0.0000317,0.000034,0.0000028,0.0000159,0.0000278,0.0000155,0,0.0000302,0.0000414,0.0000495,0.0000544,0.0000356,0.0000453,0.0000654,0.0000598,0.0000501,0.0000461,0.0000309,0.000006,0.0000392,0.000038,0.0000341,0.0000498,0.0000508,0.0000361,0.0000344,0.0000346,0.000027,0.0000345,0.0000365,0.0000151,3e-7,0.0000045,0.000003,0.0000323,0.00006,0.0000644,0.0000643,0.0000594,0.0000329,0.000009,0.0000241,0.0000215,0.0000168,0.000013,0.0000013,0.0000183,0.0000462,0.0000455,0.0000519,0.0000668,0.0000665,0.0000556,0.0001144,0.000262,0.0004823,0.0008169,0.0012403,0.0017389,0.0022532,0.0026604,0.0028811,0.0028855,0.0027666,0.0024215,0.0019476,0.0014489,0.0009772,0.0005767,0.0002837,0.000056,0.0000434,0.0000465,0.0000311,0.0000041,0.0000241,0.000024,0.0000206,0.0000449,0.0000508,0.0000555,0.0000594,0.00006,0.0000423,0.0000563,0.0000619,0.0000591,0.0000535,0.0000446,0.0000167,0.0000072,0.0000151,0.0000087,0.0000097,0.0000151,0.0000075,0.000001,0.0000278,0.0000337,0.0000391,0.000048,0.0000462,0.0000398,0.0000323,0.000029,0.0000529,0.0000824,0.0000832,0.0000773,0.000078,0.0000794,0.0000676,0.0000585,0.0000542,0.0000369,0.0000359,0.0000416,0.00004,0.0000398,0.0000397,0.0000311,0.0000415,0.00005,0.0000463,0.0000387,0.0000379,0.0000334,0.000029,0.000037,0.0000338,0.0000262,0.0000336,0.0000327,0.0000271,0.0000382,0.0000428,0.0000551,0.0000782,0.0000855,0.0000851,0.0000805,0.0000768,0.000066,0.0000585,0.0000554,0.0000432,0.000033,0.0000277,0.0000188,0.0000153,0.0000179,0.0000252,0.0000461,0.0000669,0.0000705,0.0000734,0.0000747,0.000072,0.0000554,0.000054,0.0000534,0.0000569,0.0000689,0.0000712,0.0000617,0.0000443,0.0000176,0.0000199,0.0000325,0.0000355,0.0000281,0.0000329,0.0000394,0.0000343,0.0000271,0.0000275,0.0000318,0.000049,0.0000657,0.0000656,0.0000597,0.0000433,0.0000199,0.0000121,0.0000278,0.0000279,0.0000279,0.0000399,0.0000399,0.0000374,0.0000405,0.0000412,0.0000284,0.0000203,0.0000379,0.0000553,0.0000658,0.0000685,0.0000602],"detections":[{"range_m":2.488204,"snr_db":27.0248,"width_m":0.175182}],"noise_floor":0.000034473,"blast_amplitude":0.2700443,"saturated":false}
{"timestamp":1756162804.3999958,"source":"simulated","device_id":"batvu-reference-01","beam":[0.9063078,0,0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000094,0.0000182,0.0000281,0.0000366,0.0000448,0.000025,0,0.0000249,0.0000515,0.00004,0.0000462,0.0000508,0.0000202,0.0000445,0.0000671,0.0000534,0.0000456,0.0000463,0.0000188,0.0000341,0.0000453,0.0000167,0.0000324,0.0000653,0.0000561,0.0000392,0.0000245,0.0000042,0.0000114,0.0000201,0.000007,0.0000028,0.0000133,0.0000053,0,0.000022,0.0000312,0.0000232,0.0000106,0.0000131,0.00002,0.0000241,0.000025,0,0.0000346,0.0000526,0.0000526,0.0000508,0.0000458,0.0000166,0.0000185,0.0000251,0.0000028,0.0000021,0.0000284,0.000026,0.0000202,0.0000151,0.0000015,0.0000217,0.0000489,0.0000473,0.0000629,0.0000986,0.0001026,0.0000946,0.0000785,0.0000633,0.0000287,0.0000265,0.0000279,0.0000025,0.0000099,0.0000313,0.0000324,0.0000341,0.0000348,0.0000116,0,0.0000221,0.0000201,0.0000095,0.0000113,0.0000087,0.0000023,0.0000354,0.0000419,0.0000415,0.0000332,0.0001457,0.0003449,0.0006521,0.0010483,0.0015535,0.0021156,0.0026915,0.0029911,0.0030703,0.0030514,0.0028172,0.0024108,0.0019194,0.0013963,0.0008384,0.0004897,0.0002358,0.0000858,0.0000312,0.0000373,0.0000551,0.0000761,0.0000747,0.0000713,0.0000707,0.0000624,0.0000399,0.0000237,0.0000129,0.000023,0.000032,0.0000301,0.0000142,0.0000244,0.0000286,0.0000237,0.0000242,0.0000264,0.0000207,0.0000217,0.0000225,0.0000066,0.0000088,0.0000289,0.000032,0.0000372,0.0000415,0.0000331,0.0000182,0.0000144,0.0000139,0.000013,0.0000173,0.000016,0.0000141,0.000017,0.0000184,0.0000226,0.0000251,0.0000226,0.0000107,0.0000239,0.0000346,0.0000448,0.000053,0.0000546,0.000037,0.0000361,0.000042,0.0000399,0.0000519,0.0000675,0.0000718,0.0000767,0.0000792,0.0000721,0.0000783,0.000096,0.0000993,0.0001077,0.000121,0.0001192,0.0001094,0.0000952,0.0000738,0.0000393,0.0000337,0.0000414,0.0000552,0.000076,0.0000814,0.0000804,0.0000774,0.0000758,0.0000647,0.000066,0.0000702,0.0000697,0.0000841,0.0000977,0.0000977,0.0000952,0.0000885,0.0000671,0.0000468,0.0000481,0.0000463,0.0000424,0.0000438,0.0000417,0.0000286,0.000017,0.0000121,0.0000303,0.000052,0.0000589,0.0000614,0.0000662,0.0000668,0.0000524,0.0000393,0.0000323,0.0000204,0.0000265,0.0000408,0.0000476,0.0000577,0.000064,0.0000604,0.0000534,0.0000507,0.0000456,0.0000332,0.0000304,0.0000286,0.00003,0.0000391,0.0000386,0.0000307,0.000025,0.0000386,0.0000562,0.0000775,0.0000923,0.0001053,0.0001125,0.0001126,0.0000901,0.0000677,0.0000544,0.0000391],"detections":[{"range_m":2.388322,"snr_db":28.2226,"width_m":0.171607}],"noise_floor":0.000038313,"blast_amplitude":0.2700501,"saturated":false}
{"timestamp":1756162804.4666624,"source":"simulated","device_id":"batvu-reference-01","beam":[0.8754261,-0.2345697,0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000054,0,0,0,0.0000706,0.0000748,0.0000646,0.0000454,0.0000296,0,0.0000192,0.0000339,0.0000247,0.0000427,0.0000575,0.0000299,0.0000157,0.0000175,0.0000095,0.0000078,0.0000167,0.000039,0.000059,0.0000694,0.0000386,0.0000386,0.0000835,0.0000808,0.0000713,0.0000594,0.0000206,0,0.0000206,0.0000253,0.0000357,0.0000454,0.0000446,0,0.0000162,0.000021,0.0000013,0.0000079,0.0000284,0.0000289,0.000033,0.0000347,0.0000079,0.0000061,0.0000323,0.0000346,0.0000351,0.0000348,0.0000016,0,0.0000215,0.0000176,0.0000284,0.0000604,0.0000591,0.0000456,0.0000273,0.0000235,0.0000533,0.0000864,0.0000894,0.0000899,0.0001066,0.0001065,0.0000827,0.0000632,0.0000534,0.0000255,0.0000214,0.0000267,0.0000165,0.0000347,0.0000498,0.0000483,0.0000487,0.0000509,0.000037,0.0000221,0.0000315,0.0000261,0.0000175,0.0000212,0.000014,0.0000016,0.0000477,0.0000481,0.000032,0.0001372,0.0003508,0.0006721,0.0011041,0.0017026,0.0022279,0.0026961,0.0029819,0.0030407,0.0030117,0.0027789,0.0023442,0.0017141,0.0012176,0.0007816,0.0004434,0.0002139,0.0000648,0.0000297,0.0000335,0.0000158,0,0.0000035,0.0000066,0.000018,0.0000371,0.0000439,0.0000654,0.0000965,0.0001004,0.0001001,0.0000966,0.0000905,0.0000626,0.0000549,0.0000582,0.0000568,0.0000592,0.0000592,0.0000384,0.0000209,0.0000336,0.000032,0.0000276,0.0000225,0.0000063,0,0.0000195,0.0000259,0.0000329,0.0000394,0.0000354,0.0000324,0.0000459,0.000046,0.0000523,0.0000826,0.0000893,0.0000907,0.0000905,0.0000888,0.0000695,0.000061,0.0000609,0.0000386,0.0000165,0.0000139,0.0000234,0.0000372,0.0000488,0.000048,0.0000453,0.0000399,0.0000237,0.0000154,0.0000362,0.0000454,0.000055,0.0000616,0.0000564,0.0000468,0.0000619,0.0000627,0.0000613,0.0000579,0.0000503,0.0000179,0.0000175,0.0000203,0.0000164,0.0000195,0.0000226,0.0000182,0.0000371,0.0000461,0.0000451,0.0000434,0.0000511,0.0000551,0.0000606,0.000064,0.0000566,0.0000544,0.0000665,0.0000662,0.0000643,0.0000667,0.0000655,0.0000662,0.000073,0.0000715,0.0000609,0.0000595,0.0000599,0.0000419,0.0000192,0.0000225,0.0000362,0.0000435,0.0000445,0.0000317,0.0000168,0.0000077,0.0000169,0.0000414,0.0000601,0.0000613,0.0000597,0.0000529,0.0000387,0.0000206,0.0000309,0.0000385,0.000048,0.000055,0.0000533,0.0000402,0.0000294,0.0000174,0.0000091,0.0000293,0.0000332,0.0000281,0.0000144,0.0000212,0.0000293,0.0000295,0.0000268,0.0000107],"detections":[{"range_m":2.422224,"snr_db":26.5946,"width_m":0.171607}],"noise_floor":0.000035016,"blast_amplitude":0.2699404,"saturated":false}
{"timestamp":1756162804.533329,"source":"simulated","device_id":"batvu-reference-01","beam":[0.7848856,-0.4531539,0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000537,0.0000461,0.0000269,0.0000053,0.0000255,0.0000393,0.0000395,0.0000317,0.0000194,0.0000162,0.0000284,0.0000344,0.0000243,0.0000459,0.0000587,0.0000233,0.0000094,0.0000198,0.0000097,0.000007,0.0000176,0.0000201,0.0000373,0.000054,0.0000344,0.0000269,0.0000583,0.0000541,0.0000511,0.0000538,0.0000346,0.0000421,0.0000916,0.0000903,0.0000801,0.0000653,0.0000496,0.0000094,0.0000224,0.0000263,0.0000284,0.0000311,0.0000302,0.0000014,0.0000244,0.0000296,0.0000067,0.0000347,0.0000606,0.0000591,0.0000538,0.0000469,0.0000085,0,0.0000284,0.0000282,0.0000298,0.0000319,0.0000215,0,0.0000048,0.0000056,0.0000195,0.0000512,0.0000554,0.0000588,0.0000661,0.0000643,0.000043,0.0000645,0.0000705,0.0000543,0.0000291,0.0000381,0.000053,0.00006,0.0000605,0.0000349,0.0000211,0.0000379,0.0000358,0.0000381,0.0000438,0.0000347,0.000032,0.000048,0.0000459,0.0000385,0.0000393,0.0000318,0.0000286,0.0000617,0.0000687,0.0000705,0.0000719,0.0000723,0.0000466,0.0000532,0.0000548,0.0000427,0.0001954,0.0004381,0.000846,0.0012847,0.0017556,0.0022024,0.0025672,0.0027581,0.0027669,0.0026761,0.0023823,0.0018377,0.0013333,0.0008945,0.0005539,0.000305,0.0001537,0.0000753,0.0000389,0.0000435,0.0000414,0.0000322,0.0000457,0.0000489,0.0000478,0.0000756,0.0000875,0.000092,0.0000952,0.0000956,0.0000776,0.0000608,0.0000667,0.0000616,0.0000545,0.0000461,0.0000256,0.0000132,0.000019,0.0000137,0.0000062,0.0000277,0.0000337,0.0000423,0.0000518,0.0000503,0.0000352,0.0000334,0.000042,0.0000552,0.0000663,0.0000679,0.000054,0.0000467,0.0000485,0.000033,0.0000194,0.0000137,0.0000081,0.0000292,0.0000556,0.0000669,0.0000723,0.0000721,0.0000557,0.0000303,0.0000135,0.000017,0.000025,0.0000291,0.0000227,0.0000083,0.0000212,0.0000278,0.0000506,0.0000855,0.0001057,0.0001093,0.0001091,0.0001034,0.0000759,0.0000555,0.0000475,0.0000315,0.0000269,0.0000394,0.0000427,0.0000429,0.000041,0.0000253,0.0000097,0.0000205,0.0000194,0.0000225,0.0000279,0.0000238,0.000011,0.0000251,0.0000283,0.0000279,0.0000206,0.0000121,0.0000157,0.0000179,0.0000179,0.0000064,0.0000144,0.0000154,0.0000043,0.0000212,0.0000317,0.0000318,0.0000299,0.0000335,0.0000415,0.0000543,0.0000659,0.000075,0.0000901,0.0001006,0.0000983,0.0000867,0.0000745,0.0000654,0.0000542,0.0000502,0.0000458,0.0000295,0.0000213,0.0000179,0.0000121,0.0000378,0.0000497,0.0000505,0.0000479,0.0000391,0.0000139,0.000009,0.0000153,0.0000152],"detections":[{"range_m":2.579358,"snr_db":23.8892,"width_m":0.171607}],"noise_floor":0.000034386,"blast_amplitude":0.26999,"saturated":false}
{"timestamp":1756162804.5999956,"source":"simulated","device_id":"batvu-reference-01","beam":[0.6408564,-0.6408564,0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000347,0.0000438,0.0000453,0.0000442,0.0000441,0.00003,0.0000177,0.0000221,0.0000232,0,0.0000248,0.0000353,0.0000097,0.0000091,0.0000341,0.0000321,0.0000312,0.0000334,0.0000068,0.0000185,0.0000285,0.0000053,0.0000305,0.0000568,0.0000442,0.0000546,0.0000889,0.0000811,0.0000601,0.0000383,0,0.0000048,0.0000125,0.0000071,0.0000091,0.000026,0.0000297,0.0000204,0.0000523,0.0000591,0.0000568,0.0000651,0.0000686,0.0000462,0.0000375,0.0000389,0.0000108,0.0000106,0.000029,0.0000299,0.0000435,0.0000596,0.0000481,0.0000333,0.0000225,0,0.000014,0.0000402,0.0000382,0.000033,0.0000441,0.0000397,0.0000203,0.0000076,0.0000299,0.0000489,0.0000628,0.0000618,0.0000389,0.0000497,0.0000575,0.0000518,0.0000458,0.0000394,0.0000056,0.0000212,0.00004,0.0000449,0.0000522,0.000057,0.0000445,0.0000333,0.0000529,0.0000564,0.0000631,0.0000721,0.0000681,0.0000668,0.0000824,0.0000782,0.0000573,0.0000352,0.0000284,0.0000512,0.0000696,0.0000721,0.0000502,0.0000571,0.0000627,0.0000571,0.0000489,0.0000388,0.0000102,0.0000081,0.0000137,0.0000103,0.000013,0.0000139,0.0000299,0.000098,0.0002549,0.0004681,0.000799,0.0012238,0.0016632,0.0020685,0.0023614,0.0024576,0.0024431,0.0022855,0.0019796,0.001561,0.0011277,0.0007442,0.0004287,0.0002296,0.0001334,0.0000922,0.0000703,0.0000628,0.0000489,0.0000596,0.0000719,0.0000661,0.0000504,0.0000324,0.000026,0.0000464,0.0000658,0.000071,0.0000893,0.0001124,0.000115,0.0001178,0.0001209,0.0001181,0.0000977,0.0000837,0.0000721,0.000044,0.0000191,0.0000116,0.0000218,0.0000289,0.0000309,0.0000185,0.000036,0.0000482,0.0000518,0.0000611,0.0000691,0.0000655,0.0000556,0.0000436,0.0000317,0.0000431,0.0000586,0.0000583,0.0000576,0.0000615,0.0000565,0.0000424,0.0000329,0.0000312,0.00004,0.0000512,0.0000527,0.0000356,0.0000216,0.0000136,0.0000019,0.0000202,0.0000288,0.0000266,0.0000176,0.0000107,0.00002,0.0000264,0.0000292,0.0000225,0.000022,0.0000353,0.0000424,0.0000555,0.0000642,0.0000597,0.0000385,0.000032,0.0000547,0.0000743,0.0000815,0.0000796,0.0000664,0.0000654,0.000066,0.0000497,0.0000278,0.0000226,0.0000347,0.0000396,0.0000404,0.0000415,0.000065,0.0000817,0.0000815,0.0000783,0.0000772,0.0000684,0.00005,0.0000268,0.0000213,0.0000482,0.0000628,0.0000625,0.0000598,0.000057,0.0000501,0.0000298,0.0000197,0.0000188,0.000028,0.0000503,0.0000596,0.0000599,0.000056,0.0000451,0.00002,0.0000102,0.0000181,0.0000263],"detections":[{"range_m":2.756516,"snr_db":23.0926,"width_m":0.171607}],"noise_floor":0.000039018,"blast_amplitude":0.2699787,"saturated":false}
{"timestamp":1756162804.6666622,"source":"simulated","device_id":"batvu-reference-01","beam":[0.4531539,-0.7848856,0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000111,0.0000167,0.0000198,0.0000249,0.0000511,0.0000403,0.0000061,0.0000073,0.0000337,0.0000354,0.0000512,0.0000572,0.0000275,0.0000704,0.0000979,0.0000888,0.0000797,0.0000747,0.0000254,0.000021,0.0000561,0.0000551,0.0000545,0.0000521,0.0000105,0.0000058,0.00005,0.0000498,0.0000526,0.0000573,0.0000396,0.0000427,0.0000759,0.0000713,0.0000562,0.0000895,0.000097,0.0000896,0.0000844,0.0000775,0.0000321,0.0000435,0.0000544,0.0000415,0.0000236,0.0000147,0.0000354,0.000054,0.0000596,0.0000361,0.0000219,0.0000469,0.0000431,0.0000442,0.0000571,0.0000512,0.0000445,0.0000416,0.0000253,0,0.0000075,0.0000026,0,0.0000067,0.0000085,0,0.0000194,0.0000279,0.0000282,0.0000264,0.0000196,0.0000128,0.0000314,0.0000384,0.0000232,0.0000355,0.0000481,0.0000424,0.0000318,0.0000219,0.0000162,0.0000302,0.0000384,0.000029,0.0000228,0.0000364,0.0000331,0.0000155,0.0000129,0.0000232,0.0000357,0.0000526,0.0000525,0.000038,0.0000258,0.0000173,0.0000306,0.0000606,0.000069,0.0000663,0.0000623,0.0000626,0.0000462,0.0000401,0.0000446,0.0000337,0.0000212,0.0000318,0.0000323,0.000033,0.0000329,0.000015,0.000004,0.0000518,0.0001265,0.0002861,0.0005458,0.0009447,0.0013461,0.0017613,0.0020998,0.0023256,0.0023928,0.0023821,0.0022009,0.001866,0.0013617,0.0009236,0.0005626,0.0003096,0.0001341,0.0000294,0.0000541,0.0000539,0.0000408,0.0000143,0.0000372,0.0000561,0.0000663,0.0000635,0.0000808,0.0001047,0.000106,0.0001059,0.0001037,0.0000945,0.0000628,0.0000385,0.0000327,0.0000291,0.0000272,0.0000223,0.000006,0.0000262,0.0000392,0.0000407,0.0000423,0.0000432,0.0000304,0.0000285,0.0000425,0.0000434,0.0000428,0.0000383,0.0000288,0.000032,0.0000374,0.0000334,0.0000328,0.0000465,0.0000453,0.0000399,0.000043,0.0000415,0.000029,0.0000155,0.0000175,0.0000322,0.0000454,0.0000478,0.0000416,0.0000365,0.0000341,0.0000236,0.0000224,0.0000233,0.0000139,0.0000234,0.0000319,0.0000303,0.0000311,0.0000359,0.0000303,0.0000266,0.0000369,0.0000399,0.0000493,0.0000625,0.0000625,0.000063,0.0000685,0.0000664,0.0000485,0.0000292,0.0000181,0.0000111,0.0000102,0.0000072,0,0.0000082,0.0000134,0.0000108,0.0000064,0.0000203,0.0000234,0.0000236,0.000022,0.0000101,0.0000029,0.0000181,0.0000189,0.000018,0.0000101,0.0000125,0.0000225,0.0000292,0.0000279,0.0000239,0.0000368,0.0000368,0.000034,0.0000321,0.0000319,0.000021,0.0000341,0.0000458,0.0000464,0.0000446,0.0000366,0.0000191],"detections":[{"range_m":2.846889,"snr_db":22.8317,"width_m":0.171607}],"noise_floor":0.000035156,"blast_amplitude":0.2700525,"saturated":false}
{"timestamp":1756162804.7333288,"source":"simulated","device_id":"batvu-reference-01","beam":[0.2345697,-0.8754261,0.4226183],"start_range_m":0.3,"range_step_m":0.018359375,"profile":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0.0000149,0.0000193,0.0000283,0.0000325,0.0000343,0.0000092,0.0000347,0.0000403,9e-7,0.0000555,0.0000936,0.0000941,0.0000929,0.0000868,0.0000184,0.0000071,0.0000419,0.0000348,0.0000592,0.0000892,0.0000811,0.0000824,0.0000964,0.0000786,0.000045,0.0000709,0.0000682,0.0000653,0.0000577,0.000028,0.0000097,0.0000385,0.0000416,0.0000163,0.0000457,0.0000496,0.0000203,0.000019,0.0000549,0.0000628,0.0000629,0.0000594,0.0000136,0,0.000016,0.0000085,0,0.0000088,0.000008,0.0000087,0.0000311,0.0000357,0.0000414,0.000045,0.0000343,0.000007,0.0000307,0.0000284,0.0000173,0.000019,0.0000201,0.0000167,0.0000446,0.0000521,0.0000586,0.0000658,0.0000673,0.000044,0.0000587,0.0000745,0.0000688,0.0000582,0.0000458,0.0000106,0.0000086,0.00003,0.0000282,0.0000202,0.0000157,0.0000237,0.0000411,0.0000584,0.0000564,0.0000733,0.000115,0.000116,0.000113,0.0001009,0.0000793,0.0000368,0.0000332,0.0000359,0.0000261,0.0000527,0.0000621,0.0000608,0.0000565,0.0000572,0.0000428,0.0000258,0.0000136,0.0000049,0.0000129,0.0000187,0.0000273,0.000107,0.0003059,0.0005509,0.0008874,0.0012892,0.0016919,0.0020647,0.0023346,0.0024101,0.002384,0.0021933,0.0018542,0.0014213,0.0010049,0.0006625,0.0003875,0.0002018,0.0000786,0.0000178,0.000016,0.0000179,0.0000042,0,0.0000041,0.0000101,0.0000394,0.0000671,0.0000693,0.0000666,0.0000527,0.0000275,0.000026,0.0000404,0.0000398,0.0000385,0.0000366,0.000024,0.0000137,0.0000462,0.0000507,0.0000574,0.0000675,0.0000693,0.000058,0.000061,0.0000672,0.0000638,0.0000716,0.0000777,0.0000755,0.0000734,0.0000712,0.0000555,0.0000327,0.0000157,0,0,0.0000053,0.0000024,0.0000136,0.0000527,0.0000711,0.0000846,0.0000894,0.0000864,0.0000653,0.0000589,0.0000607,0.0000513,0.0000478,0.0000496,0.0000587,0.0000742,0.0000795,0.0000721,0.0000577,0.0000462,0.0000355,0.0000304,0.000028,0.000015,0,0.00001,0.0000111,0.0000133,0.0000146,0.0000088,0.00001,0.0000308,0.0000373,0.0000531,0.0000761,0.0000833,0.000087,0.0000889,0.0000892,0.0000764,0.0000757,0.0000769,0.0000708,0.0000848,0.0000925,0.0000903,0.0000796,0.0000658,0.0000613,0.0000771,0.0000873,0.000089,0.0000979,0.0001064,0.0001034,0.0000872,0.0000578,0.0000244,0.0000167,0.0000392,0.0000437,0.0000471,0.0000536,0.0000528,0.0000537,0.0000633,0.0000654,0.0000612,0.0000597,0.0000604,0.0000472,0.0000351,0.0000333,0.0000406],"detections":[{"range_m":2.754237,"snr_db":26.402,"width_m":0.171607}],"noise_floor":0.000041085,"blast_amplitude":0.2699899,"saturated":false}

View File

@@ -0,0 +1,260 @@
//! ADR-262 P4 gates for the second modality.
//!
//! Same shape as `p1_gates.rs`: round-trip, fusability, privacy-safety,
//! determinism. Not accuracy — nothing here claims an ultrasonic scan is
//! *right*, only that it is well-formed, signed, correctly classified, and that
//! the things it must refuse to do, it refuses.
//!
//! The fixture is not hand-written. `batvu_living_room.ultrasonic.jsonl` is
//! produced by BatVu's own `npm run artifacts` — a 72-ping simulated sweep,
//! written by its TypeScript emitter — and copied here verbatim. The same file
//! is a test fixture in `ruvnet/rufield`, so a schema drift between BatVu's
//! emitter and RuField's parser fails a build in one of three repositories
//! rather than an ingest in a deployment.
use rufield_core::{FieldEvent, FusionEngine, InferenceQuery, Modality, PrivacyClass};
use rufield_fusion::RuFieldFusion;
use rufield_provenance::{is_fusable, verify_event};
use wifi_densepose_rufield::{
network_egress_allowed, ScanSource, UltrasonicScan, ULTRASONIC_EGRESS_CLASS,
};
const SCAN: &str = include_str!("fixtures/batvu_living_room.ultrasonic.jsonl");
fn scan() -> UltrasonicScan {
UltrasonicScan::load(SCAN, "living_room", ScanSource::Simulated).expect("fixture loads")
}
// ── round-trip ───────────────────────────────────────────────────────────────
#[test]
fn gate_round_trip_every_event_is_well_formed_and_serializes() {
let mut s = scan();
assert_eq!(s.ping_count(), 72);
assert_eq!(s.device_id(), "batvu-reference-01");
assert!(!s.calibration_id().is_empty());
let events = s.events().expect("events");
assert_eq!(events.len(), 72);
let mut previous = 0u64;
for event in &events {
event
.validate_evidence_at(event.timestamp_ns)
.expect("structural evidence invariants hold");
assert_eq!(event.tensor.modality, Modality::Ultrasonic);
assert_eq!(event.sensor.vendor, "batvu");
assert_eq!(event.observation.zone_id.as_deref(), Some("living_room"));
// Every profile value finite and non-negative. `FieldTensor::validate`
// checks only shape and axis rank, so a NaN would serialize to JSON
// `null` and then fail to deserialize as an f32 on the far side of the
// wire — the worst place to find it. The adapter rejects it at parse.
assert!(
event
.tensor
.values
.iter()
.all(|v| v.is_finite() && *v >= 0.0),
"profile values are finite and non-negative"
);
// Strictly increasing, which RuField's replay watermark requires in
// every trust mode and silently drops what does not satisfy.
assert!(event.timestamp_ns > previous);
previous = event.timestamp_ns;
// serde round-trip, byte-stable.
let json = serde_json::to_string(event).expect("serializes");
let back: FieldEvent = serde_json::from_str(&json).expect("deserializes");
assert_eq!(*event, back);
}
let mut ids: Vec<&str> = events.iter().map(|e| e.event_id.as_str()).collect();
ids.sort_unstable();
ids.dedup();
assert_eq!(ids.len(), events.len(), "event ids are unique");
}
// ── fusability ───────────────────────────────────────────────────────────────
#[test]
fn gate_every_event_carries_a_signature_that_verifies() {
let mut s = scan();
let events = s.events().expect("events");
for event in &events {
verify_event(event).expect("ed25519 signature verifies");
assert!(is_fusable(event));
}
// And tampering breaks it, so the signature is load-bearing rather than
// decorative.
let mut tampered = events[0].clone();
tampered.tensor.values[0] = 999.0;
assert!(verify_event(&tampered).is_err());
}
#[test]
fn gate_fusion_ingests_every_event() {
let mut s = scan();
let mut engine = RuFieldFusion::new();
for event in s.events().expect("events") {
engine.ingest(event).expect("fusion accepts the event");
}
}
// ── privacy safety — the correctness item ────────────────────────────────────
#[test]
fn gate_coarse_scan_passes_the_egress_gate_intact() {
// The claim the module makes: configuring the adapter for the coarse output
// means the egress gate has nothing left to catch. If a submodule bump ever
// changes the adapter's default class, this is where it surfaces.
let mut s = scan();
let all = s.events().expect("events").len();
let mut s = scan();
let egress = s.egress_events().expect("egress events").len();
assert_eq!(all, 72);
assert_eq!(
egress, all,
"no event is dropped at the gate in coarse mode"
);
}
#[test]
fn gate_every_event_is_p1_on_both_tensor_and_observation() {
let mut s = scan();
for event in s.events().expect("events") {
assert_eq!(event.tensor.privacy_class, ULTRASONIC_EGRESS_CLASS);
assert_eq!(event.observation.privacy_class, ULTRASONIC_EGRESS_CLASS);
// Both, because the guard is conjunctive over the pair — a P0 tensor
// under a P1 observation is exactly the composite leak the default
// guard exists to close.
assert!(network_egress_allowed(event.tensor.privacy_class, false));
assert!(network_egress_allowed(
event.observation.privacy_class,
false
));
}
assert_eq!(ULTRASONIC_EGRESS_CLASS, PrivacyClass::P1);
}
#[test]
fn gate_ultrasonic_can_never_reach_the_identity_tiers() {
// P5 is only reachable through `identity_evidence`, which
// `validate_evidence_at` restricts to BLE advertisement RSSI — so an
// ultrasonic event carrying it is a hard validation failure rather than a
// policy question. The ceiling is structural.
let mut s = scan();
for event in s.events().expect("events") {
assert!(event.tensor.privacy_class < PrivacyClass::P4);
assert!(event.observation.privacy_class < PrivacyClass::P4);
assert!(event.observation.identity_evidence.is_none());
assert!(event.observation.channel_sounding_provenance.is_none());
}
}
#[test]
fn gate_no_event_claims_a_person() {
// The tempting mistake, refused deliberately. `presence` is one of exactly
// six feature keys the fusion window reads, and populating it would light
// up the shipped `person_present` rule. One transducer pair cannot
// distinguish a person from a coat over the back of a chair.
let mut s = scan();
for event in s.events().expect("events") {
for forbidden in ["presence", "breathing_band", "posture_height", "transient"] {
assert!(
!event.observation.features.contains_key(forbidden),
"an ultrasonic event must not claim `{forbidden}`"
);
}
for label in &event.observation.labels {
assert!(
!label.contains("person") && !label.contains("presence"),
"unexpected personhood label: {label}"
);
}
}
}
/// The honest negative result, asserted rather than avoided.
///
/// Because nothing claims presence, a BatVu scan produces no fused inferences
/// under the shipped rules. Two independent reasons, and pinning both matters
/// because fixing only the first would look like progress and change nothing:
/// no rule lists `"ultrasonic"` among its inputs, and the engine's feature
/// vocabulary is entirely statements about a body, so `range_m` has nothing to
/// drive. RuField v0.1 has no predicate for static geometry.
#[test]
fn gate_no_inferences_and_that_is_the_correct_outcome() {
let mut s = scan();
let mut engine = RuFieldFusion::new();
for event in s.events().expect("events") {
engine.ingest(event).expect("ingest");
}
let inferences = engine
.infer(&InferenceQuery {
zone_id: Some("living_room".into()),
labels: vec![],
track_id: None,
as_of_ns: None,
})
.expect("infer");
assert!(
inferences.is_empty(),
"no shipped rule can fire on a range-only sensor: {inferences:?}"
);
}
// ── trust tier ───────────────────────────────────────────────────────────────
#[test]
fn gate_a_recording_cannot_relabel_itself_into_a_higher_trust_tier() {
// The fixture declares `simulated`. An operator pointing a capture-trusting
// deployment at it gets a hard refusal rather than a silently upgraded
// tier — and the reverse is refused too, so neither direction is a quiet
// reinterpretation.
let err = UltrasonicScan::load(SCAN, "living_room", ScanSource::DeviceCapture)
.expect_err("must refuse");
assert!(
err.to_string().contains("device_capture"),
"the refusal names the mismatch: {err}"
);
}
#[test]
fn gate_simulated_recordings_are_marked_synthetic() {
// Not cosmetic: `synthetic: true` is what keeps simulator output out of
// captured-replay and production trust, which reject it before any key
// lookup. Marking it otherwise to get it accepted is the §11 invariant
// violation ADR-262 forbids.
let mut s = scan();
for event in s.events().expect("events") {
assert!(event.provenance.synthetic);
}
}
// ── determinism ──────────────────────────────────────────────────────────────
#[test]
fn gate_same_recording_yields_a_byte_identical_event_stream() {
let mut a = scan();
let mut b = scan();
let left = serde_json::to_string(&a.events().expect("events")).expect("serializes");
let right = serde_json::to_string(&b.events().expect("events")).expect("serializes");
assert_eq!(left, right);
}
#[test]
fn gate_a_malformed_recording_is_refused_whole() {
// No partial ingest. A stream that half-replays and then dies is the worst
// outcome for a consumer, because it has already acted on the good prefix.
let mut bad = SCAN.lines().take(4).collect::<Vec<_>>().join("\n");
bad.push_str("\n{\"timestamp\":1756162800,\"source\":\"simulated\",\"device_id\":\"x\"}\n");
let err =
UltrasonicScan::load(&bad, "living_room", ScanSource::Simulated).expect_err("must refuse");
assert!(err.to_string().contains("rejected"));
}

View File

@@ -26,6 +26,7 @@ tower-http = { version = "0.6", features = ["fs", "cors", "set-header"] }
tokio = { workspace = true, features = ["full", "process"] }
futures-util = "0.3"
ruvector-mincut = { workspace = true }
mdns-sd = "0.11"
# Serialization
serde = { workspace = true }

View File

@@ -9,6 +9,17 @@ use crate::adaptive_classifier;
use crate::types::*;
use crate::vital_signs::VitalSigns;
const EDGE_MAX_PERSONS: u8 = 4;
/// Person count is supporting evidence, never an independent occupancy claim.
/// Return zero and mark invalid for contradictory or out-of-range firmware.
fn sanitize_edge_person_count(presence: bool, raw: u8) -> (u8, bool) {
if raw > EDGE_MAX_PERSONS || (!presence && raw != 0) {
return (0, false);
}
(raw, true)
}
// ── ESP32 UDP frame parsers ─────────────────────────────────────────────────
/// Parse a 32-byte edge vitals packet (magic 0xC511_0002).
@@ -26,26 +37,63 @@ pub fn parse_esp32_vitals(buf: &[u8]) -> Option<Esp32VitalsPacket> {
let breathing_raw = u16::from_le_bytes([buf[6], buf[7]]);
let heartrate_raw = u32::from_le_bytes([buf[8], buf[9], buf[10], buf[11]]);
let rssi = buf[12] as i8;
let n_persons = buf[13];
let presence = (flags & 0x01) != 0;
let (n_persons, person_count_valid) = sanitize_edge_person_count(presence, buf[13]);
let motion_energy = f32::from_le_bytes([buf[16], buf[17], buf[18], buf[19]]);
let presence_score = f32::from_le_bytes([buf[20], buf[21], buf[22], buf[23]]);
let timestamp_ms = u32::from_le_bytes([buf[24], buf[25], buf[26], buf[27]]);
Some(Esp32VitalsPacket {
node_id,
presence: (flags & 0x01) != 0,
presence,
fall_detected: (flags & 0x02) != 0,
motion: (flags & 0x04) != 0,
breathing_rate_bpm: breathing_raw as f64 / 100.0,
heartrate_bpm: heartrate_raw as f64 / 10000.0,
rssi,
n_persons,
person_count_valid,
motion_energy,
presence_score,
timestamp_ms,
})
}
#[cfg(test)]
mod edge_vitals_integrity_tests {
use super::*;
fn packet(presence: bool, n_persons: u8) -> Vec<u8> {
let mut buf = vec![0u8; 32];
buf[0..4].copy_from_slice(&0xC511_0002u32.to_le_bytes());
buf[4] = 4;
buf[5] = u8::from(presence);
buf[13] = n_persons;
buf
}
#[test]
fn contradictory_count_fails_closed() {
let parsed = parse_esp32_vitals(&packet(false, 4)).expect("valid packet");
assert_eq!(parsed.n_persons, 0);
assert!(!parsed.person_count_valid);
}
#[test]
fn bounded_present_count_is_preserved() {
let parsed = parse_esp32_vitals(&packet(true, 3)).expect("valid packet");
assert_eq!(parsed.n_persons, 3);
assert!(parsed.person_count_valid);
}
#[test]
fn out_of_range_count_fails_closed() {
let parsed = parse_esp32_vitals(&packet(true, 5)).expect("valid packet");
assert_eq!(parsed.n_persons, 0);
assert!(!parsed.person_count_valid);
}
}
/// Parse a WASM output packet (magic 0xC511_0007 — reassigned per issue #928;
/// the original 0xC511_0004 collided with ADR-063 fused vitals).
pub fn parse_wasm_output(buf: &[u8]) -> Option<WasmOutputPacket> {

View File

@@ -0,0 +1,125 @@
//! Local DNS-SD advertisement for RuView installation discovery.
//!
//! The TXT record deliberately contains no SSID, node identifiers, room data,
//! sensor values, credentials, or personal data. Mobile clients treat the
//! installation id as a routing hint only and still health-check the service.
use std::collections::HashMap;
use mdns_sd::{ServiceDaemon, ServiceInfo};
pub const SERVICE_TYPE: &str = "_ruview._tcp.local.";
pub const SCHEMA: &str = "ruview.installation.v1";
pub struct DiscoveryAdvertiser {
daemon: ServiceDaemon,
fullname: String,
}
impl Drop for DiscoveryAdvertiser {
fn drop(&mut self) {
let _ = self.daemon.unregister(&self.fullname);
let _ = self.daemon.shutdown();
}
}
/// Reduce an operator/host label to a deterministic RFC 6762-safe hostname.
pub fn discovery_hostname(raw: &str) -> String {
let mut label = String::with_capacity(48);
for character in raw.chars().flat_map(char::to_lowercase) {
if character.is_ascii_alphanumeric() {
label.push(character);
} else if (character == '-' || character == '_' || character == ' ')
&& !label.ends_with('-')
{
label.push('-');
}
if label.len() >= 40 {
break;
}
}
let label = label.trim_matches('-');
let safe = if label.is_empty() {
"installation"
} else {
label
};
format!("ruview-{safe}.local.")
}
pub fn build_service(
instance_name: &str,
installation_id: &str,
hostname: &str,
http_port: u16,
tls: bool,
) -> Result<ServiceInfo, mdns_sd::Error> {
let mut properties = HashMap::with_capacity(3);
properties.insert("schema".to_string(), SCHEMA.to_string());
properties.insert("tls".to_string(), if tls { "1" } else { "0" }.to_string());
properties.insert(
"installation".to_string(),
installation_id.chars().take(128).collect(),
);
ServiceInfo::new(
SERVICE_TYPE,
&instance_name.chars().take(96).collect::<String>(),
hostname,
(),
http_port,
Some(properties),
)
.map(ServiceInfo::enable_addr_auto)
}
/// Register a live local advertisement. Failure is recoverable: the sensing
/// server remains available through its explicitly configured origin.
pub fn start_advertiser(
instance_name: &str,
installation_id: &str,
hostname: &str,
http_port: u16,
) -> Result<DiscoveryAdvertiser, mdns_sd::Error> {
let daemon = ServiceDaemon::new()?;
let service = build_service(instance_name, installation_id, hostname, http_port, false)?;
let fullname = service.get_fullname().to_owned();
daemon.register(service)?;
Ok(DiscoveryAdvertiser { daemon, fullname })
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn advertisement_matches_mobile_contract_without_sensor_metadata() {
let service = build_service(
"RuView Living Room",
"home-a",
"ruview-home-a.local.",
3000,
false,
)
.unwrap();
assert_eq!(service.get_type(), SERVICE_TYPE);
assert_eq!(service.get_port(), 3000);
assert!(service.is_addr_auto());
assert_eq!(service.get_property_val_str("schema"), Some(SCHEMA));
assert_eq!(service.get_property_val_str("tls"), Some("0"));
assert_eq!(service.get_property_val_str("installation"), Some("home-a"));
for forbidden in ["ssid", "node", "room", "csi", "pose", "token"] {
assert!(service.get_property(forbidden).is_none());
}
}
#[test]
fn hostname_is_bounded_and_safe() {
assert_eq!(
discovery_hostname("Cohen's Mac Mini"),
"ruview-cohens-mac-mini.local."
);
let value = discovery_hostname("🚫 ///");
assert_eq!(value, "ruview-installation.local.");
assert!(discovery_hostname(&"A".repeat(200)).len() <= 54);
}
}

View File

@@ -41,7 +41,7 @@ use wifi_densepose_signal::ruvsense::fusion_quality::CalibrationId;
use wifi_densepose_signal::ruvsense::multistatic::MultistaticConfig;
use wifi_densepose_worldgraph::WorldId;
use super::multistatic_bridge::node_frames_from_states;
use super::multistatic_bridge::node_frames_from_states_with_guard;
use super::NodeState;
/// Minimum spacing between engine-error warn logs (errors are still counted
@@ -53,6 +53,8 @@ const ENGINE_ERROR_WARN_INTERVAL: Duration = Duration::from_secs(10);
/// live sensing loop publishes beliefs into.
pub struct EngineBridge {
engine: StreamingEngine,
/// Hard timestamp guard shared by cohort selection and engine validation.
guard_interval_us: u64,
room: WorldId,
/// Nodes already wired into the WorldGraph as sensors (by `node_id`).
registered_nodes: HashMap<u8, WorldId>,
@@ -94,6 +96,11 @@ impl EngineBridge {
room_name: &str,
multistatic_cfg: Option<MultistaticConfig>,
) -> Self {
let guard_interval_us = multistatic_cfg
.as_ref()
.map_or_else(|| MultistaticConfig::default().guard_interval_us, |cfg| {
cfg.guard_interval_us
});
let mut engine = StreamingEngine::new(mode, model_version, GeoRegistration::default());
if let Some(cfg) = multistatic_cfg {
engine.set_multistatic_config(cfg);
@@ -101,6 +108,7 @@ impl EngineBridge {
let room = engine.add_room(room_area_id, room_name);
Self {
engine,
guard_interval_us,
room,
registered_nodes: HashMap::new(),
calibration: CalibrationId(0x5256_0001), // "RV\0\x01" — placeholder epoch
@@ -165,7 +173,8 @@ impl EngineBridge {
node_states: &HashMap<u8, NodeState>,
now_ms: i64,
) -> Option<Result<TrustedOutput, EngineError>> {
let frames = node_frames_from_states(node_states);
let frames =
node_frames_from_states_with_guard(node_states, self.guard_interval_us);
if frames.is_empty() {
return None;
}
@@ -195,7 +204,15 @@ impl EngineBridge {
node_states: &HashMap<u8, NodeState>,
now_ms: i64,
) -> Option<TrustedOutput> {
match self.process_cycle_from_states(node_states, now_ms)? {
let result = self.process_cycle_from_states(node_states, now_ms)?;
self.record_cycle_result(result)
}
fn record_cycle_result(
&mut self,
result: Result<TrustedOutput, EngineError>,
) -> Option<TrustedOutput> {
match result {
Ok(trust) => {
self.last_witness = Some(trust.witness);
self.recalibration_recommended = trust.recalibration_recommended;
@@ -419,45 +436,29 @@ mod tests {
assert!(!bridge.suppress_raw_outputs());
}
/// Error wiring (review finding 1a): a live cycle that fails fusion yields
/// an `EngineError` — previously dropped by `if let Some(Ok(..))` at the
/// call sites. The counter must increment and the last good trust state
/// must survive a later failure.
///
/// Originally this forced the failure with a 56-vs-30 subcarrier mismatch
/// (`DimensionMismatch`). Since #1170 the live bridge canonicalizes every
/// node onto the 56-tone grid, so heterogeneous counts now fuse cleanly —
/// a frame-timestamp spread wider than the fuser's 60 ms guard interval is
/// the remaining deterministic way to provoke a fusion error here.
/// Error-result accounting is independent from live cohort selection, so
/// a future engine error remains auditable without deliberately forwarding
/// temporally incoherent frames through the production bridge.
#[test]
fn observe_cycle_counts_engine_errors() {
// Both nodes are 56-subcarrier (canonicalization-clean), but their
// frame timestamps are 500 ms apart — far beyond the 60 ms guard —
// so the fuser rejects the cycle with TimestampMismatch. Future
// offsets keep both instants safely after the bridge's lazy EPOCH.
fn mismatched_states() -> HashMap<u8, NodeState> {
let now = Instant::now();
let mut a = node_state_with_history(1.0, 56);
a.last_frame_time = Some(now + std::time::Duration::from_millis(600));
let mut b = node_state_with_history(1.05, 56);
b.last_frame_time = Some(now + std::time::Duration::from_millis(100));
let mut m = HashMap::new();
m.insert(0u8, a);
m.insert(1u8, b);
m
}
let mut bridge = EngineBridge::new(PrivacyMode::PrivateHome, 1, "r", "R", None);
let mismatched = mismatched_states();
let error = || {
EngineError::Fusion(
wifi_densepose_signal::ruvsense::multistatic::MultistaticError::TimestampMismatch {
spread_us: 500_000,
guard_us: 60_000,
},
)
};
assert!(bridge.observe_cycle(&mismatched, 1_000).is_none());
assert!(bridge.record_cycle_result(Err(error())).is_none());
assert_eq!(bridge.engine_error_count(), 1);
assert!(
bridge.last_trust_witness().is_none(),
"no witness from a failed cycle"
);
assert!(bridge.observe_cycle(&mismatched, 2_000).is_none());
assert!(bridge.record_cycle_result(Err(error())).is_none());
assert_eq!(bridge.engine_error_count(), 2);
// A later good cycle records trust state; the audit count is kept.
@@ -467,11 +468,39 @@ mod tests {
assert_eq!(bridge.engine_error_count(), 2);
// And a subsequent failure keeps the last good witness readable.
assert!(bridge.observe_cycle(&mismatched, 4_000).is_none());
assert!(bridge.record_cycle_result(Err(error())).is_none());
assert_eq!(bridge.engine_error_count(), 3);
assert!(bridge.last_trust_witness().is_some());
}
#[test]
fn governed_cycles_prune_slow_mixed_width_nodes_without_errors() {
let mut bridge = EngineBridge::new(PrivacyMode::PrivateHome, 1, "r", "R", None);
for tick in 0..50_i64 {
let now = Instant::now();
let mut states = HashMap::new();
for (node_id, age_ms, n_sub) in [
(1, 0, 64),
(3, 10, 256),
(4, 50, 64),
(7, 1_000, 256),
] {
let mut node = node_state_with_history(1.0 + node_id as f64 * 0.01, n_sub);
node.last_frame_time = Some(now - Duration::from_millis(age_ms));
states.insert(node_id, node);
}
assert!(
bridge.observe_cycle(&states, 1_000 + tick * 50).is_some(),
"governed cycle {tick}"
);
}
assert_eq!(bridge.engine_error_count(), 0);
assert!(bridge.last_trust_witness().is_some());
}
/// ADR-141 mapping (review finding 1c): a cycle emitted at class
/// Restricted flips `suppress_raw_outputs`, which `main.rs` uses to strip
/// per-node raw amplitude vectors from the live publish — the same field

View File

@@ -13,6 +13,7 @@ pub mod browser_session;
pub mod ws_ticket;
pub mod cli;
pub mod dataset;
pub mod discovery;
pub mod edge_registry;
pub mod error_response;
pub mod host_validation;

View File

@@ -133,6 +133,23 @@ struct Args {
#[arg(long, default_value = "127.0.0.1", env = "SENSING_BIND_ADDR")]
bind_addr: String,
/// Disable local `_ruview._tcp` discovery. Discovery is automatically
/// skipped for loopback-only binds and never carries sensor data.
#[arg(long, env = "RUVIEW_NO_MDNS")]
no_mdns: bool,
/// Stable, non-secret installation routing hint published over mDNS.
#[arg(long, env = "RUVIEW_INSTALLATION_ID")]
installation_id: Option<String>,
/// Human-readable local service name shown by commissioning clients.
#[arg(
long,
default_value = "RuView Installation",
env = "RUVIEW_INSTALLATION_NAME"
)]
installation_name: String,
/// Additional hostname (with or without `:PORT`) to permit in the `Host`
/// header — defends loopback-bound deployments against DNS rebinding.
/// Loopback names (`localhost`, `127.0.0.1`, `[::1]`) are always permitted
@@ -1696,11 +1713,21 @@ struct Esp32VitalsPacket {
heartrate_bpm: f64,
rssi: i8,
n_persons: u8,
person_count_valid: bool,
motion_energy: f32,
presence_score: f32,
timestamp_ms: u32,
}
const EDGE_MAX_PERSONS: u8 = 4;
fn sanitize_edge_person_count(presence: bool, raw: u8) -> (u8, bool) {
if raw > EDGE_MAX_PERSONS || (!presence && raw != 0) {
return (0, false);
}
(raw, true)
}
/// Parse a 32-byte edge vitals packet (magic 0xC511_0002).
fn parse_esp32_vitals(buf: &[u8]) -> Option<Esp32VitalsPacket> {
if buf.len() < 32 {
@@ -1716,26 +1743,56 @@ fn parse_esp32_vitals(buf: &[u8]) -> Option<Esp32VitalsPacket> {
let breathing_raw = u16::from_le_bytes([buf[6], buf[7]]);
let heartrate_raw = u32::from_le_bytes([buf[8], buf[9], buf[10], buf[11]]);
let rssi = buf[12] as i8;
let n_persons = buf[13];
let presence = (flags & 0x01) != 0;
let (n_persons, person_count_valid) = sanitize_edge_person_count(presence, buf[13]);
let motion_energy = f32::from_le_bytes([buf[16], buf[17], buf[18], buf[19]]);
let presence_score = f32::from_le_bytes([buf[20], buf[21], buf[22], buf[23]]);
let timestamp_ms = u32::from_le_bytes([buf[24], buf[25], buf[26], buf[27]]);
Some(Esp32VitalsPacket {
node_id,
presence: (flags & 0x01) != 0,
presence,
fall_detected: (flags & 0x02) != 0,
motion: (flags & 0x04) != 0,
breathing_rate_bpm: breathing_raw as f64 / 100.0,
heartrate_bpm: heartrate_raw as f64 / 10000.0,
rssi,
n_persons,
person_count_valid,
motion_energy,
presence_score,
timestamp_ms,
})
}
#[cfg(test)]
mod edge_vitals_integrity_tests {
use super::*;
fn packet(presence: bool, n_persons: u8) -> Vec<u8> {
let mut buf = vec![0u8; 32];
buf[0..4].copy_from_slice(&0xC511_0002u32.to_le_bytes());
buf[4] = 4;
buf[5] = u8::from(presence);
buf[13] = n_persons;
buf
}
#[test]
fn contradictory_count_fails_closed() {
let parsed = parse_esp32_vitals(&packet(false, 4)).expect("valid packet");
assert_eq!(parsed.n_persons, 0);
assert!(!parsed.person_count_valid);
}
#[test]
fn present_count_is_preserved() {
let parsed = parse_esp32_vitals(&packet(true, 3)).expect("valid packet");
assert_eq!(parsed.n_persons, 3);
assert!(parsed.person_count_valid);
}
}
// ── ADR-040: WASM Output Packet (magic 0xC511_0007 — reassigned per #928) ─────
/// Single WASM event (type + value).
@@ -1812,6 +1869,7 @@ struct EdgeFusedVitalsPacket {
heartrate_bpm: f32,
rssi: i8,
n_persons: u8,
person_count_valid: bool,
/// `mmwave_type_t` enum value from firmware.
mmwave_type: u8,
/// 0-100 fusion quality score.
@@ -1846,7 +1904,8 @@ fn parse_edge_fused_vitals(buf: &[u8]) -> Option<EdgeFusedVitalsPacket> {
let breathing_raw = u16::from_le_bytes([buf[6], buf[7]]);
let heartrate_raw = u32::from_le_bytes([buf[8], buf[9], buf[10], buf[11]]);
let rssi = buf[12] as i8;
let n_persons = buf[13];
let any_presence = (flags & 0x09) != 0;
let (n_persons, person_count_valid) = sanitize_edge_person_count(any_presence, buf[13]);
let mmwave_type = buf[14];
let fusion_confidence = buf[15];
let motion_energy = f32::from_le_bytes([buf[16], buf[17], buf[18], buf[19]]);
@@ -1866,6 +1925,7 @@ fn parse_edge_fused_vitals(buf: &[u8]) -> Option<EdgeFusedVitalsPacket> {
heartrate_bpm: heartrate_raw as f32 / 10000.0,
rssi,
n_persons,
person_count_valid,
mmwave_type,
fusion_confidence,
motion_energy,
@@ -1922,6 +1982,7 @@ mod issue_928_magic_collision_tests {
assert!((pkt.heartrate_bpm - 72.0).abs() < 1e-3, "heartrate scale 10000");
assert_eq!(pkt.rssi, -55);
assert_eq!(pkt.n_persons, 1);
assert!(pkt.person_count_valid);
assert_eq!(pkt.mmwave_type, 2);
assert_eq!(pkt.fusion_confidence, 85);
assert!((pkt.motion_energy - 0.42).abs() < 1e-6);
@@ -6177,6 +6238,9 @@ async fn nodes_endpoint(State(state): State<SharedState>) -> Json<serde_json::Va
"rssi_dbm": rssi,
"motion_level": &ns.current_motion_level,
"person_count": ns.prev_person_count,
"person_count_valid": ns.edge_vitals
.as_ref()
.map(|vitals| vitals.person_count_valid),
})
})
.collect();
@@ -6336,6 +6400,7 @@ async fn udp_receiver_task(
"breathing_rate_bpm": vitals.breathing_rate_bpm,
"heartrate_bpm": vitals.heartrate_bpm,
"n_persons": vitals.n_persons,
"person_count_valid": vitals.person_count_valid,
"motion_energy": vitals.motion_energy,
"presence_score": vitals.presence_score,
"rssi": vitals.rssi,
@@ -6635,6 +6700,7 @@ async fn udp_receiver_task(
"breathing_rate_bpm": fused.breathing_rate_bpm,
"heartrate_bpm": fused.heartrate_bpm,
"n_persons": fused.n_persons,
"person_count_valid": fused.person_count_valid,
"fusion_confidence": fused.fusion_confidence,
"mmwave": {
"hr_bpm": fused.mmwave_hr_bpm,
@@ -8762,9 +8828,15 @@ async fn main() {
);
wifi_densepose_sensing_server::host_validation::HostAllowlist::disabled()
} else {
let discovery_label = args.installation_id.as_deref().unwrap_or("installation");
let discovery_host =
wifi_densepose_sensing_server::discovery::discovery_hostname(discovery_label);
let allowlist =
wifi_densepose_sensing_server::host_validation::HostAllowlist::from_cli_and_env(
args.allowed_hosts.iter().cloned(),
args.allowed_hosts
.iter()
.cloned()
.chain(std::iter::once(discovery_host)),
);
info!(
"Host-header validation ON ({} entries; loopback names always included)",
@@ -8978,6 +9050,32 @@ async fn main() {
args.http_port
);
let discovery_label = args.installation_id.as_deref().unwrap_or("installation");
let discovery_hostname =
wifi_densepose_sensing_server::discovery::discovery_hostname(discovery_label);
let _discovery_advertiser = if args.no_mdns || bind_ip.is_loopback() {
if bind_ip.is_loopback() && !args.no_mdns {
info!("RuView discovery skipped for loopback-only HTTP bind");
}
None
} else {
match wifi_densepose_sensing_server::discovery::start_advertiser(
&args.installation_name,
discovery_label,
&discovery_hostname,
args.http_port,
) {
Ok(advertiser) => {
info!(hostname = %discovery_hostname, port = args.http_port, "RuView local discovery advertised");
Some(advertiser)
}
Err(error) => {
warn!(%error, "RuView local discovery unavailable; manual origin remains usable");
None
}
}
};
// Run the HTTP server with graceful shutdown support
let shutdown_state = state.clone();
let server = axum::serve(http_listener, http_app).with_graceful_shutdown(async {

View File

@@ -12,7 +12,9 @@ use std::time::{Duration, Instant};
use wifi_densepose_signal::hardware_norm::{CanonicalCsiFrame, HardwareNormalizer, HardwareType};
use wifi_densepose_signal::ruvsense::multiband::MultiBandCsiFrame;
use wifi_densepose_signal::ruvsense::multistatic::{FusedSensingFrame, MultistaticFuser};
use wifi_densepose_signal::ruvsense::multistatic::{
FusedSensingFrame, MultistaticConfig, MultistaticFuser,
};
use super::NodeState;
@@ -44,6 +46,24 @@ static NORMALIZER: LazyLock<HardwareNormalizer> = LazyLock::new(HardwareNormaliz
/// `last_frame_time`.
pub fn node_frame_from_state(node_id: u8, ns: &NodeState) -> Option<MultiBandCsiFrame> {
let last_time = ns.last_frame_time.as_ref()?;
let timestamp_us = ns
.mesh_aligned_us_for_latest_csi_frame()
.unwrap_or_else(|| host_arrival_timestamp_us(last_time));
node_frame_from_state_at(node_id, ns, timestamp_us)
}
fn host_arrival_timestamp_us(last_time: &Instant) -> u64 {
last_time
.checked_duration_since(*EPOCH)
.unwrap_or_default()
.as_micros() as u64
}
fn node_frame_from_state_at(
node_id: u8,
ns: &NodeState,
timestamp_us: u64,
) -> Option<MultiBandCsiFrame> {
let latest = ns.frame_history.back()?;
if latest.is_empty() {
return None;
@@ -60,19 +80,6 @@ pub fn node_frame_from_state(node_id: u8, ns: &NodeState) -> Option<MultiBandCsi
let n_sub = amplitude.len();
let phase = vec![0.0_f32; n_sub];
// Prefer the capture timestamp recovered from the node's mesh sync. This
// keeps UDP scheduling jitter out of the fuser's cross-node guard. Older
// firmware, stale sync state, and frames without the sync-valid bit retain
// the process-local host-arrival fallback.
let timestamp_us = ns
.mesh_aligned_us_for_latest_csi_frame()
.unwrap_or_else(|| {
last_time
.checked_duration_since(*EPOCH)
.unwrap_or_default()
.as_micros() as u64
});
let canonical = CanonicalCsiFrame {
amplitude,
phase,
@@ -88,25 +95,91 @@ pub fn node_frame_from_state(node_id: u8, ns: &NodeState) -> Option<MultiBandCsi
})
}
/// Collect `MultiBandCsiFrame`s from all active nodes.
/// Collect the default-guard coherent `MultiBandCsiFrame` cohort.
///
/// A node is considered active if its `last_frame_time` is within
/// [`STALE_THRESHOLD`] of `now`.
pub fn node_frames_from_states(node_states: &HashMap<u8, NodeState>) -> Vec<MultiBandCsiFrame> {
let now = Instant::now();
let mut frames = Vec::with_capacity(node_states.len());
node_frames_from_states_with_guard(
node_states,
MultistaticConfig::default().guard_interval_us,
)
}
for (&node_id, ns) in node_states {
// Skip stale nodes
if let Some(ref t) = ns.last_frame_time {
if now.duration_since(*t) > STALE_THRESHOLD {
continue;
}
} else {
/// Collect the freshest temporally coherent cohort of active node frames.
///
/// Nodes can publish at very different rates (for example, a mixed S3/C6
/// fleet). `STALE_THRESHOLD` determines whether a node is alive; it does not
/// mean its latest frame belongs to the current sensing cycle. After choosing
/// one timestamp domain for the whole cycle, retain only frames within the
/// fuser's hard guard of the freshest frame. This prevents a slow-but-live node
/// from turning every governed cycle into `TimestampMismatch`, while always
/// preserving at least the freshest node for the supported single-node path.
pub fn node_frames_from_states_with_guard(
node_states: &HashMap<u8, NodeState>,
guard_interval_us: u64,
) -> Vec<MultiBandCsiFrame> {
let now = Instant::now();
let mut active: Vec<(u8, &NodeState)> = node_states
.iter()
.filter_map(|(&node_id, ns)| {
let last_time = ns.last_frame_time.as_ref()?;
(now.duration_since(*last_time) <= STALE_THRESHOLD).then_some((node_id, ns))
})
.collect();
active.sort_unstable_by_key(|(node_id, _)| *node_id);
if active.is_empty() {
return Vec::new();
}
let guard_interval_us = guard_interval_us.max(1);
// Timestamp domains must be selected for the cycle as a whole. A CSI
// frame can legitimately arrive between periodic sync-marked frames. If
// that one node fell back to process-local host time while a peer retained
// mesh epoch time, the resulting hundreds-of-seconds spread made every
// governed fusion cycle fail. Use mesh time only when every active node
// can provide it; otherwise use host-arrival time consistently for all.
let mesh_times: Option<Vec<u64>> = active
.iter()
.map(|(_, ns)| ns.mesh_aligned_us_for_latest_csi_frame())
.collect::<Option<Vec<_>>>()
.filter(|times| {
let Some(min) = times.iter().min() else {
return false;
};
let Some(max) = times.iter().max() else {
return false;
};
max.saturating_sub(*min) <= guard_interval_us
});
let mut timed = Vec::with_capacity(active.len());
for (index, (node_id, ns)) in active.into_iter().enumerate() {
let timestamp_us = mesh_times.as_ref().map_or_else(
|| {
host_arrival_timestamp_us(
ns.last_frame_time.as_ref().expect("active node has time"),
)
},
|times| times[index],
);
timed.push((node_id, ns, timestamp_us));
}
let freshest_timestamp_us = timed
.iter()
.map(|(_, _, timestamp_us)| *timestamp_us)
.max()
.expect("non-empty active cohort");
let mut frames = Vec::with_capacity(timed.len());
for (node_id, ns, timestamp_us) in timed {
if freshest_timestamp_us.saturating_sub(timestamp_us) > guard_interval_us {
continue;
}
if let Some(frame) = node_frame_from_state(node_id, ns) {
if let Some(frame) = node_frame_from_state_at(node_id, ns, timestamp_us) {
frames.push(frame);
}
}
@@ -125,7 +198,8 @@ pub fn fuse_or_fallback(
node_states: &HashMap<u8, NodeState>,
dedup_factor: f64,
) -> (Option<FusedSensingFrame>, Option<usize>) {
let frames = node_frames_from_states(node_states);
let frames =
node_frames_from_states_with_guard(node_states, fuser.guard_interval_us());
if frames.is_empty() {
return (None, Some(0));
}
@@ -313,26 +387,127 @@ mod tests {
}
#[test]
fn unsynchronized_frames_keep_host_arrival_guard() {
fn partial_sync_uses_one_host_timestamp_domain_for_the_cycle() {
let base = Instant::now() - Duration::from_millis(500);
let mut states = HashMap::new();
for (node_id, arrival) in [
(1, base),
(2, base + Duration::from_millis(200)),
let mut synced_history = VecDeque::new();
synced_history.push_back(vec![1.0; 64]);
let mut synced = make_node_state(synced_history, None, 0);
mark_mesh_timed_frame(&mut synced, 1, 100, 101, 500_000_000, base);
states.insert(1, synced);
let mut unsynced_history = VecDeque::new();
unsynced_history.push_back(vec![1.1; 64]);
states.insert(
2,
make_node_state(unsynced_history, Some(base + Duration::from_millis(5)), 0),
);
let frames = node_frames_from_states(&states);
let spread = frames.iter().map(|f| f.timestamp_us).max().unwrap()
- frames.iter().map(|f| f.timestamp_us).min().unwrap();
assert_eq!(spread, 5_000, "partial sync must fall back as one cycle");
assert!(
MultistaticFuser::new().fuse(&frames).is_ok(),
"mixed sync validity must not mix mesh and host timestamp domains"
);
}
#[test]
fn incoherent_mesh_timestamps_fall_back_to_host_arrival_for_the_cycle() {
let base = Instant::now() - Duration::from_millis(500);
let mut states = HashMap::new();
for (node_id, mesh_epoch_us, arrival) in [
(1, 1_000_000, base),
(2, 500_000_000, base + Duration::from_millis(5)),
] {
let mut history = VecDeque::new();
history.push_back(vec![1.0; 64]);
let mut state = make_node_state(history, None, 0);
mark_mesh_timed_frame(&mut state, node_id, 100, 101, mesh_epoch_us, arrival);
states.insert(node_id, state);
}
let frames = node_frames_from_states(&states);
let spread = frames.iter().map(|f| f.timestamp_us).max().unwrap()
- frames.iter().map(|f| f.timestamp_us).min().unwrap();
assert_eq!(spread, 5_000, "incoherent mesh time must not reach fusion");
assert!(MultistaticFuser::new().fuse(&frames).is_ok());
}
#[test]
fn unsynchronized_frames_prune_to_freshest_host_cohort() {
let base = Instant::now() - Duration::from_millis(500);
let mut states = HashMap::new();
for (node_id, arrival) in [(1, base), (2, base + Duration::from_millis(200))] {
let mut history = VecDeque::new();
history.push_back(vec![1.0; 64]);
states.insert(node_id, make_node_state(history, Some(arrival), 0));
}
let frames = node_frames_from_states(&states);
assert_eq!(frames.len(), 1, "only the freshest host frame is coherent");
assert_eq!(frames[0].node_id, 2);
assert!(
MultistaticFuser::new().fuse(&frames).is_err(),
"without valid mesh time, 200 ms arrival skew must still trip the 60 ms guard"
MultistaticFuser::new().fuse(&frames).is_ok(),
"an asynchronous slow node must not fail the live cycle"
);
}
#[test]
fn slow_live_node_is_excluded_from_fresh_cohort() {
let now = Instant::now();
let mut states = HashMap::new();
for (node_id, age_ms, n_sub) in [
(1, 0, 64),
(3, 10, 256),
(4, 50, 64),
(7, 1_000, 256),
] {
let mut history = VecDeque::new();
history.push_back(vec![1.0 + node_id as f64 * 0.01; n_sub]);
states.insert(
node_id,
make_node_state(
history,
Some(now - Duration::from_millis(age_ms)),
1,
),
);
}
let frames = node_frames_from_states_with_guard(&states, 60_000);
let ids: Vec<u8> = frames.iter().map(|frame| frame.node_id).collect();
assert_eq!(ids, vec![1, 3, 4]);
assert!(MultistaticFuser::new().fuse(&frames).is_ok());
}
#[test]
fn configured_guard_is_shared_with_cohort_selection() {
let base = Instant::now() - Duration::from_millis(500);
let mut states = HashMap::new();
for (node_id, arrival) in [
(1, base),
(2, base + Duration::from_millis(150)),
] {
let mut history = VecDeque::new();
history.push_back(vec![1.0; 64]);
states.insert(node_id, make_node_state(history, Some(arrival), 0));
}
let cfg = MultistaticConfig {
guard_interval_us: 200_000,
..MultistaticConfig::default()
};
let fuser = MultistaticFuser::with_config(cfg);
let (fused, fallback) = fuse_or_fallback(&fuser, &states, 3.0);
assert_eq!(fused.as_ref().map(|frame| frame.active_nodes), Some(2));
assert!(fallback.is_none());
}
#[test]
fn heterogeneous_node_counts_canonicalize_and_fuse() {
// Issue #1170 regression: a mixed mesh with HT20 (64-bin) and HT40

View File

@@ -258,6 +258,9 @@ pub struct Esp32VitalsPacket {
pub heartrate_bpm: f64,
pub rssi: i8,
pub n_persons: u8,
/// True only when the firmware count is protocol-bounded and consistent
/// with the packet presence flag.
pub person_count_valid: bool,
pub motion_energy: f32,
pub presence_score: f32,
pub timestamp_ms: u32,

View File

@@ -272,6 +272,17 @@ impl MultistaticFuser {
self.node_positions = positions;
}
/// Return the configured hard timestamp guard in microseconds.
///
/// Callers that assemble frames before invoking [`Self::fuse`] use this
/// to select one temporally coherent sensing cohort. Keeping selection and
/// validation on the same guard prevents stale low-rate nodes from making
/// every otherwise-live fusion cycle fail.
#[must_use]
pub fn guard_interval_us(&self) -> u64 {
self.config.guard_interval_us
}
/// Return the current node positions.
pub fn node_positions(&self) -> &[[f32; 3]] {
&self.node_positions

2
vendor/rufield vendored