Skip to content

capturegraph.scheduling.energy.gaussian #

Gaussian Energy Function#

Provides a Gaussian kernel for converting distances to energy values. Sessions within sigma distance have significant mutual influence.

gaussian(sigma) #

Create a Gaussian energy function with the given bandwidth.

The Gaussian kernel provides smooth distance-to-energy conversion: energy(d) = exp(-d² / σ²)

Properties
  • energy(0) = 1.0 (identical points have maximum energy)
  • energy(σ) ≈ 0.368 (at sigma distance, ~37% energy remains)
  • energy(2σ) ≈ 0.018 (at twice sigma, energy is nearly zero)

Parameters:

Name Type Description Default
sigma float

Bandwidth parameter controlling how far influence extends. Smaller sigma = more local influence, larger sigma = wider influence.

 required

Returns:

Type Description
Callable[[float], float]

A function distance -> energy for use with select_sessions.
Source code in capturegraph-lib/capturegraph/scheduling/energy/gaussian.py 
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
def gaussian(sigma: float) -> Callable[[float], float]:
    """Create a Gaussian energy function with the given bandwidth.

    The Gaussian kernel provides smooth distance-to-energy conversion:
    `energy(d) = exp(-d² / σ²)`

    Properties:
        - energy(0) = 1.0 (identical points have maximum energy)
        - energy(σ) ≈ 0.368 (at sigma distance, ~37% energy remains)
        - energy(2σ) ≈ 0.018 (at twice sigma, energy is nearly zero)

    Args:
        sigma: Bandwidth parameter controlling how far influence extends.
            Smaller sigma = more local influence, larger sigma = wider influence.

    Returns:
        A function `distance -> energy` for use with `select_sessions`.
    """
    return lambda d: np.exp(-np.square(d / sigma))