fit_utils.py

fit_utils.py contiene il fit lineare 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.

Main imports

• Standard library: dataclasses.dataclass, typing.TYPE_CHECKING

• External libraries: numpy as np, numpy.typing.ArrayLike, numpy.typing.NDArray

• Internal imports from plot_utils: _style_context, _validate_axis_limits, _validate_decimals, _validate_figsize

• Internal imports from stats_utils: _as_float_vector, weighted_mean, covariance, variance

What it exports

• LinearFitResult

• lin_fit, con incertezze assolute o scalate dai residui

What it does

• validate x, y, sigma_y, and optionally sigma_x

• validate decimals, tol, and max_iter

• stimare pendenza e intercetta con minimi quadrati pesati o non pesati

• stimare una scala globale di incertezza dai residui

• update the weights iteratively when uncertainties on x are also present

• compute residuals, chi2, reduced_chi2, correlation, and other diagnostics

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

Related helpers

• _validate_positive_vector

• _validate_positive_scalar

• _validate_max_iter

• _fit_coefficients

• _style_context

• _validate_axis_limits

• _validate_decimals

• _validate_figsize

Detailed pages

• LinearFitResult

• lin_fit