isarpy

Inverse Synthetic Aperture Radar processing library in Python

Features

• 1-D convolution (convolve_1d) – FFT, overlap-add, or direct methods.
• 2-D convolution (convolve_2d) – FFT-based for range-Doppler maps.
• Matched filter / pulse compression (matched_filter) – cross-correlation with arbitrary reference waveforms.

Installation

# runtime only
pip install isarpy

# with dev tools (pytest, ruff)
pip install "isarpy[dev]"

With uv:

uv add isarpy

Quick start

import numpy as np
from isarpy.core import matched_filter

# LFM chirp reference
ref = np.exp(1j * np.pi * np.arange(64) ** 2 / 64)

# received signal (noisy)
signal = np.zeros(256, dtype=complex)
signal[50:114] = ref                        # chirp at delay 50

compressed = matched_filter(signal, ref, mode="same")
peak = np.argmax(np.abs(compressed))
print(f"Detected target at range-bin {peak}")  # → ~82

Running tests

# with uv
uv run pytest

# or directly
pytest

Project layout

isarpy/
├── src/
│   └── isarpy/
│       ├── __init__.py
│       └── core/
│           ├── __init__.py
│           └── convolution.py
├── tests/
│   ├── conftest.py
│   └── core/
│       └── test_convolution.py
├── notebooks/
├── pyproject.toml
└── LICENSE

Contributing

1. Fork the repository.
2. Create a feature branch: git checkout -b feat/my-feature.
3. Run uv run ruff check src tests and uv run pytest before pushing.
4. Open a pull request.

License

Apache 2.0 – see LICENSE.