NAME

Statistics::Frequency - simple counting of elements

SYNOPSIS

    use Statistics::Frequency;

    my $f1  = Statistics::Frequency->new;

    $f1->add_data(  @data );
    $f1->add_data( \@data );
    $f1->add_data( \%data );

    my @list_of_different_elements   = $f1->elements;
    my $number_of_different_elements = $f1->elements;

    my $freq = $f1->frequency('x');

    my $f2a = Statistics::Frequency->new(  @data ); # a list
    my $f2b = Statistics::Frequency->new( \@data ); # an arrayref
    my $f2c = Statistics::Frequency->new( \%data ); # a hashref

    $f->remove_data(  @data );
    $f->remove_data( \@data );
    $f->remove_data( \%data );

    $f->remove_elements('y');

    $f->clear_data;

    my $g = $f->copy_data;

    my %freq = $f->frequencies;

    my $sum = $f->frequencies_sum;
    my $min = $f->frequencies_min;
    my $max = $f->frequencies_max;

    my %prop = $f->proportional_frequencies;

    my $prop = $f->proportional_frequency('z');

DESCRIPTION

Statistics::Frequency is a simple class for counting elements, in other words, their frequencies.

Note that Statistics::Frequency is not similar to statistics modules like, say, Statistics::Descriptive. Statistics::Frequency doesn't operate on numbers, it operates on elements, which are basically opaque strings. Therefore there can't be, say, "an average" of the elements.

The goal of Statistics::Frequency is simply to be provide container for sets of elements and their respective frequencies.

new

    my $freq = Statistics::Frequency->new;
    my $freq = Statistics::Frequency->new(@data);
    my $freq = Statistics::Frequency->new(\@data);
    my $freq = Statistics::Frequency->new(\%data);

Create a new Statistics::Frequency object. The object can be either empty or a list of elements can be given. See "add_data" for details.

elements

    my @elements = $freq->elements;
    my $elements = $freq->elements;

• In array context, return the elements.

• In scalar context, return the number of elements.

frequency

    $f = $freq->frequency($element);

Return the frequency of an element.

add_data

    $freq->add_data(@data);
    $freq->add_data(\@data);
    $freq->add_data(\%data);

• If an element of the argument list is another frequency object, the frequencies in the invocant object of the elements are increased by the frequencies in the argument object.

• If an element is an array reference, add_data() is called recursively with the elements of the array behind the reference.

• If an element is a hash reference, the keys are assumed to be elements and the value are assumed to be their frequencies.

• Otherwise an element is just an ordinary element and its frequency is incremented by one.

remove_data

    $freq->remove_data(@data);
    $freq->remove_data(\@data);
    $freq->remove_data(\%data);

Remove elements, arguments as with with add_data().

remove_elements

    $freq->remove_elements( @elements );

Remove elements and their respective frequencies.

clear_data

    $freq->clear_data;

Clear all the data in a frequency object.

copy_data

    my $copy = $freq->copy_data;

Create a copy of a frequency object.

frequencies

    my %freq = $freq->frequencies;

Return the frequencies as a hash, the elements as the keys and the frequencies as the values.

frequencies_sum

    my $sum = $freq->frequencies_sum;

Return the sum of all the frequencies.

frequencies_min

    my $sum = $freq->frequencies_min;

Return the minimum of all the frequencies.

frequencies_max

    my $sum = $freq->frequencies_max;

Return the maximum of all the frequencies.

proportional_frequencies

    my %freq = $freq->proportional_frequencies;

Return the proportional frequencies as a hash, the elements as the keys and the frequencies as the values. Proportional meaning that proportional frequencies total 1.0, in other words, each of the frequencies of elements are divided by the sum of all the frequencies.

proportional_frequency

    my $f = $freq->proportional_frequency($element);

Return the proportional frequency of the element.

SEE ALSO

Statistics::Descriptive, Statistics::Descriptive::Discrete

AUTHOR

Jarkko Hietaniemi <jhi@iki.fi>

COPYRIGHT AND LICENSE

Copyright (C) 2002-2015, Jarkko Hietaniemi <jhi@iki.fi>

This library is free software; you can redistribute it and/or modify it under the same terms as Perl 5.18.2.

cpanm Statistics::Frequency

perl -MCPAN -e shell
install Statistics::Frequency