fit_utils.py

fit_utils.py contains the package’s weighted linear fit and its associated return type. It is the densest module in the project because it combines statistics, input validation, and optional plotting, while also reusing the style system defined 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

What it does

• validate x, y, sigma_y, and optionally sigma_x

• validate decimals, tol, and max_iter

• estimate slope and intercept with weighted least squares

• 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