fly_onoff_split — FLYVISION lamina op

• 데이터 종류: matrix → matrix

• 호출: import fullseye as fs; fs.ledger.fly_onoff_split(movie, dt_s, tau_on_s=0.02, tau_off_s=0.02, rectify=True)(구현을 직접 호출하려면 import flyvision; flyvision.fly_onoff_split(movie, dt_s, tau_on_s=0.02, tau_off_s=0.02, rectify=True), 원장에서 가져오려면 opsflyvision.get("fly_onoff_split"))

사용법

> 이 연산자의 설명은 아직 번역이 없습니다. 원문을 그대로 싣습니다.

Split a contrast movie into the ON and OFF channels the medulla carries.

Beyond the lamina the fly stops carrying one signed signal and carries two:

an ON channel (Mi1 / Tm3, brightening) and an OFF channel (Tm1 / Tm2, darkening), each with its own relay dynamics. This op is that split, and it keeps the rectification *optional* on purpose: the split was measured downstream, in the motion response (Joesch et al., *Nature* 468:300, 2010), while L1/L2 themselves respond linearly (Clark et al., *Neuron* 70:1165, 2011), so a pathway that rectifies at the lamina is making a claim the recordings do not.

movie: (T, n) contrast, rows = time (the return of fly_lamina_filter). dt_s: sample interval, seconds. tau_on_s / tau_off_s: the low-pass time constant of each channel, seconds.

rectify: True half-wave rectifies (ON = max(c, 0), OFF = max(-c, 0), both >= 0); False passes the signed contrast into the ON channel and its negation into the OFF channel, which is the linear L1/L2 case and lets the rectification happen downstream instead.

Returns (T, 2n) float64: columns 0..n-1 are ON, n..2n-1 are OFF, the same ommatidium order in each half.

Ground truth (exact, with tau_on_s == tau_off_s so the two channels share one filter):

• ON - OFF is the low-passed input, whichever *rectify* you chose;

• with rectify=True, ON + OFF is the low-passed absolute value;

• a movie that never goes negative leaves the OFF channel identically zero (and vice versa) — the split does not invent a dark event.

Raises ValueError: a non-2-D / too-short / non-finite *movie*, a movie

over MAX_MOVIE_ELEMENTS, and a non-positive *dt_s* / *tau_on_s* / *tau_off_s*.

자세한 사용 가이드

• fly_vision 패밀리 가이드

참고(샘플 데이터·문헌)

• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.

• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.

• 알고리즘의 정전(저자·연도)과 용도는 위의 패밀리 사용 가이드에 적혀 있습니다.

실행 가능한 예제(이 연산자를 실제로 호출하는 검증된 샘플)

• poc_fly_optomotor_steering — py -3.11 examples/poc_fly_optomotor_steering.py

타입이 이어지는 다음 연산자(matrix 를 입력으로 받는 것)

fly_lamina_filter · fly_t4t5_field · fly_flow_from_directions · fly_egomotion_from_flow · fly_hs_readout

같은 카테고리(lamina)

fly_lamina_filter


*Provenance: flyvision.py — FLYVISION 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*

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