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

1"""Operator layer for the Critical Line Algorithm. 

2 

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: 

10 

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""" 

21 

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) 

33 

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]