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:
BaseModelPrior 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:
BaseModelOne 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:
BaseModelRecalibration 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:
BaseModelCalibrated 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:
prior (PriorState) – Prior.
observations (list of RecalibrationObservation) – Observations.
config (RecalibrationConfig, optional) – Settings.
created_utc (datetime, optional) – Creation time.
- Returns:
RecalibratedState – Posterior and model update.