scoop op• Data kinds: image2d × scalar → table
• Call: import fullseye as fs; fs.ledger.revolution_volume_side(side, pitch: 'float', *, axis_col: 'float | None' = None, threshold: 'float' = 0.5) -> 'dict' (to call the implementation directly, import scoop; scoop.revolution_volume_side(side, pitch: 'float', *, axis_col: 'float | None' = None, threshold: 'float' = 0.5) -> 'dict'; from the registry, opsdrive.get("revolution_volume_side"))
Volume from 1 side image assuming axial symmetry — Pappus form V = π Σ |x − x_axis| c(x, z) pitch³ (c = coverage, x = pixel-center column).
Being linear in the coverage, it is not biased even in rows where a flat powder surface crosses mid-row (the sum of discs whose diameter is each row's width, Σ π (w/2)², counts a row with fill fraction f as f² and came out 1.5 % low, measured). Noise is removed first outside and inside the object (_clean_coverage). If the axis axis_col (pixel edges at integers) is not given, the column of the coverage centroid is used. A line is fitted to the per-row centroids and the axis tilt axis_tilt_deg (atan2) is also returned (a tilted bowl gains volume; the judgement is the caller's).
Returns: V [cube of the pitch unit], V_px, V_discs (sum of discs, for comparison), radius_px (per-row half-width), axis_col, axis_tilt_deg, rows_used, height_px. Raises ValueError: not a coverage / no powder visible / touches the left or right edge (cut off).
• 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.
• poc_powder_scoop_pour — py -3.11 examples/poc_powder_scoop_pour.py
table as input)course_layout · course_occupancy · course_contains · world_build · world_camera · world_move · lidar_scan · rss_longitudinal_same
scoop)spoon_bowl_volume · scoop_synth_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).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.