Public Member Functions
	Gnuplot (const std::string &style="points")
	set a style during construction More...

	Gnuplot (const std::vector< double > &x, const std::string &title="", const std::string &style="points", const std::string &labelx="x", const std::string &labely="y")
	plot a single std::vector at one go More...

	Gnuplot (const std::vector< double > &x, const std::vector< double > &y, const std::string &title="", const std::string &style="points", const std::string &labelx="x", const std::string &labely="y")
	plot pairs std::vector at one go More...

	Gnuplot (const std::vector< double > &x, const std::vector< double > &y, const std::vector< double > &z, const std::string &title="", const std::string &style="points", const std::string &labelx="x", const std::string &labely="y", const std::string &labelz="z")
	plot triples std::vector at one go More...

	~Gnuplot ()
	destructor: needed to delete temporary files More...

Gnuplot &	cmd (const std::string &cmdstr)
	send a command to gnuplot More...

Gnuplot &	operator<< (const std::string &cmdstr)
	Sends a command to an active gnuplot session, identical to cmd() send a command to gnuplot using the << operator. More...

Gnuplot &	showonscreen ()
	sets terminal type to terminal_std More...

Gnuplot &	savetops (const std::string &filename="gnuplot_output")
	saves a gnuplot session to a postscript file, filename without extension More...

Gnuplot &	set_style (const std::string &stylestr="points")

Gnuplot &	set_smooth (const std::string &stylestr="csplines")

Gnuplot &	unset_smooth ()
	unset smooth attention: smooth is not set by default More...

Gnuplot &	set_pointsize (const double pointsize=1.0)
	scales the size of the points used in plots More...

Gnuplot &	set_grid ()
	turns grid on/off More...

Gnuplot &	unset_grid ()
	grid is not set by default More...

Gnuplot &	set_multiplot ()

Gnuplot &	unset_multiplot ()

Gnuplot &	set_samples (const int samples=100)
	set sampling rate of functions, or for interpolating data More...

Gnuplot &	set_isosamples (const int isolines=10)
	set isoline density (grid) for plotting functions as surfaces (for 3d plots) More...

Gnuplot &	set_hidden3d ()

Gnuplot &	unset_hidden3d ()

Gnuplot &	set_contour (const std::string &position="base")

Gnuplot &	unset_contour ()

Gnuplot &	set_surface ()

Gnuplot &	unset_surface ()

Gnuplot &	set_legend (const std::string &position="default")

Gnuplot &	unset_legend ()
	Switches legend off attention:legend is set by default. More...

Gnuplot &	set_title (const std::string &title="")
	sets and clears the title of a gnuplot session More...

Gnuplot &	unset_title ()
	Clears the title of a gnuplot session The title is not set by default. More...

Gnuplot &	set_ylabel (const std::string &label="x")
	set x axis label More...

Gnuplot &	set_xlabel (const std::string &label="y")
	set y axis label More...

Gnuplot &	set_zlabel (const std::string &label="z")
	set z axis label More...

Gnuplot &	set_xrange (const double iFrom, const double iTo)
	set axis - ranges More...

Gnuplot &	set_yrange (const double iFrom, const double iTo)
	set y-axis - ranges More...

Gnuplot &	set_zrange (const double iFrom, const double iTo)
	set z-axis - ranges More...

Gnuplot &	set_xautoscale ()

Gnuplot &	set_yautoscale ()

Gnuplot &	set_zautoscale ()

Gnuplot &	set_xlogscale (const double base=10)
	turns on/off log scaling for the specified xaxis (logscale is not set by default) More...

Gnuplot &	set_ylogscale (const double base=10)
	turns on/off log scaling for the specified yaxis (logscale is not set by default) More...

Gnuplot &	set_zlogscale (const double base=10)
	turns on/off log scaling for the specified zaxis (logscale is not set by default) More...

Gnuplot &	unset_xlogscale ()

Gnuplot &	unset_ylogscale ()

Gnuplot &	unset_zlogscale ()

Gnuplot &	set_cbrange (const double iFrom, const double iTo)
	set palette range (autoscale by default) More...

Gnuplot &	plotfile_x (const std::string &filename, const unsigned int column=1, const std::string &title="")

template<typename X >
Gnuplot &	plot_x (const X &x, const std::string &title="")
	from std::vector More...

Gnuplot &	plotfile_xy (const std::string &filename, const unsigned int column_x=1, const unsigned int column_y=2, const std::string &title="")

template<typename X , typename Y >
Gnuplot &	plot_xy (const X &x, const Y &y, const std::string &title="")
	from data More...

Gnuplot &	plotfile_xy_err (const std::string &filename, const unsigned int column_x=1, const unsigned int column_y=2, const unsigned int column_dy=3, const std::string &title="")

template<typename X , typename Y , typename E >
Gnuplot &	plot_xy_err (const X &x, const Y &y, const E &dy, const std::string &title="")
	from data More...

Gnuplot &	plotfile_xyz (const std::string &filename, const unsigned int column_x=1, const unsigned int column_y=2, const unsigned int column_z=3, const std::string &title="")

template<typename X , typename Y , typename Z >
Gnuplot &	plot_xyz (const X &x, const Y &y, const Z &z, const std::string &title="")
	from std::vector More...

Gnuplot &	plot_slope (const double a, const double b, const std::string &title="")
	plot an equation of the form: y = ax + b, you supply a and b More...

Gnuplot &	plot_equation (const std::string &equation, const std::string &title="")

Gnuplot &	plot_equation3d (const std::string &equation, const std::string &title="")

Gnuplot &	plot_image (const unsigned char *ucPicBuf, const unsigned int iWidth, const unsigned int iHeight, const std::string &title="")
	plot image More...

Gnuplot &	replot (void)
	replot repeats the last plot or splot command. this can be useful for viewing a plot with different set options, or when generating the same plot for several devices (showonscreen, savetops) More...

Gnuplot &	reset_plot ()
	resets a gnuplot session (next plot will erase previous ones) More...

Gnuplot &	reset_all ()
	resets a gnuplot session and sets all variables to default More...

void	remove_tmpfiles ()
	deletes temporary files More...

bool	is_valid ()
	Is the gnuplot session valid ?? More...

Static Public Member Functions
static bool	set_GNUPlotPath (const std::string &path)
	optional function: set Gnuplot path manual attention: for windows: path with slash '/' not backslash '\' More...

static void	set_terminal_std (const std::string &type)

Constructor & Destructor Documentation

◆ Gnuplot() [1/4]

Gnuplot::Gnuplot ( const std::string & style = "points" )

set a style during construction

◆ Gnuplot() [2/4]

Gnuplot::Gnuplot	(	const std::vector< double > &	x,
		const std::string &	title = `""`,
		const std::string &	style = `"points"`,
		const std::string &	labelx = `"x"`,
		const std::string &	labely = `"y"`
	)

plot a single std::vector at one go

◆ Gnuplot() [3/4]

Gnuplot::Gnuplot	(	const std::vector< double > &	x,
		const std::vector< double > &	y,
		const std::string &	title = `""`,
		const std::string &	style = `"points"`,
		const std::string &	labelx = `"x"`,
		const std::string &	labely = `"y"`
	)

plot pairs std::vector at one go

◆ Gnuplot() [4/4]

Gnuplot::Gnuplot	(	const std::vector< double > &	x,
		const std::vector< double > &	y,
		const std::vector< double > &	z,
		const std::string &	title = `""`,
		const std::string &	style = `"points"`,
		const std::string &	labelx = `"x"`,
		const std::string &	labely = `"y"`,
		const std::string &	labelz = `"z"`
	)

plot triples std::vector at one go

◆ ~Gnuplot()

Gnuplot::~Gnuplot ( )

destructor: needed to delete temporary files

Member Function Documentation

◆ cmd()

Gnuplot & Gnuplot::cmd ( const std::string & cmdstr )

send a command to gnuplot

◆ is_valid()

bool Gnuplot::is_valid ( )

inline

Is the gnuplot session valid ??

Parameters

—

Returns: true if valid, false if not

◆ operator<<()

Gnuplot& Gnuplot::operator<< ( const std::string & cmdstr )

inline

Sends a command to an active gnuplot session, identical to cmd() send a command to gnuplot using the << operator.

Parameters

cmdstr --> the command string

Returns: <– a reference to the gnuplot object

◆ plot_equation()

Gnuplot & Gnuplot::plot_equation	(	const std::string &	equation,
		const std::string &	title = `""`
	)

plot an equation supplied as a std::string y=f(x), write only the function f(x) not y= the independent variable has to be x binary operators: ** exponentiation, * multiply, / divide, + add, - substract, % modulo unary operators: - minus, ! factorial elementary functions: rand(x), abs(x), sgn(x), ceil(x), floor(x), int(x), imag(x), real(x), arg(x), sqrt(x), exp(x), log(x), log10(x), sin(x), cos(x), tan(x), asin(x), acos(x), atan(x), atan2(y,x), sinh(x), cosh(x), tanh(x), asinh(x), acosh(x), atanh(x) special functions: erf(x), erfc(x), inverf(x), gamma(x), igamma(a,x), lgamma(x), ibeta(p,q,x), besj0(x), besj1(x), besy0(x), besy1(x), lambertw(x) statistical fuctions: norm(x), invnorm(x)

◆ plot_equation3d()

Gnuplot & Gnuplot::plot_equation3d	(	const std::string &	equation,
		const std::string &	title = `""`
	)

plot an equation supplied as a std::string z=f(x,y), write only the function f(x,y) not z= the independent variables have to be x and y

◆ plot_image()

Gnuplot & Gnuplot::plot_image	(	const unsigned char *	ucPicBuf,
		const unsigned int	iWidth,
		const unsigned int	iHeight,
		const std::string &	title = `""`
	)

plot image

note that this function is not valid for versions of GNUPlot below 4.2

◆ plot_slope()

Gnuplot & Gnuplot::plot_slope	(	const double	a,
		const double	b,
		const std::string &	title = `""`
	)

plot an equation of the form: y = ax + b, you supply a and b

◆ plot_x()

template<typename X >

Gnuplot& Gnuplot::plot_x	(	const X &	x,
		const std::string &	title = `""`
	)

inline

from std::vector

◆ plot_xy()

template<typename X , typename Y >

Gnuplot& Gnuplot::plot_xy	(	const X &	x,
		const Y &	y,
		const std::string &	title = `""`
	)

inline

from data

◆ plot_xy_err()

template<typename X , typename Y , typename E >

Gnuplot& Gnuplot::plot_xy_err	(	const X &	x,
		const Y &	y,
		const E &	dy,
		const std::string &	title = `""`
	)

inline

from data

◆ plot_xyz()

template<typename X , typename Y , typename Z >

Gnuplot& Gnuplot::plot_xyz	(	const X &	x,
		const Y &	y,
		const Z &	z,
		const std::string &	title = `""`
	)

inline

from std::vector

◆ plotfile_x()

Gnuplot & Gnuplot::plotfile_x	(	const std::string &	filename,
		const unsigned int	column = `1`,
		const std::string &	title = `""`
	)

plot a single std::vector: x from file

◆ plotfile_xy()

Gnuplot & Gnuplot::plotfile_xy	(	const std::string &	filename,
		const unsigned int	column_x = `1`,
		const unsigned int	column_y = `2`,
		const std::string &	title = `""`
	)

plot x,y pairs: x y from file

◆ plotfile_xy_err()

Gnuplot & Gnuplot::plotfile_xy_err	(	const std::string &	filename,
		const unsigned int	column_x = `1`,
		const unsigned int	column_y = `2`,
		const unsigned int	column_dy = `3`,
		const std::string &	title = `""`
	)

plot x,y pairs with dy errorbars: x y dy from file

◆ plotfile_xyz()

Gnuplot & Gnuplot::plotfile_xyz	(	const std::string &	filename,
		const unsigned int	column_x = `1`,
		const unsigned int	column_y = `2`,
		const unsigned int	column_z = `3`,
		const std::string &	title = `""`
	)

plot x,y,z triples: x y z from file

◆ remove_tmpfiles()

void Gnuplot::remove_tmpfiles ( )

deletes temporary files

◆ replot()

Gnuplot& Gnuplot::replot ( void )

inline

replot repeats the last plot or splot command. this can be useful for viewing a plot with different set options, or when generating the same plot for several devices (showonscreen, savetops)

Parameters

—

Returns: —

◆ reset_all()

Gnuplot & Gnuplot::reset_all ( )

resets a gnuplot session and sets all variables to default

◆ reset_plot()

Gnuplot & Gnuplot::reset_plot ( )

resets a gnuplot session (next plot will erase previous ones)

◆ savetops()

Gnuplot & Gnuplot::savetops ( const std::string & filename = "gnuplot_output" )

saves a gnuplot session to a postscript file, filename without extension

◆ set_cbrange()

Gnuplot & Gnuplot::set_cbrange	(	const double	iFrom,
		const double	iTo
	)

set palette range (autoscale by default)

◆ set_contour()

Gnuplot & Gnuplot::set_contour ( const std::string & position = "base" )

enables/disables contour drawing for surfaces (for 3d plot) base, surface, both

◆ set_GNUPlotPath()

bool Gnuplot::set_GNUPlotPath ( const std::string & path )

static

optional function: set Gnuplot path manual attention: for windows: path with slash '/' not backslash '\'

Parameters

path	--> the gnuplot path

Returns: true on success, false otherwise

◆ set_grid()

Gnuplot& Gnuplot::set_grid ( )

inline

turns grid on/off

◆ set_hidden3d()

Gnuplot& Gnuplot::set_hidden3d ( )

inline

enables/disables hidden line removal for surface plotting (for 3d plot)

Parameters

—

Returns: <– reference to the gnuplot object

◆ set_isosamples()

Gnuplot & Gnuplot::set_isosamples ( const int isolines = 10 )

set isoline density (grid) for plotting functions as surfaces (for 3d plots)

◆ set_legend()

Gnuplot & Gnuplot::set_legend ( const std::string & position = "default" )

switches legend on/off position: inside/outside, left/center/right, top/center/bottom, nobox/box

◆ set_multiplot()

Gnuplot& Gnuplot::set_multiplot ( )

inline

set the mulitplot mode

Parameters

—

Returns: <– reference to the gnuplot object

◆ set_pointsize()

Gnuplot & Gnuplot::set_pointsize ( const double pointsize = 1.0 )

scales the size of the points used in plots

◆ set_samples()

Gnuplot & Gnuplot::set_samples ( const int samples = 100 )

set sampling rate of functions, or for interpolating data

◆ set_smooth()

Gnuplot & Gnuplot::set_smooth ( const std::string & stylestr = "csplines" )

interpolation and approximation of data, arguments: csplines, bezier, acsplines (for data values > 0), sbezier, unique, frequency (works only with plot_x, plot_xy, plotfile_x, plotfile_xy (if smooth is set, set_style has no effekt on data plotting)

◆ set_style()

Gnuplot & Gnuplot::set_style ( const std::string & stylestr = "points" )

set line style (some of these styles require additional information): lines, points, linespoints, impulses, dots, steps, fsteps, histeps, boxes, histograms, filledcurves

◆ set_surface()

Gnuplot& Gnuplot::set_surface ( )

inline

enables/disables the display of surfaces (for 3d plot)

Parameters

—

Returns: <– reference to the gnuplot object

◆ set_terminal_std()

void Gnuplot::set_terminal_std ( const std::string & type )

static

optional: set standart terminal, used by showonscreen defaults: Windows - win, Linux - x11, Mac - aqua

Parameters

type	--> the terminal type

Returns: —

◆ set_title()

Gnuplot& Gnuplot::set_title ( const std::string & title = "" )

inline

sets and clears the title of a gnuplot session

Parameters

title --> the title of the plot [optional, default == ""]

Returns: <– reference to the gnuplot object

◆ set_xautoscale()

Gnuplot& Gnuplot::set_xautoscale ( )

inline

autoscale axis (set by default) of xaxis

Parameters

—

Returns: <– reference to the gnuplot object

◆ set_xlabel()

Gnuplot & Gnuplot::set_xlabel ( const std::string & label = "y" )

set y axis label

◆ set_xlogscale()

Gnuplot & Gnuplot::set_xlogscale ( const double base = 10 )

turns on/off log scaling for the specified xaxis (logscale is not set by default)

◆ set_xrange()

Gnuplot & Gnuplot::set_xrange	(	const double	iFrom,
		const double	iTo
	)

set axis - ranges

◆ set_yautoscale()

Gnuplot& Gnuplot::set_yautoscale ( )

inline

autoscale axis (set by default) of yaxis

Parameters

—

Returns: <– reference to the gnuplot object

◆ set_ylabel()

Gnuplot & Gnuplot::set_ylabel ( const std::string & label = "x" )

set x axis label

◆ set_ylogscale()

Gnuplot & Gnuplot::set_ylogscale ( const double base = 10 )

turns on/off log scaling for the specified yaxis (logscale is not set by default)

◆ set_yrange()

Gnuplot & Gnuplot::set_yrange	(	const double	iFrom,
		const double	iTo
	)

set y-axis - ranges

◆ set_zautoscale()

Gnuplot& Gnuplot::set_zautoscale ( )

inline

autoscale axis (set by default) of zaxis

Parameters

—

Returns: <– reference to the gnuplot object

◆ set_zlabel()

Gnuplot & Gnuplot::set_zlabel ( const std::string & label = "z" )

set z axis label

◆ set_zlogscale()

Gnuplot & Gnuplot::set_zlogscale ( const double base = 10 )

turns on/off log scaling for the specified zaxis (logscale is not set by default)

◆ set_zrange()

Gnuplot & Gnuplot::set_zrange	(	const double	iFrom,
		const double	iTo
	)

set z-axis - ranges

◆ showonscreen()

Gnuplot & Gnuplot::showonscreen ( )

sets terminal type to terminal_std

◆ unset_contour()

Gnuplot& Gnuplot::unset_contour ( )

inline

contour is not set by default, it disables contour drawing for surfaces

Parameters

—

Returns: <– reference to the gnuplot object

◆ unset_grid()

Gnuplot& Gnuplot::unset_grid ( )

inline

grid is not set by default

◆ unset_hidden3d()

Gnuplot& Gnuplot::unset_hidden3d ( )

inline

hidden3d is not set by default

Parameters

—

Returns: <– reference to the gnuplot object

◆ unset_legend()

Gnuplot& Gnuplot::unset_legend ( )

inline

Switches legend off attention:legend is set by default.

Parameters

—

Returns: <– reference to the gnuplot object

◆ unset_multiplot()

Gnuplot& Gnuplot::unset_multiplot ( )

inline

unsets the mulitplot mode

Parameters

—

Returns: <– reference to the gnuplot object

◆ unset_smooth()

Gnuplot& Gnuplot::unset_smooth ( )

inline

unset smooth attention: smooth is not set by default

Parameters

—

Returns: <– a reference to a gnuplot object

◆ unset_surface()

Gnuplot& Gnuplot::unset_surface ( )

inline

surface is set by default, it disables the display of surfaces (for 3d plot)

Parameters

—

Returns: <– reference to the gnuplot object

◆ unset_title()

Gnuplot& Gnuplot::unset_title ( )

inline

Clears the title of a gnuplot session The title is not set by default.

Parameters

—

Returns: <– reference to the gnuplot object

◆ unset_xlogscale()

Gnuplot& Gnuplot::unset_xlogscale ( )

inline

turns off log scaling for the x axis

Parameters

—

Returns: <– reference to the gnuplot object

◆ unset_ylogscale()

Gnuplot& Gnuplot::unset_ylogscale ( )

inline

turns off log scaling for the y axis

Parameters

—

Returns: <– reference to the gnuplot object

◆ unset_zlogscale()

Gnuplot& Gnuplot::unset_zlogscale ( )

inline

turns off log scaling for the z axis

Parameters

—

Returns: <– reference to the gnuplot object

The documentation for this class was generated from the following files:

gnuplot_i.hpp
gnuplot_i.cpp

Public Member Functions

Static Public Member Functions

Constructor & Destructor Documentation

◆ Gnuplot() [1/4]

◆ Gnuplot() [2/4]

◆ Gnuplot() [3/4]

◆ Gnuplot() [4/4]

◆ ~Gnuplot()

Member Function Documentation

◆ cmd()

◆ is_valid()

◆ operator<<()

◆ plot_equation()

◆ plot_equation3d()

◆ plot_image()

◆ plot_slope()

◆ plot_x()

◆ plot_xy()

◆ plot_xy_err()

◆ plot_xyz()

◆ plotfile_x()

◆ plotfile_xy()

◆ plotfile_xy_err()

◆ plotfile_xyz()

◆ remove_tmpfiles()

◆ replot()

◆ reset_all()

◆ reset_plot()

◆ savetops()

◆ set_cbrange()

◆ set_contour()

◆ set_GNUPlotPath()

◆ set_grid()

◆ set_hidden3d()

◆ set_isosamples()

◆ set_legend()

◆ set_multiplot()

◆ set_pointsize()

◆ set_samples()

◆ set_smooth()

◆ set_style()

◆ set_surface()

◆ set_terminal_std()

◆ set_title()

◆ set_xautoscale()

◆ set_xlabel()

◆ set_xlogscale()

◆ set_xrange()

◆ set_yautoscale()

◆ set_ylabel()

◆ set_ylogscale()

◆ set_yrange()

◆ set_zautoscale()

◆ set_zlabel()

◆ set_zlogscale()

◆ set_zrange()

◆ showonscreen()

◆ unset_contour()

◆ unset_grid()

◆ unset_hidden3d()

◆ unset_legend()

◆ unset_multiplot()

◆ unset_smooth()

◆ unset_surface()

◆ unset_title()

◆ unset_xlogscale()

◆ unset_ylogscale()

◆ unset_zlogscale()