These release notes are for version 5.2 patchlevel 1 (5.2.2).
This release contains bug-fixes, a few changes back-ported from the
development version, and a few new features.
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-Nov-2017
- 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.
- 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 two output modes 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.
Terminal drivers for Next/Openstep and Sun workstations are no longer
included. Legacy terminal for coreldraw is no longer built by default.
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.
Both allow zooming, toggling plot elements on/off, and user-scriptable
hot keys.
You can download a source tarball for gnuplot version 5.2.2 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.2 ; ./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.
At the time of writing both the released and development source trees are
hosted as a CVS repository on SourceForge, but are in the process of
conversion to git.