mirror of
https://github.com/ruvnet/RuView
synced 2026-07-25 17:51:48 +00:00
Dragan Spiridonov
2febbb813c
Reverses the release-wheel packaging change from3ed43e9aafter review. That commit built the published wheels with `--features sota` so `pip install wifi-densepose[aether]` would work. But it did so by abandoning a DELIBERATE, guarded design: `default = []`, the RuView#1387-default-wheel-budget-config fix-marker, and the wheel-size-budget job exist specifically to keep the base wheel small and make SOTA opt-in (ADR-117 §5.4). Building SOTA into every published wheel makes the base fat, turns the `[aether]`/`[mat]`/`[meridian]` extras into inert no-ops, and — worse — leaves the PUBLISHED wheel un-budget-checked (the budget job only builds the no-features wheel), so the ONNX Runtime dependency the fix-marker anticipates for `mat` would later balloon the shipped wheel past 5 MiB silently. A pip extra cannot enable a cargo feature on a prebuilt wheel, so "small base + opt-in SOTA in binary wheels" is only achievable by splitting into separate packages — tracked as #1412. Until that lands, P6 is source-build-only, and the honest thing is to say so. This commit: - Restores pip-release.yml to its original state (no --features in the release build; original smoke test). Net packaging change across the branch is now ZERO — the small-base design is fully intact. - Points the aether/mat/meridian import shims at the real interim path: a source build with `--features <x>` (or `--features sota`), and #1412 for the binary wheels follow-up. The earlier revision wrongly claimed "the official wheels include it", which is only true once #1412 ships. KEPT from3ed43e9a(correct regardless of packaging): the AETHER parity tests are now arch-portable — they compare a golden VECTOR within tolerance instead of a SHA-256 of raw f32 bytes, which only ever matched the one architecture that generated it and failed on the aarch64/macOS-arm wheels this project builds. Verified on aarch64/macOS with a `--features sota` build (as python-ci does): test_aether 13, test_mat 7, test_meridian 13 pass; full suite unaffected. Co-Authored-By: Ruflo & AQE
63 lines
2.4 KiB
Python
63 lines
2.4 KiB
Python
"""MERIDIAN — cross-environment domain generalization (ADR-027, ADR-185 P2).
|
|
|
|
Hardware-invariant CSI normalization, geometry-conditioned deployment,
|
|
few-shot room adaptation, and cross-domain evaluation — the tch-free
|
|
inference/adaptation path of Project MERIDIAN, computed by the Rust core.
|
|
|
|
Not in the binary wheels yet (see ruvnet/RuView#1412 — the P6 SOTA
|
|
bindings are shipped source-build-only for now to keep the base wheel
|
|
small). Build from source with ``maturin ... --features meridian`` (or
|
|
``--features sota`` for all three P6 subsystems).
|
|
|
|
Quick start::
|
|
|
|
from wifi_densepose.meridian import HardwareNormalizer, HardwareType
|
|
|
|
norm = HardwareNormalizer() # canonical 56 subcarriers
|
|
hw = HardwareType.detect(64) # -> HardwareType.Esp32S3
|
|
frame = norm.normalize(amplitude, phase, hw) # -> CanonicalCsiFrame
|
|
print(len(frame.amplitude), frame.hardware_type)
|
|
|
|
Note (honest scope, ADR-185 §3.3): the ADR's ``RapidAdaptation.calibrate``
|
|
/ ``AdaptationResult.converged`` do not exist in the Rust core — use
|
|
``push_frame(...)`` then ``adapt()``; the result exposes ``final_loss``,
|
|
``frames_used``, ``adaptation_epochs``. Training-time types
|
|
(DomainFactorizer, GradientReversalLayer, VirtualDomainAugmentor) are
|
|
out of scope for P6 (they need the deferred libtorch training tier).
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from wifi_densepose import _native
|
|
|
|
# MERIDIAN symbols are compiled into `_native` only under the Rust
|
|
# `meridian` feature; absent in a base wheel (ADR-185 §6 acceptance).
|
|
if not hasattr(_native, "HardwareNormalizer"):
|
|
raise ImportError(
|
|
"wifi_densepose.meridian is not in the binary wheels yet "
|
|
"(see ruvnet/RuView#1412). Build from source with "
|
|
"`maturin ... --features meridian` (or `--features sota`)."
|
|
)
|
|
|
|
HardwareType = _native.HardwareType
|
|
CanonicalCsiFrame = _native.CanonicalCsiFrame
|
|
HardwareNormalizer = _native.HardwareNormalizer
|
|
MeridianGeometryConfig = _native.MeridianGeometryConfig
|
|
GeometryEncoder = _native.GeometryEncoder
|
|
RapidAdaptation = _native.RapidAdaptation
|
|
AdaptationResult = _native.AdaptationResult
|
|
CrossDomainEvaluator = _native.CrossDomainEvaluator
|
|
mpjpe = _native.mpjpe
|
|
|
|
__all__ = [
|
|
"HardwareType",
|
|
"CanonicalCsiFrame",
|
|
"HardwareNormalizer",
|
|
"MeridianGeometryConfig",
|
|
"GeometryEncoder",
|
|
"RapidAdaptation",
|
|
"AdaptationResult",
|
|
"CrossDomainEvaluator",
|
|
"mpjpe",
|
|
]
|