Add a useful package (from Source forge) for octave

[CreaPhase.git] / octave_packages / nurbs-1.3.6 / vecnorm.m

diff --git a/octave_packages/nurbs-1.3.6/vecnorm.m b/octave_packages/nurbs-1.3.6/vecnorm.m
new file mode 100644 (file)
index 0000000..3fae3cc
--- /dev/null
+++ b/octave_packages/nurbs-1.3.6/vecnorm.m
@@ -0,0 +1,46 @@
+function nvec = vecnorm(vec)
+% 
+% VECNORM: Normalise the vectors.
+% 
+% Calling Sequence:
+% 
+%   nvec = vecnorn(vec);
+% 
+% INPUT:
+% 
+%   vec                : An array of column vectors represented by a matrix of
+%              size (dim,nv), where is the dimension of the vector and
+%              nv the number of vectors.
+%
+% OUTPUT:
+% 
+%   nvec               : Normalised vectors, matrix the smae size as vec.
+% 
+% Description:
+% 
+%   Normalises the array of vectors, returning the unit vectors.
+% 
+% Examples:
+% 
+%   Normalise the two vectors (0.0,2.0,1.3) and (1.5,3.4,2.3)
+%
+%   nvec = vecnorm([0.0 1.5; 2.0 3.4; 1.3 2.3]);
+%
+%    Copyright (C) 2000 Mark Spink
+%
+%    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 2 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/>.
+
+nvec = vec./repmat(sqrt(sum(vec.^2)),[size(vec,1) ones(1,ndims(vec)-1)]);
+
+end