HistogramBin

HistogramBin()

Raw statistics and optional coordinate metadata for one histogram bin.

Member details

Property · read-only

x_min: Optional[float]

Lower coordinate edge, or None for a discrete or overflow bin.

Property · read-only

x_max: Optional[float]

Upper coordinate edge, or None for a discrete or underflow bin.

Property · read-only

bin_id: Optional[int]

Discrete bin identifier, or None for a continuous bin.

Property · read-only

label: Optional[str]

Optional label of a discrete bin.

Property · read-only

entry_count: int

Number of event entries accumulated in this bin.

Property · read-only

sum_weights: float

Sum of per-sample projected weights for this bin.

Property · read-only

sum_weights_squared: float

Sum of squared per-sample projected weights for this bin.

Property · read-only

mitigated_fill_count: int

Number of fills produced by paired boundary-misbinning mitigation.

Method

average(sample_count: int) -> float

Compute this bin's Monte Carlo mean from its raw weight sum.

float

sum_weights / sample_count, or zero when sample_count is zero.

Name	Type	Default	Description
`sample_count`	`int`	`—`	Number of statistically independent samples represented by the histogram.

Method

error(sample_count: int) -> float

Compute the standard error of this bin's Monte Carlo mean.

float

Sample-mean standard error, or zero when it cannot be estimated reliably.

Name	Type	Default	Description
`sample_count`	`int`	`—`	Number of statistically independent samples represented by the histogram.