tracking_benchmark Namespace Reference

Classes
class	TrackingBenchmark

Functions
float	wilson_interval (int k, int n)

Detailed Description

Tracking performance benchmark metrics for straw tube spectrometer.

Computes track finding efficiency, clone rate, ghost rate, and resolution
metrics by comparing MC truth with reconstructed tracks. Designed to
establish a GenFit baseline and later measure ACTS performance.

Function Documentation

wilson_interval()

float tracking_benchmark.wilson_interval	(	int	k,
		int	n
	)

Wilson score interval half-width for a binomial proportion.

Parameters
----------
k : int
    Number of successes.
n : int
    Number of trials.

Returns
-------
float
    Half-width of the 68% Wilson score interval (~1 sigma).

Definition at line 23 of file tracking_benchmark.py.

def wilson_interval(k: int, n: int) -> float:
    """Wilson score interval half-width for a binomial proportion.
 
    Parameters
    ----------
    k : int
        Number of successes.
    n : int
        Number of trials.
 
    Returns
    -------
    float
        Half-width of the 68% Wilson score interval (~1 sigma).
    """
    if n == 0:
        return 0.0
    z = 1.0  # 1-sigma
    p = k / n
    denom = 1 + z**2 / n
    spread = z * math.sqrt(p * (1 - p) / n + z**2 / (4 * n**2)) / denom
    return spread