Calibrated Public-Report Design

Historically calibrated public-report design orchestration.

class updatesupport.calibrated_design.CalibratedClaimDesignResult(claim_index, calibration, audit, breaking_witness=None)[source]

Bases: object

Selected-report outcome for one historically calibrated claim.

Parameters:
claim_index: int
calibration: HistoricalTVCalibrationReport
audit: ClaimAudit
breaking_witness: MinimumClaimBreakingWitnessReport | None = None
property estimate_name: str
property calibrated_radius: float
property selected_public: tuple[str, ...]
property certified: bool
property breaking_tv_distance: float | None
property breaking_radius_multiple: float | None
as_dict()[source]
Return type:

dict[str, Any]

table_row()[source]

Return a compact row for governance and review tables.

Return type:

dict[str, Any]

class updatesupport.calibrated_design.CalibratedPublicReportDesign(name, period_column, coverage, historical_row_count, current_row_count, candidate_refinements, claim_results, public_design=None, shared_design=None, rollup=None, rollup_anchor_claim_index=None, title='Calibrated Public-Report Design', limitations=())[source]

Bases: ReportArtifactMixin

Calibrated stress, rollup, schema, and breaking-witness design report.

Parameters:
name: str
period_column: str
coverage: float
historical_row_count: int
current_row_count: int
candidate_refinements: tuple[str, ...]
claim_results: tuple[CalibratedClaimDesignResult, ...]
public_design: PublicReportDesign | None = None
shared_design: SharedRepresentationDesign | None = None
rollup: CategoricalRollupDesign | None = None
rollup_anchor_claim_index: int | None = None
title: str = 'Calibrated Public-Report Design'
limitations: tuple[str, ...] = ()
property design_kind: str
property claim_count: int
property certified_claim_count: int
property all_claims_certified: bool
property status: str
property recommended_public: tuple[str, ...] | None
property rollup_applied: bool
property calibrated_radii: tuple[float, ...]
as_dict()[source]
Return type:

dict[str, Any]

to_tables()[source]

Return flattened calibration, design, audit, and witness tables.

Return type:

dict[str, tuple[dict[str, Any], …]]

to_markdown()[source]

Render the end-to-end calibrated design for an analyst review.

Return type:

str

updatesupport.calibrated_design.design_calibrated_public_report(historical_data, current_data, claim_or_portfolio, *, period, period_order=None, coverage=0.9, min_train_transitions=3, calibration_backend='cvxpy', calibration_solver=None, calibration_solver_options=None, candidate_refinements=None, max_added_columns=None, bucket_budget=None, max_evaluations=4096, rollup_column=None, rollup_claim_index=0, rollup_max_groups=None, rollup_max_categories=9, rollup_output_column=None, threshold_margin=1e-08, tolerance=1e-09, title='Calibrated Public-Report Design')[source]

Compose historical TV calibration with public-report design intelligence.

Parameters:
Return type:

CalibratedPublicReportDesign