p5-Statistics-Descriptive-Discrete/Statistics-Descriptive-Discrete-0.12/README.md

14     print "count = ",$stats->count(),"\n";
31       print "key = $_, count = $f->{$_}\n";
40 e.g. data from an A/D conversion that  has a discrete set of possible values.
42 values in your data  set.  Even though you might have a million data points,
44 entire data set as Statistics::Descriptive does, this module only stores
48 and memory improvements.  For example, for an 8-bit data set (256 possible values),
52 Statistics::Descriptive run time is a factor of the size of the data set. In particular,
55 as the number of unique data values in the data set increases. For example, while this module
56 runs about 10x the speed of Statistics::Descriptive::Full for an 8-bit data set, the
57 run speed drops to about 3x for an equivalent sized 20-bit data set.
64 - $stat = Statistics::Descriptive::Discrete->new();
68 - $stat->add\_data(1,2,3,4,5);
74 - $stat->add\_data\_tuple(1,2,42,3);
77     are a value and a count (how many times did the value occur?)
78     The above is equivalent to `$stat->add_data(1,1,42,42,42);`
82 - $stat->max();
84     Returns the maximum value of the data set.
86 - $stat->min();
88     Returns the minimum value of the data set.
90 - $stat->mindex();
92     Returns the index of the minimum value of the data set.
100 - $stat->maxdex();
102     Returns the index of the maximum value of the data set.
111 - $stat->count();
113     Returns the total number of elements in the data set.
115 - $stat->uniq();
117     If called in scalar context, returns the total number of unique elements in the data set.
118     For example, if your data set is (1,2,2,3,3,3), uniq will return 3.
120     If called in array context, returns an array of each data value in the data set in sorted order.
126     It is useful for getting a frequency distribution for each discrete value in the data the set:
133             print "value = $_, count = $f->{$_}\n";
136 - $stat->sum();
138     Returns the sum of all the values in the data set.
140 - $stat->mean();
144 - $stat->harmonic\_mean();
150 - $stat->geometric\_mean();
155 - $stat->median();
159 - $stat->mode();
163 - $stat->variance();
167 - $stat->standard\_deviation();
171 - $stat->sample\_range();
173     Returns the sample range (max - min) of the data set.
175 - $stat->frequency\_distribution\_ref($num\_partitions);
176 - $stat->frequency\_distribution\_ref(\\@bins);
177 - $stat->frequency\_distribution\_ref();
183     minimum value of the data set is not a key and the maximum value of the data
184     set is always a key. The number of entries for a particular partition key are
188         $stat->add_data(1,1.5,2,2.5,3,3.5,4);
189         $f = $stat->frequency_distribution_ref(2);
191            print "key = $_, count = $f->{$_}\n";
196         key = 2.5, count = 4
197         key = 4, count = 3
206     set of bins contains the full range of the data, the total counts returned will
212 - my %hash = $stat->frequency\_distribution($partitions);
213 - my %hash = $stat->frequency\_distribution(\\@bins);
214 - my %hash = $stat->frequency\_distribution();
225 - $stat->get\_data();
237 - $stat->clear();
244         my $class = ref($stat);
245         undef $stat;
246         $stat = new $class;