summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/pgfplots/README
blob: ea5bd2023903e6fba47f36dd442729910e33fe14 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
pgfplots - Create normal/logarithmic plots in two and three dimensions for LaTeX/TeX/ConTeXt.

pgfplotstable - Loads, rounds, formats and postprocesses numerical tables.

PGFPlots draws high--quality function plots in normal or logarithmic scaling
with a user-friendly interface directly in TeX. The user supplies axis labels,
legend entries and the plot coordinates for one or more plots and PGFPlots
applies axis scaling, computes any logarithms and axis ticks and draws the
plots. It supports line plots, scatter plots, piecewise constant plots, bar
plots, area plots, mesh-- and surface plots, patch plots, contour plots, quiver
plots, histogram plots, polar axes, ternary diagrams, smith charts and some
more.

Pgfplots is based on Till Tantau's package PGF/TikZ (pgf).

Pgfplotstable displays numerical tables rounded to desired precision in various
display formats, for example scientific format, fixed point format or integer,
using TeX's math facilities for pretty printing. Furthermore, it provides
methods for table postprocessing.

Please take a look at 
  doc/latex/pgfplots/pgfplots.pdf
and
  doc/latex/pgfplots/pgfplotstable.pdf.


REMARK
The virus killer Avira Antivir reports the virus HTML/Malicious PDF.Gen in pgfplots.pdf. 
This is a FALSE ALARM caused by the pgfplots library for interactive,
clickable plots (based on javascript). It is virus-free.

Copyright 2007-2012 by Christian Feuersaenger.

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.


HISTORY:
1.8:
- new feature: tight bounding box even if the axis is no box and bb excludes clip path
- new feature: mesh/color input=explicit 
- new feature: shader=interp now has drivers for both dvipdfmx and xetex
- new feature: support for more color spaces in colormap definitions
- new feature: shader=interp and device-level gray colorspaces 
- new feature: 'contour/contour dir=[xyz]' to draw contours in different directions
- new feature: statistics library with boxplot handler (both boxplot prepared and automatic computation)
- fixed bug: 3d centered axis lines and label placement (requires compat=1.8 or higher)
- fixed bug: axis lines and placement of labels, tick scale labels, and reversed axes
    (requires compat=1.8 or higher)
- fixed bug: filtering out coords from a mesh plot failed
- fixed bug: every legend image post was not respected inside of \ref{plotlabel}
- fixed bug: high-order patches computed the shader=flat mean in a wrong way.
- fixed bug: remember picture inside of pgfplots axes failed (due to cell picture)
- fixed bug: now, the tick scale label will be omitted if there are no ticks
- fixed bug: axis box path was not closed
- fixed bug: the bounding box was non-empty even if the axis was hidden.
- fixed bug: auto-alignment of nodes near coords failed for xbar plots
- fixed bug: providing bar width / bar shift in terms of axis units did
    not work with [xy]bar and nodes near coords
- fixed bug: transformation 'data cs=cart' -> polar is more robust now
- fixed bug: code did not compile against pgf 2.00
- fixed bug: patch plot lib and shader=interp,patch type=biquadratic
- fixed bug: context path searching issue (pgfplots.lua)
- fixed bug: shader=interp and dvips driver 
- fixed bug: error bars with explicit relative input failed

1.7 
- added feature: 'bar shift' and 'bar width' can now be expressed in terms of axis units (compat=1.7 or higher)
- fixed incompatibility regression pgfplots 1.6.1 pgf 2.10: layers
- fixed incompatibility pgfplots and imakeidx
- added feature: 'enlargelimits={abs=1cm}', i.e. enlarge by dimension rather than unit
- patchplots lib: added patch type=bicubic
- patchplots lib: added support for global paths (fillable)
- patchplots lib: added patch type sampling feature
- patchplots lib: improved usability (documentation and improvements)
- fixed path issues in context: moved lua input file to tex/generic
- fixed bug: \ref{legendimage} inside of legend text was wrong.

1.6.1:
- fixed incompatibility lualatex,shader=interp, and german package (introduced in 1.6)

1.6:
- added support for layered graphics (main use case: multiple axes and layers)
- added support for second colormap in mesh plots (mesh/interior colormap name)
- added support for scopes inside of axes
- contour plots: added ability to provide list of discrete labels (mesh/levels)
- empty lines are interpreted as interruptions in data plots (was undocumented since 1.4)
- added more scaling options to 'scale mode=scale uniformly' (affects axis equal in 3d
  and \addplot3 graphics)
- fixed wrong implementation of 'axis equal' and 'unit vector ratio' in 3d
  (backwards compatible for 2d, but not for 3d - the 3d implementation was plain wrong)
- fixed incompatibility of lualatex and shader=interp
- fixed bugs/added features around \addplot3 graphics
- fixed bug: colorbar did not support ymode=log
- fixed a couple of minor bugs
- fixed bounding box computation for clip=false,axis lines=none

1.5.1:
- more operations for FPU library (==, !=,<=,>=,?)
- fixed bug in usage of decorations in \addplot
- bugfix for contour prepared format=matlab
- added 'const plot mark mid' and 'jump mark mid' plot handlers
- nodes on a plot (\addplot ... node[pos=<fraction>] {};)
- 'trim axis group left' and 'trim axis group right'
- bugfixes for polar axes and log+stacked plots
- added style 'log ticks with fixed point'
- introduced patched tikz paths to simplify circles and ellipses within an axis
- patchplots lib: patch type=polygon
- some more bugfixes

1.5:
 - Contour plots,
 - Histograms,
 - Quiver plots,
 - patch plots (library)
      - Triangle Meshes
      - Bilinear Elements
      - Quadratic Triangles
      - Biquadratic Quadrilaterals
      - Coons Patches
 - Discrete colorbars,
 - Table sorting,
 - Linear regression,
 - Ternary diagrams,
      - Tieline Plots
 - Smith Charts
 - Polar axes,
 - Empty lines in input files result in interrupted plots,
 - PDF user defined coordinate mouse popups
 - CMYK colormaps and shadings,
 - new markers and cycle lists
 - access to axis limits,
 - \addplot3 graphics: pgfplots draws an appropriate axis for a three-dimensional(!) external png graphics
 - 3D axes: support to provide explicit unit vectors:
 	- explicit unit vectors
	- explicit unit vectors which are uniformly rescaled to match width/height
 - 3D axes: improved support for unit vector ratios
 - improvements of the groupplot styles
 - preliminary support for (2d) bar plots in 3d axes
 - new shader 'faceted interp'
 - table package: 
 	- 'every nth row' style
	- 'comment chars' key to define comment characters in input files
	- 'skip first n' style
 - lots of smaller bugfixes (see ChangeLog for details)


1.4.1:
- improved compatibility to gnuplot 4.4

1.4:
Version 1.4 contains several new features, mostly work on details.
It fixes many bugs and provides the following improvements:
- detached legends 
- detached colorbars
- ybar (and similar plots) can now be mixed with other plot types 
  like line plots.
- improved legend formatting
- added 'restrict x to domain*' which cups coordinates outside of a specified domain (same for y and z)
- Added support for linear regression
- Inline tables,
- Lots of bug fixes

The next version will make a greater step when it is stable.


1.3.1:
Version 1.3.1 is a bugfix release containing
- improved parametric plots with gnuplot
- improved normalsize, small and footnotesize scale styles and added tiny
- a lot of bugfixes

1.3:
- improvements for two dimensional visualization, among them
	- axis equal,
	- color bars,
	- nodes near coords,
	- jumps in plots,
	- improved description positioning, 
	- reverseable axis directions,
	- simpler alignment of adjacent axes,
	- units and a simplified user interface,
- new three dimensional line, scatter, mesh and surface plots,
- a copy of the automatic pdf externalization library, 
- an improved manual enhanced with a lot of pdf cross references.

1.2.2:
- fixed a problem with the samples key, 
- provides some smaller fixes and some manual improvements.
- added plot graphics.

1.2:
- completely rewritten math expression parser with extended data range, 
- colormaps for scatter plots
- fine tuning for plot parameters.
- table package has been extended and is now a fully featured table typesetting, computing and postprocessing tool.