integrate op• 数据种类:matrix × table → measurement
• 调用: import fullseye as fs; fs.ledger.fly_hs_readout(responses, lattice, n_pref, el_min_deg=0.0, rectify=True)(要直接调用实现,import flyvision; flyvision.fly_hs_readout(responses, lattice, n_pref, el_min_deg=0.0, rectify=True);从台账取用则 opsflyvision.get("fly_hs_readout"))
> 该算子的说明尚无译文,以下照原文给出。
Horizontal-system wide-field readout: opponent sum over the upper field.
Given a stack of motion-detector responses over the ommatidia — the first
*n_pref* rows the preferred-direction type, the rest the anti-preferred — the
opponent readout over the ommatidia above the horizon is::
(a - b) / (a + b + 1e-6)
where `a and b` are the (optionally rectified) totals of the preferred
and anti-preferred responses over the columns with `el > el_min_deg`.
Only the upper visual field is used because the ground flow of forward motion
is `1/distance` while the rotational flow it must be separated from is
distance-independent: an eye 1.2 mm above the floor sees floor flow of
330-1000 deg/s, above the ~200 deg/s bandwidth of the motion detectors, so the
lower field carries speed the correlator cannot read and is excluded.
responses: a `(k, n) matrix of responses, n` matching the lattice.
lattice: the dict returned by :func:fly_hex_lattice.
n_pref: how many leading rows are the preferred-direction type
(`1 <= n_pref < k`).
el_min_deg: the horizon; only ommatidia above it contribute.
rectify: half-wave rectify (clip negatives to 0) before summing.
Returns the opponent ratio as a float in `[-1, 1]`.
Ground truth: with the preferred rows active only in the upper field and the
anti-preferred rows silent, the readout is `+1` (and the sign and value
match the hand calculation); an `el_min_deg` above every ommatidium raises
(pinned in the tests).
Raises `ValueError`: a non-2-D / empty / non-finite *responses*, a
*responses* over the element cap, a *lattice* that is not a
:func:fly_hex_lattice result, a column count not matching the lattice, a
*n_pref* outside `[1, k-1]`, a non-real *el_min_deg*, a non-bool *rectify*,
and an *el_min_deg* above every ommatidium (no upper field to read).
• 示例数据目录(下载 URL / 许可证) —— 2-D 用 skimage.data(BSD/公有领域)加合成图,3-D 给出真实数据源(Stanford/PDS 等)的下载 URL。
• 算子来历与参考文献 —— 该算子族所依据的研究/方法出处。
• 算法的正典(作者・年份)与用途见上面的族使用指南。
• poc_fly_vision — py -3.11 examples/poc_fly_vision.py
measurement 作为输入)—
integrate)—
*Provenance: flyvision.py — FLYVISION 算子登记表。本条目由 tools/opdocs.py md 自动生成(请勿手工编辑)。*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.