scoop_synth_side — DRIVE `scoop` op

• Data kinds: scalar × scalar → table

• Call: import fullseye as fs; fs.ledger.scoop_synth_side(a_px: 'float', h_px: 'float', *, fill: 'float' = 1.0, heap_frac: 'float' = 0.0, phi_deg: 'float' = 30.0, pitch: 'float' = 0.0001, margin_px: 'int' = 10, supersample: 'int' = 8, noise: 'float' = 0.0, seed: 'int | None' = None) -> 'dict' (to call the implementation directly, import scoop; scoop.scoop_synth_side(a_px: 'float', h_px: 'float', *, fill: 'float' = 1.0, heap_frac: 'float' = 0.0, phi_deg: 'float' = 30.0, pitch: 'float' = 0.0001, margin_px: 'int' = 10, supersample: 'int' = 8, noise: 'float' = 0.0, seed: 'int | None' = None) -> 'dict'; from the registry, opsdrive.get("scoop_synth_side"))

Usage

Synthesizes the side-view coverage of powder in a spherical-cap bowl (axisymmetric; ground truth in closed form).

> The detailed description below is the original text — the summary and the headings are translated.

• fill ∈ (0, 1]: 底からの深さの割合 y = fill·h まで平らに満たす(heap_frac > 0 なら 1 であること)。

• heap_frac ∈ [0, 1]: すり切りの上に、底面の半径 b = heap_frac·a・安息角 φ の円錐(真ん中に注いで育つ山)。

• 返り: side(透明な椀 = 中身が全部見える被覆率)、side_above(縁より上だけ = 金属の椀を横から見た像)、rim_row(縁の高さの行境界: 行 rim_row から下が縁より下)、axis_col(軸の列座標、画素の端が整数)、truth(V [m³] 閉形式、V_struck, V_heap, fill, heap_frac, phi_deg)、pitch。

合成と revolution_volume_side は同じ軸対称の模型なので、雑音なしの往復は 配管の検査(独立な被験者は two_view_volume の楕円の山と MuJoCo の球)。Raises ValueError: 範囲外、fill < 1 で山を載せた。

References (sample data, literature)

• Sample-data catalog (download URLs / licences) — 2-D uses skimage.data (BSD/public domain) plus synthetic images; 3-D lists download URLs for real data sources (Stanford, PDS, …).

• Operator provenance and references — the sources of the research/methods this op family came from.

• The canonical algorithm (author, year) and its uses are named in the family usage guide above.

Runnable examples (verified samples that actually call this op)

• poc_powder_scoop_pour — py -3.11 examples/poc_powder_scoop_pour.py

Ops the type connects to (they accept `table` as input)

course_layout · course_occupancy · course_contains · world_build · world_camera · world_move · lidar_scan · rss_longitudinal_same

Same category (`scoop`)

spoon_bowl_volume · revolution_volume_side · two_view_volume · scoop_volume_read · scoop_count · scoop_image_limit · tilt_wedge_retained · tilt_pour_rate

*Provenance: scoop.py — DRIVE operator registry. This per-op note is generated by tools/opdocs.py md (do not hand-edit).*

scoop_synth_side — DRIVE scoop op