Provides a GUI interface using the QT backend.
Constructor Specific Documentation:
| Parameters: |
|
|---|
declare_sample_delay(ber_sink_b_sptr self, unsigned int delay)
pc_input_buffers_full_avg(ber_sink_b_sptr self) -> pmt_vector_float
pc_output_buffers_full_avg(ber_sink_b_sptr self) -> pmt_vector_float
A graphical sink to display the IQ constellation of multiple signals.
This is a QT-based graphical sink the takes set of a complex streams and plots them on an IQ constellation plot.
Constructor Specific Documentation:
Build a constellation plot sink.
| Parameters: |
|
|---|
declare_sample_delay(const_sink_c_sptr self, unsigned int delay)
pc_input_buffers_full_avg(const_sink_c_sptr self) -> pmt_vector_float
pc_output_buffers_full_avg(const_sink_c_sptr self) -> pmt_vector_float
set_trigger_mode(const_sink_c_sptr self, gr::qtgui::trigger_mode mode, gr::qtgui::trigger_slope slope, float level, int channel, std::string const & tag_key=””)
Set up a trigger for the sink to know when to start plotting. Useful to isolate events and avoid noise.
The trigger modes are Free, Auto, Normal, and Tag (see gr::qtgui::trigger_mode). The first three are like a normal oscope trigger function. Free means free running with no trigger, auto will trigger if the trigger event is seen, but will still plot otherwise, and normal will hold until the trigger event is observed. The Tag trigger mode allows us to trigger off a specific stream tag. The tag trigger is based only on the name of the tag, so when a tag of the given name is seen, the trigger is activated.
In auto and normal mode, we look for the slope of the magnitude of the signal. As a constellation sink, this only takes in complex numbers to plot. Given a gr::qtgui::trigger_slope as either Positive or Negative, if the magnitude between two samples moves in the given direction (x[1] > x[0] for Positive or x[1] < x[0] for Negative), then the trigger is activated.
A graphical sink to display multiple signals in frequency.
This is a QT-based graphical sink the takes set of a complex streams and plots the PSD. Each signal is plotted with a different color, and the and functions can be used to change the lable and color for a given input number.
Message Ports:
Constructor Specific Documentation:
Build a complex PSD sink.
| Parameters: |
|
|---|
declare_sample_delay(freq_sink_c_sptr self, unsigned int delay)
pc_input_buffers_full_avg(freq_sink_c_sptr self) -> pmt_vector_float
pc_output_buffers_full_avg(freq_sink_c_sptr self) -> pmt_vector_float
Set up a trigger for the sink to know when to start plotting. Useful to isolate events and avoid noise.
The trigger modes are Free, Auto, Normal, and Tag (see gr::qtgui::trigger_mode). The first three are like a normal trigger function. Free means free running with no trigger, auto will trigger if the trigger event is seen, but will still plot otherwise, and normal will hold until the trigger event is observed. The Tag trigger mode allows us to trigger off a specific stream tag. The tag trigger is based only on the name of the tag, so when a tag of the given name is seen, the trigger is activated.
In auto and normal mode, we look to see if the magnitude of the any FFT point is over the set level.
A graphical sink to display multiple signals in frequency.
This is a QT-based graphical sink the takes set of a floating point streams and plots the PSD. Each signal is plotted with a different color, and the and functions can be used to change the lable and color for a given input number.
Message Ports:
Constructor Specific Documentation:
Build a floating point PSD sink.
| Parameters: |
|
|---|
declare_sample_delay(freq_sink_f_sptr self, unsigned int delay)
pc_input_buffers_full_avg(freq_sink_f_sptr self) -> pmt_vector_float
pc_output_buffers_full_avg(freq_sink_f_sptr self) -> pmt_vector_float
Pass “true” to this function to only show the positive half of the spectrum. By default, this plotter shows the full spectrum (positive and negative halves).
Set up a trigger for the sink to know when to start plotting. Useful to isolate events and avoid noise.
The trigger modes are Free, Auto, Normal, and Tag (see gr::qtgui::trigger_mode). The first three are like a normal trigger function. Free means free running with no trigger, auto will trigger if the trigger event is seen, but will still plot otherwise, and normal will hold until the trigger event is observed. The Tag trigger mode allows us to trigger off a specific stream tag. The tag trigger is based only on the name of the tag, so when a tag of the given name is seen, the trigger is activated.
In auto and normal mode, we look to see if the magnitude of the any FFT point is over the set level.
A graphical sink to display a histogram.
This is a QT-based graphical sink the displays a histogram of the data.
This histogram allows you to set and change at runtime the number of points to plot at once and the number of bins in the histogram. Both x and y-axis have their own auto-scaling behavior. By default, auto-scaling the y-axis is turned on and continuously updates the y-axis max value based on the currently plotted histogram.
The x-axis auto-scaling function only updates once when clicked. This resets the x-axis to the current range of minimum and maximum values represented in the histogram. It resets any values currently displayed because the location and width of the bins may have changed.
The histogram also has an accumulate function that simply accumulates the data between calls to work. When accumulate is activated, the y-axis autoscaling is turned on by default as the values will quickly grow in the this direction.
Constructor Specific Documentation:
Build floating point histogram sink.
| Parameters: |
|
|---|
declare_sample_delay(histogram_sink_f_sptr self, unsigned int delay)
pc_input_buffers_full_avg(histogram_sink_f_sptr self) -> pmt_vector_float
pc_output_buffers_full_avg(histogram_sink_f_sptr self) -> pmt_vector_float
A graphical sink to display numerical values of input streams.
Displays the data stream in as a number in a simple text box GUI along with an optional bar graph. The bar graph can be set to horizontal (NUM_GRAPH_HORIZ), vertical (NUM_GRAPH_VERT), or no graph (NUM_GRAPH_NONE).
The displayed value can be the average of the input stream, in which case all items received are averaged. If not averaging, the display simply samples a value in the data stream based on the update time of this block.
Note that due to a flaw in the implementation, this block cannot receive integer value inputs. It will take chars, shorts, and floats and properly convert them by setting itemsize of the constructor to one of these three values (sizeof_char, sizeof_short, and sizeof_float, respectively). If using integers, the block treats these as floats. Instead, put the integer input stream through an gr::blocks::int_to_float converter block.
Constructor Specific Documentation:
Build a number sink.
| Parameters: |
|
|---|
declare_sample_delay(number_sink_sptr self, unsigned int delay)
pc_input_buffers_full_avg(number_sink_sptr self) -> pmt_vector_float
pc_output_buffers_full_avg(number_sink_sptr self) -> pmt_vector_float
set_color(number_sink_sptr self, int which, int min, int max)
A graphical sink to display freq, spec, time, and const plots.
This is a QT-based graphical sink the takes a complex stream and plots it. The default action is to plot the signal as a PSD (FFT), spectrogram (waterfall), time domain I&Q, and constellation (I vs. Q) plots. The plots may be turned off by setting the appropriate boolean value in the constructor to False.
Message Ports:
Constructor Specific Documentation:
Build a complex qtgui sink.
| Parameters: |
|
|---|
declare_sample_delay(sink_c_sptr self, unsigned int delay)
pc_input_buffers_full_avg(sink_c_sptr self) -> pmt_vector_float
pc_output_buffers_full_avg(sink_c_sptr self) -> pmt_vector_float
A graphical sink to display freq, spec, and time.
This is a QT-based graphical sink the takes a float stream and plots it. The default action is to plot the signal as a PSD (FFT), spectrogram (waterfall), and time domain plots. The plots may be turned off by setting the appropriate boolean value in the constructor to False.
Message Ports:
Constructor Specific Documentation:
Build a floating point qtgui sink.
| Parameters: |
|
|---|
declare_sample_delay(sink_f_sptr self, unsigned int delay)
pc_input_buffers_full_avg(sink_f_sptr self) -> pmt_vector_float
pc_output_buffers_full_avg(sink_f_sptr self) -> pmt_vector_float
A graphical sink to display multiple signals on a time_raster plot.
This is a QT-based graphical sink that takes in byte streams and plots a time_raster (spectrogram) plot.
Input stream: This expects a bit stream (0, 1 in the LSB of a byte). It will display packed bytes but the display will have to be autoscaled.
Constructor Specific Documentation:
Build a bit time raster sink.
| Parameters: |
|
|---|
declare_sample_delay(time_raster_sink_b_sptr self, unsigned int delay)
pc_input_buffers_full_avg(time_raster_sink_b_sptr self) -> pmt_vector_float
pc_output_buffers_full_avg(time_raster_sink_b_sptr self) -> pmt_vector_float
A graphical sink to display multiple signals on a time_raster plot.
This is a QT-based graphical sink that takes set of a floating point streams and plots a time_raster (spectrogram) plot.
Constructor Specific Documentation:
Build a floating point time raster sink.
| Parameters: |
|
|---|
declare_sample_delay(time_raster_sink_f_sptr self, unsigned int delay)
pc_input_buffers_full_avg(time_raster_sink_f_sptr self) -> pmt_vector_float
pc_output_buffers_full_avg(time_raster_sink_f_sptr self) -> pmt_vector_float
A graphical sink to display multiple signals in time.
This is a QT-based graphical sink the takes set of a complex streams and plots them in the time domain. For each signal, both the signal’s I and Q parts are plotted, and they are all plotted with a different color, and the and functions can be used to change the lable and color for a given input number.
Constructor Specific Documentation:
Build complex time sink.
| Parameters: |
|
|---|
declare_sample_delay(time_sink_c_sptr self, unsigned int delay)
pc_input_buffers_full_avg(time_sink_c_sptr self) -> pmt_vector_float
pc_output_buffers_full_avg(time_sink_c_sptr self) -> pmt_vector_float
set_trigger_mode(time_sink_c_sptr self, gr::qtgui::trigger_mode mode, gr::qtgui::trigger_slope slope, float level, float delay, int channel, std::string const & tag_key=””)
Set up a trigger for the sink to know when to start plotting. Useful to isolate events and avoid noise.
The trigger modes are Free, Auto, Normal, and Tag (see gr::qtgui::trigger_mode). The first three are like a normal oscope trigger function. Free means free running with no trigger, auto will trigger if the trigger event is seen, but will still plot otherwise, and normal will hold until the trigger event is observed. The Tag trigger mode allows us to trigger off a specific stream tag. The tag trigger is based only on the name of the tag, so when a tag of the given name is seen, the trigger is activated.
In auto and normal mode, we look for the slope of the of the signal. Given a gr::qtgui::trigger_slope as either Positive or Negative, if the value between two samples moves in the given direction (x[1] > x[0] for Positive or x[1] < x[0] for Negative), then the trigger is activated.
With the complex time sink, each input has two lines drawn for the real and imaginary parts of the signal. When selecting the value, channel 0 is the real signal and channel 1 is the imaginary signal. For more than 1 input stream, channel 2i is the real part of the ith input and channel (2i+1) is the imaginary part of the ith input channel.
The value is specified in time based off the sample rate. If the sample rate of the block is set to 1, the delay is then also the sample number offset. This is the offset from the left-hand y-axis of the plot. It delays the signal to show the trigger event at the given delay along with some portion of the signal before the event. The delay must be within 0 - t_max where t_max is the maximum amount of time displayed on the time plot.
A graphical sink to display multiple signals in time.
This is a QT-based graphical sink the takes set of a float streams and plots them in the time domain. Each signal is plotted with a different color, and the and functions can be used to change the lable and color for a given input number.
Constructor Specific Documentation:
Build floating point time sink.
| Parameters: |
|
|---|
declare_sample_delay(time_sink_f_sptr self, unsigned int delay)
pc_input_buffers_full_avg(time_sink_f_sptr self) -> pmt_vector_float
pc_output_buffers_full_avg(time_sink_f_sptr self) -> pmt_vector_float
set_trigger_mode(time_sink_f_sptr self, gr::qtgui::trigger_mode mode, gr::qtgui::trigger_slope slope, float level, float delay, int channel, std::string const & tag_key=””)
Set up a trigger for the sink to know when to start plotting. Useful to isolate events and avoid noise.
The trigger modes are Free, Auto, Normal, and Tag (see gr::qtgui::trigger_mode). The first three are like a normal oscope trigger function. Free means free running with no trigger, auto will trigger if the trigger event is seen, but will still plot otherwise, and normal will hold until the trigger event is observed. The Tag trigger mode allows us to trigger off a specific stream tag. The tag trigger is based only on the name of the tag, so when a tag of the given name is seen, the trigger is activated.
In auto and normal mode, we look for the slope of the of the signal. Given a gr::qtgui::trigger_slope as either Positive or Negative, if the value between two samples moves in the given direction (x[1] > x[0] for Positive or x[1] < x[0] for Negative), then the trigger is activated.
The value is specified in time based off the sample rate. If the sample rate of the block is set to 1, the delay is then also the sample number offset. This is the offset from the left-hand y-axis of the plot. It delays the signal to show the trigger event at the given delay along with some portion of the signal before the event. The delay must be within 0 - t_max where t_max is the maximum amount of time displayed on the time plot.
A graphical sink to display multiple vector-based signals.
This is a QT-based graphical sink that plots vectors of data as-is. Each signal is plotted with a different color, and the set_title() and set_color() functions can be used to change the label and color for a given input number.
To specify units for the x- and y-axes, use the set_x_axis_units() and set_y_axis_units() functions. This does not change the x- and y-labels, which are either specified during construction, or by calling the set_x_axis_label() and set_y_axis_label() methods.
Constructor Specific Documentation:
Build a vector plotting sink.
| Parameters: |
|
|---|
declare_sample_delay(vector_sink_f_sptr self, unsigned int delay)
pc_input_buffers_full_avg(vector_sink_f_sptr self) -> pmt_vector_float
pc_output_buffers_full_avg(vector_sink_f_sptr self) -> pmt_vector_float
The ref level is a reference line.
Update the values on the x-Axis.
Change the units string on the x-Axis (e.g. ‘m’ if x-Axis label was ‘Distance’)
Change the units string on the y-Axis (e.g. ‘V’ if x-Axis label was ‘Amplitude’)
A graphical sink to display multiple signals on a waterfall (spectrogram) plot.
This is a QT-based graphical sink the takes set of a complex streams and plots a waterfall (spectrogram) plot.
Note that unlike the other qtgui sinks, this one does not support multiple input streams. We have yet to figure out a good way to display multiple, independent signals on this kind of a plot. If there are any suggestions or examples of this, we would love to see them. Otherwise, to display multiple signals here, it’s probably best to sum the signals together and connect that here.
Message Ports:
Constructor Specific Documentation:
Build a complex waterfall sink.
| Parameters: |
|
|---|
declare_sample_delay(waterfall_sink_c_sptr self, unsigned int delay)
pc_input_buffers_full_avg(waterfall_sink_c_sptr self) -> pmt_vector_float
pc_output_buffers_full_avg(waterfall_sink_c_sptr self) -> pmt_vector_float
A graphical sink to display multiple signals on a waterfall (spectrogram) plot.
This is a QT-based graphical sink the takes set of a floating point streams and plots a waterfall (spectrogram) plot.
Note that unlike the other qtgui sinks, this one does not support multiple input streams. We have yet to figure out a good way to display multiple, independent signals on this kind of a plot. If there are any suggestions or examples of this, we would love to see them. Otherwise, to display multiple signals here, it’s probably best to sum the signals together and connect that here.
Message Ports:
Constructor Specific Documentation:
Build a floating point waterfall sink.
| Parameters: |
|
|---|
declare_sample_delay(waterfall_sink_f_sptr self, unsigned int delay)
pc_input_buffers_full_avg(waterfall_sink_f_sptr self) -> pmt_vector_float
pc_output_buffers_full_avg(waterfall_sink_f_sptr self) -> pmt_vector_float
Pass “true” to this function to only show the positive half of the spectrum. By default, this plotter shows the full spectrum (positive and negative halves).