video_spacetime_cube — VIDEOCUBE cube op

• Data kinds: video → voxel

• Call: import fullseye as fs; fs.ledger.video_spacetime_cube(video, mode: 'str' = 'motion', sigma: 'float' = 1.0, percentile: 'float' = 99.5, floor: 'float' = 0.15) -> 'np.ndarray' (implementation को सीधे call करना हो तो import videocube; videocube.video_spacetime_cube(video, mode: 'str' = 'motion', sigma: 'float' = 1.0, percentile: 'float' = 99.5, floor: 'float' = 0.15) -> 'np.ndarray', registry से लेना हो तो opsvideocube.get("video_spacetime_cube"))

उपयोग

video (T, H, W) को space × time cube (T, H, W) float [0, 1] में बदलता है (voxel)।

mode="motion": पास के frames के अंतर का परिमाण |I_t − I_{t−1}| space में σ = sigma वाले Gaussian से smooth किया जाता है, percentile quantile पर 1 तक normalise, floor से कम को 0 करके [0, 1] तक फैलाया जाता है (पहला frame 0; sensor noise के अंतर floor के नीचे डूब जाते हैं)। केवल चलती वस्तुएँ उभरती हैं, इसलिए यह vol_render_transfer की opacity बनता है -- स्थिर background पारदर्शी हो जाता है और trajectories उभर आती हैं (Summagator का transfer function)। mode="intensity": brightness को [0, 1] पर normalise (रंग का स्रोत, या background को हल्का बिछाने के लिए)। mode="dark" / "bright": dark / bright जगहों को opaque बनाता है (σ से smooth, floor से कम 0)। video नहीं बल्कि z stack (EM के लगातार sections: membrane dark होती है; fluorescence: cells bright होते हैं) को उसी cube की तरह देखने के लिए -- पहले axis को time की बजाय depth पढ़ने भर से section (video_cube_cut) और rotation (video_cube_orbit) भी उन्हीं ops से चलते हैं।

>>> alpha = video_spacetime_cube(clip, "motion")

>>> color = video_spacetime_cube(clip, "intensity")

>>> rgb = vol_render_transfer(alpha, color, yaw=35.0, pitch=25.0)

>>> membranes = video_spacetime_cube(em_stack, "dark", sigma=1.0) # fly brain के sections जोड़कर बना cube

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

• videocube 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_video_cube — py -3.11 examples/poc_video_cube.py

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

vol_render_transfer

इसी category के (cube)

video_cube_cut

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

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