2019-01-20 23:15:10 +08:00
# JKQTPlotter - A Qt Plotting Library
2018-11-28 05:49:27 +08:00
This is an extensive library of function/data plotter classes for Qt (>= 4.7, tested with Qt up to 5.11).
2015-07-11 23:51:59 +08:00
2018-12-29 00:46:47 +08:00
This software is licensed under the term of the [GNU Lesser General Public License 2.1
2019-01-12 20:43:12 +08:00
(LGPL 2.1)](./LICENSE) or above.
2018-11-25 22:02:55 +08:00
2019-01-14 00:18:27 +08:00
## Main Features
2019-01-20 23:15:10 +08:00
- 2D Plotter class (JKQTPlotter)
2019-01-14 00:18:27 +08:00
- high-quality plotting
2019-01-14 00:19:05 +08:00
- no other dependencies than Qt >=4.7 (compatible with Qt 5.xx)
2019-01-14 00:18:27 +08:00
- highly customizable axes/grids (linear/log, date/time, custom ticks ...)
- integrated LaTeX parser (pure C++, no dependencies) to render mathematical equations in axis labels, ticks, ...
- extensive user-interactions pre-programmed (several zooming modes, selecting regions, custom context menus, switch graph visibility, ...)
- full print and export (PDF,PNG,...) support with preview and parametrization out-the-box
- highly customizable look and feel
- supports the Qt layout system for graphs and allows to symchronize several graphs with each other
- centralized data management in an internal datastore:
- data organized by columns, can also represent image data (ropw-major)
- allows to reuse a column in several graphs
- access via Qt's model view framework
- external or internal datasets
- complete with GUI (table view)
- export capabilities (e.g. to CSV, SYLK, ...)
2019-05-30 04:47:26 +08:00
- C++ standard iterator interface
2019-06-02 00:20:36 +08:00
- statistics library (basic statistics, boxplots, histograms, kernel density estimates, regression analysis, polynomial fitting)
2019-01-14 00:18:27 +08:00
- large variety of graphs that can be added to a plot, e.g.:
- scatter-plots (also parametrized color/size/symbol by a third data-column)
- line graphs, step graphs, impulses
- filled curves
- barcharts (also stacked)
- extensive support for different styles of error indicators
- integrated mathematical function parser for function plots (with intelligent rendering algorithm)
- line/scatter graphs can also be based on C/C++ functions instead of data series (C++11 support!)
- statistical plots (e.g. boxplots)
- extensive library of image plots (inclusing different color-scale modes, RGBA-plots, overlays/masks)
- contour plots
- geometric forms/annotations
2019-01-20 17:49:29 +08:00
- can be easily extended by deriving a new graph from JKQTPPlotElement or JKQTPPlotObject
2019-01-14 00:18:27 +08:00
- optional: OpenCV interface
2019-06-21 04:38:51 +08:00
- CMake-based build system
2019-01-14 00:18:27 +08:00
- extensive set of [Examples/Tutorials ](./examples/README.md )
2019-01-21 16:31:13 +08:00
- extensive doxygen-generated [Documentation ](http://jkriege2.github.io/JKQtPlotter/index.html )
2018-12-21 22:31:56 +08:00
2019-01-21 16:30:57 +08:00
## [Documentation](http://jkriege2.github.io/JKQtPlotter/index.html)
2019-01-13 16:35:35 +08:00
A Documentation (auto-)generated with [doxygen ](http://www.doxygen.nl/ ) from the trunk source code can be found here:
2019-01-21 16:30:57 +08:00
**[http://jkriege2.github.io/JKQTPlotter/index.html](http://jkriege2.github.io/JKQtPlotter/index.html)**
2019-01-13 16:35:35 +08:00
2019-01-21 16:30:57 +08:00
Documentation is auto-generated after pushes by [Travis ](https://travis-ci.org/jkriege2/JKQtPlotter ): [](https://travis-ci.org/jkriege2/JKQtPlotter)
2019-01-16 00:15:02 +08:00
2019-01-12 21:15:08 +08:00
## [Examples](./examples/)
There is a [large set of usage examples (with explanations for each) and tutorials ](./examples/ ) in the folder [`./examples/` ](./examples ).
2018-11-27 05:35:21 +08:00
All test-projects are Qt-projects that use qmake to build. You can load them into QtCreator easily.
2019-01-12 21:15:43 +08:00
[](./examples/README.md)
2018-12-02 18:40:36 +08:00
2019-01-12 21:15:08 +08:00
## [Screenshots](./screenshots/)
The [Screenshots-page ](./screenshots/ ) contains several screenshots, partly taken from the provided examples, but also from other software using this libarary (e.g. [QuickFit 3.0 ](https://github.com/jkriege2/QuickFit3 ))
2019-01-12 21:15:43 +08:00
[](./screenshots/README.md)
2019-01-12 21:15:08 +08:00
2018-12-02 18:40:36 +08:00
2019-01-12 20:43:12 +08:00
## Building
2019-06-21 04:44:42 +08:00
Simply use CMake, e.g. from QTCreator, or by calling something like:
```
$ mkdir build; cd build
$ cmake ../
$ make
$ make install
```
Building instructions for QMake can be found here:
2019-01-12 21:15:43 +08:00
- include necessary files into QMake project: [`./lib/*.pri` ](./lib/README.md )
2019-06-21 04:24:47 +08:00
- [build a static library ](./staticlib ): [`./qmake/staticlib/*.pro` ](./qmake/staticlib/README.md )
- [build a shared library (DLL, SO, ...) ](./sharedlib ): [`./qmake/sharedlib/*.pro` ](./qmake/sharedlib/README.md )
2019-01-14 00:18:27 +08:00
## Continuous Integration Status
[](https://ci.appveyor.com/project/jkriege2/jkqtplotter/branch/master)
