Digital-rf

====================

**Added:**

* Added start sample to debug printing of 'digital_rf_channel_sink' to complement the debug printing of rx_time tags.

**Changed:**

* The Digital RF (Channel) Source/Sink blocks for gnuradio-companion have been modified to accept 'raw' input for the start and end identifiers instead of strings, allowing variables to be used. Existing flowgraphs may require quotes to be placed around existing string input.

**Fixed:**

* The drf_watchdog module is now compatible with watchdog 0.10+. There may be a slight change of behavior (duplicate or out of order events) but the mirror and ringbuffer utilities can handle it gracefully.
* Better error message when no samples are specified with drf_plot.py.
* Fix the Digital RF sink blocks and GRC yaml to prevent an empty array for center_frequencies being written as Digital Metadata (currently happens with default GRC block with GNU Radio 3.8).
* Clarified docstrings (and updated to actual modern behavior) for 'start' and 'end' in Digital RF source/sinks.

**Authors:**

* Ryan Volz

====================

**Fixed:**

* Fix to drf_plot.py to ignore negative infinity values when autoscaling.
* Fix thorpluto.py for better compatibility when both the libiio python bindings (iio.py module) and the gr-iio package (either gnuradio.iio or just iio) are installed.

**Authors:**

* Ryan Volz

====================

**Fixed:**

* Fix matched filtering in drf_plot.py to run with Python 3 and use the correct code (not reversed). Also shift the filtered result so that ranges are the same before and after filtering.
* Fix RTI and STI plots in drf_plot.py tool for Python 3. Once again the assumption of an integer result from division rears its ugly head.

====================

**Fixed:**

* Fix an error seen when deleting the Digital RF Reader object (such as on interpreter shutdown) caused by trying to close the cached HDF5 file handle.
* Fix another Python 3 issue with the plotting tools caused by getting a float from division when an integer is required.
* Fix automatic plot scaling in the plotting tools to handle data with NaNs.

**Authors:**

* Ryan Volz

====================

**Fixed:**

* Fix drf_plot.py, drf_sti.py, drf_cross_sti.py, and drf_sound.py to be compatible with Python 3 by removing use of string module functions and listing dict keys objects.
* Fix the plotting tools to be compatible with Matplotlib 3 by removing use of hold functions on axes instances.
* The thorpluto.py script has been fixed to work with both the released gr-iio version (compatible with GNU Radio 3.7) and the unreleased gr-iio version that is compatible with GNU Radio 3.8.
* Fix an error with thorpluto.py when no mainboard is specified (it should have used the first available.)

**Authors:**

* Ryan Volz

====================

**Added:**

* Add the "thorpluto" tool for writing data from the ADALM PLUTO using GNU Radio. This script requires gr-iio to run. Note that this script duplicates some of the functionality of the existing "thor" recorder script, and may be subsumed or arguments may change in a future consolidation.
* Option to use the CMake variable ``Python_EXECUTABLE`` to manually set the path to the Python interpreter (useful if autodetection fails or Python 2 is preferred).
* Add ``stop_on_time_tag`` parameter to the Digital RF Sink blocks, useful when time tags only happen for USRP dropped samples but the 'rx_time' tag value falsely indicates no drop.
* Add the "thorosmo" tool for writing data from osmosdr-supported receivers using GNU Radio, and add the "uhdtodrf" tool for writing data from UHD devices using the UHD Python API *without* using GNU Radio. Note that these scripts duplicate some of the functionality of the existing "thor" recorder script, and they may be subsumed or their arguments may change in a future consolidation.
* Add option to force polling for watchdog functions (ringbuffer, mirror, etc.), which is useful as a fallback when the default watchdog observer fails silently.

**Changed:**

* The ``thor.py`` script's ``stop_on_dropped`` parameter now includes the new ``stop_on_time_tag`` behavior.

**Fixed:**

* Fix an IndexError when using `stop_on_skipped` or `stop_on_time_tag` with `gr_digital_rf.digital_rf_channel_sink`. If the skip/tag happened with only one data block to be written, the IndexError would trigger upon trying to index to a second data block.