# sdr
<div align=center>
<a href="https://pypi.org/project/sdr"><img src="https://img.shields.io/pypi/v/sdr"></a>
<a href="https://pypi.org/project/sdr"><img src="https://img.shields.io/pypi/pyversions/sdr"></a>
<a href="https://pypi.org/project/sdr"><img src="https://img.shields.io/pypi/wheel/sdr"></a>
<a href="https://pypistats.org/packages/sdr"><img src="https://img.shields.io/pypi/dm/sdr"></a>
<a href="https://pypi.org/project/sdr"><img src="https://img.shields.io/pypi/l/sdr"></a>
<a href="https://twitter.com/sdr_py"><img src="https://img.shields.io/static/v1?label=follow&message=@sdr_py&color=blue&logo=twitter"></a>
</div>
<div align=center>
<a href="https://github.com/mhostetter/sdr/actions/workflows/docs.yaml"><img src="https://github.com/mhostetter/sdr/actions/workflows/docs.yaml/badge.svg"></a>
<a href="https://github.com/mhostetter/sdr/actions/workflows/lint.yaml"><img src="https://github.com/mhostetter/sdr/actions/workflows/lint.yaml/badge.svg"></a>
<a href="https://github.com/mhostetter/sdr/actions/workflows/build.yaml"><img src="https://github.com/mhostetter/sdr/actions/workflows/build.yaml/badge.svg"></a>
<a href="https://github.com/mhostetter/sdr/actions/workflows/test.yaml"><img src="https://github.com/mhostetter/sdr/actions/workflows/test.yaml/badge.svg"></a>
<a href="https://codecov.io/gh/mhostetter/sdr"><img src="https://codecov.io/gh/mhostetter/sdr/branch/main/graph/badge.svg?token=3FJML79ZUK"></a>
</div>
The `sdr` library is a Python 3 package for software-defined radio (SDR).
The goal of `sdr` is to provide tools to design, analyze, build, and test digital communication systems
in Python. The library relies on and is designed to be interoperable with NumPy, SciPy, and Matplotlib.
Performance is also very important. So, where possible, Numba is used to accelerate computationally-intensive
functions.
Additionally, the library aims to replicate relevant functionality from MATLAB's Communications and
DSP Toolboxes.
We are progressively adding functionality to the library. If there is something you'd like to see included
in `sdr`, please open an issue on GitHub.
> Enjoying the library? Give us a :star: on [GitHub](https://github.com/mhostetter/sdr)!
## Documentation
The documentation for `sdr` is located at <https://mhostetter.github.io/sdr/latest/>.
## Installation
The latest version of `sdr` can be installed from [PyPI](https://pypi.org/project/sdr/) using `pip`.
```console
python3 -m pip install sdr
```
## Features
View all available classes and functions in the [API Reference](https://mhostetter.github.io/sdr/latest/api/dsp/).
- **Digital signal processing**: Finite impulse response (FIR) filter, FIR filter design,
infinite impulse response (IIR) filter, polyphase interpolator, polyphase decimator, polyphase resampler,
polyphase channelizer, Farrow arbitrary resampler, fractional delay FIR filter, FIR moving average,
FIR differentiator, IIR integrator, IIR leaky integrator, complex mixing, real/complex conversion.
- **Sequences**: Barker, Hadamard, Walsh, Zadoff-Chu.
- **Modulation**: Phase-shift keying (PSK), $\pi/M$ PSK, offset QPSK, rectangular pulse shape, half-sine pulse shape,
raised cosine pulse shape, root raised cosine pulse shape, Gaussian pulse shape, binary and Gray symbol mapping,
differential encoding.
- **Synchronization**: Numerically-controlled oscillator (NCO), loop filter, closed-loop phase-locked loop (PLL)
analysis, automatic gain control (AGC), phase error detector (PEDs).
- **Measurement**: Energy, power, voltage, Euclidean distance, Hamming distance, bit/symbol error rate,
error vector magnitude (EVM).
- **Conversions**: Between linear units and decibels. Between $E_b/N_0$, $E_s/N_0$, and $S/N$.
- **Simulation**: Binary symmetric channel (BSC), binary erasure channel (BEC), discrete memoryless channel (DMC),
additive white Gaussian noise (AWGN), frequency offset, sample rate offset, IQ imbalance.
- **Link budgets**: Channel capacity, free-space path loss, antenna gain.
- **Data manipulation**: Packing and unpacking binary data, hexdump of binary data.
- **Plotting**: Time-domain, raster, periodogram, spectrogram, constellation, symbol map, eye diagram,
bit error rate (BER), symbol error rate (SER), impulse response, step response, magnitude response, phase response,
phase delay, group delay, and zeros/poles.
## Examples
There are detailed examples published at <https://mhostetter.github.io/sdr/latest/examples/pulse-shapes/>.
The Jupyter notebooks behind the examples are available for experimentation in `docs/examples/`.
Raw data
{
"_id": null,
"home_page": "",
"name": "sdr",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "software-defined radio,sdr,digital communications,wireless communications,digital signal processing,dsp,modulation,demodulation,modem,forward error correction,numpy",
"author": "",
"author_email": "Matt Hostetter <matthostetter@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/76/c7/7b1d02c674fdb199774cf0ccfae2f0745b5f1319f55fa87d599b063fd962/sdr-0.0.16.tar.gz",
"platform": null,
"description": "# sdr\n\n<div align=center>\n <a href=\"https://pypi.org/project/sdr\"><img src=\"https://img.shields.io/pypi/v/sdr\"></a>\n <a href=\"https://pypi.org/project/sdr\"><img src=\"https://img.shields.io/pypi/pyversions/sdr\"></a>\n <a href=\"https://pypi.org/project/sdr\"><img src=\"https://img.shields.io/pypi/wheel/sdr\"></a>\n <a href=\"https://pypistats.org/packages/sdr\"><img src=\"https://img.shields.io/pypi/dm/sdr\"></a>\n <a href=\"https://pypi.org/project/sdr\"><img src=\"https://img.shields.io/pypi/l/sdr\"></a>\n <a href=\"https://twitter.com/sdr_py\"><img src=\"https://img.shields.io/static/v1?label=follow&message=@sdr_py&color=blue&logo=twitter\"></a>\n</div>\n\n<div align=center>\n <a href=\"https://github.com/mhostetter/sdr/actions/workflows/docs.yaml\"><img src=\"https://github.com/mhostetter/sdr/actions/workflows/docs.yaml/badge.svg\"></a>\n <a href=\"https://github.com/mhostetter/sdr/actions/workflows/lint.yaml\"><img src=\"https://github.com/mhostetter/sdr/actions/workflows/lint.yaml/badge.svg\"></a>\n <a href=\"https://github.com/mhostetter/sdr/actions/workflows/build.yaml\"><img src=\"https://github.com/mhostetter/sdr/actions/workflows/build.yaml/badge.svg\"></a>\n <a href=\"https://github.com/mhostetter/sdr/actions/workflows/test.yaml\"><img src=\"https://github.com/mhostetter/sdr/actions/workflows/test.yaml/badge.svg\"></a>\n <a href=\"https://codecov.io/gh/mhostetter/sdr\"><img src=\"https://codecov.io/gh/mhostetter/sdr/branch/main/graph/badge.svg?token=3FJML79ZUK\"></a>\n</div>\n\nThe `sdr` library is a Python 3 package for software-defined radio (SDR).\n\nThe goal of `sdr` is to provide tools to design, analyze, build, and test digital communication systems\nin Python. The library relies on and is designed to be interoperable with NumPy, SciPy, and Matplotlib.\nPerformance is also very important. So, where possible, Numba is used to accelerate computationally-intensive\nfunctions.\n\nAdditionally, the library aims to replicate relevant functionality from MATLAB's Communications and\nDSP Toolboxes.\n\nWe are progressively adding functionality to the library. If there is something you'd like to see included\nin `sdr`, please open an issue on GitHub.\n\n> Enjoying the library? Give us a :star: on [GitHub](https://github.com/mhostetter/sdr)!\n\n## Documentation\n\nThe documentation for `sdr` is located at <https://mhostetter.github.io/sdr/latest/>.\n\n## Installation\n\nThe latest version of `sdr` can be installed from [PyPI](https://pypi.org/project/sdr/) using `pip`.\n\n```console\npython3 -m pip install sdr\n```\n\n## Features\n\nView all available classes and functions in the [API Reference](https://mhostetter.github.io/sdr/latest/api/dsp/).\n\n- **Digital signal processing**: Finite impulse response (FIR) filter, FIR filter design,\n infinite impulse response (IIR) filter, polyphase interpolator, polyphase decimator, polyphase resampler,\n polyphase channelizer, Farrow arbitrary resampler, fractional delay FIR filter, FIR moving average,\n FIR differentiator, IIR integrator, IIR leaky integrator, complex mixing, real/complex conversion.\n- **Sequences**: Barker, Hadamard, Walsh, Zadoff-Chu.\n- **Modulation**: Phase-shift keying (PSK), $\\pi/M$ PSK, offset QPSK, rectangular pulse shape, half-sine pulse shape,\n raised cosine pulse shape, root raised cosine pulse shape, Gaussian pulse shape, binary and Gray symbol mapping,\n differential encoding.\n- **Synchronization**: Numerically-controlled oscillator (NCO), loop filter, closed-loop phase-locked loop (PLL)\n analysis, automatic gain control (AGC), phase error detector (PEDs).\n- **Measurement**: Energy, power, voltage, Euclidean distance, Hamming distance, bit/symbol error rate,\n error vector magnitude (EVM).\n- **Conversions**: Between linear units and decibels. Between $E_b/N_0$, $E_s/N_0$, and $S/N$.\n- **Simulation**: Binary symmetric channel (BSC), binary erasure channel (BEC), discrete memoryless channel (DMC),\n additive white Gaussian noise (AWGN), frequency offset, sample rate offset, IQ imbalance.\n- **Link budgets**: Channel capacity, free-space path loss, antenna gain.\n- **Data manipulation**: Packing and unpacking binary data, hexdump of binary data.\n- **Plotting**: Time-domain, raster, periodogram, spectrogram, constellation, symbol map, eye diagram,\n bit error rate (BER), symbol error rate (SER), impulse response, step response, magnitude response, phase response,\n phase delay, group delay, and zeros/poles.\n\n## Examples\n\nThere are detailed examples published at <https://mhostetter.github.io/sdr/latest/examples/pulse-shapes/>.\nThe Jupyter notebooks behind the examples are available for experimentation in `docs/examples/`.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Python package for software-defined radio",
"version": "0.0.16",
"project_urls": {
"Discuss": "https://github.com/mhostetter/sdr/discussions",
"Documentation": "https://mhostetter.github.io/sdr/latest/",
"Homepage": "https://github.com/mhostetter/sdr",
"Issues": "https://github.com/mhostetter/sdr/issues",
"Source": "https://github.com/mhostetter/sdr",
"Twitter": "https://twitter.com/sdr_py"
},
"split_keywords": [
"software-defined radio",
"sdr",
"digital communications",
"wireless communications",
"digital signal processing",
"dsp",
"modulation",
"demodulation",
"modem",
"forward error correction",
"numpy"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "bac967f9db736f9a32b340dff1580b0b7a2f1bd43e90b0898a76ff08e8a91b29",
"md5": "9cacf302eee55f7f1cb0f85d6885705b",
"sha256": "d816d8daa24b8538cc13f2e97812722a868d86fb890673dd486efc72ddc7342e"
},
"downloads": -1,
"filename": "sdr-0.0.16-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9cacf302eee55f7f1cb0f85d6885705b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 137025,
"upload_time": "2024-03-03T21:58:47",
"upload_time_iso_8601": "2024-03-03T21:58:47.601598Z",
"url": "https://files.pythonhosted.org/packages/ba/c9/67f9db736f9a32b340dff1580b0b7a2f1bd43e90b0898a76ff08e8a91b29/sdr-0.0.16-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "76c77b1d02c674fdb199774cf0ccfae2f0745b5f1319f55fa87d599b063fd962",
"md5": "7472068248fa8fa73c6a39b1aee26207",
"sha256": "ad839aebbfdb21f16f06da1783cd2c3dd0cbea962c56da16606851031f7730a2"
},
"downloads": -1,
"filename": "sdr-0.0.16.tar.gz",
"has_sig": false,
"md5_digest": "7472068248fa8fa73c6a39b1aee26207",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 6019013,
"upload_time": "2024-03-03T21:58:49",
"upload_time_iso_8601": "2024-03-03T21:58:49.713775Z",
"url": "https://files.pythonhosted.org/packages/76/c7/7b1d02c674fdb199774cf0ccfae2f0745b5f1319f55fa87d599b063fd962/sdr-0.0.16.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-03 21:58:49",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mhostetter",
"github_project": "sdr",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "sdr"
}