Mercurial > octave
annotate scripts/plot/draw/plot.m @ 21580:ecce63c99c3f
maint: Add semicolons to terminate code in %! blocks.
* splineimages.m, Cell.cc, bsxfun.cc, cellfun.cc, conv2.cc, data.cc,
debug.cc, file-io.cc, gcd.cc, getrusage.cc, graphics.cc, kron.cc, mappers.cc,
oct-map.cc, ordschur.cc, psi.cc, rand.cc, variables.cc, __osmesa_print__.cc,
amd.cc, audiodevinfo.cc, dmperm.cc, qr.cc, ov-bool-mat.cc, ov-class.cc,
ov-fcn-handle.cc, ov-java.cc, oct-parse.in.yy, bicubic.m, delaunay3.m,
accumarray.m, flip.m, fliplr.m, flipud.m, gradient.m, inputParser.m, interp1.m,
narginchk.m, rot90.m, validateattributes.m, delaunay.m, delaunayn.m,
griddata3.m, inpolygon.m, waitbar.m, gray2ind.m, hsv2rgb.m, im2double.m,
image.m, imformats.m, imread.m, imshow.m, imwrite.m, ntsc2rgb.m, rgb2hsv.m,
rgb2ntsc.m, isbanded.m, onenormest.m, edit.m, fullfile.m, license.m, ode23.m,
ode45.m, glpk.m, annotation.m, legend.m, orient.m, text.m, area.m, barh.m,
contour.m, line.m, plot.m, plot3.m, plotyy.m, quiver.m, stem.m, clf.m,
copyobj.m, findobj.m, subplot.m, ppval.m, splinefit.m, ismember.m, freqz.m,
unwrap.m, eigs.m, ichol.m, pcg.m, spdiags.m, svds.m, magic.m, lscov.m,
median.m, ols.m, dec2base.m, strsplit.m, strtok.m, test.m, bug-31371.tst,
bug-36025.tst, bug-44940.tst, build-sparse-tests.sh, class-concat.tst,
classdef.tst, classes.tst, colormaps.tst, command.tst, ctor-vs-method.tst,
error.tst, fcn-handle-derived-resolution.tst, for.tst, index.tst, io.tst,
jit.tst, null-assign.tst, parser.tst, struct.tst, system.tst:
Add semicolons to terminate code in %! blocks.
author | Rik <rik@octave.org> |
---|---|
date | Fri, 01 Apr 2016 16:03:29 -0700 |
parents | 516bb87ea72e |
children | 1c4cd12987f5 |
rev | line source |
---|---|
19697
4197fc428c7d
maint: Update copyright notices for 2015.
John W. Eaton <jwe@octave.org>
parents:
19593
diff
changeset
|
1 ## Copyright (C) 1993-2015 John W. Eaton |
2313 | 2 ## |
3 ## This file is part of Octave. | |
4 ## | |
5 ## Octave is free software; you can redistribute it and/or modify it | |
6 ## under the terms of the GNU General Public License as published by | |
7016 | 7 ## the Free Software Foundation; either version 3 of the License, or (at |
8 ## your option) any later version. | |
2313 | 9 ## |
10 ## Octave is distributed in the hope that it will be useful, but | |
11 ## WITHOUT ANY WARRANTY; without even the implied warranty of | |
12 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
13 ## General Public License for more details. | |
14 ## | |
15 ## You should have received a copy of the GNU General Public License | |
7016 | 16 ## along with Octave; see the file COPYING. If not, see |
17 ## <http://www.gnu.org/licenses/>. | |
245 | 18 |
3368 | 19 ## -*- texinfo -*- |
20852
516bb87ea72e
2015 Code Sprint: remove class of function from docstring for all m-files.
Rik <rik@octave.org>
parents:
20715
diff
changeset
|
20 ## @deftypefn {} {} plot (@var{y}) |
516bb87ea72e
2015 Code Sprint: remove class of function from docstring for all m-files.
Rik <rik@octave.org>
parents:
20715
diff
changeset
|
21 ## @deftypefnx {} {} plot (@var{x}, @var{y}) |
516bb87ea72e
2015 Code Sprint: remove class of function from docstring for all m-files.
Rik <rik@octave.org>
parents:
20715
diff
changeset
|
22 ## @deftypefnx {} {} plot (@var{x}, @var{y}, @var{fmt}) |
516bb87ea72e
2015 Code Sprint: remove class of function from docstring for all m-files.
Rik <rik@octave.org>
parents:
20715
diff
changeset
|
23 ## @deftypefnx {} {} plot (@dots{}, @var{property}, @var{value}, @dots{}) |
516bb87ea72e
2015 Code Sprint: remove class of function from docstring for all m-files.
Rik <rik@octave.org>
parents:
20715
diff
changeset
|
24 ## @deftypefnx {} {} plot (@var{x1}, @var{y1}, @dots{}, @var{xn}, @var{yn}) |
516bb87ea72e
2015 Code Sprint: remove class of function from docstring for all m-files.
Rik <rik@octave.org>
parents:
20715
diff
changeset
|
25 ## @deftypefnx {} {} plot (@var{hax}, @dots{}) |
516bb87ea72e
2015 Code Sprint: remove class of function from docstring for all m-files.
Rik <rik@octave.org>
parents:
20715
diff
changeset
|
26 ## @deftypefnx {} {@var{h} =} plot (@dots{}) |
17122
eaab03308c0b
doc: Rewrite docstrings for most plot functions.
Rik <rik@octave.org>
parents:
17036
diff
changeset
|
27 ## Produce 2-D plots. |
11587
c792872f8942
all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents:
11523
diff
changeset
|
28 ## |
11316
b7ff4a51ea88
plot.m: Eliminate present tense in first sentence of docstring.
Rik <octave@nomad.inbox5.com>
parents:
10791
diff
changeset
|
29 ## Many different combinations of arguments are possible. The simplest |
b7ff4a51ea88
plot.m: Eliminate present tense in first sentence of docstring.
Rik <octave@nomad.inbox5.com>
parents:
10791
diff
changeset
|
30 ## form is |
3426 | 31 ## |
3368 | 32 ## @example |
33 ## plot (@var{y}) | |
34 ## @end example | |
3426 | 35 ## |
3368 | 36 ## @noindent |
37 ## where the argument is taken as the set of @var{y} coordinates and the | |
17191
85e55da61409
doc: Clarify description of plot format.
Rik <rik@octave.org>
parents:
17190
diff
changeset
|
38 ## @var{x} coordinates are taken to be the range @code{1:numel (@var{y})}. |
5798 | 39 ## |
3368 | 40 ## If more than one argument is given, they are interpreted as |
3426 | 41 ## |
3368 | 42 ## @example |
6895 | 43 ## plot (@var{y}, @var{property}, @var{value}, @dots{}) |
3368 | 44 ## @end example |
3426 | 45 ## |
3368 | 46 ## @noindent |
6895 | 47 ## or |
6459 | 48 ## |
49 ## @example | |
50 ## plot (@var{x}, @var{y}, @var{property}, @var{value}, @dots{}) | |
51 ## @end example | |
52 ## | |
53 ## @noindent | |
6895 | 54 ## or |
55 ## | |
56 ## @example | |
57 ## plot (@var{x}, @var{y}, @var{fmt}, @dots{}) | |
58 ## @end example | |
59 ## | |
60 ## @noindent | |
61 ## and so on. Any number of argument sets may appear. The @var{x} and | |
62 ## @var{y} values are interpreted as follows: | |
3426 | 63 ## |
3368 | 64 ## @itemize @bullet |
65 ## @item | |
66 ## If a single data argument is supplied, it is taken as the set of @var{y} | |
67 ## coordinates and the @var{x} coordinates are taken to be the indices of | |
68 ## the elements, starting with 1. | |
3426 | 69 ## |
3368 | 70 ## @item |
17191
85e55da61409
doc: Clarify description of plot format.
Rik <rik@octave.org>
parents:
17190
diff
changeset
|
71 ## If @var{x} and @var{y} are scalars, a single point is plotted. |
17388
e04847bbcfdf
Squeeze Nd > 2 plot vectors.
Ben Abbott <bpabbott@mac.com>
parents:
17301
diff
changeset
|
72 ## |
e04847bbcfdf
Squeeze Nd > 2 plot vectors.
Ben Abbott <bpabbott@mac.com>
parents:
17301
diff
changeset
|
73 ## @item |
e04847bbcfdf
Squeeze Nd > 2 plot vectors.
Ben Abbott <bpabbott@mac.com>
parents:
17301
diff
changeset
|
74 ## @code{squeeze()} is applied to arguments with more than two dimensions, |
e04847bbcfdf
Squeeze Nd > 2 plot vectors.
Ben Abbott <bpabbott@mac.com>
parents:
17301
diff
changeset
|
75 ## but no more than two singleton dimensions. |
19593
446c46af4b42
strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents:
17744
diff
changeset
|
76 ## |
17191
85e55da61409
doc: Clarify description of plot format.
Rik <rik@octave.org>
parents:
17190
diff
changeset
|
77 ## @item |
85e55da61409
doc: Clarify description of plot format.
Rik <rik@octave.org>
parents:
17190
diff
changeset
|
78 ## If both arguments are vectors, the elements of @var{y} are plotted versus |
85e55da61409
doc: Clarify description of plot format.
Rik <rik@octave.org>
parents:
17190
diff
changeset
|
79 ## the elements of @var{x}. |
85e55da61409
doc: Clarify description of plot format.
Rik <rik@octave.org>
parents:
17190
diff
changeset
|
80 ## |
85e55da61409
doc: Clarify description of plot format.
Rik <rik@octave.org>
parents:
17190
diff
changeset
|
81 ## @item |
85e55da61409
doc: Clarify description of plot format.
Rik <rik@octave.org>
parents:
17190
diff
changeset
|
82 ## If @var{x} is a vector and @var{y} is a matrix, then |
6177 | 83 ## the columns (or rows) of @var{y} are plotted versus @var{x}. |
2311 | 84 ## (using whichever combination matches, with columns tried first.) |
3426 | 85 ## |
3368 | 86 ## @item |
6177 | 87 ## If the @var{x} is a matrix and @var{y} is a vector, |
88 ## @var{y} is plotted versus the columns (or rows) of @var{x}. | |
2311 | 89 ## (using whichever combination matches, with columns tried first.) |
3426 | 90 ## |
3368 | 91 ## @item |
92 ## If both arguments are matrices, the columns of @var{y} are plotted | |
93 ## versus the columns of @var{x}. In this case, both matrices must have | |
94 ## the same number of rows and columns and no attempt is made to transpose | |
95 ## the arguments to make the number of rows match. | |
96 ## @end itemize | |
3426 | 97 ## |
6895 | 98 ## Multiple property-value pairs may be specified, but they must appear |
17122
eaab03308c0b
doc: Rewrite docstrings for most plot functions.
Rik <rik@octave.org>
parents:
17036
diff
changeset
|
99 ## in pairs. These arguments are applied to the line objects drawn by |
17281
bc924baa2c4e
doc: Add new @qcode macro for code samples which are quoted.
Rik <rik@octave.org>
parents:
17211
diff
changeset
|
100 ## @code{plot}. Useful properties to modify are @qcode{"linestyle"}, |
bc924baa2c4e
doc: Add new @qcode macro for code samples which are quoted.
Rik <rik@octave.org>
parents:
17211
diff
changeset
|
101 ## @qcode{"linewidth"}, @qcode{"color"}, @qcode{"marker"}, |
20715
5b7643257978
Remove trailing whitespace at end of lines.
Rik <rik@octave.org>
parents:
20635
diff
changeset
|
102 ## @qcode{"markersize"}, @qcode{"markeredgecolor"}, @qcode{"markerfacecolor"}. |
5b7643257978
Remove trailing whitespace at end of lines.
Rik <rik@octave.org>
parents:
20635
diff
changeset
|
103 ## @xref{Line Properties}. |
3426 | 104 ## |
17191
85e55da61409
doc: Clarify description of plot format.
Rik <rik@octave.org>
parents:
17190
diff
changeset
|
105 ## The @var{fmt} format argument can also be used to control the plot style. |
20635
410b1b3d109e
plot.m: use actual property names in the description FMT argument (bug #46240)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
19697
diff
changeset
|
106 ## It is a string composed of four optional parts: |
410b1b3d109e
plot.m: use actual property names in the description FMT argument (bug #46240)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
19697
diff
changeset
|
107 ## "<linestyle><marker><color><;displayname;>". |
410b1b3d109e
plot.m: use actual property names in the description FMT argument (bug #46240)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
19697
diff
changeset
|
108 ## When a marker is specified, but no linestyle, only the markers are |
410b1b3d109e
plot.m: use actual property names in the description FMT argument (bug #46240)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
19697
diff
changeset
|
109 ## plotted. Similarly, if a linestyle is specified, but no marker, then |
17191
85e55da61409
doc: Clarify description of plot format.
Rik <rik@octave.org>
parents:
17190
diff
changeset
|
110 ## only lines are drawn. If both are specified then lines and markers will |
85e55da61409
doc: Clarify description of plot format.
Rik <rik@octave.org>
parents:
17190
diff
changeset
|
111 ## be plotted. If no @var{fmt} and no @var{property}/@var{value} pairs are |
85e55da61409
doc: Clarify description of plot format.
Rik <rik@octave.org>
parents:
17190
diff
changeset
|
112 ## given, then the default plot style is solid lines with no markers and the |
17281
bc924baa2c4e
doc: Add new @qcode macro for code samples which are quoted.
Rik <rik@octave.org>
parents:
17211
diff
changeset
|
113 ## color determined by the @qcode{"colororder"} property of the current axes. |
3426 | 114 ## |
17191
85e55da61409
doc: Clarify description of plot format.
Rik <rik@octave.org>
parents:
17190
diff
changeset
|
115 ## Format arguments: |
3426 | 116 ## |
17191
85e55da61409
doc: Clarify description of plot format.
Rik <rik@octave.org>
parents:
17190
diff
changeset
|
117 ## @table @asis |
85e55da61409
doc: Clarify description of plot format.
Rik <rik@octave.org>
parents:
17190
diff
changeset
|
118 ## @item linestyle |
3426 | 119 ## |
17204
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
120 ## @multitable @columnfractions 0.06 0.94 |
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
121 ## @item @samp{-} @tab Use solid lines (default). |
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
122 ## @item @samp{--} @tab Use dashed lines. |
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
123 ## @item @samp{:} @tab Use dotted lines. |
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
124 ## @item @samp{-.} @tab Use dash-dotted lines. |
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
125 ## @end multitable |
3426 | 126 ## |
20635
410b1b3d109e
plot.m: use actual property names in the description FMT argument (bug #46240)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
19697
diff
changeset
|
127 ## @item marker |
17191
85e55da61409
doc: Clarify description of plot format.
Rik <rik@octave.org>
parents:
17190
diff
changeset
|
128 ## |
17204
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
129 ## @multitable @columnfractions 0.06 0.94 |
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
130 ## @item @samp{+} @tab crosshair |
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
131 ## @item @samp{o} @tab circle |
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
132 ## @item @samp{*} @tab star |
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
133 ## @item @samp{.} @tab point |
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
134 ## @item @samp{x} @tab cross |
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
135 ## @item @samp{s} @tab square |
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
136 ## @item @samp{d} @tab diamond |
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
137 ## @item @samp{^} @tab upward-facing triangle |
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
138 ## @item @samp{v} @tab downward-facing triangle |
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
139 ## @item @samp{>} @tab right-facing triangle |
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
140 ## @item @samp{<} @tab left-facing triangle |
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
141 ## @item @samp{p} @tab pentagram |
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
142 ## @item @samp{h} @tab hexagram |
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
143 ## @end multitable |
17191
85e55da61409
doc: Clarify description of plot format.
Rik <rik@octave.org>
parents:
17190
diff
changeset
|
144 ## |
85e55da61409
doc: Clarify description of plot format.
Rik <rik@octave.org>
parents:
17190
diff
changeset
|
145 ## @item color |
85e55da61409
doc: Clarify description of plot format.
Rik <rik@octave.org>
parents:
17190
diff
changeset
|
146 ## |
17204
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
147 ## @multitable @columnfractions 0.06 0.94 |
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
148 ## @item @samp{k} @tab blacK |
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
149 ## @item @samp{r} @tab Red |
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
150 ## @item @samp{g} @tab Green |
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
151 ## @item @samp{b} @tab Blue |
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
152 ## @item @samp{m} @tab Magenta |
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
153 ## @item @samp{c} @tab Cyan |
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
154 ## @item @samp{w} @tab White |
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
155 ## @end multitable |
17191
85e55da61409
doc: Clarify description of plot format.
Rik <rik@octave.org>
parents:
17190
diff
changeset
|
156 ## |
20635
410b1b3d109e
plot.m: use actual property names in the description FMT argument (bug #46240)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
19697
diff
changeset
|
157 ## @item @qcode{";displayname;"} |
410b1b3d109e
plot.m: use actual property names in the description FMT argument (bug #46240)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
19697
diff
changeset
|
158 ## Here @qcode{"displayname"} is the label to use for the plot legend. |
17191
85e55da61409
doc: Clarify description of plot format.
Rik <rik@octave.org>
parents:
17190
diff
changeset
|
159 ## @end table |
85e55da61409
doc: Clarify description of plot format.
Rik <rik@octave.org>
parents:
17190
diff
changeset
|
160 ## |
20635
410b1b3d109e
plot.m: use actual property names in the description FMT argument (bug #46240)
Pantxo Diribarne <pantxo.diribarne@gmail.com>
parents:
19697
diff
changeset
|
161 ## The @var{fmt} argument may also be used to assign legend labels. |
17191
85e55da61409
doc: Clarify description of plot format.
Rik <rik@octave.org>
parents:
17190
diff
changeset
|
162 ## To do so, include the desired label between semicolons after the |
17281
bc924baa2c4e
doc: Add new @qcode macro for code samples which are quoted.
Rik <rik@octave.org>
parents:
17211
diff
changeset
|
163 ## formatting sequence described above, e.g., @qcode{"+b;Key Title;"}. |
17204
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
164 ## Note that the last semicolon is required and Octave will generate |
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
165 ## an error if it is left out. |
3683 | 166 ## |
3368 | 167 ## Here are some plot examples: |
3426 | 168 ## |
3368 | 169 ## @example |
17191
85e55da61409
doc: Clarify description of plot format.
Rik <rik@octave.org>
parents:
17190
diff
changeset
|
170 ## plot (x, y, "or", x, y2, x, y3, "m", x, y4, "+") |
3368 | 171 ## @end example |
3426 | 172 ## |
17191
85e55da61409
doc: Clarify description of plot format.
Rik <rik@octave.org>
parents:
17190
diff
changeset
|
173 ## This command will plot @code{y} with red circles, @code{y2} with solid |
85e55da61409
doc: Clarify description of plot format.
Rik <rik@octave.org>
parents:
17190
diff
changeset
|
174 ## lines, @code{y3} with solid magenta lines, and @code{y4} with points |
85e55da61409
doc: Clarify description of plot format.
Rik <rik@octave.org>
parents:
17190
diff
changeset
|
175 ## displayed as @samp{+}. |
3426 | 176 ## |
3368 | 177 ## @example |
17191
85e55da61409
doc: Clarify description of plot format.
Rik <rik@octave.org>
parents:
17190
diff
changeset
|
178 ## plot (b, "*", "markersize", 10) |
3368 | 179 ## @end example |
3426 | 180 ## |
6672 | 181 ## This command will plot the data in the variable @code{b}, |
17204
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
182 ## with points displayed as @samp{*} and a marker size of 10. |
3683 | 183 ## |
184 ## @example | |
9051
1bf0ce0930be
Grammar check TexInfo in all .m files
Rik <rdrider0-list@yahoo.com>
parents:
9040
diff
changeset
|
185 ## @group |
3683 | 186 ## t = 0:0.1:6.3; |
17191
85e55da61409
doc: Clarify description of plot format.
Rik <rik@octave.org>
parents:
17190
diff
changeset
|
187 ## plot (t, cos(t), "-;cos(t);", t, sin(t), "-b;sin(t);"); |
9051
1bf0ce0930be
Grammar check TexInfo in all .m files
Rik <rdrider0-list@yahoo.com>
parents:
9040
diff
changeset
|
188 ## @end group |
3683 | 189 ## @end example |
190 ## | |
191 ## This will plot the cosine and sine functions and label them accordingly | |
17204
d87179b38bcf
doc: Touch up alignment of @multitables in plot, legend, newplot.
Rik <rik@octave.org>
parents:
17191
diff
changeset
|
192 ## in the legend. |
6820 | 193 ## |
17122
eaab03308c0b
doc: Rewrite docstrings for most plot functions.
Rik <rik@octave.org>
parents:
17036
diff
changeset
|
194 ## If the first argument @var{hax} is an axes handle, then plot into this axis, |
eaab03308c0b
doc: Rewrite docstrings for most plot functions.
Rik <rik@octave.org>
parents:
17036
diff
changeset
|
195 ## rather than the current axes returned by @code{gca}. |
11587
c792872f8942
all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents:
11523
diff
changeset
|
196 ## |
17122
eaab03308c0b
doc: Rewrite docstrings for most plot functions.
Rik <rik@octave.org>
parents:
17036
diff
changeset
|
197 ## The optional return value @var{h} is a vector of graphics handles to |
eaab03308c0b
doc: Rewrite docstrings for most plot functions.
Rik <rik@octave.org>
parents:
17036
diff
changeset
|
198 ## the created line objects. |
14001
5f0bb45e615c
doc: Update documentation for functions returning a graphics handle h (Bug #34761)
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
199 ## |
17191
85e55da61409
doc: Clarify description of plot format.
Rik <rik@octave.org>
parents:
17190
diff
changeset
|
200 ## To save a plot, in one of several image formats such as PostScript |
85e55da61409
doc: Clarify description of plot format.
Rik <rik@octave.org>
parents:
17190
diff
changeset
|
201 ## or PNG, use the @code{print} command. |
85e55da61409
doc: Clarify description of plot format.
Rik <rik@octave.org>
parents:
17190
diff
changeset
|
202 ## |
17122
eaab03308c0b
doc: Rewrite docstrings for most plot functions.
Rik <rik@octave.org>
parents:
17036
diff
changeset
|
203 ## @seealso{axis, box, grid, hold, legend, title, xlabel, ylabel, xlim, ylim, ezplot, errorbar, fplot, line, plot3, polar, loglog, semilogx, semilogy, subplot} |
3368 | 204 ## @end deftypefn |
4 | 205 |
2314 | 206 ## Author: jwe |
207 | |
17036
08dd9458684a
Overhaul __plt_get_axis_arg__ and newplot functions to avoid creating unnecessary axes.
Rik <rik@octave.org>
parents:
15015
diff
changeset
|
208 function h = plot (varargin) |
4 | 209 |
17036
08dd9458684a
Overhaul __plt_get_axis_arg__ and newplot functions to avoid creating unnecessary axes.
Rik <rik@octave.org>
parents:
15015
diff
changeset
|
210 [hax, varargin, nargs] = __plt_get_axis_arg__ ("plot", varargin{:}); |
10730
390d93e20531
Plot commands now print usage information without errors
Rik <octave@nomad.inbox5.com>
parents:
10687
diff
changeset
|
211 |
390d93e20531
Plot commands now print usage information without errors
Rik <octave@nomad.inbox5.com>
parents:
10687
diff
changeset
|
212 if (nargs < 1) |
14846
460a3c6d8bf1
maint: Use Octave coding convention for cuddled parenthis in function calls with empty argument lists.
Rik <octave@nomad.inbox5.com>
parents:
14138
diff
changeset
|
213 print_usage (); |
10730
390d93e20531
Plot commands now print usage information without errors
Rik <octave@nomad.inbox5.com>
parents:
10687
diff
changeset
|
214 endif |
7216 | 215 |
17211
87ba70043bfc
Don't use ifelse in plot fcns to avoid unnecessary fcn evaluations.
Rik <rik@octave.org>
parents:
17204
diff
changeset
|
216 oldfig = []; |
17301
68bcac3c043a
Correct inversion accidentally introduced in cset 87ba70043bfc.
Rik <rik@octave.org>
parents:
17281
diff
changeset
|
217 if (! isempty (hax)) |
17211
87ba70043bfc
Don't use ifelse in plot fcns to avoid unnecessary fcn evaluations.
Rik <rik@octave.org>
parents:
17204
diff
changeset
|
218 oldfig = get (0, "currentfigure"); |
87ba70043bfc
Don't use ifelse in plot fcns to avoid unnecessary fcn evaluations.
Rik <rik@octave.org>
parents:
17204
diff
changeset
|
219 endif |
7215 | 220 unwind_protect |
17036
08dd9458684a
Overhaul __plt_get_axis_arg__ and newplot functions to avoid creating unnecessary axes.
Rik <rik@octave.org>
parents:
15015
diff
changeset
|
221 hax = newplot (hax); |
08dd9458684a
Overhaul __plt_get_axis_arg__ and newplot functions to avoid creating unnecessary axes.
Rik <rik@octave.org>
parents:
15015
diff
changeset
|
222 htmp = __plt__ ("plot", hax, varargin{:}); |
7215 | 223 unwind_protect_cleanup |
17036
08dd9458684a
Overhaul __plt_get_axis_arg__ and newplot functions to avoid creating unnecessary axes.
Rik <rik@octave.org>
parents:
15015
diff
changeset
|
224 if (! isempty (oldfig)) |
08dd9458684a
Overhaul __plt_get_axis_arg__ and newplot functions to avoid creating unnecessary axes.
Rik <rik@octave.org>
parents:
15015
diff
changeset
|
225 set (0, "currentfigure", oldfig); |
08dd9458684a
Overhaul __plt_get_axis_arg__ and newplot functions to avoid creating unnecessary axes.
Rik <rik@octave.org>
parents:
15015
diff
changeset
|
226 endif |
7215 | 227 end_unwind_protect |
6302 | 228 |
229 if (nargout > 0) | |
17036
08dd9458684a
Overhaul __plt_get_axis_arg__ and newplot functions to avoid creating unnecessary axes.
Rik <rik@octave.org>
parents:
15015
diff
changeset
|
230 h = htmp; |
6302 | 231 endif |
4 | 232 |
233 endfunction | |
14001
5f0bb45e615c
doc: Update documentation for functions returning a graphics handle h (Bug #34761)
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
234 |
5f0bb45e615c
doc: Update documentation for functions returning a graphics handle h (Bug #34761)
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
235 |
15015 | 236 %!demo |
237 %! x = 1:5; y = 1:5; | |
238 %! plot (x,y,'g'); | |
17190
df4c4b7708a4
Add titles and clean-up plotting %!demos.
Rik <rik@octave.org>
parents:
17122
diff
changeset
|
239 %! title ('plot() of green line at 45 degrees'); |
14001
5f0bb45e615c
doc: Update documentation for functions returning a graphics handle h (Bug #34761)
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
240 |
15015 | 241 %!demo |
242 %! x = 1:5; y = 1:5; | |
243 %! plot (x,y,'g*'); | |
17190
df4c4b7708a4
Add titles and clean-up plotting %!demos.
Rik <rik@octave.org>
parents:
17122
diff
changeset
|
244 %! title ('plot() of green stars along a line at 45 degrees'); |
15015 | 245 |
246 %!demo | |
247 %! x1 = 1:5; y1 = 1:5; | |
248 %! x2 = 5:9; y2 = 5:-1:1; | |
249 %! plot (x1,y1,'bo-', x2,y2,'rs-'); | |
250 %! axis ('tight'); | |
17190
df4c4b7708a4
Add titles and clean-up plotting %!demos.
Rik <rik@octave.org>
parents:
17122
diff
changeset
|
251 %! title ({'plot() of blue circles ascending and red squares descending'; |
19593
446c46af4b42
strip trailing whitespace from most source files
John W. Eaton <jwe@octave.org>
parents:
17744
diff
changeset
|
252 %! 'connecting lines drawn'}); |
15015 | 253 |
17388
e04847bbcfdf
Squeeze Nd > 2 plot vectors.
Ben Abbott <bpabbott@mac.com>
parents:
17301
diff
changeset
|
254 %!demo |
e04847bbcfdf
Squeeze Nd > 2 plot vectors.
Ben Abbott <bpabbott@mac.com>
parents:
17301
diff
changeset
|
255 %! x = 0:10; |
21580
ecce63c99c3f
maint: Add semicolons to terminate code in %! blocks.
Rik <rik@octave.org>
parents:
20852
diff
changeset
|
256 %! plot (x, rand (numel (x), 3)); |
ecce63c99c3f
maint: Add semicolons to terminate code in %! blocks.
Rik <rik@octave.org>
parents:
20852
diff
changeset
|
257 %! axis ([0 10 0 1]); |
ecce63c99c3f
maint: Add semicolons to terminate code in %! blocks.
Rik <rik@octave.org>
parents:
20852
diff
changeset
|
258 %! title ({'Three random variables', 'x[1x11], y[11x3]'}); |
17388
e04847bbcfdf
Squeeze Nd > 2 plot vectors.
Ben Abbott <bpabbott@mac.com>
parents:
17301
diff
changeset
|
259 |
e04847bbcfdf
Squeeze Nd > 2 plot vectors.
Ben Abbott <bpabbott@mac.com>
parents:
17301
diff
changeset
|
260 %!demo |
e04847bbcfdf
Squeeze Nd > 2 plot vectors.
Ben Abbott <bpabbott@mac.com>
parents:
17301
diff
changeset
|
261 %! x = 0:10; |
21580
ecce63c99c3f
maint: Add semicolons to terminate code in %! blocks.
Rik <rik@octave.org>
parents:
20852
diff
changeset
|
262 %! plot (x, rand (3, numel (x))); |
ecce63c99c3f
maint: Add semicolons to terminate code in %! blocks.
Rik <rik@octave.org>
parents:
20852
diff
changeset
|
263 %! axis ([0 10 0 1]); |
ecce63c99c3f
maint: Add semicolons to terminate code in %! blocks.
Rik <rik@octave.org>
parents:
20852
diff
changeset
|
264 %! title ({'Three random variables', 'x[1x11], y[3x11]'}); |
17388
e04847bbcfdf
Squeeze Nd > 2 plot vectors.
Ben Abbott <bpabbott@mac.com>
parents:
17301
diff
changeset
|
265 |
e04847bbcfdf
Squeeze Nd > 2 plot vectors.
Ben Abbott <bpabbott@mac.com>
parents:
17301
diff
changeset
|
266 %!demo |
e04847bbcfdf
Squeeze Nd > 2 plot vectors.
Ben Abbott <bpabbott@mac.com>
parents:
17301
diff
changeset
|
267 %! x = 0:10; |
21580
ecce63c99c3f
maint: Add semicolons to terminate code in %! blocks.
Rik <rik@octave.org>
parents:
20852
diff
changeset
|
268 %! plot (repmat (x, 2, 1), rand (2, numel (x)), '-s'); |
ecce63c99c3f
maint: Add semicolons to terminate code in %! blocks.
Rik <rik@octave.org>
parents:
20852
diff
changeset
|
269 %! axis ([0 10 0 1]); |
17530 | 270 %! title ({'Vertical lines with random height and lengths', ... |
17388
e04847bbcfdf
Squeeze Nd > 2 plot vectors.
Ben Abbott <bpabbott@mac.com>
parents:
17301
diff
changeset
|
271 %! 'x[2x11], y[2,11]'}) |
e04847bbcfdf
Squeeze Nd > 2 plot vectors.
Ben Abbott <bpabbott@mac.com>
parents:
17301
diff
changeset
|
272 |
e04847bbcfdf
Squeeze Nd > 2 plot vectors.
Ben Abbott <bpabbott@mac.com>
parents:
17301
diff
changeset
|
273 %!demo |
e04847bbcfdf
Squeeze Nd > 2 plot vectors.
Ben Abbott <bpabbott@mac.com>
parents:
17301
diff
changeset
|
274 %! x = 0:10; |
21580
ecce63c99c3f
maint: Add semicolons to terminate code in %! blocks.
Rik <rik@octave.org>
parents:
20852
diff
changeset
|
275 %! plot (repmat (x(:), 1, 2), rand (numel (x), 2)); |
ecce63c99c3f
maint: Add semicolons to terminate code in %! blocks.
Rik <rik@octave.org>
parents:
20852
diff
changeset
|
276 %! axis ([0 10 0 1]); |
ecce63c99c3f
maint: Add semicolons to terminate code in %! blocks.
Rik <rik@octave.org>
parents:
20852
diff
changeset
|
277 %! title ({'Two random variables', 'x[11x2], y[11x2]'}); |
17388
e04847bbcfdf
Squeeze Nd > 2 plot vectors.
Ben Abbott <bpabbott@mac.com>
parents:
17301
diff
changeset
|
278 |
e04847bbcfdf
Squeeze Nd > 2 plot vectors.
Ben Abbott <bpabbott@mac.com>
parents:
17301
diff
changeset
|
279 %!demo |
e04847bbcfdf
Squeeze Nd > 2 plot vectors.
Ben Abbott <bpabbott@mac.com>
parents:
17301
diff
changeset
|
280 %! x = 0:10; |
e04847bbcfdf
Squeeze Nd > 2 plot vectors.
Ben Abbott <bpabbott@mac.com>
parents:
17301
diff
changeset
|
281 %! shape = [1, 1, numel(x), 2]; |
e04847bbcfdf
Squeeze Nd > 2 plot vectors.
Ben Abbott <bpabbott@mac.com>
parents:
17301
diff
changeset
|
282 %! x = reshape (repmat (x(:), 1, 2), shape); |
e04847bbcfdf
Squeeze Nd > 2 plot vectors.
Ben Abbott <bpabbott@mac.com>
parents:
17301
diff
changeset
|
283 %! y = rand (shape); |
21580
ecce63c99c3f
maint: Add semicolons to terminate code in %! blocks.
Rik <rik@octave.org>
parents:
20852
diff
changeset
|
284 %! plot (x, y); |
ecce63c99c3f
maint: Add semicolons to terminate code in %! blocks.
Rik <rik@octave.org>
parents:
20852
diff
changeset
|
285 %! axis ([0 10 0 1]); |
ecce63c99c3f
maint: Add semicolons to terminate code in %! blocks.
Rik <rik@octave.org>
parents:
20852
diff
changeset
|
286 %! title ({'Two random variables', 'squeezed from 4-d arrays'}); |
17388
e04847bbcfdf
Squeeze Nd > 2 plot vectors.
Ben Abbott <bpabbott@mac.com>
parents:
17301
diff
changeset
|
287 |