These release notes are for version 5.2 patchlevel 5 (5.2.5).
This release contains bug-fixes, a few changes back-ported from the
development version, and a few new features. The most notable fixes are
(1) improved clipping of lines or other plot elements that would otherwise
extend beyond the edges of the plot.
(2) in versions 5.2.0 through 5.2.4 function plots in parametric and polar
modes did not work with logscale x axis.
Please see the ChangeLog file for a complete list of changes made during the
course of development from 5.0 to 5.2.
Release Notes date: 01-October-2018
- NEW "set pm3d depthorder base" sorts pm3d quadrangles by projecting to z=0
- NEW "set jitter vertical" displaces y coordinate rather than x coordinate
- NEW array size can be determined automatically from the initializer
- CHANGE equivalent slope constraint for mcs splines at both ends of the range
- CHANGE treat imaginary values plotted from a using spec as UNDEFINED (NaN)
- CHANGE allow "reset" between plots in a multiplot layout
- CHANGE Deprecate linux and vgagl terminals (to be removed in 5.3)
- CHANGE placement of axis and tic labels in 3D projections on to xz or yz plane
- CHANGE default to ./configure --without-wx-multithreading
- FIX parametric function plots did not work with logscale x (regression in 5.2.0-4)
- FIX polar mode "set trange" was assumed to use radians, now it tracks "set angle"
- FIX clip polar grid lines and ticks to x/y range limits
- FIX clipping of plot "with lines" when axes are nonlinear (regression from 5.0)
- FIX clipping of all elements in finanacebars/candlesticks/boxplots
- FIX clipping of 3D splot "with labels"
- FIX strange interaction of "noautoscale" with blank data lines
- FIX alignment of boxed text to center for eps/cairolatex
- FIX incompatibility of "pm3d depthorder" and rgb color taken from data column
- FIX aqua terminal font changes in enhanced text mode
- NEW "call" parameters ARG1, ARG2, ... are also present as ARGV[1]...ARGV[ARGC]
- CHANGE generalize the test for missing data flag in input data
- CHANGE "set []range writeback" is now essentially always in effect
- CHANGE consistent placement of timestamp at true bottom of page
- FIX spurious evaluation of logscale coordinates as UNDEFINED
- FIX column header title assignments for histogram with errorbars
- FIX re-implement "refresh" command to use autoscale writeback/restore
- FIX font-handling bug; line-spacing of previous font still in effect
- FIX post, svg, dumb terminals: early fontsize initialization
- NEW "set grid {no}vertical" adds grid lines in the xz and yz planes
- NEW "set cntrparam {firstlinetype N} {{un}sorted}"
- CHANGE drop non-working support for YIQ color space
- CHANGE expand \n characters when printing into a datablock
- CHANGE allow contour plots to opt out of hidden3d processing
- CHANGE special-case code to speed up handling of logscale axes
- CHANGE do not write GPFUN_* variables to "save" output file
- CHANGE default to density 100 for "set fs solid", 50 for "set fs transparent"
- FIX potential buffer overflow in gprintf formats containing %%
- FIX immediate response to ctrl-Z when libreadline is used for input
- FIX warning messages inside a bracketed clause could trigger early exit
- FIX tweak logscale tic range limits and minor tic generation intervals
- FIX stats FOO using 'namedcolumn' name columnhead
- FIX clipping of INRANGE->UNDEFINED line segments
- FIX use of logscale y axis in "set view map" or "set pm3d map" modes
- FIX placement of colorbox in "set view map" mode
- FIX autoscaled axis range of logscale axes in "set view map" mode
- FIX polar mode "with yerrorbars" error bars are radial, not vertical
- FIX clipping of circles whose center is offscreen to the left or bottom
- FIX canvas terminal: apply both color and alpha channel to points and lines
- FIX svg terminal: apply current color to dots
- FIX qt terminal: include "notitle" plots in accounting for toggle operations
- FIX svg terminal: point plot empty title produced spurious mousing directive
- FIX tikz terminal: failed to recognize dashtype 1
- NEW set table separator {tab|comma|"char"} allows creation of csv files
- NEW hotkey for changing azimuth in 3D plots with mousing
- NEW titles for "splot .. with lines" can be placed at {beg|end} of plotted line
- NEW Rework gstrptime() to handle relative time formats tH tM tS
- NEW command 'set rgbmax <value>' controls interpretation of input RGB values
- CHANGE restore pre-5.2 interpretation of logscaled tic increment as a multiplier
- CHANGE allow mixed use of in-key plot titles and manually placed titles
- CHANGE more documentation on use of pipes to input data
- FIX autoscaling of plots with spline or bezier smoothing
- FIX autoscaling of plots with linked axes where data is plotted on x2 or y2
- FIX "with filledcurves below y=foo" mishandled the case of y value exactly = foo
- FIX [windows] repair breakage of stderr/stdout redirection to console
- FIX postscript terminal artifacts when drawing dot/dash circles
- FIX handle empty range on logscale y axis as a warning, not an error
- FIX allow set xrange [explicit_min:*] for stacked histograms
- NEW plot styles and options
- splot ... using <x>:<y>:<z>:<zlow>:<zhigh> with zerrorfill
- "set jitter" allows creation of bee swarm plots
- data filter "bins" sorts input into equal width bins on x
- "with points" and "with linespoints" accept `pointtype variable`
- hidden3d now treats 'image' and 'rgbimage' as occluding rectangles
- "smooth fnormal" plots normalized frequency
- allow sampling interval in range specifiers for pseudofiles '+' '++'
- "plot with table" can handle string-valued output columns
- NEW polar mode improvements and extensions
- "set [m]ttics" places theta tics and labels on perimeter of polar grid
- "set rlabel" places a label above the r axis
- "set rrange [90:0]" plots in celestial horizontal coordinates
- "set border polar" uses border linetype for perimeter of polar plot
- "set theta <origin> <sense>" orientation of polar coordinate theta
- label, arrow, and object positions may be given in polar coordinates
- NEW nonlinear coordinate systems
- "set nonlinear <axis> via f(axis) inverse g(axis)"
- "set log" re-implemented as special case of "set nonlinear"
- NEW data type array[size]
- any element A[i] of an array may be an integer, complex, or string value
- operator |A| gives the cardinality of array A
- NEW commands and command options
- "break" exits from iteration loop
- "continue" begins next iteration immediately
- "toggle {<plotno> | "plottitle" | all}"
- "set pm3d lighting" specifies lighting model with specular highlighting
- "set table OUTFILE {append}"
- "set minussign" and "set micro" (first appeared in 5.0.5)
- "set view azimuth <angle>" controls azimuth of the z axis in 3D plots
- "save fit <filename>" replaces deprecated command "update"
- "set style textbox" supports fillcolor and bordercolor
- NEW terminals and terminal options
- terminal domterm (supports in-line SVG in DomTerm terminal emulator)
- terminal sixelgd (sixel terminal graphics using gdlib)
- svg 'standalone' embeds images rather than including by reference
- windows terminal supports saving graph as bitmap
- windows graph windows can be docked to the wgnuplot text window
- wxt supports saving graph as EMF on Windows
- wxt supports printing on Windows
- dumb supports ANSI colors and filled polygons
- NEW gnuplot on Windows
- converts Unicode (BMP) input to current `set encoding`, including UTF-8
- the program is system DPI aware
Gnuplot development assigns very high priority to backward compatibility
with earlier versions. However changes introduced in version 5 can affect
the operation of some version 4 scripts. Please see section
"Differences from Version 4" in the User Manual.
The "update" command is still recognized in version 5.2 but is deprecated
and will be removed in the next version. Use "save fit" instead.
The control variable of an iteration loop is strictly limited in scope
to the iteration it controls. The value of any previous variable with
that name is restored after iteration. The same is true for an iteration
associated with a sampling range in a plot or splot command.
- Auto-placement of axis labels, title, and other text items
on the page has changed slightly since version 5.0
- point style associated with "plot with labels" is shown in the key
- text properties for the key title are separate from the key entries
- order of margins in `set margins <left>, <right>, <bottom>, <top>`
- Store and reuse x,y dimensions at the time image data is read in
- Some STATS_foo variables are of type integer rather than real (complex)
- ^R starts a backward search when using the built-in readline
- Only update axis->data_min/max if the point being stored is INRANGE
- auto-generation of minitics on logscale axis has changed
- revised printing dialogs on Windows
- preserve whitespace following opening { in enhanced text strings
- windows terminal provides better oversampling
- New default "set key fixed" prevents 3D key box from rotating with plot
- windows terminal also uses GDI+ for printing and copy-to-clipboard
- raxis/polar grid can coexist with Cartesian axes
- evaluation of norm(x) or x**y returns 0 on floating underflow
- support for space-in-x11-raises-KDE3-konsole is now a configure option
- don't use loadpath to choose output directory for "save"
- GNUTERM may contain terminal options in addition to bare terminal name
- RGB color components of "with rgbimage" are always in the range [0:255]
(i.e. not affected by "set cbrange")
Demo plots illustrating new and old features are online at
http://gnuplot.sourceforge.net/demo_5.2/
- If you configure in the wxt terminal on linux you may need
to manually set the environmental variable TERMLIBS during configuration:
- TERMLIBS="-lX11" ./configure
- Some people have reported runtime problems when the wxt terminal uses
wxgtk library versions 3.0.x. If you have the option of linking against
wxgtk version 2.8 instead, this may be a better choice.
- Compilation on Solaris may require adding -liconv to LIB_FLAGS
Building the plugin demo with a SunPro Compiler requires changing the
build flags as shown in comments in ./demo/plugin/Makefile.am
- Font initialization on OSX can be very slow, causing the qt terminal to
issue warning or error messages for the first plot command.
- The antialiasing option produces artifacts in some versions of Qt.
In particular point types 1 and 2 appear unbalanced due to shading.
- You can configure support for both wxt and qt into the same gnuplot
executable, but only one of these can be used in any given gnuplot session.
- The gnuplot build system is not very good at figuring out where to find
or install LaTeX-related files. This can affect use of the lua/tikz
and ConTeXt terminals.
- Using mouse clicks to toggle individual plots on/off does not always
work correctly for multiplots if the key box is opaque.
Toggling plots drawn in hidden3d mode (hidden line removal) does not work.
- Mouse double-click to export terminal coordinates to the X11 clipboard
no longer works reliably, and may be deprecated in the future.
The "gnuplot mode" elisp and TeX files for use with emacs are now
maintained as a separate project: https://github.com/bruceravel/gnuplot-mode
so there is no longer a configuration option --with-lisp-files.
The TeX tutorial produced by --with-tutorial is horribly out of date.
./configure --enable-backwards-compatibility will allow use of some
deprecated syntax from old gnuplot versions. However the result of
using these deprecated commands may not match the old version output.
The 5.2 source code supports three primary cross-platform interactive
modes in addition to several platform-specific modes.
- Qt
The qt terminal supports interactive display with menu-driven
output to png, svg or pdf. If either Qt4 or Qt5 is detected by the
configure script, this will be the default terminal. It is now the
fastest and most full-featured interactive terminal option.
To disable this terminal:
./configure --without-qt
To force use of Qt4 even if Qt5 is present:
./configure --with-qt=qt4
- Cairo/pango/wxWidgets
This set of terminals includes
- X11 (the "classic" interactive interface)
This used to be the preferred interactive interface, but the newer
wxt and qt terminals offer nicer output and a wider range of features.
Of course the terminals (output modes) present in previous gnuplot versions
are also still available. These include, among many more obscure options:
- Mouseable output for display on the web can be created using either
the canvas terminal (HTML5 2D canvas element) or the svg terminal.
You can download a source tarball for gnuplot version 5.2.3 from the
gnuplot development site on SourceForge.
http://sourceforge.net/projects/gnuplot
Installation instructions are available in the source itself; the short
version for linux/unix-like systems is to unpack the tarball and then
build it:
cd gnuplot-5.2.3 ; ./configure ; make
test it:
make check
install it:
make install
Pay careful attention to the output of the ./configure script.
It may indicate that some output drivers have been omitted because the
necessary support libraries were not found. In general you need to have
previously installed the "-devel-" versions of these libraries.
Please report all bugs and installation problems to the bug tracker
on SourceForge:
https://sourceforge.net/p/gnuplot/bugs/
There is also an gnuplot discussion forum on usenet group
comp.graphics.apps.gnuplot
Gnuplot development is ongoing. The development branch contains preliminary
implementations of new features. The current development version is 5.3
(odd minor number) and will eventually be released as version 5.4 (even
minor number). Bugfixes to version 5.2 will appear in patchlevel releases
5.2.1, 5.2.2, etc., approximately twice a year or as needed to correct a
serious problem.
Note: development has recently moved from cvs to git. Many of the files
in the 5.2.4 source distribution still contain a cvs version identifier
$RCSid and date, but these are not current if the file has been changed
since the move to git.