/usr/share/octave/packages/interval-1.4.1/@infsupdec/union.m is in octave-interval 1.4.1-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 | ## Copyright 2014-2016 Oliver Heimlich
##
## This program is free software; you can redistribute it and/or modify
## it under the terms of the GNU General Public License as published by
## the Free Software Foundation; either version 3 of the License, or
## (at your option) any later version.
##
## This program is distributed in the hope that it will be useful,
## but WITHOUT ANY WARRANTY; without even the implied warranty of
## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
## GNU General Public License for more details.
##
## You should have received a copy of the GNU General Public License
## along with this program; if not, see <http://www.gnu.org/licenses/>.
## -*- texinfo -*-
## @documentencoding UTF-8
## @defmethod {@@infsupdec} union (@var{A})
## @defmethodx {@@infsupdec} union (@var{A}, @var{B})
## @defmethodx {@@infsupdec} union (@var{A}, [], @var{DIM})
##
## Build the interval hull of the union of intervals.
##
## With two arguments the union is built pair-wise. Otherwise the union is
## computed for all interval members along dimension @var{DIM}, which defaults
## to the first non-singleton dimension.
##
## Accuracy: The result is exact.
##
## @comment DO NOT SYNCHRONIZE DOCUMENTATION STRING
## The function is a set operation and the result carries the @code{trv}
## decoration at best.
##
## @example
## @group
## x = infsupdec (1, 3);
## y = infsupdec (2, 4);
## union (x, y)
## @result{} ans = [1, 4]_trv
## @end group
## @end example
## @seealso{hull, @@infsupdec/intersect, @@infsupdec/setdiff, @@infsupdec/setxor}
## @end defmethod
## Author: Oliver Heimlich
## Keywords: interval
## Created: 2014-10-13
function result = union (a, b, dim)
if (not (isa (a, "infsupdec")))
a = infsupdec (a);
endif
if (isnai (a))
result = a;
return
endif
switch (nargin)
case 1
bare = union (intervalpart (a));
case 2
if (not (isa (b, "infsupdec")))
b = infsupdec (b);
endif
if (isnai (b))
result = b;
return
endif
bare = union (intervalpart (a), intervalpart (b));
case 3
if (not (builtin ("isempty", b)))
warning ("union: second argument is ignored");
endif
bare = union (intervalpart (a), [], dim);
otherwise
print_usage ();
return
endswitch
## convexHull must not retain any useful decoration
result = infsupdec (bare, "trv");
endfunction
%!test "from the documentation string";
%! assert (isequal (union (infsupdec (1, 3), infsupdec (2, 4)), infsupdec (1, 4, "trv")));
|