QT GUI Time Sink: Difference between revisions

From GNU Radio
Jump to navigation Jump to search
No edit summary
(4 intermediate revisions by the same user not shown)
Line 4: Line 4:
This block does not support C++ output, so it cannot be used when the output language of a flowgraph in GRC is C++.
This block does not support C++ output, so it cannot be used when the output language of a flowgraph in GRC is C++.


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 label and color for a given input number.
This is a QT-based graphical sink that takes sets of float or complex streams and plots them in the time domain. Each signal is plotted with a different color, and options of the block can be used to change the label and color for a given input number.


The sink supports plotting streaming float data or messages. The message port is named "in". The two modes cannot be used simultaneously, and should be set to 0 when using the message mode. GRC handles this issue by providing the "Float Message" type that removes the streaming port(s).
The sink supports plotting streaming float data, complex data or messages. The message port is named "in". The two modes cannot be used simultaneously, and should be set to 0 when using the message mode. GRC handles this issue by providing the "Float Message" type that removes the streaming port(s).


There are many parameters, across three different tabs, most of which are self-explanatory.
There are many parameters, across three different tabs of General, Trigger and Config, most of which are self-explanatory.  
 
See [[GUI Hint]] for info about how to organize multiple QT GUIs.


== Parameters ==
== Parameters ==
<b>(''R''):</b> <span class="plainlinks">[https://wiki.gnuradio.org/index.php/GNURadioCompanion#Variable_Controls ''Run-time adjustable'']</span>
<b>(''R''):</b> <span class="plainlinks">[https://wiki.gnuradio.org/index.php/GNURadioCompanion#Variable_Controls ''Run-time adjustable'']</span>
=== General ===
; Type
:* Complex
:* Float
:* Complex Message
:* Float Message
; Name
: The name of the plot. It is shown on the top of the plot in the output window.
; Y Axis Label
: The Y Axis Label to be added to the plot. The x-axis label is 'Time', which is added automatically to the plot.
; Y Axis Unit
: The unit of data to be shown infront of the Y Axis Label. It is shown in round brackets.
; Number of Points
: Sample Rate (''R'')


; Grid
; Grid
: Yes: Adds a grid to the plot
:* Yes: Adds a grid to the plot
: No: No grid added to the plot
:* No: No grid added to the plot


; Autoscale
; Autoscale
: Yes: Automatically adjust the maximum and minimum y axis values of the plot to contain the entire plot along y axis. Choosing this option overrides the values specified in Y min and Y max input parameters.
:* Yes: Automatically adjust the maximum and minimum y axis values of the plot to contain the entire plot along y axis. Choosing this option overrides the values specified in Y min and Y max input parameters.
: No: Does not automatically adjust the plot. The values of Y min and Y max are used to create the plot.
:* No: Does not automatically adjust the plot. The values of Y min and Y max are used to create the plot.


; Y min (''R'')
; Y min (''R'')
Line 36: Line 54:


; Disp. Tags
; Disp. Tags
: Yes: Display the tags in the plot
:* Yes: Display the tags in the plot
: No: Do not display the tags in the plot
:* No: Do not display the tags in the plot


; GUI Hint
; GUI Hint
: This parameter controls the placement of this time sink in the output window.
: This parameter controls the placement of the plot in the output window. See [[GUI Hint]] for info about how to organize multiple QT GUIs.


== Example Flowgraph ==
== Example Flowgraph ==

Revision as of 06:35, 27 January 2022

A graphical sink to display multiple signals in time.

This block does not support C++ output, so it cannot be used when the output language of a flowgraph in GRC is C++.

This is a QT-based graphical sink that takes sets of float or complex streams and plots them in the time domain. Each signal is plotted with a different color, and options of the block can be used to change the label and color for a given input number.

The sink supports plotting streaming float data, complex data or messages. The message port is named "in". The two modes cannot be used simultaneously, and should be set to 0 when using the message mode. GRC handles this issue by providing the "Float Message" type that removes the streaming port(s).

There are many parameters, across three different tabs of General, Trigger and Config, most of which are self-explanatory.

Parameters

(R): Run-time adjustable

General

Type
  • Complex
  • Float
  • Complex Message
  • Float Message
Name
The name of the plot. It is shown on the top of the plot in the output window.
Y Axis Label
The Y Axis Label to be added to the plot. The x-axis label is 'Time', which is added automatically to the plot.
Y Axis Unit
The unit of data to be shown infront of the Y Axis Label. It is shown in round brackets.
Number of Points
Sample Rate (R)
Grid
  • Yes: Adds a grid to the plot
  • No: No grid added to the plot
Autoscale
  • Yes: Automatically adjust the maximum and minimum y axis values of the plot to contain the entire plot along y axis. Choosing this option overrides the values specified in Y min and Y max input parameters.
  • No: Does not automatically adjust the plot. The values of Y min and Y max are used to create the plot.
Y min (R)
The minimum y axis value to be automatically shown in the plot
Y max (R)
The maximum y axis value to be automatically shown in the plot
Number of Inputs
Total number of input ports to be created on this block
Update Period (R)
The period after which the plot data will be updated
Disp. Tags
  • Yes: Display the tags in the plot
  • No: Do not display the tags in the plot
GUI Hint
This parameter controls the placement of the plot in the output window. See GUI Hint for info about how to organize multiple QT GUIs.

Example Flowgraph

Noise-source-ex.png

Control Panel & Triggering

Qt GUI Time Sink showing its control panel, with trigger settings.

Timesink-ctrl-large.jpg

Source Files

C++ files
time_sink_complex_impl.cc
time_sink_float_impl.cc
Header files
time_sink_complex_impl.h
time_sink_float_impl.h
Public header files
time_sink_complex.h
time_sink_float.h
Block definition
qtgui_time_sink_x.block.yml