summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/pgfplots/pgfplotstodo.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/pgfplots/pgfplotstodo.tex')
-rw-r--r--Master/texmf-dist/doc/latex/pgfplots/pgfplotstodo.tex323
1 files changed, 281 insertions, 42 deletions
diff --git a/Master/texmf-dist/doc/latex/pgfplots/pgfplotstodo.tex b/Master/texmf-dist/doc/latex/pgfplots/pgfplotstodo.tex
index 69467841566..cf93843552b 100644
--- a/Master/texmf-dist/doc/latex/pgfplots/pgfplotstodo.tex
+++ b/Master/texmf-dist/doc/latex/pgfplots/pgfplotstodo.tex
@@ -34,13 +34,13 @@ last test verifications:
\begin{tabular}{lllll}
& pgf CVS & pgf 2.10 & pgf 2.00 &pgf 2.00+compat=default\\
-pgfplotstests & for 1.5 & for 1.5 & for 1.4 &2009-12-30 \\
-manual & for 1.5 & for 1.5 & for 1.5 & \\
-pgfplotstable.pdf & for 1.5 & for 1.5 & for 1.5\\
+pgfplotstests & for 1.5.1 & for 1.5.1 & for 1.4 &2009-12-30 \\
+manual & for 1.5.1 & for 1.5.1 & for 1.5 & \\
+pgfplotstable.pdf & for 1.5.1 & for 1.5.1 & for 1.5\\
example latex & for 1.5 & for 1.5 & 2009-12-30 \\
-example context & for 1.5 & for 1.5 & 2009-12-30 \\
-example plain tex & for 1.5 & for 1.5 & 2009-12-30 \\
-tests context & for 1.4 &\\
+example context & for 1.5.1 & for 1.5.1 & 2009-12-30 \\
+example plain tex & for 1.5.1 & for 1.5.1 & 2009-12-30 \\
+tests context & for 1.4 & for 1.5.1\\
\end{tabular}
\section{Future work}
@@ -122,6 +122,63 @@ tests context & for 1.4 &\\
\section{Documentation todo}
\begin{bugtracker}
+\begin{doctodo}[+]
+ document that \verb|axis lines=none| is essentially an alias for \verb|hide axis| .
+\end{doctodo}
+
+\begin{doctodo}[+]
+ Document how to use decorations inside of plots
+\begin{verbatim}
+ \begin{tikzpicture}[]
+
+ \begin{axis}[axis lines=middle,
+ xmin=-2,
+ xmax=2,
+ ymin=-2,
+ ymax=2,
+ xtick={-1,1},
+ ytick={-1,1},
+ yticklabel=\ ,% this disables the standard tick label *text* (but not the line)
+ extra description/.code={
+ % this generates custom y labels to implement individual
+ % styles for every tick:
+ \node[below left] at (axis cs:0,-1) {$-1$};
+ \node[above left] at (axis cs:0,1) {$1$};
+ },
+ axis line style={->},
+ ]%,x=1cm,y=1cm]
+ \addplot[samples=100,domain=0:2*pi,
+ % tedious, but necessary: pgfplots accidentally resets the
+ % "decorate" option at the beginning of the path (probably a
+ % bug).
+ % This is a work-around:
+ every path/.style={
+ postaction={decorate},
+ every path/.style={},
+ },
+ decoration={markings,
+ mark=at position 0.25 with {\arrow{>}},
+ mark=at position 0.5 with {\arrow{>}},
+ mark=at position 0.75 with {\arrow{>}}}
+ ]
+ ({sin(deg(2*x))}, {sin(deg(x))});
+ \end{axis}
+ \end{tikzpicture}
+\end{verbatim}
+
+\end{doctodo}
+
+
+\begin{doctodo}
+ document some FAQ for number formatting options.
+
+ This should contain how to get non-exponential number printing for log axes
+\end{doctodo}
+
+\begin{doctodo}[+]
+ \verb|\pgfplotspointplotattime| .
+\end{doctodo}
+
\begin{doctodo}
bei dem Bsp-Tex zu pgfplotstable scheint eine Zeile im Tex-File zu fehlen:
\verb|\usepackage{pgfplotstable}|
@@ -197,7 +254,7 @@ document the possibiliy of skewed 3d axes by means of manually provided unit vec
\end{verbatim}
\end{doctodo}
-\begin{doctodo}[open]
+\begin{doctodo}[+]
mention \verb|xtick=data| in docs for \verb|symbolic x coords|
\end{doctodo}
@@ -772,6 +829,131 @@ Thanks!
\section{Bugs in PGFPlots}
\begin{bugtracker}
+\begin{bug}
+ Using \verb|hide axis| or \verb|axis lines=none| causes the axis to vanish -- but it will still consume space in the bounding box!
+
+ A work-around for the user who reported the bug was to use \verb|clip=false|:
+
+\begin{minimal}
+\documentclass{article}
+\usepackage[utf8]{inputenc}
+\usepackage{pgfplots}
+\pgfplotsset{compat=1.4}
+\begin{document}
+
+\begin{figure}
+ \centering
+ \fbox{%
+ \begin{tikzpicture}
+ \begin{axis}[axis equal,scale=2,axis lines=none,clip=false]
+ \addplot3[surf,samples=9,domain=-1:1,y domain=0:2*pi,z buffer=sort,opacity=0.75]
+ ({cos(deg(y)) * (1 + x/2 * cos(deg(y)/2))},
+ {sin(deg(y)) * (1 + x/2 * cos(deg(y)/2))},
+ {x/2 * sin(deg(y)/2)});
+ \end{axis}
+ \end{tikzpicture}}
+ \caption{M"obiusband}
+\end{figure}
+
+\end{document}
+\end{minimal}
+
+ Interestingly, this does NOT work for 1d plots... here is what I found out today:
+ \begin{itemize}
+ \item excluding the clip path helps for the example above.
+ \item it has no effect for 1d plots (2d axis)
+ \item excluding the background path instruction from the low level node causes the bounding box to be empty -- for both 2d and 3d
+ \end{itemize}
+
+ See \verb|unittest_hideaxis*|.
+
+\end{bug}
+
+\begin{bug}[+]
+ Adding a decoration to a plot requires \verb|every path/.style={decorate,every path/.style={}}| because pgfplots sets its options inside of a \verb|\scope[<options>]|.
+
+ This should be fixed.
+\end{bug}
+
+\begin{bug}
+ disable tick scale label if the ticks have been disabled.
+
+ \verb|https://sourceforge.net/tracker/index.php?func=detail&aid=3457210&group_id=224188&atid=1060656|
+\end{bug}
+
+\begin{bug}
+ nodes near coords is broken for layer branch
+\end{bug}
+
+\begin{bug}[closed]
+ \verb|axis equal,view={0}{90}| for a 3d axis leads to compilation errors (although it seems to work)
+\end{bug}
+
+\begin{bug}
+ xbar and nodes near coords does not automatically align the nodes, see \verb|http://tex.stackexchange.com/questions/31701/pgfplots-nodes-near-coords-on-xbar-chart-is-off|
+\end{bug}
+
+\begin{bug}
+ view direction is imprecise. It seems as if the $z$ direction is wrong.
+
+ See the recent commits on branch \verb|mesh_bg_colormap|
+\end{bug}
+
+\begin{bug}
+ cannot provide clip path usage in pgfplots commands because of the nested scopes.
+
+ to reproduce, try to give \verb|\addplot+[/tikz/clip]| to some plot.
+\end{bug}
+
+\begin{bug}
+ 3d: automatic label placement for 'axis lines=center' is buggy
+\end{bug}
+
+\begin{bug}
+ \verb|\pgfplotsforeachungrouped| cannot be combined with three or more arguments like \verb|\foreach|
+\end{bug}
+
+\begin{bug}
+ If one specifies \verb|\scope| within an axis, the plots (partially) use their variables, but legends do not.
+\begin{minimal}
+\documentclass{article}
+ \usepackage{pgfplots}
+ \pgfplotsset{
+ compat=newest,
+ }
+\begin{document}
+ \begin{tikzpicture}
+ \begin{axis}[
+% reverse legend, % uncomment and one entry is missing
+ legend pos=north west,
+ ]
+ \begin{scope}[only marks]
+ \addplot
+ coordinates { (0,0) (1,1) } node [right] {a};
+ \addplot
+% [green] % uncomment and legend does exactly the wrong thing
+ coordinates { (0,1) (1,2) } node [right] {b};
+ \end{scope}
+ \begin{scope}[mark=none]
+ \addplot
+ coordinates { (0,0.5) (1,1.5) } node [right] {c};
+ \addplot
+% [orange] % uncomment and it works
+ % (I think this is luck, because it does the same
+ % thing as the [green] example above)
+ coordinates { (0,1.5) (1,2.5) } node [right] {d};
+ \end{scope}
+ \legend{
+ a,
+ b,
+ c,
+ d,
+ }
+ \end{axis}
+ \end{tikzpicture}
+\end{document}
+\end{minimal}
+\end{bug}
\begin{bug}
the below example of a latex file gives the following error upon the 2nd run of latex. The first run works fine. This happens both when running dvilualatex and just latex, both from TexLive 2011.
@@ -834,7 +1016,7 @@ l.30 \ref{govconsumptionlegend}
the table package does not support non-ASCII column names. If there are non-ASCII column names, it might fail to produce a readable error message.
\end{bug}
-\begin{bug}
+\begin{bug}[prio=2]
\#3213889 hyperref boxes are in wrong position for vertical labels
see \url{http://tex.stackexchange.com/questions/13364/how-to-make-pgfplots-vertical-labels-have-proper-hyperref-erence-box
@@ -842,7 +1024,7 @@ l.30 \ref{govconsumptionlegend}
\end{bug}
-\begin{bug}
+\begin{bug}[prio=1]
CRASH:
\begin{minimal}
\begin{tikzpicture}
@@ -863,7 +1045,7 @@ CRASH:
\end{minimal}
\end{bug}
-\begin{bug}
+\begin{bug}[prio=1]
Using $0$ in pgfplots coordinate systems does not necessarily mean ``no offset''. This is misleading. Bug sourceforge \#3168030:
\begin{minimal}
\documentclass[a4paper]{article}
@@ -907,7 +1089,9 @@ CRASH:
\end{minimal}
\end{bug}
-\begin{bug}
+
+
+\begin{bug}[prio=2]
The clipping of tick lines uses the middle of axis lines; it does not incorporate the line width of the axis lines.
\begin{minimal}
\documentclass{article}
@@ -935,7 +1119,7 @@ CRASH:
\end{minimal}
\end{bug}
-\begin{bug}
+\begin{bug}[prio=2]
can someone confirm the following behavior. The y label of a plot gets
truncated in some circumstances if the external library is used. This
happens for me if no title is specified for a plot. Consider the
@@ -961,8 +1145,10 @@ following example:
\end{minimal}
\end{bug}
-\begin{bug}
- Decorations in plots appear to be problematic:
+
+
+\begin{bug}[prio=8,+]
+ Decorations in plots appear to be problematic (this is a duplicate! caused by the fact that decorate=false is used at the beginning of every plot, need to adjust every path style):
\begin{minimal}
\documentclass{scrartcl}
@@ -981,12 +1167,31 @@ following example:
\draw [postaction={draw, decorate, decoration=border}] (0,-3cm) -- ++(5cm,0.5cm); %funktioniert
\end{tikzpicture}
+
+\begin{tikzpicture}
+
+\begin{axis}
+
+\addplot+[postaction={draw, decorate, decoration=border},
+ % tedious, but necessary: pgfplots accidentally resets the
+ % "decorate" option at the beginning of the path (probably a
+ % bug).
+ % This is a work-around:
+ every path/.style={
+ postaction={decorate},
+ every path/.style={},
+ },
+ ] coordinates {(0,0) (5,0.5)}; %funktioniert nicht
+
+\end{axis}
+
+\end{tikzpicture}
\end{document}
\end{minimal}
\end{bug}
-\begin{bug}
+\begin{bug}[prio=10,closed]
Markers in legends are not (always?) filled properly
\begin{minimal}
\documentclass{article}
@@ -1002,13 +1207,14 @@ following example:
\end{tikzpicture}
\end{document}
\end{minimal}
+ caused by the fact that options of `every axis legend' are in effect at this time -- which includes \verb|fill=white|.
\end{bug}
-\begin{bug}
+\begin{bug}[prio=11,closed]
polar lib: the clipping of markers doesn't work correctly for partial polar axes.
\end{bug}
-\begin{bug}
+\begin{bug}[prio=1]
The legend has the \verb|text depth=0.15em| initial configuration, which is extremely bad for legend entries with huge depth (large fractionals or formulas?)
\end{bug}
@@ -1090,11 +1296,11 @@ see also \url{https://sourceforge.net/tracker/?func=detail&atid=1060656&aid=3033
fails and resorts to guesses!
\end{bug}
-\begin{bug}
+\begin{bug}[prio=3]
\verb|\addplot table[blue]| ignores the color options!
\end{bug}
-\begin{bug}
+\begin{bug}[prio=10]
providing \verb|ymin=0| for a logarithmic axes has no effect; and there is no sanity checking
\end{bug}
@@ -1157,10 +1363,14 @@ Missing character: There is no k in font nullfont!
anywhere in the code -- the \verb|\def| introduces special checks for the \verb|#| whereas the \verb|\toks| does not.
\end{bug}
-\begin{bug}[prio=2]
+\begin{bug}[prio=7,+]
It is not possible to use \verb|\addplot ... node[pos=0.5] {a};| in pgfplots.
Reason: the timer information is tikz high level, but pgfplots uses the PGF basic layer.
+
+ DONE.
+
+ Open: the \verb|\pgfplotspointplotattime| should provide more useful output: SCI notation and it should respect custom trafos
\end{bug}
@@ -1191,11 +1401,11 @@ Missing character: There is no k in font nullfont!
\end{minimal}
\end{bug}
-\begin{bug}
+\begin{bug}[prio=1]
providing \verb|\legend{}| without any \verb|\addplot| commands causes a problem
\end{bug}
-\begin{bug}[prio=3]
+\begin{bug}[prio=3,closed]
It is not (properly) possible to provide \verb|surf| to \verb|\addplot|.
\begin{verbatim}
\begin{tikzpicture}
@@ -1279,7 +1489,7 @@ style={thick,color=black}},
\end{minimal}
\end{bug}
-\begin{bug}[-,prio=3]
+\begin{bug}[-,prio=1]
the axis line combination styles can't be adjusted for 3D because they are
evaluated too early.
\end{bug}
@@ -1311,10 +1521,6 @@ style={thick,color=black}},
\end{bug}
\begin{bug}[-]
- document INS 671 does not compile with pgfplots 1.4 and pgf 2.00
-\end{bug}
-
-\begin{bug}[-]
numplotspertype and forget plot and ybar interval yields errors.
\end{bug}
@@ -1372,7 +1578,7 @@ and you can remark that colour filling overlaps x- and y-axis ! So I suggest tha
3D axes: it is difficult to get an 1:1 correspondence to tikz.
\end{bug}
-\begin{bug}[-]
+\begin{bug}[closed]
3D axes: providing three unit vectors is not sufficient, one also needs to set
'view={}{}'. That should be done automatically.
@@ -1393,14 +1599,14 @@ and you can remark that colour filling overlaps x- and y-axis ! So I suggest tha
refine/triangulation etc. and shouldn't make a difference otherwise.
\end{bug}
-\begin{bug}[-]
+\begin{bug}[closed]
manual errors of given pgfplots\_unstable version:
94 2.5.12 \verb|addplot+[patch] --> addplot3+[patch]|
162 "xmode, ymode, zmode" and "x dir, ..."
come again on page 177
\end{bug}
-\begin{bug}[-]
+\begin{bug}[closed]
don't loose \verb|\ref|'s when externalizing
I'll provide a minimal later
\end{bug}
@@ -1415,7 +1621,7 @@ and you can remark that colour filling overlaps x- and y-axis ! So I suggest tha
plot graphics: \verb|\ref| legend doesn't work properly
\end{bug}
-\begin{bug}[-]
+\begin{bug}[-,prio=9]
french babel and colorbars are not fully compatible. The problem is that
colorbars use '\verb|\addplot| graphics {};' with a fixed catcode for the ';' --
which might lead to problems.
@@ -1486,12 +1692,12 @@ and you can remark that colour filling overlaps x- and y-axis ! So I suggest tha
with them as far as I know.
\end{bug}
-\begin{bug}[-]
+\begin{bug}[-,prio=2]
contour external doesn't handle explicitly provided matrix data (mesh/rows and
mesh/cols) yet.
\end{bug}
-\begin{bug}[-]
+\begin{bug}[-,prio=2]
contour external doesn't handle the ordering flag correctly.
\end{bug}
@@ -1505,7 +1711,7 @@ and you can remark that colour filling overlaps x- and y-axis ! So I suggest tha
sanity checking here.
\end{bug}
-\begin{bug}[-]
+\begin{bug}[-,prio=2]
the title style for 'footnotesize' is not as I want it to: it doesn't respect
the depth below the baseline. Or does it need a \verb|\strut|?
\end{bug}
@@ -1642,7 +1848,7 @@ and you can remark that colour filling overlaps x- and y-axis ! So I suggest tha
gnuplot: set terminal table seems to be deprecated.
\end{bug}
-\begin{bug}[-]
+\begin{bug}[closed]
gnuplot and 3D
$\leadsto$ I need a shared interface to prepare the required keys for expression plotting
\end{bug}
@@ -1703,7 +1909,7 @@ and you can remark that colour filling overlaps x- and y-axis ! So I suggest tha
\end{bug}
-\begin{bug}[-]
+\begin{bug}[closed]
3D: axis equal implementation might not be correct (at least not for view
special cases)
\end{bug}
@@ -1854,6 +2060,34 @@ and you can remark that colour filling overlaps x- and y-axis ! So I suggest tha
% FEATURES
\section{Feature Proposals PGFPlots}
\begin{bugtracker}
+
+\begin{feature}
+ improve support for circle / ellipse paths inside of an axis
+
+ compare \url{http://www.digipedia.pl/usenet/thread/16719/198}
+
+ \url{http://sourceforge.net/mailarchive/forum.php?thread_name=D595FD68-AFAB-4C1C-8B9D-A2F84D1A0598\%40mac.com&forum_name=pgfplots-features}
+
+\end{feature}
+
+\begin{feature}
+ provide log labels without exponents, i.e. $10000$ instead of $10^4$
+\end{feature}
+
+\begin{feature}
+ it would be nice to have automatic PNG export for huge graphics. Such an approach, combined with plot graphics,
+ could result in considerably smaller pdfs and faster rendering. At the same time, it would not suffer the limitation which arises if one uses the external lib and converts the complete figure to png (including axis descritpions)
+\end{feature}
+
+\begin{feature}
+ There is no simple way to provide LOG colorbars:
+ \begin{enumerate}
+ \item ymode=log is not supported in `every colorbar' due to key filtering problems
+ \item disablelogfilter appears to be useless and does not respect `log basis'
+ \end{enumerate}
+ If those two this would be fixed, one could provide \verb|colorbar style={ymode=log,disablelogfilter}| and would get a proper logarithmic colorbar. Perhaps even combined with \verb|log basis| ... ?
+\end{feature}
+
\begin{feature}
Cases-statement in math parser
\end{feature}
@@ -2014,10 +2248,11 @@ If there would be a search path like \verb|\graphicspath| for graphics it would
ternary diagram for extractions (more details will come)
\end{feature}
-\begin{feature}[-]
+\begin{feature}[-,prio=9]
filled area between 2 addplot's (already requested in mailing list)
perhaps style 'fill plot' which is applied in vis phase. There, one can
access the postprocessed information of the previous plot.
+ DUPLICATE
\end{feature}
\begin{feature}[-]
@@ -2097,12 +2332,14 @@ If there would be a search path like \verb|\graphicspath| for graphics it would
or confusing....
\end{feature}
-\begin{feature}[-]
+\begin{feature}[-,prio=9]
> Is it possible to shade the area between two curves, using pgfplots, such as
> in this example: \url{http://www.mathworks.com/matlabcentral/fileexchange/13188}
> The only shading I could find is between one curve and the x axis... Shading
> between curves seems to be possible, but only with stacked curves. Is is
> possible to disable stacking somehow, but keep the closedcycle behavior?
+
+ DUPLICATE
\end{feature}
\begin{feature}[-]
@@ -2476,7 +2713,7 @@ Das Plotten sollte dann out-of-the-box m\"oglich sein.
\end{verbatim}
\end{feature}
-\begin{feature}[-]
+\begin{feature}[+]
I got several feature requests for non-cartesian axes.
Perhaps there is a way to generalize the complete procedure... as far as I
remember, I use the pointxyz routines anyway to place tick marks and so on.
@@ -2490,7 +2727,7 @@ Das Plotten sollte dann out-of-the-box m\"oglich sein.
\url{http://www.siart.de/lehre/smithdgr.pdf}
\end{feature}
-\begin{feature}
+\begin{feature}[+]
smith charts
\url{http://www.siart.de/lehre/tutorien.xhtml#smishort}
@@ -2576,13 +2813,15 @@ Das Plotten sollte dann out-of-the-box m\"oglich sein.
\end{feature}
-\begin{feature}[-]
+\begin{feature}[-,prio=9]
it might be interesting to fill the area between two paths. Perhaps there is
such a feature in pgf; or perhaps I can generalize the \verb|\closedcycle|
implementation written for stacked plots.
+
+ DUPLICATE
\end{feature}
-\begin{feature}[-]
+\begin{feature}[+]
provide a \verb|\numplotsperplothandler| or something like that. This would improve
things for bar plots!
\end{feature}