fly_hex_quantize — FLYVISION sample op

• 資料種類:signal → signal

• 呼叫: import fullseye as fs; fs.ledger.fly_hex_quantize(signal, bits=3, mode='log', contrast=0.2)(要直接呼叫實作,import flyvision; flyvision.fly_hex_quantize(signal, bits=3, mode='log', contrast=0.2);從台帳取用則 opsflyvision.get("fly_hex_quantize"))

用法

以與眼睛相同的方式量化小眼訊號:先做對數壓縮,再對每個小眼取 n 位元(mode="onoff" 為 ON / OFF 2 個通道)。

複眼天生就是量化器:每隻眼約 800 個小眼(間隔 4.6°),光受器對強度作對數壓縮並適應平均值, lamina 的 L1 / L2 把相對平均值的偏差分成 ON 與 OFF。此 op 重現這項預算,使下游模型(reservoir、視網膜拓撲對應檢驗)能被問到「究竟需要多少位元」。

複眼天生就是量化器: 每隻眼約 800 個小眼,間隔 4.6 deg, 光受器對強度作對數壓縮並適應平均值,lamina 細胞(L1/L2) 把偏差分成 ON 與 OFF 通道。此 op 重現這項預算,使下游模型(reservoir、視網膜拓撲檢驗)能被問到真正需要多少位元。

Parameters

signal : (n,) float

每個小眼的強度 >= 0(fly_hex_resample 的輸出)。

bits : int

1..8 級 = 2**bits(mode="onoff" 時忽略: 輸出為下方的帶符號對)。

mode : str

"log": 相對平均值作 log1p 壓縮,把最暗的小眼移到 0,然後

在壓縮後的範圍上均勻分級; "linear": 在 [0, max] 上均勻分級; "onoff": 相對平均值的偏差

以 contrast 正規化並裁切到 [-1, 1],作為 2 * n 個值 [ON..., OFF...] 回傳

(ON = 正部分,OFF = 負部分),各值 >= 0。

contrast : float

使 ON/OFF 通道飽和的 Michelson 式對比(僅 mode="onoff")。

Returns

(n,) float,取值 [0, 1] (級數 / (2**bits - 1));"onoff" 時為 (2n,),取值 [0, 1]。

Notes

拒絕非有限或負的輸入。常數訊號量化為全零("log" / "onoff")—— 沒有可編碼的對比。

詳細使用指南

• fly_vision 族使用指南

參考(範例資料、文獻)

• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。

• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。

• 演算法的正典(作者、年份)與用途見上面的族使用指南。

可執行的範例(實際呼叫該運算子並已驗證的樣例)

• poc_eye_to_brain — py -3.11 examples/poc_eye_to_brain.py

型別可銜接的下一個運算子(可接受 signal 作為輸入)

fly_emd_response · fly_lgmd_eta · fly_tau_from_expansion · fly_dsi

同類別(sample)

fly_hex_resample


*Provenance: flyvision.py — FLYVISION 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.