scoop op• 데이터 종류: any × scalar × scalar → table
• 호출: import fullseye as fs; fs.ledger.stream_flux_read(frames, dt: 'float', radius_px: 'float', *, band_rows=None, band_px: 'int' = 9, window: 'int' = 32, particle_mass: 'float | None' = None, c_max: 'float' = 0.95, min_valid: 'float' = 0.3, min_crossings: 'float' = 30.0) -> 'dict'(구현을 직접 호출하려면 import scoop; scoop.stream_flux_read(frames, dt: 'float', radius_px: 'float', *, band_rows=None, band_px: 'int' = 9, window: 'int' = 32, particle_mass: 'float | None' = None, c_max: 'float' = 0.95, min_valid: 'float' = 0.3, min_crossings: 'float' = 30.0) -> 'dict', 원장에서 가져오려면 opsdrive.get("stream_flux_read"))
흐름의 프레임 열로부터 유량 [개/s] (와 질량 유량)를 읽습니다 —— 속도는 PIV(pivops.piv_cross_correlate의 전체 프레임 쌍의 중앙값), 입자의 선밀도는 시간 평균 피복률에 대한 Boolean 모형의 역(stream_areal_density)을 가로로 적분한 λ, 유량은 λ v.
band_rows = 측정할 띠의 중심 행(None 이면 PIV 창의 행 중심 전부). 각 띠는 band_px 행의 평균. 속도는 흐름의방향(행이 증가하는 방향) 성분을 PIV 창의 행 사이에서 선형 보간하고, 열은 피복률 가중으로 평균한다.
반환: rows, v_px(px/프레임), v(px/s), lam(개/px), flux(개/s), flux_naive(소박한 c/(πr²)), flux_mean, flux_spread(띠 사이의 (max − min)/평균 = 유량 연속성 검사), mass_flux(particle_mass 를 주었을 때), valid_fraction(PIV 의 유한한 창의 비율), c_max_seen, n_crossed_est(기록 동안 각 띠를 가로지른 알갱이의 추정 수 flux·T), rel_err_poisson(1/√n, 알갱이 계수의 요동), reliable(모든 띠에서 n ≥ min_crossings). 알갱이가 적으면 유량은 계수 요동 그 자체(1 띠를 가로지르는 알갱이가 2 개면 ±70 %) —— reliable=False 로 알린다. Raises ValueError: 프레임이 2 미만 / 형상이 맞지 않음 / PIV 의 유한한 창이 min_valid 미만(알갱이가 너무 적어 속도를읽을 수 없음 —— 깨지는 곳) / 띠가 영상 밖 / 포화.
• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.
• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.
• 알고리즘의 정전(저자·연도)과 용도는 위의 패밀리 사용 가이드에 적혀 있습니다.
• poc_powder_scoop_pour — py -3.11 examples/poc_powder_scoop_pour.py
table 를 입력으로 받는 것)course_layout · course_occupancy · course_contains · world_build · world_camera · world_move · lidar_scan · rss_longitudinal_same
scoop)spoon_bowl_volume · scoop_synth_side · revolution_volume_side · two_view_volume · scoop_volume_read · scoop_count · scoop_image_limit · tilt_wedge_retained
*Provenance: scoop.py — DRIVE 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.