brushline.monitoring.recalibration

Observation-driven state recalibration.

class brushline.monitoring.recalibration.PriorState(*, segment_id: str, probabilities: dict[str, float], confidence: Annotated[float, Ge(ge=0), Le(le=1)], parameter: Annotated[float, Gt(gt=0)] = 1.0)[source]

Bases: BaseModel

Prior class distribution.

model_config = {'extra': 'forbid', 'frozen': True}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class brushline.monitoring.recalibration.RecalibrationObservation(*, observed_class: str, confidence: Annotated[float, Ge(ge=0), Le(le=1)], latency_days: Annotated[int, Ge(ge=0)] = 0)[source]

Bases: BaseModel

One observation for recalibration.

model_config = {'extra': 'forbid', 'frozen': True}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class brushline.monitoring.recalibration.RecalibrationConfig(*, observation_weight: Annotated[float, Ge(ge=0), Le(le=1)] = 0.5, parameter_weight: Annotated[float, Ge(ge=0), Le(le=1)] = 0.25, model_version: str = 'brushline.low-vegetation.prototype.v0')[source]

Bases: BaseModel

Recalibration settings.

model_config = {'extra': 'forbid', 'frozen': True}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class brushline.monitoring.recalibration.RecalibratedState(*, schema_version: Literal['brushline.recalibration.v1'] = 'brushline.recalibration.v1', segment_id: str, posterior: dict[str, float], confidence: Annotated[float, Ge(ge=0), Le(le=1)], parameter: Annotated[float, Gt(gt=0)], observation_count: Annotated[int, Ge(ge=0)], model_version: str, created_utc: datetime)[source]

Bases: BaseModel

Calibrated state and model update record.

model_config = {'extra': 'forbid', 'frozen': True}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

brushline.monitoring.recalibration.recalibrate(prior: PriorState, observations: list[RecalibrationObservation], config: RecalibrationConfig | None = None, created_utc: datetime | None = None) → RecalibratedState[source]

Update class probabilities, uncertainty, and a model parameter.

Parameters:
Returns:

RecalibratedState – Posterior and model update.