fit_utils.py

fit_utils.py contiene il fit lineare pesato del package e il tipo di ritorno associato. E il modulo piu denso del progetto, perche combina statistica, validazione degli input e plotting opzionale, riusando anche il sistema di stile gia definito in plot_utils.

Import principali

• Standard library: dataclasses.dataclass, typing.TYPE_CHECKING

• Librerie esterne: numpy as np, numpy.typing.ArrayLike, numpy.typing.NDArray

• Import interni da plot_utils: _style_context, _validate_axis_limits, _validate_decimals, _validate_figsize

• Import interni da stats_utils: _as_float_vector, weighted_mean, covariance, variance

Cosa espone

• LinearFitResult

• lin_fit

Di cosa si occupa

• validare x, y, sigma_y e opzionalmente sigma_x

• validare decimals, tol e max_iter

• stimare pendenza e intercetta con minimi quadrati pesati

• aggiornare iterativamente i pesi quando esistono incertezze anche su x

• calcolare residui, chi2, reduced_chi2, correlazione e altre diagnostiche

• creare, se richiesto, una figura matplotlib con pannello del fit e pannello dei residui usando lo stesso sistema di stile di histogram

Helper collegati

• _validate_positive_vector

• _validate_positive_scalar

• _validate_max_iter

• _fit_coefficients

• _style_context

• _validate_axis_limits

• _validate_decimals

• _validate_figsize

Pagine di dettaglio

• LinearFitResult

• lin_fit