Installing the Qt Data Visualization Module

Use the Package Manager in Maintenance Tool or the Online installer to install the Qt Data Visualization module. The module can be found under Qt Enterprise Add-Ons in the package manager.

After installation Qt Data Visualization documentation and examples are available in Qt Creator. Examples can be found on the examples page of Qt Creator by selecting the Qt Data Visualization component from the drop-down menu.

The source code is installed into the QtDataVisualization folder under EnterpriseAddOns.

Building Qt Data Visualization

To build the Qt Data Visualization module from source code yourself, set up a command prompt with an environment for building Qt applications, navigate to the directory containing qtdatavisualization.pro, and configure the project with qmake:

qmake

After running qmake, build the project with make:

The above generates the default makefiles for your configuration, which is typically the release build if you are using precompiled binary Qt distribution. To build both debug and release, or one specifically, use one of the following qmake lines instead.

For debug builds:

qmake CONFIG+=debug
make

or

qmake CONFIG+=debug_and_release
make debug

For release builds:

qmake CONFIG+=release
make

or

qmake CONFIG+=debug_and_release
make release

For both builds (Windows/OS X only):

qmake CONFIG+="debug_and_release build_all"
make

After building, install the module to your Qt directory:

make install

If you want to uninstall the module:

make uninstall

To build a statically linked version of the Qt Data Visualization module, give the following commands:

qmake CONFIG+=static
make
make install

Running Examples

Qt Data Visualization examples are found under the examples subdirectory. To build and run a single example, in this case qmlsurface, navigate to the example directory and enter the following commands:

qmake
make
./qmlsurface

Note: On some platforms, such as Windows, the executable can be generated under debug or release folders, depending on your build.

Creating a Simple Application

To create a simple application, start by creating a new Qt Gui Application project in Qt Creator and add this line to the .pro file of the project:

QT += datavisualization

In the main.cpp file, include the module headers and declare namespace usage:

#include <QtDataVisualization>

using namespace QtDataVisualization;

Then, add the sample code found in one of the following pages, depending on what kind of visualization you are interested in: How to construct a minimal Q3DBars graph, How to construct a minimal Q3DScatter graph, or How to construct a minimal Q3DSurface graph.

To use Qt Data Visualization graphs in widget based applications, you can use the QWidget::createWindowContainer() function to wrap the graph into a widget:

Q3DBars *graph = new Q3DBars();
QWidget *container = QWidget::createWindowContainer(graph);

For further code examples, see one of the Qt Data Visualization examples: