cone_profile_px — DRIVE granular op

• Data kinds: signal × scalar × scalar → signal

• Call: import fullseye as fs; fs.ledger.cone_profile_px(u, H_px: 'float', phi_deg: 'float', toe_round_px: 'float' = 0.0, apex_blunt_px: 'float' = 0.0) (to call the implementation directly, import granular; granular.cone_profile_px(u, H_px: 'float', phi_deg: 'float', toe_round_px: 'float' = 0.0, apex_blunt_px: 'float' = 0.0); from the registry, opsdrive.get("cone_profile_px"))

Usage

Cross-section c(u) [px] of the cone's generatrix (u = distance from the axis [px]).

The base is c = max(0, H − u tan φ). apex_blunt_px = radius of the arc inscribed at the apex (removes material; centre at (0, H − r/cos φ), tangent point u = r sin φ). toe_round_px = radius of the arc filling the concave foot (adds material; centre on the air side (x_t, r), x_t = R + r tan(φ/2), tangent point u = x_t − r sin φ) —— both are tangent-continuous (derivation: at the tangent point the heights on both sides agree, r(1 − cos φ) at the foot and H − r sin²φ / cos φ at the apex). Raises ValueError: the two arcs overlap (the peak is too small).

Empty input (u with 0 elements) raises ValueError.

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)

• gallery_drive_soil_tactile — py -3.11 examples/gallery_drive_soil_tactile.py

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

flight_vacuum · magnus_lift_coefficient · drag_coefficient_sphere · restitution_from_apexes · restitution_from_intervals · fit_parabola · flight_fit · fit_aero

Same category (granular)

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


*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.