Location : Home > Languages > Perl > Package Title : Statistics::Frequency

名称

　Statistics::Frequency - 要素数を数える

概要

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');

説明

　Statistics::Frequency は要素の数を数える簡単なクラスである。 すなわち頻度を計算する。
　Note that Statistics::Frequency は他の統計用モジュール、例えば Statistics::Descriptive とは似ていない。Statistics::Frequency は数に対しては作用しない。あくまで、基本的には文字列のような要素に対してである。したがって要素の「平均」などというものは計算できない。
　Statistics::Frequency の目的は単に要素の集合とその頻度に対するコンテナを提供するだけである。

new

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

　新しい Statistics::Frequency オブジェクトを生成する。オブジェクトは空または所与の要素のリストである。詳しくは add_data を見よ。

elements

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

• 配列に対しては要素を返す。
• スカラーに対しては要素数を返す。

frequency

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

　要素の頻度を返す。

add_data

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

• 引数のリストが他の frequency オブジェクトの要素であれば呼び出された要素のオブジェクトの要素数は１ずつ増加する。
• 要素が配列参照であれば、add_data() が再帰的に呼び出され参照の背後にある配列の要素を格納する。
• 要素がハッシュ参照であれば、キーは要素であり、値は頻度とみなされる。
• それ以外であれば要素は通常の要素であり、その頻度は１ずつ増加する。

remove_data

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

　要素を削除する。

remove_elements

$freq->remove_elements( @elements );

　要素と対応する頻度を削除する。

clear_data

$freq->clear_data;

　frequency オブジェクト中の全データを消去する。

copy_data

my $copy = $freq->copy_data;

　frequency オブジェクトを複製する。

frequencies

my %freq = $freq->frequencies;

　要素をキーとし、頻度を値とするハッシュを返す。

frequencies_sum

my $sum = $freq->frequencies_sum;

　頻度の合計を返す。

frequencies_min

my $sum = $freq->frequencies_min;

　頻度の最小値を返す。

frequencies_max

my $sum = $freq->frequencies_max;

　頻度の最大値を返す。

proportional_frequencies

my %freq = $freq->proportional_frequencies;

　頻度の比率をハッシュとして返す。比率とは全体を1とした値である。すなわち各頻度を頻度の和で除した値である。

proportional_frequency

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

　要素の比率を返す。

参考資料

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

著者

　Jarkko Hietaniemi, <jhi@iki.fi>

著作権とライセンス

　Copyright 2002 Jarkko Hietaniemi All Rights Reserved

　本ライブラリはフリーソフトウェアであり、Perl 本体と同等の条件で修正／再配布してもよい。

Updated : 2006/09/29