(Available on PyPI)
Author: Josiah W. Smith, Ph.D.
A lightweight complex-valued neural network package built on PyTorch.
This is a package built on PyTorch with the intention of implementing light-weight interfaces for common complex-valued neural network operations and architectures. Notably, we include efficient implementations for linear, convolution, and attention modules in addition to activation functions and normalization layers such as batchnorm and layernorm.
Although there is an emphasis on 1-D data tensors, due to a focus on signal processing, communications, and radar data, many of the routines are implemented for 2-D and 3-D data as well.
See CHANGELOG.md for the full release history. Version 2.0
brings major feature-parity expansion (RNN/LSTM, Transformer, ARD/Variational
Dropout, masked layers, transforms, signal, datasets, models subpackages); see
the changelog for the breaking changes around MultiheadAttention and
default bias=True.
Live docs: https://josiahwsmith10.github.io/complextorch/latest/ — including
an executable Getting Started notebook
and a full API reference auto-generated from docstrings. The accompanying
paper is at docs/complextorch_paper.pdf.
This library requires numpy and PyTorch.PyTorch should be installed to your environment using the compute platform (CPU/GPU) settings for your machine. PyTorch will not be automatically installed with the installation of complextorch and MUST be installed manually by the user.
IMPORTANT: Prior to installation, install PyTorch to your environment using your preferred method using the compute platform (CPU/GPU) settings for your machine.
Using pip
pip install complextorchFrom the source:
git clone https://github.com/josiahwsmith10/complextorch.git
cd complextorch
pip install -r requirements.txt
pip install . --use-pep517import torch
import complextorch as cT
x = torch.randn(64, 5, 7, dtype=torch.cfloat)
model = cT.nn.Conv1d(5, 16, kernel_size=3)
y = model(x)The test suite mirrors complextorch/ 1:1 under tests/ and covers every public class and helper. CI enforces 100% line coverage on Python 3.10 / 3.11 / 3.12 — any PR that drops coverage fails automatically.
pip install '.[test]' # pytest, pytest-cov, pytest-xdist, hypothesis
pytest # auto-parallel (-n auto) from pyproject
pytest --cov=complextorch --cov-report=term-missing --cov-fail-under=100 # mirror CI exactly
pytest --cov=complextorch --cov-report=html && open htmlcov/index.html # browse uncovered linesWhen adding a new module, add a matching tests/.../test_<module>.py. Fast/Slow numerical equivalence checks share weights via load_state_dict; loss tests sweep the reduction matrix; round-trip invariants (Fast/Slow, polar, casting, FFT) live under tests/invariants/ and use Hypothesis. Prefer per-line # pragma: no cover over whole-function exclusions so dead code stays visible.