khisto.core.compute_histograms

khisto.core.compute_histograms(x: NDArray[np.float64]) → list[HistogramResult]

Compute optimal histogram of an array using khisto CLI binary input.

Note

Khiops bins are left-open and right-closed, (lower, upper], unlike NumPy bins which are left-closed and right-open, [lower, upper).

Parameters:

xNDArray[np.float64]

Array of numeric values. Only 1-dimensional arrays are supported. Missing values (NaN) are filtered out.

Returns:

list[HistogramResult]

A list of HistogramResult, one per granularity level, sorted from coarsest to finest.

Raises:

RuntimeError

If khisto CLI execution fails or returns invalid output.

ValueError

If input array is empty after filtering.