raygeo.ops.assembly.wavefront

AdaptiveWavefrontSpec

Parameters for the inside-out adaptive wavefront assembler.

area_tolerance

area_tolerance: float

precision

precision: float

step_over

step_over: float

z

z: float

Functions

adaptive_wavefronts()

adaptive_wavefronts(
    part: ops.part.Part,
    step_over: float = 2,
    z: float = 0,
    area_tolerance: float = 1,
    precision: float = 0,
    cut_feed_rate: int = 1200,
    cut_power: float = 1,
    profile: bool = False,
) -> ops.assembly.AssemblyResult

Inside-out adaptive wavefronts.

Finds the largest inscribed circle inside part's boundary, seeds the cleared area with concentric rings spaced step_over apart, then iteratively expands the frontier outward by step_over, clipping to the boundary. The loop terminates when the newly added area drops below area_tolerance.

Each ring fragment is emitted as MoveTo + LineTo at height z with cut_feed_rate applied.

Parameter	Type	Description
part	ops.part.Part	The part whose stock_region defines the pocket boundary and islands.
step_over	float = 2	Radial expansion per iteration (default 2.0).
z	float = 0	Z height for generated commands (default 0.0).
area_tolerance	float = 1	Minimum area increase to continue (default 1.0).
precision	float = 0	Edge tolerance for frontier simplification and vertex resampling; smaller values produce denser edges (default 0.0 = use internal default).
cut_feed_rate	int = 1200	Feed rate for cutting moves (default 1200).
cut_power	float = 1	Laser power for cutting moves (0.0-1.0, default 1.0).
profile	bool = False	Print a profiling report to stdout (default False).
Returns	ops.assembly.AssemblyResult	An AssemblyResult with wavefront cutting commands.

Adaptive wavefronts expand from the initial cleared disk (blue) to fill the pocket boundary (black)

Adaptive wavefronts in a pocket with three islands — contours wrap around each island as they expand

Adaptive wavefronts in a Y-shaped channel — contours split and propagate along each branch

Adaptive wavefronts in a complex SVG shape — contours adapt to the boundary and wrap around islands