cvx-linalg 0.5.1

Linear algebra utilities for portfolio optimization

cvx-linalg

Linear algebra utilities for portfolio optimization, part of the jebel-quant ecosystem.

Installation

pip install cvx-linalg

Usage

from cvx.linalg import (
    a_norm, cholesky, ewm_covariance,
    inv_a_norm, is_positive_definite, pca, rand_cov, solve, valid,
)

Functions

• a_norm(vector, matrix=None) — Euclidean norm or NaN-aware matrix norm
• cholesky(cov, rhs=None) — Upper triangular Cholesky factor R such that R.T @ R = cov; when rhs is given, solves cov @ x = rhs (falls back to LU for non-positive-definite matrices)
• ewm_covariance(data, assets, index_col, window, is_halflife, warmup) — Exponentially weighted covariance matrices from a Polars DataFrame
• inv_a_norm(vector, matrix=None) — Euclidean norm or inverse NaN-aware matrix norm
• is_positive_definite(matrix) — Return True if the matrix is symmetric positive-definite
• pca(returns, n_components) — Principal Component Analysis via SVD
• rand_cov(n, seed) — Random positive semi-definite covariance matrix
• solve(matrix, rhs, cond_threshold=1e12) — Solve a linear system restricted to valid rows/columns; NaN entries are returned for invalid positions
• valid(matrix) — Return a boolean mask and valid submatrix by removing rows/columns with non-finite diagonal entries

Exceptions & Warnings

• DimensionMismatchError — Raised when vector length does not match matrix dimension
• IllConditionedMatrixWarning — Emitted when the condition number exceeds a configurable threshold
• NegativeWarmupError — Raised when a negative warmup period is passed to ewm_covariance
• NonSquareMatrixError — Raised when a square matrix is required but the input is not square
• SingularMatrixError — Raised when a matrix is numerically singular
• check_and_warn_condition(matrix, threshold) — Emit IllConditionedMatrixWarning when the condition number exceeds the threshold

Types

• Matrix — Type alias for numpy.ndarray with float64 dtype