1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
|
/* -*- c++ -*- */
/*
* Copyright 2013,2015 Free Software Foundation, Inc.
*
* This file is part of GNU Radio
*
* SPDX-License-Identifier: GPL-3.0-or-later
*
*/
#ifndef INCLUDED_QTGUI_HISTOGRAM_SINK_F_H
#define INCLUDED_QTGUI_HISTOGRAM_SINK_F_H
#ifdef ENABLE_PYTHON
#include <Python.h>
#endif
#include <gnuradio/qtgui/api.h>
#include <gnuradio/sync_block.h>
#include <qapplication.h>
namespace gr {
namespace qtgui {
/*!
* \brief A graphical sink to display a histogram.
* \ingroup instrumentation_blk
* \ingroup qtgui_blk
*
* \details
* 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.
*
* The sink supports plotting streaming float data or
* messages. The message port is named "in". The two modes cannot
* be used simultaneously, and \p nconnections 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).
*
* This sink can plot messages that contain either uniform vectors
* of float 32 values (pmt::is_f32vector) or PDUs where the data
* is a uniform vector of float 32 values.
*/
class QTGUI_API histogram_sink_f : virtual public sync_block
{
public:
// gr::qtgui::histogram_sink_f::sptr
typedef boost::shared_ptr<histogram_sink_f> sptr;
/*!
* \brief Build floating point histogram sink
*
* \param size number of points to plot at once
* \param bins number of bins to sort the data into
* \param xmin minimum x-axis value
* \param xmax maximum x-axis value
* \param name title for the plot
* \param nconnections number of signals connected to sink
* \param parent a QWidget parent object, if any
*/
static sptr make(int size,
int bins,
double xmin,
double xmax,
const std::string& name,
int nconnections = 1,
QWidget* parent = NULL);
virtual void exec_() = 0;
virtual QWidget* qwidget() = 0;
#ifdef ENABLE_PYTHON
virtual PyObject* pyqwidget() = 0;
#else
virtual void* pyqwidget() = 0;
#endif
public:
virtual std::string title() = 0;
virtual std::string line_label(unsigned int which) = 0;
virtual std::string line_color(unsigned int which) = 0;
virtual int line_width(unsigned int which) = 0;
virtual int line_style(unsigned int which) = 0;
virtual int line_marker(unsigned int which) = 0;
virtual double line_alpha(unsigned int which) = 0;
virtual void set_size(int width, int height) = 0;
virtual void enable_menu(bool en = true) = 0;
virtual void enable_grid(bool en = true) = 0;
virtual void enable_autoscale(bool en = true) = 0;
virtual void enable_semilogx(bool en = true) = 0;
virtual void enable_semilogy(bool en = true) = 0;
virtual void enable_accumulate(bool en = true) = 0;
virtual void enable_axis_labels(bool en = true) = 0;
virtual void autoscalex() = 0;
virtual int nsamps() const = 0;
virtual int bins() const = 0;
virtual void reset() = 0;
QApplication* d_qApplication;
virtual void set_y_axis(double min, double max) = 0;
virtual void set_x_axis(double min, double max) = 0;
virtual void set_update_time(double t) = 0;
virtual void set_title(const std::string& title) = 0;
virtual void set_line_label(unsigned int which, const std::string& line) = 0;
virtual void set_line_color(unsigned int which, const std::string& color) = 0;
virtual void set_line_width(unsigned int which, int width) = 0;
virtual void set_line_style(unsigned int which, int style) = 0;
virtual void set_line_marker(unsigned int which, int marker) = 0;
virtual void set_line_alpha(unsigned int which, double alpha) = 0;
virtual void set_nsamps(const int newsize) = 0;
virtual void set_bins(const int bins) = 0;
virtual void disable_legend() = 0;
};
} /* namespace qtgui */
} /* namespace gr */
#endif /* INCLUDED_QTGUI_HISTOGRAM_SINK_F_H */
|
