Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

statistics::basic::_twovectorbase(3pm) [debian man page]

Statistics::Basic::_TwoVectorBase(3pm)			User Contributed Perl Documentation		    Statistics::Basic::_TwoVectorBase(3pm)

NAME

       Statistics::Basic::_TwoVectorBase - base class objects like Correlation

METHODS

       query()
	   Query the value of the object.  It will return the undefined value until there's something to calculate.

       insert()
	   Insert two new new values into the vectors.	This function must be given precisely two arguments and probably shouldn't be undefined
	   values in most cases.

	       # insert a 4 in one vector and a 3 in the other
	       $object_instance->insert( 4, 3 );

       append() ginsert()
	   The growing insert inserts new elements, growing the max size of the vector to accommodate the new elements (if necessary).	This
	   function must be given precisely two arguments and probably shouldn't be undefined values in most cases.

	       # append a 4 in one vector and a 3 in the other
	       $object_instance->ginsert( 4, 3 );

       query_size()
	   The current size of the vectors -- regardless of their max size (as set by "set_size()").  This function returns a list, i.e.:

	       my @s = $obj->query_size; # two values
	       my $s = $obj->query_size; # the right hand value of the list

       set_size()
	   Set the maximum size for the underlying Statistics::Basic::Vector objects.  This function requires two arguments.

       set_vector()
	   Set the vector objects used to calculate the object's value.  This function takes two arguments -- which can either be arrayrefs or
	   Statistics::Basic::Vector objects.  They must have the same number of elements.

	       my $v1 = vector
	       my $v2 = $v1->copy;
	       $example_correlation->set_vector($v1, $v2);

OVERLOADS

       This class provides overloads.  If evaluated as a string, it will attempt to print a pretty value for the object (or "n/a", see "query()"
       above).	the resulting string can be tuned, in terms of precision, see ipres for further information.

       If evaluated as a number, it will try to return the raw result of "query()", possibly turning the resulting "undef" (if applicable) into a
       0 in the process -- note that Perl does this 0-izing, not the overload.

       The "eq" and "==" operators are also overloaded, trying to do the right thing.  Also see toler for further information.

AUTHOR

       Paul Miller "<jettero@cpan.org>"

COPYRIGHT

       Copyright 2012 Paul Miller -- Licensed under the LGPL

SEE ALSO

       perl(1), Statistics::Basic, Statistics::Basic::Vector

perl v5.14.2							    2012-01-23				    Statistics::Basic::_TwoVectorBase(3pm)

Check Out this Related Man Page

Statistics::Basic::Median(3pm)				User Contributed Perl Documentation			    Statistics::Basic::Median(3pm)

NAME

       Statistics::Basic::Median - find the median of a list

SYNOPSIS

       Invoke it this way:

	   my $median = median(1,2,3);

       Or this way:

	   my $v1  = vector(1,2,3);
	   my $med = median($v1);

       And then either query the values or print them like so:

	   print "The median of $v1: $med
";
	   my $mq = $med->query;
	   my $m0 = 0+$med;

       Create a 20 point "moving" median like so:

	   use Statistics::Basic qw(:all nofill);

	   my $sth = $dbh->prepare("select col1 from data where something");
	   my $len = 20;
	   my $med = median()->set_size($len);

	   $sth->execute or die $dbh->errstr;
	   $sth->bind_columns( my $val ) or die $dbh->errstr;

	   while( $sth->fetch ) {
	       $med->insert( $val );
	       if( defined( $m = $med->query ) ) {
		   print "Median: $m
";
	       }

	       # This would also work:
	       # print "Median: $med
" if $med->query_filled;
	   }

METHODS

       new()
	   The constructor takes a single array ref or a single Statistics::Basic::Vector as arguments.  It returns a Statistics::Basic::Median
	   object.

	   Note: normally you'd use the median() constructor, rather than building these by hand using "new()".

       _OVB::import()
	   This module also inherits all the overloads and methods from Statistics::Basic::_OneVectorBase.

OVERLOADS

       This object is overloaded.  It tries to return an appropriate string for the calculation or the value of the computation in numeric
       context.

       In boolean context, this object is always true (even when empty).

AUTHOR

       Paul Miller "<jettero@cpan.org>"

COPYRIGHT

       Copyright 2012 Paul Miller -- Licensed under the LGPL

SEE ALSO

       perl(1), Statistics::Basic, Statistics::Basic::_OneVectorBase, Statistics::Basic::Vector

perl v5.14.2							    2012-01-23					    Statistics::Basic::Median(3pm)
Man Page