at.ofai.music.plot

Class M

java.lang.Object

at.ofai.music.plot.M

public class M
extends java.lang.Object

A useful class providing various mathematical basic functionalities that might be of use more than once.

Author:

Werner Goebl, Aug. 2005; Aug. 2006; April 2007

Constructor Summary

Constructors

Constructor and Description
M()

Method Summary

Methods

Modifier and Type	Method and Description
static double[]	autoCorr(int[] X) Calculates auto correlation of the array X, returning an array double[] of the same length (with 1 as the first and last value).
static double[]	autoCorr(int[] X, int maxShift) Calculates an auto correlation of the array int[] X until the maximum shift of int maxShift, returning an array of correlation coefficients with the length maxShift.
static double	calcCorr(double[] x, double[] y) Computes the Pearson's correlation coefficient of the arrays x and y and returns a double (between -1 and 1)
static double	calcCorr(int[] x, int[] y) Computes the Pearson's correlation coefficient of the arrays x and y and returns a double (between -1 and 1)
static Data2D	hist(double[] data, int nBins) Histogram.
static Data2D	histc(double[] data, double[] binEdges) Histogram.
static double[][]	histogram(double[] data, double binWidth)
static double[][]	histogram(double[] data, double binWidth, double binZero) Code from flanagan's stat package.
static double[]	interp1(double[] x, double[] y, double[] xx) INTERP1 1-D interpolation (table lookup); interpolates linearly to find yy, the values of the underlying function y at the points in the array xx.
static double[]	lili2arr(java.util.LinkedList<java.lang.Double> L) Converts a LinkedList into an array.
static void	main(java.lang.String[] args)
static double	max(double[] x) Returns the maximum value of an array.
static int	max(int[] x) Returns the maximum value of an array.
static double	max(java.util.LinkedList<java.lang.Double> x) Returns the maximum value of an LinkedList.
static double	mean(double[] x) Returns the arithmetic mean value of an array.
static double	mean(java.util.LinkedList<java.lang.Double> x) Returns the arithmetic mean value of an LinkedList.
static double	mean(long[] x) Returns the arithmetic mean value of an array.
static double	min(double[] x) Returns the minimum value of an array.
static int	min(int[] x) Returns the minimum value of an array.
static double	min(java.util.LinkedList<java.lang.Double> x) Returns the minimum value of an array.
static double	mode(double[] arr) Calculates a mode value for the double[] array taking a 10% binWidth rounded to the nearest power of 10.
static double	mode(double[] arr, double binWidth) Calculates a mode values (most often value) of the input array double[] using double binWidth as categorisation units.
static void	out(java.lang.String str)
static void	outn(java.lang.String str)
static double	sum(double[] x) Returns the sum of an array.
static double	sum(java.util.LinkedList<java.lang.Double> x) Returns the sum of an LinkedList.
static long	sum(long[] x) Returns the sum of an array.
static double	var(double[] x) Returns the variance of an array.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

M

public M()

Method Detail

min

public static int min(int[] x)

Returns the minimum value of an array.

Parameters:

x - input array

Returns:

minimum value

min

public static double min(double[] x)

Returns the minimum value of an array.

Parameters:

x - input array

Returns:

minimum value

min

public static double min(java.util.LinkedList<java.lang.Double> x)

Returns the minimum value of an array.

Parameters:

x - input LinkedList

Returns:

minimum value

max

public static int max(int[] x)

Returns the maximum value of an array.

Parameters:

x - input array

Returns:

maximum value

max

public static double max(double[] x)

Returns the maximum value of an array.

Parameters:

x - input array

Returns:

maximum value

max

public static double max(java.util.LinkedList<java.lang.Double> x)

Returns the maximum value of an LinkedList.

Parameters:

x - input array

Returns:

maximum value

mean

public static double mean(double[] x)

Returns the arithmetic mean value of an array.

Parameters:

x - input array

Returns:

arithmetic mean

mean

public static double mean(long[] x)

Returns the arithmetic mean value of an array.

Parameters:

x - input array

Returns:

arithmetic mean

mean

public static double mean(java.util.LinkedList<java.lang.Double> x)

Returns the arithmetic mean value of an LinkedList.

Parameters:

x - input array

Returns:

arithmetic mean

sum

public static double sum(double[] x)

Returns the sum of an array.

Parameters:

x - input array

Returns:

sum of the array

sum

public static long sum(long[] x)

Returns the sum of an array.

Parameters:

x - input array

Returns:

sum of the array

sum

public static double sum(java.util.LinkedList<java.lang.Double> x)

Returns the sum of an LinkedList.

Parameters:

x - input array

Returns:

sum of the LinkedList

var

public static double var(double[] x)

Returns the variance of an array.

Parameters:

x - input array

Returns:

variance

autoCorr

public static double[] autoCorr(int[] X)

Calculates auto correlation of the array X, returning an array double[] of the same length (with 1 as the first and last value).

Parameters:

X - input array int[].

Returns:

double[] (with 1 as first and last value).

autoCorr

public static double[] autoCorr(int[] X,
                int maxShift)

Calculates an auto correlation of the array int[] X until the maximum shift of int maxShift, returning an array of correlation coefficients with the length maxShift.

Parameters:

X -

maxShift -

Returns:

double[] with the lenght maxShift, with 1 as the first value

calcCorr

public static double calcCorr(int[] x,
              int[] y)

Computes the Pearson's correlation coefficient of the arrays x and y and returns a double (between -1 and 1)

Parameters:

x - input array (int[]).

y - input array (int[]); must be same length as x.

Returns:

correlation coefficient between -1 and 1.

calcCorr

public static double calcCorr(double[] x,
              double[] y)

Computes the Pearson's correlation coefficient of the arrays x and y and returns a double (between -1 and 1)

Parameters:

x - input array (double[]).

y - input array (double[]); must be same length as x.

Returns:

correlation coefficient between -1 and 1.

mode

public static double mode(double[] arr)

Calculates a mode value for the double[] array taking a 10% binWidth rounded to the nearest power of 10. WG, Aug 2005

Parameters:

arr - input array double[]

Returns:

double mode value

mode

public static double mode(double[] arr,
          double binWidth)

Calculates a mode values (most often value) of the input array double[] using double binWidth as categorisation units. WG, Aug 2005

Parameters:

arr - double[] array of values

binWidth - double bin width

Returns:

double mode value (most often value).

lili2arr

public static double[] lili2arr(java.util.LinkedList<java.lang.Double> L)

Converts a LinkedList into an array.

Parameters:

L - input LinkedList

Returns:

output array

interp1

public static double[] interp1(double[] x,
               double[] y,
               double[] xx)

INTERP1 1-D interpolation (table lookup); interpolates linearly to find yy, the values of the underlying function y at the points in the array xx. x and y must be vectors of length N.

Parameters:

x - input vector

y - input vector with the same length

xx - x values for the interpolated vector

Returns:

(linearly) interpolated yy values

main

public static void main(java.lang.String[] args)

hist

public static Data2D hist(double[] data,
          int nBins)

Histogram. Groups the elements of data into nBins equally spaced containers and returns the number of elements in each container.

Parameters:

data - Data array

nBins - Number of bins of the histogram

Returns:

array[0][] = binCenters; array[1][] = binCounts.

histc

public static Data2D histc(double[] data,
           double[] binEdges)

Histogram. For vector X, counts the number of values in X that fall between the elements in the binEdges vector.

Parameters:

data -

binEdges -

Returns:

array[0][] = binCenters; array[1][] = binCounts.

histogram

public static double[][] histogram(double[] data,
                   double binWidth)

Parameters:

data -

binWidth -

Returns:

at.ofai.music.plot.Data2D object

histogram

public static double[][] histogram(double[] data,
                   double binWidth,
                   double binZero)

Code from flanagan's stat package.

Parameters:

data -

binWidth -

binZero -

Returns:

out

public static void out(java.lang.String str)

outn

public static void outn(java.lang.String str)