Mercurial > octave-nkf
annotate doc/interpreter/plot.txi @ 11878:2415586d0f5a release-3-0-x
doc fixes
| author | John W. Eaton <jwe@octave.org> |
|---|---|
| date | Sun, 12 Oct 2008 19:38:43 +0200 |
| parents | 233de4b9b259 |
| children | 3342d1a7c4c9 |
| rev | line source |
|---|---|
| 7018 | 1 @c Copyright (C) 1996, 1997, 1999, 2000, 2002, 2003, 2004, 2005, |
| 11740 | 2 @c 2006, 2007, 2008 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 | |
| 6888 | 26 * Plotting Basics:: |
| 27 * Advanced Plotting:: | |
| 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:: |
| 45 * Test Plotting Functions:: | |
| 3294 | 46 @end menu |
| 47 | |
| 6888 | 48 @node Two-Dimensional Plots |
| 49 @subsection Two-Dimensional Plots | |
| 50 | |
| 51 The @code{plot} function allows you to create simple x-y plots with | |
| 52 linear axes. For example, | |
| 3294 | 53 |
| 6888 | 54 @example |
| 55 @group | |
| 56 x = -10:0.1:10; | |
| 57 plot (x, sin (x)); | |
| 58 @end group | |
| 59 @end example | |
| 60 | |
| 61 @noindent | |
| 6899 | 62 displays a sine wave shown in @ref{fig:plot}. On most systems, this |
| 6888 | 63 command will open a separate plot window to display the graph. |
| 5134 | 64 |
| 6888 | 65 @float Figure,fig:plot |
| 66 @image{plot,8cm} | |
| 67 @caption{Simple Two-Dimensional Plot.} | |
| 68 @end float | |
| 69 | |
| 70 The function @code{fplot} also generates two-dimensional plots with | |
| 71 linear axes using a function name and limits for the range of the | |
| 72 x-coordinate instead of the x and y data. For example, | |
| 5134 | 73 |
| 6888 | 74 @example |
| 75 @group | |
| 76 fplot (@@sin, [-10, 10], 201); | |
| 77 @end group | |
| 78 @end example | |
| 79 | |
| 80 @noindent | |
| 81 produces a plot that is equivalent to the one above, but also includes a | |
| 82 legend displaying the name of the plotted function. | |
| 6502 | 83 |
| 5134 | 84 @DOCSTRING(plot) |
| 85 | |
| 6502 | 86 @DOCSTRING(fplot) |
| 87 | |
| 6888 | 88 The functions @code{semilogx}, @code{semilogy}, and @code{loglog} are |
| 89 similar to the @code{plot} function, but produce plots in which one or | |
| 90 both of the axes use log scales. | |
| 91 | |
| 92 @DOCSTRING(semilogx) | |
| 6502 | 93 |
| 6888 | 94 @DOCSTRING(semilogy) |
| 6502 | 95 |
| 6888 | 96 @DOCSTRING(loglog) |
| 97 | |
| 98 The functions @code{bar}, @code{barh}, @code{stairs}, and @code{stem} | |
| 99 are useful for displaying discrete data. For example, | |
| 5134 | 100 |
| 6888 | 101 @example |
| 102 @group | |
| 103 hist (randn (10000, 1), 30); | |
| 104 @end group | |
| 105 @end example | |
| 5134 | 106 |
| 6888 | 107 @noindent |
| 108 produces the histogram of 10,000 normally distributed random numbers | |
| 6899 | 109 shown in @ref{fig:hist}. |
| 5134 | 110 |
| 6888 | 111 @float Figure,fig:hist |
| 112 @image{hist,8cm} | |
| 113 @caption{Histogram.} | |
| 114 @end float | |
| 5134 | 115 |
| 116 @DOCSTRING(bar) | |
| 117 | |
| 6877 | 118 @DOCSTRING(barh) |
| 119 | |
| 6888 | 120 @DOCSTRING(hist) |
| 121 | |
| 122 @DOCSTRING(stairs) | |
| 123 | |
| 124 @DOCSTRING(stem) | |
| 125 | |
| 11818 | 126 The @code{contour}, @code{contourf} and @code{contourc} functions |
| 127 produce two-dimensional contour plots from three dimensional data. | |
| 6888 | 128 |
| 5134 | 129 @DOCSTRING(contour) |
| 130 | |
| 11818 | 131 @DOCSTRING(contourf) |
| 132 | |
| 6502 | 133 @DOCSTRING(contourc) |
| 134 | |
| 6888 | 135 The @code{errorbar}, @code{semilogxerr}, @code{semilogyerr}, and |
| 136 @code{loglogerr} functions produces plots with error bar markers. For | |
| 137 example, | |
| 6877 | 138 |
| 6888 | 139 @example |
| 140 x = 0:0.1:10; | |
| 141 y = sin (x); | |
| 142 yp = 0.1 .* randn (size (x)); | |
| 143 ym = -0.1 .* randn (size (x)); | |
| 144 errorbar (x, sin (x), ym, yp); | |
| 145 @end example | |
| 5134 | 146 |
| 6888 | 147 @noindent |
| 6899 | 148 produces the figure shown in @ref{fig:errorbar}. |
| 6502 | 149 |
| 6888 | 150 @float Figure,fig:errorbar |
| 151 @image{errorbar,8cm} | |
| 152 @caption{Errorbar plot.} | |
| 153 @end float | |
| 5134 | 154 |
| 155 @DOCSTRING(errorbar) | |
| 156 | |
| 157 @DOCSTRING(semilogxerr) | |
| 158 | |
| 159 @DOCSTRING(semilogyerr) | |
| 160 | |
| 6888 | 161 @DOCSTRING(loglogerr) |
| 162 | |
| 163 Finally, the @code{polar} function allows you to easily plot data in | |
| 7001 | 164 polar coordinates. However, the display coordinates remain rectangular |
| 6888 | 165 and linear. For example, |
| 166 | |
| 167 @example | |
| 168 polar (0:0.1:10*pi, 0:0.1:10*pi); | |
| 169 @end example | |
| 170 | |
| 171 @noindent | |
| 6899 | 172 produces the spiral plot shown in @ref{fig:polar}. |
| 6888 | 173 |
| 174 @float Figure,fig:polar | |
| 175 @image{polar,8cm} | |
| 176 @caption{Polar plot.} | |
| 177 @end float | |
| 178 | |
| 179 @DOCSTRING(polar) | |
| 180 | |
| 7120 | 181 @DOCSTRING(pie) |
| 182 | |
| 183 @DOCSTRING(quiver) | |
| 184 | |
| 185 @DOCSTRING(pcolor) | |
| 186 | |
| 7153 | 187 @DOCSTRING(area) |
| 188 | |
| 6888 | 189 The axis function may be used to change the axis limits of an existing |
| 190 plot. | |
| 191 | |
| 192 @DOCSTRING(axis) | |
| 193 | |
| 7189 | 194 Similarly the axis limits of the colormap can be changed with the caxis |
| 195 function. | |
| 196 | |
| 197 @DOCSTRING(caxis) | |
| 198 | |
| 5134 | 199 @node Three-Dimensional Plotting |
| 6888 | 200 @subsection Three-Dimensional Plotting |
| 201 | |
| 202 The function @code{mesh} produces mesh surface plots. For example, | |
| 203 | |
| 204 @example | |
| 205 @group | |
| 206 tx = ty = linspace (-8, 8, 41)'; | |
| 207 [xx, yy] = meshgrid (tx, ty); | |
| 208 r = sqrt (xx .^ 2 + yy .^ 2) + eps; | |
| 209 tz = sin (r) ./ r; | |
| 210 mesh (tx, ty, tz); | |
| 211 @end group | |
| 212 @end example | |
| 213 | |
| 214 @noindent | |
| 6899 | 215 produces the familiar ``sombrero'' plot shown in @ref{fig:mesh}. Note |
| 6888 | 216 the use of the function @code{meshgrid} to create matrices of X and Y |
| 217 coordinates to use for plotting the Z data. The @code{ndgrid} function | |
| 218 is similar to @code{meshgrid}, but works for N-dimensional matrices. | |
| 219 | |
| 220 @float Figure,fig:mesh | |
| 221 @image{mesh,8cm} | |
| 222 @caption{Mesh plot.} | |
| 223 @end float | |
| 5134 | 224 |
| 6888 | 225 The @code{meshc} function is similar to @code{mesh}, but also produces a |
| 226 plot of contours for the surface. | |
| 227 | |
| 228 The @code{plot3} function displays arbitrary three-dimensional data, | |
| 229 without requiring it to form a surface. For example | |
| 230 | |
| 231 @example | |
| 232 @group | |
| 233 t = 0:0.1:10*pi; | |
| 234 r = linspace (0, 1, numel (t)); | |
| 235 z = linspace (0, 1, numel (t)); | |
| 236 plot3 (r.*sin(t), r.*cos(t), z); | |
| 237 @end group | |
| 238 @end example | |
| 239 | |
| 240 @noindent | |
| 6899 | 241 displays the spiral in three dimensions shown in @ref{fig:plot3}. |
| 6888 | 242 |
| 243 @float Figure,fig:plot3 | |
| 244 @image{plot3,8cm} | |
| 245 @caption{Three dimensional spiral.} | |
| 246 @end float | |
| 247 | |
| 248 Finally, the @code{view} function changes the viewpoint for | |
| 249 three-dimensional plots. | |
| 5134 | 250 |
| 251 @DOCSTRING(mesh) | |
| 252 | |
| 6788 | 253 @DOCSTRING(meshc) |
| 254 | |
| 7153 | 255 @DOCSTRING(hidden) |
| 256 | |
| 7120 | 257 @DOCSTRING(surf) |
| 258 | |
| 259 @DOCSTRING(surfc) | |
| 260 | |
| 5134 | 261 @DOCSTRING(meshgrid) |
| 262 | |
| 6550 | 263 @DOCSTRING(ndgrid) |
| 264 | |
| 6888 | 265 @DOCSTRING(plot3) |
| 266 | |
| 6502 | 267 @DOCSTRING(view) |
| 268 | |
| 7120 | 269 @DOCSTRING(shading) |
| 270 | |
| 6888 | 271 @node Plot Annotations |
| 272 @subsection Plot Annotations | |
| 6502 | 273 |
| 6888 | 274 You can add titles, axis labels, legends, and arbitrary text to an |
| 275 existing plot. For example, | |
| 6877 | 276 |
| 6888 | 277 @example |
| 278 @group | |
| 279 x = -10:0.1:10; | |
| 280 plot (x, sin (x)); | |
| 281 title ("sin(x) for x = -10:0.1:10"); | |
| 282 xlabel ("x"); | |
| 283 ylabel ("sin (x)"); | |
| 284 text (pi, 0.7, "arbitrary text"); | |
| 285 legend ("sin (x)"); | |
| 286 @end group | |
| 287 @end example | |
| 6502 | 288 |
| 6888 | 289 The functions @code{grid} and @code{box} may also be used to add grid |
| 290 and border lines to the plot. By default, the grid is off and the | |
| 291 border lines are on. | |
| 5134 | 292 |
| 293 @DOCSTRING(title) | |
| 294 | |
| 6502 | 295 @DOCSTRING(legend) |
| 296 | |
| 297 @DOCSTRING(text) | |
| 298 | |
| 5134 | 299 @DOCSTRING(xlabel) |
| 300 | |
| 6502 | 301 @DOCSTRING(box) |
| 302 | |
| 303 @DOCSTRING(grid) | |
| 304 | |
|
11830
233de4b9b259
add colorbar docstring to the manual
John W. Eaton <jwe@octave.org>
parents:
11818
diff
changeset
|
305 @DOCSTRING(colorbar) |
|
233de4b9b259
add colorbar docstring to the manual
John W. Eaton <jwe@octave.org>
parents:
11818
diff
changeset
|
306 |
| 5134 | 307 @node Multiple Plots on One Page |
| 6888 | 308 @subsection Multiple Plots on One Page |
| 309 | |
| 310 Octave can display more than one plot in a single figure. The simplest | |
| 311 way to do this is to use the @code{subplot} function to divide the plot | |
| 312 area into a series of subplot windows that are indexed by an integer. | |
| 313 For example, | |
| 314 | |
| 315 @example | |
| 316 @group | |
| 317 subplot (2, 1, 1) | |
| 318 fplot (@@sin, [-10, 10]); | |
| 319 subplot (2, 1, 2) | |
| 320 fplot (@@cos, [-10, 10]); | |
| 321 @end group | |
| 322 @end example | |
| 323 | |
| 324 @noindent | |
| 325 creates a figure with two separate axes, one displaying a sine wave and | |
| 326 the other a cosine wave. The first call to subplot divides the figure | |
| 327 into two plotting areas (two rows and one column) and makes the first plot | |
| 328 area active. The grid of plot areas created by @code{subplot} is | |
| 329 numbered in column-major order (top to bottom, left to right). | |
| 5134 | 330 |
| 331 @DOCSTRING(subplot) | |
| 332 | |
| 333 @node Multiple Plot Windows | |
| 6888 | 334 @subsection Multiple Plot Windows |
| 335 | |
| 336 You can open multiple plot windows using the @code{figure} function. | |
| 337 For example | |
| 338 | |
| 339 @example | |
| 340 figure (1); | |
| 341 fplot (@@sin, [-10, 10]); | |
| 342 figure (2); | |
| 343 fplot (@@cos, [-10, 10]); | |
| 344 @end example | |
| 345 | |
| 346 @noindent | |
| 347 creates two figures, with the first displaying a sine wave and | |
| 348 the second a cosine wave. Figure numbers must be positive integers. | |
| 5134 | 349 |
| 350 @DOCSTRING(figure) | |
| 351 | |
| 6502 | 352 @node Printing Plots |
| 6888 | 353 @subsection Printing Plots |
| 354 | |
| 355 The @code{print} command allows you to save plots in a variety of | |
| 356 formats. For example, | |
| 357 | |
| 358 @example | |
| 359 print -deps foo.eps | |
| 360 @end example | |
| 361 | |
| 362 @noindent | |
| 363 writes the current figure to an encapsulated PostScript file called | |
| 364 @file{foo.eps}. | |
| 6502 | 365 |
| 366 @DOCSTRING(print) | |
| 367 | |
| 368 @DOCSTRING(orient) | |
| 5134 | 369 |
| 6788 | 370 @node Test Plotting Functions |
| 6888 | 371 @subsection Test Plotting Functions |
| 372 | |
| 373 The functions @code{sombrero} and @code{peaks} provide a way to check | |
| 374 that plotting is working. Typing either @code{sombrero} or @code{peaks} | |
| 375 at the Octave prompt should display a three dimensional plot. | |
| 6788 | 376 |
| 6877 | 377 @DOCSTRING(sombrero) |
| 378 | |
| 6788 | 379 @DOCSTRING(peaks) |
| 380 | |
| 6888 | 381 @node Advanced Plotting |
| 382 @section Advanced Plotting | |
| 383 | |
| 384 @menu | |
| 385 * Graphics Objects:: | |
| 386 * Graphics Object Properties:: | |
| 6891 | 387 * Managing Default Properties:: |
| 6889 | 388 * Colors:: |
| 389 * Line Styles:: | |
| 390 * Marker Styles:: | |
| 6888 | 391 * Interaction with gnuplot:: |
| 392 @end menu | |
| 393 | |
| 394 @node Graphics Objects | |
| 395 @subsection Graphics Objects | |
| 396 | |
| 397 Plots in Octave are constructed from the following @dfn{graphics | |
| 398 objects}. Each graphics object has a set of properties that define its | |
| 399 appearance and may also contain links to other graphics objects. | |
| 400 Graphics objects are only referenced by a numeric index, or @dfn{handle}. | |
| 401 | |
| 402 @table @asis | |
| 403 @item root figure | |
| 11878 | 404 @cindex root figure graphics object |
| 405 @cindex graphics object, root figure | |
| 6888 | 406 The parent of all figure objects. The index for the root figure is |
| 407 defined to be 0. | |
| 408 | |
| 409 @item figure | |
| 11878 | 410 @cindex figure graphics object |
| 411 @cindex graphics object, figure | |
| 6888 | 412 A figure window. |
| 413 | |
| 414 @item axes | |
| 11878 | 415 @cindex axes graphics object |
| 416 @cindex graphics object, axes | |
| 6888 | 417 An set of axes. This object is a child of a figure object and may be a |
| 418 parent of line, text, image, patch, or surface objects. | |
| 419 | |
| 420 @item line | |
| 11878 | 421 @cindex line graphics object |
| 422 @cindex graphics object, line | |
| 6888 | 423 A line in two or three dimensions. |
| 424 | |
| 425 @item text | |
| 11878 | 426 @cindex text graphics object |
| 427 @cindex graphics object, text | |
| 6888 | 428 Text annotations. |
| 429 | |
| 430 @item image | |
| 11878 | 431 @cindex image graphics object |
| 432 @cindex graphics object, image | |
| 6888 | 433 A bitmap image. |
| 434 | |
| 435 @item patch | |
| 11878 | 436 @cindex patch graphics object |
| 437 @cindex graphics object, patch | |
| 6888 | 438 A filled polygon, currently limited to two dimensions. |
| 439 | |
| 440 @item surface | |
| 11878 | 441 @cindex surface graphics object |
| 442 @cindex graphics object, surface | |
| 6888 | 443 A three-dimensional surface. |
| 444 @end table | |
| 445 | |
| 446 To determine whether an object is a graphics object index or a figure | |
| 447 index, use the functions @code{ishandle} and @code{isfigure}. | |
| 448 | |
| 449 @DOCSTRING(ishandle) | |
| 450 | |
| 451 @DOCSTRING(isfigure) | |
| 452 | |
| 453 The function @code{gcf} returns an index to the current figure object, | |
| 454 or creates one if none exists. Similarly, @code{gca} returns the | |
| 455 current axes object, or creates one (and its parent figure object) if | |
| 456 none exists. | |
| 457 | |
| 458 @DOCSTRING(gcf) | |
| 459 | |
| 460 @DOCSTRING(gca) | |
| 461 | |
| 462 The @code{get} and @code{set} functions may be used to examine and set | |
| 463 properties for graphics objects. For example, | |
| 464 | |
| 465 @example | |
| 466 @group | |
| 467 get (0) | |
| 468 @result{} ans = | |
| 469 @{ | |
| 470 type = root figure | |
| 471 currentfigure = [](0x0) | |
| 472 children = [](0x0) | |
| 473 visible = on | |
| 474 @} | |
| 475 @end group | |
| 476 @end example | |
| 477 | |
| 478 @noindent | |
| 479 returns a structure containing all the properties of the root figure. | |
| 480 As with all functions in Octave, the structure is returned by value, so | |
| 481 modifying it will not modify the internal root figure plot object. To | |
| 482 do that, you must use the @code{set} function. Also, note that in this | |
| 483 case, the @code{currentfigure} property is empty, which indicates that | |
| 484 there is no current figure window. | |
| 485 | |
| 486 The @code{get} function may also be used to find the value of a single | |
| 487 property. For example, | |
| 488 | |
| 489 @example | |
| 490 @group | |
| 491 get (gca (), "xlim") | |
| 492 @result{} [ 0 1 ] | |
| 493 @end group | |
| 494 @end example | |
| 495 | |
| 496 @noindent | |
| 497 returns the range of the x-axis for the current axes object in the | |
| 498 current figure. | |
| 499 | |
| 500 To set graphics object properties, use the set function. For example, | |
| 501 | |
| 502 @example | |
| 503 set (gca (), "xlim", [-10, 10]); | |
| 504 @end example | |
| 505 | |
| 506 @noindent | |
| 507 sets the range of the x-axis for the current axes object in the current | |
| 508 figure to @samp{[-10, 10]}. Additionally, calling set with a graphics | |
| 509 object index as the only argument returns a structure containing the | |
| 510 default values for all the properties for the given object type. For | |
| 511 example, | |
| 512 | |
| 513 @example | |
| 514 set (gca ()) | |
| 515 @end example | |
| 516 | |
| 517 @noindent | |
| 518 returns a structure containing the default property values for axes | |
| 519 objects. | |
| 520 | |
| 521 @DOCSTRING(get) | |
| 522 | |
| 523 @DOCSTRING(set) | |
| 524 | |
| 525 @DOCSTRING(ancestor) | |
| 526 | |
| 527 You can create axes, line, and patch objects directly using the | |
| 528 @code{axes}, @code{line}, and @code{patch} functions. These objects | |
| 529 become children of the current axes object. | |
| 530 | |
| 531 @DOCSTRING(axes) | |
| 532 | |
| 533 @DOCSTRING(line) | |
| 534 | |
| 535 @DOCSTRING(patch) | |
| 536 | |
| 7120 | 537 @DOCSTRING(surface) |
| 538 | |
| 6888 | 539 By default, Octave refreshes the plot window when a prompt is printed, |
| 540 or when waiting for input. To force an update at other times, call the | |
| 541 @code{drawnow} function. | |
| 542 | |
| 543 @DOCSTRING(drawnow) | |
| 544 | |
| 545 Normally, high-level plot functions like @code{plot} or @code{mesh} call | |
| 546 @code{newplot} to initialize the state of the current axes so that the | |
| 547 next plot is drawn in a blank window with default property settings. To | |
| 548 have two plots superimposed over one another, call the @code{hold} | |
| 549 function. For example, | |
| 550 | |
| 551 @example | |
| 552 @group | |
| 553 hold ("on"); | |
| 554 x = -10:0.1:10; | |
| 555 plot (x, sin (x)); | |
| 556 plot (x, cos (x)); | |
| 557 hold ("off"); | |
| 558 @end group | |
| 559 @end example | |
| 560 | |
| 561 @noindent | |
| 562 displays sine and cosine waves on the same axes. If the hold state is | |
| 563 off, consecutive plotting commands like this will only display the last | |
| 564 plot. | |
| 565 | |
| 566 @DOCSTRING(newplot) | |
| 567 | |
| 568 @DOCSTRING(hold) | |
| 569 | |
| 570 @DOCSTRING(ishold) | |
| 571 | |
| 572 To clear the current figure, call the @code{clf} function. To bring it | |
| 573 to the top of the window stack, call the @code{shg} function. To delete | |
| 574 a graphics object, call @code{delete} on its index. To close the | |
| 575 figure window, call the @code{close} function. | |
| 576 | |
| 577 @DOCSTRING(clf) | |
| 578 | |
| 579 @DOCSTRING(shg) | |
| 580 | |
| 581 @DOCSTRING(delete) | |
| 582 | |
| 583 @DOCSTRING(close) | |
| 584 | |
| 585 @DOCSTRING(closereq) | |
| 586 | |
| 587 @node Graphics Object Properties | |
| 588 @subsection Graphics Object Properties | |
| 589 @cindex graphics object properties | |
| 590 | |
| 591 @menu | |
| 592 * Root Figure Properties:: | |
| 6889 | 593 * Figure Properties:: |
| 6888 | 594 * Axes Properties:: |
| 595 * Line Properties:: | |
| 596 * Text Properties:: | |
| 597 * Image Properties:: | |
| 598 * Patch Properties:: | |
| 599 * Surface Properties:: | |
| 600 @end menu | |
| 601 | |
| 602 @node Root Figure Properties | |
| 603 @subsubsection Root Figure Properties | |
| 604 | |
| 605 @table @code | |
| 606 @item currentfigure | |
| 6889 | 607 Index to graphics object for the current figure. |
| 608 | |
| 609 @c FIXME -- does this work? | |
| 610 @c @item visible | |
| 611 @c Either @code{"on"} or @code{"off"} to toggle display of figures. | |
| 6888 | 612 @end table |
| 613 | |
| 6889 | 614 @node Figure Properties |
| 615 @subsubsection Figure Properties | |
| 11878 | 616 @cindex figure properties |
| 6888 | 617 |
| 618 @table @code | |
| 619 @item nextplot | |
| 6889 | 620 May be one of |
| 621 @table @code | |
| 622 @item "new" | |
| 623 @item "add" | |
| 624 @item "replace" | |
| 625 @item "replacechildren" | |
| 626 @end table | |
| 627 | |
| 6888 | 628 @item closerequestfcn |
| 6889 | 629 Handle of function to call when a figure is closed. |
| 630 | |
| 6888 | 631 @item currentaxes |
| 6889 | 632 Index to graphics object of current axes. |
| 633 | |
| 6888 | 634 @item colormap |
| 6889 | 635 An N-by-3 matrix containing the color map for the current axes. |
| 636 | |
| 6888 | 637 @item visible |
| 6889 | 638 Either @code{"on"} or @code{"off"} to toggle display of the figure. |
| 639 | |
| 6888 | 640 @item paperorientation |
| 6889 | 641 Indicates the orientation for printing. Either @code{"landscape"} or |
| 642 @code{"portrait"}. | |
| 6888 | 643 @end table |
| 644 | |
| 645 @node Axes Properties | |
| 646 @subsubsection Axes Properties | |
| 11878 | 647 @cindex axes properties |
| 6888 | 648 |
| 649 @table @code | |
| 650 @item position | |
| 11878 | 651 A vector specifying the position of the plot, excluding titles, axes and |
| 652 legend. The four elements of the vector are the coordinates of the | |
| 653 lower left corner and width and height of the plot, in units normalized | |
| 654 to the width and height of the plot window. For example, @code{[0.2, | |
| 655 0.3, 0.4, 0.5]} sets the lower left corner of the axes at @math{(0.2, | |
| 656 0.3)} and the width and height to be 0.4 and 0.5 respectively. See also | |
| 657 the @code{outerposition} property. | |
| 6889 | 658 |
| 6888 | 659 @item title |
| 6889 | 660 Index of text object for the axes title. |
| 661 | |
| 6888 | 662 @item box |
| 6889 | 663 Either @code{"on"} or @code{"off"} to toggle display of the box around |
| 664 the axes. | |
| 665 | |
| 6888 | 666 @item key |
| 6889 | 667 Either @code{"on"} or @code{"off"} to toggle display of the legend. |
| 668 Note that this property is not compatible with @sc{Matlab} and may be | |
| 669 removed in a future version of Octave. | |
| 670 | |
| 6888 | 671 @item keybox |
| 6889 | 672 Either @code{"on"} or @code{"off"} to toggle display of a box around the |
| 673 legend. Note that this property is not compatible with @sc{Matlab} and | |
| 674 may be removed in a future version of Octave. | |
| 675 | |
| 6888 | 676 @item keypos |
| 6889 | 677 An integer from 1 to 4 specifying the position of the legend. 1 |
| 678 indicates upper right corner, 2 indicates upper left, 3 indicates lower | |
| 679 left, and 4 indicates lower right. Note that this property is not | |
| 680 compatible with @sc{Matlab} and may be removed in a future version of | |
| 681 Octave. | |
| 682 | |
| 6888 | 683 @item dataaspectratio |
| 6889 | 684 A two-element vector specifying the relative height and width of the |
| 685 data displayed in the axes. Setting @code{dataaspectratio} to @samp{1, | |
| 686 2]} causes the length of one unit as displayed on the y axis to be the | |
| 687 same as the length of 2 units on the x axis. Setting | |
| 688 @code{dataaspectratio} also forces the @code{dataaspectratiomode} | |
| 689 property to be set to @code{"manual"}. | |
| 690 | |
| 6888 | 691 @item dataaspectratiomode |
| 6889 | 692 Either @code{"manual"} or @code{"auto"}. |
| 693 | |
| 6888 | 694 @item xlim |
| 695 @itemx ylim | |
| 696 @itemx zlim | |
| 697 @itemx clim | |
| 6889 | 698 Two-element vectors defining the limits for the x, y, and z axes and the |
| 699 Setting one of these properties also forces the corresponding mode | |
| 700 property to be set to @code{"manual"}. | |
| 701 | |
| 6888 | 702 @item xlimmode |
| 703 @itemx ylimmode | |
| 704 @itemx zlimmode | |
| 705 @itemx climmode | |
| 6889 | 706 Either @code{"manual"} or @code{"auto"}. |
| 707 | |
| 6888 | 708 @item xlabel |
| 709 @itemx ylabel | |
| 710 @itemx zlabel | |
| 6889 | 711 Indices to text objects for the axes labels. |
| 712 | |
| 6888 | 713 @item xgrid |
| 714 @itemx ygrid | |
| 715 @itemx zgrid | |
| 6889 | 716 Either @code{"on"} or @code{"off"} to toggle display of grid lines. |
| 717 | |
| 6888 | 718 @item xminorgrid |
| 719 @itemx yminorgrid | |
| 720 @itemx zminorgrid | |
| 6889 | 721 Either @code{"on"} or @code{"off"} to toggle display of minor grid lines. |
| 722 | |
| 6888 | 723 @item xtick |
| 724 @itemx ytick | |
| 725 @itemx ztick | |
| 6889 | 726 Setting one of these properties also forces the corresponding mode |
| 727 property to be set to @code{"manual"}. | |
| 728 | |
| 6888 | 729 @item xtickmode |
| 730 @itemx ytickmode | |
| 731 @itemx ztickmode | |
| 6889 | 732 Either @code{"manual"} or @code{"auto"}. |
| 733 | |
| 6888 | 734 @item xticklabel |
| 735 @itemx yticklabel | |
| 736 @itemx zticklabel | |
| 6889 | 737 Setting one of these properties also forces the corresponding mode |
| 738 property to be set to @code{"manual"}. | |
| 739 | |
| 6888 | 740 @item xticklabelmode |
| 741 @itemx yticklabelmode | |
| 742 @itemx zticklabelmode | |
| 6889 | 743 Either @code{"manual"} or @code{"auto"}. |
| 744 | |
| 6888 | 745 @item xscale |
| 746 @itemx yscale | |
| 747 @itemx zscale | |
| 6889 | 748 Either @code{"linear"} or @code{"log"}. |
| 749 | |
| 6888 | 750 @item xdir |
| 751 @itemx ydir | |
| 752 @itemx zdir | |
| 6889 | 753 Either @code{"forward"} or @code{"reverse"}. |
| 754 | |
| 6888 | 755 @item xaxislocation |
| 756 @itemx yaxislocation | |
| 6889 | 757 Either @code{"top"} or @code{"bottom"} for the x axis and @code{"left"} |
| 758 or @code{"right"} for the y axis. | |
| 759 | |
| 6888 | 760 @item view |
| 6889 | 761 A three element vector specifying the view point for three-dimensional plots. |
| 762 | |
| 6888 | 763 @item visible |
| 6889 | 764 Either @code{"on"} or @code{"off"} to toggle display of the axes. |
| 765 | |
| 6888 | 766 @item nextplot |
| 6889 | 767 May be one of |
| 768 @table @code | |
| 769 @item "new" | |
| 770 @item "add" | |
| 771 @item "replace" | |
| 772 @item "replacechildren" | |
| 773 @end table | |
| 774 | |
| 6888 | 775 @item outerposition |
| 11878 | 776 A vector specifying the position of the plot, including titles, axes and |
| 777 legend. The four elements of the vector are the coordinates of the | |
| 778 lower left corner and width and height of the plot, in units normalized | |
| 779 to the width and height of the plot window. For example, @code{[0.2, | |
| 780 0.3, 0.4, 0.5]} sets the lower left corner of the axes at @math{(0.2, | |
| 781 0.3)} and the width and height to be 0.4 and 0.5 respectively. See also | |
| 782 the @code{position} property. | |
| 6888 | 783 @end table |
| 784 | |
| 785 @node Line Properties | |
| 786 @subsubsection Line Properties | |
| 11878 | 787 @cindex line properties |
| 6888 | 788 |
| 789 @table @code | |
| 790 @itemx xdata | |
| 791 @itemx ydata | |
| 792 @itemx zdata | |
| 793 @itemx ldata | |
| 794 @itemx udata | |
| 795 @itemx xldata | |
| 796 @itemx xudata | |
| 6889 | 797 The data to be plotted. The @code{ldata} and @code{udata} elements are |
| 798 for errobars in the y direction, and the @code{xldata} and @code{xudata} | |
| 799 elements are for errorbars in the x direction. | |
| 800 | |
| 6888 | 801 @item color |
| 6889 | 802 The RGB color of the line, or a color name. @xref{Colors}. |
| 803 | |
| 6888 | 804 @item linestyle |
| 6889 | 805 @itemx linewidth |
| 806 @xref{Line Styles}. | |
| 807 | |
| 6888 | 808 @item marker |
| 809 @item markeredgecolor | |
| 810 @item markerfacecolor | |
| 811 @item markersize | |
| 6889 | 812 @xref{Marker Styles}. |
| 813 | |
| 6888 | 814 @item keylabel |
| 6889 | 815 The text of the legend entry corresponding to this line. Note that this |
| 816 property is not compatible with @sc{Matlab} and may be removed in a | |
| 817 future version of Octave. | |
| 6888 | 818 @end table |
| 819 | |
| 820 @node Text Properties | |
| 821 @subsubsection Text Properties | |
| 11878 | 822 @cindex text properties |
| 6888 | 823 |
| 824 @table @code | |
| 825 @item string | |
| 6889 | 826 The character string contained by the text object. |
| 827 | |
| 6888 | 828 @item units |
| 6889 | 829 May be @code{"normalized"} or @code{"graph"}. |
| 830 | |
| 6888 | 831 @item position |
| 6889 | 832 The coordinates of the text object. |
| 833 | |
| 6888 | 834 @item rotation |
| 6889 | 835 The angle of rotation for the displayed text, measured in degrees. |
| 836 | |
| 6888 | 837 @item horizontalalignment |
| 6889 | 838 May be @code{"left"}, @code{"center"}, or @code{"right"}. |
| 839 | |
| 6888 | 840 @item color |
| 6889 | 841 The color of the text. @xref{Colors}. |
| 7189 | 842 |
| 843 @item fontname | |
| 844 The font used for the text. | |
| 845 | |
| 846 @item fontsize | |
| 847 The size of the font, in points to use. | |
| 848 | |
| 849 @item fontangle | |
| 850 Flag whether the font is italic or normal. Valid values are 'normal', | |
| 851 'italic' and 'oblique'. | |
| 852 | |
| 853 @item fontweight | |
| 854 Flag whether the font is bold, etc. Valid values are 'normal', 'bold', | |
| 855 'demi' or 'light'. | |
| 856 | |
| 857 @item interpreter | |
| 858 Determines how the text is rendered. Valid values are 'none', 'tex' or | |
| 859 'latex'. | |
| 6888 | 860 @end table |
| 861 | |
| 7189 | 862 All text objects, including titles, labels, legends, and text, include |
| 863 the property 'interpreter', this property determines the manner in which | |
| 864 special control sequences in the text are rendered. If the interpreter | |
| 865 is set to 'none', then no rendering occurs. At this point the 'latex' | |
| 866 option is not implemented and so the 'latex' interpreter also does not | |
| 867 interpret the text. | |
| 868 | |
| 869 The 'tex' option implements a subset of @sc{TeX} functionality in the | |
| 870 rendering of the text. This allows the insertion of special characters | |
| 871 such as Greek or mathematical symbols within the text. The special | |
| 872 characters are also inserted with a code starting with the back-slash | |
| 873 (\) character, as in the table @ref{tab:extended}. | |
| 874 | |
| 875 In addition, the formating of the text can be changed within the string | |
| 876 with the codes | |
| 877 | |
| 878 @multitable @columnfractions .2 .2 .6 .2 | |
| 879 @item @tab \bf @tab Bold font @tab | |
| 880 @item @tab \it @tab Italic font @tab | |
| 881 @item @tab \sl @tab Oblique Font @tab | |
| 882 @item @tab \rm @tab Normal font @tab | |
| 883 @end multitable | |
| 884 | |
| 885 These are be used in conjunction with the @{ and @} characters to limit | |
| 886 the change in the font to part of the string. For example | |
| 887 | |
| 888 @example | |
| 889 xlabel ('@{\bf H@} = a @{\bf V@}') | |
| 890 @end example | |
| 891 | |
| 892 where the character 'a' will not appear in a bold font. Note that to | |
| 893 avoid having Octave interpret the backslash characters in the strings, | |
| 894 the strings should be in single quotes. | |
| 895 | |
| 896 It is also possible to change the fontname and size within the text | |
| 897 | |
| 898 @multitable @columnfractions .1 .4 .6 .1 | |
| 899 @item @tab \fontname@{@var{fontname}@} @tab Specify the font to use @tab | |
| 900 @item @tab \fontsize@{@var{size}@} @tab Specify the size of the font to | |
| 901 use @tab | |
| 902 @end multitable | |
| 903 | |
| 904 Finally, the superscript and subscripting can be controlled with the '^' | |
| 905 and '_' characters. If the '^' or '_' is followed by a @{ character, | |
| 906 then all of the block surrounded by the @{ @} pair is super- or | |
| 907 sub-scripted. Without the @{ @} pair, only the character immediately | |
| 908 following the '^' or '_' is super- or sub-scripted. | |
| 909 | |
| 910 @float Table,tab:extended | |
| 911 @iftex | |
| 912 @tex | |
| 913 \vskip 6pt | |
| 914 {\hbox to \hsize {\hfill\vbox{\offinterlineskip \tabskip=0pt | |
| 915 \halign{ | |
| 916 \vrule height2.0ex depth1.ex width 0.6pt #\tabskip=0.3em & | |
| 917 # \hfil & \vrule # & # \hfil & # \vrule & | |
| 918 # \hfil & \vrule # & # \hfil & # \vrule & | |
| 919 # \hfil & \vrule # & # \hfil & # \vrule | |
| 920 width 0.6pt \tabskip=0pt\cr | |
| 921 \noalign{\hrule height 0.6pt} | |
| 922 & Code && Sym && Code && Sym && Code && Sym &\cr | |
| 923 \noalign{\hrule} | |
|
11705
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
924 & $\backslash$forall && $\forall$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
925 && $\backslash$exists && $\exists$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
926 && $\backslash$ni && $\ni$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
927 & $\backslash$cong && $\cong$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
928 && $\backslash$Delta && $\Delta$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
929 && $\backslash$Phi && $\Phi$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
930 & $\backslash$Gamma && $\Gamma$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
931 && $\backslash$vartheta && $\vartheta$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
932 && $\backslash$Lambda && $\Lambda$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
933 & $\backslash$Pi && $\Pi$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
934 && $\backslash$Theta && $\Theta$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
935 && $\backslash$Sigma && $\Sigma$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
936 & $\backslash$varsigma && $\varsigma$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
937 && $\backslash$Omega && $\Omega$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
938 && $\backslash$Xi && $\Xi$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
939 & $\backslash$Psi && $\Psi$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
940 && $\backslash$perp && $\perp$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
941 && $\backslash$alpha && $\alpha$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
942 & $\backslash$beta && $\beta$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
943 && $\backslash$chi && $\chi$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
944 && $\backslash$delta && $\delta$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
945 & $\backslash$epsilon && $\epsilon$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
946 && $\backslash$phi && $\phi$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
947 && $\backslash$gamma && $\gamma$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
948 & $\backslash$eta && $\eta$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
949 && $\backslash$iota && $\iota$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
950 && $\backslash$varphi && $\varphi$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
951 & $\backslash$kappa && $\kappa$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
952 && $\backslash$lambda && $\lambda$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
953 && $\backslash$mu && $\mu$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
954 & $\backslash$nu && $\nu$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
955 && $\backslash$o && $\o$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
956 && $\backslash$pi && $\pi$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
957 & $\backslash$theta && $\theta$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
958 && $\backslash$rho && $\rho$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
959 && $\backslash$sigma && $\sigma$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
960 & $\backslash$tau && $\tau$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
961 && $\backslash$upsilon && $\upsilon$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
962 && $\backslash$varpi && $\varpi$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
963 & $\backslash$omega && $\omega$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
964 && $\backslash$xi && $\xi$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
965 && $\backslash$psi && $\psi$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
966 & $\backslash$zeta && $\zeta$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
967 && $\backslash$sim && $\sim$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
968 && $\backslash$Upsilon && $\Upsilon$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
969 & $\backslash$prime && $\prime$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
970 && $\backslash$leq && $\leq$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
971 && $\backslash$infty && $\infty$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
972 & $\backslash$clubsuit && $\clubsuit$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
973 && $\backslash$diamondsuit && $\diamondsuit$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
974 && $\backslash$heartsuit && $\heartsuit$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
975 & $\backslash$spadesuit && $\spadesuit$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
976 && $\backslash$leftrightarrow && $\leftrightarrow$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
977 && $\backslash$leftarrow && $\leftarrow$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
978 & $\backslash$uparrow && $\uparrow$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
979 && $\backslash$rightarrow && $\rightarrow$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
980 && $\backslash$downarrow && $\downarrow$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
981 & $\backslash$circ && $\circ$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
982 && $\backslash$pm && $\pm$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
983 && $\backslash$geq && $\geq$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
984 & $\backslash$times && $\times$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
985 && $\backslash$propto && $\propto$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
986 && $\backslash$partial && $\partial$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
987 & $\backslash$bullet && $\bullet$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
988 && $\backslash$div && $\div$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
989 && $\backslash$neq && $\neq$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
990 & $\backslash$equiv && $\equiv$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
991 && $\backslash$approx && $\approx$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
992 && $\backslash$ldots && $\ldots$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
993 & $\backslash$mid && $\mid$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
994 && $\backslash$aleph && $\aleph$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
995 && $\backslash$Im && $\Im$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
996 & $\backslash$Re && $\Re$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
997 && $\backslash$wp && $\wp$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
998 && $\backslash$otimes && $\otimes$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
999 & $\backslash$oplus && $\oplus$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1000 && $\backslash$oslash && $\oslash$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1001 && $\backslash$cap && $\cap$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1002 & $\backslash$cup && $\cup$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1003 && $\backslash$supset && $\supset$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1004 && $\backslash$supseteq && $\supseteq$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1005 & $\backslash$subset && $\subset$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1006 && $\backslash$subseteq && $\subseteq$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1007 && $\backslash$in && $\in$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1008 & $\backslash$notin && $\notin$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1009 && $\backslash$angle && $\angle$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1010 && $\backslash$bigtriangledown && $\bigtriangledown$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1011 & $\backslash$langle && $\langle$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1012 && $\backslash$rangle && $\rangle$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1013 && $\backslash$nabla && $\nabla$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1014 & $\backslash$prod && $\prod$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1015 && $\backslash$surd && $\surd$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1016 && $\backslash$cdot && $\cdot$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1017 & $\backslash$neg && $\neg$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1018 && $\backslash$wedge && $\wedge$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1019 && $\backslash$vee && $\vee$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1020 & $\backslash$Leftrightarrow && $\Leftrightarrow$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1021 && $\backslash$Leftarrow && $\Leftarrow$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1022 && $\backslash$Uparrow && $\Uparrow$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1023 & $\backslash$Rightarrow && $\Rightarrow$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1024 && $\backslash$Downarrow && $\Downarrow$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1025 && $\backslash$diamond && $\diamond$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1026 & $\backslash$copyright && $\copyright$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1027 && $\backslash$rfloor && $\rfloor$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1028 && $\backslash$lceil && $\lceil$ &\cr |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1029 & $\backslash$lfloor && $\lfloor$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1030 && $\backslash$rceil && $\rceil$ |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1031 && $\backslash$int && $\int$ &\cr |
| 7189 | 1032 \noalign{\hrule height 0.6pt} |
| 1033 }}\hfill}} | |
| 1034 @end tex | |
| 1035 @end iftex | |
| 1036 @ifnottex | |
| 1037 @multitable @columnfractions .125 .25 .25 .25 .125 | |
|
11705
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1038 @item @tab \forall @tab \exists @tab \ni @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1039 @item @tab \cong @tab \Delta @tab \Phi @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1040 @item @tab \Gamma @tab \vartheta @tab \Lambda @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1041 @item @tab \Pi @tab \Theta @tab \Sigma @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1042 @item @tab \varsigma @tab \Omega @tab \Xi @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1043 @item @tab \Psi @tab \perp @tab \alpha @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1044 @item @tab \beta @tab \chi @tab \delta @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1045 @item @tab \epsilon @tab \phi @tab \gamma @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1046 @item @tab \eta @tab \iota @tab \varphi @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1047 @item @tab \kappa @tab \lambda @tab \mu @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1048 @item @tab \nu @tab \o @tab \pi @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1049 @item @tab \theta @tab \rho @tab \sigma @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1050 @item @tab \tau @tab \upsilon @tab \varpi @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1051 @item @tab \omega @tab \xi @tab \psi @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1052 @item @tab \zeta @tab \sim @tab \Upsilon @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1053 @item @tab \prime @tab \leq @tab \infty @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1054 @item @tab \clubsuit @tab \diamondsuit @tab \heartsuit @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1055 @item @tab \spadesuit @tab \leftrightarrow @tab \leftarrow @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1056 @item @tab \uparrow @tab \rightarrow @tab \downarrow @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1057 @item @tab \circ @tab \pm @tab \geq @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1058 @item @tab \times @tab \propto @tab \partial @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1059 @item @tab \bullet @tab \div @tab \neq @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1060 @item @tab \equiv @tab \approx @tab \ldots @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1061 @item @tab \mid @tab \aleph @tab \Im @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1062 @item @tab \Re @tab \wp @tab \otimes @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1063 @item @tab \oplus @tab \oslash @tab \cap @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1064 @item @tab \cup @tab \supset @tab \supseteq @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1065 @item @tab \subset @tab \subseteq @tab \in @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1066 @item @tab \notin @tab \angle @tab \bigrightriangledown @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1067 @item @tab \langle @tab \rangle @tab \nabla @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1068 @item @tab \prod @tab \surd @tab \cdot @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1069 @item @tab \neg @tab \wedge @tab \vee @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1070 @item @tab \Leftrightarrow @tab \Leftarrow @tab \Uparrow @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1071 @item @tab \Rightarrow @tab \Downarrow @tab \diamond @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1072 @item @tab \copyright @tab \lfloor @tab \lceil @tab |
|
39049855358d
Correct typos in __go_draw_axes__.m and update Manual
godfrey@qss.Stanford.EDU
parents:
7189
diff
changeset
|
1073 @item @tab \rfloor @tab \rceil @tab \int @tab |
| 7189 | 1074 @end multitable |
| 1075 @end ifnottex | |
| 1076 @caption{Available special characters in @sc{TeX} mode} | |
| 1077 @end float | |
| 1078 | |
| 1079 A complete example showing the capabilities of the extended text is | |
| 1080 | |
| 1081 @example | |
| 1082 @group | |
| 1083 x = 0:0.01:3; | |
| 1084 plot(x,erf(x)); | |
| 1085 hold on; | |
| 1086 plot(x,x,"r"); | |
| 1087 axis([0, 3, 0, 1]); | |
| 1088 text(0.65, 0.6175, strcat('\leftarrow x = @{2/\surd\pi', | |
| 1089 ' @{\fontsize@{16@}\int_@{\fontsize@{8@}0@}^@{\fontsize@{8@}x@}@}', | |
| 1090 ' e^@{-t^2@} dt@} = 0.6175')) | |
| 1091 @end group | |
| 1092 @end example | |
| 1093 | |
| 1094 @ifnotinfo | |
| 1095 @noindent | |
| 1096 The result of which can be seen in @ref{fig:extendedtext} | |
| 1097 | |
| 1098 @float Figure,fig:extendedtext | |
| 1099 @image{extended,8cm} | |
| 1100 @caption{Example of inclusion of text with the @sc{TeX} interpreter} | |
| 1101 @end float | |
| 1102 @end ifnotinfo | |
| 1103 | |
| 6888 | 1104 @node Image Properties |
| 1105 @subsubsection Image Properties | |
| 11878 | 1106 @cindex image properties |
| 6888 | 1107 |
| 1108 @table @code | |
| 1109 @item cdata | |
| 6889 | 1110 The data for the image. Each pixel of the image corresponds to an |
| 1111 element of @code{cdata}. The value of an element of @code{cdata} | |
| 1112 specifies the row-index into the colormap of the axes object containing | |
| 1113 the image. The color value found in the color map for the given index | |
| 1114 determines the color of the pixel. | |
| 1115 | |
| 1116 @item xdata | |
| 6888 | 1117 @itemx ydata |
| 7001 | 1118 Two-element vectors specifying the range of the x- and y- coordinates for |
| 6889 | 1119 the image. |
| 6888 | 1120 @end table |
| 1121 | |
| 1122 @node Patch Properties | |
| 1123 @subsubsection Patch Properties | |
| 11878 | 1124 @cindex patch properties |
| 6888 | 1125 |
| 1126 @table @code | |
| 1127 @item cdata | |
| 1128 @itemx xdata | |
| 1129 @itemx ydata | |
| 1130 @itemx zdata | |
| 6889 | 1131 Data defining the patch object. |
| 1132 | |
| 6888 | 1133 @item facecolor |
| 6889 | 1134 The fill color of the patch. @xref{Colors}. |
| 1135 | |
| 6888 | 1136 @item facealpha |
| 6889 | 1137 A number in the range [0, 1] indicating the transparency of the patch. |
| 1138 | |
| 6888 | 1139 @item edgecolor |
| 6889 | 1140 The color of the line defining the patch. @xref{Colors}. |
| 1141 | |
| 6888 | 1142 @item linestyle |
| 6889 | 1143 @itemx linewidth |
| 1144 @xref{Line Styles}. | |
| 1145 | |
| 6888 | 1146 @item marker |
| 6889 | 1147 @itemx markeredgecolor |
| 1148 @itemx markerfacecolor | |
| 1149 @itemx markersize | |
| 1150 @xref{Marker Styles}. | |
| 6888 | 1151 @end table |
| 1152 | |
| 1153 @node Surface Properties | |
| 1154 @subsubsection Surface Properties | |
| 11878 | 1155 @cindex surface properties |
| 6888 | 1156 |
| 1157 @table @code | |
| 1158 @item xdata | |
| 1159 @itemx ydata | |
| 1160 @itemx zdata | |
| 6889 | 1161 The data determining the surface. The @code{xdata} and @code{ydata} |
| 1162 elements are vectors and @code{zdata} must be a matrix. | |
| 1163 | |
| 6888 | 1164 @item keylabel |
| 6889 | 1165 The text of the legend entry corresponding to this surface. Note that |
| 1166 this property is not compatible with @sc{Matlab} and may be removed in a | |
| 1167 future version of Octave. | |
| 1168 @end table | |
| 1169 | |
| 6891 | 1170 @node Managing Default Properties |
| 1171 @subsection Managing Default Properties | |
| 11878 | 1172 @cindex default graphics properties |
| 1173 @cindex graphics properties, default | |
| 6891 | 1174 |
| 6892 | 1175 Object properties have two classes of default values, @dfn{factory |
| 1176 defaults} (the initial values) and @dfn{user-defined defaults}, which | |
| 1177 may override the factory defaults. | |
| 6891 | 1178 |
| 1179 Although default values may be set for any object, they are set in | |
| 1180 parent objects and apply to child objects. For example, | |
| 1181 | |
| 1182 @example | |
| 1183 set (0, "defaultlinecolor", "green"); | |
| 1184 @end example | |
| 1185 | |
| 1186 @noindent | |
| 1187 sets the default line color for all objects. The rule for constructing | |
| 1188 the property name to set a default value is | |
| 1189 | |
| 1190 @example | |
| 1191 default + @var{object-type} + @var{property-name} | |
| 1192 @end example | |
| 1193 | |
| 1194 This rule can lead to some strange looking names, for example | |
| 1195 @code{defaultlinelinewidth"} specifies the default @code{linewidth} | |
| 1196 property for @code{line} objects. | |
| 1197 | |
| 1198 The example above used the root figure object, 0, so the default | |
| 1199 property value will apply to all line objects. However, default values | |
| 1200 are hierarchical, so defaults set in a figure objects override those | |
| 1201 set in the root figure object. Likewise, defaults set in axes objects | |
| 1202 override those set in figure or root figure objects. For example, | |
| 1203 | |
| 1204 @example | |
| 1205 @group | |
| 1206 subplot (2, 1, 1); | |
| 1207 set (0, "defaultlinecolor", "red"); | |
| 1208 set (1, "defaultlinecolor", "green"); | |
| 1209 set (gca (), "defaultlinecolor", "blue"); | |
| 1210 line (1:10, rand (1, 10)); | |
| 1211 subplot (2, 1, 2); | |
| 1212 line (1:10, rand (1, 10)); | |
| 1213 figure (2) | |
| 1214 line (1:10, rand (1, 10)); | |
| 1215 @end group | |
| 1216 @end example | |
| 1217 | |
| 1218 @noindent | |
| 1219 produces two figures. The line in first subplot window of the first | |
| 1220 figure is blue because it inherits its color from its parent axes | |
| 1221 object. The line in the second subplot window of the first figure is | |
| 1222 green because it inherits its color from its parent figure object. The | |
| 1223 line in the second figure window is red because it inherits its color | |
| 1224 from the global root figure parent object. | |
| 1225 | |
| 1226 To remove a user-defined default setting, set the default property to | |
| 1227 the value @code{"remove"}. For example, | |
| 1228 | |
| 1229 @example | |
| 1230 set (gca (), "defaultlinecolor", "remove"); | |
| 1231 @end example | |
| 1232 | |
| 1233 @noindent | |
| 1234 removes the user-defined default line color setting from the current axes | |
| 1235 object. | |
| 1236 | |
| 1237 Getting the @code{"default"} property of an object returns a list of | |
| 1238 user-defined defaults set for the object. For example, | |
| 1239 | |
| 1240 @example | |
| 1241 get (gca (), "default"); | |
| 1242 @end example | |
| 1243 | |
| 1244 @noindent | |
| 1245 returns a list of user-defined default values for the current axes | |
| 1246 object. | |
| 1247 | |
| 1248 Factory default values are stored in the root figure object. The | |
| 1249 command | |
| 1250 | |
| 1251 @example | |
| 1252 get (0, "factory"); | |
| 1253 @end example | |
| 1254 | |
| 1255 @noindent | |
| 1256 returns a list of factory defaults. | |
| 1257 | |
| 6889 | 1258 @node Colors |
| 1259 @subsection Colors | |
| 11878 | 1260 @cindex graphics colors |
| 1261 @cindex colors, graphics | |
| 6889 | 1262 |
| 1263 Colors may be specified as RGB triplets with values ranging from zero to | |
| 1264 one, or by name. Recognized color names include @code{"blue"}, | |
| 1265 @code{"black"}, @code{"cyan"}, @code{"green"}, @code{"magenta"}, | |
| 1266 @code{"red"}, @code{"white"}, and @code{"yellow"}. | |
| 1267 | |
| 1268 @node Line Styles | |
| 1269 @subsection Line Styles | |
| 11878 | 1270 @cindex line styles, graphics |
| 1271 @cindex graphics line styles | |
| 1272 | |
| 7001 | 1273 Line styles are specified by the following properties: |
| 6889 | 1274 |
| 1275 @table @code | |
| 1276 @item linestyle | |
| 1277 May be one of | |
| 1278 @table @code | |
| 1279 @item "-" | |
| 1280 Solid lines. | |
| 1281 @item "--" | |
| 1282 Dashed lines. | |
| 1283 @item ":" | |
| 1284 Points. | |
| 1285 @item "-." | |
| 1286 A dash-dot line. | |
| 1287 @end table | |
| 1288 | |
| 1289 @item linewidth | |
| 1290 A number specifying the width of the line. The default is 1. A value | |
| 1291 of 2 is twice as wide as the default, etc. | |
| 1292 @end table | |
| 1293 | |
| 1294 @node Marker Styles | |
| 1295 @subsection Marker Styles | |
| 11878 | 1296 @cindex graphics marker styles |
| 1297 @cindex marker styles, graphics | |
| 1298 | |
| 7001 | 1299 Marker styles are specified by the following properties: |
| 6889 | 1300 @table @code |
| 1301 @item marker | |
| 1302 A character indicating a plot marker to be place at each data point, or | |
| 1303 @code{"none"}, meaning no markers should be displayed. | |
| 1304 | |
| 1305 @itemx markeredgecolor | |
| 1306 The color of the edge around the marker, or @code{"auto"}, meaning that | |
| 1307 the edge color is the same as the face color. @xref{Colors}. | |
| 1308 | |
| 1309 @itemx markerfacecolor | |
| 1310 The color of the marker, or @code{"none"} to indicate that the marker | |
| 1311 should not be filled. @xref{Colors}. | |
| 1312 | |
| 1313 @itemx markersize | |
| 1314 A number specifying the size of the marker. The default is 1. A value | |
| 1315 of 2 is twice as large as the default, etc. | |
| 6888 | 1316 @end table |
| 1317 | |
| 4167 | 1318 @node Interaction with gnuplot |
| 6888 | 1319 @subsection Interaction with @code{gnuplot} |
| 3428 | 1320 |
| 1321 @DOCSTRING(gnuplot_binary) | |
| 1322 | |
| 6331 | 1323 @DOCSTRING(gnuplot_use_title_option) |