capturegraph.scheduling.energy

Energy - Distance to Coverage Conversion

Energy functions convert distances into "coverage" or "energy" values used by the Void & Cluster algorithm. High energy means two points are similar (close); low energy means they are different (far).

The Void & Cluster algorithm finds "voids" (low energy regions) to fill and "clusters" (high energy regions) to avoid redundancy.

Available Functions

• gaussian(sigma): Smooth Gaussian falloff, exp(-d²/σ²).
• inverse: Simple 1/d inverse distance.

Example

import capturegraph.scheduling as cgsh

# Create energy function with 2° radius of influence
energy_fn = cgsh.energy.gaussian(sigma=2.0)

energy_fn(0.0)   # → 1.0 (identical points)
energy_fn(2.0)   # → 0.368 (at sigma distance)
energy_fn(10.0)  # → ~0.0 (far apart)

Modules:

Name	Description
gaussian	Gaussian Energy Function
inverse	Inverse Energy Function