NAME

Math::Vector::Real - Real vector arithmetic in Perl

SYNOPSIS

use Math::Vector::Real;

my $v = V(1.1, 2.0, 3.1, -4.0, -12.0);
my $u = V(2.0, 0.0, 0.0,  1.0,   0.3);
printf "abs(%s) = %d\n", $v, abs($b);

my $dot = $u * $v;

my $sub = $u - $v;

# etc...

DESCRIPTION

A simple pure perl module to manipulate vectors of any dimension.

The function V that is automatically exported by the module allows to create new vectors:

my $v = V(0, 1, 3, -1);

Vectors are represented as blessed array references. You are allowed to manipulate the arrays as far as only real numbers are inserted (well, actually, integers are also allowed, from a mathematical point of view, integers are also reals).

Example:

my $v = V(0.0, 1.0);

# extending the 2D vector to 3D:
push @$v, 0.0;

# setting some component value:
$v->[0] = 23;

Vectors can be used in mathematical expressions:

my $u = V(3, 3, 0);
$p = $u * $v; # dot product
$f = 1.4 * $u + $v; # scalar product and vector addition
$c = $u x $v; # cross product, only defined for 3D vectors
# etc.

The currently supported operations are:

+ * /
- (both unary and binary)
x (cross product for 3D vectors)
+= -= *= /= x=
== !=
"" (stringfication)
abs (returns the norm)
atan2 (returns the angle between two vectors)

That AFAIK, are the operations that can be applied to vectors.

When an array is used in an operation involving a vector, it is automatically upgraded to a vector. For instance:

my $v = V(1, 2);
$v += [0, 2];

SEE ALSO

Math::GSL::Vector, PDL.

There are other vector manipulation packages in CPAN (Math::Vec, Math::RealVec, Math::Vector), but most of them are limited to 3D.

AUTHOR

Salvador Fandiño, <sfandino@Eyahoo.com<gt>

COPYRIGHT AND LICENSE

Copyright (C) 2009 by Salvador Fandiño

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.10.0 or, at your option, any later version of Perl 5 you may have available.