Repository navigation
NeckLink v3.0.0 — BANC v888 Connectome Weights & Audited Benchmarks (Research Beta)
Research beta. NeckLink v3.0.0 compiles ~33,000 weight entries from the 157,789-neuron, 23.55M-synapse adult Drosophila BANC v888 connectome into Python (data/*.npz), zero-float/zero-heap ANSI C99 (*_banc_weights.h, 24,024 B Whole-CNS state, 0 B .bss), ESP32/Arduino, and standalone WebAssembly (107.5 KB necklink_cns.wasm), and tests every module against K = 100 Maslov–Sneppen degree- and weight-multiset-preserving raw-neuron shuffles (N = 30 seeds).
NLTP (pynltp==1.6.0) is unchanged in this release.
Highlights & What Was Measured
- Connectome-derived default weights (
connectome_weights="banc_v888") acrossneckcompass,necksight,necksense,neckcord, andnecklink-cns, with the earlier hand-tuned symmetric model retained asconnectome_weights="v2_analytic". - Connectome extraction & Maslov–Sneppen shuffling (
necklink-cns[connectome]):necklink_cns.connectome.extractandnecklink_cns.connectome.shuffleplus the reproducible suite and raw outputs inbenchmarks/v3/. - Audited
K = 100shuffle-gate summary:- Where specific connectome topology matters:
NeckCompasswave +125°magnetic spike RMS (12.84°vs62.82°shuffled,r = 0/100, p = 0.0099),NeckCompassclosed-loop homing (100%vs4.7%shuffled,r = 0/100, p = 0.0099), andNeckCordemergent tripod gait order (0.855vs0.411shuffled,r = 0/100, p = 0.0099);NeckLink CNSclosed-loop boat sim (66.7%over 30 seeds;58.3%vs4.6%in the 12-seed shuffle gate,r = 2/100, p = 0.030, marginal) andNeckSightthin poles/wires (0.755vs0.672shuffled,r = 3/100, p = 0.040, marginal). - Honest nulls:
NeckSensemushroom body (0.666vs0.672shuffled on UCI gas novelty,p = 0.74) performs identically to degree-matched random claws. - Accuracy vs baselines: On every task, either
connectome_weights="v2_analytic"or a tuned classical baseline (χ²-gated EKF, gyro-derotated Farneback, One-Class SVM, nearest centroid, SciPy bounded QP) achieves the highest raw accuracy. Real circuits carry biological left/right asymmetries (e.g., compass drift in darkness).
- Where specific connectome topology matters:
- Audit & packaging fixes:
- Fixed C99/WASM
nl_cns_initto initializeplastic_ring.compwithBANC v888weights (nc_banc_default_weights()). - Guarded WASM singletons behind
#if defined(__EMSCRIPTEN__) || defined(__wasm__) || defined(NL_CNS_WASM_SINGLETON)so MCU.bssis0 B(ESP32esp32devPlatformIO compile check:14.5%RAM /39.3%Flash forNeckLinkCNS). - Lazy-loaded
scipy/pandas/pyarrowinto optional[connectome]extra so runtime wheel installs require onlynumpy. - Added explicit
PROVENANCE = "engineering"/"connectome"class labels.
- Fixed C99/WASM
- Scope & caveats: Pipeline design used real-wiring feedback prior to freezing shuffles; p-values are unadjusted across multiple endpoints; benchmarks other than UCI gas drift and CWRU bearing vibration are numerical/MuJoCo simulations, and closed-loop physical robot hardware has not yet been tested.
PyPI Packages (v3.0.0)
pip install --upgrade necklink==3.0.0
# or individual packages:
pip install --upgrade necksight==3.0.0 neckcompass==3.0.0 neckcord==3.0.0 necksense==3.0.0 necklink-cns==3.0.0