fly_dsi — FLYVISION tuning op

• Data kinds: signal → table

• Call: import fullseye as fs; fs.ledger.fly_dsi(responses, angles_deg) (implementation को सीधे call करना हो तो import flyvision; flyvision.fly_dsi(responses, angles_deg), registry से लेना हो तो opsflyvision.get("fly_dsi"))

उपयोग

tuning responses से direction-selectivity index और preferred दिशा।

> नीचे का विस्तृत विवरण मूल text में है — सारांश और headings का अनुवाद हो चुका है।

A vector sum on the circle::

DSI = |sum_k r_k exp(i theta_k)| / (sum_k r_k + 1e-9)

preferred = angle(sum_k r_k exp(i theta_k))

where r_k >= 0 is the response to a stimulus moving at angle theta_k = angles_deg[k] (negatives clipped to 0).

responses: a 1-D array of responses, one per direction.

angles_deg: the stimulus directions in degrees, same length.

Returns a dict {"dsi": float, "pref_deg": float} with pref_deg in [-180, 180].

Ground truth: a response at a single direction gives dsi == 1; an isotropic response over directions evenly spanning the circle gives dsi == 0 (pinned in the tests).

Raises ValueError: a non-1-D / empty / non-finite *responses* or *angles_deg*, mismatched lengths, an array over MAX_SIGNAL_POINTS, and an all-zero *responses* (no direction tuning to report).

उपयोग की विस्तृत guide

• fly_vision family guide

संदर्भ (sample data, साहित्य)

• Sample data catalog (DL URL / license) — 2-D के लिए skimage.data (BSD/public) + synthetic, 3-D के लिए real data sources (Stanford/PDS आदि) के DL URL।

• Operators का स्रोत और संदर्भ — इस op family के मूल research/methods के स्रोत।

• Algorithm का मानक स्रोत (लेखक, वर्ष) और उपयोग ऊपर की family usage guide में दिए गए हैं।

चलाए जा सकने वाले उदाहरण (verified samples जो सच में यह op call करते हैं)

• poc_fly_vision — py -3.11 examples/poc_fly_vision.py

वे अगले ops जिनसे type जुड़ता है (table को input के रूप में लेते हैं)

fly_t4t5_field · fly_flow_from_directions · fly_matched_filter · fly_egomotion_from_flow · fly_eye_merge · fly_hex_resample · fly_hs_readout

इसी category के (tuning)

—


*Provenance: flyvision.py — FLYVISION operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*

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