Lazylinop
Lazylinop is a python toolbox to ease and accelerate computations with ("matrix-free") linear operators. It provides glue to combine linear operators as easily as NumPy arrays, PyTorch/CuPy compatibility, standard signal/image processing linear operators, as well as advanced tools to approximate large matrices by efficient butterfly operators.
A LazyLinOp is a high-level linear operator based on an arbitrary underlying implementation, such as:
- custom Python functions,
- a [NumPy array](https://numpy.org/doc/stable/reference/generated/numpy.array.html),
- a [SciPy matrix](https://docs.scipy.org/doc/scipy/reference/sparse.html),
- a [CuPy array](https://docs.cupy.dev/en/stable/reference/generated/cupy.array.html),
- a [torch tensor](https://docs.pytorch.org/docs/stable/tensors.html),
- a [Faust](https://faustgrp.gitlabpages.inria.fr/faust/last-doc/html/classpyfaust_1_1Faust.html) object,
- any Python linear operator.
Thanks to the Lazylinop API, this operator can be easily manipulated, transformed or aggregated with other linear operators to form more complex LazyLinOp objects.
Thus, many operations are available such as the addition, concatenation, adjoint etc.
These operations are all ruled by the lazy paradigm: their evaluation is delayed until the resulting LazyLinOp is actually applied to a vector (or to a collection of vectors, seen as a matrix).
Get started with lazylinop
Run the following command to install the lazylinop package from PyPI:
pip install lazylinop
Run the following commands to install from conda:
conda config --add channels conda-forge
conda config --add channels lazylinop
conda install lazylinop
First steps
Build 2D FFT from 1D FFT and Kronecker product:
from lazylinop.signal import fft
from lazylinop.basicops import kron
fft2d = kron(fft(N), fft(N))
x = np.random.randn(fft2d.shape[1])
y = fft2d @ x
Build circular convolution from 1D FFT:
from lazylinop.signal import fft
from lazylinop.basicops import diag
DFT = fft(N) * np.sqrt(N)
D = diag(DFT @ filter, k=0)
L = (DFT / N).H @ D @ DFT
Authors
- Pascal Carrivain
- Simon Delamare
- Hakim Hadj-Djilani
- Remi Gribonval
Contribute to lazylinop
You can contribute to lazylinop with bug report, feature request and merge request.
Useful links
- Link to the documentation: Gitlab pages
Running unit tests
cd tests
python3 -m unittest TestLazyLinOp.py
python3 -m unittest TestSignal.py
4 maintainers
Release files for lazylinop 1.24.19
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| lazylinop-1.24.19-py3-none-any.whl | Python 3 | none | any | Details |
Release files / lazylinop-1.24.19-py3-none-any.whl
| Download URL | lazylinop-1.24.19-py3-none-any.whl |
|---|---|
| Size | 340.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c3c161f7fa088645e57145e879c8478b626506aaecdb12e4b8a34aeab14f81a2
|
|
BLAKE2b-256 checksum How to use checksums |
dc23f0c4bb624b1b7cd98aaec6b7455b0a5c9b47135822e4cb256c38b9b32cca
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.5
|
