diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex')
47 files changed, 721 insertions, 250 deletions
diff --git a/Master/texmf-dist/doc/latex/pgfplots/ChangeLog b/Master/texmf-dist/doc/latex/pgfplots/ChangeLog index 8e58a522a74..e39a4175aba 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/ChangeLog +++ b/Master/texmf-dist/doc/latex/pgfplots/ChangeLog @@ -1,3 +1,104 @@ +2010-03-31 Christian Feuersaenger <ludewich@users.sourceforge.net> + + - Released version 1.3.1 + +2010-03-25 Christian Feuersaenger <ludewich@users.sourceforge.net> + + - Imported all patches to PGF written by Christian Feuersaenger. + - Fixed bug: axis descriptions for |small| and |footnotesize| styles were + too large + - added |tiny| style + +2010-03-24 Christian Feuersaenger <ludewich@users.sourceforge.net> + + - Fixed bug: overlay did not work properly + - Fixed bug: grids worked only for boxed axes + +2010-03-23 Christian Feuersaenger <ludewich@users.sourceforge.net> + + - Fixed bug: \pgfplotstablesave did not reset 'postproc cell content' + +2010-03-16 Christian Feuersaenger <ludewich@users.sourceforge.net> + + - Fixed bug: 'draw=none' wasn't handled correctly. + +2010-03-12 Christian Feuersaenger <ludewich@users.sourceforge.net> + + - Fixed bug: the table package had spurious spaces + +2010-02-23 Christian Feuersaenger <ludewich@users.sourceforge.net> + + - Fixed bug: the 'date type' was broken due to a missing comma + +2010-02-22 Christian Feuersaenger <ludewich@users.sourceforge.net> + + - Fixed bug: providing a point meta expression twice as in 'point meta=<expr>, point meta=<expr>' yielded an infinite recursion + +2010-02-20 Christian Feuersaenger <ludewich@users.sourceforge.net> + + - Fixed docs for \addlegendimage which was documented using the wrong name |\legendimage| + - Allowed paragraphs in legend texts (was broken before) + +2010-02-18 Christian Feuersaenger <ludewich@users.sourceforge.net> + + - number printing: added 'sci generic' style to customize the appearance + of scientific format and a 'verbatim' style which doesn't use TeX macros + for the formatted numbers. + + +2010-02-09 Christian Feuersaenger <ludewich@users.sourceforge.net> + + - Fixed bug in auto cross referenced of table package manual + + +2010-02-08 Christian Feuersaenger <ludewich@users.sourceforge.net> + + - Fixed problem with spurious white space occuring during table input command + +2010-02-04 Christian Feuersaenger <ludewich@users.sourceforge.net> + + - Fixed problem with spurious white space occuring during table input command + +2010-01-27 Christian Feuersaenger <ludewich@users.sourceforge.net> + + - fixed bug: \coordindex for plot table from already loaded structure was + wrong. + +2010-01-26 Christian Feuersaenger <ludewich@users.sourceforge.net> + + - Introduced 'compat=1.3' . The name 'compat=newest' was not not such a + good idea since it might introduce a problem for following releases. + - Emphasized key names in references to show that /pgfplots/, /tikz/ and + similar prefixes are unnecessary. + - Fixed the 'xticklabels' key such that it also accepts '\\' terminated + lists. This fixes strange bugs with dots '.' as last characters in + entries. + +2010-01-21 Christian Feuersaenger <ludewich@users.sourceforge.net> + - added sanity checks such that 'xmin/max' and friends can't be invoked + within an \addplot. + - plot gnuplot: added user customizable styles to change the dummy + variables. The initial config will now use 'x' for 1d, 'x,y' for 2d, 't' + for 1d parametric and 'u,v' for 2d parametric plots. + - fixed bug: one couldn't use different log/normal scalings in a group + plot. Relaxed sanity checking here. + - added docs for |variable| and |variable y| which appeared to be missing. + +2010-01-14 Christian Feuersaenger <ludewich@users.sourceforge.net> + + - fixed that '\addlegendimage' did not respect the every plot styles. + - added 'every legend image post' style. + + +2010-01-08 Christian Feuersaenger <ludewich@users.sourceforge.net> + + - fixed bug which occurs if 'legend style' is set *after* \begin{axis}. + - plot gnuplot: restored support for the '/tikz/parametric' option: it did only work if + one provided the prefix '/tikz/' explicitly + - plot gnuplot: parametric plots now use the SAME dummy variables as plot + expression. If you write variable=\x, 'x' will be the gnuplot variable. If + you write variable y=\y, 'y' will be the second gnuplot variable. + 2010-01-02 Christian Feuersaenger <ludewich@users.sourceforge.net> - Released version 1.3 diff --git a/Master/texmf-dist/doc/latex/pgfplots/Makefile b/Master/texmf-dist/doc/latex/pgfplots/Makefile index 6414fa5a278..576def59f2f 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/Makefile +++ b/Master/texmf-dist/doc/latex/pgfplots/Makefile @@ -8,7 +8,7 @@ notes: TeX-programming-notes.pdf pgfplots: pgfplots.pdf pgfplotstable: pgfplotstable.pdf -%.pdf: FORCE +%.pdf: update-git-hooks FORCE mkdir -p gnuplot @export TEXMFCNF=.: && $(PDFLATEX) $(@:.pdf=.tex) @bibtex $(@:.pdf=) || exit 0 @@ -19,4 +19,7 @@ pgfplotstable: pgfplotstable.pdf clean: rm -f *.aux *.ind *.idx *.toc *.out *.log *.ilg *.dvi pgfplots.pdf pgfplotstable.pdf *.djs *.bbl *.blg figures/expensiveexample* +update-git-hooks: + @ + FORCE: diff --git a/Master/texmf-dist/doc/latex/pgfplots/TeX-programming-notes.pdf b/Master/texmf-dist/doc/latex/pgfplots/TeX-programming-notes.pdf Binary files differindex 7657c60b10e..adc6b7268fa 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/TeX-programming-notes.pdf +++ b/Master/texmf-dist/doc/latex/pgfplots/TeX-programming-notes.pdf diff --git a/Master/texmf-dist/doc/latex/pgfplots/gallery/Makefile b/Master/texmf-dist/doc/latex/pgfplots/gallery/Makefile index f65f03818db..27896014114 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/gallery/Makefile +++ b/Master/texmf-dist/doc/latex/pgfplots/gallery/Makefile @@ -20,7 +20,7 @@ prepare: $(DOC_SRC) touch $@ clean: - rm ./example* prepare index.html + rm -f ./example* prepare index.html prepared: $(PREPARED_SRC:%.tex=%.pdf) diff --git a/Master/texmf-dist/doc/latex/pgfplots/gallery/extractexamples.pl b/Master/texmf-dist/doc/latex/pgfplots/gallery/extractexamples.pl index b58e8f00817..5576c9ad7fb 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/gallery/extractexamples.pl +++ b/Master/texmf-dist/doc/latex/pgfplots/gallery/extractexamples.pl @@ -51,6 +51,7 @@ $header = % http://www.ctan.org/tex-archive/graphics/pgf/contrib/pgfplots/doc/latex/plotdata/ \usepackage{pgfplots} +\pgfplotsset{compat=newest} \pagestyle{empty} '; diff --git a/Master/texmf-dist/doc/latex/pgfplots/gallery/pgfshell_cos.sh b/Master/texmf-dist/doc/latex/pgfplots/gallery/pgfshell_cos.sh deleted file mode 100644 index 69dfb98cfb0..00000000000 --- a/Master/texmf-dist/doc/latex/pgfplots/gallery/pgfshell_cos.sh +++ /dev/null @@ -1 +0,0 @@ -awk 'BEGIN{ pi=3.14159; N=10; for(i=0;i<=N;i++) print i,cos(i/N*pi);}' diff --git a/Master/texmf-dist/doc/latex/pgfplots/gallery/pgfshell_replot.sh b/Master/texmf-dist/doc/latex/pgfplots/gallery/pgfshell_replot.sh deleted file mode 100644 index 43f9c74b10d..00000000000 --- a/Master/texmf-dist/doc/latex/pgfplots/gallery/pgfshell_replot.sh +++ /dev/null @@ -1 +0,0 @@ -cat pgfshell_cos.out diff --git a/Master/texmf-dist/doc/latex/pgfplots/gnuplot/pgfplots_DoG.gnuplot b/Master/texmf-dist/doc/latex/pgfplots/gnuplot/pgfplots_DoG.gnuplot index 722f1b2926b..83b33ab108c 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/gnuplot/pgfplots_DoG.gnuplot +++ b/Master/texmf-dist/doc/latex/pgfplots/gnuplot/pgfplots_DoG.gnuplot @@ -1,2 +1,2 @@ set table "gnuplot/pgfplots_DoG.table"; set format "%.5f" -set format "%.7e";; set samples 100; plot [x=-15:15] 1.3*exp(-x**2/10) - exp(-x**2/20); +set format "%.7e";; set samples 100; set dummy x,y; plot [x=-15:15] 1.3*exp(-x**2/10) - exp(-x**2/20); diff --git a/Master/texmf-dist/doc/latex/pgfplots/gnuplot/pgfplots_exp.gnuplot b/Master/texmf-dist/doc/latex/pgfplots/gnuplot/pgfplots_exp.gnuplot index 709bdf2166a..a99cd2f2f1d 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/gnuplot/pgfplots_exp.gnuplot +++ b/Master/texmf-dist/doc/latex/pgfplots/gnuplot/pgfplots_exp.gnuplot @@ -1,2 +1,2 @@ set table "gnuplot/pgfplots_exp.table"; set format "%.5f" -set format "%.7e";; set samples 25; set logscale y 2.71828182845905; plot [x=0:10] exp(x); +set format "%.7e";; set samples 25; set dummy x,y; set logscale y 2.71828182845905; plot [x=0:10] exp(x); diff --git a/Master/texmf-dist/doc/latex/pgfplots/gnuplot/pgfplots_filesuffix.gnuplot b/Master/texmf-dist/doc/latex/pgfplots/gnuplot/pgfplots_filesuffix.gnuplot index 3bbc4c5a6ec..10456404a51 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/gnuplot/pgfplots_filesuffix.gnuplot +++ b/Master/texmf-dist/doc/latex/pgfplots/gnuplot/pgfplots_filesuffix.gnuplot @@ -1,2 +1,2 @@ set table "gnuplot/pgfplots_filesuffix.table"; set format "%.5f" -set format "%.7e";; set samples 25; plot [x=-5:5] (-x**5 - 242); +set format "%.7e";; set samples 25; set dummy x,y; plot [x=-5:5] (-x**5 - 242); diff --git a/Master/texmf-dist/doc/latex/pgfplots/gnuplot/pgfplots_gnuplot_ppp.gnuplot b/Master/texmf-dist/doc/latex/pgfplots/gnuplot/pgfplots_gnuplot_ppp.gnuplot index bee9ff15ac7..7acc4a7fd6e 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/gnuplot/pgfplots_gnuplot_ppp.gnuplot +++ b/Master/texmf-dist/doc/latex/pgfplots/gnuplot/pgfplots_gnuplot_ppp.gnuplot @@ -1,2 +1,2 @@ set table "gnuplot/pgfplots_gnuplot_ppp.table"; set format "%.5f" -set format "%.7e";; set samples 120; plot [x=-40:40] 10000*sin(x/3); +set format "%.7e";; set samples 120; set dummy x,y; plot [x=-40:40] 10000*sin(x/3); diff --git a/Master/texmf-dist/doc/latex/pgfplots/gnuplot/pgfplots_parable.gnuplot b/Master/texmf-dist/doc/latex/pgfplots/gnuplot/pgfplots_parable.gnuplot index 9144ac39184..c94d4875087 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/gnuplot/pgfplots_parable.gnuplot +++ b/Master/texmf-dist/doc/latex/pgfplots/gnuplot/pgfplots_parable.gnuplot @@ -1,2 +1,2 @@ set table "gnuplot/pgfplots_parable.table"; set format "%.5f" -set format "%.7e";; set samples 25; plot [x=-5:5] 4*x**2 - 5; +set format "%.7e";; set samples 25; set dummy x,y; plot [x=-5:5] 4*x**2 - 5; diff --git a/Master/texmf-dist/doc/latex/pgfplots/gnuplot/pgfplots_pow2.gnuplot b/Master/texmf-dist/doc/latex/pgfplots/gnuplot/pgfplots_pow2.gnuplot index fd5e0ab7b3c..b700c64ee70 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/gnuplot/pgfplots_pow2.gnuplot +++ b/Master/texmf-dist/doc/latex/pgfplots/gnuplot/pgfplots_pow2.gnuplot @@ -1,2 +1,2 @@ set table "gnuplot/pgfplots_pow2.table"; set format "%.5f" -set format "%.7e";; set samples 8; set logscale y 2.71828182845905; plot [x=0:10] 2**(-1.5*x -3); +set format "%.7e";; set samples 8; set dummy x,y; set logscale y 2.71828182845905; plot [x=0:10] 2**(-1.5*x -3); diff --git a/Master/texmf-dist/doc/latex/pgfplots/gnuplot/pgfplots_sin.gnuplot b/Master/texmf-dist/doc/latex/pgfplots/gnuplot/pgfplots_sin.gnuplot index 2bc6c2ecd64..1784003af06 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/gnuplot/pgfplots_sin.gnuplot +++ b/Master/texmf-dist/doc/latex/pgfplots/gnuplot/pgfplots_sin.gnuplot @@ -1,2 +1,2 @@ set table "gnuplot/pgfplots_sin.table"; set format "%.5f" -set format "%.7e";; set samples 25; plot [x=-5:5] sin(x); +set format "%.7e";; set samples 25; set dummy x,y; plot [x=-5:5] sin(x); diff --git a/Master/texmf-dist/doc/latex/pgfplots/gnuplot/pgfplots_tangens.gnuplot b/Master/texmf-dist/doc/latex/pgfplots/gnuplot/pgfplots_tangens.gnuplot index 483ee2b9a13..a3e066c321b 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/gnuplot/pgfplots_tangens.gnuplot +++ b/Master/texmf-dist/doc/latex/pgfplots/gnuplot/pgfplots_tangens.gnuplot @@ -1,2 +1,2 @@ set table "gnuplot/pgfplots_tangens.table"; set format "%.5f" -set format "%.7e";; set samples 1000; plot [x=-1.5*pi:1.5*pi] tan(x); +set format "%.7e";; set samples 1000; set dummy x,y; plot [x=-1.5*pi:1.5*pi] tan(x); diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfmanual-en-macros.tex b/Master/texmf-dist/doc/latex/pgfplots/pgfmanual-en-macros.tex index 4033e67b27b..e12e483dcb6 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/pgfmanual-en-macros.tex +++ b/Master/texmf-dist/doc/latex/pgfplots/pgfmanual-en-macros.tex @@ -224,7 +224,7 @@ \ifpgfutil@in@% \extractequalinitial#1\@nil% \else - \pgfmanualentryheadline{{\ttfamily\declare{#1}}\hfill(\extrakeytext no value)}% + \pgfmanualentryheadline{{\ttfamily\declarekey{#1}}\hfill(\extrakeytext no value)}% \def\mykey{#1}% \def\mypath{}% \def\myname{}% @@ -234,6 +234,31 @@ \fi% } +\pgfkeyssetvalue{/pgfmanual/gray key prefixes}{/pgfplots/,/tikz/} + +\def\declarekey#1{% + \begingroup + \gdef\declarekey@didit{0}% + \pgfkeysgetvalue{/pgfmanual/gray key prefixes}\declarekey@gray + \def\declarekey@loop{\foreach \prefix in }% + \expandafter\declarekey@loop\expandafter{\declarekey@gray} {% + \expandafter\pgfutil@in@\expandafter{\prefix}{#1}% + \ifpgfutil@in@ + \expandafter\def\expandafter\declarekey@handleprefix\prefix####1\relax{% + \keyprefix{\prefix}\declare{####1}% + }% + \declarekey@handleprefix#1\relax + \gdef\declarekey@didit{1}% + \breakforeach + \fi + }% + \if0\declarekey@didit + \declare{#1}% + \fi + \endgroup +}% +\def\keyprefix#1{\textcolor{gray}{#1}} + \def\extractkeyequal#1=#2\@nil{% \pgfutil@in@{(default}{#2}% \ifpgfutil@in@% @@ -243,8 +268,8 @@ \ifpgfutil@in@% \extractinitial{#1}#2\@nil% \else -% \pgfmanualentryheadline{{\ttfamily\declare{#1}=}#2\hfill(\extrakeytext no default)}% - \pgfmanualentryheadline{{\ttfamily\declare{#1}=}#2\hfill}% +% \pgfmanualentryheadline{{\ttfamily\declarekey{#1}=}#2\hfill(\extrakeytext no default)}% + \pgfmanualentryheadline{{\ttfamily\declarekey{#1}=}#2\hfill}% \fi% \fi% \def\mykey{#1}% @@ -255,16 +280,16 @@ } \def\extractdefault#1#2(default #3)\@nil{% - \pgfmanualentryheadline{{\ttfamily\declare{#1}\opt{=}}\opt{#2}\hfill (\extrakeytext default {\ttfamily#3})}% + \pgfmanualentryheadline{{\ttfamily\declarekey{#1}\opt{=}}\opt{#2}\hfill (\extrakeytext default {\ttfamily#3})}% } \def\extractinitial#1#2(initially #3)\@nil{% -% \pgfmanualentryheadline{{\ttfamily\declare{#1}=}#2\hfill (\extrakeytext no default, initially {\ttfamily#3})}% - \pgfmanualentryheadline{{\ttfamily\declare{#1}=}#2\hfill (\extrakeytext initially {\ttfamily#3})}% +% \pgfmanualentryheadline{{\ttfamily\declarekey{#1}=}#2\hfill (\extrakeytext no default, initially {\ttfamily#3})}% + \pgfmanualentryheadline{{\ttfamily\declarekey{#1}=}#2\hfill (\extrakeytext initially {\ttfamily#3})}% } \def\extractequalinitial#1 (initially #2)\@nil{% - \pgfmanualentryheadline{{\ttfamily\declare{#1}}\hfill (\extrakeytext initially {\ttfamily#2})}% + \pgfmanualentryheadline{{\ttfamily\declarekey{#1}}\hfill (\extrakeytext initially {\ttfamily#2})}% \def\mykey{#1}% \def\mypath{}% \def\myname{}% diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplots-macros.tex b/Master/texmf-dist/doc/latex/pgfplots/pgfplots-macros.tex index 3db2099ab98..037fd69d3eb 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/pgfplots-macros.tex +++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplots-macros.tex @@ -244,7 +244,7 @@ \newenvironment{codekey}[1]{% \begin{pgfmanualentry} - \pgfmanualentryheadline{{\ttfamily\declare{#1}\textcolor{gray}{/\pgfmanualpdfref{/handlers/.code}{.code}}=\marg{...}}\hfill}% + \pgfmanualentryheadline{{\ttfamily\declarekey{#1}\textcolor{gray}{/\pgfmanualpdfref{/handlers/.code}{.code}}=\marg{...}}\hfill}% \def\mykey{#1}% \def\mypath{}% \def\myname{}% @@ -264,7 +264,7 @@ } \newenvironment{pgfplotscodetwokey}[1]{% \begin{pgfmanualentry} - \pgfmanualentryheadline{{\ttfamily\declare{/pgfplots/#1}\textcolor{gray}{/\pgfmanualpdfref{/handlers/.code 2 args}{.code 2 args}}=\marg{...}}\hfill}% + \pgfmanualentryheadline{{\ttfamily\declarekey{/pgfplots/#1}\textcolor{gray}{/\pgfmanualpdfref{/handlers/.code 2 args}{.code 2 args}}=\marg{...}}\hfill}% \def\mykey{/pgfplots/#1}% \def\mypath{}% \def\myname{}% @@ -283,7 +283,7 @@ \pgfmanualentryheadline@##1\pgfplots@EOI }% \def\pgfmanualentryheadline@##1\hfill##2\pgfplots@EOI{% - \oldpgfmanualentryheadline{{\ttfamily\declare{##1}\textcolor{gray}{/\pgfmanualpdfref{/handlers/.code}{.code}}=\marg{...}}\hfill}% + \oldpgfmanualentryheadline{{\ttfamily\declarekey{##1}\textcolor{gray}{/\pgfmanualpdfref{/handlers/.code}{.code}}=\marg{...}}\hfill}% } \begin{pgfplotsxykeylist}{#1}% } diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.basic.reference.tex b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.basic.reference.tex index 950de93151b..bb705ef1831 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.basic.reference.tex +++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.basic.reference.tex @@ -4,7 +4,7 @@ This section documents commands which provide access to more basic elements of \ However, most elements in this section are only interesting for advanced users -- and perhaps only for special cases. -\subsection{Utitity Commands} +\subsection{Utility Commands} \begin{command}{\foreach \meta{variables} |in| \meta{list} \marg{commands}} A powerful loop command provided by \Tikz, see~\cite[Section Utilities]{tikz}. @@ -42,7 +42,7 @@ All collected = \allcollected. \end{command} \begin{command}{\pgfplotsinvokeforeach\marg{list} \marg{command}} - A variant of |\pgfplotsforeachungrouped| (and such also of |\foreach|) which replaces any occurence of |#1| inside of \meta{command} once for every element in \meta{list}. Thus, it actually assumes that \marg{command} is like a |\newcommand| body. + A variant of |\pgfplotsforeachungrouped| (and such also of |\foreach|) which replaces any occurrence of |#1| inside of \meta{command} once for every element in \meta{list}. Thus, it actually assumes that \marg{command} is like a |\newcommand| body. In other words, \marg{command} is invoked for every element of \marg{list}. The actual element of \marg{list} is available as |#1|. @@ -144,7 +144,7 @@ The number is printed using the current number printing options, see the manual \subsection{Path Operations} \begin{commandlist}{\path,\draw,\fill,\node,\matrix} - These commands are \Tikz\ drawing commands all of which are documented in~\cite{tikz}. They are used to draw or fill paths, generate text nodes or aligned text matrizes. They are equivalent to + These commands are \Tikz\ drawing commands all of which are documented in~\cite{tikz}. They are used to draw or fill paths, generate text nodes or aligned text matrices. They are equivalent to \pgfmanualpdflabel{/tikz/draw}{}|\path[draw]|, \pgfmanualpdflabel{/tikz/fill}{}|\path[fill]|, \pgfmanualpdflabel{/tikz/node}{}|\path[node]|, diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.importexport.tex b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.importexport.tex index 070f573d1e2..ac8b4ba4bcb 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.importexport.tex +++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.importexport.tex @@ -29,16 +29,16 @@ The only steps which are necessary is to use \pgfmanualpdflabel{\textbackslash tikzexternalize}{}% |\usepgfplotslibrary{external}| -|\tikzexternalize|\marg{the main file name} +|\tikzexternalize| -\noindent where \meta{the main file name} is the name of your |.tex| file (without the extension |.tex|). No further modification to the document is necessary. Suppose we have a file called |test.tex|: +\noindent somewhere in your document's preamble. No further modification to the document is necessary. Suppose we have a file called |test.tex|: \begin{codeexample}[code only] \documentclass{article} \usepackage{pgfplots} \usepgfplotslibrary{external} -\tikzexternalize{test} +\tikzexternalize% activate externalization! \begin{document} \begin{figure} @@ -64,7 +64,7 @@ The only steps which are necessary is to use \begin{codeexample}[code only] pdflatex -shell-escape test \end{codeexample} -\noindent and \LaTeX\ will now generate the required graphics files |test-figure0.pdf| and |test-figure1.pdf| automatically. Any further call to |pdflatex| will simply use |\includegraphics| and the |tikzpicture|s as such are no longer considered. +\noindent and \LaTeX\ will now generate the required graphics files |test-figure0.pdf| and |test-figure1.pdf| automatically. Any further call to |pdflatex| will simply use |\includegraphics| and the |tikzpicture|s as such are no longer considered (you need a different command line switch for Mik\TeX, see the |shell escape| option). If a figure shall be remade, one can simply delete all or selected graphics files and re-generate them. Alternatively, one can use the command |\tikzset{external/force remake}| somewhere in the document to remake every following picture automatically. @@ -98,7 +98,7 @@ There are three ways to modify the file names of externalized figures: \usepackage{tikz} \usepgfplotslibrary{external} -\tikzexternalize[prefix=figures/]{main} % provide the file's real name +\tikzexternalize[prefix=figures/]% activate with a name prefix \begin{document} @@ -132,7 +132,7 @@ pdflatex -shell-escape main \usepackage{tikz} \usepgfplotslibrary{external} -\tikzexternalize{main} % provide the file's real name +\tikzexternalize% activate externalization! \begin{document} @@ -193,17 +193,19 @@ pdflatex -shell-escape main \begin{key}{/tikz/external/system call=\marg{template}} \label{extlib:systemcall:option} - A template string used to generate system calls. Inside of \marg{template}, the macro |\image| can be used as placeholder for the image which is about to be generated while |\texsource| contains the main file name. + A template string used to generate system calls. Inside of \marg{template}, the macro |\image| can be used as placeholder for the image which is about to be generated while |\texsource| contains the main file name (in truth, it contains |\input|\marg{main file name}, but that doesn't matter). The default is \begin{codeexample}[code only] -\tikzset{external/system call={pdflatex -shell-escape -halt-on-error +\tikzset{external/system call={pdflatex \tikzexternalcheckshellescape -halt-on-error -interaction=batchmode -jobname "\image" "\texsource"} \end{codeexample} + \noindent where \declareandlabel{\tikzexternalcheckshellescape} inserts the value of the configuration key |shell escape| + if and only if the current document has been typeset with |-shell-escape|\footnote{Note that this is always true for the default configuration. This security consideration applies mainly for \texttt{mode=list and make} which will also work \emph{without} shell escapes.}. For |eps| output, you can (and need to) use \begin{codeexample}[code only] -\tikzset{external/system call={latex -shell-escape -halt-on-error +\tikzset{external/system call={latex \tikzexternalcheckshellescape -halt-on-error -interaction=batchmode -jobname "\image" "\texsource"; dvips -o "\image".ps "\image".dvi}} \end{codeexample} @@ -211,12 +213,32 @@ pdflatex -shell-escape main The argument \marg{template} will be expanded using |\edef|, so any control sequences will be expanded. During this evaluation, `|\\|' will result in a normal backslash, `|\|'. Furthermore, double quotes `|"|', single quotes `|'|', semicolons and dashes `|-|' will be made to normal characters if any package uses them as macros. This ensures compatibility with the |german| package, for example. \end{key} +\begin{key}{/tikz/external/shell escape=\marg{command-line arg} (initially -shell-escape)} + Contains the command line option for |latex| which enables the |\write18| feature. For \TeX-Live, this is |-shell-escape|. For Mik\TeX, you should use |\tikzexternalize[shell escape=-enable-write18]|. +\end{key} + +\begin{key}{/tikz/external/mode=\mchoice{convert with system call,list and make,$\dotsc$} (initially convert with system call)} + This allows to change the default operation mode. There are a handful of choices possible, all of them are described in detail in~\cite[section ``Externalization Library'']{tikz}. The most useful ones are probably the initial configuration |convert with system call| and the specialized choice |list and make|. + + The choice |list and make| configures the library to check if there are already external graphics and uses them. If there are no graphics, the library will \emph{skip} the figure. However, it will also generate a |makefile| to generate the graphics, and a list of all required graphics files. + + It is not required to use |make|: the library expects you to generate the images somehow and it doesn't care about the ``how''. Using |make -f |\meta{name-of-tex-file}|.makefile -j 2| allows parallel execution which might, indeed, be an option. Furthermore, the makefile also supports file dependencies: if one of your data tables has been updated, the external graphics will be remade automatically. \PGFPlots\ tells the external library about any file dependencies (input files and tables). + + The two modes have the following characteristics: + \begin{enumerate} + \item |convert with system call| is automatic and does everything on--the--fly. However, it \emph{can't} work with |\ref| and/or |\label| information in external pictures. + \item |list and make| requires either manual (by calling the system calls manually) or semi--automatic conversion (using the generated \meta{main}|.makefile|), and multiple runs of |pdflatex|. The generated Makefile can be processed in parallel. Furthermore, |list and make| provides \emph{full support} for |\ref| and |\label|: any |\label| defined inside of an externalized graphics is still available for the main document. + + If you have legends with |legend to name| or |\label|/|\ref|, you need to generate the graphics defining the |\label| (or |legend to name|), then run |pdflatex| twice on the main document. Afterwards, you can externalize the legend graphics. + \end{enumerate} +\end{key} + The complete reference documentation and remaining options are documented in~\cite[``Externalization Library'']{tikz}. This reference also contains information about \begin{itemize} \item how to use |\tikzset{external/|\declareandlabel{force remake}|}| and |\tikzset{external/|\declareandlabel{remake next}|}| to remake selected figures, \item how to disable the externalization partially with |\tikzset{external/|\declareandlabel{export}|=false}| or completely with |\tikzexternaldisable|, \item how to optimize the speed of the conversion process using |\tikzset{external/optimize command away=\myExpensiveMacro}|, - \item how to use |mode=list and make| to automatically generate makefiles for parallel image externalization\footnote{In case you'd like to test \texttt{list and make}, consider using \texttt{\textbackslash tikzifexternalizing\{\textbackslash nofiles\}\{\}} to suppress \texttt{.aux} file generation during parallel externalization procedures; \texttt{.aux} files would be screwed up otherwise.}, + \item how to add further remake-dependencies with |\tikzpicturedependsonfile|\marg{name} and/or |\tikzexternalfiledependsonfile|\marg{external file}\marg{name}, \item how to typeset such a document without \pgfname\ installed or \item how to provide work-arounds with |.pdf| images and bounding box restrictions. \index{External Graphics!Bounding Box Issues} @@ -229,7 +251,7 @@ There is a small replacement package \declareandlabel{tikzexternal.sty} which ca % \usepackage{tikz} % \usepackage{pgfplots} \usepackage{tikzexternal} -\tikzexternalize{test} % <-- provide the main .tex name +\tikzexternalize% activate externalization \begin{document} \begin{tikzpicture} @@ -323,6 +345,12 @@ These steps are explained in much more detail in Section``Externalizing Graphics It should be noted that this approach of image externalization is not limited to \Tikz\ picture environments. In fact, it collects everything between the begin and end statements into the external file. It is implicitly assumed that the encapsulated stuff is one box, but you can also encapsulate complete paragraphs using something like the \LaTeX\ minipage (or a |\vbox| which is not as powerful but does not affect the remaining document that much). +\begin{key}{/pgf/images/aux in dpth=\mchoice{true,false} (initially false)} + If this boolean is set to |true|, any |\label| information generated inside of the external image is stored into the already mentioned |.dpth| file. The main document can thus reference label information of externalized parts of the document (although you may need to run |latex| several times). + + Label support is provided for |\ref|, and probably |\cite|. The |\pageref| command is only partially supported. +\end{key} + \paragraph{Using the Library Without {\normalfont\pgfname} Installed} Simply uncomment the packages |\usepackage{tikz}| and |\usepackage{pgfplots}| and use \begin{codeexample}[code only] diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.install.tex b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.install.tex index 851be797929..c356a2ebefb 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.install.tex +++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.install.tex @@ -37,7 +37,7 @@ However, Mik\TeX\ provides a feature to install packages locally in its own \TeX Mik\TeX\ complains if the provided directory is not TDS conform (see section~\ref{pgfplots:tds} for details), so you can't provide a wrong directory here. This method does also work for other packages, but some packages may need some directory restructuring before Mik\TeX\ accepts them. \subsubsection{Installation of Linux Packages} -At the time of this writing, I am unaware of \PGFPlots\ packages for recent stable Linux distributions. For Ubuntu, there are inofficial Ubuntu Package Repositories which can be added to the Ubuntu Package Tools. The idea is: add a simple URL to the Ubuntu Package Tool, run update and the installation takes place automatically. These URLs are maintained as PPA on Ubuntu Servers. +At the time of this writing, I am unaware of \PGFPlots\ packages for recent stable Linux distributions. For Ubuntu, there are unofficial Ubuntu Package Repositories which can be added to the Ubuntu Package Tools. The idea is: add a simple URL to the Ubuntu Package Tool, run update and the installation takes place automatically. These URLs are maintained as PPA on Ubuntu Servers. The \PGFPlots\ download area on sourceforge contains recent links about Ubuntu Package Repositories, go to \url{http://sourceforge.net/projects/pgfplots/files} @@ -131,7 +131,7 @@ Furthermore, \PGF\ needs to know a \emph{driver} so that the DVI file can be con %\def\pgfsysdriver{pgfsys-dvips.def} \usepackage{pgfplots}. \end{verbatim} - The uncommented commands could be used to set other drivers explictly. + The uncommented commands could be used to set other drivers explicitly. \end{itemize} Please read the corresponding sections in~\cite[Section 7.2.1 and 7.2.2]{tikz} if you have further questions. These sections also contain limitations of particular drivers. @@ -141,7 +141,7 @@ The choice which won't produce any problems at all is |pdflatex|. \PGFPlots\ can handle small up to medium sized plots. However, \TeX\ has never been designed for data plots -- you will eventually face the problem of small memory capacities. See section~\ref{sec:pgfplots:optimization} for how to enlarge them. \subsubsection{Problems with Language Settings and Active Characters} -Both, \PGF\ and \PGFPlots\ use a lot of characters -- which may lead to incompatibilites with other packages which define active characters. Compatibility is better than in earlier versions, but may still be an issue. The manual compiles with the |babel| package for english and french, the |german| package does also work. If you experience any trouble, let me know. Sometimes it may work to disable active characters temporarily (|babel| provides such a command). +Both, \PGF\ and \PGFPlots\ use a lot of characters -- which may lead to incompatibilities with other packages which define active characters. Compatibility is better than in earlier versions, but may still be an issue. The manual compiles with the |babel| package for english and french, the |german| package does also work. If you experience any trouble, let me know. Sometimes it may work to disable active characters temporarily (|babel| provides such a command). \subsubsection{Other Problems} Please read the mailing list at diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.intro.tex b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.intro.tex index af80b0ecd3f..ec1686dadfb 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.intro.tex +++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.intro.tex @@ -39,7 +39,7 @@ % for dvipdfm: %\def\pgfsysdriver{pgfsys-dvipdfm.def} \usepackage{pgfplots} -\pgfplotsset{compat=newest}% <-- moves axis labels near ticklabels (respects tick label widths) +\pgfplotsset{compat=1.3}% <-- moves axis labels near ticklabels (respects tick label widths) \begin{document} \begin{figure} diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.libs.tex b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.libs.tex index 44ff66ca55c..0049ec089bf 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.libs.tex +++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.libs.tex @@ -26,7 +26,7 @@ This section describes some libraries which come with \PGFPlots, but they are mo \rlap{\includegraphics[height=6cm]{figures/pgfplotsclickable-fig2.png}}\hfill \nobreak - These screenshots show the result of clicking into the axis range (left column) and of dragging from one point to another (right column). The second case shows the result of drag- and drop: it displays start- and end points and the equation for the line segment between between the first point of the drag- and drop and the second point where the mouse has been released. The line segment is + These screen shots show the result of clicking into the axis range (left column) and of dragging from one point to another (right column). The second case shows the result of drag- and drop: it displays start- and end points and the equation for the line segment between between the first point of the drag- and drop and the second point where the mouse has been released. The line segment is \[ l(x; x_0,y_0,x_1,y_1) = m \cdot x + n \] where $m = (y_1-y_0) / (x_1-x_0)$ is the slope and $n$ the offset chosen such that $l(x_0;\dotsc) = y_0$. For logarithmic plots, logarithms will be applied before computing slopes. @@ -39,7 +39,7 @@ This section describes some libraries which come with \PGFPlots, but they are mo \end{tikzpicture}\hss}% \nobreak - These screenshots show the result of drag- and drop for \emph{logarithmic} axes: the end points show, again, the coordinates (without logs) and the form field in the middle shows the slope and offset of the linear equation in log coordinates. + These screen shots show the result of drag- and drop for \emph{logarithmic} axes: the end points show, again, the coordinates (without logs) and the form field in the middle shows the slope and offset of the linear equation in log coordinates. The log basis for any logarithmic axes is usually~$10$, but it respects the current setting of |log basis x| and |log basis y|. The applied log will always use the same logarithm which is also used for the axis descriptions (this is not necessarily the same as used by \PGFPlotstable!). @@ -128,7 +128,7 @@ It is possible to customize |pgfplots.clickable| with several options. \end{pgfplotskey} \begin{pgfplotskey}{annot/font=\marg{javascript font name} (initially font.Times)} - Allows to choose a javascript font for the annotations. Possible choices are limited to what javascripts accepts (which is \emph{not} the same as \LaTeX). The default fonts and its names are shown below. + Allows to choose a javascript font for the annotations. Possible choices are limited to what javascript accepts (which is \emph{not} the same as \LaTeX). The default fonts and its names are shown below. \begin{center} \begin{tabular}{ll} diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.makefile b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.makefile index 2ff065a1d46..1f9688988df 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.makefile +++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.makefile @@ -4,144 +4,151 @@ ALL_FIGURES=$(ALL_FIGURE_NAMES:%=%.pdf) allimages: $(ALL_FIGURES) @echo All images exist now. Use make -B to re-generate them. -figures/expensiveexamplepgfplots-figure0.pdf: +FORCEREMAKE: + +include $(ALL_FIGURE_NAMES:%=%.dep) + +%.dep: + touch $@ # will be filled later. + +figures/expensiveexamplepgfplots-figure0.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure0" "pgfplots" -figures/expensiveexamplepgfplots-figure1.pdf: +figures/expensiveexamplepgfplots-figure1.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure1" "pgfplots" -figures/expensiveexamplepgfplots-figure2.pdf: +figures/expensiveexamplepgfplots-figure2.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure2" "pgfplots" -figures/expensiveexamplepgfplots-figure3.pdf: +figures/expensiveexamplepgfplots-figure3.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure3" "pgfplots" -figures/expensiveexamplepgfplots-figure4.pdf: +figures/expensiveexamplepgfplots-figure4.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure4" "pgfplots" -figures/expensiveexamplepgfplots-figure5.pdf: +figures/expensiveexamplepgfplots-figure5.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure5" "pgfplots" -figures/expensiveexamplepgfplots-figure6.pdf: +figures/expensiveexamplepgfplots-figure6.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure6" "pgfplots" -figures/expensiveexamplepgfplots-figure7.pdf: +figures/expensiveexamplepgfplots-figure7.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure7" "pgfplots" -figures/expensiveexamplepgfplots-figure8.pdf: +figures/expensiveexamplepgfplots-figure8.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure8" "pgfplots" -figures/expensiveexamplepgfplots-figure9.pdf: +figures/expensiveexamplepgfplots-figure9.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure9" "pgfplots" -figures/expensiveexamplepgfplots-figure10.pdf: +figures/expensiveexamplepgfplots-figure10.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure10" "pgfplots" -figures/expensiveexamplepgfplots-figure11.pdf: +figures/expensiveexamplepgfplots-figure11.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure11" "pgfplots" -figures/expensiveexamplepgfplots-figure12.pdf: +figures/expensiveexamplepgfplots-figure12.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure12" "pgfplots" -figures/expensiveexamplepgfplots-figure13.pdf: +figures/expensiveexamplepgfplots-figure13.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure13" "pgfplots" -figures/expensiveexamplepgfplots-figure14.pdf: +figures/expensiveexamplepgfplots-figure14.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure14" "pgfplots" -figures/expensiveexamplepgfplots-figure15.pdf: +figures/expensiveexamplepgfplots-figure15.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure15" "pgfplots" -figures/expensiveexamplepgfplots-figure16.pdf: +figures/expensiveexamplepgfplots-figure16.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure16" "pgfplots" -figures/expensiveexamplepgfplots-figure17.pdf: +figures/expensiveexamplepgfplots-figure17.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure17" "pgfplots" -figures/expensiveexamplepgfplots-figure18.pdf: +figures/expensiveexamplepgfplots-figure18.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure18" "pgfplots" -figures/expensiveexamplepgfplots-figure19.pdf: +figures/expensiveexamplepgfplots-figure19.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure19" "pgfplots" -figures/expensiveexamplepgfplots-figure20.pdf: +figures/expensiveexamplepgfplots-figure20.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure20" "pgfplots" -figures/expensiveexamplepgfplots-figure21.pdf: +figures/expensiveexamplepgfplots-figure21.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure21" "pgfplots" -figures/expensiveexamplepgfplots-figure22.pdf: +figures/expensiveexamplepgfplots-figure22.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure22" "pgfplots" -figures/expensiveexamplepgfplots-figure23.pdf: +figures/expensiveexamplepgfplots-figure23.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure23" "pgfplots" -figures/expensiveexamplepgfplots-figure24.pdf: +figures/expensiveexamplepgfplots-figure24.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure24" "pgfplots" -figures/expensiveexamplepgfplots-figure25.pdf: +figures/expensiveexamplepgfplots-figure25.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure25" "pgfplots" -figures/expensiveexamplepgfplots-figure26.pdf: +figures/expensiveexamplepgfplots-figure26.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure26" "pgfplots" -figures/expensiveexamplepgfplots-figure27.pdf: +figures/expensiveexamplepgfplots-figure27.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure27" "pgfplots" -figures/expensiveexamplepgfplots-figure28.pdf: +figures/expensiveexamplepgfplots-figure28.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure28" "pgfplots" -figures/expensiveexamplepgfplots-figure29.pdf: +figures/expensiveexamplepgfplots-figure29.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure29" "pgfplots" -figures/expensiveexamplepgfplots-figure30.pdf: +figures/expensiveexamplepgfplots-figure30.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure30" "pgfplots" -figures/expensiveexamplepgfplots-figure31.pdf: +figures/expensiveexamplepgfplots-figure31.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure31" "pgfplots" -figures/expensiveexamplepgfplots-figure32.pdf: +figures/expensiveexamplepgfplots-figure32.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure32" "pgfplots" -figures/expensiveexamplepgfplots-figure33.pdf: +figures/expensiveexamplepgfplots-figure33.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure33" "pgfplots" -figures/expensiveexamplepgfplots-figure34.pdf: +figures/expensiveexamplepgfplots-figure34.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure34" "pgfplots" -figures/expensiveexamplepgfplots-figure35.pdf: +figures/expensiveexamplepgfplots-figure35.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure35" "pgfplots" -figures/expensiveexamplepgfplots-figure36.pdf: +figures/expensiveexamplepgfplots-figure36.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure36" "pgfplots" -figures/expensiveexamplepgfplots-figure37.pdf: +figures/expensiveexamplepgfplots-figure37.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure37" "pgfplots" -figures/expensiveexamplepgfplots-figure38.pdf: +figures/expensiveexamplepgfplots-figure38.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure38" "pgfplots" -figures/expensiveexamplepgfplots-figure39.pdf: +figures/expensiveexamplepgfplots-figure39.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure39" "pgfplots" -figures/expensiveexamplepgfplots-figure40.pdf: +figures/expensiveexamplepgfplots-figure40.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure40" "pgfplots" -figures/expensiveexamplepgfplots-figure41.pdf: +figures/expensiveexamplepgfplots-figure41.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure41" "pgfplots" -figures/expensiveexamplepgfplots-figure42.pdf: +figures/expensiveexamplepgfplots-figure42.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure42" "pgfplots" -figures/expensiveexamplepgfplots-figure43.pdf: +figures/expensiveexamplepgfplots-figure43.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure43" "pgfplots" -figures/expensiveexamplepgfplots-figure44.pdf: +figures/expensiveexamplepgfplots-figure44.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure44" "pgfplots" -figures/expensiveexamplepgfplots-figure45.pdf: +figures/expensiveexamplepgfplots-figure45.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure45" "pgfplots" -figures/expensiveexamplepgfplots-figure46.pdf: +figures/expensiveexamplepgfplots-figure46.pdf: pdflatex -shell-escape -halt-on-error -interaction=batchmode -jobname "figures/expensiveexamplepgfplots-figure46" "pgfplots" diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.pdf b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.pdf Binary files differindex 170ab6b8f99..238d646785b 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.pdf +++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.pdf diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.preamble.tex b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.preamble.tex index 89d61c21c26..8d2bf40ada7 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.preamble.tex +++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.preamble.tex @@ -117,9 +117,11 @@ \usepackage{eurosym} \input{pgfplots-macros} +\usepackage{nicefrac} + \graphicspath{{figures/}} -\def\preambleconfig{width=7cm,compat=newest} +\def\preambleconfig{width=7cm,compat=1.3} \expandafter\pgfplotsset\expandafter{\preambleconfig} diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.2dplots.tex b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.2dplots.tex index 7999d661e5b..cb55235b94d 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.2dplots.tex +++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.2dplots.tex @@ -34,7 +34,7 @@ Smooth plots interpolate smoothly between successive points. \end{plottype} \subsubsection{Constant Plots} -Constant plots draw lines parallel to the $x$-axis to connect coordinates. The discontinuos edges may be drawn or not, and marks may be placed on left or right ends. +Constant plots draw lines parallel to the $x$-axis to connect coordinates. The discontinuous edges may be drawn or not, and marks may be placed on left or right ends. \begin{plottype}{const plot} Connects all points with horizontal and vertical lines. Marks are placed left-handed on horizontal line segments, causing the plot to be right-sided continuous at all data points. @@ -580,13 +580,13 @@ Area plots may need modified legends, for example using the |area legend| key. F \end{codeexample} \begin{codeexample}[] -\pgfplotstableread{pgfplots.timeseries.dat}\table -\pgfplotstabletypeset\table +\pgfplotstableread{pgfplots.timeseries.dat}\loadedtable +\pgfplotstabletypeset\loadedtable \end{codeexample} \begin{codeexample}[] \pgfplotstableread {pgfplots.timeseries.dat} - {\table} + {\loadedtable} \begin{tikzpicture} \begin{axis}[ @@ -604,19 +604,19 @@ Area plots may need modified legends, for example using the |area legend| key. F legend columns=-1}] \addplot[draw=blue,fill=blue!30!white] - table[x=time,y=1minload] from \table + table[x=time,y=1minload] from \loadedtable \closedcycle; - \addplot table[x=time,y=nodes] from \table; - \addplot table[x=time,y=cpus] from \table; + \addplot table[x=time,y=nodes] from \loadedtable; + \addplot table[x=time,y=cpus] from \loadedtable; \addplot table[x=time,y=processes] - from \table; + from \loadedtable; \legend{1min load,nodes,cpus,processes} \end{axis} \end{tikzpicture} \end{codeexample} \begin{codeexample}[width=4cm] -\pgfplotstableread{pgfplots.timeseries.dat}\table +\pgfplotstableread{pgfplots.timeseries.dat}\loadedtable \begin{tikzpicture} \begin{axis}[ @@ -639,11 +639,11 @@ Area plots may need modified legends, for example using the |area legend| key. F anchor=north, legend columns=2}] - \addplot table[x=time,y=memused] from \table \closedcycle; - \addplot table[x=time,y=memcached] from \table \closedcycle; - \addplot table[x=time,y=membuf] from \table \closedcycle; + \addplot table[x=time,y=memused] from \loadedtable \closedcycle; + \addplot table[x=time,y=memcached] from \loadedtable \closedcycle; + \addplot table[x=time,y=membuf] from \loadedtable \closedcycle; \addplot+[stack plots=false] - table[x=time,y=memtotal] from \table; + table[x=time,y=memtotal] from \loadedtable; \legend{Memory used,Memory cached,Memory buffered,Total memory} \end{axis} \end{tikzpicture} @@ -798,9 +798,9 @@ Scatter plots can be configured using a set of options. One of them is mandatory \paragraph{Remark:} The style |use mapped color| \emph{re}defines |@pre marker code| and |@post marker code|. There is a starred variant \declareandlabel{use mapped color*} which \emph{appends} the functionality while keeping the old marker code. \end{stylekey} -\begin{stylekey}{/pgfplots/scatter/classes=\marg{styles for each classname}} +\begin{stylekey}{/pgfplots/scatter/classes=\marg{styles for each class name}} \label{pgfplots:scatterclasses} - A scatter plot style which visualizes points using several classes. The style assumes that every point coordinate has a class label attached, that means the choice |scatter src=explicit symbolic| is assumed\footnote{If \texttt{scatter src} is not \texttt{explicit symbolic}, we expect a numeric argument which is rounded to the nearest integer. The resulting integer is used a class label. If that fails, the numeric argument is truncated to the nearest integer. If that fails as well, the point has no label.}. A class label can be a number, but it can also be a symbolic constant. Given class labels for every point, \marg{styles for each classname} contains a comma-separated list which associates appearance options to each class label. + A scatter plot style which visualizes points using several classes. The style assumes that every point coordinate has a class label attached, that means the choice |scatter src=explicit symbolic| is assumed\footnote{If \texttt{scatter src} is not \texttt{explicit symbolic}, we expect a numeric argument which is rounded to the nearest integer. The resulting integer is used a class label. If that fails, the numeric argument is truncated to the nearest integer. If that fails as well, the point has no label.}. A class label can be a number, but it can also be a symbolic constant. Given class labels for every point, \marg{styles for each class name} contains a comma-separated list which associates appearance options to each class label. \begin{codeexample}[] \begin{tikzpicture} @@ -870,9 +870,9 @@ It is also possible to provide |scatter/classes| as argument to a single plot, a \end{tikzpicture} \end{codeexample} -In general, the format of \marg{styles for each classname} is a comma separated list of \meta{label}|=|\marg{style options}. +In general, the format of \marg{styles for each class name} is a comma separated list of \meta{label}|=|\marg{style options}. -\paragraph{Attention:} The keys |every mark| and |mark options| have \emph{no effect} when used inside of \marg{styles for each classname}! So, instead of assigning |mark options|, you can simply provide the options directly. They apply only to markers anyway. +\paragraph{Attention:} The keys |every mark| and |mark options| have \emph{no effect} when used inside of \marg{styles for each class name}! So, instead of assigning |mark options|, you can simply provide the options directly. They apply only to markers anyway. \paragraph{Remark:} To use |\label| and |\ref| in conjunction with |scatter/classes|, you can provide the class labels as optional arguments to |\label| in square brackets: @@ -970,7 +970,7 @@ First class is \ref{label:for:first:class}, second is \ref{label:for:second:clas scatter/@post marker code} These two keys constitute the public interface which determines the marker appearance depending on scatter source coordinates. - Redefining them allows fine grained control even over marker types, linestyles and colors. + Redefining them allows fine grained control even over marker types, line styles and colors. The scatter plot algorithm works as follows: \begin{enumerate} @@ -1054,7 +1054,7 @@ Please note that |\ifdim| compares \TeX\ lengths, so the example employs the suf \subsubsection{Interrupted Plots} \index{Interrupted Plots}% \label{pgfplots:interrupt}% -Sometimes it is desireable to draw parts of a single plot separately, without connection between the parts (discontinuities). This can be achieved using the |unbounded coords| key combined with coordinate values |nan|, |inf| or |-inf|. +Sometimes it is desirable to draw parts of a single plot separately, without connection between the parts (discontinuities). This can be achieved using the |unbounded coords| key combined with coordinate values |nan|, |inf| or |-inf|. \begin{pgfplotskey}{unbounded coords=\mchoice{discard,jump} (initially discard)} This key configures what to do if one or more coordinates of a single point are unbounded. Here, unbounded means it is either $\pm \infty$ (|+inf| or |-inf|) or it has the special ``not--a--number'' value |nan|. diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.3dconfiguration.tex b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.3dconfiguration.tex index 4192dae2e56..a34e70054e5 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.3dconfiguration.tex +++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.3dconfiguration.tex @@ -1,7 +1,7 @@ \subsection{3D Axis Configuration} -This section described keys which are used to configure the appearance of three dimensional figures. Some of them apply for twodimensional plots as special case as well, and they will also be discussed in the respective sections of this manual. +This section described keys which are used to configure the appearance of three dimensional figures. Some of them apply for two--dimensional plots as special case as well, and they will also be discussed in the respective sections of this manual. \subsubsection{View Configuration} \begin{pgfplotskey}{view=\marg{azimuth}\marg{elevation} (initially \{25\}\{30\})} diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.3dplots.tex b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.3dplots.tex index 2140d0d15bf..05c431c0588 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.3dplots.tex +++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.3dplots.tex @@ -22,11 +22,11 @@ Enough for now, let's continue. The \verbpdfref{\addplot3} command accepts the same input methods as the |\addplot| variant, including expression plotting, coordinates, files and tables. However, a third coordinate is necessary for each of these methods which is usually straight--forward and is explained in all detail in the following. - Furthermore, \verbpdfref{\addplot3} has a way to decide whether a \emph{line} visualization or a \emph{mesh} visualization has to be done. The first one is map from one dimension into $\R^3$ and the latter one a map from two dimensions to $\R^3$. Here, the keys |mesh/rows| and |mesh/cols| are used to define mesh sizes (matrix sizes). Usually, you don't have to care about that because the coordinate input routines already allow either onedimensional or two dimensional structure. + Furthermore, \verbpdfref{\addplot3} has a way to decide whether a \emph{line} visualization or a \emph{mesh} visualization has to be done. The first one is map from one dimension into $\R^3$ and the latter one a map from two dimensions to $\R^3$. Here, the keys |mesh/rows| and |mesh/cols| are used to define mesh sizes (matrix sizes). Usually, you don't have to care about that because the coordinate input routines already allow either one--dimensional or two dimensional structure. \end{addplot3generic} \begin{addplot3operation}[]{coordinates}{\marg{coordinate list}} - The \verbpdfref{\addplot3 coordinates} method works like its twodimensional variant, \verbpdfref{\addplot coordinates} which is described in all detail on page~\pageref{pgfplots:addplot:coordinates}: + The \verbpdfref{\addplot3 coordinates} method works like its two--dimensional variant, \verbpdfref{\addplot coordinates} which is described in all detail on page~\pageref{pgfplots:addplot:coordinates}: A long list of coordinates |(|\meta{x}|,|\meta{y}|,|\meta{z}|)| is expected, separated by white spaces. The input list can be either an unordered series of coordinates, for example for scatter or line plots. It can also have matrix structure, in which case an empty input line (which is equivalent to ``|\par|'') marks the end of one matrix row. Matrix structure can also be provided if one of |mesh/rows| or |mesh/cols| is provided explicitly. @@ -47,7 +47,7 @@ Enough for now, let's continue. \end{codeexample} \noindent Here, \verbpdfref{\addplot3} reads a matrix with three rows and four columns. The empty lines separate one row from the following. - As for the twodimensional |plot coordinates|, it is possible to provide (constant) mathematical expressions inside of single coordinates. The syntax |(|\meta{x}|,|\meta{y}|,|\meta{z}|) |\oarg{meta} can be used just as for two dimensional |plot coordinates| to provide explicit color data; error bars are also supported. + As for the two--dimensional |plot coordinates|, it is possible to provide (constant) mathematical expressions inside of single coordinates. The syntax |(|\meta{x}|,|\meta{y}|,|\meta{z}|) |\oarg{meta} can be used just as for two dimensional |plot coordinates| to provide explicit color data; error bars are also supported. \end{addplot3operation} \begin{addplot3operation}[]{file}{\marg{name}} @@ -91,7 +91,7 @@ Enough for now, let's continue. \end{addplot3operation} \begin{addplot3operation}[]{table}{\oarg{column selection}\marg{file}} - The \verbpdfref{\addplot3 table} input works in the same way as its two dimensional counterpart \verbpdfref{\addplot table}. It only expects a column for the $z$ coordinates. Furthermore, it interpretes empty input lines as end--of--row (more generally, end--of--scanline) markers, just as for |plot file|. The remarks above about the |mesh/ordering| applies here as well. + The \verbpdfref{\addplot3 table} input works in the same way as its two dimensional counterpart \verbpdfref{\addplot table}. It only expects a column for the $z$ coordinates. Furthermore, it interprets empty input lines as end--of--row (more generally, end--of--scanline) markers, just as for |plot file|. The remarks above about the |mesh/ordering| applies here as well. \end{addplot3operation} \begin{pgfplotskeylist}{mesh/rows=\marg{integer},mesh/cols=\marg{integer}} @@ -126,7 +126,7 @@ Enough for now, let's continue. \end{pgfplotskeylist} \begin{pgfplotskey}{mesh/ordering=\mchoice{x varies,y varies,rowwise,colwise} (initially x varies)} - Allows to configure the sequence in which matrizes (meshes) are read from \verbpdfref{\addplot3 coordinates}, \verbpdfref{\addplot3 file} or \verbpdfref{\addplot3 table}. + Allows to configure the sequence in which matrices (meshes) are read from \verbpdfref{\addplot3 coordinates}, \verbpdfref{\addplot3 file} or \verbpdfref{\addplot3 table}. Here, \declaretext{x varies} means a sequence of points where $n$=|mesh/cols| successive points have the $y$ coordinate fixed. This is intuitive when you write down a function because $x$ is horizontal and $y$ vertical. Note that in matrix terminology, $x$ refers to \emph{column indices} whereas $y$ refers to \emph{row indices}. Thus, |x varies| is equivalent to \declaretext{rowwise} ordering in this sense. This is the initial configuration. @@ -380,7 +380,7 @@ The following example uses |mark=cube*| and |z buffer=sort| to place boxes at ea \subsubsection{Mesh Plots} \label{sec:2d:mesh} \begin{plottype}[/pgfplots]{mesh} - A mesh plot uses different colors for each mesh segment. Each mesh segment gets the same color. The color is determined using a ``color coordinate'' which is also called ``meta data'' throughout this document. It is the same data which is used for surface and scatter plots as well, see section~\ref{pgfplots:pointmeta}. In the initial configuration, the ``color coordinate'' is the $z$ axis (or the $y$ axis for two dimensional plots). This color coordinate is mapped linearly into the current color map to determine the color for each mesh segment. Thus, if the smallest occuring color data is, say, $-1$ and the largest is $42$, points with color data $-1$ will get the color at the lower end of the color map and points with color data $42$ the color of the upper end of the color map. + A mesh plot uses different colors for each mesh segment. Each mesh segment gets the same color. The color is determined using a ``color coordinate'' which is also called ``meta data'' throughout this document. It is the same data which is used for surface and scatter plots as well, see section~\ref{pgfplots:pointmeta}. In the initial configuration, the ``color coordinate'' is the $z$ axis (or the $y$ axis for two dimensional plots). This color coordinate is mapped linearly into the current color map to determine the color for each mesh segment. Thus, if the smallest occurring color data is, say, $-1$ and the largest is $42$, points with color data $-1$ will get the color at the lower end of the color map and points with color data $42$ the color of the upper end of the color map. \pgfplotsexpensiveexample \begin{codeexample}[] @@ -560,13 +560,13 @@ The following example uses |mark=cube*| and |z buffer=sort| to place boxes at ea \noindent The |flat| shader provides full support of |z buffer|ing, that means it does also support the choice |z buffer=sort|. There are (currently) two possibilities to determine the single color for every segment: \begin{description} - \item[\declaretext{flat corner}] Uses the color data of one vertex to color the segment. It is not defined which vertex is used here\footnote{\PGFPlots\ just uses the last vertex encountered in its internal processings -- but after any $z$ buffer reorderings.}. + \item[\declaretext{flat corner}] Uses the color data of one vertex to color the segment. It is not defined which vertex is used here\footnote{\PGFPlots\ just uses the last vertex encountered in its internal processings -- but after any $z$ buffer re-orderings.}. \item[\declaretext{flat mean}] Uses the mean of all four color data values as segment color. This is the initial value as it provides symmetric colors for symmetric functions. \end{description} The choice |flat| is actually the same as |flat mean|. Please note that |shader=flat mean| and |shader=flat corner| also influence mesh plots -- the choices determine the mesh segment color. - Another choice is |shader=interp| which uses Gouraud shading (bilinear interpolation) to fill the segments. + Another choice is |shader=interp| which uses Goraud shading (bilinear interpolation) to fill the segments. \pgfplotsexpensiveexample \begin{codeexample}[] diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.alignment.tex b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.alignment.tex index 9c8c9ccb9ea..9386714999c 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.alignment.tex +++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.alignment.tex @@ -13,7 +13,9 @@ The idea is to provide an \marg{coordinate expression} where the axis will be pl \begin{pgfplotskey}{anchor=\marg{name} (initially south west)} \label{option:anchor}% -This option shifts the axis horizontally and vertically such that the axis anchor (a point on the axis) is placed at canvas coordinate $(0,0)$ (this is \emph{not} the logical coordinate, it is an image coordinate). For users who are familiar with \Tikz: an axis is actually a very special node, so anchors work as in~\cite{tikz}. +Chooses one of the different possible positions inside of an axis which is placed with |at|. The |at| key defines the position where to place the axis inside of the embedding picture, the |anchor| key defines which point of the axis shall be positioned by `|at|'. The initial configuration assumes |at={(0,0)}|. Thus, |anchor=center| will place the axis' center at the logical picture position $(0,0)$. Similarly, |anchor=south west| will position the lower left corner of the axis at $(0,0)$. + +For users who are familiar with \Tikz: an axis is actually a very special node, so anchors work as in~\cite{tikz}. Anchors are useful in conjunction with horizontal or vertical alignment of plots, see the examples below. @@ -133,9 +135,17 @@ The default value is |anchor=south west|. You can use anchors in conjunction wit \subsubsection{Vertical alignment with \texttt{baseline}} \label{sec:align}% -\pgfmanualpdflabel{/tikz/baseline}{}% +\begin{key}{/tikz/baseline} +The |baseline| option should be provided as argument to a |tikzpicture|. It configures \Tikz\ to shift the picture position $y=0$ to the embedding text's baseline: +\begin{codeexample}[width=3cm] +This is \tikz[baseline]\fill[red] (0,0) circle(3pt); a picture, +here \tikz[baseline]\fill[red] (0,10pt) circle(3pt); another one. +\end{codeexample} +\noindent Consequently, the |baseline| option allows to align different |tikzpicture|s. An axis is, by default, placed with |at={(0,0)}|, and the |anchor| key specifies which part of the axis is placed at |(0,0)|. Consequently, the |baseline| option, together with |anchor|, allows to align different axes with the embedding text. + The default axis anchor is |south west|, which means that the picture coordinate $(0,0)$ is the lower left corner of the axis. As a consequence, the \Tikz\ option ``|baseline|'' allows vertical alignment of adjacent plots: \begin{codeexample}[] +% 1. Unaligned: \pgfplotsset{domain=-1:1} \begin{tikzpicture} \begin{axis}[xlabel=A normal sized $x$ label] @@ -151,6 +161,7 @@ The default axis anchor is |south west|, which means that the picture coordinate \end{codeexample} \begin{codeexample}[] +% 2. Aligned: \pgfplotsset{domain=-1:1} \begin{tikzpicture}[baseline] \begin{axis}[xlabel=A normal sized $x$ label] @@ -164,7 +175,8 @@ The default axis anchor is |south west|, which means that the picture coordinate \end{axis} \end{tikzpicture} \end{codeexample} -The |baseline| option configures \Tikz\ to shift position $y=0$ to the text's baseline and the |south west| anchor shifts the axis such the $y=0$ is at the lower left axis corner. +\end{key} +The |baseline| key is related to |\begin{minipage}|\oarg{align how} or |\begin{tabular}|\oarg{align how}: the \meta{align how} tells \LaTeX\ which part of the |minipage| or |tabular| shall be positioned on the baseline. Thus, |baseline| does the some for pictures (with more freedom for \meta{align how}). \subsubsection{Horizontal Alignment} \label{sec:halign}% diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.axis-addplot.tex b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.axis-addplot.tex index ae02b4c8bb8..4af602d4fd8 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.axis-addplot.tex +++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.axis-addplot.tex @@ -133,7 +133,7 @@ coordinates \end{tikzpicture} \end{codeexample} -Inside of an axis environment, the |\addplot| command is the main user interface. It comes in two variants: |\addplot| for twodimensional visualization and \verbpdfref{\addplot3} for threedimensional visualization. +Inside of an axis environment, the |\addplot| command is the main user interface. It comes in two variants: |\addplot| for two--dimensional visualization and \verbpdfref{\addplot3} for three--dimensional visualization. \begin{command}{\addplot\oarg{options} \meta{input data} \meta{trailing path commands};} \label{cmd:pgfplots:addplot} @@ -141,7 +141,7 @@ This is the main plotting command, available within each axis environment. It ca It reads point coordinates from one of the available input sources specified by \meta{input data}, updates limits, remembers \meta{options} for use in a legend (if any) and applies any necessary coordinate transformations (or logarithms). -The \meta{options} can be omitted in which case the next entry from the |cycle list| will be inserted as \meta{options}. These keys characterize the plot's type like linear interpolation, smooth plot, constant interpolation, bar plot, mesh plots, surface plots or whatever and define colors, markers and line specifications\footnote{In version 1.2.2 and earlier, there was an explicit distiction between ``behaviour'' options like error bars, domain, number of samples etc.\ and ``style options'' like color, line width, markers etc. This distiction is obsolete now, simply collect everything into \meta{options}.}\index{Behavior Options}\index{Options!Distinction Behavior, Style Options}. Plot variants like error bars, the number of samples or a sample domain can also be configured in \meta{options}. +The \meta{options} can be omitted in which case the next entry from the |cycle list| will be inserted as \meta{options}. These keys characterize the plot's type like linear interpolation, smooth plot, constant interpolation, bar plot, mesh plots, surface plots or whatever and define colors, markers and line specifications\footnote{In version 1.2.2 and earlier, there was an explicit distinction between ``behaviour'' options like error bars, domain, number of samples etc.\ and ``style options'' like color, line width, markers etc. This distinction is obsolete now, simply collect everything into \meta{options}.}\index{Behavior Options}\index{Options!Distinction Behavior, Style Options}. Plot variants like error bars, the number of samples or a sample domain can also be configured in \meta{options}. The \meta{input data} is one of several coordinate input tools which are described in more detail below. Finally, if |\addplot| successfully processed all coordinates from \meta{input data}, it generates \Tikz\ paths to realize the drawing operations. Any \meta{trailing path commands} are appended to the final drawing command, allowing to continue the \Tikz\ path (from the last plot coordinate). @@ -177,7 +177,7 @@ Some more details: \end{codeexample} You can represent arbitrarily small or very large numbers as long as its logarithm can be represented as a \TeX-length (up to about~$16384$). Of course, any coordinate~$x\le 0$ is not possible since the logarithm of a non-positive number is not defined. Such coordinates will be skipped automatically (using the initial configuration |unbounded coords=discard|). - \item For normal (non--logarithmic) axes, \PGFPlots\ applies floating point arithmetics to support large or small numbers like 0.00000001234 or $1.234\cdot 10^{24}$. Its number range is much larger than \TeX's native support for numbers. The relative precision is between $4$ and $7$ significant decimal digits for the mantisse. + \item For normal (non--logarithmic) axes, \PGFPlots\ applies floating point arithmetics to support large or small numbers like 0.00000001234 or $1.234\cdot 10^{24}$. Its number range is much larger than \TeX's native support for numbers. The relative precision is between $4$ and $7$ significant decimal digits for the mantissa. As soon as the axes limits are completely known, \PGFPlots\ applies a transformation which maps these floating point numbers into \TeX-precision using transformations \[ T_x(x) = 10^{s_x} \cdot x - a_x @@ -373,11 +373,11 @@ or \end{codeexample} Alternatively, you can load the table \emph{once} and use it \emph{multiple} times: \begin{codeexample}[code only] -\pgfplotstableread{datafile.dat}\table +\pgfplotstableread{datafile.dat}\loadedtable ... -\addplot table[x=dof,y=L2] from \table; +\addplot table[x=dof,y=L2] from \loadedtable; ... -\addplot table[x=dof,y=Lmax] from \table; +\addplot table[x=dof,y=Lmax] from \loadedtable; ... \end{codeexample} I am not really sure how much time can be saved, but it works anyway. As a rule of thumb, decide as follows: @@ -432,6 +432,9 @@ Summary and remarks: \end{itemize} \end{addplotoperation} +\subsubsection*{Keys To Configure Table Input} +The following list of keys allow different methods to select input data or different input formats. Note that the common prefix `|table/|' can be omitted if these keys are set after |\addplot table|\oarg{options}. The |/pgfplots/| prefix can always be omitted when used in a \PGFPlots\ method. + \begin{pgfplotskey}{table/header=\mchoice{true,false} (initially true)} Allows to disable header identification for |plot table|. See above. \end{pgfplotskey} @@ -526,7 +529,7 @@ Please note that \PGF's math parser uses degrees for trigonometric functions: %\index{y@\texttt{\textbackslash y} In Coordinate Expressions}% \item The complete set of math expressions can be found in the \PGF\ manual. The most important mathematical operations are - |+|, |-|, |*|, |/|, |abs|, |round|, |floor|, |mod|, |<|, |>|, |max|, |min|, |sin|, |cos|, |tan|, |deg| (conversion from radians to degrees), |rad| (conversion from degrees to radians), |atan|, |asin|, |acos|, |cot|, |sec|, |cosec|, |exp|, |ln|, |sqrt|, the constanst |pi| and |e|, |^| (power operation), |factorial|\footnote{Starting with \PGF\ versions newer than $2.00$, you can use the postfix operator \texttt{!} instead of \texttt{factorial}.}, |rand| (random between $-1$ and $1$), |rnd| (random between $0$ and $1$), number format conversions |hex|, |Hex|, |oct|, |bin| and some more. The math parser has been written by Mark Wibrow and Till Tantau~\cite{tikz}, the FPU routines have been developed as part of \PGFPlots. The documentation for both parts can be found in~\cite{tikz}. + |+|, |-|, |*|, |/|, |abs|, |round|, |floor|, |mod|, |<|, |>|, |max|, |min|, |sin|, |cos|, |tan|, |deg| (conversion from radians to degrees), |rad| (conversion from degrees to radians), |atan|, |asin|, |acos|, |cot|, |sec|, |cosec|, |exp|, |ln|, |sqrt|, the constants |pi| and |e|, |^| (power operation), |factorial|\footnote{Starting with \PGF\ versions newer than $2.00$, you can use the postfix operator \texttt{!} instead of \texttt{factorial}.}, |rand| (random between $-1$ and $1$), |rnd| (random between $0$ and $1$), number format conversions |hex|, |Hex|, |oct|, |bin| and some more. The math parser has been written by Mark Wibrow and Till Tantau~\cite{tikz}, the FPU routines have been developed as part of \PGFPlots. The documentation for both parts can be found in~\cite{tikz}. Please note, however, that trigonometric functions are defined in degrees. The character `|^|' is used for exponentiation (not `|**|' as in gnuplot). @@ -627,6 +630,16 @@ Please note that \PGF's math parser uses degrees for trigonometric functions: \paragraph{Attention:} |samples at| overrides |domain|, even if |domain| has been set \emph{after} |samples at|! Use |samples at={}| to clear \marg{coordinate list} and re-activate |domain|. \end{pgfplotskey} +\begin{pgfplotskeylist}{% + variable=\marg{variable name} (initially x),% + variable y=\marg{variable name} (initially y)} + Defines the variables names which will be sampled in |domain| (with |variable|) and in |domain y| (with |variable y|). + + The same variables are used for parametric and for non-parametric plots. Use |variable=t| to change them if you like (for |gnuplot|, there is such a distinction; see |parametric/var 1d|). + + Technical remark: \Tikz\ also uses the |variable| key. However, it expects a \emph{macro} name, i.e.\ |\x| instead of just |x|. Both possibilities are accepted here. +\end{pgfplotskeylist} + \subsubsection{Mathematical Expressions And File Data} \PGFPlots\ allows to combine `|plot table|' and `|plot expression|' to get both, file input and modifications by means of mathematical expressions. @@ -635,6 +648,8 @@ Please note that \PGF's math parser uses degrees for trigonometric functions: Besides the already discussed possibility to provide a column selection by means of column names (|x||=|\meta{name} or |x index||=|\meta{index}, see section~\ref{pgfplots:addplot:table}), it is also possible to provide mathematical expressions as arguments. Mathematical expressions are specified with |x expr||=|\meta{expression} inside of \meta{column selection and expressions}. They can depend on zero, one or more columns of the input file. A column is referenced using the special command `|\thisrow|\marg{column name}' within \meta{expression} (or |\thisrowno|\meta{column index}). + +\pgfplotstableset{begin table={\begin{tabular}[b]}} \begin{codeexample}[vbox] \pgfplotstabletypeset[columns={maxlevel,L2}]{plotdata/newexperiment1.dat} @@ -721,15 +736,20 @@ Sometimes it is called |shell-escape| or |enable-write18|. Sometimes one needs t The \meta{options} determine the appearance of the plotted function; these parameters also affect the legend. There is also a set of options which are specific to the gnuplot interface. These options are described in all detail in \cite[section~18.6]{tikz}. A short summary is shown below. + +Some remarks: +\begin{itemize} + \item The independent variable for one dimensional plots can be change with the |variable| option, just as for |plot expression|. Similarly, the second variable for two dimensional plots can be changed with |variable y|. + + For |parametric| plots, the variable names need to be adjusted with |parametric/var 1d| and |parametric/var 2d| (since gnuplot uses |t| and |u,v| as initial values for |parametric| plots). + \item Please note that |plot gnuplot| does not allow per point meta data (color data for each coordinate). -Please refer to \cite[section~18.6]{tikz} for more details about |plot function| and the |gnuplot| interaction. + \item The generated output file name can be customized with |id|, see below. +\end{itemize} -\begin{pgfplotskey}{translate gnuplot=\mchoice{true,false} (initially true)} - Enables or disables automatic translation of the exponentiation operator `|^|' to `|**|'. +Please refer to \cite[section~18.6]{tikz} for more details about |plot function| and the |gnuplot| interaction. - This features allows to use |^| in |plot gnuplot| instead of gnuplot's |**|. -\end{pgfplotskey} \end{addplotoperation} \begin{addplotoperation}[]{function}{\marg{gnuplot code}} @@ -742,6 +762,30 @@ Please refer to \cite[section~18.6]{tikz} for more details about |plot function| |\addplot gnuplot |\marg{gnuplot code}|;| \end{addplotoperation} +\begin{pgfplotskey}{translate gnuplot=\mchoice{true,false} (initially true)} + Enables or disables automatic translation of the exponentiation operator `|^|' to `|**|'. + + This features allows to use |^| in |plot gnuplot| instead of gnuplot's |**|. +\end{pgfplotskey} + +\begin{pgfplotskey}{parametric=\mchoice{true,false} (initially false)} + Set this to |true| if you'd like to use parametric plots with |gnuplot|. Parametric plots use a comma separated list of expressions to make up $x(t),\, y(t)$ for a line plot or $x(u,v), \, y(u,v)\, z(u,v)$ for a mesh plot (refer to the gnuplot manual for more information about its input methods for parametric plots). +\end{pgfplotskey} + +\begin{pgfplotskeylist}{% + parametric/var 1d=\marg{variable name} (initially t),% + parametric/var 2d=\marg{variable name,variable name} (initially {u,v})% + } + Allows to change the dummy variables used by |parametric| |gnuplot| plots. The initial setting is the one of |gnuplot|: to use the dummy varialbe `|t|' for parametric line plots and `|u,v|' for parametric mesh plots. + + These keys are quite the same as |variable| and |variable y|, only for parametric plots. If you like to change variables for non-parametric plots, use |variable| and/or |variable y|. + + In case you don't want the distinction between parametric and non-parametric plots, use + + |\pgfplotsset{parametric/var 1d=,parametric/var 2d=}|. + +\end{pgfplotskeylist} + \begin{key}{/tikz/id=\marg{unique string identifier}} A unique identifier for the current plot. It is used to generate temporary filenames for |gnuplot| output. \end{key} @@ -900,6 +944,10 @@ Using |gv|, I determined that the bounding box needs to be shifted |12| units to The scaling will thus ignore the aspect ratio of the external image and prefer the one used by \PGFPlots. You will need to provide |width| and |height| to the \PGFPlots\ axis to change its scaling. Use the |scale only axis| key in such a case. \end{addplotoperation} + +\subsubsection*{Keys To Configure Plot Graphics} +The following list of keys configure |\addplot graphics|. Note that the common prefix `|plot graphics/|' can be omitted if these keys are set after |\addplot graphics|\oarg{options}. The |/pgfplots/| prefix can always be omitted when used in a \PGFPlots\ method. + \begin{pgfplotsxykeylist}{ plot graphics/\x min=\marg{coordinate}, plot graphics/\x max=\marg{coordinate}} diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.axisdescription.tex b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.axisdescription.tex index 6c220b201ae..746c007d1eb 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.axisdescription.tex +++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.axisdescription.tex @@ -305,15 +305,15 @@ Labels are \Tikz-Nodes which are placed with \end{codeexample} so their position and appearance can be customized. -\paragraph{Upgrade notice:} Since version 1.3, label placement \emph{can} respect the size of adjacent tick labels. Use |\pgfplotsset{compat=newest}| in the preamble to activate this feature. See |xlabel near ticks| for details. +\paragraph{Upgrade notice:} Since version 1.3, label placement \emph{can} respect the size of adjacent tick labels. Use |\pgfplotsset{compat=1.3}| in the preamble to activate this feature. See |xlabel near ticks| for details. \begin{pgfplotsxykeylist}{\x label shift=\marg{dimension} (initially 0pt),label shift=\marg{dimension}} Shifts labels in direction of the outer normal vector of the axis by an amount of \marg{dimension}. The |label shift| sets all three label shifts to the same value. - \paragraph{Attention:} This does only work if |\pgfplotsset{compat=newest}| has been called (More precisely: if |xlabel near ticks| is active for the respective axis). + \paragraph{Attention:} This does only work if |\pgfplotsset{compat=1.3}| has been called (More precisely: if |xlabel near ticks| is active for the respective axis). \end{pgfplotsxykeylist} -\begin{pgfplotsxykeylist}{\x label near ticks,compat=newest} +\begin{pgfplotsxykeylist}{\x label near ticks,compat=1.3} These keys place axis labels (like |xlabel|) near the tick labels. If tick labels are small, labels will move closer to the axis. If tick labels are large, axis labels will move away from the axis. This is the default for every three dimensional plot, but it \emph{won't} be used initially for two--dimensional plots for backwards compatibility. Take a look at the definition of |near ticklabel| on page~\pageref{key:near:ticklabel} for an example. The definition of these styles is @@ -334,13 +334,13 @@ so their position and appearance can be customized. It is encouraged to write \begin{codeexample}[code only] -\pgfplotsset{compat=newest} +\pgfplotsset{compat=1.3} \end{codeexample} \noindent in your preamble to install the styles document-wide -- it leads to the best output (it avoids unnecessary space). It is not activated initially for backwards compatibility with older versions which used fixed distances from the tick labels. \end{pgfplotsxykeylist} \begin{pgfplotsxykeylist}{\x label absolute,compat=pre 1.3} - Installs placement styles for axis labels such that |xlabel| yields a description of absolute, fixed distance to the axis. This is the initial configuration (for backwards compatibility with versions before 1.3). Use |compat=newest| to get the most recent, more flexible configuration. Take a look at the definition of |near ticklabel| on page~\pageref{key:near:ticklabel} for an example. + Installs placement styles for axis labels such that |xlabel| yields a description of absolute, fixed distance to the axis. This is the initial configuration (for backwards compatibility with versions before 1.3). Use |compat=1.3| to get the most recent, more flexible configuration. Take a look at the definition of |near ticklabel| on page~\pageref{key:near:ticklabel} for an example. These styles are defined by \begin{codeexample}[code only] @@ -566,16 +566,16 @@ Using |\legend| overwrites any other existing legend entries. \end{pgfplotskey} -\begin{command}{\legendimage\marg{options}} +\begin{command}{\addlegendimage\marg{options}} Adds a further ``plot style'' for legend creation. - Each |\addplot| command appends its plot style options to a list, and |\legendimage| adds \meta{options} to the very same list. + Each |\addplot| command appends its plot style options to a list, and |\addlegendimage| adds \meta{options} to the very same list. - Thus, the effect is as if you had provided |\addplot|\oarg{options}, but |\legendimage| bypasses all the logic usually associated with a plot. In other words: except for the legend, the state of the axis remains as if the command would not have been drawn. + Thus, the effect is as if you had provided |\addplot|\oarg{options}, but |\addlegendimage| bypasses all the logic usually associated with a plot. In other words: except for the legend, the state of the axis remains as if the command would not have been drawn. Not even the current plot's index is advanced, making |\addlegendimage| compatible with any plot styles like |ybar|. - Use |\legendimage| to provide custom styles into legends, for example to document custom |\draw| commands inside of an axis. + Use |\addlegendimage| to provide custom styles into legends, for example to document custom |\draw| commands inside of an axis. - You can call |\label| after |\legendimage| just as for a normal style. + You can call |\label| after |\addlegendimage| just as for a normal style. \end{command} \subsubsection{Legend Appearance} @@ -782,6 +782,11 @@ Use |legend columns=-1| to draw all entries horizontally. Configures where the small line specifications will be drawn: left of the description, right of the description or not at all. \end{pgfplotskey} +\begin{stylekey}{/pgfplots/every legend image post} + \label{key:legendimagepost} + A style which can be used to provide drawing options to every small legend image. These options apply after |current plot style| has been set, allowing users different line styles for legends than for plots. +\end{stylekey} + \begin{pgfplotscodekey}{legend image code} \label{opt:legend:image:code} Allows to replace the default images which are drawn inside of legends. When this key is evaluated, the current plot specification has already been activated (using |\begin{scope}[current plot style]|)% @@ -965,7 +970,7 @@ Finally, \ref{pgfplots:label3} is only here to get three examples. Label3 = \ref{pgfplots:label3}; Label2 = \ref{pgfplots:label2} \end{codeexample} - The label is assembled using |legend image code| and the plot style of the last plot. Any \PGFPlots\ option is expanded until only \Tikz\ (or \pgfname) options remain; these options are used to get an independant label\footnote{Please note that you can't use the label/ref mechanism in conjunction with image externalization as this will (naturally) lead to undefined references.}. + The label is assembled using |legend image code| and the plot style of the last plot. Any \PGFPlots\ option is expanded until only \Tikz\ (or \pgfname) options remain; these options are used to get an independent label\footnote{Please note that you can't use the label/ref mechanism in conjunction with image externalization as this will (naturally) lead to undefined references.}. More precisely, the small image generated by |\ref|\marg{label name} is \begin{codeexample}[code only] @@ -1110,9 +1115,9 @@ Feel free to overwrite these styles if the default doesn't fit your needs or tas \end{tikzpicture} \end{codeexample} -In case |middle|, the style |every inner axis x line| allows to adjust the appearenace. +In case |middle|, the style |every inner axis x line| allows to adjust the appearance. -Note that three dimensional axes only support to use the same value for every axis, i.e.\ three dimensional axes support only the |axis lines| key (or, preferrably for 3D axes, the |axis lines*| key -- check what looks best). See section~\ref{sec:pgfplots:axislines:3d} for examples of three dimensional axis line variations. +Note that three dimensional axes only support to use the same value for every axis, i.e.\ three dimensional axes support only the |axis lines| key (or, preferably for 3D axes, the |axis lines*| key -- check what looks best). See section~\ref{sec:pgfplots:axislines:3d} for examples of three dimensional axis line variations. \end{pgfplotskeylist} \begin{pgfplotsxykey}{every inner \x\ axis line} @@ -1605,7 +1610,7 @@ Axis scaling and clipping will be done as if you did not use |hide axis|. \end{stylekey} \begin{stylekey}{/pgfplots/every colorbar} - This style governs the placement, alignment and appearance of color bars. Any desired detail changes for color bars can be put into this style. Additionally, there is a style |colorbar shift| which is set after |every colorbar|. The latter style is intented to contain only shift transformations like |xshift| or |yshift| (making it easier to overwrite or deactivate them). + This style governs the placement, alignment and appearance of color bars. Any desired detail changes for color bars can be put into this style. Additionally, there is a style |colorbar shift| which is set after |every colorbar|. The latter style is intended to contain only shift transformations like |xshift| or |yshift| (making it easier to overwrite or deactivate them). While a color bar is drawn, the predefined node |parent axis| can be used to align at the parent axis. \begin{predefinednode}{parent axis} @@ -1714,7 +1719,7 @@ Axis scaling and clipping will be done as if you did not use |hide axis|. \begin{stylekey}{/pgfplots/colorbar shift} - This style is installed after |every colorbar|. It is intented to contain only shift transformations like |xshift| and/or |yshift|. The reason to provide two separate styles is to allow easier deactivation of shift transformations. + This style is installed after |every colorbar|. It is intended to contain only shift transformations like |xshift| and/or |yshift|. The reason to provide two separate styles is to allow easier deactivation of shift transformations. \begin{codeexample}[code only] \pgfplotsset{ @@ -1817,9 +1822,11 @@ There are a couple of predefined scaling styles which set some of these options: \begin{codeexample}[code only] \pgfplotsset{ small/.style={ - /pgfplots/width=6.5cm, - /pgfplots/height=, - /pgfplots/max space between ticks=25 + width=6.5cm, + height=, + tick label style={font=\footnotesize}, + label style={font=\small}, + max space between ticks=25, } } \end{codeexample} @@ -1848,12 +1855,14 @@ Feel free to redefine the scaling -- the option may still be useful to get more \begin{codeexample}[code only] \pgfplotsset{ footnotesize/.style={ - /pgfplots/width=5cm, - /pgfplots/height=, + width=5cm, + height=, legend style={font=\footnotesize}, tick label style={font=\footnotesize}, label style={font=\small}, - /pgfplots/max space between ticks=20, + title style={font=\small}, + every axis title shift=0pt, + max space between ticks=15, every mark/.append style={mark size=8}, major tick length=0.1cm, minor tick length=0.066cm, @@ -1862,5 +1871,47 @@ Feel free to redefine the scaling -- the option may still be useful to get more \end{codeexample} As for |small|, it can be convenient to set |footnotesize| and set |width| afterwards. -See also the |compat=newest| method which causes the positions of |xlabel|, |ylabel| and |zlabel| to be right near the tick labels. +You will need |compat=1.3| or newer for this to work. +\end{stylekey} + +\begin{stylekey}{/pgfplots/tiny} + Redefines several keys such that the axis is very small. Most descriptions will have |\tiny| as fontsize. + +\begin{codeexample}[] +\begin{tikzpicture} + \begin{axis}[tiny, + title=A ``tiny'' figure, + xlabel=The $x$ axis, + ylabel=The $y$ axis, + minor tick num=1, + legend entries={Leg}] + \addplot+[const plot] + coordinates { + (0,0) (1,1) (3,3) (5,10) + }; + \end{axis} +\end{tikzpicture} +\end{codeexample} + The initial setting is +\begin{codeexample}[code only] +\pgfplotsset{ + tiny/.style={ + width=4cm, + height=, + legend style={font=\tiny}, + tick label style={font=\tiny}, + label style={font=\tiny}, + title style={font=\footnotesize}, + every axis title shift=0pt, + max space between ticks=12, + every mark/.append style={mark size=6}, + major tick length=0.1cm, + minor tick length=0.066cm, + every legend image post/.append style={scale=0.8}, + }, +} +\end{codeexample} +As for |small|, it can be convenient to use |tiny,width=4.5cm| to adjust the width. + +You will need |compat=1.3| or newer for this to work. \end{stylekey} diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.closingplots.tex b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.closingplots.tex index d201284ac15..9f11fc7760a 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.closingplots.tex +++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.closingplots.tex @@ -4,7 +4,7 @@ \begin{command}{\closedcycle} Provide |\closedcycle| as \meta{trailing path commands} after |\addplot| to draw a closed line from the last plot coordinate to the first one. - Use |\closedcycle| whenevery you intend to fill the area under a plot. + Use |\closedcycle| whenever you intend to fill the area under a plot. \begin{codeexample}[] \begin{tikzpicture} @@ -21,7 +21,7 @@ \end{axis} \end{tikzpicture} \end{codeexample} - In case of stacked plots, |\closedcycle| connects the current plot with the previous plot instead of connecting with the $x$~axis\footnote{The implementation for stacked plots requires some additional logic to determine the filled area: \lstinline{\\closedcycle} will produce a \texttt{plot coordinates} command with \emph{reversed} coordinates of the previous plot. This is usually irrelevant for end users, but it assumes that the plot's type is symmetric. Since constant plots are inherently unsymmetric, \lstinline{\\closedcycle} will use \texttt{const plot mark right} as reversed sequence for \texttt{const plot mark left}.}. + In case of stacked plots, |\closedcycle| connects the current plot with the previous plot instead of connecting with the $x$~axis\footnote{The implementation for stacked plots requires some additional logic to determine the filled area: \lstinline{\\closedcycle} will produce a \texttt{plot coordinates} command with \emph{reversed} coordinates of the previous plot. This is usually irrelevant for end users, but it assumes that the plot's type is symmetric. Since constant plots are inherently asymmetric, \lstinline{\\closedcycle} will use \texttt{const plot mark right} as reversed sequence for \texttt{const plot mark left}.}. \begin{codeexample}[] \begin{tikzpicture} \begin{axis}[stack plots=y] diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.gridoptions-axiscoordinates.tex b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.gridoptions-axiscoordinates.tex index aa924828fa8..ff0a73d2dd9 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.gridoptions-axiscoordinates.tex +++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.gridoptions-axiscoordinates.tex @@ -158,7 +158,7 @@ The ``relative axis coordinate system'', |rel axis cs|, uses the complete axis v \noindent where \meta{x}, \meta{y} and \meta{z} are coordinates or constant mathematical expressions. The second syntax is only available in three dimensional axes. - There is one speciality: if you reverse an axis (with |x dir=reverse|), points provided by |rel axis cs| will be \emph{unaffected} by the axis reversal. This is intented to provide consistent placement even for reversed axes. Use |allow reversal of rel axis cs=false| to disable this feature. + There is one speciality: if you reverse an axis (with |x dir=reverse|), points provided by |rel axis cs| will be \emph{unaffected} by the axis reversal. This is intended to provide consistent placement even for reversed axes. Use |allow reversal of rel axis cs=false| to disable this feature. There is also a low--level interface to access the transformations and coordinates, see section~\ref{sec:pgfplots:lowlevel} on page~\pageref{sec:pgfplots:lowlevel}. \end{coordinatesystem} diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.markers-meta.tex b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.markers-meta.tex index 56114469f88..6fcce13a478 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.markers-meta.tex +++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.markers-meta.tex @@ -415,7 +415,7 @@ The |xcolor| package provides even more methods to combine colors, among them th \begin{pgfplotskey}{colormap=\marg{name}\marg{color specification}} Defines a new colormap named \marg{name} according to \marg{color specification} and activates it using |colormap name=|\marg{name}. - The \marg{color specification} is a sequence of positions and associated colors where linear interpolation is applied inbetween. The syntax is very similar as the one used for \PGF\ shadings described in~\cite[VIII -- Shadings]{tikz}: it is a semicolon--separated series of + The \marg{color specification} is a sequence of positions and associated colors where linear interpolation is applied in-between. The syntax is very similar as the one used for \PGF\ shadings described in~\cite[VIII -- Shadings]{tikz}: it is a semicolon--separated series of \meta{color type}|(|\meta{offset}|)=(|\meta{color value}|); |: @@ -554,7 +554,7 @@ Available color maps are shown below. The usage of the result \meta{\textbackslash macro} is a little bit low--level. \end{command} -\subsubsection{Cycle Lists -- Options Controlling Linestyles} +\subsubsection{Cycle Lists -- Options Controlling Line Styles} \label{sec:cycle:list}% \begin{pgfplotskeylist}{cycle list=\marg{list},cycle list name=\marg{\textbackslash macro}} @@ -562,7 +562,7 @@ Allows to specify a list of plot specifications which will be used for each \hbo The list element with index~$i$ will be chosen where~$i$ is the index of the current |\addplot| command. This indexing does also include plot commands which don't use the |cycle list|. -There are several possiblities to change the currently active |cycle list|: +There are several possibilities to change the currently active |cycle list|: \begin{enumerate} \item Use one of the predefined lists\footnote{In an early version, these lists were called \texttt{\textbackslash coloredplotspeclist} and \texttt{\textbackslash blackwhiteplotspeclist} which appeared to be unnecessarily long, so they have been renamed. The old names are still accepted, however.}, \begin{itemize} @@ -875,7 +875,7 @@ In this case, the \emph{last} entry also needs a terminating `|\\|', but one can \end{codeexample} \noindent The provided |cycle multi list| consists of three lists. The style for a single plot is made up using elements of each of the three lists: the first plot has style |red,solid,mark=*|, the second has |red,solid,mark=x|, the third has |red,solid,mark=o|. The fourth plot restarts the third list and uses the next one of list $2$: it has |red,dotted,mark options={solid},mark=*| and so on. - The last list will always be advanced for a new plot. The list before the last (in our case the second list) will be advanced after the last one has been reset. In other words: |cycle multi list| allows a composition of different |cycle list| in a lexicographical way\footnote{For those who prefer formulars: The plot with index $0 \le i < N$ will use cycle list offsets $i_0,i_1,\dotsc,i_k$, $0 \le i_m < N_m$ where $k$ is the number of arguments provided to \texttt{cycle multi list} and $N_m$ is the number of elements in the $m$th cycle list. The offsets $i_m$ are computed in a loop {\ttfamily \{ int tmp=i; for( int m=k-1; m>=0; m=m-1 ) \{ i\_m = tmp\%N\_m; tmp = tmp/N\_m; \}\}}.}. + The last list will always be advanced for a new plot. The list before the last (in our case the second list) will be advanced after the last one has been reset. In other words: |cycle multi list| allows a composition of different |cycle list| in a lexicographical way\footnote{For those who prefer formulas: The plot with index $0 \le i < N$ will use cycle list offsets $i_0,i_1,\dotsc,i_k$, $0 \le i_m < N_m$ where $k$ is the number of arguments provided to \texttt{cycle multi list} and $N_m$ is the number of elements in the $m$th cycle list. The offsets $i_m$ are computed in a loop {\ttfamily \{ int tmp=i; for( int m=k-1; m>=0; m=m-1 ) \{ i\_m = tmp\%N\_m; tmp = tmp/N\_m; \}\}}.}. The argument for |cycle multi list| is a sequence of arguments as they would have been provided for |cycle list|, separated by \declareandlabel{\nextlist}. In addition to providing a new cycle list, the \meta{list $i$} elements can also denote |cycle list name| values (including the special |auto| cycle list which is the most recently assigned |cycle list| or |cycle list name|). The final |\nextlist| is optional. diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.numberformatting.tex b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.numberformatting.tex index 8eec38ea994..fa2e79f6052 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.numberformatting.tex +++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.numberformatting.tex @@ -17,7 +17,7 @@ Please refer to the manual of \PGFPlotstable\ (shipped with this package) for de \begin{pgfplotskey}{log identify minor tick positions=\mchoice{true,false} (initially false)} Set this to |true| if you want to identify log--plot tick labels at positions \[ i \cdot 10^j \] -with $i \in \{2,3,4,5,6,7,8,9\},\, j \in \Z$. This may be valueable in conjunction with the `|extra x ticks|' and `|extra y ticks|' options. +with $i \in \{2,3,4,5,6,7,8,9\},\, j \in \Z$. This may be valuable in conjunction with the `|extra x ticks|' and `|extra y ticks|' options. \begin{codeexample}[] \begin{tikzpicture}% \begin{loglogaxis} diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.preliminaryoptions.tex b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.preliminaryoptions.tex index fe8d58ad432..7dded72cd83 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.preliminaryoptions.tex +++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.preliminaryoptions.tex @@ -10,7 +10,9 @@ \end{axis} \end{tikzpicture} \end{codeexample} -\noindent which changes them for the complete axis. Some keys can be changed for each plot: +\noindent which changes them for the complete axis. A |key| in this context can be any option defined in this manual, no matter if it has the |/pgfplots/| or the |/tikz/| key prefix. Note that key prefixes can be omitted in almost all cases. + +Some keys can be changed individually for each plot: \begin{codeexample}[code only] \begin{tikzpicture} \begin{axis} @@ -20,7 +22,7 @@ \end{tikzpicture} \end{codeexample} -The basic engine to manage key--value pairs is |pgfkeys| which is part of \pgfname. This engine always has a key name and a key ``path'', which is somehow similar to file name and directory of files. The common ``directory'' (key path) of \PGFPlots\ is `|/pgfplots/|'. Although the key definitions below provide this full path, it is always (well, almost always) enough to skipt this prefix -- \PGFPlots\ uses it automatically. The same holds for the prefixes `|/tikz/|' which are common for all \Tikz\ drawing options and `|/pgf/|' which are for the (more or less) low--level commands of \pgfname. All these prefixes can be omitted. +The basic engine to manage key--value pairs is |pgfkeys| which is part of \pgfname. This engine always has a key name and a key ``path'', which is somehow similar to file name and directory of files. The common ``directory'' (key path) of \PGFPlots\ is `|/pgfplots/|'. Although the key definitions below provide this full path, it is always (well, almost always) enough to skip this prefix -- \PGFPlots\ uses it automatically. The same holds for the prefixes `|/tikz/|' which are common for all \Tikz\ drawing options and `|/pgf/|' which are for the (more or less) low--level commands of \pgfname. All these prefixes can be omitted. One important concept is the concept of styles. A style is a key which contains one or more other keys. It can be redefined or modified until it is actually used by the internal routines. Each single component of \Tikz\ and \PGFPlots\ can be configured with styles. @@ -34,7 +36,7 @@ sets the line width for every axis to |1pt|. There are several other styles predefined to modify the appearance, see section~\ref{sec:styles}. \begin{command}{\pgfplotsset\marg{key-value-list}} - Defines or sets all options in \marg{key-value-list}. + Defines or sets all options in \marg{key-value-list}. The \meta{key-value-list} can contain any of the options in this manual which have the prefix |/pgfplots/| (you do not need to type the prefix). It is a shortcut for |\pgfqkeys{/pgfplots}|\marg{key-value-list}, that means it inserts the prefix |/pgfplots| to any option which has no full path. diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.scaling.tex b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.scaling.tex index 8e25d5a7b03..450843801d8 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.scaling.tex +++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.scaling.tex @@ -70,7 +70,7 @@ Here, \marg{dimen} is any \TeX\ size like |1mm|, |2cm| or |5pt|. It is allowed t \end{tikzpicture} \end{codeexample} -The second syntax, |x={(|\meta{x}|,|\meta{y}|)}| sets $e_x = (\meta{x},\meta{y})^T$ explicitly\footnote{Please note that you need extra curly braces around the vector. Otherwise, the comma will be interpreted as separator for the next key-value pair.}; the corresponding |y| key works similiarly. This allows to define skewed or rotated axes. +The second syntax, |x={(|\meta{x}|,|\meta{y}|)}| sets $e_x = (\meta{x},\meta{y})^T$ explicitly\footnote{Please note that you need extra curly braces around the vector. Otherwise, the comma will be interpreted as separator for the next key-value pair.}; the corresponding |y| key works similarly. This allows to define skewed or rotated axes. \begin{codeexample}[] \begin{tikzpicture} diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.specifyrange.tex b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.specifyrange.tex index 5ad417ecedc..6997afc53a1 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.specifyrange.tex +++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.specifyrange.tex @@ -101,7 +101,7 @@ You can set |xmin|, |xmax| and |ymin|, |ymax| to the minimum/maximum values of y \item The value \declaretext{false} uses tight axis limits as specified by the user (or read from input coordinates). \item The value \declaretext{auto} will enlarge limits only for axis for which axis limits have been determined automatically. - For threedimensional figures, the \declaretext{auto} mechanism applies only for the $z$ axis. The $x$ and $y$ axis won't be enlarged. + For three--dimensional figures, the \declaretext{auto} mechanism applies only for the $z$ axis. The $x$ and $y$ axis won't be enlarged. \item The value \declaretext{upper} enlarges only the upper axis limit while \declaretext{lower} enlarges only the lower axis limit. \item Values like `|enlarge x limits=0.1|' will enlarge lower and upper axis limit relatively (in this example, $10\%$ of the axis limits will be added on both sides). \item It is also possible to change just the relative threshold using the \declaretext{value=}\marg{val} key. It can be combined with any of the other possible values. For example, diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.styleoptions.tex b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.styleoptions.tex index 3b37dc32c47..69fe108fac9 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.styleoptions.tex +++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.styleoptions.tex @@ -99,6 +99,11 @@ The initial setting is \begin{codeexample}[code only] \pgfplotsset{every axis title/.style={at={(0.5,1)},above,yshift=6pt}} \end{codeexample} + +To be more precise, the |yshift| doesn't use the hardcoded |6pt|: it uses the value of +\begin{key}{/pgfplots/every axis title shift=\marg{default shift} (initially 6pt)} +\end{key} +which can be reset if needed. \end{stylekey} \pgfplotsshortstylekey title style=every axis title\pgfeov @@ -120,6 +125,12 @@ The initial setting is \pgfplotsshortstylekey legend style=every axis legend\pgfeov +\begin{stylekey}{/pgfplots/every legend image post} + Allows to change the appearance of the small legend images \emph{after} the options of the plot style have been applied. Thus, legend formatting can be changed independently of the plot style using |every legend image post|. + + This key is also documented on page~\pageref{key:legendimagepost}. +\end{stylekey} + \subsubsection*{Styles for axis lines} \begin{xystylekey}{/pgfplots/every outer \x\ axis line (initially empty)} Installed for every axis line which lies on the outer box. @@ -198,7 +209,7 @@ The initial settings are Installed for tick \emph{lines} on either $x$ or $y$ axis. \end{xystylekey} -\pgfplotsshortxystylekey \x\ tick style=every \x\ tick\pgfeov +\pgfplotsshortxystylekey \x tick style=every \x\ tick\pgfeov \begin{xystylekey}{/pgfplots/every minor \x\ tick (initially empty)} Installed for minor tick lines on either $x$ or $y$ axis. diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.tickoptions.tex b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.tickoptions.tex index e08329345da..0cb1556035f 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.tickoptions.tex +++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.reference.tickoptions.tex @@ -13,7 +13,7 @@ The \marg{coordinate list} will be used inside of a |\foreach \x in |\marg{coord \item |{0,2,...,10}| (the same as |{0,2,4,6,8,10}|), \item |{9,...,3.5}| (the same as |{9, 8, 7, 6, 5, 4}|), \item See \cite[Section~34]{tikz} for a more detailed definition of the options. - \item Please be careful with whitespaces inside of \marg{coordinate list} (at least around the dots). + \item Please be careful with white spaces inside of \marg{coordinate list} (at least around the dots). \end{itemize} For logplots, \PGFPlots\ will apply $\log(\cdot)$ to each element in `\marg{coordinate list}'. \begin{codeexample}[] @@ -41,7 +41,7 @@ For logplots, \PGFPlots\ will apply $\log(\cdot)$ to each element in `\marg{coor \vspace*{0.3cm} \noindent -The default choice for tick \emph{positions} in normal plots is to place a tick at each coordinate~$i\cdot h$. The step size~$h$ depends on the axis scaling and the axis limits. It is chosen from a list a ``feasable'' step sizes such that neither too much nor too few ticks will be generated. The default for logplots is to place ticks at positions $10^i$ in the axis' range. The positions depend on the axis scaling and the dimensions of the picture. If log plots contain just one (or two) positions $10^i$ in their limits, ticks will be placed at positions $10^{i\cdot h}$ with ``feasable'' step sizes $h$ as in the case of linear axis. +The default choice for tick \emph{positions} in normal plots is to place a tick at each coordinate~$i\cdot h$. The step size~$h$ depends on the axis scaling and the axis limits. It is chosen from a list a ``feasible'' step sizes such that neither too much nor too few ticks will be generated. The default for logplots is to place ticks at positions $10^i$ in the axis' range. The positions depend on the axis scaling and the dimensions of the picture. If log plots contain just one (or two) positions $10^i$ in their limits, ticks will be placed at positions $10^{i\cdot h}$ with ``feasible'' step sizes $h$ as in the case of linear axis. \noindent The tick \emph{appearance} can be (re-)configured with @@ -271,6 +271,8 @@ coordinates { \end{semilogyaxis} \end{tikzpicture} \end{codeexample} + + Note that it is also possible to terminate list entries with two backslashes, |\\|. In that case, the last entry needs to be terminated by |\\| as well (it is the same alternative syntax which is also accepted for |\legend| and |cycle list|). \end{pgfplotsxykey} @@ -320,30 +322,40 @@ That means you can configure the appearance of linear axis with the number forma \end{codeexample} The following example uses explicitly formatted $x$ tick labels and a small \TeX\ script to format $y$ tick labels in the form \meta{sign}\meta{number}|/10|. +% \usepackage{nicefrac} \begin{codeexample}[width=4cm] +% \usepackage{nicefrace}% required \begin{tikzpicture} \begin{axis}[ - title=A special Prewavelet, + % x ticks explicitly formatted: xtick={0,1,0.5,0.25,0.75}, xticklabels={$0$,$1$,$\frac12$,$\frac14$,$\frac34$}, + % y ticks automatically by some code fragment: ytick=data, - ymajorgrids, yticklabel={% \scriptsize \ifdim\tick pt<0pt % a TeX \if -- see TeX Book \pgfmathparse{-10*\tick}% - $-\pgfmathprintnumber{\pgfmathresult}/10$% + $-\nicefrac{\pgfmathprintnumber{\pgfmathresult}}{10}$% \else - \pgfmathparse{10*\tick}% - $\pgfmathprintnumber{\pgfmathresult}/10$% + \ifdim\tick pt=0pt + \else + \pgfmathparse{10*\tick}% + $\nicefrac{\pgfmathprintnumber{\pgfmathresult}}{10}$% + \fi \fi - } + }, + ymajorgrids, + title=A special Prewavelet, + axis x line=center, + axis y line=left, ] \addplot coordinates {(0,-1.2) (0.25,1.1) (0.5,-0.6) (0.75,0.1) (1,0)}; \end{axis} \end{tikzpicture} \end{codeexample} +\noindent The \TeX\ script takes the |\tick| macro as input and applies some logic. The |\ifdim\tick pt<0pt| means ``if dimension |\tick pt| $ < $ |0pt|''. The |\ifdim| is \TeX's only way to compare real fixed point numbers and the author did not want to invoke |\pgfmath| for this simple task. Since |\ifdim| expects a dimension, we have to use the |pt| suffix which is compatible with |\pgfmath|. The result is that negative numbers, zero and positive numbers are typeset differently. You can change the appearance of tick labels with \begin{codeexample}[code only] diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.resources.tex b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.resources.tex index 194e82d6aa4..87b7a54d236 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.resources.tex +++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.resources.tex @@ -41,7 +41,7 @@ However, for large scale plots with a lot of points, limitations of \TeX's capac \subsection{Memory Limitations} The default settings of most \TeX-distributions are quite restrictive, so it may be necessary to adjust them. -Usually, the log--file or the final error message contains a summary about the used ressources, giving a hint which parameter needs to be increased. +Usually, the log--file or the final error message contains a summary about the used resources, giving a hint which parameter needs to be increased. \subsubsection{Mik\TeX} For Mik\TeX, memory limits can be increased in two ways. The first is to use command line switches: diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.tex b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.tex index 5d1b7fec2a3..4d4364563b1 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/pgfplots.tex +++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplots.tex @@ -80,7 +80,7 @@ This package provides tools to generate plots and labeled axes easily. It draws \item consistency of document and font type and font size, \item direct use of \TeX\ math mode in axis descriptions, \item consistency of data and figures (no third party tool necessary), - \item interdocument consistency using preamble configurations and styles. + \item inter document consistency using preamble configurations and styles. \end{itemize} Although not necessary, separate |.pdf| or |.eps| graphics can be generated using the |external| library developed as part of \Tikz. @@ -112,9 +112,9 @@ This release provides a lot of improvements which can be found in all detail in Use \begin{codeexample}[code only] \usepackage{pgfplots} -\pgfplotsset{compat=newest} +\pgfplotsset{compat=1.3} \end{codeexample} - in your preamble to benefit from the improved spacing\footnote{The |compat=newest| setting is necessary for new features which move axis labels around like reversed axis. However, \PGFPlots\ will still work as it does in earlier versions, your documents will remain the same if you don't set it explicitly.}. + in your preamble to benefit from the improved spacing\footnote{The |compat=1.3| setting is necessary for new features which move axis labels around like reversed axis. However, \PGFPlots\ will still work as it does in earlier versions, your documents will remain the same if you don't set it explicitly.}. Take a look at the next page for the precise definition of |compat|. \item \PGFPlots\ 1.3 now supports reversed axes. It is no longer necessary to use work--arounds with negative units. @@ -122,7 +122,7 @@ This release provides a lot of improvements which can be found in all detail in Take a look at the |x dir=reverse| key. - Existing work--arounds will still function properly. Use |\pgfplotsset{compat=newest}| together with |x dir=reverse| to switch to the new version. + Existing work--arounds will still function properly. Use |\pgfplotsset{compat=1.3}| together with |x dir=reverse| to switch to the new version. \end{enumerate} \subsubsection{Old Features Which May Need Attention} @@ -140,11 +140,11 @@ This release provides a lot of improvements which can be found in all detail in \end{enumerate} I apologize for any inconvenience caused by these changes. -\begin{pgfplotskey}{compat=\mchoice{newest,pre 1.3,default} (initially default)} +\begin{pgfplotskey}{compat=\mchoice{1.3,pre 1.3,default,newest} (initially default)} The preamble configuration \begin{codeexample}[code only] \usepackage{pgfplots} -\pgfplotsset{compat=newest} +\pgfplotsset{compat=1.3} \end{codeexample} allows to choose between backwards compatibility and most recent features. @@ -159,11 +159,11 @@ I apologize for any inconvenience caused by these changes. You are encouraged to use \begin{codeexample}[code only] \usepackage{pgfplots} -\pgfplotsset{compat=newest} +\pgfplotsset{compat=1.3} \end{codeexample} in your preamble. - \item Version 1.3 fixes a bug with |anchor=south west| which occured mainly for reversed axes: the anchors where upside--down. This is fixed now. + \item Version 1.3 fixes a bug with |anchor=south west| which occurred mainly for reversed axes: the anchors where upside--down. This is fixed now. If you have written some work--around and want to keep it going, use @@ -174,10 +174,12 @@ I apologize for any inconvenience caused by these changes. \end{enumerate} Use |\pgfplotsset{compat=default}| to restore the factory settings. + + The setting |\pgfplotsset{compat=newest}| will always use features of the most recent version. This might result in small changes in the document's appearance. \end{pgfplotskey} \subsection{The Team} -\PGFPlots\ has been written mainly by Christian Feuersänger with many improvements of Pascal Wolkotte and Nick Papior Andersen as a spare time project. We hope it is useful and provides valueable plots. +\PGFPlots\ has been written mainly by Christian Feuersänger with many improvements of Pascal Wolkotte and Nick Papior Andersen as a spare time project. We hope it is useful and provides valuable plots. If you are interested in writing something but don't know how, consider reading the auxiliary manual \href{file:TeX-programming-notes.pdf}{TeX-programming-notes.pdf} which comes with \PGFPlots. It is far from complete, but maybe it is a good starting point (at least for more literature). diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplotsexample.pdf b/Master/texmf-dist/doc/latex/pgfplots/pgfplotsexample.pdf Binary files differdeleted file mode 100644 index 9f945031366..00000000000 --- a/Master/texmf-dist/doc/latex/pgfplots/pgfplotsexample.pdf +++ /dev/null diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplotsexample.tex b/Master/texmf-dist/doc/latex/pgfplots/pgfplotsexample.tex index 9ba0240cc42..074e7738125 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/pgfplotsexample.tex +++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplotsexample.tex @@ -3,7 +3,7 @@ % for dvipdfm: %\def\pgfsysdriver{pgfsys-dvipdfm.def} \usepackage{pgfplots} -\pgfplotsset{compat=newest}% <-- moves axis labels near ticklabels (respects tick label widths) +\pgfplotsset{compat=1.3}% <-- moves axis labels near ticklabels (respects tick label widths) \begin{document} \begin{figure} diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplotstable.pdf b/Master/texmf-dist/doc/latex/pgfplots/pgfplotstable.pdf Binary files differindex 44298fdc005..2876de353a3 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/pgfplotstable.pdf +++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplotstable.pdf diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplotstable.tex b/Master/texmf-dist/doc/latex/pgfplots/pgfplotstable.tex index 15d4668102b..c4be25d48f4 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/pgfplotstable.tex +++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplotstable.tex @@ -36,6 +36,8 @@ tabsize=4, } +\pgfkeys{/pgfmanual/gray key prefixes/.add={/pgfplots/table/,/pgf/number format/,}{}} + \makeatletter \pgfkeys{% /codeexample/prettyprint/key name with handler/.code 2 args={% @@ -65,7 +67,10 @@ } \makeatother -%\pgfplotstableset{debug=true} +\pgfplotstableset{ + %debug=true, + begin table=\begin{tabular}[b], +} \title{% Manual for Package \PGFPlotstable\\ @@ -194,16 +199,18 @@ Technical note: every opened file will be protocolled into your log file. \begin{command}{\pgfplotstableread\marg{file name}\marg{\textbackslash macro}} - Loads the table \marg{file name} into a \TeX-macro \meta{\textbackslash macro}. This macro can than be used several times. + Loads the table \marg{file name} into a \TeX-macro \meta{\textbackslash macro}. This macro can then be used several times. \begin{codeexample}[] -\pgfplotstableread{pgfplotstable.example1.dat}\table -\pgfplotstabletypeset[columns={dof,error1}]\table +\pgfplotstableread{pgfplotstable.example1.dat}\loadedtable +\pgfplotstabletypeset[columns={dof,error1}]\loadedtable \hspace{2cm} -\pgfplotstabletypeset[columns={dof,error2}]\table +\pgfplotstabletypeset[columns={dof,error2}]\loadedtable \end{codeexample} There are variants of this command which do not really built up a struct but which report every line to a ``listener''. There is also a struct which avoids protection by \TeX\ scopes. In case you need such things, consider reading the source code comments. Technical note: every opened file will be protocolled into your log file. + + Note: avoid using `|\table|' as name, it conflicts with |\begin{table}| of \LaTeX. \end{command} \begin{key}{/pgfplots/table/col sep=\mchoice{space,tab,comma,semicolon,colon,braces} (initially space)} @@ -677,7 +684,24 @@ The following styles allow to configure the final table code \emph{after any cel \begin{key}{/pgfplots/table/begin table=\marg{code} (initially \textbackslash begin\{tabular\})} Contains \marg{code} which is generated as table start. - Use |begin table/.add={}{[t]}| to append the prefix |[t]|. + The following example uses a |longtable| instead\index{longtable} of |tabular|: +\begin{codeexample}[code only] +\pgfplotstableset{ + begin table=\begin{longtable}, + end table=\end{longtable}, +} +\end{codeexample} + + It is also possible to \emph{change} the value. For example, +\begin{codeexample}[code only] +\pgfplotstableset{ + begin table/.add={}{[t]}, +} +\end{codeexample} + prepends the empty string |{}| and appends the prefix |[t]|. Thus, `|\begin{tabular}|' becomes `|\begin{tabular}[t]|'. +\end{key} +\begin{key}{/pgfplots/table/end table=\marg{code} (initially \textbackslash end\{tabular\})} + Contains \marg{code} which is generated as table end. \end{key} \begin{codekey}{/pgfplots/table/typeset cell} @@ -696,13 +720,10 @@ The following styles allow to configure the final table code \emph{after any cel \paragraph{Attention:} The value of |\pgfplotstablecol| starts with $1$ in this context, i.e.\ it is in the range $1,\dotsc,n$ where $n=$ |\pgfplotstablecols|. This simplifies checks whether we have the last column. \end{codekey} -\begin{key}{/pgfplots/table/end table=\marg{code} (initially \textbackslash end\{tabular\})} - Contains \marg{code} which is generated as table end. -\end{key} - \begin{key}{/pgfplots/table/outfile=\marg{file name} (initially empty)} \label{page:outfile} Writes the generated tabular code into \marg{file name}. It can then be used with |\input|\marg{file name}, \PGFPlotstable\ is no longer required since it contains a completely normal |tabular|. + \pgfplotstableset{begin table=\begin{tabular}} \begin{codeexample}[] \pgfplotstabletypeset[ columns={dof,error1}, @@ -920,8 +941,10 @@ See section~\ref{sec:number:styles} for how to change the exponential display st Sets both, |fixed zerofill| and |sci zerofill| at once. \end{stylekey} -\begin{key}{/pgf/number format/std} -Configures |\pgfmathprintnumber| to a standard algorithm. It chooses either \texttt{fixed} or \texttt{sci}, depending on the order of magnitude. Let $n=s \cdot m \cdot 10^e$ be the input number and $p$ the current precision. If $-p/2 \le e \le 4$, the number is displayed using the fixed format. Otherwise, it is displayed using the scientific format. +\begin{keylist}{/pgf/number format/std,% + /pgf/number format/std=\meta{lower e}, + /pgf/number format/std=\meta{lower e}:\meta{upper e}} +Configures |\pgfmathprintnumber| to a standard algorithm. It chooses either |fixed| or |sci|, depending on the order of magnitude. Let $n=s \cdot m \cdot 10^e$ be the input number and $p$ the current precision. If $-p/2 \le e \le 4$, the number is displayed using |fixed| format. Otherwise, it is displayed using |sci| format. \begin{codeexample}[] \pgfkeys{/pgf/number format/.cd,std,precision=2} @@ -931,7 +954,9 @@ Configures |\pgfmathprintnumber| to a standard algorithm. It chooses either \tex \pgfmathprintnumber{24415.98123}\hspace{1em} \pgfmathprintnumber{123456.12345} \end{codeexample} -\end{key} +The parameters can be customized using the optional integer argument(s): if $\text{\meta{lower e}} \le e \le \text{\meta{upper e}}$, the number is displayed in |fixed| format, otherwise in |sci| format. Note that \meta{lower e} should be negative for useful results. The precision used for scientific format can be adjusted with |sci precision| if necessary. + +\end{keylist} \begin{key}{/pgf/number format/int detect} Configures |\pgfmathprintnumber| to detect integers automatically. If the input number is an integer, no period is displayed at all. If not, the scientific format is chosen. @@ -946,6 +971,18 @@ Configures |\pgfmathprintnumber| to detect integers automatically. If the input \end{codeexample} \end{key} +\begin{command}{\pgfmathifisint\marg{number constant}\marg{true code}\marg{false code}} + A command which does the same check as |int detect|, but it invokes \meta{true code} if the \meta{number constant} actually is an integer and the \meta{false code} if not. + + As a side--effect, |\pgfretval| will contain the parsed number, either in integer format or as parsed floating point number. + + The argument \meta{number constant} will be parsed with |\pgfmathfloatparsenumber|. +\begin{codeexample}[] +15 \pgfmathifisint{15}{is an int: \pgfretval.}{is no int}\hspace{1em} +15.5 \pgfmathifisint{15.5}{is an int: \pgfretval.}{is no int} +\end{codeexample} +\end{command} + \begin{key}{/pgf/number format/int trunc} Truncates every number to integers (discards any digit after the period). @@ -962,6 +999,12 @@ Truncates every number to integers (discards any digit after the period). \begin{key}{/pgf/number format/precision=\marg{number}} Sets the desired rounding precision for any display operation. For scientific format, this affects the mantisse. \end{key} +\begin{key}{/pgf/number format/sci precision=\meta{number or empty} (initially empty)} + Sets the desired rounding precision only for |sci| styles. + + Use |sci precision={}| to restore the initial configuration (which uses the argument provided to |precision| for all number styles). +\end{key} + \subsubsection{Changing Number Format Display Styles}% \label{sec:number:styles}% @@ -1168,6 +1211,29 @@ Typesets the exponent as superscript for any number displayed in scientific form \end{codeexample} \end{key} +\begin{key}{/pgf/number format/sci generic=\marg{keys}} +Allows to define an own number style for the scientific format. Here, \meta{keys} can be one of the following choices (omit the long key prefix): + +\begin{key}{/pgf/number format/sci generic/mantisse sep=\marg{text} (initially empty)} + Provides the separator between a mantisse and the exponent. It might be |\cdot|, for example, +\end{key} +\begin{key}{/pgf/number format/sci generic/exponent=\marg{text} (initially empty)} + Provides text to format the exponent. The actual exponent is available as argument |#1| (see below). +\end{key} + +\begin{codeexample}[] +\pgfkeys{ + /pgf/number format/.cd, + sci, + sci generic={mantisse sep=\times,exponent={10^{#1}}}} +\pgfmathprintnumber{12.345}; +\pgfmathprintnumber{0.00012345} +\end{codeexample} + The \meta{keys} can depend on three parameters, namely on |#1| which is the exponent, |#2| containing the flags entity of the floating point number and |#3| is the (unprocessed and unformatted) mantisse. + + Note that |sci generic| is \emph{not} suitable to modify the appearance of fixed point numbers, nor can it be used to format the mantisse (which is typeset like fixed point numbers). Use |dec sep|, |1000 sep| and |print sign| to customize the mantisse. +\end{key} + \begin{key}{/pgf/number format/@dec sep mark=\marg{text}} Will be placed right before the place where a decimal separator belongs to. However, \marg{text} will be inserted even if there is no decimal separator. It is intented as place-holder for auxiliary routines to find alignment positions. @@ -1186,6 +1252,24 @@ Typesets the exponent as superscript for any number displayed in scientific form The initial setting installs a |\pgfutilensuremath| around each final number to change to math mode if necessary. Use |assume math mode=true| if you know that math mode is active and you don't want |\pgfutilensuremath|. \end{key} +\begin{stylekey}{/pgf/number format/verbatim} + A style which configures the number printer to produce verbatim text output, i.e.\ it doesn't contain \TeX\ macros. +\begin{codeexample}[] +\pgfkeys{ + /pgf/fpu, + /pgf/number format/.cd, + sci, + verbatim} +\pgfmathprintnumber{12.345}; +\pgfmathprintnumber{0.00012345}; +\pgfmathparse{exp(15)} +\pgfmathprintnumber{\pgfmathresult} +\end{codeexample} + The style resets |1000 sep|, |dec sep|, |print sign|, |skip 0.| and sets |assume math mode|. Furthermore, it installs a |sci generic| format for verbatim output of scientific numbers. + + However, it will still respect |precision|, |fixed zerofill|, |sci zerofill| and the overall styles |fixed|, |sci|, |int detect| (and their variants). It might be useful if you intent to write output files. +\end{stylekey} + @@ -1404,7 +1488,7 @@ The preprocessing step allows to change cell contents \emph{before} any typesett \end{stylekey} \begin{codekey}{/pgfplots/table/row predicate} - A boolean predicate which allows to select particular rows of the input table. The argument |#1| contains the current row's index (starting with~$0$, not counting comment lines or column names). + A boolean predicate which allows to select particular rows of the input table, based on the current row's index. The argument |#1| contains the current row's index (starting with~$0$, not counting comment lines or column names). The return value is assigned to the \TeX-if \declareandlabel{\ifpgfplotstableuserow}. If the boolean is not changed, the return value is true. \begin{codeexample}[narrow] @@ -1423,7 +1507,7 @@ The preprocessing step allows to change cell contents \emph{before} any typesett ] {pgfplotstable.example1.dat} \end{codeexample} - Please note that |row predicate| is applied \emph{before} any other option which affects row appearance. It is evaluated before |assign cell content|. For example, the even/odd row styles refer to those rows for which the predicate returns |true|. In fact, you can use |row predicate| to truncate the complete table before it as actually processed. + Please note that |row predicate| is applied \emph{before} any other option which affects row (or column) appearance. It is evaluated before |assign cell content|. One of the consequences ist that even/odd row styles refer to those rows for which the predicate returns |true|. In fact, you can use |row predicate| to truncate the complete table before it has actually been processed. During |row predicate|, the macro |\pgfplotstablerows| contains the total number of \emph{input} rows. @@ -1456,14 +1540,14 @@ The preprocessing step allows to change cell contents \emph{before} any typesett every head row/.style={before row=\toprule,after row=\midrule}, every last row/.style={after row=\bottomrule}} -\pgfplotstabletypeset[string type]{pgfplotstable.example2.dat} - +\pgfplotstabletypeset[string type]{pgfplotstable.example2.dat}% +~ \pgfplotstabletypeset[ - display columns/0/.style={select equal part entry of={0}{2},string type}, - display columns/1/.style={select equal part entry of={0}{2},string type}, - display columns/2/.style={select equal part entry of={1}{2},string type}, - display columns/3/.style={select equal part entry of={1}{2},string type}, - columns={A,B,A,B} + columns={A,B,A,B}, + display columns/0/.style={select equal part entry of={0}{2},string type},% first part of `A' + display columns/1/.style={select equal part entry of={0}{2},string type},% first part of `B' + display columns/2/.style={select equal part entry of={1}{2},string type},% second part of `A' + display columns/3/.style={select equal part entry of={1}{2},string type},% second part of `B' ] {pgfplotstable.example2.dat} \end{codeexample} @@ -1473,7 +1557,7 @@ The preprocessing step allows to change cell contents \emph{before} any typesett \end{stylekey} \begin{stylekey}{/pgfplots/table/unique=\marg{column name}} - A style which appends an |row predicate| which suppresses successive occurances of the same elements in \marg{column name}. + A style which appends a |row predicate| which suppresses successive occurances of the same elements in \marg{column name}. For example, if \marg{column name} contains |1,1,3,5,5,6,5,0|, the application of |unique| results in |1,3,5,6,5,0| (the last |5| is kept -- it is not directly preceeded by another |5|). The algorithm uses string token comparison to find multiple occurances\footnote{To be more precise, the comparison is done using \texttt{\textbackslash ifx}, i.e. cell contents won't be expanded. Only the tokens as they are seen in the input table will be used.}. @@ -1610,7 +1694,7 @@ It is possible to create new tables from scratch or to change tables after they Furthermore, there must be |create on use| statements (see the next subsection) for every column which shall be generated\footnote{Currently, you need to provide at least one column: the implementation gets confused for completely empty tables. If you do not provide any column name, a dummy column will be created.}. Columns are generated - independently, in the order of appearance in |columns|. + independently, in the order of appearance in |columns|. As soon as a column is complete, it can be accessed using any of the basic level access mechanisms. Thus, you can built columns which depend on each other. The table will contain exactly \marg{row count} rows. If \marg{row count} is an |\pgfplotstablegetrowsof| statement, that statement will be executed and the resulting number of rows be used. Otherwise, \marg{row count} will be evaluated as number. \begin{codeexample}[] @@ -1619,9 +1703,9 @@ It is possible to create new tables from scratch or to change tables after they % define how the 'new' column shall be filled: create on use/new/.style={create col/set list={4,5,6,7,...,10}}} % create a new table with 11 rows and column 'new': -\pgfplotstablenew[columns={new}]{11}\table +\pgfplotstablenew[columns={new}]{11}\loadedtable % show it: -\pgfplotstabletypeset[empty cells with={---}]\table +\pgfplotstabletypeset[empty cells with={---}]\loadedtable \end{codeexample} \begin{codeexample}[] @@ -1631,9 +1715,9 @@ It is possible to create new tables from scratch or to change tables after they create on use/new/.style={create col/expr={factorial(15+\pgfplotstablerow)}}, columns={new}] {11} - \table + \loadedtable % show it: -\pgfplotstabletypeset\table +\pgfplotstabletypeset\loadedtable \end{codeexample} \end{commandlist} @@ -1718,7 +1802,7 @@ The \marg{col name} is expected to be a \emph{physical} column name, no alias or The following example takes our well-known input table and creates a copy of the |level| column. Furthermore, it produces a lot of output to show the available macros. Finally, it uses |\pgfkeyslet| to assign the contents of the resulting |\entry| to |next content|. \begin{codeexample}[] -\pgfplotstableread{pgfplotstable.example1.dat}\table +\pgfplotstableread{pgfplotstable.example1.dat}\loadedtable \pgfplotstablecreatecol[ create col/assign/.code={% \getthisrow{level}\entry @@ -1727,13 +1811,13 @@ The following example takes our well-known input table and creates a copy of the (\#\pgfplotstablerow/\pgfplotstablerows)}% \pgfkeyslet{/pgfplots/table/create col/next content}\entry }] - {new}\table + {new}\loadedtable \pgfplotstabletypeset[ column type=l, columns={level,new}, columns/new/.style={string type} -]\table +]\loadedtable \end{codeexample} There is one more speciality: you can use |columns=|\marg{column list} to reduce the runtime complexity of this command. This works only if the |columns| key is provided directly into \marg{options}. In this case |\thisrow| and its variants are only defined for those columns listed in the |columns| value. @@ -2012,10 +2096,10 @@ The example creates two columns: the |new| column is just the sum of each value }, columns={cut}] {2} - \table + \loadedtable % Show the data: -\pgfplotstabletypeset{\table} +\pgfplotstabletypeset{\loadedtable} \begin{tikzpicture} \begin{loglogaxis} @@ -2049,9 +2133,9 @@ The example creates two columns: the |new| column is just the sum of each value }, columns={cut}] {2} - \table + \loadedtable % Show the data: -\pgfplotstabletypeset{\table} +\pgfplotstabletypeset{\loadedtable} \end{codeexample} \PGFPlotstable\ will call |\foreach |\meta{\textbackslash foreach loop head} and it will expand \marg{file name pattern} for every iteration. For every iteration, a simpler list entry of the form @@ -2123,7 +2207,8 @@ Empty cells will be filled with |{}| if |col sep=space|. Use the |empty cells wi \item |every table|, \item |every even row|, |every odd row|, |every even column|, |every odd column|, \item |every first column|, |every last column|, |every first row|, |every last row|, - \item |every head row|. + \item |every head row|, + \item |postproc cell content|, |preproc cell content|. \end{itemize} In case you want to reset all, you should also consider the key |disable rowcol styles|. \end{key} @@ -2191,8 +2276,8 @@ Tables are always stored as a sequence of column vectors. Therefore, iteration o Iterates over every column name of \meta{table}. The \meta{\textbackslash macro} will be set to the currently visited column name. Then, \marg{code} will be executed. During \marg{code}, |\pgfplotstablecol| denotes the current column index (starting with 0). \begin{codeexample}[] \begin{minipage}{0.8\linewidth} -\pgfplotstableread{pgfplotstable.example1.dat}\table -\pgfplotstableforeachcolumn\table\as\col{% +\pgfplotstableread{pgfplotstable.example1.dat}\loadedtable +\pgfplotstableforeachcolumn\loadedtable\as\col{% column name is `\col'; index is\pgfplotstablecol;\par } \end{minipage} @@ -2207,8 +2292,8 @@ Tables are always stored as a sequence of column vectors. Therefore, iteration o For every cell in the column named \meta{column name}, \marg{code} will be executed. During this invocation, the macro \meta{\textbackslash cellcontent} will contain the cell's content and |\pgfplotstablerow| will contain the current row's index. \begin{codeexample}[] \begin{minipage}{0.8\linewidth} -\pgfplotstableread{pgfplotstable.example1.dat}\table -\pgfplotstableforeachcolumnelement{error1}\of\table\as\cell{% +\pgfplotstableread{pgfplotstable.example1.dat}\loadedtable +\pgfplotstableforeachcolumnelement{error1}\of\loadedtable\as\cell{% I have now cell element `\cell' at row index `\pgfplotstablerow';\par } \end{minipage} @@ -2223,11 +2308,11 @@ Tables are always stored as a sequence of column vectors. Therefore, iteration o but any changes of \meta{\textbackslash cellcontent} which might occur during \marg{code} will be written back into the respective cell. \begin{codeexample}[] -\pgfplotstableread{pgfplotstable.example1.dat}\table -\pgfplotstablemodifyeachcolumnelement{error1}\of\table\as\cell{% +\pgfplotstableread{pgfplotstable.example1.dat}\loadedtable +\pgfplotstablemodifyeachcolumnelement{error1}\of\loadedtable\as\cell{% \edef\cell{\#\pgfplotstablerow: \cell}% } -\pgfplotstabletypeset[columns=error1,string type]{\table} +\pgfplotstabletypeset[columns=error1,string type]{\loadedtable} \end{codeexample} If \marg{column name} is a column alias or has been created on-the-fly, a new column named \meta{column name} will be created. @@ -2238,11 +2323,11 @@ Tables are always stored as a sequence of column vectors. Therefore, iteration o The return value will be written to |\pgfplotsretval|. \begin{codeexample}[] -\pgfplotstableread{pgfplotstable.example1.dat}{\table} -\pgfplotstablegetelem{4}{error1}\of{\table} +\pgfplotstableread{pgfplotstable.example1.dat}{\loadedtable} +\pgfplotstablegetelem{4}{error1}\of{\loadedtable} The value (4,error1) is `\pgfplotsretval'. -\pgfplotstablegetelem{2}{[index]0}\of{\table} +\pgfplotstablegetelem{2}{[index]0}\of{\loadedtable} The value (2,0) is `\pgfplotsretval'. \end{codeexample} @@ -2250,7 +2335,7 @@ The value (2,0) is `\pgfplotsretval'. \end{command} \begin{command}{\pgfplotstablegetrowsof\marg{file name or \textbackslash loadedtable}} - Defines |\pgfmathresult| to be the number of rows in a table. The argument may be either a file name or an already loaded table (the \meta{\textbackslash macro} of |\pgfplotstableread|). + Defines |\pgfplotsretval| to be the number of rows in a table\footnote{It will also assign \texttt{\textbackslash pgfmathresult} to the same value.}. The argument may be either a file name or an already loaded table (the \meta{\textbackslash macro} of |\pgfplotstableread|). \end{command} @@ -2277,8 +2362,8 @@ The value (2,0) is `\pgfplotsretval'. \end{codeexample} \begin{codeexample}[] -\pgfplotstabletranspose\table{pgfplotstable.example3.dat} -\pgfplotstabletypeset[string type]\table +\pgfplotstabletranspose\loadedtable{pgfplotstable.example3.dat} +\pgfplotstabletypeset[string type]\loadedtable \end{codeexample} The optional argument \meta{options} can contain options which influence the transposition: @@ -2289,8 +2374,8 @@ The value (2,0) is `\pgfplotsretval'. If \marg{colname} is not empty, it denotes an input column name whose cell values will make up the output column names: \begin{codeexample}[] -\pgfplotstabletranspose[colnames from=c]\table{pgfplotstable.example3.dat} -\pgfplotstabletypeset[string type]\table +\pgfplotstabletranspose[colnames from=c]\loadedtable{pgfplotstable.example3.dat} +\pgfplotstabletypeset[string type]\loadedtable \end{codeexample} The argument \meta{colname} won't appear as cell contents. It is an error if the the cells in \meta{colname} don't yield unique column names. \end{pgfplotskey} @@ -2300,13 +2385,13 @@ The value (2,0) is `\pgfplotsretval'. Will create a further column named \meta{name} which will be filled with the input column names (as string type). \begin{codeexample}[] -\pgfplotstabletranspose[input colnames to=Input]\table{pgfplotstable.example3.dat} -\pgfplotstabletypeset[string type]\table +\pgfplotstabletranspose[input colnames to=Input]\loadedtable{pgfplotstable.example3.dat} +\pgfplotstabletypeset[string type]\loadedtable \end{codeexample} Set \meta{name} to the empty string to disable this column. \begin{codeexample}[] -\pgfplotstabletranspose[input colnames to=]\table{pgfplotstable.example3.dat} -\pgfplotstabletypeset[string type]\table +\pgfplotstabletranspose[input colnames to=]\loadedtable{pgfplotstable.example3.dat} +\pgfplotstabletypeset[string type]\loadedtable \end{codeexample} \end{pgfplotskey} @@ -2317,8 +2402,8 @@ The value (2,0) is `\pgfplotsretval'. If \meta{list} is not empty, it is expected to be a list of column names. Only these columns will be used as input for the transposition, just as if the remaining one weren't there. It is acceptable to provide column aliases or |create on use| arguments inside of \meta{list}. \begin{codeexample}[] -\pgfplotstabletranspose[columns={a,b}]\table{pgfplotstable.example3.dat} -\pgfplotstabletypeset[string type]\table +\pgfplotstabletranspose[columns={a,b}]\loadedtable{pgfplotstable.example3.dat} +\pgfplotstabletypeset[string type]\loadedtable \end{codeexample} Here is the only difference between |\pgfplotstabletranspose| and |\pgfplotstabletranspose*|: the version without `|*|' \emph{resets} the |columns| key before it starts whereas the version with `|*|' simply uses the actual content of |columns|. diff --git a/Master/texmf-dist/doc/latex/pgfplots/todo.txt b/Master/texmf-dist/doc/latex/pgfplots/todo.txt index 780eb01a8a0..baca906ec89 100644 --- a/Master/texmf-dist/doc/latex/pgfplots/todo.txt +++ b/Master/texmf-dist/doc/latex/pgfplots/todo.txt @@ -10,8 +10,9 @@ Testing last test verifications: pgf CVS pgf 2.00 pgf 2.00+compat=default -pgfplotstests 2009-12-30 2009-12-30 2009-12-30 -manual 2009-12-29 2009-12-30 +pgfplotstests for 1.3.1 for 1.3.1 2009-12-30 +manual for 1.3.1 for 1.3.1 +pgfplotstable.pdf for 1.3.1 for 1.3.1 example latex for 1.3 2009-12-30 example context for 1.3 2009-12-30 example plain tex for 1.3 2009-12-30 @@ -33,6 +34,30 @@ The test suite needs to be developed! + test those tickpos num keys! especially in combination with axis line variations. Also test ticklabel pos +--------------- +pgfplots 1.3.1: +--------------- ++ tests (see above) ++ spell checker ++ the ChangeLog is a mess. The automerger failed. + I will need to restore it manually... it mixed stable and master versions. ++ critical: external lib and its backw. compat layer + perhaps I should disable them completely for the stable version? + There are no branches, either fully CVS or not at all. +- import docs for recent number printing styles ++ set version number ++ set release dates for pgfplots.sty and pgfplotstable.sty ++ update ChangeLog to reflect the release and tag git +- update ubuntu PPA +- upload sourceforge images +- release makefile +- CTAN: communicate sourceforge link +- make short, summarized changelog: + - improved parametric plots with gnuplot + - improved normalsize, small and footnotesize scale styles and added tiny + - fixed a lot of bugs + + ------------------------------------------------------------- USER INTERFACE DECISIONS ------------------------------------------------------------- @@ -47,6 +72,12 @@ MISC + disable pgfplots CVS? - documentation todo: + - pgfplots.sty: try to insert the SHA hash of the commit (for non-stable + versions) + - pgfplotstable: the '[b]' option is mysterious in output listings. Hide it + there! + - pgfplotstable: show how to use '\begin{longtable}' + + gnuplot + parametric is not documented. + table + error bar expr + document examples for 3d LINE plots. + the 'tick label anchor' is something which I do not understand myselfes. @@ -75,7 +106,7 @@ MISC + the legend feature for mesh/surf plots: 'every mesh legend' style and the default 'legend image code' + document how to make line plots in 3d - - perhaps: display KNOWN key paths in key definitions in gray, not in red? + + perhaps: display KNOWN key paths in key definitions in gray, not in red? + check if area cycle list is documented + nodes near coords + the 'cube' mark and its parameters 'cube/size [xyz]' @@ -168,7 +199,11 @@ MISC ------------------------------------------------------------- PGF / TikZ Development: ------------------------------------------------------------- - - external lib: 'list and make' does not work together with \include (aux files!) or other file writing things -- at least not if one tries to do that in parallel. + - provide '\times' or more general formatting rules to number printer + + external lib: implement \tikzpicturedependsonfile#1 + + in pgfplots: invoke \tikzpicturedependsonfile. + perhaps the plot-from-table-struct should also use it. + + external lib: 'list and make' does not work together with \include (aux files!) or other file writing things -- at least not if one tries to do that in parallel. + consider the "plot function" patch from Andy Schlaikjer + it seems fadings don't work correctly with externalization!? - include addition of Christophe Jorssen for MD5 checksums in external lib @@ -198,6 +233,48 @@ PGF / TikZ Development: BUGS / FIXES ------------------------------------------------------------- ++ the \pgfplots@ifgridlines@onorientedsurf@should@be@drawn#1#2 is WRONG. + It works ONLY for boxed axes. All others need special handling... + +- table package: + using a non-trivial 'every table' style combined with + \pgfplotstabletypeset[begin table/.add={}{}] + yields a bug: the .add is invoked twice (since the 'every table' stuff is + invoked twice). + + +- yticklabels={<list>}, extra y ticks={...} is incompatible since the extra + ticks share the same tick typesetting routine (which, in turn, queries the + <list>). + +- '\addplot[only marks]' does not assign a plot mark; one needs 'mark=*' + explicitly. that's confusing... + +- The 'text depth' in legend entries is incompatible with 'text width'. + The problem: text width is realized using \begin{minipage}[t] + so its contents is all in the depth. Setting text depths overrides the + height! + +- the '/pgfplots/table/.search also' is overwritten during \addplot table with + /.search also={/pgfplots}. That's not so good. + +- one can't provide 'disable log filter' to \addplot (but it might be + interesting) + +- FPU: atan doesn't check for unbounded inputs. + +- unbounded inputs: improve warning messages: they should not contain low level + FPU args. + +- in tick label reference: the example with \nicefrac has ymajorgrids, but + doesn't display them! Check! +>>>>>>> origin/stable:doc/latex/pgfplots/todo.txt + +- parametric gnuplot plots do not work correctly (see mail of Gabriel Lera) + +- the user interface to set 'tickwidth=0' for a SINGLE axis is not very good: it seems one needs 'xtick style={/pgfplots/tickwidth=0}' to do so... + + + the tick pos stuff works (puh!) However, there is an inconsistency with the axis lines stuff: 'axis lines=left,tick pos=right' @@ -1096,6 +1173,12 @@ X verschiebung des ylabels ist komisch, wegen der rotate option FEATURES ------------------------------------------------------------- +- external lib + makefile support: provide data files automatically as prereqs + +- pgfplotstable file open protocol: provide public listener interface + +- allow to advance cycle list(s) manually + - \addplot coordinates {\macro}; - precise width calculation idea: |