Mercurial > repos > deepakjadmin > mayatool3_test3
diff mayachemtools/docs/modules/html/StatisticsUtil.html @ 0:73ae111cf86f draft
Uploaded
author | deepakjadmin |
---|---|
date | Wed, 20 Jan 2016 11:55:01 -0500 |
parents | |
children |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/mayachemtools/docs/modules/html/StatisticsUtil.html Wed Jan 20 11:55:01 2016 -0500 @@ -0,0 +1,301 @@ +<html> +<head> +<title>MayaChemTools:Documentation:StatisticsUtil.pm</title> +<meta http-equiv="content-type" content="text/html;charset=utf-8"> +<link rel="stylesheet" type="text/css" href="../../css/MayaChemTools.css"> +</head> +<body leftmargin="20" rightmargin="20" topmargin="10" bottommargin="10"> +<br/> +<center> +<a href="http://www.mayachemtools.org" title="MayaChemTools Home"><img src="../../images/MayaChemToolsLogo.gif" border="0" alt="MayaChemTools"></a> +</center> +<br/> +<div class="DocNav"> +<table width="100%" border=0 cellpadding=0 cellspacing=2> +<tr align="left" valign="top"><td width="33%" align="left"><a href="./SequenceFileUtil.html" title="SequenceFileUtil.html">Previous</a> <a href="./index.html" title="Table of Contents">TOC</a> <a href="./TextUtil.html" title="TextUtil.html">Next</a></td><td width="34%" align="middle"><strong>StatisticsUtil.pm</strong></td><td width="33%" align="right"><a href="././code/StatisticsUtil.html" title="View source code">Code</a> | <a href="./../pdf/StatisticsUtil.pdf" title="PDF US Letter Size">PDF</a> | <a href="./../pdfgreen/StatisticsUtil.pdf" title="PDF US Letter Size with narrow margins: www.changethemargins.com">PDFGreen</a> | <a href="./../pdfa4/StatisticsUtil.pdf" title="PDF A4 Size">PDFA4</a> | <a href="./../pdfa4green/StatisticsUtil.pdf" title="PDF A4 Size with narrow margins: www.changethemargins.com">PDFA4Green</a></td></tr> +</table> +</div> +<p> +</p> +<h2>NAME</h2> +<p>StatisticsUtil</p> +<p> +</p> +<h2>SYNOPSIS</h2> +<p>use StatisticsUtil;</p> +<p>use Statistics qw(:all);</p> +<p> +</p> +<h2>DESCRIPTION</h2> +<p><strong>StatisticsUtil</strong> module provides the following functions:</p> +<p> <a href="#average">Average</a>, <a href="#averagedeviation">AverageDeviation</a>, <a href="#correlation">Correlation</a>, <a href="#covariance">Covariance</a>, <a href="#euclidean">Euclidean</a>, <a href="#factorial">Factorial</a> +, <a href="#factorialdivison">FactorialDivison</a>, <a href="#frequency">Frequency</a>, <a href="#geometricmean">GeometricMean</a>, <a href="#harmonicmean">HarmonicMean</a>, <a href="#klargest">KLargest</a>, <a href="#ksmallest">KSmallest</a> +, <a href="#kurtosis">Kurtosis</a>, <a href="#maximum">Maximum</a>, <a href="#mean">Mean</a>, <a href="#median">Median</a>, <a href="#minimum">Minimum</a>, <a href="#mode">Mode</a>, <a href="#pearsoncorrelation">PearsonCorrelation</a>, <a href="#permutations">Permutations</a> +, <a href="#product">Product</a>, <a href="#rsquare">RSquare</a>, <a href="#range">Range</a>, <a href="#skewness">Skewness</a>, <a href="#standarddeviation">StandardDeviation</a>, <a href="#standarddeviationn">StandardDeviationN</a> +, <a href="#standarderror">StandardError</a>, <a href="#standardscores">StandardScores</a>, <a href="#standardscoresn">StandardScoresN</a>, <a href="#standardize">Standardize</a>, <a href="#sum">Sum</a>, <a href="#sumofsquares">SumOfSquares</a> +, <a href="#trimmean">TrimMean</a>, <a href="#variance">Variance</a>, <a href="#variancen">VarianceN</a> +</p><p> +</p> +<h2>METHODS</h2> +<dl> +<dt><strong><a name="average" class="item"><strong>Average</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + $Value = Average(\@DataArray);</div> +<p>Computes the mean of an array of numbers: SUM( x[i] ) / n</p> +</dd> +<dt><strong><a name="averagedeviation" class="item"><strong>AverageDeviation</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + $Value = AverageDeviation(\@DataArray);</div> +<p>Computes the average of the absolute deviation of an array of numbers: SUM( ABS(x[i] - Xmean) ) / n</p> +</dd> +<dt><strong><a name="correlation" class="item"><strong>Correlation</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + $Value = Correlation(\@XDataArray, \@YDataArray);</div> +<p>Computes the Pearson correlation coefficient between two arrays of numbers: +SUM( (x[i] - Xmean)(y[i] - Ymean) ) / SQRT( SUM( (x[i] - Xmean)^2 )(SUM( (y[i] - Ymean)^2 )) )</p> +</dd> +<dt><strong><a name="euclidean" class="item"><strong>Euclidean</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + $Return = Euclidean(\@DataArray);</div> +<p>Computes the euclidean distance of an array of numbers: SQRT( SUM( x[i] ** 2) )</p> +</dd> +<dt><strong><a name="covariance" class="item"><strong>Covariance</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + $Value = Covariance(\@XDataArray, \@YDataArray);</div> +<p>Computes the covariance between two arrays of numbers: SUM( (x[i] - Xmean) (y[i] - Ymean) ) / n</p> +</dd> +<dt><strong><a name="factorial" class="item"><strong>Factorial</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + $Value = Factorial($Num);</div> +<p>Computes the factorial of a positive integer.</p> +</dd> +<dt><strong><a name="factorialdivison" class="item"><strong>FactorialDivison</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + $Value = FactorialDivision($Numerator, $Denominator);</div> +<p>Compute the factorial divison of two positive integers.</p> +</dd> +<dt><strong><a name="frequency" class="item"><strong>Frequency</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + %FrequencyValues = Frequency(\@DataArray, [$NumOfBins]); +<br/> %FrequencyValues = Frequency(\@DataArray, [\@BinRange]);</div> +<p>A hash array is returned with keys and values representing range and frequency values, respectively. +The frequency value for a specific key corresponds to all the values which are greater than +the previous key and less than or equal to the current key. A key value representing maximum value is +added for generating frequency distribution for specific number of bins, and whenever the maximum +array value is greater than the maximum specified in bin range, it is also added to bin range.</p> +</dd> +<dt><strong><a name="geometricmean" class="item"><strong>GeometricMean</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + $Value = GeometricMean(\@DataArray);</div> +<p>Computes the geometric mean of an array of numbers: NthROOT( PRODUCT(x[i]) )</p> +</dd> +<dt><strong><a name="harmonicmean" class="item"><strong>HarmonicMean</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + $Value = HarmonicMean(\@DataArray);</div> +<p>Computes the harmonic mean of an array of numbers: 1 / ( SUM(1/x[i]) / n )</p> +</dd> +<dt><strong><a name="klargest" class="item"><strong>KLargest</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + $Value = KLargest(\@DataArray, $KthNumber);</div> +<p>Returns the k-largest value from an array of numbers.</p> +</dd> +<dt><strong><a name="ksmallest" class="item"><strong>KSmallest</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + $Value = KSmallest(\@DataArray, $KthNumber);</div> +<p>Returns the k-smallest value from an array of numbers.</p> +</dd> +<dt><strong><a name="kurtosis" class="item"><strong>Kurtosis</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + $Value = Kurtosis(\@DataArray);</div> +<p>Computes the kurtosis of an array of numbers: +[ {n(n + 1)/(n - 1)(n - 2)(n - 3)} SUM{ ((x[i] - Xmean)/STDDEV)^4 } ] - {3((n - 1)^2)}/{(n - 2)(n-3)}</p> +</dd> +<dt><strong><a name="maximum" class="item"><strong>Maximum</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + $Value = Maximum(\@DataArray);</div> +<p>Returns the largest value from an array of numbers.</p> +</dd> +<dt><strong><a name="minimum" class="item"><strong>Minimum</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + $Value = Minimum(\@DataArray);</div> +<p>Returns the smallest value from an array of numbers.</p> +</dd> +<dt><strong><a name="mean" class="item"><strong>Mean</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + $Value = Mean(\@DataArray);</div> +<p>Computes the mean of an array of numbers: SUM( x[i] ) / n</p> +</dd> +<dt><strong><a name="median" class="item"><strong>Median</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + $Value = Median(\@DataArray);</div> +<p>Computes the median value of an array of numbers. For an even number array, it's +the average of two middle values.</p> +<p>For even values of n: Xsorted[(n - 1)/2 + 1] +For odd values of n: (Xsorted[n/2] + Xsorted[n/2 + 1])/2</p> +</dd> +<dt><strong><a name="mode" class="item"><strong>Mode</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + $Value = Mode(\@DataArray);</div> +<p>Returns the most frequently occuring value in an array of numbers.</p> +</dd> +<dt><strong><a name="pearsoncorrelation" class="item"><strong>PearsonCorrelation</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + $Value = Correlation(\@XDataArray, \@YDataArray);</div> +<p>Computes the Pearson correlation coefficient between two arrays of numbers: +SUM( (x[i] - Xmean)(y[i] - Ymean) ) / SQRT( SUM( (x[i] - Xmean)^2 )(SUM( (y[i] - Ymean)^2 )) )</p> +</dd> +<dt><strong><a name="permutations" class="item"><strong>Permutations</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + $PermutationsRef = Permutations(@DataToPermute);</div> +<p>Generate all possible permuations or a specific permutations of items in an array +and return a reference to an array containing array references to generated permuations.</p> +<p>This alogrithm is based on the example provided by Mark Jason-Dominus, and is available +at CPAN as mjd_permute standalone script.</p> +</dd> +<dt><strong><a name="product" class="item"><strong>Product</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + $Value = Product(\@DataArray);</div> +<p>Compute the product of an array of numbers.</p> +</dd> +<dt><strong><a name="range" class="item"><strong>Range</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + ($Smallest, $Largest) = Range(\@DataArray);</div> +<p>Return the smallest and largest values from an array of numbers.</p> +</dd> +<dt><strong><a name="rsquare" class="item"><strong>RSquare</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + $Value = RSquare(\@XDataArray, \@YDataArray);</div> +<p>Computes square of the Pearson correlation coefficient between two arrays of numbers.</p> +</dd> +<dt><strong><a name="skewness" class="item"><strong>Skewness</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + $Value = Skewness(\@DataArray);</div> +<p>Computes the skewness of an array of numbers: +{n/(n - 1)(n - 2)} SUM{ ((x[i] - Xmean)/STDDEV)^3 }</p> +</dd> +<dt><strong><a name="standarddeviation" class="item"><strong>StandardDeviation</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + $Value = StandardDeviation(\@DataArray);</div> +<p>Computes the standard deviation of an array of numbers. +SQRT ( SUM( (x[i] - mean)^2 ) / (n - 1) )</p> +</dd> +<dt><strong><a name="standarddeviationn" class="item"><strong>StandardDeviationN</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + $Value = StandardDeviationN(\@DataArray);</div> +<p>Computes the standard deviation of an array of numbers representing entire population: +SQRT ( SUM( (x[i] - mean)^2 ) / n )</p> +</dd> +<dt><strong><a name="standarderror" class="item"><strong>StandardError</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + $Value = StandardError($StandardDeviation, $Count);</div> +<p>Computes the standard error using standard deviation and sample size.</p> +</dd> +<dt><strong><a name="standardize" class="item"><strong>Standardize</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + $Value = Standardize($Value, $Mean, $StandardDeviation);</div> +<p>Standardizes the value using mean and standard deviation.</p> +</dd> +<dt><strong><a name="standardscores" class="item"><strong>StandardScores</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + @Values = StandardScores(\@DataArray);</div> +<p>Computes the standard deviation above the mean for an array of numbers: +(x[i] - mean) / (n - 1)</p> +</dd> +<dt><strong><a name="standardscoresn" class="item"><strong>StandardScoresN</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + @Values = StandardScoresN(\@DataArray);</div> +<p>Computes the standard deviation above the mean for an array of numbers representing entire population: +(x[i] - mean) / n</p> +</dd> +<dt><strong><a name="sum" class="item"><strong>Sum</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + $Value = Sum(\@DataArray);</div> +<p>Compute the sum of an array of numbers.</p> +</dd> +<dt><strong><a name="sumofsquares" class="item"><strong>SumOfSquares</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + $Value = SumOfSquares(\@DataArray);</div> +<p>Computes the sum of an array of numbers.</p> +</dd> +<dt><strong><a name="trimmean" class="item"><strong>TrimMean</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + $Value = TrimMean(\@DataArray, $FractionToExclude));</div> +<p>Computes the mean of an array of numbers by excluding a fraction of +numbers from the top and bottom of the data set.</p> +</dd> +<dt><strong><a name="variance" class="item"><strong>Variance</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + $Value = Variance(\@DataArray);</div> +<p>Computes the variance of an array of numbers: SUM( (x[i] - Xmean)^2 / (n - 1) )</p> +</dd> +<dt><strong><a name="variancen" class="item"><strong>VarianceN</strong></a></strong></dt> +<dd> +<div class="OptionsBox"> + $Value = Variance(\@DataArray);</div> +<p>Compute the variance of an array of numbers representing entire population: +SUM( (x[i] - Xmean)^2 / n )</p> +</dd> +</dl> +<p> +</p> +<h2>AUTHOR</h2> +<p><a href="mailto:msud@san.rr.com">Manish Sud</a></p> +<p> +</p> +<h2>SEE ALSO</h2> +<p><a href="./Constants.html">Constants.pm</a>, <a href="./ConversionsUtil.html">ConversionsUtil.pm</a>, <a href="./MathUtil.html">MathUtil.pm</a> +</p> +<p> +</p> +<h2>COPYRIGHT</h2> +<p>Copyright (C) 2015 Manish Sud. All rights reserved.</p> +<p>This file is part of MayaChemTools.</p> +<p>MayaChemTools is free software; you can redistribute it and/or modify it under +the terms of the GNU Lesser General Public License as published by the Free +Software Foundation; either version 3 of the License, or (at your option) +any later version.</p> +<p> </p><p> </p><div class="DocNav"> +<table width="100%" border=0 cellpadding=0 cellspacing=2> +<tr align="left" valign="top"><td width="33%" align="left"><a href="./SequenceFileUtil.html" title="SequenceFileUtil.html">Previous</a> <a href="./index.html" title="Table of Contents">TOC</a> <a href="./TextUtil.html" title="TextUtil.html">Next</a></td><td width="34%" align="middle"><strong>March 29, 2015</strong></td><td width="33%" align="right"><strong>StatisticsUtil.pm</strong></td></tr> +</table> +</div> +<br /> +<center> +<img src="../../images/h2o2.png"> +</center> +</body> +</html>