package PDL::NDBin::Action::StdDev;
{
$PDL::NDBin::Action::StdDev::VERSION = '0.008'; # TRIAL
}
# ABSTRACT: Action for PDL::NDBin that computes standard deviation
use strict;
use warnings;
use PDL::Lite; # do not import any functions into this namespace
use PDL::NDBin::Actions_PP;
sub new
{
my $class = shift;
my $m = shift;
return bless { m => $m }, $class;
}
sub process
{
my $self = shift;
my $iter = shift;
$self->{out} = PDL->zeroes( PDL::double, $self->{m} ) unless defined $self->{out};
$self->{count} = PDL->zeroes( PDL::long, $self->{m} ) unless defined $self->{count};
$self->{avg} = PDL->zeroes( PDL::double, $self->{m} ) unless defined $self->{avg};
PDL::NDBin::Actions_PP::_istddev_loop( $iter->data, $iter->idx, $self->{out}, $self->{count}, $self->{avg}, $self->{m} );
# as the plugin processes all bins at once, every variable
# needs to be visited only once
$iter->var_active( 0 );
return $self;
}
sub result
{
my $self = shift;
PDL::NDBin::Actions_PP::_istddev_post( $self->{count}, $self->{out} );
return $self->{out};
}
1;
__END__
=pod
=head1 NAME
PDL::NDBin::Action::StdDev - Action for PDL::NDBin that computes standard deviation
=head1 VERSION
version 0.008
=head1 DESCRIPTION
This class implements an action for PDL::NDBin.
=head1 METHODS
=head2 new()
my $instance = PDL::NDBin::Action::StdDev->new( $N );
Construct an instance for this action. Requires the number of bins $N as input.
=head2 process()
$instance->process( $iter );
Run the action with the given iterator $iter. This action will compute all bins
during the first call and will subsequently deactivate the variable.
=head2 result()
my $result = $instance->result;
Return the result of the computation.
=head1 AUTHOR
Edward Baudrez <ebaudrez@cpan.org>
=head1 COPYRIGHT AND LICENSE
This software is copyright (c) 2013 by Edward Baudrez.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
=cut