LogarithmicScale

class

class LogarithmicScale(
    min_val: ScaleLimitSpec,
    max_val: ScaleLimitSpec,
    base: ScaleBaseSpec = math.e,
    bins: BinCountSpec = MAX_BINS,
    use_bin_zero: bool = False,
)

Bases: Scale

Categories: dq-classifier

A scale whose bin edges are spaced logarithmically over [min_val, max_val] (used with ScaleCategorizer).

Examples

Bins that widen logarithmically -- useful for long-tailed values:

ScaleCategorizer(
    ["amount"],
    scale=LogarithmicScale(1.0, 1000.0, base=10.0, bins=3),
)

Parameters

parameter

min_valScaleLimitSpec (StrictInt | StrictFloat)

Lowest value of the scale; an int or float.

parameter

max_valScaleLimitSpec (StrictInt | StrictFloat)

Highest value of the scale; strictly greater than min_val.

parameter

baseScaleBaseSpec (StrictFloat)

Base of the logarithm; a float greater than 0 (default e).

parameter

binsBinCountSpec (StrictInt)

Number of bins; a whole number from 1 to 100 (default 100).

parameter

use_bin_zerobool

If False, the minimum value belongs to the first bin; if True, min_val gets its own bin 0.