Mercurial > hg > octave-lyh
annotate scripts/plot/peaks.m @ 17535:c12c688a35ed default tip lyh
Fix warnings
author | LYH <lyh.kernel@gmail.com> |
---|---|
date | Fri, 27 Sep 2013 17:43:27 +0800 |
parents | 1c89599167a6 |
children |
rev | line source |
---|---|
14138
72c96de7a403
maint: update copyright notices for 2012
John W. Eaton <jwe@octave.org>
parents:
11587
diff
changeset
|
1 ## Copyright (C) 2007-2012 Paul Kienzle |
6788 | 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. | |
6788 | 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/>. | |
6788 | 18 |
19 ## -*- texinfo -*- | |
10793
be55736a0783
Grammarcheck the documentation from m-files.
Rik <octave@nomad.inbox5.com>
parents:
9245
diff
changeset
|
20 ## @deftypefn {Function File} {} peaks () |
6788 | 21 ## @deftypefnx {Function File} {} peaks (@var{n}) |
22 ## @deftypefnx {Function File} {} peaks (@var{x}, @var{y}) | |
23 ## @deftypefnx {Function File} {@var{z} =} peaks (@dots{}) | |
24 ## @deftypefnx {Function File} {[@var{x}, @var{y}, @var{z}] =} peaks (@dots{}) | |
17126
eaab03308c0b
doc: Rewrite docstrings for most plot functions.
Rik <rik@octave.org>
parents:
14868
diff
changeset
|
25 ## Plot a function with lots of local maxima and minima. |
eaab03308c0b
doc: Rewrite docstrings for most plot functions.
Rik <rik@octave.org>
parents:
14868
diff
changeset
|
26 ## |
eaab03308c0b
doc: Rewrite docstrings for most plot functions.
Rik <rik@octave.org>
parents:
14868
diff
changeset
|
27 ## The function has the form |
6788 | 28 ## |
29 ## @tex | |
17126
eaab03308c0b
doc: Rewrite docstrings for most plot functions.
Rik <rik@octave.org>
parents:
14868
diff
changeset
|
30 ## $$f(x,y) = 3 (1 - x) ^ 2 e ^ {\left(-x^2 - (y+1)^2\right)} - 10 \left({x \over 5} - x^3 - y^5)\right) - {1 \over 3} e^{\left(-(x+1)^2 - y^2\right)}$$ |
6788 | 31 ## @end tex |
32 ## @ifnottex | |
33 ## @verbatim | |
34 ## f(x,y) = 3*(1-x)^2*exp(-x^2 - (y+1)^2) ... | |
35 ## - 10*(x/5 - x^3 - y^5)*exp(-x^2-y^2) ... | |
36 ## - 1/3*exp(-(x+1)^2 - y^2) | |
37 ## @end verbatim | |
38 ## @end ifnottex | |
39 ## | |
11587
c792872f8942
all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents:
11523
diff
changeset
|
40 ## Called without a return argument, @code{peaks} plots the surface of the |
17126
eaab03308c0b
doc: Rewrite docstrings for most plot functions.
Rik <rik@octave.org>
parents:
14868
diff
changeset
|
41 ## above function using @code{surf}. |
eaab03308c0b
doc: Rewrite docstrings for most plot functions.
Rik <rik@octave.org>
parents:
14868
diff
changeset
|
42 ## |
eaab03308c0b
doc: Rewrite docstrings for most plot functions.
Rik <rik@octave.org>
parents:
14868
diff
changeset
|
43 ## If @var{n} is a scalar, @code{peaks} plots the value of the above |
eaab03308c0b
doc: Rewrite docstrings for most plot functions.
Rik <rik@octave.org>
parents:
14868
diff
changeset
|
44 ## function on an @var{n}-by-@var{n} mesh over the range [-3,3]. The |
eaab03308c0b
doc: Rewrite docstrings for most plot functions.
Rik <rik@octave.org>
parents:
14868
diff
changeset
|
45 ## default value for @var{n} is 49. |
6788 | 46 ## |
17126
eaab03308c0b
doc: Rewrite docstrings for most plot functions.
Rik <rik@octave.org>
parents:
14868
diff
changeset
|
47 ## If @var{n} is a vector, then it represents the grid values over which |
eaab03308c0b
doc: Rewrite docstrings for most plot functions.
Rik <rik@octave.org>
parents:
14868
diff
changeset
|
48 ## to calculate the function. If @var{x} and @var{y} are specified then |
eaab03308c0b
doc: Rewrite docstrings for most plot functions.
Rik <rik@octave.org>
parents:
14868
diff
changeset
|
49 ## the function value is calculated over the specified grid of vertices. |
eaab03308c0b
doc: Rewrite docstrings for most plot functions.
Rik <rik@octave.org>
parents:
14868
diff
changeset
|
50 ## |
eaab03308c0b
doc: Rewrite docstrings for most plot functions.
Rik <rik@octave.org>
parents:
14868
diff
changeset
|
51 ## When called with output arguments, return the data for the function |
eaab03308c0b
doc: Rewrite docstrings for most plot functions.
Rik <rik@octave.org>
parents:
14868
diff
changeset
|
52 ## evaluated over the meshgrid. This can subsequently be plotted with |
eaab03308c0b
doc: Rewrite docstrings for most plot functions.
Rik <rik@octave.org>
parents:
14868
diff
changeset
|
53 ## @code{surf (@var{x}, @var{y}, @var{z})}. |
eaab03308c0b
doc: Rewrite docstrings for most plot functions.
Rik <rik@octave.org>
parents:
14868
diff
changeset
|
54 ## |
eaab03308c0b
doc: Rewrite docstrings for most plot functions.
Rik <rik@octave.org>
parents:
14868
diff
changeset
|
55 ## @seealso{sombrero, meshgrid, mesh, surf} |
6788 | 56 ## @end deftypefn |
57 | |
6895 | 58 ## Expression for the peaks function was taken from the following paper: |
59 ## http://www.control.hut.fi/Kurssit/AS-74.115/Material/GENALGgoga.pdf | |
60 | |
6788 | 61 function [X_out, Y_out, Z_out] = peaks (x, y) |
62 | |
7216 | 63 if (nargin == 0) |
64 x = y = linspace (-3, 3, 49); | |
65 elseif (nargin == 1) | |
14552
86854d032a37
maint: miscellaneous style fixes for .m files
John W. Eaton <jwe@octave.org>
parents:
14138
diff
changeset
|
66 if (length (x) > 1) |
6788 | 67 y = x; |
68 else | |
7216 | 69 x = y = linspace (-3, 3, x); |
6788 | 70 endif |
71 endif | |
72 | |
7216 | 73 if (isvector (x) && isvector (y)) |
6788 | 74 [X, Y] = meshgrid (x, y); |
75 else | |
76 X = x; | |
77 Y = y; | |
78 endif | |
79 | |
14868
5d3a684236b0
maint: Use Octave coding conventions for cuddling parentheses in scripts directory
Rik <octave@nomad.inbox5.com>
parents:
14552
diff
changeset
|
80 Z = 3 * (1 - X) .^ 2 .* exp (- X .^ 2 - (Y + 1) .^ 2) ... |
5d3a684236b0
maint: Use Octave coding conventions for cuddling parentheses in scripts directory
Rik <octave@nomad.inbox5.com>
parents:
14552
diff
changeset
|
81 - 10 * (X / 5 - X .^ 3 - Y .^ 5) .* exp (- X .^ 2 - Y .^ 2) ... |
5d3a684236b0
maint: Use Octave coding conventions for cuddling parentheses in scripts directory
Rik <octave@nomad.inbox5.com>
parents:
14552
diff
changeset
|
82 - 1 / 3 * exp (- (X + 1) .^ 2 - Y .^ 2); |
6788 | 83 |
7216 | 84 if (nargout == 0) |
7282 | 85 surf (x, y, Z); |
7216 | 86 elseif (nargout == 1) |
6788 | 87 X_out = Z; |
88 else | |
89 X_out = X; | |
90 Y_out = Y; | |
91 Z_out = Z; | |
92 endif | |
93 | |
94 endfunction | |
17346
1c89599167a6
maint: End m-files with 1 blank line.
Rik <rik@octave.org>
parents:
17126
diff
changeset
|
95 |