Mercurial > hg > octave-nkf
annotate scripts/general/trapz.m @ 18208:1c1236fd179a stable
fix menu name of release notes in warning bar of exp. gui (bug #41078)
* main-window.cc (construct_warning_bar): fix text of warning bar,
menu for release notes in news menu
* libgui/languages/*.ts: update language files accordingly
author | Torsten <ttl@justmail.de> |
---|---|
date | Fri, 03 Jan 2014 23:15:34 +0100 |
parents | d63878346099 |
children | 4197fc428c7d |
rev | line source |
---|---|
17744
d63878346099
maint: Update copyright notices for release.
John W. Eaton <jwe@octave.org>
parents:
14363
diff
changeset
|
1 ## Copyright (C) 2000-2013 Kai Habel |
5820 | 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. | |
5820 | 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/>. | |
5820 | 18 |
19 ## -*- texinfo -*- | |
12612
16cca721117b
doc: Update all documentation for chapter on Numerical Integration
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
20 ## @deftypefn {Function File} {@var{q} =} trapz (@var{y}) |
16cca721117b
doc: Update all documentation for chapter on Numerical Integration
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
21 ## @deftypefnx {Function File} {@var{q} =} trapz (@var{x}, @var{y}) |
16cca721117b
doc: Update all documentation for chapter on Numerical Integration
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
22 ## @deftypefnx {Function File} {@var{q} =} trapz (@dots{}, @var{dim}) |
16cca721117b
doc: Update all documentation for chapter on Numerical Integration
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
23 ## |
16cca721117b
doc: Update all documentation for chapter on Numerical Integration
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
24 ## Numerically evaluate the integral of points @var{y} using the trapezoidal |
16cca721117b
doc: Update all documentation for chapter on Numerical Integration
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
25 ## method. |
16cca721117b
doc: Update all documentation for chapter on Numerical Integration
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
26 ## @w{@code{trapz (@var{y})}} computes the integral of @var{y} along the first |
16cca721117b
doc: Update all documentation for chapter on Numerical Integration
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
27 ## non-singleton dimension. When the argument @var{x} is omitted an |
12642
f96b9b9f141b
doc: Periodic grammarcheck and spellcheck of documentation.
Rik <octave@nomad.inbox5.com>
parents:
12612
diff
changeset
|
28 ## equally spaced @var{x} vector with unit spacing (1) is assumed. |
12612
16cca721117b
doc: Update all documentation for chapter on Numerical Integration
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
29 ## @code{trapz (@var{x}, @var{y})} evaluates the integral with respect |
16cca721117b
doc: Update all documentation for chapter on Numerical Integration
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
30 ## to the spacing in @var{x} and the values in @var{y}. This is useful if |
16cca721117b
doc: Update all documentation for chapter on Numerical Integration
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
31 ## the points in @var{y} have been sampled unevenly. |
16cca721117b
doc: Update all documentation for chapter on Numerical Integration
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
32 ## If the optional @var{dim} argument is given, operate along this dimension. |
11587
c792872f8942
all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents:
11523
diff
changeset
|
33 ## |
12612
16cca721117b
doc: Update all documentation for chapter on Numerical Integration
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
34 ## If @var{x} is not specified then unit spacing will be used. To scale |
16cca721117b
doc: Update all documentation for chapter on Numerical Integration
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
35 ## the integral to the correct value you must multiply by the actual spacing |
16cca721117b
doc: Update all documentation for chapter on Numerical Integration
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
36 ## value (deltaX). As an example, the integral of @math{x^3} over the range |
16cca721117b
doc: Update all documentation for chapter on Numerical Integration
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
37 ## [0, 1] is @math{x^4/4} or 0.25. The following code uses @code{trapz} to |
16cca721117b
doc: Update all documentation for chapter on Numerical Integration
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
38 ## calculate the integral in three different ways. |
16cca721117b
doc: Update all documentation for chapter on Numerical Integration
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
39 ## |
16cca721117b
doc: Update all documentation for chapter on Numerical Integration
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
40 ## @example |
16cca721117b
doc: Update all documentation for chapter on Numerical Integration
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
41 ## @group |
16cca721117b
doc: Update all documentation for chapter on Numerical Integration
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
42 ## x = 0:0.1:1; |
16cca721117b
doc: Update all documentation for chapter on Numerical Integration
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
43 ## y = x.^3; |
16cca721117b
doc: Update all documentation for chapter on Numerical Integration
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
44 ## q = trapz (y) |
16cca721117b
doc: Update all documentation for chapter on Numerical Integration
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
45 ## @result{} q = 2.525 # No scaling |
16cca721117b
doc: Update all documentation for chapter on Numerical Integration
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
46 ## q * 0.1 |
16cca721117b
doc: Update all documentation for chapter on Numerical Integration
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
47 ## @result{} q = 0.2525 # Approximation to integral by scaling |
12642
f96b9b9f141b
doc: Periodic grammarcheck and spellcheck of documentation.
Rik <octave@nomad.inbox5.com>
parents:
12612
diff
changeset
|
48 ## trapz (x, y) |
12612
16cca721117b
doc: Update all documentation for chapter on Numerical Integration
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
49 ## @result{} q = 0.2525 # Same result by specifying @var{x} |
16cca721117b
doc: Update all documentation for chapter on Numerical Integration
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
50 ## @end group |
16cca721117b
doc: Update all documentation for chapter on Numerical Integration
Rik <octave@nomad.inbox5.com>
parents:
11587
diff
changeset
|
51 ## @end example |
11587
c792872f8942
all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents:
11523
diff
changeset
|
52 ## |
5820 | 53 ## @seealso{cumtrapz} |
54 ## @end deftypefn | |
55 | |
10549 | 56 ## Author: Kai Habel <kai.habel@gmx.de> |
5820 | 57 ## |
11587
c792872f8942
all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents:
11523
diff
changeset
|
58 ## also: June 2000 - Paul Kienzle (fixes,suggestions) |
5820 | 59 ## 2006-05-12 David Bateman - Modified for NDArrays |
60 | |
61 function z = trapz (x, y, dim) | |
11587
c792872f8942
all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents:
11523
diff
changeset
|
62 |
5820 | 63 if (nargin < 1) || (nargin > 3) |
6046 | 64 print_usage (); |
5820 | 65 endif |
66 | |
12667
d8aff843a9e9
Accept input x vector with y matrix for trapz,cumtrapz (bug #33292).
Rik <octave@nomad.inbox5.com>
parents:
12642
diff
changeset
|
67 have_xy = have_dim = false; |
5820 | 68 |
69 if (nargin == 3) | |
12667
d8aff843a9e9
Accept input x vector with y matrix for trapz,cumtrapz (bug #33292).
Rik <octave@nomad.inbox5.com>
parents:
12642
diff
changeset
|
70 have_xy = true; |
5820 | 71 have_dim = true; |
12667
d8aff843a9e9
Accept input x vector with y matrix for trapz,cumtrapz (bug #33292).
Rik <octave@nomad.inbox5.com>
parents:
12642
diff
changeset
|
72 elseif (nargin == 2) |
6157 | 73 if (! size_equal (x, y) && isscalar (y)) |
5820 | 74 dim = y; |
75 have_dim = true; | |
76 else | |
12667
d8aff843a9e9
Accept input x vector with y matrix for trapz,cumtrapz (bug #33292).
Rik <octave@nomad.inbox5.com>
parents:
12642
diff
changeset
|
77 have_xy = true; |
5820 | 78 endif |
79 endif | |
80 | |
12667
d8aff843a9e9
Accept input x vector with y matrix for trapz,cumtrapz (bug #33292).
Rik <octave@nomad.inbox5.com>
parents:
12642
diff
changeset
|
81 if (have_xy) |
d8aff843a9e9
Accept input x vector with y matrix for trapz,cumtrapz (bug #33292).
Rik <octave@nomad.inbox5.com>
parents:
12642
diff
changeset
|
82 nd = ndims (y); |
d8aff843a9e9
Accept input x vector with y matrix for trapz,cumtrapz (bug #33292).
Rik <octave@nomad.inbox5.com>
parents:
12642
diff
changeset
|
83 sz = size (y); |
d8aff843a9e9
Accept input x vector with y matrix for trapz,cumtrapz (bug #33292).
Rik <octave@nomad.inbox5.com>
parents:
12642
diff
changeset
|
84 else |
d8aff843a9e9
Accept input x vector with y matrix for trapz,cumtrapz (bug #33292).
Rik <octave@nomad.inbox5.com>
parents:
12642
diff
changeset
|
85 nd = ndims (x); |
d8aff843a9e9
Accept input x vector with y matrix for trapz,cumtrapz (bug #33292).
Rik <octave@nomad.inbox5.com>
parents:
12642
diff
changeset
|
86 sz = size (x); |
d8aff843a9e9
Accept input x vector with y matrix for trapz,cumtrapz (bug #33292).
Rik <octave@nomad.inbox5.com>
parents:
12642
diff
changeset
|
87 endif |
d8aff843a9e9
Accept input x vector with y matrix for trapz,cumtrapz (bug #33292).
Rik <octave@nomad.inbox5.com>
parents:
12642
diff
changeset
|
88 |
5820 | 89 if (! have_dim) |
10690
35adf2a71f3f
Use common code block to find first non-singleton dimension.
Rik <octave@nomad.inbox5.com>
parents:
10549
diff
changeset
|
90 ## Find the first non-singleton dimension. |
12667
d8aff843a9e9
Accept input x vector with y matrix for trapz,cumtrapz (bug #33292).
Rik <octave@nomad.inbox5.com>
parents:
12642
diff
changeset
|
91 (dim = find (sz > 1, 1)) || (dim = 1); |
5820 | 92 else |
12667
d8aff843a9e9
Accept input x vector with y matrix for trapz,cumtrapz (bug #33292).
Rik <octave@nomad.inbox5.com>
parents:
12642
diff
changeset
|
93 if (!(isscalar (dim) && dim == fix (dim)) |
d8aff843a9e9
Accept input x vector with y matrix for trapz,cumtrapz (bug #33292).
Rik <octave@nomad.inbox5.com>
parents:
12642
diff
changeset
|
94 || !(1 <= dim && dim <= nd)) |
d8aff843a9e9
Accept input x vector with y matrix for trapz,cumtrapz (bug #33292).
Rik <octave@nomad.inbox5.com>
parents:
12642
diff
changeset
|
95 error ("trapz: DIM must be an integer and a valid dimension"); |
5820 | 96 endif |
97 endif | |
11587
c792872f8942
all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents:
11523
diff
changeset
|
98 |
5820 | 99 n = sz(dim); |
12675
2e9cf640379b
trapz.m, cumtrapz.m: Quote ':' in initialization statement to prevent it being
Rik <octave@nomad.inbox5.com>
parents:
12667
diff
changeset
|
100 idx1 = idx2 = repmat ({':'}, [nd, 1]); |
11587
c792872f8942
all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents:
11523
diff
changeset
|
101 idx1{dim} = 2 : n; |
5820 | 102 idx2{dim} = 1 : (n - 1); |
103 | |
12667
d8aff843a9e9
Accept input x vector with y matrix for trapz,cumtrapz (bug #33292).
Rik <octave@nomad.inbox5.com>
parents:
12642
diff
changeset
|
104 if (! have_xy) |
5820 | 105 z = 0.5 * sum (x(idx1{:}) + x(idx2{:}), dim); |
106 else | |
12667
d8aff843a9e9
Accept input x vector with y matrix for trapz,cumtrapz (bug #33292).
Rik <octave@nomad.inbox5.com>
parents:
12642
diff
changeset
|
107 if (isvector (x) && !isvector (y)) |
d8aff843a9e9
Accept input x vector with y matrix for trapz,cumtrapz (bug #33292).
Rik <octave@nomad.inbox5.com>
parents:
12642
diff
changeset
|
108 if (length (x) != sz(dim)) |
d8aff843a9e9
Accept input x vector with y matrix for trapz,cumtrapz (bug #33292).
Rik <octave@nomad.inbox5.com>
parents:
12642
diff
changeset
|
109 error ("trapz: length of X and length of Y along DIM must match"); |
d8aff843a9e9
Accept input x vector with y matrix for trapz,cumtrapz (bug #33292).
Rik <octave@nomad.inbox5.com>
parents:
12642
diff
changeset
|
110 endif |
d8aff843a9e9
Accept input x vector with y matrix for trapz,cumtrapz (bug #33292).
Rik <octave@nomad.inbox5.com>
parents:
12642
diff
changeset
|
111 ## Reshape vector to point along dimension DIM |
d8aff843a9e9
Accept input x vector with y matrix for trapz,cumtrapz (bug #33292).
Rik <octave@nomad.inbox5.com>
parents:
12642
diff
changeset
|
112 shape = ones (nd, 1); |
d8aff843a9e9
Accept input x vector with y matrix for trapz,cumtrapz (bug #33292).
Rik <octave@nomad.inbox5.com>
parents:
12642
diff
changeset
|
113 shape(dim) = sz(dim); |
d8aff843a9e9
Accept input x vector with y matrix for trapz,cumtrapz (bug #33292).
Rik <octave@nomad.inbox5.com>
parents:
12642
diff
changeset
|
114 x = reshape (x, shape); |
d8aff843a9e9
Accept input x vector with y matrix for trapz,cumtrapz (bug #33292).
Rik <octave@nomad.inbox5.com>
parents:
12642
diff
changeset
|
115 z = 0.5 * sum (bsxfun (@times, diff (x), y(idx1{:}) + y(idx2{:})), dim); |
d8aff843a9e9
Accept input x vector with y matrix for trapz,cumtrapz (bug #33292).
Rik <octave@nomad.inbox5.com>
parents:
12642
diff
changeset
|
116 else |
d8aff843a9e9
Accept input x vector with y matrix for trapz,cumtrapz (bug #33292).
Rik <octave@nomad.inbox5.com>
parents:
12642
diff
changeset
|
117 if (! size_equal (x, y)) |
d8aff843a9e9
Accept input x vector with y matrix for trapz,cumtrapz (bug #33292).
Rik <octave@nomad.inbox5.com>
parents:
12642
diff
changeset
|
118 error ("trapz: X and Y must have same shape"); |
d8aff843a9e9
Accept input x vector with y matrix for trapz,cumtrapz (bug #33292).
Rik <octave@nomad.inbox5.com>
parents:
12642
diff
changeset
|
119 endif |
d8aff843a9e9
Accept input x vector with y matrix for trapz,cumtrapz (bug #33292).
Rik <octave@nomad.inbox5.com>
parents:
12642
diff
changeset
|
120 z = 0.5 * sum (diff (x, 1, dim) .* (y(idx1{:}) + y(idx2{:})), dim); |
5820 | 121 endif |
122 endif | |
123 endfunction | |
124 | |
12667
d8aff843a9e9
Accept input x vector with y matrix for trapz,cumtrapz (bug #33292).
Rik <octave@nomad.inbox5.com>
parents:
12642
diff
changeset
|
125 |
14363
f3d52523cde1
Use Octave coding conventions in all m-file %!test blocks
Rik <octave@nomad.inbox5.com>
parents:
14138
diff
changeset
|
126 %!assert (trapz (1:5), 12) |
f3d52523cde1
Use Octave coding conventions in all m-file %!test blocks
Rik <octave@nomad.inbox5.com>
parents:
14138
diff
changeset
|
127 %!assert (trapz (0:0.5:2,1:5), 6) |
f3d52523cde1
Use Octave coding conventions in all m-file %!test blocks
Rik <octave@nomad.inbox5.com>
parents:
14138
diff
changeset
|
128 %!assert (trapz ([1:5;1:5].',1), [12,12]) |
f3d52523cde1
Use Octave coding conventions in all m-file %!test blocks
Rik <octave@nomad.inbox5.com>
parents:
14138
diff
changeset
|
129 %!assert (trapz ([1:5;1:5],2), [12;12]) |
f3d52523cde1
Use Octave coding conventions in all m-file %!test blocks
Rik <octave@nomad.inbox5.com>
parents:
14138
diff
changeset
|
130 %!assert (trapz (repmat (reshape (1:5,1,1,5),2,2), 3), [12 12; 12 12]) |
f3d52523cde1
Use Octave coding conventions in all m-file %!test blocks
Rik <octave@nomad.inbox5.com>
parents:
14138
diff
changeset
|
131 %!assert (trapz ([0:0.5:2;0:0.5:2].',[1:5;1:5].',1), [6, 6]) |
f3d52523cde1
Use Octave coding conventions in all m-file %!test blocks
Rik <octave@nomad.inbox5.com>
parents:
14138
diff
changeset
|
132 %!assert (trapz ([0:0.5:2;0:0.5:2],[1:5;1:5],2), [6; 6]) |
f3d52523cde1
Use Octave coding conventions in all m-file %!test blocks
Rik <octave@nomad.inbox5.com>
parents:
14138
diff
changeset
|
133 %!assert (trapz (repmat (reshape ([0:0.5:2],1,1,5),2,2), ... |
f3d52523cde1
Use Octave coding conventions in all m-file %!test blocks
Rik <octave@nomad.inbox5.com>
parents:
14138
diff
changeset
|
134 %! repmat (reshape (1:5,1,1,5),2,2), 3), [6 6; 6 6]) |
f3d52523cde1
Use Octave coding conventions in all m-file %!test blocks
Rik <octave@nomad.inbox5.com>
parents:
14138
diff
changeset
|
135 %!assert (trapz (0:0.5:2,[(1:5)',(1:5)']), [6, 6]) |
f3d52523cde1
Use Octave coding conventions in all m-file %!test blocks
Rik <octave@nomad.inbox5.com>
parents:
14138
diff
changeset
|
136 %!assert (trapz (0:0.5:2,[(1:5);(1:5)],2), [6; 6]) |
f3d52523cde1
Use Octave coding conventions in all m-file %!test blocks
Rik <octave@nomad.inbox5.com>
parents:
14138
diff
changeset
|
137 %!assert (trapz (0:0.5:2,repmat (reshape (1:5,1,1,5),2,2),3), [6 6; 6 6]) |
12667
d8aff843a9e9
Accept input x vector with y matrix for trapz,cumtrapz (bug #33292).
Rik <octave@nomad.inbox5.com>
parents:
12642
diff
changeset
|
138 |