++ed by:

1 non-PAUSE user.

NAME

Statistics::Frequency - simple counting of elements

SYNOPSIS

use Statistics::Frequency;

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

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.

• 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.