pothosware / pothoswidgets

Graphical widgets to supplement the Pothos GUI

Graphical widgets to supplement the Pothos GUI

Documentation

• https://github.com/pothosware/PothosWidgets/wiki

Dependencies

• Pothos library
• QT5 C++ development libraries and headers

Building

Configure, build, and install with CMake

Licensing information

Use, modification and distribution is subject to the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

pothoswidgets's Issues

fft plotters need a full-scale parameter

Currently fullscale is assumed to be 1.0. To better handle fixed point data (and really anything) there should be a parameter that specifies what is full-scale (defaulting to 1.0).

wave viewer: triggering support

• trigger channel: None, ch0, other
• trigger mode: auto, normal, always
• trigger polarity: pos or neg
• trigger position: X and Y (consider 2d-entry widget)
• trigger properties tab for the above: pothosware/PothosFlow#28

wave viewer - wait for all ports in sync mode

When in synchronous alignment mode, the wave plotter should ensure that the entire display is only refreshed after all N channels have arrived. Otherwise we are not necessarily looking at curves from the same time.

other interesting qwt widgets

qwt thermo?
qwt dial?

spectrogram can segfault w/ zooming

Something happens with zooming + tooltip that causes invalid memory access into the raster.

2d planar widget setValue() does not scale correctly

Really cool frequency entry widget

One of those widgets with hooks to spin individual digits up and down (example gqrx)

periodigram: fft bins have an edge issue

Looks like the end-bin math may be bad (after the shift to put DC in center). This shows up in the periodigram at the bin[0] index as random jumps up to 0dB

logic analyzer with wave and list view

Display the raw values of the stream or packet with a finite window, hex format, binary format, float values. But just printing the raw values.

multichannel fft display widget

• arbitrary number of streaming input ports
• setters for most controls
• other cool options?

text entry box input widget

• setter for value
• float, int, string options
• other validators?
• output message for change

eye diagram

spectrogram center freq setting broken

try to set a center freq, it doesnt display at all -- investigate and fix

Add format string to plots

Plot titling would be better if it could be format stringed.

"Constellation: %1" <--- BPSK or QPSK.

multichannel scope display widget

• arbitrary number of streaming input ports
• setters for most control
• other cool options?

periodigram: peak hold and average

• peak hold is an extra trace with configurable life-time to peak over
• average alters the channel to avaerage over a specified life-time
• need to select which trace peak hold is active on: None, CH0, or custom list
• need to select which channels average is on: None, CH0, or custom list
• need to configure history duration (in seconds?) for both features

Constellation plot sometimes does not plot

Complex graphs like the one attached cause problems where the constellation plot will not update.

stream intercept widget - debug tool

Allow the user to step through a stream with a push button, triggered by the presense of messages and labels. The widget will display the contents of the object (at least the data type).

documentation for creating widget aware blocks

swap out internal copy of qwt for git submodule

We don't actually need the embedded copy, its just for special situations where its hard to get pre-built qwt. An optional submodule would be preferable:

• qwt mirrored here: https://github.com/osakared/qwt/tree/tags/qwt-6.1.2

radio group cant use label to drag

This may be cause by the fact that QGroupBox is checkable (which is disabled in this case), so its eating the events and not forwarding them...

duplicate and report ComboBox bug to Qt

    /*!
     * FIXME -- This is almost certainly a Qt bug-workaround.
     * Changing this widget's parent causes a segfault in QComboBox.
     * Start with no parent, set parent, clear parent, set again -> segfault.
     * The workaround is to create a new QComboBox and restore its state.
     */
    bool event(QEvent *e)
    {
        if (e->type() == QEvent::ParentAboutToChange)
        {
            const auto oldIndex = _comboBox->currentIndex();
            QStringList oldItems; for (int i = 0; i < _comboBox->count(); i++) oldItems.push_back(_comboBox->itemText(i));
            delete _comboBox;
            _comboBox = (new QComboBox(this));
            layout()->addWidget(_comboBox);
            _comboBox->addItems(oldItems);
            _comboBox->setCurrentIndex(oldIndex);
        }
        return QWidget::event(e);
    }

plotters should accumulate input to avoid contention issue

Set the bins per display or points per wave plotter and the input sits on all the buffer resources waiting for more. Set the size back and it resumes plotting. We should in general address the issue of buffer requirements through the API, however in this case, accumulating to a render buffer at the display rate is very reasonable

• also see pothosware/pothos-library#74

pushbutton widget

• two modes: click or toggle
• signals for clicked and toggled
• slot for label
• slot for value

flexible datatype plotter widgets

• remove dtype from constructor and available params
• accept incoming buffers from streams and packet messages
• accept dtype from the incoming buffer

2d image display widget

This widget displays an image passed in via message. The message should contain a matrix. Exact format to be determined.

display labels as visual symbols on the wave viewer

screenshots and documentation for widgets

display plotters zoom controls

Use the qwt zoom picker to enable mouse controls to zoom select with a bounding box, and zoom out with click

Example: https://github.com/eiimage/qwt/blob/master/examples/spectrogram/plot.cpp#L13

drop down control widget

• dropdown/radiobuttons/combobox sort of widget that chooses from a set of enumerated options
• setter for the available options
• output message port for changed value

display plotters range controls

Provide these settings in the regular block properties panel. Possibly a context menu or built-in plot control panel as well.

• Y axis auto scale
• reference level
• dynamic range

numeric entry slider looses focus when arrow-key adjusting

Perhaps the spin box change is stealing focus, we may have to set it back to the slider

constellation plotter for complex data

Colored square for status visualization

We want an easy way to visualize the state of something. Like active/inactive, fail/pass, 0/1/tristate, etc.

The colored square block has an input slot which takes an arbitrary value of arbitrary type. The user configures the block with a map of possible values to a hex color code. The block performs the lookup to set the color.

Example configs:

• {true : "blue", false : "red"}
• {1 : "#000000", 2: "#ffffff", 3: "gray"}

QString conversion+serialization support module

This will allow QString-based signals and slots from a Qt widget to be used in an ecosystem outside of Qt which would use std::string. Supporting this lowers the amount of code wrapping because users can directly register QWidget slots that take QStrings and it will "just work".

• conversions between QString and std:string
• serialization for QString

constellation plotter curve options

• lines
• dots
• both
• colors

reusable property edit widget for window function selection

In the same style of pothos-gui edit wigets:
https://github.com/pothosware/pothos-gui/tree/master/EditWidgets

Any arbitrary widget can be registered into the property tree at "/gui/EntryWidgets/*"

This window function edit widget can be used in Periodigram, Spectrogram, and pothos-blocks taps designer block.

slider control widget

• typical linear slider
• logarithmic scaling option
• vertical/horizontal
• setters for min, max, step
• output message for value on change