octave-nkf: scripts/plot/draw/fplot.m annotate

annotate scripts/plot/draw/fplot.m @ 20830:b65888ec820e draft default tip gccjit

dmalcom gcc jit import

author	Stefan Mahr <dac922@gmx.de>
date	Fri, 27 Feb 2015 16:59:36 +0100
parents	59911f536b07
children

rev	line source
19898 4197fc428c7d maint: Update copyright notices for 2015. John W. Eaton <jwe@octave.org> parents: 19790 diff changeset	1 ## Copyright (C) 2005-2015 Paul Kienzle
5820 27c966e4b2dc [project @ 2006-05-17 21:00:54 by jwe] jwe parents: diff changeset	2 ##
27c966e4b2dc [project @ 2006-05-17 21:00:54 by jwe] jwe parents: diff changeset	3 ## This file is part of Octave.
27c966e4b2dc [project @ 2006-05-17 21:00:54 by jwe] jwe parents: diff changeset	4 ##
27c966e4b2dc [project @ 2006-05-17 21:00:54 by jwe] jwe parents: diff changeset	5 ## Octave is free software; you can redistribute it and/or modify it
27c966e4b2dc [project @ 2006-05-17 21:00:54 by jwe] jwe parents: diff changeset	6 ## under the terms of the GNU General Public License as published by
7016 93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe] jwe parents: 6895 diff changeset	7 ## the Free Software Foundation; either version 3 of the License, or (at
93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe] jwe parents: 6895 diff changeset	8 ## your option) any later version.
5820 27c966e4b2dc [project @ 2006-05-17 21:00:54 by jwe] jwe parents: diff changeset	9 ##
27c966e4b2dc [project @ 2006-05-17 21:00:54 by jwe] jwe parents: diff changeset	10 ## Octave is distributed in the hope that it will be useful, but
27c966e4b2dc [project @ 2006-05-17 21:00:54 by jwe] jwe parents: diff changeset	11 ## WITHOUT ANY WARRANTY; without even the implied warranty of
27c966e4b2dc [project @ 2006-05-17 21:00:54 by jwe] jwe parents: diff changeset	12 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
27c966e4b2dc [project @ 2006-05-17 21:00:54 by jwe] jwe parents: diff changeset	13 ## General Public License for more details.
27c966e4b2dc [project @ 2006-05-17 21:00:54 by jwe] jwe parents: diff changeset	14 ##
27c966e4b2dc [project @ 2006-05-17 21:00:54 by jwe] jwe parents: diff changeset	15 ## You should have received a copy of the GNU General Public License
7016 93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe] jwe parents: 6895 diff changeset	16 ## along with Octave; see the file COPYING. If not, see
93c65f2a5668 [project @ 2007-10-12 06:40:56 by jwe] jwe parents: 6895 diff changeset	17 ## <http://www.gnu.org/licenses/>.
5820 27c966e4b2dc [project @ 2006-05-17 21:00:54 by jwe] jwe parents: diff changeset	18
27c966e4b2dc [project @ 2006-05-17 21:00:54 by jwe] jwe parents: diff changeset	19 ## -- texinfo --
10793 be55736a0783 Grammarcheck the documentation from m-files. Rik <octave@nomad.inbox5.com> parents: 10549 diff changeset	20 ## @deftypefn {Function File} {} fplot (@var{fn}, @var{limits})
17479 bdb237c7507c doc: Redo fplot docstring. Rik <rik@octave.org> parents: 17190 diff changeset	21 ## @deftypefnx {Function File} {} fplot (@dots{}, @var{tol})
bdb237c7507c doc: Redo fplot docstring. Rik <rik@octave.org> parents: 17190 diff changeset	22 ## @deftypefnx {Function File} {} fplot (@dots{}, @var{n})
bdb237c7507c doc: Redo fplot docstring. Rik <rik@octave.org> parents: 17190 diff changeset	23 ## @deftypefnx {Function File} {} fplot (@dots{}, @var{fmt})
16950 b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	24 ## @deftypefnx {Function File} {[@var{x}, @var{y}] =} fplot (@dots{})
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	25 ## Plot a function @var{fn} within the range defined by @var{limits}.
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	26 ##
17479 bdb237c7507c doc: Redo fplot docstring. Rik <rik@octave.org> parents: 17190 diff changeset	27 ## @var{fn} is a function handle, inline function, or string containing the
bdb237c7507c doc: Redo fplot docstring. Rik <rik@octave.org> parents: 17190 diff changeset	28 ## name of the function to evaluate.
bdb237c7507c doc: Redo fplot docstring. Rik <rik@octave.org> parents: 17190 diff changeset	29 ##
bdb237c7507c doc: Redo fplot docstring. Rik <rik@octave.org> parents: 17190 diff changeset	30 ## The limits of the plot are of the form @w{@code{[@var{xlo}, @var{xhi}]}} or
bdb237c7507c doc: Redo fplot docstring. Rik <rik@octave.org> parents: 17190 diff changeset	31 ## @w{@code{[@var{xlo}, @var{xhi}, @var{ylo}, @var{yhi}]}}.
bdb237c7507c doc: Redo fplot docstring. Rik <rik@octave.org> parents: 17190 diff changeset	32 ##
16950 b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	33 ## The next three arguments are all optional and any number of them may be
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	34 ## given in any order.
17479 bdb237c7507c doc: Redo fplot docstring. Rik <rik@octave.org> parents: 17190 diff changeset	35 ##
16950 b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	36 ## @var{tol} is the relative tolerance to use for the plot and defaults
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	37 ## to 2e-3 (.2%).
17479 bdb237c7507c doc: Redo fplot docstring. Rik <rik@octave.org> parents: 17190 diff changeset	38 ##
bdb237c7507c doc: Redo fplot docstring. Rik <rik@octave.org> parents: 17190 diff changeset	39 ## @var{n} is the minimum number of points to use. When @var{n} is specified,
bdb237c7507c doc: Redo fplot docstring. Rik <rik@octave.org> parents: 17190 diff changeset	40 ## the maximum stepsize will be @code{@var{xhi} - @var{xlo} / @var{n}}. More
bdb237c7507c doc: Redo fplot docstring. Rik <rik@octave.org> parents: 17190 diff changeset	41 ## than @var{n} points may still be used in order to meet the relative
bdb237c7507c doc: Redo fplot docstring. Rik <rik@octave.org> parents: 17190 diff changeset	42 ## tolerance requirement.
bdb237c7507c doc: Redo fplot docstring. Rik <rik@octave.org> parents: 17190 diff changeset	43 ##
16950 b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	44 ## The @var{fmt} argument specifies the linestyle to be used by the plot
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	45 ## command.
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	46 ##
17159 d74e2b5bdeb5 fplot.m: Accept an axis handle as first input. Rik <rik@octave.org> parents: 17122 diff changeset	47 ## If the first argument @var{hax} is an axes handle, then plot into this axis,
d74e2b5bdeb5 fplot.m: Accept an axis handle as first input. Rik <rik@octave.org> parents: 17122 diff changeset	48 ## rather than the current axes returned by @code{gca}.
d74e2b5bdeb5 fplot.m: Accept an axis handle as first input. Rik <rik@octave.org> parents: 17122 diff changeset	49 ##
16950 b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	50 ## With no output arguments the results are immediately plotted. With two
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	51 ## output arguments the 2-D plot data is returned. The data can subsequently
16951 a7c9be4a2c0f fplot.m: Fix bad texinfo in docstring for changeset b34202b24212. Rik <rik@octave.org> parents: 16950 diff changeset	52 ## be plotted manually with @code{plot (@var{x}, @var{y})}.
16950 b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	53 ##
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	54 ## Example:
5820 27c966e4b2dc [project @ 2006-05-17 21:00:54 by jwe] jwe parents: diff changeset	55 ##
27c966e4b2dc [project @ 2006-05-17 21:00:54 by jwe] jwe parents: diff changeset	56 ## @example
9051 1bf0ce0930be Grammar check TexInfo in all .m files Rik <rdrider0-list@yahoo.com> parents: 9040 diff changeset	57 ## @group
16951 a7c9be4a2c0f fplot.m: Fix bad texinfo in docstring for changeset b34202b24212. Rik <rik@octave.org> parents: 16950 diff changeset	58 ## fplot (@@cos, [0, 2*pi])
14327 4d917a6a858b doc: Use Octave coding conventions in @example blocks of docstrings. Rik <octave@nomad.inbox5.com> parents: 14138 diff changeset	59 ## fplot ("[cos(x), sin(x)]", [0, 2*pi])
9051 1bf0ce0930be Grammar check TexInfo in all .m files Rik <rdrider0-list@yahoo.com> parents: 9040 diff changeset	60 ## @end group
5820 27c966e4b2dc [project @ 2006-05-17 21:00:54 by jwe] jwe parents: diff changeset	61 ## @end example
16950 b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	62 ##
20415 59911f536b07 fplot.m: Document requirement of accepting vector inputs (bug #42050). Rik <rik@octave.org> parents: 20038 diff changeset	63 ## Programming Notes:
59911f536b07 fplot.m: Document requirement of accepting vector inputs (bug #42050). Rik <rik@octave.org> parents: 20038 diff changeset	64 ##
59911f536b07 fplot.m: Document requirement of accepting vector inputs (bug #42050). Rik <rik@octave.org> parents: 20038 diff changeset	65 ## @code{fplot} works best with continuous functions. Functions with
17122 eaab03308c0b doc: Rewrite docstrings for most plot functions. Rik <rik@octave.org> parents: 17026 diff changeset	66 ## discontinuities are unlikely to plot well. This restriction may be removed
eaab03308c0b doc: Rewrite docstrings for most plot functions. Rik <rik@octave.org> parents: 17026 diff changeset	67 ## in the future.
20415 59911f536b07 fplot.m: Document requirement of accepting vector inputs (bug #42050). Rik <rik@octave.org> parents: 20038 diff changeset	68 ##
59911f536b07 fplot.m: Document requirement of accepting vector inputs (bug #42050). Rik <rik@octave.org> parents: 20038 diff changeset	69 ## @code{fplot} requires that the function accept and return a vector argument.
59911f536b07 fplot.m: Document requirement of accepting vector inputs (bug #42050). Rik <rik@octave.org> parents: 20038 diff changeset	70 ## Consider this when writing user-defined functions and use @code{.*},
59911f536b07 fplot.m: Document requirement of accepting vector inputs (bug #42050). Rik <rik@octave.org> parents: 20038 diff changeset	71 ## @code{./}, etc. See the function @code{vectorize} for potentially
59911f536b07 fplot.m: Document requirement of accepting vector inputs (bug #42050). Rik <rik@octave.org> parents: 20038 diff changeset	72 ## converting inline or anonymous functions to vectorized versions.
59911f536b07 fplot.m: Document requirement of accepting vector inputs (bug #42050). Rik <rik@octave.org> parents: 20038 diff changeset	73 ##
59911f536b07 fplot.m: Document requirement of accepting vector inputs (bug #42050). Rik <rik@octave.org> parents: 20038 diff changeset	74 ## @seealso{ezplot, plot, vectorize}
5820 27c966e4b2dc [project @ 2006-05-17 21:00:54 by jwe] jwe parents: diff changeset	75 ## @end deftypefn
27c966e4b2dc [project @ 2006-05-17 21:00:54 by jwe] jwe parents: diff changeset	76
7017 a1dbe9d80eee [project @ 2007-10-12 21:27:11 by jwe] jwe parents: 7016 diff changeset	77 ## Author: Paul Kienzle <pkienzle@users.sf.net>
a1dbe9d80eee [project @ 2007-10-12 21:27:11 by jwe] jwe parents: 7016 diff changeset	78
17159 d74e2b5bdeb5 fplot.m: Accept an axis handle as first input. Rik <rik@octave.org> parents: 17122 diff changeset	79 function [X, Y] = fplot (varargin)
d74e2b5bdeb5 fplot.m: Accept an axis handle as first input. Rik <rik@octave.org> parents: 17122 diff changeset	80
d74e2b5bdeb5 fplot.m: Accept an axis handle as first input. Rik <rik@octave.org> parents: 17122 diff changeset	81 [hax, varargin, nargin] = __plt_get_axis_arg__ ("fplot", varargin{:});
5820 27c966e4b2dc [project @ 2006-05-17 21:00:54 by jwe] jwe parents: diff changeset	82
16950 b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	83 if (nargin < 2 \|\| nargin > 5)
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	84 print_usage ();
6781 3058060c560f [project @ 2007-07-19 08:07:31 by dbateman] dbateman parents: 6699 diff changeset	85 endif
3058060c560f [project @ 2007-07-19 08:07:31 by dbateman] dbateman parents: 6699 diff changeset	86
17159 d74e2b5bdeb5 fplot.m: Accept an axis handle as first input. Rik <rik@octave.org> parents: 17122 diff changeset	87 fn = varargin{1};
d74e2b5bdeb5 fplot.m: Accept an axis handle as first input. Rik <rik@octave.org> parents: 17122 diff changeset	88 limits = varargin{2};
d74e2b5bdeb5 fplot.m: Accept an axis handle as first input. Rik <rik@octave.org> parents: 17122 diff changeset	89 varargin = varargin(3:end);
d74e2b5bdeb5 fplot.m: Accept an axis handle as first input. Rik <rik@octave.org> parents: 17122 diff changeset	90
6699 3f4ccca05612 [project @ 2007-06-12 20:48:02 by jwe] jwe parents: 6220 diff changeset	91 if (strcmp (typeinfo (fn), "inline function"))
3f4ccca05612 [project @ 2007-06-12 20:48:02 by jwe] jwe parents: 6220 diff changeset	92 fn = vectorize (fn);
3f4ccca05612 [project @ 2007-06-12 20:48:02 by jwe] jwe parents: 6220 diff changeset	93 nam = formula (fn);
3f4ccca05612 [project @ 2007-06-12 20:48:02 by jwe] jwe parents: 6220 diff changeset	94 elseif (isa (fn, "function_handle"))
3f4ccca05612 [project @ 2007-06-12 20:48:02 by jwe] jwe parents: 6220 diff changeset	95 nam = func2str (fn);
5820 27c966e4b2dc [project @ 2006-05-17 21:00:54 by jwe] jwe parents: diff changeset	96 elseif (all (isalnum (fn)))
6781 3058060c560f [project @ 2007-07-19 08:07:31 by dbateman] dbateman parents: 6699 diff changeset	97 nam = fn;
10400 b14fd5116c29 Ensure that 'limits' is a 2 or 4 vector, and that 'fn' is a function Soren Hauberg <hauberg@gmail.com> parents: 9051 diff changeset	98 elseif (ischar (fn))
16338 8aeb5d5c3747 fplot.m: Overhaul code to use modern coding practices. Rik <rik@octave.org> parents: 14868 diff changeset	99 fn = vectorize (inline (fn));
8aeb5d5c3747 fplot.m: Overhaul code to use modern coding practices. Rik <rik@octave.org> parents: 14868 diff changeset	100 nam = formula (fn);
5820 27c966e4b2dc [project @ 2006-05-17 21:00:54 by jwe] jwe parents: diff changeset	101 else
16338 8aeb5d5c3747 fplot.m: Overhaul code to use modern coding practices. Rik <rik@octave.org> parents: 14868 diff changeset	102 error ("fplot: FN must be a function handle, inline function, or string");
6781 3058060c560f [project @ 2007-07-19 08:07:31 by dbateman] dbateman parents: 6699 diff changeset	103 endif
3058060c560f [project @ 2007-07-19 08:07:31 by dbateman] dbateman parents: 6699 diff changeset	104
16950 b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	105 if (iscomplex (limits) \|\| (numel (limits) != 2 && numel (limits) != 4))
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	106 error ("fplot: LIMITS must be a real vector with 2 or 4 elements");
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	107 endif
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	108
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	109 n = 5;
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	110 tol = 2e-3;
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	111 fmt = "";
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	112 for i = 1:numel (varargin)
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	113 arg = varargin{i};
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	114 if (ischar (arg))
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	115 fmt = arg;
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	116 elseif (isnumeric (arg) && isscalar (arg) && arg > 0)
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	117 if (arg == fix (arg))
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	118 n = arg;
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	119 else
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	120 tol = arg;
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	121 endif
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	122 else
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	123 error ("fplot: bad input in position %d", i+2);
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	124 endif
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	125 endfor
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	126
19790 446c46af4b42 strip trailing whitespace from most source files John W. Eaton <jwe@octave.org> parents: 18777 diff changeset	127 if (n != 5)
446c46af4b42 strip trailing whitespace from most source files John W. Eaton <jwe@octave.org> parents: 18777 diff changeset	128 ## n was specified
16950 b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	129 x0 = linspace (limits(1), limits(2), n/2 + 1)';
6781 3058060c560f [project @ 2007-07-19 08:07:31 by dbateman] dbateman parents: 6699 diff changeset	130 y0 = feval (fn, x0);
3058060c560f [project @ 2007-07-19 08:07:31 by dbateman] dbateman parents: 6699 diff changeset	131 x = linspace (limits(1), limits(2), n)';
3058060c560f [project @ 2007-07-19 08:07:31 by dbateman] dbateman parents: 6699 diff changeset	132 y = feval (fn, x);
3058060c560f [project @ 2007-07-19 08:07:31 by dbateman] dbateman parents: 6699 diff changeset	133 else
16950 b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	134 x0 = linspace (limits(1), limits(2), 5)';
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	135 y0 = feval (fn, x0);
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	136 n = 8;
6781 3058060c560f [project @ 2007-07-19 08:07:31 by dbateman] dbateman parents: 6699 diff changeset	137 x = linspace (limits(1), limits(2), n)';
3058060c560f [project @ 2007-07-19 08:07:31 by dbateman] dbateman parents: 6699 diff changeset	138 y = feval (fn, x);
5820 27c966e4b2dc [project @ 2006-05-17 21:00:54 by jwe] jwe parents: diff changeset	139 endif
27c966e4b2dc [project @ 2006-05-17 21:00:54 by jwe] jwe parents: diff changeset	140
16950 b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	141 if (rows (x0) != rows (y0))
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	142 ## FN is a constant value function
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	143 y0 = repmat (y0, size (x0));
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	144 y = repmat (y, size (x));
8145 7ef5b1b4e029 fplot.m: call axis after plot John W. Eaton <jwe@octave.org> parents: 7280 diff changeset	145 endif
7ef5b1b4e029 fplot.m: call axis after plot John W. Eaton <jwe@octave.org> parents: 7280 diff changeset	146
16950 b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	147 err0 = Inf;
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	148
19790 446c46af4b42 strip trailing whitespace from most source files John W. Eaton <jwe@octave.org> parents: 18777 diff changeset	149 ## FIXME: This algorithm should really use adaptive scaling as the
16950 b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	150 ## the numerical quadrature algorithms do so that extra points are
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	151 ## used where they are needed and not spread evenly over the entire
17479 bdb237c7507c doc: Redo fplot docstring. Rik <rik@octave.org> parents: 17190 diff changeset	152 ## x-range. Try any function with a discontinuity, such as
bdb237c7507c doc: Redo fplot docstring. Rik <rik@octave.org> parents: 17190 diff changeset	153 ## fplot (@tan, [-2, 2]) or fplot ("1./x", [-3, 2]), to see the
16950 b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	154 ## problems with the current solution.
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	155
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	156 while (n < 2^18) # Something is wrong if we need more than 250K points
18777 6fdd3ab55b78 undo unintended changes to fplot in changeset 37c300acfcfd John W. Eaton <jwe@octave.org> parents: 18775 diff changeset	157 yi = interp1 (x0, y0, x, "linear");
16950 b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	158 ## relative error calculation using average of [yi,y] as reference
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	159 ## since neither estimate is known a priori to be better than the other.
18777 6fdd3ab55b78 undo unintended changes to fplot in changeset 37c300acfcfd John W. Eaton <jwe@octave.org> parents: 18775 diff changeset	160 err = 0.5 * max (abs ((yi - y) ./ (yi + y))(:));
16950 b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	161 if (err < tol \|\| abs (err - err0) < tol/2)
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	162 ## Either relative tolerance has been met OR
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	163 ## algorithm has stopped making any reasonable progress per iteration.
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	164 break;
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	165 endif
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	166 x0 = x;
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	167 y0 = y;
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	168 err0 = err;
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	169 n = 2 * (n - 1) + 1;
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	170 x = linspace (limits(1), limits(2), n)';
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	171 y = feval (fn, x);
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	172 endwhile
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	173
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	174 if (nargout == 2)
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	175 X = x;
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	176 Y = y;
6781 3058060c560f [project @ 2007-07-19 08:07:31 by dbateman] dbateman parents: 6699 diff changeset	177 else
17159 d74e2b5bdeb5 fplot.m: Accept an axis handle as first input. Rik <rik@octave.org> parents: 17122 diff changeset	178 if (isempty (hax))
d74e2b5bdeb5 fplot.m: Accept an axis handle as first input. Rik <rik@octave.org> parents: 17122 diff changeset	179 hax = gca ();
d74e2b5bdeb5 fplot.m: Accept an axis handle as first input. Rik <rik@octave.org> parents: 17122 diff changeset	180 endif
d74e2b5bdeb5 fplot.m: Accept an axis handle as first input. Rik <rik@octave.org> parents: 17122 diff changeset	181 plot (hax, x, y, fmt);
d74e2b5bdeb5 fplot.m: Accept an axis handle as first input. Rik <rik@octave.org> parents: 17122 diff changeset	182 axis (hax, limits);
16950 b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	183 if (isvector (y))
17159 d74e2b5bdeb5 fplot.m: Accept an axis handle as first input. Rik <rik@octave.org> parents: 17122 diff changeset	184 legend (hax, nam);
16950 b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	185 else
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	186 for i = 1:columns (y)
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	187 nams{i} = sprintf ("%s(:,%i)", nam, i);
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	188 endfor
17159 d74e2b5bdeb5 fplot.m: Accept an axis handle as first input. Rik <rik@octave.org> parents: 17122 diff changeset	189 legend (hax, nams{:});
16950 b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	190 endif
6781 3058060c560f [project @ 2007-07-19 08:07:31 by dbateman] dbateman parents: 6699 diff changeset	191 endif
16338 8aeb5d5c3747 fplot.m: Overhaul code to use modern coding practices. Rik <rik@octave.org> parents: 14868 diff changeset	192
5820 27c966e4b2dc [project @ 2006-05-17 21:00:54 by jwe] jwe parents: diff changeset	193 endfunction
7245 d65670971cbc [project @ 2007-12-04 03:03:54 by jwe] jwe parents: 7017 diff changeset	194
d65670971cbc [project @ 2007-12-04 03:03:54 by jwe] jwe parents: 7017 diff changeset	195
d65670971cbc [project @ 2007-12-04 03:03:54 by jwe] jwe parents: 7017 diff changeset	196 %!demo
14237 11949c9795a0 Revamp %!demos in m-files to use Octave coding conventions on spacing, etc. Rik <octave@nomad.inbox5.com> parents: 14138 diff changeset	197 %! clf;
16950 b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	198 %! fplot (@cos, [0, 2*pi]);
17190 df4c4b7708a4 Add titles and clean-up plotting %!demos. Rik <rik@octave.org> parents: 17159 diff changeset	199 %! title ('fplot() single function');
14237 11949c9795a0 Revamp %!demos in m-files to use Octave coding conventions on spacing, etc. Rik <octave@nomad.inbox5.com> parents: 14138 diff changeset	200
11949c9795a0 Revamp %!demos in m-files to use Octave coding conventions on spacing, etc. Rik <octave@nomad.inbox5.com> parents: 14138 diff changeset	201 %!demo
11949c9795a0 Revamp %!demos in m-files to use Octave coding conventions on spacing, etc. Rik <octave@nomad.inbox5.com> parents: 14138 diff changeset	202 %! clf;
14245 4506eade9f04 Use Matlab coding conventions for demos in plot/ directory. Rik <octave@nomad.inbox5.com> parents: 14237 diff changeset	203 %! fplot ('[cos(x), sin(x)]', [0, 2*pi]);
17190 df4c4b7708a4 Add titles and clean-up plotting %!demos. Rik <rik@octave.org> parents: 17159 diff changeset	204 %! title ('fplot() multiple functions');
14237 11949c9795a0 Revamp %!demos in m-files to use Octave coding conventions on spacing, etc. Rik <octave@nomad.inbox5.com> parents: 14138 diff changeset	205
16950 b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	206 %!demo
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	207 %! clf;
17190 df4c4b7708a4 Add titles and clean-up plotting %!demos. Rik <rik@octave.org> parents: 17159 diff changeset	208 %! %% sinc function
17026 be52288f827b Tweak some plotting demos for messages and spelling. Rik <rik@octave.org> parents: 16951 diff changeset	209 %! fh = @(x) sin (pix) ./ (pix);
16950 b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	210 %! fplot (fh, [-5, 5]);
17190 df4c4b7708a4 Add titles and clean-up plotting %!demos. Rik <rik@octave.org> parents: 17159 diff changeset	211 %! title ('fplot() sinc function');
16950 b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	212
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	213 %!test
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	214 %! [x, y] = fplot ("[cos(x), sin(x)]", [0, 2*pi]);
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	215 %! assert (columns (y) == 2);
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	216 %! assert (rows (x) == rows (y));
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	217 %! assert (y, [cos(x), sin(x)], -2e-3);
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	218
20038 9fc020886ae9 maint: Clean up m-files to follow Octave coding conventions. Rik <rik@octave.org> parents: 19898 diff changeset	219 ## Test input validation
16775 5ec3f4aea91c fplot.m: Fix bug when FN is a constant function (bug #39287) Rik <rik@octave.org> parents: 16338 diff changeset	220 %!error fplot (1)
16950 b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	221 %!error fplot (1,2,3,4,5,6)
b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	222 %!error <FN must be a function handle> fplot (1, [0 1])
16775 5ec3f4aea91c fplot.m: Fix bug when FN is a constant function (bug #39287) Rik <rik@octave.org> parents: 16338 diff changeset	223 %!error <LIMITS must be a real vector> fplot (@cos, [i, 2*i])
5ec3f4aea91c fplot.m: Fix bug when FN is a constant function (bug #39287) Rik <rik@octave.org> parents: 16338 diff changeset	224 %!error <LIMITS must be a real vector with 2 or 4> fplot (@cos, [1])
5ec3f4aea91c fplot.m: Fix bug when FN is a constant function (bug #39287) Rik <rik@octave.org> parents: 16338 diff changeset	225 %!error <LIMITS must be a real vector with 2 or 4> fplot (@cos, [1 2 3])
16950 b34202b24212 fplot.m: Overhaul function for Matlab compatibility and performance (bug #38961). Rik <rik@octave.org> parents: 16775 diff changeset	226 %!error <bad input in position 3> fplot (@cos,[-1,1], {1})
16775 5ec3f4aea91c fplot.m: Fix bug when FN is a constant function (bug #39287) Rik <rik@octave.org> parents: 16338 diff changeset	227

Mercurial > hg > octave-nkf

annotate scripts/plot/draw/fplot.m @ 20830:b65888ec820e draft default tip gccjit