PySDR Textbook

This repo contains the source content used to generate the textbook, __PySDR: A Guide to SDR and DSP using Python__ , hosted at www.pysdr.org.

Feel free to submit an issue, or even a Pull Request (PR) with fixes or improvements. Those who submit valuable feedback/fixes be permanently added to the acknowledgments section. Not good at Git but have changes to suggest? Feel free to email Marc at pysdr@vt.edu.

Building

Note that the website is now automatically built and deployed with each push/merge into the main branch, using the github action .github/workflows/build-and-deploy.yml and the GitHub pages system for hosting the website.

Ubuntu

sudo apt update
sudo apt install -y texlive-latex-extra pdf2svg
pip install -r requirements.txt
make html
make html-fr
make html-nl
make html-ukraine

In _build there should be an index.html that represents the main page of the site

Note: on one machine I had to add ~/.local/bin to PATH

Windows

(this wont include the French version):

sphinx-build -b html -D imgmath_latex="C:\Program Files\MiKTeX 2.9\miktex\bin\x64\latex.exe" . _build

Creating a PDF Export

Not fully working yet due to gifs

sudo apt-get install -y latexmk
sphinx-build -b latex . _build/latex
make latexpdf
NEED TO REMOVE ALL GIFS FOR IT TO NOT ERROR OUT

Misc

Ideas for future chapters:

• Equalization, would be the last step needed to finish the end-to-end comms link
• Cyclostationary analysis
• OFDM, simulating OFDM and CP, show via Python how it turns freq selective fading into flat fading
• How to create real-time SDR apps with GUIs in Python using pyqt and pyqtgraph, or even just matplotlib with updating
• Python code that lets the Pluto (or RTL-SDR) act as an FM receiver, like with sound output
• End to end example that shows how to detect start of packet and other concepts not covered in RDS chapter

This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License.