heap_volume_heightmap — DRIVE granular op

• Data kinds: image2d × scalar → scalar

• Call: import fullseye as fs; fs.ledger.heap_volume_heightmap(hm, pitch: 'float', ground=None) -> 'float' (to call the implementation directly, import granular; granular.heap_volume_heightmap(hm, pitch: 'float', ground=None) -> 'float'; from the registry, opsdrive.get("heap_volume_heightmap"))

Usage

Heap volume from a heightmap Σ (z − z_ground) pitch² [m³]. ground is the ground height with the same shape (None = 0). Negative heights (below the ground) are clipped to 0 — holes are not subtracted from the heap. Raises ValueError: shape, pitch.

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_granular_heap_repose — py -3.11 examples/poc_granular_heap_repose.py

Ops the type connects to (they accept scalar as input)

spin_from_marker_sequence · carla_transform_matrix · carla_pose_to_world · carla_camera_pose · carla_xy_yaw · carla_scene_load · town_chain · osm_parse

Same category (granular)

heap_volume_cone · heap_mass · beverloo_rate · beverloo_fit · discharge_synth · dispense_mass_from_video · hopper_discharge_rate · spoon_tilt_critical


*Provenance: granular.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.