scoop op• 데이터 종류: scalar × scalar × scalar × scalar → table
• 호출: import fullseye as fs; fs.ledger.scoop_image_limit(a: 'float', pitch: 'float', radius: 'float', bulk_density: 'float', *, h: 'float | None' = None, phi_deg: 'float' = 30.0, edge_px: 'float' = 0.5, grain_frac: 'float' = 0.25, min_a_over_d: 'float' = 5.0, target_mass: 'float | None' = None, rel_tol: 'float' = 0.05) -> 'dict'(구현을 직접 호출하려면 import scoop; scoop.scoop_image_limit(a: 'float', pitch: 'float', radius: 'float', bulk_density: 'float', *, h: 'float | None' = None, phi_deg: 'float' = 30.0, edge_px: 'float' = 0.5, grain_frac: 'float' = 0.25, min_a_over_d: 'float' = 5.0, target_mass: 'float | None' = None, rel_tol: 'float' = 0.05) -> 'dict', 원장에서 가져오려면 opsdrive.get("scoop_image_limit"))
수북이 담은 숟가락을 측면 영상으로 잴 때의 불확도 기준과 "영상으로 충분한가, 저울인가"(규칙 기반, 기준).
모형: 체적 오차 ≈ 보이는 표면적 S × 경계의 불확실성 e = edge_px·pitch + grain_frac·r(가장자리 화소와, 윤곽이 입자의바깥쪽 포락선이 되는 부분 중 교정으로 사라지지 않는 나머지). S 는 더미의 원뿔 측면 π a √(a² + H²)(H = a tan φ), 체적은 고봉의닫힌 형식(h 를 주지 않으면 a/2). grain_frac = 0.25 는 MuJoCo 의 강체 구(반경 2 mm, 테두리 반경 30 mm, 충전율을 1 회 교정)에서 3 개 양 × 2 seed 의 개수 오차가 4.3 % 이내였던 상한으로부터 역산한 0.15 에 여유를 둔 값(PoC). 입자가 적으면 선형 외삽보다 빨리 무너지므로(반경 3.5 mm, 테두리 반경 / 입경 4.3 에서 9.5 %), a / d < min_a_over_d 는 오차와 관계없이 scale 을 반환한다.
반환: sigma_V, sigma_mass = ρ_b σ_V, rel_err = σ_V / V, a_over_d(테두리 반경 / 입경), a_min(rel_tol 을만족하는 최소 테두리 반경 —— 오차는 e / a 에 비례), verdict(image / scale), reason. target_mass 를주면, 같은 모양의 그릇을 그 질량에 맞춰 축소했을 때의 상대 오차 rel_err_target 으로 판정한다. Raises ValueError: 인수의 범위.
• 샘플 데이터 카탈로그(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 · tilt_wedge_retained · tilt_pour_rate
*Provenance: scoop.py — DRIVE 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.