Mercurial > hg > octave-lyh
annotate doc/interpreter/plot.txi @ 9088:77e71f3da3d6
Fix documentation image printing under new development code
Printed images are now clipped to image size rather than to papersize of 8.5x11
Images are scaled to 4 inches and centered in display
pdf printing is sub-optimal as texi2pdf picks the png rendering (bitmap) rather
than the pdf rendering (vector).
author | Rik <rdrider0-list@yahoo.com> |
---|---|
date | Sat, 04 Apr 2009 14:28:22 -0700 |
parents | dbd0c77e575e |
children | 923c7cb7f13f |
rev | line source |
---|---|
7018 | 1 @c Copyright (C) 1996, 1997, 1999, 2000, 2002, 2003, 2004, 2005, |
8920 | 2 @c 2006, 2007, 2008, 2009 John W. Eaton |
7018 | 3 @c |
4 @c This file is part of Octave. | |
5 @c | |
6 @c Octave is free software; you can redistribute it and/or modify it | |
7 @c under the terms of the GNU General Public License as published by the | |
8 @c Free Software Foundation; either version 3 of the License, or (at | |
9 @c your option) any later version. | |
10 @c | |
11 @c Octave is distributed in the hope that it will be useful, but WITHOUT | |
12 @c ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or | |
13 @c FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License | |
14 @c for more details. | |
15 @c | |
16 @c You should have received a copy of the GNU General Public License | |
17 @c along with Octave; see the file COPYING. If not, see | |
18 @c <http://www.gnu.org/licenses/>. | |
3294 | 19 |
4167 | 20 @node Plotting |
3294 | 21 @chapter Plotting |
6888 | 22 @cindex plotting |
23 @cindex graphics | |
3294 | 24 |
25 @menu | |
9032
349616d9c38e
Cleanup top-level documentation menu in octave.texi
Rik <rdrider0-list@yahoo.com>
parents:
8920
diff
changeset
|
26 * Plotting Basics:: |
349616d9c38e
Cleanup top-level documentation menu in octave.texi
Rik <rdrider0-list@yahoo.com>
parents:
8920
diff
changeset
|
27 * Advanced Plotting:: |
6888 | 28 @end menu |
29 | |
30 @node Plotting Basics | |
31 @section Plotting Basics | |
32 | |
33 Octave makes it easy to create many different types of two- and | |
34 three-dimensional plots using a few high-level functions. | |
35 | |
36 If you need finer control over graphics, see @ref{Advanced Plotting}. | |
37 | |
38 @menu | |
39 * Two-Dimensional Plots:: | |
3294 | 40 * Three-Dimensional Plotting:: |
41 * Plot Annotations:: | |
42 * Multiple Plots on One Page:: | |
3428 | 43 * Multiple Plot Windows:: |
6888 | 44 * Printing Plots:: |
7984
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
45 * Interacting with plots:: |
6888 | 46 * Test Plotting Functions:: |
3294 | 47 @end menu |
48 | |
6888 | 49 @node Two-Dimensional Plots |
50 @subsection Two-Dimensional Plots | |
51 | |
52 The @code{plot} function allows you to create simple x-y plots with | |
53 linear axes. For example, | |
3294 | 54 |
6888 | 55 @example |
56 @group | |
57 x = -10:0.1:10; | |
58 plot (x, sin (x)); | |
59 @end group | |
60 @end example | |
61 | |
62 @noindent | |
6899 | 63 displays a sine wave shown in @ref{fig:plot}. On most systems, this |
6888 | 64 command will open a separate plot window to display the graph. |
5134 | 65 |
6888 | 66 @float Figure,fig:plot |
9088
77e71f3da3d6
Fix documentation image printing under new development code
Rik <rdrider0-list@yahoo.com>
parents:
9040
diff
changeset
|
67 @center @image{plot,4in} |
6888 | 68 @caption{Simple Two-Dimensional Plot.} |
69 @end float | |
70 | |
5134 | 71 @DOCSTRING(plot) |
72 | |
8817
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
73 The @code{plotyy} function may be used to create a plot with two |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
74 independent y axes. |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
75 |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
76 @DOCSTRING(plotyy) |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
77 |
6888 | 78 The functions @code{semilogx}, @code{semilogy}, and @code{loglog} are |
79 similar to the @code{plot} function, but produce plots in which one or | |
80 both of the axes use log scales. | |
81 | |
82 @DOCSTRING(semilogx) | |
6502 | 83 |
6888 | 84 @DOCSTRING(semilogy) |
6502 | 85 |
6888 | 86 @DOCSTRING(loglog) |
87 | |
88 The functions @code{bar}, @code{barh}, @code{stairs}, and @code{stem} | |
89 are useful for displaying discrete data. For example, | |
5134 | 90 |
6888 | 91 @example |
92 @group | |
93 hist (randn (10000, 1), 30); | |
94 @end group | |
95 @end example | |
5134 | 96 |
6888 | 97 @noindent |
98 produces the histogram of 10,000 normally distributed random numbers | |
6899 | 99 shown in @ref{fig:hist}. |
5134 | 100 |
6888 | 101 @float Figure,fig:hist |
9088
77e71f3da3d6
Fix documentation image printing under new development code
Rik <rdrider0-list@yahoo.com>
parents:
9040
diff
changeset
|
102 @center @image{hist,4in} |
6888 | 103 @caption{Histogram.} |
104 @end float | |
5134 | 105 |
106 @DOCSTRING(bar) | |
107 | |
6877 | 108 @DOCSTRING(barh) |
109 | |
6888 | 110 @DOCSTRING(hist) |
111 | |
112 @DOCSTRING(stairs) | |
113 | |
114 @DOCSTRING(stem) | |
115 | |
8817
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
116 @DOCSTRING(stem3) |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
117 |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
118 @DOCSTRING(scatter) |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
119 |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
120 @DOCSTRING(scatter3) |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
121 |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
122 @DOCSTRING(plotmatrix) |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
123 |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
124 @DOCSTRING(pareto) |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
125 |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
126 @DOCSTRING(rose) |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
127 |
7981 | 128 The @code{contour}, @code{contourf} and @code{contourc} functions |
129 produce two-dimensional contour plots from three dimensional data. | |
6888 | 130 |
5134 | 131 @DOCSTRING(contour) |
132 | |
7981 | 133 @DOCSTRING(contourf) |
134 | |
6502 | 135 @DOCSTRING(contourc) |
136 | |
8817
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
137 @DOCSTRING(contour3) |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
138 |
6888 | 139 The @code{errorbar}, @code{semilogxerr}, @code{semilogyerr}, and |
8347
fa78cb8d8a5c
corrections for typos
Brian Gough<bjg@network-theory.co.uk>
parents:
8325
diff
changeset
|
140 @code{loglogerr} functions produce plots with error bar markers. For |
6888 | 141 example, |
6877 | 142 |
6888 | 143 @example |
9088
77e71f3da3d6
Fix documentation image printing under new development code
Rik <rdrider0-list@yahoo.com>
parents:
9040
diff
changeset
|
144 @group |
6888 | 145 x = 0:0.1:10; |
146 y = sin (x); | |
147 yp = 0.1 .* randn (size (x)); | |
148 ym = -0.1 .* randn (size (x)); | |
149 errorbar (x, sin (x), ym, yp); | |
9088
77e71f3da3d6
Fix documentation image printing under new development code
Rik <rdrider0-list@yahoo.com>
parents:
9040
diff
changeset
|
150 @end group |
6888 | 151 @end example |
5134 | 152 |
6888 | 153 @noindent |
6899 | 154 produces the figure shown in @ref{fig:errorbar}. |
6502 | 155 |
6888 | 156 @float Figure,fig:errorbar |
9088
77e71f3da3d6
Fix documentation image printing under new development code
Rik <rdrider0-list@yahoo.com>
parents:
9040
diff
changeset
|
157 @center @image{errorbar,4in} |
6888 | 158 @caption{Errorbar plot.} |
159 @end float | |
5134 | 160 |
161 @DOCSTRING(errorbar) | |
162 | |
163 @DOCSTRING(semilogxerr) | |
164 | |
165 @DOCSTRING(semilogyerr) | |
166 | |
6888 | 167 @DOCSTRING(loglogerr) |
168 | |
169 Finally, the @code{polar} function allows you to easily plot data in | |
7001 | 170 polar coordinates. However, the display coordinates remain rectangular |
6888 | 171 and linear. For example, |
172 | |
173 @example | |
174 polar (0:0.1:10*pi, 0:0.1:10*pi); | |
175 @end example | |
176 | |
177 @noindent | |
6899 | 178 produces the spiral plot shown in @ref{fig:polar}. |
6888 | 179 |
180 @float Figure,fig:polar | |
9088
77e71f3da3d6
Fix documentation image printing under new development code
Rik <rdrider0-list@yahoo.com>
parents:
9040
diff
changeset
|
181 @center @image{polar,4in} |
6888 | 182 @caption{Polar plot.} |
183 @end float | |
184 | |
185 @DOCSTRING(polar) | |
186 | |
7120 | 187 @DOCSTRING(pie) |
188 | |
189 @DOCSTRING(quiver) | |
190 | |
8817
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
191 @DOCSTRING(quiver3) |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
192 |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
193 @DOCSTRING(compass) |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
194 |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
195 @DOCSTRING(feather) |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
196 |
7120 | 197 @DOCSTRING(pcolor) |
198 | |
7153 | 199 @DOCSTRING(area) |
200 | |
8817
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
201 @DOCSTRING(comet) |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
202 |
6888 | 203 The axis function may be used to change the axis limits of an existing |
8429
f34ab2b433e8
One word missing from int8 help string.
Francesco Potortì <pot@gnu.org>
parents:
8428
diff
changeset
|
204 plot and various other axis properties, such as the aspect ratio and the |
f34ab2b433e8
One word missing from int8 help string.
Francesco Potortì <pot@gnu.org>
parents:
8428
diff
changeset
|
205 appearance of tic marks. |
6888 | 206 |
207 @DOCSTRING(axis) | |
208 | |
7189 | 209 Similarly the axis limits of the colormap can be changed with the caxis |
210 function. | |
211 | |
212 @DOCSTRING(caxis) | |
213 | |
8817
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
214 The @code{xlim}, @code{ylim}, and @code{zlim} functions may be used to |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
215 get or set individual axis limits. Each has the same form. |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
216 |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
217 @anchor{doc-ylim} |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
218 @anchor{doc-zlim} |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
219 @DOCSTRING(xlim) |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
220 |
7989
23c248d415b5
Various doc fixes. Readd cellidx
David Bateman <dbateman@free.fr>
parents:
7984
diff
changeset
|
221 @menu |
23c248d415b5
Various doc fixes. Readd cellidx
David Bateman <dbateman@free.fr>
parents:
7984
diff
changeset
|
222 * Two-dimensional Function Plotting:: |
23c248d415b5
Various doc fixes. Readd cellidx
David Bateman <dbateman@free.fr>
parents:
7984
diff
changeset
|
223 @end menu |
23c248d415b5
Various doc fixes. Readd cellidx
David Bateman <dbateman@free.fr>
parents:
7984
diff
changeset
|
224 |
7984
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
225 @node Two-dimensional Function Plotting |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
226 @subsubsection Two-dimensional Function Plotting |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
227 |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
228 Octave can plot a function from a function handle inline function or |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
229 string defining the function without the user needing to explicitly |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
230 create the data to be plotted. The function @code{fplot} also generates |
7984
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
231 two-dimensional plots with linear axes using a function name and limits |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
232 for the range of the x-coordinate instead of the x and y data. For |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
233 example, |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
234 |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
235 @example |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
236 @group |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
237 fplot (@@sin, [-10, 10], 201); |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
238 @end group |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
239 @end example |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
240 |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
241 @noindent |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
242 produces a plot that is equivalent to the one above, but also includes a |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
243 legend displaying the name of the plotted function. |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
244 |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
245 @DOCSTRING(fplot) |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
246 |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
247 Other functions that can create two-dimensional plots directly from a |
8055
d51c3541be28
contrib.txi: new documentation for contributors
Jaroslav Hajek <highegg@gmail.com>
parents:
8046
diff
changeset
|
248 function include @code{ezplot}, @code{ezcontour}, @code{ezcontourf} and |
8046 | 249 @code{ezpolar}. |
250 | |
251 @DOCSTRING(ezplot) | |
7984
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
252 |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
253 @DOCSTRING(ezcontour) |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
254 |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
255 @DOCSTRING(ezcontourf) |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
256 |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
257 @DOCSTRING(ezpolar) |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
258 |
5134 | 259 @node Three-Dimensional Plotting |
6888 | 260 @subsection Three-Dimensional Plotting |
261 | |
262 The function @code{mesh} produces mesh surface plots. For example, | |
263 | |
264 @example | |
265 @group | |
266 tx = ty = linspace (-8, 8, 41)'; | |
267 [xx, yy] = meshgrid (tx, ty); | |
268 r = sqrt (xx .^ 2 + yy .^ 2) + eps; | |
269 tz = sin (r) ./ r; | |
270 mesh (tx, ty, tz); | |
271 @end group | |
272 @end example | |
273 | |
274 @noindent | |
6899 | 275 produces the familiar ``sombrero'' plot shown in @ref{fig:mesh}. Note |
6888 | 276 the use of the function @code{meshgrid} to create matrices of X and Y |
277 coordinates to use for plotting the Z data. The @code{ndgrid} function | |
278 is similar to @code{meshgrid}, but works for N-dimensional matrices. | |
279 | |
280 @float Figure,fig:mesh | |
9088
77e71f3da3d6
Fix documentation image printing under new development code
Rik <rdrider0-list@yahoo.com>
parents:
9040
diff
changeset
|
281 @center @image{mesh,4in} |
6888 | 282 @caption{Mesh plot.} |
283 @end float | |
5134 | 284 |
6888 | 285 The @code{meshc} function is similar to @code{mesh}, but also produces a |
286 plot of contours for the surface. | |
287 | |
288 The @code{plot3} function displays arbitrary three-dimensional data, | |
289 without requiring it to form a surface. For example | |
290 | |
291 @example | |
292 @group | |
293 t = 0:0.1:10*pi; | |
294 r = linspace (0, 1, numel (t)); | |
295 z = linspace (0, 1, numel (t)); | |
296 plot3 (r.*sin(t), r.*cos(t), z); | |
297 @end group | |
298 @end example | |
299 | |
300 @noindent | |
6899 | 301 displays the spiral in three dimensions shown in @ref{fig:plot3}. |
6888 | 302 |
303 @float Figure,fig:plot3 | |
9088
77e71f3da3d6
Fix documentation image printing under new development code
Rik <rdrider0-list@yahoo.com>
parents:
9040
diff
changeset
|
304 @center @image{plot3,4in} |
6888 | 305 @caption{Three dimensional spiral.} |
306 @end float | |
307 | |
308 Finally, the @code{view} function changes the viewpoint for | |
309 three-dimensional plots. | |
5134 | 310 |
311 @DOCSTRING(mesh) | |
312 | |
6788 | 313 @DOCSTRING(meshc) |
314 | |
8817
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
315 @DOCSTRING(meshz) |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
316 |
7153 | 317 @DOCSTRING(hidden) |
318 | |
7120 | 319 @DOCSTRING(surf) |
320 | |
321 @DOCSTRING(surfc) | |
322 | |
8817
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
323 @DOCSTRING(surfl) |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
324 |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
325 @DOCSTRING(surfnorm) |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
326 |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
327 @DOCSTRING(diffuse) |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
328 |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
329 @DOCSTRING(specular) |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
330 |
5134 | 331 @DOCSTRING(meshgrid) |
332 | |
6550 | 333 @DOCSTRING(ndgrid) |
334 | |
6888 | 335 @DOCSTRING(plot3) |
336 | |
6502 | 337 @DOCSTRING(view) |
338 | |
8817
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
339 @DOCSTRING(slice) |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
340 |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
341 @DOCSTRING(ribbon) |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
342 |
7120 | 343 @DOCSTRING(shading) |
344 | |
7989
23c248d415b5
Various doc fixes. Readd cellidx
David Bateman <dbateman@free.fr>
parents:
7984
diff
changeset
|
345 @menu |
23c248d415b5
Various doc fixes. Readd cellidx
David Bateman <dbateman@free.fr>
parents:
7984
diff
changeset
|
346 * Three-dimensional Function Plotting:: |
8817
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
347 * Three-dimensional Geometric Shapes:: |
7989
23c248d415b5
Various doc fixes. Readd cellidx
David Bateman <dbateman@free.fr>
parents:
7984
diff
changeset
|
348 @end menu |
23c248d415b5
Various doc fixes. Readd cellidx
David Bateman <dbateman@free.fr>
parents:
7984
diff
changeset
|
349 |
23c248d415b5
Various doc fixes. Readd cellidx
David Bateman <dbateman@free.fr>
parents:
7984
diff
changeset
|
350 @node Three-dimensional Function Plotting |
23c248d415b5
Various doc fixes. Readd cellidx
David Bateman <dbateman@free.fr>
parents:
7984
diff
changeset
|
351 @subsubsection Three-dimensional Function Plotting |
7984
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
352 |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
353 @DOCSTRING(ezplot3) |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
354 |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
355 @DOCSTRING(ezmesh) |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
356 |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
357 @DOCSTRING(ezmeshc) |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
358 |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
359 @DOCSTRING(ezsurf) |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
360 |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
361 @DOCSTRING(ezsurfc) |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
362 |
8817
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
363 @node Three-dimensional Geometric Shapes |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
364 @subsubsection Three-dimensional Geometric Shapes |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
365 |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
366 @DOCSTRING(cylinder) |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
367 |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
368 @DOCSTRING(sphere) |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
369 |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
370 @DOCSTRING(ellipsoid) |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
371 |
6888 | 372 @node Plot Annotations |
373 @subsection Plot Annotations | |
6502 | 374 |
6888 | 375 You can add titles, axis labels, legends, and arbitrary text to an |
376 existing plot. For example, | |
6877 | 377 |
6888 | 378 @example |
379 @group | |
380 x = -10:0.1:10; | |
381 plot (x, sin (x)); | |
382 title ("sin(x) for x = -10:0.1:10"); | |
383 xlabel ("x"); | |
384 ylabel ("sin (x)"); | |
385 text (pi, 0.7, "arbitrary text"); | |
386 legend ("sin (x)"); | |
387 @end group | |
388 @end example | |
6502 | 389 |
6888 | 390 The functions @code{grid} and @code{box} may also be used to add grid |
391 and border lines to the plot. By default, the grid is off and the | |
392 border lines are on. | |
5134 | 393 |
394 @DOCSTRING(title) | |
395 | |
6502 | 396 @DOCSTRING(legend) |
397 | |
398 @DOCSTRING(text) | |
399 | |
8428
ee1bc8aa226b
Add cross reference from Plot Annotations to Text Properties.
Francesco Potortì <pot@gnu.org>
parents:
8347
diff
changeset
|
400 See @ref{Text Properties} for the properties that you can set. |
ee1bc8aa226b
Add cross reference from Plot Annotations to Text Properties.
Francesco Potortì <pot@gnu.org>
parents:
8347
diff
changeset
|
401 |
8286
6f2d95255911
fix @seealso references to point to existing anchors
Thorsten Meyer <thorsten.meyier@gmx.de>
parents:
8261
diff
changeset
|
402 @anchor{doc-ylabel} |
6f2d95255911
fix @seealso references to point to existing anchors
Thorsten Meyer <thorsten.meyier@gmx.de>
parents:
8261
diff
changeset
|
403 @anchor{doc-zlabel} |
5134 | 404 @DOCSTRING(xlabel) |
405 | |
8817
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
406 @DOCSTRING(clabel) |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
407 |
6502 | 408 @DOCSTRING(box) |
409 | |
410 @DOCSTRING(grid) | |
411 | |
8089
0ec09255515a
add colorbar docstring to the manual
John W. Eaton <jwe@octave.org>
parents:
8073
diff
changeset
|
412 @DOCSTRING(colorbar) |
0ec09255515a
add colorbar docstring to the manual
John W. Eaton <jwe@octave.org>
parents:
8073
diff
changeset
|
413 |
5134 | 414 @node Multiple Plots on One Page |
6888 | 415 @subsection Multiple Plots on One Page |
416 | |
417 Octave can display more than one plot in a single figure. The simplest | |
418 way to do this is to use the @code{subplot} function to divide the plot | |
419 area into a series of subplot windows that are indexed by an integer. | |
420 For example, | |
421 | |
422 @example | |
423 @group | |
424 subplot (2, 1, 1) | |
425 fplot (@@sin, [-10, 10]); | |
426 subplot (2, 1, 2) | |
427 fplot (@@cos, [-10, 10]); | |
428 @end group | |
429 @end example | |
430 | |
431 @noindent | |
432 creates a figure with two separate axes, one displaying a sine wave and | |
433 the other a cosine wave. The first call to subplot divides the figure | |
434 into two plotting areas (two rows and one column) and makes the first plot | |
435 area active. The grid of plot areas created by @code{subplot} is | |
436 numbered in column-major order (top to bottom, left to right). | |
5134 | 437 |
438 @DOCSTRING(subplot) | |
439 | |
440 @node Multiple Plot Windows | |
6888 | 441 @subsection Multiple Plot Windows |
442 | |
443 You can open multiple plot windows using the @code{figure} function. | |
444 For example | |
445 | |
446 @example | |
9088
77e71f3da3d6
Fix documentation image printing under new development code
Rik <rdrider0-list@yahoo.com>
parents:
9040
diff
changeset
|
447 @group |
6888 | 448 figure (1); |
449 fplot (@@sin, [-10, 10]); | |
450 figure (2); | |
451 fplot (@@cos, [-10, 10]); | |
9088
77e71f3da3d6
Fix documentation image printing under new development code
Rik <rdrider0-list@yahoo.com>
parents:
9040
diff
changeset
|
452 @end group |
6888 | 453 @end example |
454 | |
455 @noindent | |
456 creates two figures, with the first displaying a sine wave and | |
457 the second a cosine wave. Figure numbers must be positive integers. | |
5134 | 458 |
459 @DOCSTRING(figure) | |
460 | |
6502 | 461 @node Printing Plots |
6888 | 462 @subsection Printing Plots |
463 | |
464 The @code{print} command allows you to save plots in a variety of | |
465 formats. For example, | |
466 | |
467 @example | |
468 print -deps foo.eps | |
469 @end example | |
470 | |
471 @noindent | |
472 writes the current figure to an encapsulated PostScript file called | |
473 @file{foo.eps}. | |
6502 | 474 |
475 @DOCSTRING(print) | |
476 | |
477 @DOCSTRING(orient) | |
5134 | 478 |
7984
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
479 @node Interacting with plots |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
480 @subsection Interacting with plots |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
481 |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
482 The user can select points on a plot with the @code{ginput} function or |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
483 selection the position at which to place text on the plot with the |
7984
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
484 @code{gtext} function using the mouse. |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
485 |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
486 @DOCSTRING(ginput) |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
487 |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
488 @DOCSTRING(waitforbuttonpress) |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
489 |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
490 @DOCSTRING(gtext) |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
491 |
6788 | 492 @node Test Plotting Functions |
6888 | 493 @subsection Test Plotting Functions |
494 | |
495 The functions @code{sombrero} and @code{peaks} provide a way to check | |
496 that plotting is working. Typing either @code{sombrero} or @code{peaks} | |
497 at the Octave prompt should display a three dimensional plot. | |
6788 | 498 |
6877 | 499 @DOCSTRING(sombrero) |
500 | |
6788 | 501 @DOCSTRING(peaks) |
502 | |
6888 | 503 @node Advanced Plotting |
504 @section Advanced Plotting | |
505 | |
506 @menu | |
507 * Graphics Objects:: | |
508 * Graphics Object Properties:: | |
6891 | 509 * Managing Default Properties:: |
6889 | 510 * Colors:: |
511 * Line Styles:: | |
512 * Marker Styles:: | |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
513 * Callbacks:: |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
514 * Object Groups:: |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
515 * Graphics backends:: |
6888 | 516 @end menu |
517 | |
518 @node Graphics Objects | |
519 @subsection Graphics Objects | |
520 | |
521 Plots in Octave are constructed from the following @dfn{graphics | |
522 objects}. Each graphics object has a set of properties that define its | |
523 appearance and may also contain links to other graphics objects. | |
524 Graphics objects are only referenced by a numeric index, or @dfn{handle}. | |
525 | |
526 @table @asis | |
527 @item root figure | |
8071 | 528 @cindex root figure graphics object |
529 @cindex graphics object, root figure | |
6888 | 530 The parent of all figure objects. The index for the root figure is |
531 defined to be 0. | |
532 | |
533 @item figure | |
8071 | 534 @cindex figure graphics object |
535 @cindex graphics object, figure | |
6888 | 536 A figure window. |
537 | |
538 @item axes | |
8071 | 539 @cindex axes graphics object |
540 @cindex graphics object, axes | |
6888 | 541 An set of axes. This object is a child of a figure object and may be a |
542 parent of line, text, image, patch, or surface objects. | |
543 | |
544 @item line | |
8071 | 545 @cindex line graphics object |
546 @cindex graphics object, line | |
6888 | 547 A line in two or three dimensions. |
548 | |
549 @item text | |
8071 | 550 @cindex text graphics object |
551 @cindex graphics object, text | |
6888 | 552 Text annotations. |
553 | |
554 @item image | |
8071 | 555 @cindex image graphics object |
556 @cindex graphics object, image | |
6888 | 557 A bitmap image. |
558 | |
559 @item patch | |
8071 | 560 @cindex patch graphics object |
561 @cindex graphics object, patch | |
6888 | 562 A filled polygon, currently limited to two dimensions. |
563 | |
564 @item surface | |
8071 | 565 @cindex surface graphics object |
566 @cindex graphics object, surface | |
6888 | 567 A three-dimensional surface. |
568 @end table | |
569 | |
570 To determine whether an object is a graphics object index or a figure | |
571 index, use the functions @code{ishandle} and @code{isfigure}. | |
572 | |
573 @DOCSTRING(ishandle) | |
574 | |
8817
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
575 @DOCSTRING(ishghandle) |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
576 |
6888 | 577 @DOCSTRING(isfigure) |
578 | |
579 The function @code{gcf} returns an index to the current figure object, | |
580 or creates one if none exists. Similarly, @code{gca} returns the | |
581 current axes object, or creates one (and its parent figure object) if | |
582 none exists. | |
583 | |
584 @DOCSTRING(gcf) | |
585 | |
586 @DOCSTRING(gca) | |
587 | |
588 The @code{get} and @code{set} functions may be used to examine and set | |
589 properties for graphics objects. For example, | |
590 | |
591 @example | |
592 @group | |
593 get (0) | |
594 @result{} ans = | |
595 @{ | |
596 type = root figure | |
597 currentfigure = [](0x0) | |
598 children = [](0x0) | |
599 visible = on | |
600 @} | |
601 @end group | |
602 @end example | |
603 | |
604 @noindent | |
605 returns a structure containing all the properties of the root figure. | |
606 As with all functions in Octave, the structure is returned by value, so | |
607 modifying it will not modify the internal root figure plot object. To | |
608 do that, you must use the @code{set} function. Also, note that in this | |
609 case, the @code{currentfigure} property is empty, which indicates that | |
610 there is no current figure window. | |
611 | |
612 The @code{get} function may also be used to find the value of a single | |
613 property. For example, | |
614 | |
615 @example | |
616 @group | |
617 get (gca (), "xlim") | |
618 @result{} [ 0 1 ] | |
619 @end group | |
620 @end example | |
621 | |
622 @noindent | |
623 returns the range of the x-axis for the current axes object in the | |
624 current figure. | |
625 | |
626 To set graphics object properties, use the set function. For example, | |
627 | |
628 @example | |
629 set (gca (), "xlim", [-10, 10]); | |
630 @end example | |
631 | |
632 @noindent | |
633 sets the range of the x-axis for the current axes object in the current | |
634 figure to @samp{[-10, 10]}. Additionally, calling set with a graphics | |
635 object index as the only argument returns a structure containing the | |
636 default values for all the properties for the given object type. For | |
637 example, | |
638 | |
639 @example | |
640 set (gca ()) | |
641 @end example | |
642 | |
643 @noindent | |
644 returns a structure containing the default property values for axes | |
645 objects. | |
646 | |
647 @DOCSTRING(get) | |
648 | |
649 @DOCSTRING(set) | |
650 | |
651 @DOCSTRING(ancestor) | |
652 | |
7984
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
653 @DOCSTRING(allchild) |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
654 |
6888 | 655 You can create axes, line, and patch objects directly using the |
656 @code{axes}, @code{line}, and @code{patch} functions. These objects | |
657 become children of the current axes object. | |
658 | |
659 @DOCSTRING(axes) | |
660 | |
661 @DOCSTRING(line) | |
662 | |
663 @DOCSTRING(patch) | |
664 | |
8817
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
665 @DOCSTRING(fill) |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
666 |
7120 | 667 @DOCSTRING(surface) |
668 | |
6888 | 669 By default, Octave refreshes the plot window when a prompt is printed, |
670 or when waiting for input. To force an update at other times, call the | |
671 @code{drawnow} function. | |
672 | |
673 @DOCSTRING(drawnow) | |
674 | |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
675 Only figures that are modified will be updated. The @code{refresh} |
8070
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
676 function can also be to force an update of the current figure, even if |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
677 it is nor modified. |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
678 |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
679 @DOCSTRING(refresh) |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
680 |
6888 | 681 Normally, high-level plot functions like @code{plot} or @code{mesh} call |
682 @code{newplot} to initialize the state of the current axes so that the | |
683 next plot is drawn in a blank window with default property settings. To | |
684 have two plots superimposed over one another, call the @code{hold} | |
685 function. For example, | |
686 | |
687 @example | |
688 @group | |
689 hold ("on"); | |
690 x = -10:0.1:10; | |
691 plot (x, sin (x)); | |
692 plot (x, cos (x)); | |
693 hold ("off"); | |
694 @end group | |
695 @end example | |
696 | |
697 @noindent | |
698 displays sine and cosine waves on the same axes. If the hold state is | |
699 off, consecutive plotting commands like this will only display the last | |
700 plot. | |
701 | |
702 @DOCSTRING(newplot) | |
703 | |
704 @DOCSTRING(hold) | |
705 | |
706 @DOCSTRING(ishold) | |
707 | |
8286
6f2d95255911
fix @seealso references to point to existing anchors
Thorsten Meyer <thorsten.meyier@gmx.de>
parents:
8261
diff
changeset
|
708 To clear the current figure, call the @code{clf} function. To clear the |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
709 current axis, call the @code{cla} function. To bring the current figure |
6888 | 710 to the top of the window stack, call the @code{shg} function. To delete |
711 a graphics object, call @code{delete} on its index. To close the | |
712 figure window, call the @code{close} function. | |
713 | |
714 @DOCSTRING(clf) | |
715 | |
8286
6f2d95255911
fix @seealso references to point to existing anchors
Thorsten Meyer <thorsten.meyier@gmx.de>
parents:
8261
diff
changeset
|
716 @DOCSTRING(cla) |
6f2d95255911
fix @seealso references to point to existing anchors
Thorsten Meyer <thorsten.meyier@gmx.de>
parents:
8261
diff
changeset
|
717 |
6888 | 718 @DOCSTRING(shg) |
719 | |
720 @DOCSTRING(delete) | |
721 | |
722 @DOCSTRING(close) | |
723 | |
724 @DOCSTRING(closereq) | |
725 | |
726 @node Graphics Object Properties | |
727 @subsection Graphics Object Properties | |
728 @cindex graphics object properties | |
729 | |
730 @menu | |
731 * Root Figure Properties:: | |
6889 | 732 * Figure Properties:: |
6888 | 733 * Axes Properties:: |
734 * Line Properties:: | |
735 * Text Properties:: | |
736 * Image Properties:: | |
737 * Patch Properties:: | |
738 * Surface Properties:: | |
8070
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
739 * Searching Properties:: |
6888 | 740 @end menu |
741 | |
742 @node Root Figure Properties | |
743 @subsubsection Root Figure Properties | |
744 | |
745 @table @code | |
746 @item currentfigure | |
6889 | 747 Index to graphics object for the current figure. |
748 | |
749 @c FIXME -- does this work? | |
750 @c @item visible | |
751 @c Either @code{"on"} or @code{"off"} to toggle display of figures. | |
6888 | 752 @end table |
753 | |
6889 | 754 @node Figure Properties |
755 @subsubsection Figure Properties | |
8071 | 756 @cindex figure properties |
6888 | 757 |
758 @table @code | |
759 @item nextplot | |
6889 | 760 May be one of |
761 @table @code | |
762 @item "new" | |
763 @item "add" | |
764 @item "replace" | |
765 @item "replacechildren" | |
766 @end table | |
767 | |
6888 | 768 @item closerequestfcn |
6889 | 769 Handle of function to call when a figure is closed. |
770 | |
6888 | 771 @item currentaxes |
6889 | 772 Index to graphics object of current axes. |
773 | |
6888 | 774 @item colormap |
6889 | 775 An N-by-3 matrix containing the color map for the current axes. |
776 | |
6888 | 777 @item visible |
6889 | 778 Either @code{"on"} or @code{"off"} to toggle display of the figure. |
779 | |
6888 | 780 @item paperorientation |
6889 | 781 Indicates the orientation for printing. Either @code{"landscape"} or |
782 @code{"portrait"}. | |
6888 | 783 @end table |
784 | |
785 @node Axes Properties | |
786 @subsubsection Axes Properties | |
8071 | 787 @cindex axes properties |
6888 | 788 |
789 @table @code | |
790 @item position | |
8071 | 791 A vector specifying the position of the plot, excluding titles, axes and |
792 legend. The four elements of the vector are the coordinates of the | |
793 lower left corner and width and height of the plot, in units normalized | |
794 to the width and height of the plot window. For example, @code{[0.2, | |
795 0.3, 0.4, 0.5]} sets the lower left corner of the axes at @math{(0.2, | |
796 0.3)} and the width and height to be 0.4 and 0.5 respectively. See also | |
797 the @code{outerposition} property. | |
6889 | 798 |
6888 | 799 @item title |
6889 | 800 Index of text object for the axes title. |
801 | |
6888 | 802 @item box |
6889 | 803 Either @code{"on"} or @code{"off"} to toggle display of the box around |
804 the axes. | |
805 | |
6888 | 806 @item key |
6889 | 807 Either @code{"on"} or @code{"off"} to toggle display of the legend. |
9088
77e71f3da3d6
Fix documentation image printing under new development code
Rik <rdrider0-list@yahoo.com>
parents:
9040
diff
changeset
|
808 Note that this property is not compatible with @sc{matlab} and may be |
6889 | 809 removed in a future version of Octave. |
810 | |
6888 | 811 @item keybox |
6889 | 812 Either @code{"on"} or @code{"off"} to toggle display of a box around the |
9088
77e71f3da3d6
Fix documentation image printing under new development code
Rik <rdrider0-list@yahoo.com>
parents:
9040
diff
changeset
|
813 legend. Note that this property is not compatible with @sc{matlab} and |
6889 | 814 may be removed in a future version of Octave. |
815 | |
6888 | 816 @item keypos |
6889 | 817 An integer from 1 to 4 specifying the position of the legend. 1 |
818 indicates upper right corner, 2 indicates upper left, 3 indicates lower | |
819 left, and 4 indicates lower right. Note that this property is not | |
9088
77e71f3da3d6
Fix documentation image printing under new development code
Rik <rdrider0-list@yahoo.com>
parents:
9040
diff
changeset
|
820 compatible with @sc{matlab} and may be removed in a future version of |
6889 | 821 Octave. |
822 | |
6888 | 823 @item dataaspectratio |
6889 | 824 A two-element vector specifying the relative height and width of the |
825 data displayed in the axes. Setting @code{dataaspectratio} to @samp{1, | |
826 2]} causes the length of one unit as displayed on the y axis to be the | |
827 same as the length of 2 units on the x axis. Setting | |
828 @code{dataaspectratio} also forces the @code{dataaspectratiomode} | |
829 property to be set to @code{"manual"}. | |
830 | |
6888 | 831 @item dataaspectratiomode |
6889 | 832 Either @code{"manual"} or @code{"auto"}. |
833 | |
6888 | 834 @item xlim |
835 @itemx ylim | |
836 @itemx zlim | |
837 @itemx clim | |
6889 | 838 Two-element vectors defining the limits for the x, y, and z axes and the |
839 Setting one of these properties also forces the corresponding mode | |
840 property to be set to @code{"manual"}. | |
841 | |
6888 | 842 @item xlimmode |
843 @itemx ylimmode | |
844 @itemx zlimmode | |
845 @itemx climmode | |
6889 | 846 Either @code{"manual"} or @code{"auto"}. |
847 | |
6888 | 848 @item xlabel |
849 @itemx ylabel | |
850 @itemx zlabel | |
6889 | 851 Indices to text objects for the axes labels. |
852 | |
6888 | 853 @item xgrid |
854 @itemx ygrid | |
855 @itemx zgrid | |
6889 | 856 Either @code{"on"} or @code{"off"} to toggle display of grid lines. |
857 | |
6888 | 858 @item xminorgrid |
859 @itemx yminorgrid | |
860 @itemx zminorgrid | |
6889 | 861 Either @code{"on"} or @code{"off"} to toggle display of minor grid lines. |
862 | |
6888 | 863 @item xtick |
864 @itemx ytick | |
865 @itemx ztick | |
6889 | 866 Setting one of these properties also forces the corresponding mode |
867 property to be set to @code{"manual"}. | |
868 | |
6888 | 869 @item xtickmode |
870 @itemx ytickmode | |
871 @itemx ztickmode | |
6889 | 872 Either @code{"manual"} or @code{"auto"}. |
873 | |
6888 | 874 @item xticklabel |
875 @itemx yticklabel | |
876 @itemx zticklabel | |
6889 | 877 Setting one of these properties also forces the corresponding mode |
878 property to be set to @code{"manual"}. | |
879 | |
6888 | 880 @item xticklabelmode |
881 @itemx yticklabelmode | |
882 @itemx zticklabelmode | |
6889 | 883 Either @code{"manual"} or @code{"auto"}. |
884 | |
6888 | 885 @item xscale |
886 @itemx yscale | |
887 @itemx zscale | |
6889 | 888 Either @code{"linear"} or @code{"log"}. |
889 | |
6888 | 890 @item xdir |
891 @itemx ydir | |
892 @itemx zdir | |
6889 | 893 Either @code{"forward"} or @code{"reverse"}. |
894 | |
6888 | 895 @item xaxislocation |
896 @itemx yaxislocation | |
6889 | 897 Either @code{"top"} or @code{"bottom"} for the x axis and @code{"left"} |
898 or @code{"right"} for the y axis. | |
899 | |
6888 | 900 @item view |
6889 | 901 A three element vector specifying the view point for three-dimensional plots. |
902 | |
6888 | 903 @item visible |
6889 | 904 Either @code{"on"} or @code{"off"} to toggle display of the axes. |
905 | |
6888 | 906 @item nextplot |
6889 | 907 May be one of |
908 @table @code | |
909 @item "new" | |
910 @item "add" | |
911 @item "replace" | |
912 @item "replacechildren" | |
913 @end table | |
914 | |
6888 | 915 @item outerposition |
8071 | 916 A vector specifying the position of the plot, including titles, axes and |
917 legend. The four elements of the vector are the coordinates of the | |
918 lower left corner and width and height of the plot, in units normalized | |
919 to the width and height of the plot window. For example, @code{[0.2, | |
920 0.3, 0.4, 0.5]} sets the lower left corner of the axes at @math{(0.2, | |
921 0.3)} and the width and height to be 0.4 and 0.5 respectively. See also | |
922 the @code{position} property. | |
6888 | 923 @end table |
924 | |
925 @node Line Properties | |
926 @subsubsection Line Properties | |
8071 | 927 @cindex line properties |
6888 | 928 |
929 @table @code | |
930 @itemx xdata | |
931 @itemx ydata | |
932 @itemx zdata | |
933 @itemx ldata | |
934 @itemx udata | |
935 @itemx xldata | |
936 @itemx xudata | |
6889 | 937 The data to be plotted. The @code{ldata} and @code{udata} elements are |
8325
b93ac0586e4b
spelling corrections
Brian Gough<bjg@network-theory.co.uk>
parents:
8297
diff
changeset
|
938 for errorbars in the y direction, and the @code{xldata} and @code{xudata} |
6889 | 939 elements are for errorbars in the x direction. |
940 | |
6888 | 941 @item color |
6889 | 942 The RGB color of the line, or a color name. @xref{Colors}. |
943 | |
6888 | 944 @item linestyle |
6889 | 945 @itemx linewidth |
946 @xref{Line Styles}. | |
947 | |
6888 | 948 @item marker |
949 @item markeredgecolor | |
950 @item markerfacecolor | |
951 @item markersize | |
6889 | 952 @xref{Marker Styles}. |
953 | |
6888 | 954 @item keylabel |
6889 | 955 The text of the legend entry corresponding to this line. Note that this |
9088
77e71f3da3d6
Fix documentation image printing under new development code
Rik <rdrider0-list@yahoo.com>
parents:
9040
diff
changeset
|
956 property is not compatible with @sc{matlab} and may be removed in a |
6889 | 957 future version of Octave. |
6888 | 958 @end table |
959 | |
960 @node Text Properties | |
961 @subsubsection Text Properties | |
8071 | 962 @cindex text properties |
6888 | 963 |
964 @table @code | |
965 @item string | |
6889 | 966 The character string contained by the text object. |
967 | |
6888 | 968 @item units |
6889 | 969 May be @code{"normalized"} or @code{"graph"}. |
970 | |
6888 | 971 @item position |
6889 | 972 The coordinates of the text object. |
973 | |
6888 | 974 @item rotation |
6889 | 975 The angle of rotation for the displayed text, measured in degrees. |
976 | |
6888 | 977 @item horizontalalignment |
6889 | 978 May be @code{"left"}, @code{"center"}, or @code{"right"}. |
979 | |
6888 | 980 @item color |
6889 | 981 The color of the text. @xref{Colors}. |
7189 | 982 |
983 @item fontname | |
984 The font used for the text. | |
985 | |
986 @item fontsize | |
987 The size of the font, in points to use. | |
988 | |
989 @item fontangle | |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
990 Flag whether the font is italic or normal. Valid values are 'normal', |
7189 | 991 'italic' and 'oblique'. |
992 | |
993 @item fontweight | |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
994 Flag whether the font is bold, etc. Valid values are 'normal', 'bold', |
7189 | 995 'demi' or 'light'. |
996 | |
997 @item interpreter | |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
998 Determines how the text is rendered. Valid values are 'none', 'tex' or |
7189 | 999 'latex'. |
6888 | 1000 @end table |
1001 | |
7189 | 1002 All text objects, including titles, labels, legends, and text, include |
1003 the property 'interpreter', this property determines the manner in which | |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1004 special control sequences in the text are rendered. If the interpreter |
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1005 is set to 'none', then no rendering occurs. At this point the 'latex' |
7189 | 1006 option is not implemented and so the 'latex' interpreter also does not |
1007 interpret the text. | |
1008 | |
1009 The 'tex' option implements a subset of @sc{TeX} functionality in the | |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1010 rendering of the text. This allows the insertion of special characters |
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1011 such as Greek or mathematical symbols within the text. The special |
7189 | 1012 characters are also inserted with a code starting with the back-slash |
1013 (\) character, as in the table @ref{tab:extended}. | |
1014 | |
8325
b93ac0586e4b
spelling corrections
Brian Gough<bjg@network-theory.co.uk>
parents:
8297
diff
changeset
|
1015 In addition, the formatting of the text can be changed within the string |
7189 | 1016 with the codes |
1017 | |
1018 @multitable @columnfractions .2 .2 .6 .2 | |
1019 @item @tab \bf @tab Bold font @tab | |
1020 @item @tab \it @tab Italic font @tab | |
1021 @item @tab \sl @tab Oblique Font @tab | |
1022 @item @tab \rm @tab Normal font @tab | |
1023 @end multitable | |
1024 | |
1025 These are be used in conjunction with the @{ and @} characters to limit | |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1026 the change in the font to part of the string. For example |
7189 | 1027 |
1028 @example | |
1029 xlabel ('@{\bf H@} = a @{\bf V@}') | |
1030 @end example | |
1031 | |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1032 where the character 'a' will not appear in a bold font. Note that to |
7189 | 1033 avoid having Octave interpret the backslash characters in the strings, |
1034 the strings should be in single quotes. | |
1035 | |
1036 It is also possible to change the fontname and size within the text | |
1037 | |
1038 @multitable @columnfractions .1 .4 .6 .1 | |
1039 @item @tab \fontname@{@var{fontname}@} @tab Specify the font to use @tab | |
1040 @item @tab \fontsize@{@var{size}@} @tab Specify the size of the font to | |
1041 use @tab | |
1042 @end multitable | |
1043 | |
1044 Finally, the superscript and subscripting can be controlled with the '^' | |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1045 and '_' characters. If the '^' or '_' is followed by a @{ character, |
7189 | 1046 then all of the block surrounded by the @{ @} pair is super- or |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1047 sub-scripted. Without the @{ @} pair, only the character immediately |
7189 | 1048 following the '^' or '_' is super- or sub-scripted. |
1049 | |
1050 @float Table,tab:extended | |
1051 @iftex | |
1052 @tex | |
1053 \vskip 6pt | |
1054 {\hbox to \hsize {\hfill\vbox{\offinterlineskip \tabskip=0pt | |
1055 \halign{ | |
1056 \vrule height2.0ex depth1.ex width 0.6pt #\tabskip=0.3em & | |
1057 # \hfil & \vrule # & # \hfil & # \vrule & | |
1058 # \hfil & \vrule # & # \hfil & # \vrule & | |
1059 # \hfil & \vrule # & # \hfil & # \vrule | |
1060 width 0.6pt \tabskip=0pt\cr | |
1061 \noalign{\hrule height 0.6pt} | |
1062 & Code && Sym && Code && Sym && Code && Sym &\cr | |
1063 \noalign{\hrule} | |
7608
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1064 & $\backslash$forall && $\forall$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1065 && $\backslash$exists && $\exists$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1066 && $\backslash$ni && $\ni$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1067 & $\backslash$cong && $\cong$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1068 && $\backslash$Delta && $\Delta$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1069 && $\backslash$Phi && $\Phi$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1070 & $\backslash$Gamma && $\Gamma$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1071 && $\backslash$vartheta && $\vartheta$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1072 && $\backslash$Lambda && $\Lambda$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1073 & $\backslash$Pi && $\Pi$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1074 && $\backslash$Theta && $\Theta$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1075 && $\backslash$Sigma && $\Sigma$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1076 & $\backslash$varsigma && $\varsigma$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1077 && $\backslash$Omega && $\Omega$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1078 && $\backslash$Xi && $\Xi$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1079 & $\backslash$Psi && $\Psi$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1080 && $\backslash$perp && $\perp$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1081 && $\backslash$alpha && $\alpha$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1082 & $\backslash$beta && $\beta$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1083 && $\backslash$chi && $\chi$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1084 && $\backslash$delta && $\delta$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1085 & $\backslash$epsilon && $\epsilon$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1086 && $\backslash$phi && $\phi$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1087 && $\backslash$gamma && $\gamma$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1088 & $\backslash$eta && $\eta$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1089 && $\backslash$iota && $\iota$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1090 && $\backslash$varphi && $\varphi$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1091 & $\backslash$kappa && $\kappa$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1092 && $\backslash$lambda && $\lambda$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1093 && $\backslash$mu && $\mu$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1094 & $\backslash$nu && $\nu$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1095 && $\backslash$o && $\o$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1096 && $\backslash$pi && $\pi$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1097 & $\backslash$theta && $\theta$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1098 && $\backslash$rho && $\rho$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1099 && $\backslash$sigma && $\sigma$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1100 & $\backslash$tau && $\tau$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1101 && $\backslash$upsilon && $\upsilon$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1102 && $\backslash$varpi && $\varpi$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1103 & $\backslash$omega && $\omega$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1104 && $\backslash$xi && $\xi$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1105 && $\backslash$psi && $\psi$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1106 & $\backslash$zeta && $\zeta$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1107 && $\backslash$sim && $\sim$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1108 && $\backslash$Upsilon && $\Upsilon$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1109 & $\backslash$prime && $\prime$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1110 && $\backslash$leq && $\leq$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1111 && $\backslash$infty && $\infty$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1112 & $\backslash$clubsuit && $\clubsuit$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1113 && $\backslash$diamondsuit && $\diamondsuit$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1114 && $\backslash$heartsuit && $\heartsuit$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1115 & $\backslash$spadesuit && $\spadesuit$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1116 && $\backslash$leftrightarrow && $\leftrightarrow$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1117 && $\backslash$leftarrow && $\leftarrow$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1118 & $\backslash$uparrow && $\uparrow$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1119 && $\backslash$rightarrow && $\rightarrow$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1120 && $\backslash$downarrow && $\downarrow$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1121 & $\backslash$circ && $\circ$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1122 && $\backslash$pm && $\pm$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1123 && $\backslash$geq && $\geq$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1124 & $\backslash$times && $\times$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1125 && $\backslash$propto && $\propto$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1126 && $\backslash$partial && $\partial$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1127 & $\backslash$bullet && $\bullet$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1128 && $\backslash$div && $\div$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1129 && $\backslash$neq && $\neq$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1130 & $\backslash$equiv && $\equiv$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1131 && $\backslash$approx && $\approx$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1132 && $\backslash$ldots && $\ldots$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1133 & $\backslash$mid && $\mid$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1134 && $\backslash$aleph && $\aleph$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1135 && $\backslash$Im && $\Im$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1136 & $\backslash$Re && $\Re$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1137 && $\backslash$wp && $\wp$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1138 && $\backslash$otimes && $\otimes$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1139 & $\backslash$oplus && $\oplus$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1140 && $\backslash$oslash && $\oslash$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1141 && $\backslash$cap && $\cap$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1142 & $\backslash$cup && $\cup$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1143 && $\backslash$supset && $\supset$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1144 && $\backslash$supseteq && $\supseteq$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1145 & $\backslash$subset && $\subset$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1146 && $\backslash$subseteq && $\subseteq$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1147 && $\backslash$in && $\in$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1148 & $\backslash$notin && $\notin$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1149 && $\backslash$angle && $\angle$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1150 && $\backslash$bigtriangledown && $\bigtriangledown$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1151 & $\backslash$langle && $\langle$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1152 && $\backslash$rangle && $\rangle$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1153 && $\backslash$nabla && $\nabla$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1154 & $\backslash$prod && $\prod$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1155 && $\backslash$surd && $\surd$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1156 && $\backslash$cdot && $\cdot$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1157 & $\backslash$neg && $\neg$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1158 && $\backslash$wedge && $\wedge$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1159 && $\backslash$vee && $\vee$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1160 & $\backslash$Leftrightarrow && $\Leftrightarrow$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1161 && $\backslash$Leftarrow && $\Leftarrow$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1162 && $\backslash$Uparrow && $\Uparrow$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1163 & $\backslash$Rightarrow && $\Rightarrow$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1164 && $\backslash$Downarrow && $\Downarrow$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1165 && $\backslash$diamond && $\diamond$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1166 & $\backslash$copyright && $\copyright$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1167 && $\backslash$rfloor && $\rfloor$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1168 && $\backslash$lceil && $\lceil$ &\cr |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1169 & $\backslash$lfloor && $\lfloor$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1170 && $\backslash$rceil && $\rceil$ |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1171 && $\backslash$int && $\int$ &\cr |
7189 | 1172 \noalign{\hrule height 0.6pt} |
1173 }}\hfill}} | |
1174 @end tex | |
1175 @end iftex | |
1176 @ifnottex | |
1177 @multitable @columnfractions .125 .25 .25 .25 .125 | |
7608
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1178 @item @tab \forall @tab \exists @tab \ni @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1179 @item @tab \cong @tab \Delta @tab \Phi @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1180 @item @tab \Gamma @tab \vartheta @tab \Lambda @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1181 @item @tab \Pi @tab \Theta @tab \Sigma @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1182 @item @tab \varsigma @tab \Omega @tab \Xi @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1183 @item @tab \Psi @tab \perp @tab \alpha @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1184 @item @tab \beta @tab \chi @tab \delta @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1185 @item @tab \epsilon @tab \phi @tab \gamma @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1186 @item @tab \eta @tab \iota @tab \varphi @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1187 @item @tab \kappa @tab \lambda @tab \mu @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1188 @item @tab \nu @tab \o @tab \pi @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1189 @item @tab \theta @tab \rho @tab \sigma @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1190 @item @tab \tau @tab \upsilon @tab \varpi @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1191 @item @tab \omega @tab \xi @tab \psi @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1192 @item @tab \zeta @tab \sim @tab \Upsilon @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1193 @item @tab \prime @tab \leq @tab \infty @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1194 @item @tab \clubsuit @tab \diamondsuit @tab \heartsuit @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1195 @item @tab \spadesuit @tab \leftrightarrow @tab \leftarrow @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1196 @item @tab \uparrow @tab \rightarrow @tab \downarrow @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1197 @item @tab \circ @tab \pm @tab \geq @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1198 @item @tab \times @tab \propto @tab \partial @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1199 @item @tab \bullet @tab \div @tab \neq @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1200 @item @tab \equiv @tab \approx @tab \ldots @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1201 @item @tab \mid @tab \aleph @tab \Im @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1202 @item @tab \Re @tab \wp @tab \otimes @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1203 @item @tab \oplus @tab \oslash @tab \cap @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1204 @item @tab \cup @tab \supset @tab \supseteq @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1205 @item @tab \subset @tab \subseteq @tab \in @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1206 @item @tab \notin @tab \angle @tab \bigrightriangledown @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1207 @item @tab \langle @tab \rangle @tab \nabla @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1208 @item @tab \prod @tab \surd @tab \cdot @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1209 @item @tab \neg @tab \wedge @tab \vee @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1210 @item @tab \Leftrightarrow @tab \Leftarrow @tab \Uparrow @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1211 @item @tab \Rightarrow @tab \Downarrow @tab \diamond @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1212 @item @tab \copyright @tab \lfloor @tab \lceil @tab |
49810341db91
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1213 @item @tab \rfloor @tab \rceil @tab \int @tab |
7189 | 1214 @end multitable |
1215 @end ifnottex | |
1216 @caption{Available special characters in @sc{TeX} mode} | |
1217 @end float | |
1218 | |
1219 A complete example showing the capabilities of the extended text is | |
1220 | |
1221 @example | |
1222 @group | |
1223 x = 0:0.01:3; | |
1224 plot(x,erf(x)); | |
1225 hold on; | |
1226 plot(x,x,"r"); | |
1227 axis([0, 3, 0, 1]); | |
1228 text(0.65, 0.6175, strcat('\leftarrow x = @{2/\surd\pi', | |
1229 ' @{\fontsize@{16@}\int_@{\fontsize@{8@}0@}^@{\fontsize@{8@}x@}@}', | |
1230 ' e^@{-t^2@} dt@} = 0.6175')) | |
1231 @end group | |
1232 @end example | |
1233 | |
1234 @ifnotinfo | |
1235 @noindent | |
1236 The result of which can be seen in @ref{fig:extendedtext} | |
1237 | |
1238 @float Figure,fig:extendedtext | |
9088
77e71f3da3d6
Fix documentation image printing under new development code
Rik <rdrider0-list@yahoo.com>
parents:
9040
diff
changeset
|
1239 @center @image{extended,4in} |
7189 | 1240 @caption{Example of inclusion of text with the @sc{TeX} interpreter} |
1241 @end float | |
1242 @end ifnotinfo | |
1243 | |
6888 | 1244 @node Image Properties |
1245 @subsubsection Image Properties | |
8071 | 1246 @cindex image properties |
6888 | 1247 |
1248 @table @code | |
1249 @item cdata | |
6889 | 1250 The data for the image. Each pixel of the image corresponds to an |
1251 element of @code{cdata}. The value of an element of @code{cdata} | |
1252 specifies the row-index into the colormap of the axes object containing | |
1253 the image. The color value found in the color map for the given index | |
1254 determines the color of the pixel. | |
1255 | |
1256 @item xdata | |
6888 | 1257 @itemx ydata |
7001 | 1258 Two-element vectors specifying the range of the x- and y- coordinates for |
6889 | 1259 the image. |
6888 | 1260 @end table |
1261 | |
1262 @node Patch Properties | |
1263 @subsubsection Patch Properties | |
8071 | 1264 @cindex patch properties |
6888 | 1265 |
1266 @table @code | |
1267 @item cdata | |
1268 @itemx xdata | |
1269 @itemx ydata | |
1270 @itemx zdata | |
6889 | 1271 Data defining the patch object. |
1272 | |
6888 | 1273 @item facecolor |
6889 | 1274 The fill color of the patch. @xref{Colors}. |
1275 | |
6888 | 1276 @item facealpha |
6889 | 1277 A number in the range [0, 1] indicating the transparency of the patch. |
1278 | |
6888 | 1279 @item edgecolor |
6889 | 1280 The color of the line defining the patch. @xref{Colors}. |
1281 | |
6888 | 1282 @item linestyle |
6889 | 1283 @itemx linewidth |
1284 @xref{Line Styles}. | |
1285 | |
6888 | 1286 @item marker |
6889 | 1287 @itemx markeredgecolor |
1288 @itemx markerfacecolor | |
1289 @itemx markersize | |
1290 @xref{Marker Styles}. | |
6888 | 1291 @end table |
1292 | |
1293 @node Surface Properties | |
1294 @subsubsection Surface Properties | |
8071 | 1295 @cindex surface properties |
6888 | 1296 |
1297 @table @code | |
1298 @item xdata | |
1299 @itemx ydata | |
1300 @itemx zdata | |
6889 | 1301 The data determining the surface. The @code{xdata} and @code{ydata} |
1302 elements are vectors and @code{zdata} must be a matrix. | |
1303 | |
6888 | 1304 @item keylabel |
6889 | 1305 The text of the legend entry corresponding to this surface. Note that |
9088
77e71f3da3d6
Fix documentation image printing under new development code
Rik <rdrider0-list@yahoo.com>
parents:
9040
diff
changeset
|
1306 this property is not compatible with @sc{matlab} and may be removed in a |
6889 | 1307 future version of Octave. |
1308 @end table | |
1309 | |
8070
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1310 @node Searching Properties |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1311 @subsubsection Searching Properties |
7984
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
1312 |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
1313 @DOCSTRING(findobj) |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
1314 |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
1315 @DOCSTRING(findall) |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
1316 |
bbaa5d7d0143
Some documentation updates
David Bateman <dbateman@free.fr>
parents:
7981
diff
changeset
|
1317 |
6891 | 1318 @node Managing Default Properties |
1319 @subsection Managing Default Properties | |
8071 | 1320 @cindex default graphics properties |
1321 @cindex graphics properties, default | |
6891 | 1322 |
6892 | 1323 Object properties have two classes of default values, @dfn{factory |
1324 defaults} (the initial values) and @dfn{user-defined defaults}, which | |
1325 may override the factory defaults. | |
6891 | 1326 |
1327 Although default values may be set for any object, they are set in | |
1328 parent objects and apply to child objects. For example, | |
1329 | |
1330 @example | |
1331 set (0, "defaultlinecolor", "green"); | |
1332 @end example | |
1333 | |
1334 @noindent | |
1335 sets the default line color for all objects. The rule for constructing | |
1336 the property name to set a default value is | |
1337 | |
1338 @example | |
1339 default + @var{object-type} + @var{property-name} | |
1340 @end example | |
1341 | |
1342 This rule can lead to some strange looking names, for example | |
1343 @code{defaultlinelinewidth"} specifies the default @code{linewidth} | |
1344 property for @code{line} objects. | |
1345 | |
1346 The example above used the root figure object, 0, so the default | |
1347 property value will apply to all line objects. However, default values | |
1348 are hierarchical, so defaults set in a figure objects override those | |
1349 set in the root figure object. Likewise, defaults set in axes objects | |
1350 override those set in figure or root figure objects. For example, | |
1351 | |
1352 @example | |
1353 @group | |
1354 subplot (2, 1, 1); | |
1355 set (0, "defaultlinecolor", "red"); | |
1356 set (1, "defaultlinecolor", "green"); | |
1357 set (gca (), "defaultlinecolor", "blue"); | |
1358 line (1:10, rand (1, 10)); | |
1359 subplot (2, 1, 2); | |
1360 line (1:10, rand (1, 10)); | |
1361 figure (2) | |
1362 line (1:10, rand (1, 10)); | |
1363 @end group | |
1364 @end example | |
1365 | |
1366 @noindent | |
1367 produces two figures. The line in first subplot window of the first | |
1368 figure is blue because it inherits its color from its parent axes | |
1369 object. The line in the second subplot window of the first figure is | |
1370 green because it inherits its color from its parent figure object. The | |
1371 line in the second figure window is red because it inherits its color | |
1372 from the global root figure parent object. | |
1373 | |
1374 To remove a user-defined default setting, set the default property to | |
1375 the value @code{"remove"}. For example, | |
1376 | |
1377 @example | |
1378 set (gca (), "defaultlinecolor", "remove"); | |
1379 @end example | |
1380 | |
1381 @noindent | |
1382 removes the user-defined default line color setting from the current axes | |
1383 object. | |
1384 | |
1385 Getting the @code{"default"} property of an object returns a list of | |
1386 user-defined defaults set for the object. For example, | |
1387 | |
1388 @example | |
1389 get (gca (), "default"); | |
1390 @end example | |
1391 | |
1392 @noindent | |
1393 returns a list of user-defined default values for the current axes | |
1394 object. | |
1395 | |
1396 Factory default values are stored in the root figure object. The | |
1397 command | |
1398 | |
1399 @example | |
1400 get (0, "factory"); | |
1401 @end example | |
1402 | |
1403 @noindent | |
1404 returns a list of factory defaults. | |
1405 | |
6889 | 1406 @node Colors |
1407 @subsection Colors | |
8071 | 1408 @cindex graphics colors |
1409 @cindex colors, graphics | |
6889 | 1410 |
1411 Colors may be specified as RGB triplets with values ranging from zero to | |
1412 one, or by name. Recognized color names include @code{"blue"}, | |
1413 @code{"black"}, @code{"cyan"}, @code{"green"}, @code{"magenta"}, | |
1414 @code{"red"}, @code{"white"}, and @code{"yellow"}. | |
1415 | |
1416 @node Line Styles | |
1417 @subsection Line Styles | |
8071 | 1418 @cindex line styles, graphics |
1419 @cindex graphics line styles | |
1420 | |
7001 | 1421 Line styles are specified by the following properties: |
6889 | 1422 |
1423 @table @code | |
1424 @item linestyle | |
1425 May be one of | |
1426 @table @code | |
1427 @item "-" | |
1428 Solid lines. | |
1429 @item "--" | |
1430 Dashed lines. | |
1431 @item ":" | |
1432 Points. | |
1433 @item "-." | |
1434 A dash-dot line. | |
1435 @end table | |
1436 | |
1437 @item linewidth | |
1438 A number specifying the width of the line. The default is 1. A value | |
1439 of 2 is twice as wide as the default, etc. | |
1440 @end table | |
1441 | |
1442 @node Marker Styles | |
1443 @subsection Marker Styles | |
8071 | 1444 @cindex graphics marker styles |
1445 @cindex marker styles, graphics | |
1446 | |
7001 | 1447 Marker styles are specified by the following properties: |
6889 | 1448 @table @code |
1449 @item marker | |
1450 A character indicating a plot marker to be place at each data point, or | |
1451 @code{"none"}, meaning no markers should be displayed. | |
1452 | |
1453 @itemx markeredgecolor | |
1454 The color of the edge around the marker, or @code{"auto"}, meaning that | |
1455 the edge color is the same as the face color. @xref{Colors}. | |
1456 | |
1457 @itemx markerfacecolor | |
1458 The color of the marker, or @code{"none"} to indicate that the marker | |
1459 should not be filled. @xref{Colors}. | |
1460 | |
1461 @itemx markersize | |
1462 A number specifying the size of the marker. The default is 1. A value | |
1463 of 2 is twice as large as the default, etc. | |
6888 | 1464 @end table |
1465 | |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1466 @node Callbacks |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1467 @subsection Callbacks |
8071 | 1468 @cindex callbacks |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1469 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1470 Callback functions can be associated with graphics objects and triggered |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1471 after certain events occur. The basic structure of all callback function |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1472 is |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1473 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1474 @example |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1475 @group |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1476 function mycallback (src, data) |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1477 @dots{} |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1478 endfunction |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1479 @end group |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1480 @end example |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1481 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1482 where @code{src} gives a handle to the source of the callback, and |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1483 @code{code} gives some event specific data. This can then be associated |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1484 with an object either at the objects creation or later with the |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1485 @code{set} function. For example |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1486 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1487 @example |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1488 plot (x, "DeleteFcn", @@(s, e) disp("Window Deleted")) |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1489 @end example |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1490 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1491 @noindent |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1492 where at the moment that the plot is deleted, the message "Window |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1493 Deleted" will be displayed. |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1494 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1495 Additional user arguments can be passed to callback functions, and will |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1496 be passed after the 2 default arguments. For example |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1497 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1498 @example |
9088
77e71f3da3d6
Fix documentation image printing under new development code
Rik <rdrider0-list@yahoo.com>
parents:
9040
diff
changeset
|
1499 @group |
8057 | 1500 plot (x, "DeleteFcn", @{@@mycallback, "1"@}) |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1501 @dots{} |
8057 | 1502 function mycallback (src, data, a1) |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1503 fprintf ("Closing plot %d\n", a1); |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1504 endfunction |
9088
77e71f3da3d6
Fix documentation image printing under new development code
Rik <rdrider0-list@yahoo.com>
parents:
9040
diff
changeset
|
1505 @end group |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1506 @end example |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1507 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1508 The basic callback functions that are available for all graphics objects |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1509 are |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1510 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1511 @itemize @bullet |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1512 @item CreateFcn |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1513 This is the callback that is called at the moment of the objects |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1514 creation. It is not called if the object is altered in any way, and so |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1515 it only makes sense to define this callback in the function call that |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1516 defines the object. Callbacks that are added to @code{CreateFcn} later with |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1517 the @code{set} function will never be executed. |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1518 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1519 @item DeleteFcn |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1520 This is the callback that is called at the moment an object is deleted. |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1521 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1522 @item ButtonDownFcn |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1523 This is the callback that is called if a mouse button is pressed while |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1524 the pointer is over this object. Note, that the gnuplot interface does |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1525 not respect this callback. |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1526 @end itemize |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1527 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1528 The object and figure that the event occurred in that resulted in the |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1529 callback being called can be found with the @code{gcbo} and @code{gcbf} |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1530 functions. |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1531 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1532 @DOCSTRING(gcbo) |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1533 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1534 @DOCSTRING(gcbf) |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1535 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1536 Callbacks can equally be added to properties with the @code{addlistener} |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1537 function described below. |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1538 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1539 @node Object Groups |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1540 @subsection Object Groups |
8071 | 1541 @cindex object groups |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1542 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1543 A number of Octave high level plot functions return groups of other |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1544 graphics objects or they return graphics objects that are have their |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1545 properties linked in such a way that changes to one of the properties |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1546 results in changes in the others. A graphic object that groups other |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1547 objects is an @code{hggroup} |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1548 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1549 @DOCSTRING(hggroup) |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1550 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1551 For example a simple use of a @code{hggroup} might be |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1552 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1553 @example |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1554 @group |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1555 x = 0:0.1:10; |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1556 hg = hggroup (); |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1557 plot (x, sin (x), "color", [1, 0, 0], "parent", hg); |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1558 hold on |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1559 plot (x, cos (x), "color", [0, 1, 0], "parent", hg); |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1560 set (hg, "visible", "off"); |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1561 @end group |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1562 @end example |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1563 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1564 @noindent |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1565 which groups the two plots into a single object and controls their |
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1566 visibility directly. The default properties of an @code{hggroup} are |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1567 the same as the set of common properties for the other graphics |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1568 objects. Additional properties can be added with the @code{addproperty} |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1569 function. |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1570 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1571 @DOCSTRING(addproperty) |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1572 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1573 Once a property in added to an @code{hggroup}, it is not linked to any |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1574 other property of either the children of the group, or any other |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1575 graphics object. Add so to control the way in which this newly added |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1576 property is used, the @code{addlistener} function is used to define a |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1577 callback function that is executed when the property is altered. |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1578 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1579 @DOCSTRING(addlistener) |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1580 |
8817
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
1581 @DOCSTRING(dellistener) |
03b7f618ab3d
include docstrings for new functions in the manual
John W. Eaton <jwe@octave.org>
parents:
8519
diff
changeset
|
1582 |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1583 An example of the use of these two functions might be |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1584 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1585 @example |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1586 @group |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1587 x = 0:0.1:10; |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1588 hg = hggroup (); |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1589 h = plot (x, sin (x), "color", [1, 0, 0], "parent", hg); |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1590 addproperty ("linestyle", hg, "linelinestyle", get (h, "linestyle")); |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1591 addlistener (hg, "linestyle", @@update_props); |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1592 hold on |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1593 plot (x, cos (x), "color", [0, 1, 0], "parent", hg); |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1594 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1595 function update_props (h, d) |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1596 set (get (h, "children"), "linestyle", get (h, "linestyle")); |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1597 endfunction |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1598 @end group |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1599 @end example |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1600 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1601 @noindent |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1602 that adds a @code{linestyle} property to the @code{hggroup} and |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1603 propagating any changes its value to the children of the group. The |
8070
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1604 @code{linkprop} function can be used to simplify the above to be |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1605 |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1606 @example |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1607 @group |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1608 x = 0:0.1:10; |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1609 hg = hggroup (); |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1610 h1 = plot (x, sin (x), "color", [1, 0, 0], "parent", hg); |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1611 addproperty ("linestyle", hg, "linelinestyle", get (h, "linestyle")); |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1612 hold on |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1613 h2 = plot (x, cos (x), "color", [0, 1, 0], "parent", hg); |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1614 hlink = linkprop ([hg, h1, h2], "color"); |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1615 @end group |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1616 @end example |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1617 |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1618 @DOCSTRING(linkprop) |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1619 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1620 These capabilities are used in a number of basic graphics objects. |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1621 The @code{hggroup} objects created by the functions of Octave contain |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1622 one or more graphics object and are used to: |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1623 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1624 @itemize @bullet |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1625 @item group together multiple graphics objects, |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1626 @item create linked properties between different graphics objects, and |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1627 @item to hide the nominal user data, from the actual data of the objects. |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1628 @end itemize |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1629 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1630 @noindent |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1631 For example the @code{stem} function creates a stem series where each |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1632 @code{hggroup} of the stem series contains two line objects representing |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1633 the body and head of the stem. The @code{ydata} property of the |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1634 @code{hggroup} of the stem series represents the head of the stem, |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1635 whereas the body of the stem is between the baseline and this value. For |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1636 example |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1637 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1638 @example |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1639 @group |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1640 h = stem (1:4) |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1641 get (h, "xdata") |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1642 @result{} [ 1 2 3 4]' |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1643 get (get (h, "children")(1), "xdata") |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1644 @result{} [ 1 1 NaN 2 2 NaN 3 3 NaN 4 4 NaN]' |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1645 @end group |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1646 @end example |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1647 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1648 @noindent |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1649 shows the difference between the @code{xdata} of the @code{hggroup} |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1650 of a stem series object and the underlying line. |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1651 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1652 The basic properties of such group objects is that they consist of one |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1653 or more linked @code{hggroup}, and that changes in certain properties of |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1654 these groups are propagated to other members of the group. Whereas, |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1655 certain properties of the members of the group only apply to the current |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1656 member. |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1657 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1658 In addition the members of the group can also be linked to other |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1659 graphics objects through callback functions. For example the baseline of |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1660 the @code{bar} or @code{stem} functions is a line object, whose length |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1661 and position are automatically adjusted, based on changes to the |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1662 corresponding hggroup elements. |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1663 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1664 @menu |
8070
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1665 * Data sources in object groups:: |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1666 * Area series:: |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1667 * Bar series:: |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1668 * Contour groups:: |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1669 * Error bar series:: |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1670 * Line series:: |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1671 * Quiver group:: |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1672 * Scatter group:: |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1673 * Stair group:: |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1674 * Stem Series:: |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1675 * Surface group:: |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1676 @end menu |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1677 |
8070
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1678 @node Data sources in object groups |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1679 @subsubsection Data sources in object groups |
8071 | 1680 @cindex data sources in object groups |
8070
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1681 |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1682 All of the group objects contain data source parameters. There are |
8070
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1683 string parameters that contain an expression that is evaluated to update |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1684 the relevant data property of the group when the @code{refreshdata} |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1685 function is called. |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1686 |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1687 @DOCSTRING(refreshdata) |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1688 |
8286
6f2d95255911
fix @seealso references to point to existing anchors
Thorsten Meyer <thorsten.meyier@gmx.de>
parents:
8261
diff
changeset
|
1689 @anchor{doc-linkdata} |
8070
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1690 @c add the description of the linkdata function here when it is written |
8286
6f2d95255911
fix @seealso references to point to existing anchors
Thorsten Meyer <thorsten.meyier@gmx.de>
parents:
8261
diff
changeset
|
1691 @c remove the explicit anchor when you add the corresponding @DOCSTRING |
6f2d95255911
fix @seealso references to point to existing anchors
Thorsten Meyer <thorsten.meyier@gmx.de>
parents:
8261
diff
changeset
|
1692 @c command |
8070
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1693 |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1694 @node Area series |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1695 @subsubsection Area series |
8071 | 1696 @cindex series objects |
1697 @cindex area series | |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1698 |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1699 Area series objects are created by the @code{area} function. Each of the |
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1700 @code{hggroup} elements contains a single patch object. The properties |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1701 of the area series are |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1702 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1703 @table @code |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1704 @item basevalue |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1705 The value where the base of the area plot is drawn. |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1706 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1707 @item linewidth |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1708 @itemx linestyle |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1709 The line width and style of the edge of the patch objects making up the |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1710 areas. @xref{Line Styles}. |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1711 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1712 @item edgecolor |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1713 @itemx facecolor |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1714 The line and fill color of the patch objects making up the areas. @xref{Colors}. |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1715 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1716 @item xdata |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1717 @itemx ydata |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1718 The x and y coordinates of the original columns of the data passed to |
8325
b93ac0586e4b
spelling corrections
Brian Gough<bjg@network-theory.co.uk>
parents:
8297
diff
changeset
|
1719 @code{area} prior to the cumulative summation used in the @code{area} |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1720 function. |
8070
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1721 |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1722 @item xdatasource |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1723 @itemx ydatasource |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1724 Data source variables. |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1725 @end table |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1726 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1727 @node Bar series |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1728 @subsubsection Bar series |
8071 | 1729 @cindex series objects |
1730 @cindex bar series | |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1731 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1732 Bar series objects are created by the @code{bar} or @code{barh} |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1733 functions. Each @code{hggroup} element contains a single patch object. |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1734 The properties of the bar series are |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1735 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1736 @table @code |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1737 @item showbaseline |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1738 @itemx baseline |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1739 @itemx basevalue |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1740 The property @code{showbaseline} flags whether the baseline of the bar |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1741 series is displayed (default is "on"). The handle of the graphics object |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1742 representing the baseline is given by the @code{baseline} property and |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1743 the y-value of the baseline by the @code{basevalue} property. |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1744 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1745 Changes to any of these property are propagated to the other members of |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1746 the bar series and to the baseline itself. Equally changes in the |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1747 properties of the base line itself are propagated to the members of the |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1748 corresponding bar series. |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1749 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1750 @item barwidth |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1751 @itemx barlayout |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1752 @itemx horizontal |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1753 The property @code{barwidth} is the width of the bar corresponding to |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1754 the @var{width} variable passed to @code{bar} or @var{barh}. Whether the |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1755 bar series is "grouped" or "stacked" is determined by the |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1756 @code{barlayout} property and whether the bars are horizontal or |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1757 vertical by the @code{horizontal} property. |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1758 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1759 Changes to any of these property are propagated to the other members of |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1760 the bar series. |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1761 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1762 @item linewidth |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1763 @itemx linestyle |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1764 The line width and style of the edge of the patch objects making up the |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1765 bars. @xref{Line Styles}. |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1766 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1767 @item edgecolor |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1768 @itemx facecolor |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1769 The line and fill color of the patch objects making up the bars. @xref{Colors}. |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1770 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1771 @item xdata |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1772 The nominal x positions of the bars. Changes in this property and |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1773 propagated to the other members of the bar series. |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1774 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1775 @item ydata |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1776 The y value of the bars in the @code{hggroup}. |
8070
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1777 |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1778 @item xdatasource |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1779 @itemx ydatasource |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1780 Data source variables. |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1781 @end table |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1782 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1783 @node Contour groups |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1784 @subsubsection Contour groups |
8071 | 1785 @cindex series objects |
1786 @cindex contour series | |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1787 |
8289
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1788 Contour group objects are created by the @code{contour}, @code{contourf} |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1789 and @code{contour3} functions. The are equally one of the handles returned |
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1790 by the @code{surfc} and @code{meshc} functions. The properties of the contour |
8289
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1791 group are |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1792 |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1793 @table @code |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1794 @item contourmatrix |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1795 A read only property that contains the data return by @code{contourc} used to |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1796 create the contours of the plot. |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1797 |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1798 @item fill |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1799 A radio property that can have the values "on" or "off" that flags whether the |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1800 contours to plot are to be filled. |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1801 |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1802 @item zlevelmode |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1803 @itemx zlevel |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1804 The radio property @code{zlevelmode} can have the values "none", "auto" or |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1805 "manual". When its value is "none" there is no z component to the plotted |
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1806 contours. When its value is "auto" the z value of the plotted contours is |
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1807 at the same value as the contour itself. If the value is "manual", then the |
8289
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1808 z value at which to plot the contour is determined by the @code{zlevel} |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1809 property. |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1810 |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1811 @item levellistmode |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1812 @itemx levellist |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1813 @itemx levelstepmode |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1814 @itemx levelstep |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1815 If @code{levellistmode} is "manual", then the levels at which to plot the |
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1816 contours is determined by @code{levellist}. If @code{levellistmode} is |
8289
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1817 set to "auto", then the distance between contours is determined by |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1818 @code{levelstep}. If both @code{levellistmode} and @code{levelstepmode} |
8289
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1819 are set to "auto", then there are assumed to be 10 equal spaced contours. |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1820 |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1821 @item textlistmode |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1822 @itemx textlist |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1823 @itemx textstepmode |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1824 @itemx textstep |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1825 If @code{textlistmode} is "manual", then the labelled contours |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1826 is determined by @code{textlist}. If @code{textlistmode} is set to |
8289
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1827 "auto", then the distance between labelled contours is determined by |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1828 @code{textstep}. If both @code{textlistmode} and @code{textstepmode} |
8289
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1829 are set to "auto", then there are assumed to be 10 equal spaced |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1830 labelled contours. |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1831 |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1832 @item showtext |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1833 Flag whether the contour labels are shown or not. |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1834 |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1835 @item labelspacing |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1836 The distance between labels on a single contour in points. |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1837 |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1838 @item linewidth |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1839 @item linestyle |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1840 @item linecolor |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1841 The properties of the contour lines. The properties @code{linewidth} and |
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1842 @code{linestyle} are similar to the corresponding properties for lines. The |
8297 | 1843 property @code{linecolor} is a color property (@pxref{Colors}), that can also |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1844 have the values of "none" or "auto". If @code{linecolor} is "none", then no |
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1845 contour line is drawn. If @code{linecolor} is "auto" then the line color is |
8289
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1846 determined by the colormap. |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1847 |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1848 @item xdata |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1849 @itemx ydata |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1850 @itemx zdata |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1851 The original x, y, and z data of the contour lines. |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1852 |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1853 @item xdatasource |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1854 @itemx ydatasource |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1855 @itemx zdatasource |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1856 Data source variables. |
ac7f334d9652
Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
8286
diff
changeset
|
1857 @end table |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1858 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1859 @node Error bar series |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1860 @subsubsection Error bar series |
8071 | 1861 @cindex series objects |
1862 @cindex error bar series | |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1863 |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1864 Error bar series are created by the @code{errorbar} function. Each |
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1865 @code{hggroup} element contains two line objects representing the data and |
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1866 the errorbars separately. The properties of the error bar series are |
8258 | 1867 |
1868 @table @code | |
1869 @item color | |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1870 The RGB color or color name of the line objects of the error bars. @xref{Colors}. |
8258 | 1871 |
1872 @item linewidth | |
1873 @itemx linestyle | |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1874 The line width and style of the line objects of the error bars. @xref{Line Styles}. |
8258 | 1875 |
1876 @item marker | |
1877 @itemx markeredgecolor | |
1878 @itemx markerfacecolor | |
1879 @itemx markersize | |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1880 The line and fill color of the markers on the error bars. @xref{Colors}. |
8258 | 1881 |
1882 @item xdata | |
1883 @itemx ydata | |
1884 @itemx ldata | |
1885 @itemx udata | |
1886 @itemx xldata | |
1887 @itemx xudata | |
1888 The original x, y, l, u, xl, xu data of the error bars. | |
1889 | |
1890 @item xdatasource | |
1891 @itemx ydatasource | |
1892 @itemx ldatasource | |
1893 @itemx udatasource | |
1894 @itemx xldatasource | |
1895 @itemx xudatasource | |
1896 Data source variables. | |
1897 @end table | |
1898 | |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1899 @node Line series |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1900 @subsubsection Line series |
8071 | 1901 @cindex series objects |
1902 @cindex line series | |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1903 |
8257 | 1904 Line series objects are created by the @code{plot} and @code{plot3} |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1905 functions and are of the type @code{line}. The properties of the |
8257 | 1906 line series with the ability to add data sources. |
8070
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1907 |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1908 @table @code |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1909 @item color |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1910 The RGB color or color name of the line objects. @xref{Colors}. |
8070
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1911 |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1912 @item linewidth |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1913 @itemx linestyle |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1914 The line width and style of the line objects. @xref{Line Styles}. |
8070
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1915 |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1916 @item marker |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1917 @itemx markeredgecolor |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1918 @itemx markerfacecolor |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1919 @itemx markersize |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1920 The line and fill color of the markers. @xref{Colors}. |
8070
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1921 |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1922 @item xdata |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1923 @itemx ydata |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1924 @itemx zdata |
8257 | 1925 The original x, y and z data. |
8070
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1926 |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1927 @item xdatasource |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1928 @itemx ydatasource |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1929 @itemx zdatasource |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1930 Data source variables. |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1931 @end table |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1932 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1933 @node Quiver group |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1934 @subsubsection Quiver group |
8071 | 1935 @cindex group objects |
1936 @cindex quiver group | |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1937 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1938 Quiver series objects are created by the @code{quiver} or @code{quiver3} |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1939 functions. Each @code{hggroup} element of the series contains three line |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1940 objects as children representing the body and head of the arrow, |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1941 together with a marker as the point of original of the arrows. The |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1942 properties of the quiver series are |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1943 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1944 @table @code |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1945 @item autoscale |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1946 @itemx autoscalefactor |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1947 Flag whether the length of the arrows is scaled or defined directly from |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1948 the @var{u}, @var{v} and @var{w} data. If the arrow length is flagged |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1949 as being scaled by the @code{autoscale} property, then the length of the |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1950 autoscaled arrow is controlled by the @code{autoscalefactor}. |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1951 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1952 @item maxheadsize |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1953 This property controls the size of the head of the arrows in the quiver |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1954 series. The default value is 0.2. |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1955 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1956 @item showarrowhead |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1957 Flag whether the arrow heads are displayed in the quiver plot. |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1958 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1959 @item color |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1960 The RGB color or color name of the line objects of the quiver. @xref{Colors}. |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1961 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1962 @item linewidth |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1963 @itemx linestyle |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1964 The line width and style of the line objects of the quiver. @xref{Line Styles}. |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1965 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1966 @item marker |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1967 @itemx markerfacecolor |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1968 @itemx markersize |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1969 The line and fill color of the marker objects at the original of the |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1970 arrows. @xref{Colors}. |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1971 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1972 @item xdata |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1973 @itemx ydata |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1974 @itemx zdata |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1975 The origins of the values of the vector field. |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1976 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1977 @item udata |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1978 @itemx vdata |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1979 @itemx wdata |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1980 The values of the vector field to plot. |
8070
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1981 |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1982 @item xdatasource |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1983 @itemx ydatasource |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1984 @itemx zdatasource |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1985 @itemx udatasource |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1986 @itemx vdatasource |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1987 @itemx wdatasource |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
1988 Data source variables. |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1989 @end table |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1990 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1991 @node Scatter group |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1992 @subsubsection Scatter group |
8071 | 1993 @cindex group objects |
1994 @cindex scatter group | |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
1995 |
8257 | 1996 Scatter series objects are created by the @code{scatter} or @code{scatter3} |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
1997 functions. A single hggroup element contains as many children as there are |
8257 | 1998 points in the scatter plot, with each child representing one of the points. |
1999 The properties of the stem series are | |
2000 | |
2001 @table @code | |
2002 @item linewidth | |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
2003 The line width of the line objects of the points. @xref{Line Styles}. |
8257 | 2004 |
2005 @item marker | |
2006 @itemx markeredgecolor | |
2007 @itemx markerfacecolor | |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
2008 The line and fill color of the markers of the points. @xref{Colors}. |
8257 | 2009 |
2010 @item xdata | |
2011 @itemx ydata | |
2012 @itemx zdata | |
2013 The original x, y and z data of the stems. | |
2014 | |
2015 @item cdata | |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
2016 The color data for the points of the plot. Each point can have a separate |
8257 | 2017 color, or a unique color can be specified. |
2018 | |
2019 @item sizedata | |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
2020 The size data for the points of the plot. Each point can its own size or a |
8257 | 2021 unique size can be specified. |
2022 | |
2023 @item xdatasource | |
2024 @itemx ydatasource | |
2025 @itemx zdatasource | |
2026 @itemx cdatasource | |
2027 @itemx sizedatasource | |
2028 Data source variables. | |
2029 @end table | |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2030 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2031 @node Stair group |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2032 @subsubsection Stair group |
8071 | 2033 @cindex group objects |
2034 @cindex stair group | |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2035 |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
2036 Stair series objects are created by the @code{stair} function. Each |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2037 @code{hggroup} element of the series contains a single line object as a |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
2038 child representing the stair. The properties of the stair series are |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2039 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2040 @table @code |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2041 @item color |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
2042 The RGB color or color name of the line objects of the stairs. @xref{Colors}. |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2043 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2044 @item linewidth |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2045 @itemx linestyle |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
2046 The line width and style of the line objects of the stairs. @xref{Line Styles}. |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2047 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2048 @item marker |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2049 @itemx markeredgecolor |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2050 @itemx markerfacecolor |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2051 @itemx markersize |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
2052 The line and fill color of the markers on the stairs. @xref{Colors}. |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2053 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2054 @item xdata |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2055 @itemx ydata |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2056 The original x and y data of the stairs. |
8070
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
2057 |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
2058 @item xdatasource |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
2059 @itemx ydatasource |
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
2060 Data source variables. |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2061 @end table |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2062 |
8073 | 2063 @node Stem Series |
2064 @subsubsection Stem Series | |
2065 @cindex series objects | |
2066 @cindex stem series | |
2067 | |
8257 | 2068 Stem series objects are created by the @code{stem} or @code{stem3} |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
2069 functions. Each @code{hggroup} element contains a single line object |
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
2070 as a child representing the stems. The properties of the stem series |
8257 | 2071 are |
2072 | |
2073 @table @code | |
2074 @item showbaseline | |
2075 @itemx baseline | |
2076 @itemx basevalue | |
2077 The property @code{showbaseline} flags whether the baseline of the | |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
2078 stem series is displayed (default is "on"). The handle of the graphics |
8257 | 2079 object representing the baseline is given by the @code{baseline} |
2080 property and the y-value (or z-value for @code{stem3}) of the baseline | |
2081 by the @code{basevalue} property. | |
2082 | |
2083 Changes to any of these property are propagated to the other members of | |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
2084 the stem series and to the baseline itself. Equally changes in the |
8257 | 2085 properties of the base line itself are propagated to the members of the |
2086 corresponding stem series. | |
2087 | |
2088 @item color | |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
2089 The RGB color or color name of the line objects of the stems. @xref{Colors}. |
8257 | 2090 |
2091 @item linewidth | |
2092 @itemx linestyle | |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
2093 The line width and style of the line objects of the stems. @xref{Line Styles}. |
8257 | 2094 |
2095 @item marker | |
2096 @itemx markeredgecolor | |
2097 @itemx markerfacecolor | |
2098 @itemx markersize | |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
2099 The line and fill color of the markers on the stems. @xref{Colors}. |
8257 | 2100 |
2101 @item xdata | |
2102 @itemx ydata | |
2103 @itemx zdata | |
2104 The original x, y and z data of the stems. | |
2105 | |
2106 @item xdatasource | |
2107 @itemx ydatasource | |
2108 @itemx zdatasource | |
2109 Data source variables. | |
2110 @end table | |
8073 | 2111 |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2112 @node Surface group |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2113 @subsubsection Surface group |
8071 | 2114 @cindex group objects |
2115 @cindex surface group | |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2116 |
8257 | 2117 Surface group objects are created by the @code{surf} or @code{mesh} |
2118 functions, but are equally one of the handles returned by the @code{surfc} | |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
2119 or @code{meshc} functions. The surface group is of the type @code{surface}. |
8257 | 2120 |
2121 The properties of the surface group are | |
2122 | |
2123 @table @code | |
2124 @item edgecolor | |
2125 @item facecolor | |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
2126 The RGB color or color name of the edges or faces of the surface. @xref{Colors}. |
8257 | 2127 |
2128 @item linewidth | |
2129 @itemx linestyle | |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
2130 The line width and style of the lines on the surface. @xref{Line Styles}. |
8257 | 2131 |
2132 @item marker | |
2133 @itemx markeredgecolor | |
2134 @itemx markerfacecolor | |
2135 @itemx markersize | |
9040
dbd0c77e575e
Cleanup documentation file plot.texi
Rik <rdrider0-list@yahoo.com>
parents:
9032
diff
changeset
|
2136 The line and fill color of the markers on the surface. @xref{Colors}. |
8257 | 2137 |
2138 @item xdata | |
2139 @itemx ydata | |
2140 @itemx zdata | |
2141 @item cdata | |
2142 The original x, y, z and c data. | |
2143 | |
2144 @item xdatasource | |
2145 @itemx ydatasource | |
2146 @itemx zdatasource | |
2147 @itemx cdatasource | |
2148 Data source variables. | |
2149 @end table | |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2150 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2151 @node Graphics backends |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2152 @subsection Graphics backends |
8071 | 2153 @cindex graphics backends |
2154 @cindex backends, graphics | |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2155 |
8519 | 2156 @DOCSTRING(backend) |
8070
3b53b25e2550
Add data sources and line series
David Bateman <dbateman@free.fr>
parents:
8057
diff
changeset
|
2157 |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2158 @DOCSTRING(available_backends) |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2159 |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2160 @menu |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2161 * Interaction with gnuplot:: |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2162 @end menu |
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2163 |
4167 | 2164 @node Interaction with gnuplot |
8056
9a6f4713f765
Add area, bar, quiver and stair series graphics objects. Document them
David Bateman <dbateman@free.fr>
parents:
8055
diff
changeset
|
2165 @subsubsection Interaction with @code{gnuplot} |
8071 | 2166 @cindex gnuplot interaction |
3428 | 2167 |
2168 @DOCSTRING(gnuplot_binary) |