Skip to main content

SIGINT

License: MIT basic-tests PyPI version

Explore signal intelligence techniques with runnable Python simulations. Each example generates a signal, analyzes it, and prints estimates. Add --show-plots to inspect the signals visually. No test runner is needed.

Get started

Install this checkout in a virtual environment (includes NumPy, SciPy, and Matplotlib):

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -e .
sigint list
sigint run basic --show-plots

On Windows, activate with .venv\Scripts\activate instead.

Run examples

sigint run tdoa
sigint run gaussian-jitter --show-plots
sigint run two-pulse-trains --show-plots

Without --show-plots, examples print results and finish without opening windows. Interactive plots require a graphical desktop and a Matplotlib GUI backend; close each plot window to continue through the example.

Example What it demonstrates
basic Carrier-modulated pulse train, matched filter, and pulse repetition interval (PRI) estimation
amplitude-modulation Pulses with varying amplitudes and autocorrelation analysis
chirped-pulses Matched filtering of linear chirps
irregular-pulses Pulse timing with uniform jitter
gaussian-jitter Gaussian timing jitter and PRI statistics with outlier removal
multi-emitter-jitter Two emitters with noise and timing jitter
noisy-multi-emitter Two fixed-PRI emitters in noise
tdoa Time difference of arrival between two receivers
two-pulse-trains Fundamental PRIs of two overlapping pulse trains

You can also use python -m sigint_examples in place of sigint:

python -m sigint_examples list
python -m sigint_examples run chirped-pulses --show-plots

The original sigint-workflow --show-plots and python -m sigint_examples.basic_workflow --show-plots commands still work.

Use from Python

The workflows live in sigint_examples/examples/, separate from their tests. For example:

from sigint_examples.examples.gaussian_jittered import run

results = run(show_plots=False)
print(results["mean_PRI_clean"])  # seconds

Simulation parameters are defined near the start of each workflow. These are introductory estimators; noise, jitter, harmonics, and sample resolution can affect the estimates. Time estimates use seconds internally, except the multi-emitter fundamentals arrays, which use microseconds. CLI output labels its units.

Development

Tests check the same workflows that the CLI runs:

python -m pip install -e '.[dev]'
python -m pytest

For optional visual debugging, use python -m pytest --show-plots. To exercise plotting on a headless machine, use MPLBACKEND=Agg python -m pytest --show-plots.

Metadata

Release files for sigint-examples 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sigint-examples 0.2.0
File Size Uploaded Provenance Actions
sigint_examples-0.2.0.tar.gz 17.9 kB Without provenance Details for sigint_examples-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for sigint-examples 0.2.0
File Interpreter ABI Platform Actions
sigint_examples-0.2.0-py3-none-any.whl Python 3 none any Details for sigint_examples-0.2.0-py3-none-any.whl

Total release size: 39.4 kB

Release files / sigint_examples-0.2.0.tar.gz

Download URL sigint_examples-0.2.0.tar.gz
Size 17.9 kB
Tags Source
SHA-256 checksum
How to use checksums
6f78ce08662c93e6bac17060a67488beacaec95b5862870e996ac5e825106dd3
BLAKE2b-256 checksum
How to use checksums
d2ee407a86d8e260a1f40d4871a4c70185e7c9d3707100978266f45432326b92
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.6

Release files / sigint_examples-0.2.0-py3-none-any.whl

Download URL sigint_examples-0.2.0-py3-none-any.whl
Size 21.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8b3d9371fe64071394fd87b8171bd77db8614060a47fd3261827430708532702
BLAKE2b-256 checksum
How to use checksums
31f82ac8e80076856b9c29e0946b84079f07e1466fcb210ee16da83b843f6097
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.6

Security for sigint-examples 0.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page