view scripts/polynomial/ppjumps.m @ 10793:be55736a0783

Grammarcheck the documentation from m-files.
author Rik <octave@nomad.inbox5.com>
date Sun, 18 Jul 2010 20:35:16 -0700
parents 702b998698ea
children 1740012184f9
line wrap: on
line source

## Copyright (C) 2008, 2009  VZLU Prague, a.s., Czech Republic
## 
## This file is part of Octave.
## 
## Octave 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 software; see the file COPYING.  If not, see
## <http://www.gnu.org/licenses/>.

## -*- texinfo -*-
## @deftypefn {Function File} {ppd =} ppjumps (pp)
## Evaluates the boundary jumps of a piecewise polynomial.
## If there are n intervals, and the dimensionality of pp is d,
## the resulting array has dimensions @code{[d, n-1]}.
## @end deftypefn

function jumps = ppjumps (pp)
  if (nargin != 1)
    print_usage ();
  endif
  if (! isstruct (pp))
    error ("ppjumps: expects a pp structure");
  endif

  ## Extract info.
  x = pp.x;
  P = pp.P;
  d = pp.d;
  [nd, n, k] = size (P);

  ## Offsets.
  dx = diff (x(1:n)).';
  dx = dx(ones (1, nd), :); # spread (do nothing in 1D)

  ## Use Horner scheme to get limits from the left.
  llim = P(:,1:n-1,1);
  for i = 2:k;
    llim .*= dx;
    llim += P(:,1:n-1,i);
  endfor

  rlim = P(:,2:n,k); # limits from the right
  jumps = reshape (rlim - llim, [d, n-1]);

endfunction