Mercurial > octave-nkf
annotate scripts/plot/stem3.m @ 8052:961d4c52ffae
Convert stem and stem3 to use stem series objects
* * *
Use property inheritance and don't call drawnow in __stem__
| author | David Bateman <dbateman@free.fr> |
|---|---|
| date | Mon, 25 Aug 2008 15:45:24 -0400 |
| parents | d65670971cbc |
| children | eb63fbe60fab |
| rev | line source |
|---|---|
| 7217 | 1 ## Copyright (C) 2007 David Bateman |
| 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 | |
| 7 ## the Free Software Foundation; either version 3 of the License, or (at | |
| 8 ## your option) any later version. | |
| 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 | |
| 16 ## along with Octave; see the file COPYING. If not, see | |
| 17 ## <http://www.gnu.org/licenses/>. | |
| 18 | |
| 19 ## -*- texinfo -*- | |
| 20 ## @deftypefn {Function File} {@var{h} =} stem3 (@var{x}, @var{y}, @var{z}, @var{linespec}) | |
| 21 ## Plot a three-dimensional stem graph and return the handles of the line | |
|
8052
961d4c52ffae
Convert stem and stem3 to use stem series objects
David Bateman <dbateman@free.fr>
parents:
7245
diff
changeset
|
22 ## and marker objects used to draw the stems as "stem series" object. |
|
961d4c52ffae
Convert stem and stem3 to use stem series objects
David Bateman <dbateman@free.fr>
parents:
7245
diff
changeset
|
23 ## The default color is @code{"r"} (red). The default line style is |
|
961d4c52ffae
Convert stem and stem3 to use stem series objects
David Bateman <dbateman@free.fr>
parents:
7245
diff
changeset
|
24 ## @code{"-"} and the default marker is @code{"o"}. |
| 7217 | 25 ## |
| 26 ## For example, | |
| 27 ## @example | |
| 28 ## theta = 0:0.2:6; | |
| 29 ## stem3 (cos (theta), sin (theta), theta) | |
| 30 ## @end example | |
| 31 ## | |
| 32 ## @noindent | |
| 33 ## plots 31 stems with heights from 0 to 6 lying on a circle. Color | |
| 34 ## definitions with rgb-triples are not valid! | |
| 35 ## @seealso{bar, barh, stem, plot} | |
| 36 ## @end deftypefn | |
| 37 | |
| 38 function h = stem3 (varargin) | |
| 39 | |
| 7219 | 40 if (nargin < 1 || nargin > 4) |
| 7218 | 41 print_usage (); |
| 42 endif | |
| 43 | |
| 7217 | 44 tmp = __stem__ (true, varargin{:}); |
| 45 | |
| 46 if (nargout > 0) | |
| 47 h = tmp; | |
| 48 endif | |
| 49 | |
| 50 endfunction | |
| 7245 | 51 |
| 52 %!demo | |
| 53 %! theta = 0:0.2:6; | |
| 54 %! stem3 (cos (theta), sin (theta), theta) |