The origin of this package comes from the writing the book Signals and Systems for Dummies, published by Wiley in 2013. The original module for this book is named ssd.py
. In scikit-dsp-comm
this module is renamed to sigsys.py
to better reflect the fact that signal processing and communications theory is founded in signals and systems, a traditional subject in electrical engineering curricula.
This package is a collection of functions and classes to support signal processing and communications theory teaching and research. The foundation for this package is scipy.signal
. The code in particular currently requires Python >=3.7x
.
There are presently ten modules that make up scikit-dsp-comm:
-
sigsys.py
for basic signals and systems functions both continuous-time and discrete-time, including graphical display tools such as pole-zero plots, up-sampling and down-sampling. -
digitalcomm.py
for digital modulation theory components, including asynchronous resampling and variable time delay functions, both useful in advanced modem testing. -
synchronization.py
which contains phase-locked loop simulation functions and functions for carrier and phase synchronization of digital communications waveforms. -
fec_conv.py
for the generation rate one-half and one-third convolutional codes and soft decision Viterbi algorithm decoding, including soft and hard decisions, trellis and trellis-traceback display functions, and puncturing. -
fir_design_helper.py
which for easy design of lowpass, highpass, bandpass, and bandstop filters using the Kaiser window and equal-ripple designs, also includes a list plotting function for easily comparing magnitude, phase, and group delay frequency responses. -
iir_design_helper.py
which for easy design of lowpass, highpass, bandpass, and bandstop filters using scipy.signal Butterworth, Chebyshev I and II, and elliptical designs, including the use of the cascade of second-order sections (SOS) topology from scipy.signal, also includes a list plotting function for easily comparing of magnitude, phase, and group delay frequency responses. -
multirate.py
that encapsulate digital filters into objects for filtering, interpolation by an integer factor, and decimation by an integer factor. -
coeff2header.py
writeC/C++
header files for FIR and IIR filters implemented inC/C++
, using the cascade of second-order section representation for the IIR case. This last module find use in real-time signal processing on embedded systems, but can be used for simulation models inC/C++
.
Presently the collection of modules contains about 125 functions and classes. The authors/maintainers are working to get more detailed documentation in place.
Documentation is now housed on readthedocs
which you can get to by clicking the docs badge near the top of this README
. Example notebooks can be viewed on GitHub pages. In time more notebook postings will be extracted from Dr. Wickert's Info Center.
The best way to use this package is to clone this repository and then install it.
git clone https://github.com/mwickert/scikit-dsp-comm.git
There are package dependencies for some modules that you may want to avoid. Specifically these are whenever hardware interfacing is involved. Specific hardware and software configuration details are discussed in wiki pages.
For Windows users pip
install takes care of almost everything. I assume below you have Python on your path, so for example with Anaconda, I suggest letting the installer set these paths up for you.
With the terminal in the root directory of the cloned repo perform an editable pip
install using
pip install -e .
The advantage of the editable pip
install is that it is very easy to keep scikit-dsp-comm
up to date. If you know that updates have been pushed to the master branch, you simply go to your local repo folder and
git pull origin master
This will update you local repo and automatically update the Python install without the need to run pip
again. Note: If you have any Python kernels running, such as a Jupyter Notebook, you will need to restart the kernel to insure any module changes get reloaded.