autogpy 0.2.1

autogpy: AutoGnuplot.py - automatic generation of gnuplot figures (including script and data) from python

autogpy - AutoGnuplot.py

Automatic generation of gnuplot figures/scripts/data from python.

Author: Alessandro Corbetta, 2019
Documentation: https://acorbe.github.io/autogpy/
Examples Link
Github Link
Pypi Link

Which problem does it solve?

autogpy eliminates annoying duplications of code/data when doing data analytics in python and publication figures in gnuplot. Using a syntax close to gnuplot, it automatically generates gnuplot scripts and dumps suitably the data.

In the scientific community, gnuplot is a gold standard for publication-quality plots. While python comes with several options for plotting, often gnuplot is preferred in production.

Main features

• anything that be obtained by the gnuplot command plot can be produced
• output figures are shipped in a folder that includes scripts, data and makefile
• any gnuplot state modification can be achieved
• terminals epslatex, tikz/pgfplot and jpg
• multiplots
• plt.hist-like gnuplot histogram figures generator
• jupyter notebook figure preview
• jupyter notebook gnuplot script inspection
• easy scp-based synchronization between a machine in which the figures are generated (e.g. from even larger datasets) and the "paper writing" machine.

Works on

• Linux/MacOs
• Python 3

Getting autogpy

Via pip

pip install autogpy

From source

git clone [e-mail]:acorbe/autogpy.git
pip install autogpy/

In a nutshell

Please see also the examples and the documentation.

import autogpy
import numpy as np

xx = np.linspace(0,6,100)
yy = np.sin(xx)
zz = np.cos(xx)

with autogpy.AutogpyFigure("test_figure") as figure: 

	# gnuplot syntax case
	figure.plot(r'with lines t "sin"',xx,yy)
	
	# python style
	figure.plot(xx,zz,u='1:2',w='lines',label='cos')

will generate the following figure (also appearing in jupyter)

Most importantly, the following source and data will be created in the folder test_figure

$ ls test_figure

.gitignore
Makefile
sync_me.sh
fig__0__.dat
fig__1__.dat
fig__.core.gnu
fig__.jpg.gnu
fig__.pdflatex_compile.sh
fig__.pdflatex.gnu
fig__.tikz_compile.sh
fig__.tikz.gnu

With make one can obtain jpg, epslatex, and tikz/pgfplot versions of the figure. Notice that the input data has been formatted automatically.

Inspecting fig__.pdflatex.gnu, responsible of the epslatex version of the figure, one gets:

set terminal epslatex size 9.9cm,8.cm color colortext standalone      'phv,12 '  linewidth 2
set output 'fig.latex.nice/plot_out.tex'

load "fig__.core.gnu"; 

while fig__.core.gnu reads:

p "fig__0__.dat" with lines t "sin",\
"fig__1__.dat" u 1:2 with lines t "cos"

KWONW ISSUES

• Certain features require imagemagick and a working gnuplot-tikz.lua. Some versions of these might have bugs. Call figure.display_fixes() to show known fixes.