What's New (Release Notes/Versions)

Table of Contents

• trunk/master
  • trunk: Overview
  • trunk: Download
• V4.0.0: Qt6 compatibility & diverse improvements + bugfixes
  • V4.0.0: Overview
  • V4.0.0: Download
• v2019.11: Major rework of the library
  • v2019.11: Overview
  • v2019.11: Download
• v2018.08: Minor Modifications (Final QuickFit3-compatible Version)
  • v2018.08: Overview
  • v2018.08: Download
• v2015.10: Initial Release
  • v2015.10: Overview
  • v2015.10: Download

This page lists release notes for the different version of JKQTPlotter

trunk/master

trunk: Overview

Changes, compared to v4.0.0 include:

• General/Build-System:

  • BREAKING: renamed library JKQTCommonStatisticsAndMath to JKQTMath. Note: A CMake-ALIAS-Library JKQTCommonStatisticsAndMath was also added to ease transition for users
  • BREAKING: JKQTFastPlotter class and library are now deprecated and will be removed in future versions!
  • BREAKING: The QMake build system is deprecated and will not get the same love and atttention as the recommended CMake system. The QMake scripts might be removed in future versions!
  • FIXED/SECURITY not using sprintf() any more ... replaced by e.g. snprintf() , which is more secure.
  • FIXED issue #102: Fix CMake Compile Error: JKQTCommonLib no properly linked in JKQTMath static build (thanks to user:Neumann-A for reporting)
  • CLEANUP (BREAKING) of library structure
  • NEW: Using precompiled headers in CMake-build to speed up build times
  • NEW/BREAKING: split jkqtcommon into basic tools and jkqtmath for advanced math tools not used by all libs
  • NEW: When using a MSVC compiler, the generated PDB files are installed to CMAKE_INSTALL_PREFIX/bin/
    
  • NEW: Added CMake option JKQtPlotter_BUILD_WITH_TIMING_INFO_OUTPUT, which activates several runtime-measurement guards of type JKQTPAutoOutputTimer (output via qDebug())
    
  • NEW/BREAKING: provide general targets JKQTPlotter5/6::JKQTPlotter5/6, JKQTPlotter5/6::JKQTMathText5/6, ... which are independent of the type of build (shared/static)
    
  • NEW/BREAKING: refactor CMake-Code, so static/dynamic switch is done via BUILD_SHARED_LIBS, which retires JKQtPlotter_BUILD_STATIC_LIBS, JKQtPlotter_BUILD_SHARED_LIBS and removes the capability to build static and shared libraries in one location (fixes issue #104)
    
  • NEW: prepareed library for CMake's FetchContent-API
    
  • NEW: the different sub-libraries JKQTPlotter, JKQTFastPlotter (DEPRECATED), JKQTMath, JKQTMathText can be activated/deactivated with CMake options JKQtPlotter_BUILD_LIB_JKQTPLOTTER, JKQtPlotter_BUILD_LIB_JKQTFASTPLOTTER, JKQtPlotter_BUILD_LIB_JKQTMATHTEXT, JKQtPlotter_BUILD_LIB_JKQTMATH
    
  • NEW add JKQTPExpected datatype, jkqtp_roundToDigits(), generic RegularExpression functions (jkqtp_rxExactlyMatches(), jkqtp_rxIndexIn(), jkqtp_rxContains(), jkqtp_rxPartiallyMatchesAt() )
  • NEW CSS-parser JKQTPCSSParser in order to parse e.g. linear-gradient() specifications in jkqtp_String2QBrushStyleExt()

• JKQTPlotter:

  • BREAKING/REWORKED: Updated default styling of graphs. They are now more modern!
  • BREAKING/REWORKED: Implement better/more access functions to the graphs (inlcuding sorting, moving up/down, appending/prepending, graphs-iterators ...), solves issue #97, thanks to user:sim186 for bringing this up
  • BREAKING/FIXED: fixed issue #96: JKQTPlotter::saveAsPixelImage() does not add a border around the image any longer (can be reacivated by a new optional function parameter), thanks to user:nmielcarek for reporting
  • BREAKING/FIXED: JKQTPXFunctionLineGraph and JKQTPYFunctionLineGraph do no longer contribute to auto-scaling, as that depends on the current plot-axes (hen-egg-problem).
  • BREAKING/FIXED: graph symbols were not properly applied when reading styles (in fact they were shuffled under some circumstances)
  • BREAKING/NEW: rework layouting of keys/legends: new classes JKQTPBaseKey, JKQTPMainKey ... and removed several styling function for the main key from JKQTBasePlotter and JKQTPlotter (these are now accessible via JKQTBasePlotter::getMainKey()
  • BREAKING/DEPRECATED: deprecated JKQTBasePlotter::zoom() and JKQTPlotter::zoom(), use JKQTBasePlotter::setXY() and JKQTPlotter::setXY() instead
  • FIXED issue described in #62: Fix custom labels draw, because giving exactly two label-strings did not display all of them, thanks to user:FalsinSoft
  • FIXED issue #70: Typo in jkqtplotter/CMakeLists.txt, thanks to user:tedlinlab
  • FIXED issue #80: Bug with multiple inheritance with Q_GDAGET with CLANG, thanks to user:igormironchik, caused by QTBUG-104874
  • FIXED: styling was not properly applied to coordinate axes of colorbars outside the plot
  • FIXED issue #73: Symbol thickness differs in actual plot and legend, thanks to user:sim186
  • FIXED plot-size calculation for filled graphs
  • FIXED issue #98: Signal JKQTPlotter::plotMouseWheelOperated() was called with wrong x/y-position-coordinates, thanks to user:fpalazzolo for reporting this bug
  • FIXED: first symbol in symbols rotation was never used
  • FIXED: color palettes with few entries (i.e. "step"-palettes) were not applied correctly
  • FIXED: fixes strange rendering with distortions (especially in text!), by correcting size calculation of internal image buffer
  • FIXED: exporting gridPrinting plots when using only a JKQTBasePlotter
  • FIXED: fixed impleentations of JKQTPlotter::beginGraphs(), which actually returned the end-iterator (COPY-PASTE-ERROR!!!)
  • FIXED issue #99: Clipping of Tick Labels: for horizontal axes, additional space at the left and/or right of the plot is allowed so labels are no longer clipped (thanks to user:allenbarnett5 for reporting)
  • FIXED issue #99: Height of one-column key/legend was too large (thanks to user:allenbarnett5 for reporting)
  • FIXED issue mentioned in #110: Lock the panning action to certain values: View zooms in, when panning close to AbosluteXY (thanks to user:sim186 for reporting)
  • FIXED: jkqtpstatSum() and jkqtpstatSumSqr() did not work, as a non-existing function is called internally
  • FIXED removed unnecessary operators (<,>,<=,>=) from JKQTPColumnIterator and JKQTPColumnConstIterator, which lead to exceptions on some compilers (MSVC)
  • FIXED/IMPROVED issue #100: Add option to disable resize delay feature by setting the delay to zero (thanks to user:fpalazzolo for reporting)
  • FIXED symmetry when zooming with JKQTBasePlotter::zoomIn() or JKQTBasePlotter::zoomOut()
  • FIXED/NEW: placement of plot-title (was not centerd in its box, but glued to the bottom) by adding a plotstyle parameter JKQTBasePlotterStyle::plotLabelOffset
  • FIXED/REWORKED issue #111: Can't write to PDF files with JKQTPlotter::saveImage() when passing a filename ending in ".pdf" (thanks to user:fpalazzolo for reporting):
    While fixing this issue, the functions JKQTBasePlotter::saveImage() etc. gained a bool return value to indicate whether sacing was successful.
  • IMPROVED/FIXED outside space requirements for color bars. Text was sometime too close to the plot border.
  • FIXED issue #140: addGraph function return value by adding return values to all addGraph()-Variants in JKQTPlotter (to mirror the interface of JKQTBasePlotter), (thanks to user:sajadblog
  • REWORKED JKQTBasePlotter::saveData() with a more consistent interface and a bool return value to indicate success or failure + improved documentation, added methods to JKQTPSaveDataAdapter that allow to specify file extensions and an ID for the plugin.
  • REWORKED: separation and gruping factor for barcharts on autoscaling
  • REORGANIZED: separated line-graphs from jkqtpscatter.h/.cpp into jkqtplines.h/.cpp
  • IMPROVED: QT6-compatibility by removing deprecated warnings
  • IMPROVED: added missing override declarations
  • IMPROVED: JKQTPlotter::jkqtp_RESIZE_DELAY is thread-safe now (atomic)
  • IMPROVED: Using axis's tick label formating properties to format values in data-tooltips (e.g. dates will appear formated as such)
  • IMPROVED/REWORKED: reworked JKQTPErrorPlotstyle and error indicator plotting so error-inidcators can be specified as ORed combination of flags from JKQTPErrorPlotstyleElements, added additional error indicator styles (half-bars, arrows...)
  • IMPROVED/REWORKED: reworked JKQTPCADrawMode and coordinate axis drawing so the draw mide can be specified as ORed combination of flags from JKQTPCADrawModeElements, added flags to draw arrows at the end of the axis line
  • IMPROVED/REWORKED: coordinate axis code was refactored
  • IMPROVED/REWORKED: zomm/pan by mouse-wheel: now there are modes that support zoomin AND panning by trakpad and mouse-wheel simultaneously! This can only be implemented using heuristics, due to the way that Qt handles track-pad events, but the current solution should at least improve the behaviour seen before. Mainly jkqtpmwaZoomByWheelAndTrackpadPan was introduced into JKQTPMouseWheelActions und is set as default mode: Here JKQTPlotter tries to distinguish the QWheelEvent s sent by an actual mouse wheel and a trackpad.
  • IMPROVED/REWORKED: better example graphs in Tutorial (JKQTPlotter): Styling a JKQtPlotter .
  • IMPROVED/REWORKED: legend/key positioning as combination of 3 values, e.g. JKQTPKeyOutsideTop|JKQTPKeyTop|JKQTPKeyRight or JKQTPKeyInside|JKQTPKeyTopJKQTPKeyRight
  • IMPROVED/REWORKED: The functions JKQTBasePlotter::saveImage(), JKQTBasePlotter::saveAsPixelImage(), JKQTBasePlotter::saveAsPDF(), JKQTBasePlotter::saveSVG(), ... gained a bool return value to indicate whether sacing was successful.
  • IMPROVED/REWORKED: More save...() functions will appear in the API of JKQTPlotter, so you don't have to go via JKQTPlotter::getPlotter(). These are merely forwarding the call to the internel JKQTBasePlotter instance.
  • IMPROVED: documentation of styles: automatized doc image generation.
  • IMPROVED: axis labeling: there were some minor differences between compilers
  • IMPROVED: jkqtp_floattounitstr()/jkqtp_floattolatexunitstr(): add all SI-Prefixes from 10^-30...10^30
  • RENAMED JKQTPDatastore::addColumnCalculatedFromColumn() to JKQTPDatastore::addCalculatedColumnFromColumn(), which is more in line with the other add...()-function names. Aliases with the old function names remain for compatibility
  • NEW: JKQTPFilledCurveXGraph and JKQTPFilledCurveYGraph can now plot wiggle plots with different fill styles above and below the baseline (feature request #68 Wiggle Plots from user:xichaoqiang
  • NEW/BREAKING CHANGE: data tooltip can now also be shown when "just" moving the mouse (so far this was only possible when dragging the mouse with a button pressed). This also removes JKQtPlotter::getActMouseLeftAsToolTip() and adds JKQtPlotter::getActMouseMoveToolTip() instead! Also the default toolbars and context menus changed!
  • NEW: new "seaborn" style for plots, see Styling System
  • NEW/BREAKING CHANGE: changed JKQTPColorDerivationMode into a struct, which extends its capabilities above the previously available few enum-items
  • NEW: added debug-feature to show boxes around text in the plot
  • BREAKING: Print-Support can now be switched off with a CMAKE-option JKQtPlotter_BUILD_FORCE_NO_PRINTER_SUPPORT=ON. This also switches off PDF and SVG export, partly solves issue #81, many thanks to user:sufuk for contributing part of the code and supplying the idea!
  • NEW: improved plotting speed for line-graphs by drawing a series of single lines instead of a polyline in some cases
  • NEW: improved plotting speed for line-graphs by a compression algorithm (see JKQTPGraphLinesCompressionMixin) that removes overlaying lines (e.g. in JKQTPXYLineGraph)
  • NEW: improved plotting speed for line-graphs by a clipping algorithm (applies to JKQTPXYLineGraph, JKQTPGraphErrorStyleMixin, JKQTPSpecialLineHorizontalGraph, JKQTPSpecialLineVerticalGraph and others)
  • NEW: improved plotting speed for scatter-graphs by not calling draw functions for symbols outside the plot window (e.g. in JKQTPXYLineGraph)
  • NEW: added JKQTBasePlotter::grabPixelImage() and JKQTPlotter::grabPixelImage(), which grab the plotter into a QImage
  • NEW: added option to not display the preview dialog to JKQTBasePlotter::copyPixelImage() and JKQTPlotter::copyPixelImage()
  • NEW: added simple scatter plot JKQTPXYScatterGraph
  • NEW: made resize-timer status accessible from outside via JKQTPlotter::isResizeTimerRunning()
  • NEW: made it's delay a global static variable that can be set and red with JKQTPlotter::setGlobalResizeDelay() and JKQTPlotter::getGlobalResizeDelay()
  • NEW: Using JKQTMathText::useGuiFonts() for FONT rendering by default
  • NEW: added the option to draw a character from a font as symbol (JKQTPCharacterSymbol+QChar('C').unicode() and JKQTPFilledCharacterSymbol+QChar('C').unicode())
  • NEW: added the option to register a custom symbol using JKQTPRegisterCustomGraphSymbol()
  • NEW: added property drawLineInForeground to JKQTPXYLineGraph and JKQTPXYParametrizedScatterGraph
  • NEW: added JKQTPXYGraph::setKeyColumn()/JKQTPXYGraph::getKeyColumn() and JKQTPXYGraph::setValueColumn()/JKQTPXYGraph::getValueColumn() and corresponding functions in other classes. In most graph classes they point to xColumn for key and yColumn for values. These functions are virtual and overwritten in derived classes with horizontally oriented graphs, where they point to yColumn for key and yColumn for value. This way you can write generic code with classes for both orientations.
  • NEW: added new error indicator styles JKQTPErrorHalfBarsOutwards, JKQTPErrorHalfBarsInwards, JKQTPErrorHalfBarsAbove, JKQTPErrorHalfBarsBelow which are especially useful for barcharts
  • NEW: Added signals JKQTBasePlotter::beforeExporting()/JKQTBasePlotter::afterExporting() and JKQTBasePlotterJKQTBasePlotter:beforePrinting()/JKQTBasePlotter::afterPrinting() which allow to modify the plot just before and just after an export/print
  • NEW: Added new JKQTPCALabelType elements (JKQTPCALTfrac...), so axis label ticks can be displayed as fractions 1/2 instead of 0.5
    JKQTPCALTscientific, so axis label ticks can be displayed as numbers in scientific notation like 1.2E-34
    JKQTPCALTprintf for general formatting with a printf-format string
    JKQTPCALTformat for general formatting with a std::format-format string (available for C++>=20 only!!!)
  • NEW: all elements of a coordinate axis may have their own color now
  • NEW: added possibility to scale the axis ticks by a factor (e.g. pi) to generate axes with ticks 0pi, 1pi, 2pi ...
  • NEW: added option to draw a zero axis to JKQTPCoordinateAxis, which draws an axis at the origin of the coordinate system
  • NEW: barcharts (derived from JKQTPBarGraphBase) can be configured to use different fill styles above and below the baseline, see JKQTPBarGraphBase::FillMode
  • NEW: barcharts may have rounded corners now, via JKQTPBarGraphBase::setRectRadius()
  • NEW: barcharts can be colored by a user-specified functor
  • NEW: you can provide a custom draw functor to barcharts to completely customize their look
  • NEW: barcharts and impulse graphs may now draw their baseline as stylable line (default: off)
  • NEW: secondary axes: added functionality to manage additional secondary axes in a JKQTPBasePlotter and to select which x-/y-Axis to use for drawing a JKQTPPlotElement
  • NEW: You can use additional syntax derived from CCS to define colors in style.ini.files (or when using jkqtp_String2QColor() ): You can use full CSS-color syntax with functions "rgb(R,G,B)", "rgba(...)", "hsl(...)", "hsv(...)", "gray(...)", "green(...)", "red(...)", "blue(...)".
  • NEW: several new color palettes (especially stepped/categorial palettes), e.g. JKQTPMathImageColorPalette::JKQTPMathImageOkabeIto_STEP, JKQTPMathImageColorPalette::JKQTPMathImageIBMColorBlindSafe, JKQTPMathImageColorPalette::JKQTPMathImageIBMColorBlindSafe_STEP, ...
  • NEW: add color palettes from Green's HELIX method, see https://arxiv.org/abs/1108.5083, also see https://jiffyclub.github.io/palettable/cubehelix/, see JKQTPCreateGreensCubeHelixLUT() and e.g. JKQTPMathImageCubeHelixClassic, JKQTPMathImageCubeHelix1, ...
  • NEW: Using Q_SIGNALS/Q_SLOTS instead of signals/slots MOC-keywords ... this allows for interoperability with other signals/slots frameworks, thanks to user:nickmontini for the proposal
  • NEW: you can use any (preferably stepped/categorial) JKQTPMathImageColorPalette as default graph colors list in a style.ini file, by setting auto_styles/use_color_from_palette=PALETTE_NAME
  • NEW: added entry for JKQTBasePlotterStyle::plotLabelColor to set the plot label color
  • NEW: added JKQTBasePlotterStyle::plotLabelTopBorder to set the spacing between top and plot label
  • NEW: Due to addition of JKQTMathText::setFontOptions() and the matchign extension of JKQTMathText::setFontSpecial() (see below) you can now add modifiers like +BOLD+ITALIC to any font-name provided to JKQTPlotter and in style INI-files
  • NEW: added JKQTPLabelMinBesides and JKQTPLabelMaxBesides to JKQTPLabelPosition, so labels can be set besides the axes
  • NEW/REWORKED all functions in JKQTBasePlotter are re-entrant, i.e. different instances can be used from different threads in parallel (although there is some overhead due to shared caches between the threads!). This is demonstrated and discussed in Example (JKQTPlotter): Multi-Threaded (Parallel) Plotting .
  • NEW: allow linear-gradient(), currentcolor, ... in brush definitions of style.ini-file ... and using it is cyberpunk and dark styles
  • NEW: style simple_noaxes.ini
  • NEW: JKQTPXYGraphLabels which can draw a label next to each datapoint in the given x/y-dataset. The labels can be x-/y- or x&y-coordinates or custom, then defined by a user-supplied functor (+example Example (JKQTPlotter): Simple Graph Labels Example)
  • NEW: Base class JKQTPXYAndVectorGraph for graphs like vector fields, e.g. (x,y,dx,dy) or (x,y,angle,length)
  • NEW: JKQTPVectorFieldGraph for drawing "simple" vector fields/quiver plots (+example Example (JKQTPlotter): Vector Field Plot Example)
  • NEW: JKQTPParametrizedVectorFieldGraph for drawing color-coded vector fields/quiver plots (+example Example (JKQTPlotter): Vector Field Plot Example)
  • NEW: JKQTPFinancialGraph for drawing candlestick or OHLC graphs of financial data, such as stock amrket prices (+example Example (JKQTPlotter): Financial Chart (Candlestick/OHLC) Example)
  • NEW: stacked barcharts may have a small separation (default 1pt)
  • NEW: autoscaling for barcharts works now, also when stacked and unstacked charts are combined in one plot
  • NEW: JKQTPGeoBezierCurve for drawing bezier curves of degree 1-4 (+example Example (JKQTPlotter): Plotting Bezier Curves)
  • NEW: added JKQTPCoordinateAxis::setRangeFixed() which disables changing the axis range (and thus the zoom)
  • NEW: added JKQTPCoordinateAxis::getMin() and JKQTPCoordinateAxis::getMax() getters
  • NEW: added example Example (JKQTPlotter): Using a QScrollbar together with JKQtPlotter

• JKQTMathText:
  • FIXED: JKQTMathText added a little whitespace before and after the LaTeX-string. This was removed as it disturbed the layout of text in plots
  • FIXED: height-calculation of frac-like instructions: before the ascent and descent were equal, even if the numerator and denominator have different heights
  • FIXED: strikeoutPos was not correctly calculated in sub-/superscript node
  • FIXED: symbol spacing in math mode (and text mode)
  • FIXED/IMPROVED: JKQTMathText renders several LaTeX strings better (simple braces in math mode, +-*... as symbols with proper sizes in math mode, added some missing instruction aliases, improved size of \vec and \hat, corrrected fonts usage for \mathrm
  • FIXED: \sum and \prod used the wrong symbol in XITS-mode
  • FIXED issue #117: Unnecessary printing of tilde symbol in math (thanks to user:igormironchik for reporting):
    Tilde was not recognized as a LaTeX instruction, now is interpreted as non-breaking whitespace
  • FIXED issue #118: Dangerous warning in MacOS and clang (thanks to user:igormironchik for reporting):
    a forward-declared class (i.e. incomplete type) was deleted
  • FIXED issue #128: Question about rendering unicode in plot labels: Unicode characters were not rendered if they are not in the currently active font, as fallback-rendering was switched off. It is now switched on again for text and verbatim nodes. Thanks to user:fpalazzolo for reporting this bug
  • IMPROVED: high-dpr-support in JKQTMathText
  • IMPROVED: typesetting of sub-/supercripts, especially for large math operators and braces
  • MODIFIED: brace node now calculates the extension of the child height above or below the strikeoutPos, in order to center braces around the strikeoutPos
  • IMPROVED: improved drawing of parantheses, square brackets ... , underbrace/overbrace
  • IMPROVED: added x-correction for sub/superscript above/below/besides integrals
  • IMPROVED: rendering of sqrt
  • IMPROVED: rendering and size calculation of decorations
  • IMPROVED: tokenizing and parsing of text in text-mode: now a lot of accents with commands like \"a, \'e and variants (e.g. {\"a}, \"{a}, ...) are supported now
  • IMPROVED: all functions in JKQTMathText are re-entrant + diverse speed improvements for parallel use-cases (via caches)
  • IMPROVED/BREAKING: refactored symbol node JKQTMathTextSymbolNode and changed font-lookup!
  • IMPROVED/NEW/BREAKING: refactored whitespace-processing node JKQTMathTextWhitespaceNode, now all major LaTeX whitespace commands are supported properly
  • IMPROVED/NEW/BREAKING: refactored LaTeX parser in JKQTMathText
  • REMOVED/BREAKING: \v[a-zA-Z] and shorthand for \vec{a-zA-Z} was removed, implementation of \bbR,\bbC,... changed
  • MODIFIED/BREAKING: new options interface for JKQTMathText::parse()
  • EMOVED/BREAKING: removed JKQTMathtext::unparsedNode
  • IMPROVED/REWORKED rendering of text in text- and math-mode. Now it is more consistent with the output of LaTeX itself
  • IMPROVED/REWORKED rendering of blackboard font: now several different rendering modes can be selected using JKQTMathText::setFontBlackboradMode()
  • BREAKING/REWORKED: The \verb!...!-command now works the same as in LaTeX
  • BREAKING/REWORKED: Separated the LaTeX parser into JKQTMathTextLatexParser from JKQTMathText
  • BREAKING/CLEANUP: cleanup: Removed Parameter prevNodeSize from JKQTMathTextNode::draw() and JKQTMathTextNode::getSize()/JKQTMathTextNode::getSizeInternal(), since it is only really necessary for JKQTMathTextSubscriptNode and JKQTMathTextSuperscriptNode
  • BREAKING/CLEANUP: using JKQTMathTextNodeSize for all size-calculation functions and got rid of all functions that take the output parameters with call-by-reference, additional information can be outut by local size-classes that derive from JKQTMathTextNodeSize, see e.g. JKQTMathTextSymbolNode::NodeSize and JKQTMathTextSymbolNode::getSymbolSize()
  • NEW: JKQTMathTextVerticalListNode allows to typeset a vertical list of lines
  • NEW: JKQTMathText::parse() by default allows linebreaks in the LaTeX string to be parsed. This can be switched off by a parameter
  • NEW: added functions to set the font-size in pixels (as alternative to the existing functions that set them in points), implements request #76 from user:igormironchik
  • NEW: reworked drawing of decorations: improved appearance and positioning!
  • NEW: additional method JKQTMathtext::getSizeDetail() that returns all size-properties as a convenient struct, also added matching varinat JKQTMathTextNode::getSize()
  • NEW: additional method JKQTMathtext::drawIntoPixmap(), JKQTMathtext::drawIntoPicture(), JKQTMathtext::drawIntoImage() which returns a QPixmap, QPicture and QImage respectively that contains the render result of the currently parsed markup
  • NEW: array/tabular-environments have limited support for formatting string like l|r|c and for \hline , \hdashline , \toprule , \midrule , \bottomrule
  • NEW: reworked code structure: broke up large, single CPP-files into several smaller files!
  • NEW: reworked node class tree: inserted base-class nodes for single-child, dual-child!
  • NEW: improved frac-rendering: font-scaling takes nesting-level into account, overall-rendering, sizes, if a brace surrounds a frac, the heights are equal above and below to center the brace , ...
  • NEW: shows strikeoutPos when drawing Debug-Boxes
  • NEW: LaTeX-Parser understands optional instruction parameters in [...] now
  • NEW: LaTeX-Parser simplifies parse-tree to increase speed of execution
  • NEW: added new decoration instructions: \cancel, \xcancel, \bcancel, \sout, \ocirc, \widetilde, \widehat, \breve
  • NEW: \limits and \nolimits works as in LaTeX now (before it was simply removed and the functionality implemented for a fixed list of symbols)
  • NEW: added top-corner (\ulcorner/\urcorner ) and bottom-corner brackets (\llcorner/\lrcorner )
  • NEW: added \overbracket and \underbracket
  • NEW: added \shaded{color}{...}
  • NEW: added \dashbox{...}
  • NEW: added \dottedbox{...}
  • NEW: added \snugshade{...}
  • NEW: added \snugbox{...}
  • NEW: added \acute{X}, \grave{X}, \acute{X}
  • NEW: added \dashuline{X}, \dotuline{X}
  • NEW: added \underleftarrow{X}, \underrightarrow{X}, \underleftrightarrow{X}, \overleftarrow{X}, \overrightarrow{X}, \overleftrightarrow{X}
  • NEW: added \userfont{SystemFontName}{Text} instruction
  • NEW: added \unicode{HEX} and \utfeight{HEX} instruction to draw unicide characters by code
  • NEW: added \substack[lcr]{...\\...} , \lsubstack{...\\...} , \rsubstack{...\\...} instructions
  • NEW: added \phantom{xXy} , \vphantom{xXy} and \hphantom{xXy} instructions for whitespaces with the size of xXy
  • NEW: added \~{} , \^{}, \`{}, ... instructions
  • NEW: added support for flushleft/flushright/center-environments with linebreaks
  • NEW: added support for framed/shaded/snugshade-environments with linebreaks and framed
  • NEW: added support for – and — for en- and em-dashes
  • NEW: added support for \char"HEX , \char\'OCTAL and \charDECIMAL for inserting any uicode character code
  • NEW: added support for \bigl,\bigr,\Bigr,... commands for fixed-size but enlarged paramtheses
  • NEW: added support for \begin{verbatim}...\end{verbatim}, \begin{verbatim*}...\end{verbatim*}
  • NEW: added command line tool Tool (JKQTMathText): Command-Line Utility jkqtmathtext_render that renders LaTeX into images, using it to generate the documentation images for JKQTMathText
  • NEW: added environment-modifying commands for font sizes: \tiny ... \normalsize ... \Huge
  • NEW: added environment-modifying commands for text color: {\color{COL}...}
  • NEW: added environment-modifying commands for text formatting: {\bfseries...}, {\itshape...}, {\bf...}, {\it...}, {\sffamily...}, {\ttfamily...}, ...
  • NEW: Added the Fira Math fonts as sans-serif symbol font to the library (as a ressource) and added JKQTMathText::useFiraMath()
  • NEW: Added JKQTMathText::useGuiFonts()
  • NEW: Added JKQTMathText::setFontOptions(), which allows to make fonts initially e.g. bold, italic, ... and extended JKQTMathText::setFontSpecial() accordingly
• JKQTPCommon:
  • NEW: iadded variant of jkqtp_bounded<T>(TIn v), which limits to the limits of a type T and can cope with cases where TIn is signed, but T is unsigned
• JKQTFastPloter:
  • BREAKING: This class/library is now deprecated and will be removed in future versions!

trunk: Download

This release is available from

• Source code branch: https://github.com/jkriege2/JKQtPlotter
• Source Code download (ZIP): https://github.com/jkriege2/JKQtPlotter/archive/master.zip
• Git-Link: https://github.com/jkriege2/JKQtPlotter.git

V4.0.0: Qt6 compatibility & diverse improvements + bugfixes

V4.0.0: Overview

Changes, compared to v2019.11 include:

• fixed issue #34: Skip drawing the line for negative values in log plots, thanks to user:certik
• fixed issue #38: Buffer overflow, thanks to user:zertyz
• fixed issue #43: jkqtp_format() had undefined behaviour, thanks to user:Makis42
• fixed issue #41: Build error when JKQtPlotter_BUILD_INCLUDE_XITS_FONTS set to OFF , thanks to user:smistad
• fixed issue #37: CMake installs things into $PREFIX/doc/ *.txt , thanks to user:certik
• fixed issue #45: Build error on mac jkqtfastplotter.cpp:342:28: Variable has incomplete type 'QPainterPath', thanks to user:abdedixit
• merged PR #47: Some minor build fixes, thanks to user:patstew
• fixed issue #48: Cannot #include QPrintPreviewWidget, thanks to user:schlenger
• fixed issue #49: Incorrect tag in style .ini-files, thanks to user:smistad
• fixed issue #50: Double-Click Zoom Issue, thanks to user:Delfinos
• fixed issue #52: 'runtime_error': is not a member of 'std', thanks to user:gomgomi
• fixed issue #56: Logscale zoom multiple zeros? , thanks to user:sufuk
• merged PR #51: Bug: JKMathParser exception return local variable , thanks to user:StephanOostveen
• renamed/BREAKING change: renamed JKQTPPlotObject->JKQTPGeometricPlotElement and added new base class JKQTPPlotAnnotationElement
• renamed/BREAKING change: renamed JKQTPColorPaletteStyleAndToolsMixin::setPalette() -> JKQTPColorPaletteStyleAndToolsMixin::setColorPalette()
• removed/BREAKING change: removed the usage of some deprecated functions and objects (e.g. QMatrix)
• removed/BREAKING change: removed the overlay elements (derived from JKQTPOverlayElement), which were not very well set up and are more confusing than useful.
• improved/BREAKING change: geometric objects now use an adaptive drawing algorithm to represent curves (before e.g. ellipses were always separated into a fixed number of line-segments)
• improved/BREAKING change: geometric elements constructor: removed all styling properties, added setStyle()-functions to replace them. This is necessary to better work with the extended Styling system
• improved: constructors and access functions for several geometric objects (e.g. more constructors, additional functions to retrieve parameters in diferent forms, iterators for polygons, ...)
• improved/BREAKING change: reworked class hierarchy of parsed function plots and declared several setters as slots.
• improved/BREAKING change: reworked class hierarchy of bar & impulse charts.
• improved/BREAKING change: reworked class hierarchy of range charts.
• improved/BREAKING change: reworked class hierarchy of special line (step) graphs.
• improved/BREAKING change: reworked class hierarchy of filled line graphs.
• improved/BREAKING change: reworked class hierarchy of range plot elements (JKQTPVerticalRange and JKQTPHorizontalRange).
• improved/BREAKING change: reworked class hierarchy of boxplots.
• improved/BREAKING change: reworked class hierarchy of violin plots.
• improved/BREAKING change: extended styling system for graphs.
• improved/BREAKING change: reworked graph Base-Classes (promoted several setters to slots, added Q_PROPERTY- and Q_ENUM-declarations...)
• improved/BREAKING change: made more functions and function parameters const
• improved/BREAKING change: image plots now manage CONST-data, not plain pointer arrays... This is OK, since the raw data is never owned nor modified by the plot, only referenced!.
• bugfixed/improved: aspect ratio handling in JKQTPlotter.
• new: switching to semantic versioning ... starting with v4.0.0
• new: Compatibility with Qt 5.15 and Qt6
• new: added support for high-dpi devices (thanks for PR #55: Enable high-dpi support for plots by user:akenmorris.
• new: added geometric plot objects JKQTPGeoArrow to draw arrows (aka lines with added line-end decorators, also extended JKQTPGeoLine, JKQTPGeoInfiniteLine, JKQTPGeoPolyLines to draw line-end decorator (aka arrows)
• new: all geometric objects can either be drawn as graphic element (i.e. lines are straight line, even on non-linear axes), or as mathematical curve (i.e. on non-linear axes, lines become the appropriate curve representing the linear function, connecting the given start/end-points). The only exceptions are ellipses (and the derived arcs,pies,chords), which are always drawn as mathematical curves
• new: a new graph class JKQTPXYFunctionLineGraph draws parametric 2D curves ( \f$ [x,y] = f(t) \f$ ), see Example (JKQTPlotter): Plotting Parametric Mathematical Curves as Line Graphs for an example
• new: added several new copy/set-functions to JKQTPDatastore
• new: added JKQTPlotter signal, when widget was resized
• new: added JKQTPFilledHorizontalRangeGraph, complementing JKQTPFilledVerticalRangeGraph

V4.0.0: Download

This release is available from

• Source code branch: https://github.com/jkriege2/JKQtPlotter/tree/v4.0.0
• Latest Release/Tag: https://github.com/jkriege2/JKQtPlotter/releases/tag/v4.0.0 (2021-April-xx)

v2019.11: Major rework of the library

Starting in summer 2018, JKQTPlotter received some major workover. During this, it lost compatibility to the QuickFit 3.0 code base.

v2019.11: Overview

Changes, compared to v2018.08 include:

• new: CMake-base build, which deprecated the QMake-build
• new: added QMake-Projects for static and for shared library builds
• new: extensive set of Examples and Tutorials
• new: checked builds with continuous integration from AppVeyor: https://ci.appveyor.com/project/jkriege2/jkqtplotter/branch/master
• new/update: support for building with Microsoft Visual Studio (Win), MinGW (Win), GCC (Linux/MacOS)
• update: massively improved (doxygen-generated) Online-Documentation (http://jkriege2.github.io/JKQtPlotter/index.html) (automatically generated after each commit using ravis CI)
• update: refactoring of the library's directory structure
• update: refactoring/renaming of API, including the function anming scheme and class names
• changed: using static const variables instead of #define for fixed default values (e.g. JKQTPImageTools::LUTSIZE, JKQTPImageTools::PALETTE_ICON_WIDTH, JKQTPlotterDrawinTools::ABS_MIN_LINEWIDTH, JKQTMathText::ABS_MIN_LINEWIDTH ...)
• Updates to JKQTPlotter:
  • new: added JKQTPSingleColumnSymbolsGraph for single-column data, e.g. drawn as (random) scatter or bee-swarm or rug plots
  • new: stacked barcharts with JKQTPBarVerticalStackableGraph, JKQTPBarHorizontalStackableGraph
  • new: use/support of C++11 features (e.g. \c std::function<> and lambda functions in JKQTPXFunctionLineGraph / JKQTPYFunctionLineGraph )
  • new: optional OpenCV interface
  • new: optional CImg interface
  • new: Styling System for JKQTPlotter
  • new: added debugging option, which surrounds different regions with visible rectangles (JKQTBasePlotter::enableDebugShowRegionBoxes() )
  • new: frames (plot viewport, key/legend ...) may be rounded off at the corners
  • new: diverse new styling options (default font name/size ...)
  • new: additionl options for styling coordinate axes
  • new: Mix-In classes to unify plot styleing functions (setters/getters) in all graphs
  • new: additional options for graph filling (color gradients, textures, ...) as provided by QBrush
  • new: added a general feature to JKQTPPlotElement which allows to show a graph in a highlighted state (if supported by the derived graph class!)
  • new: JKQTPXYParametrizedScatterGraph: added functors to transform column values into symbol type+size and line-width to give even more control
  • new: user-interaction tool that shows coordinates of data points near the current mouse position (when mouse is dragged, while mouse button is pressed), see: jkqtpmdaToolTipForClosestDataPoint
  • new: user-interaction tool that measures distances and angles when mouse is dragged, while mouse button is pressed), see: jkqtpmdaRuler
  • new: advanced styling options for boxplots + example for the styling: Example (JKQTPlotter): Styling different aspects of boxplots
  • new: notched boxplots, see: Example (JKQTPlotter): Styling different aspects of boxplots
  • new: several new plot symbols, see: JKQTPGraphSymbols
  • new: Statistics library with functions to calculate histograms, regression, kernel density estimates, ... see: Statistical Computations
  • new: iterator interface and improved documentation for JKQTPDatastore
  • new: violin plots (see Example (JKQTPlotter): Violin Plots )
  • changed: removed old selection-code and replaced by general highlighting feature
  • changed: JKQTPStepHorizontalGraph has been renamed to JKQTPSpecialLineHorizontalGraph (vertical variants also) and have gained additional features (baseline for filling and drawing of symbols)
  • changed: filled curve graphs (e.g. JKQTPSpecialLineHorizontalGraph) are now merely a specializedly initialized JKQTPSpecialLineHorizontalGraph
  • removed: Removed datarange-feature
  • update: reworked user interactions API
  • update: reworked error indicator base classes
  • update: improvements to contour plots (e.g. highlighting single contour levels, split into a class for simple C-arrays [JKQTPContourPlot] and one for image data in a JKQTPDatastore column [JKQTPColumnContourPlot]) + added example, see JKQTPColumnContourPlot and Example (JKQTPlotter): Contour Plots
  • fixed: colorbars at top were positioned over the plot label
  • fixed: RGB-image plots now work properly with inverted axes (image is inverted, befor image was not shown at all)
• Updates to JKQTMathText:
  • new: slanted fractions (\sfrac{}{}, \stfrac{}{})
  • update/fix: several general improvements and bugfixes
  • update/fix: improved error handling
  • update: updated contained version of STIX fonts, better handling of different STIX versions
  • update: improved documentation

v2019.11: Download

This release is available from

• Source code branch: https://github.com/jkriege2/JKQtPlotter/tree/v2019.11
• Latest Release/Tag: https://github.com/jkriege2/JKQtPlotter/releases/tag/v2019.11.1 (2019-Dec-05)

v2018.08: Minor Modifications (Final QuickFit3-compatible Version)

v2018.08: Overview

This is the final version of JKQTPlotter, which is still compatible with the QuickFit 3.0 code base. It contains minor changes as compared to v2015.10

• new: added Qt data model to switch graphs on/off
• update: some improvements to test programs

v2018.08: Download

This release is available from

• Source code branch: https://github.com/jkriege2/JKQtPlotter/tree/v2018.08
• Latest Release/Tag: https://github.com/jkriege2/JKQtPlotter/releases/tag/v2018.08 (2018-Aug-19)

v2015.10: Initial Release

v2015.10: Overview

This is the initial release of the library. It was developed initially as part of QuickFit 3.0 and then separated out into a separate repository.

v2015.10: Download

This release is available from

• Source code branch: https://github.com/jkriege2/JKQtPlotter/tree/v2015.10
• Latest Release/Tag: https://github.com/jkriege2/JKQtPlotter/releases/tag/v2015.10 (2015-Oct-20)