For an example of how to use pyspuc, please take a look at the QPSK example.
In this example. Most of the C++ code details are buried and it is possible to examine many of the aspects of the simulation through python. The example requires scipy and matplotlib. Using these one can examine the received signal, the ADC samples, the demodulated signal, the carrier and symbol tracking loops, etc. Also one can enable/disable loops and change signal to noise ratios, etc. - All without having to compile any code. To see what signals are available to view/access through python, please look at the respective documentation of the C++ code. If one simply runs this program using "python qpsk_main.py", you will get print outs of the bit error rate as the simulation proceeds.