edu.umass.cs.mallet.base.types

Class MatrixOps

java.lang.Object

edu.umass.cs.mallet.base.types.MatrixOps

public final class MatrixOps
extends Object

A class of static utility functions for manipulating arrays of double.

Constructor Summary

Constructors

Constructor and Description
MatrixOps()

Method Summary

Modifier and Type	Method and Description
static double	absNorm(double[] m)
static double	absNormalize(double[] m)
static double	dot(double[] m1, double[] m2) Deprecated. Use dotProduct()
static double	dotProduct(double[] m1, double[] m2)
static double	infinityNorm(double[] m)
static boolean	isNaN(double[] m)
static void	log(double[] m)
static double	max(double[] elems)
static int	max(int[] elems)
static int	max(int[][] m)
static double	maxAbsdiff(double[] v1, double[] v2) Returns the maximum elementwise absolute difference between two vectors.
static double	mean(double[] m)
static double	oneNorm(double[] m)
static void	plusEquals(double[][] m1, double[][] m2, double factor)
static void	plusEquals(double[] m, double toadd) Adds a scalar to every element in an array.
static void	plusEquals(double[] m1, double[] m2)
static void	plusEquals(double[] m1, double[] m2, double factor)
static void	print(double[] m) Prints a double array to standard output
static void	print(double[][] arr)
static void	print(int[] m)
static void	print(int[][] arr)
static void	print(PrintWriter out, double[] m) Prints a double array to the given PrintWriter.
static void	printInRows(double[] arr)
static double[]	randomVector(int n, Random r)
static double	rowDotProduct(double[] m, int nc, int ri, Vector v, double factor, int maxCi, FeatureSelection selection)
static double	rowDotProduct(double[] m, int nc, int ri, Vector v, int maxCi, FeatureSelection selection)
static void	rowPlusEquals(double[] m, int nc, int ri, Vector v, double factor)
static void	rowSetAll(double[] m, int nc, int ri, double v, FeatureSelection fselection, boolean ifSelected) If "ifSelected" is false, it reverses the selection.
static void	set(double[] dest, double[] source)
static void	setAll(double[][][] m, double v)
static void	setAll(double[][] m, double v)
static void	setAll(double[] m, double v) Sets every element of a double array to a given value.
static double	stddev(double[] m) Return the standard deviation
static double	stderr(double[] m)
static void	substitute(double[] m, double oldValue, double newValue)
static double	sum(double[] m)
static double	sum(double[][] m)
static int	sum(int[] m)
static double	sum(Vector v)
static void	timesEquals(double[][] m, double factor)
static void	timesEquals(double[] m, double factor) Multiplies every element in an array by a scalar.
static void	timesEquals(double[] m1, double[] m2)
static String	toString(Object m) Print a space-separated array of elements
static double	twoNorm(double[] m)
static double	twoNormalize(double[] m)

Methods inherited from class java.lang.Object

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

Constructor Detail

MatrixOps

public MatrixOps()

Method Detail

setAll

public static void setAll(double[] m,
                          double v)

Sets every element of a double array to a given value.

Parameters:

m - The array to modify

v - The value

set

public static void set(double[] dest,
                       double[] source)

timesEquals

public static void timesEquals(double[] m,
                               double factor)

Multiplies every element in an array by a scalar.

Parameters:

m - The array

factor - The scalar

timesEquals

public static void timesEquals(double[] m1,
                               double[] m2)

plusEquals

public static void plusEquals(double[] m,
                              double toadd)

Adds a scalar to every element in an array.

Parameters:

m - The array

toadd - The scalar

plusEquals

public static void plusEquals(double[] m1,
                              double[] m2)

plusEquals

public static void plusEquals(double[] m1,
                              double[] m2,
                              double factor)

plusEquals

public static void plusEquals(double[][] m1,
                              double[][] m2,
                              double factor)

log

public static void log(double[] m)

dot

public static double dot(double[] m1,
                         double[] m2)

Deprecated. Use dotProduct()

dotProduct

public static double dotProduct(double[] m1,
                                double[] m2)

absNorm

public static double absNorm(double[] m)

twoNorm

public static double twoNorm(double[] m)

oneNorm

public static double oneNorm(double[] m)

infinityNorm

public static double infinityNorm(double[] m)

absNormalize

public static double absNormalize(double[] m)

twoNormalize

public static double twoNormalize(double[] m)

substitute

public static void substitute(double[] m,
                              double oldValue,
                              double newValue)

rowSetAll

public static final void rowSetAll(double[] m,
                                   int nc,
                                   int ri,
                                   double v,
                                   FeatureSelection fselection,
                                   boolean ifSelected)

If "ifSelected" is false, it reverses the selection. If "fselection" is null, this implies that all features are selected; all values in the row will be changed unless "ifSelected" is false.

rowDotProduct

public static double rowDotProduct(double[] m,
                                   int nc,
                                   int ri,
                                   Vector v,
                                   int maxCi,
                                   FeatureSelection selection)

rowDotProduct

public static double rowDotProduct(double[] m,
                                   int nc,
                                   int ri,
                                   Vector v,
                                   double factor,
                                   int maxCi,
                                   FeatureSelection selection)

rowPlusEquals

public static final void rowPlusEquals(double[] m,
                                       int nc,
                                       int ri,
                                       Vector v,
                                       double factor)

isNaN

public static boolean isNaN(double[] m)

sum

public static double sum(double[] m)

sum

public static double sum(double[][] m)

sum

public static int sum(int[] m)

sum

public static double sum(Vector v)

mean

public static double mean(double[] m)

stddev

public static double stddev(double[] m)

Return the standard deviation

stderr

public static double stderr(double[] m)

print

public static final void print(double[] m)

Prints a double array to standard output

Parameters:

m - Array to print.

print

public static final void print(PrintWriter out,
                               double[] m)

Prints a double array to the given PrintWriter.

Parameters:

out - Writer to print ouput to

m - Array to print.

print

public static final void print(double[][] arr)

toString

public static final String toString(Object m)

Print a space-separated array of elements

Parameters:

m - An array of any type

printInRows

public static final void printInRows(double[] arr)

setAll

public static void setAll(double[][][] m,
                          double v)

setAll

public static void setAll(double[][] m,
                          double v)

print

public static void print(int[][] arr)

print

public static void print(int[] m)

randomVector

public static double[] randomVector(int n,
                                    Random r)

timesEquals

public static void timesEquals(double[][] m,
                               double factor)

maxAbsdiff

public static double maxAbsdiff(double[] v1,
                                double[] v2)

Returns the maximum elementwise absolute difference between two vectors. This is the same as infinityNorm (v1 - v2) (if that were legal Java).

Parameters:

v1 - Input vector, as double[]

v2 - Input vector, as double[]

Returns:

max

public static int max(int[][] m)

max

public static int max(int[] elems)

max

public static double max(double[] elems)