Coverage for src/cvxcla/operators/__init__.py: 100%
3 statements
« prev ^ index » next coverage.py v7.17.3, created at 2026-11-17 13:36 +0000
« prev ^ index » next coverage.py v7.17.3, created at 2026-11-17 13:36 +0000
1"""Operator layer for the Critical Line Algorithm.
3The turning-point loop reaches its Hessian (the covariance ``Sigma``, or the Gram
4matrix ``X.T @ X`` for a LASSO / LARS path) through the cvx-linalg
5:class:`~cvx.linalg.SymmetricOperator` protocol: matrix-vector and sub-block
6products, a free-block solve, and a reciprocal-condition check. This package no
7longer defines its own operator classes -- the backends (dense, matrix-free Gram,
8diagonal-plus-low-rank Woodbury, and a maintained-inverse dense variant) live in
9:mod:`cvx.linalg`. What remains here is thin:
11- :data:`QuadraticForm` / :data:`CovarianceOperator`: aliases of
12 :class:`cvx.linalg.SymmetricOperator`, the loop's backend contract.
13- builders (:mod:`cvxcla.operators.builders`) that assemble the right cvx-linalg
14 operator from CLA / LASSO inputs, kept under the familiar ``*Covariance`` names.
15- :func:`bordered_solve` and :func:`cross`, the parametric-path helpers built on
16 the operator protocol, and :func:`orthonormal_rows`, which restates a constraint
17 system in an orthonormal basis of its rows.
18- :data:`RCOND_FLOOR`, the reciprocal-condition threshold below which a free
19 block counts as singular.
20"""
22from ._core import RCOND_FLOOR, CovarianceOperator, QuadraticForm, bordered_solve, cross, orthonormal_rows
23from .builders import (
24 DenseCovariance,
25 FactorCovariance,
26 GramCovariance,
27 IncrementalDenseCovariance,
28 dense_covariance,
29 factor_covariance,
30 gram_covariance,
31 incremental_dense_covariance,
32)
34__all__ = [
35 "RCOND_FLOOR",
36 "CovarianceOperator",
37 "DenseCovariance",
38 "FactorCovariance",
39 "GramCovariance",
40 "IncrementalDenseCovariance",
41 "QuadraticForm",
42 "bordered_solve",
43 "cross",
44 "dense_covariance",
45 "factor_covariance",
46 "gram_covariance",
47 "incremental_dense_covariance",
48 "orthonormal_rows",
49]