edu.emory.mathcs.utils

Class Utils

java.lang.Object

edu.emory.mathcs.utils.Utils

public class Utils
extends Object

Utility class for translating Octave/Numpy code to Colt.

Author:

Richard Lincoln

Field Summary

Fields

Modifier and Type	Field and Description
static DComplexFunctions	cfunc
static double[]	CNEG_ONE
static double[]	CONE
static double[]	CZERO
static DoubleFunctions	dfunc
static double	EPS Machine epsilon.
static IntFunctions	ifunc
static double[]	j
static Utils	util

Method Summary

Methods

Modifier and Type	Method and Description
static boolean	all(DoubleMatrix1D x)
static boolean	all(IntMatrix1D x)
static boolean	any(DoubleMatrix1D x)
static IntMatrix1D	any(DoubleMatrix2D x)
static boolean	any(int[] x)
static boolean	any(IntMatrix1D x)
static DoubleMatrix1D	append(DoubleMatrix1D x, double a) Appends a value to the given matrix.
static IntMatrix1D	append(IntMatrix1D x, int a) Appends a value to the given matrix.
static DComplexMatrix1D	complex(DoubleMatrix1D real, DoubleMatrix1D imaginary)
static DComplexMatrix2D	complex(DoubleMatrix2D real, DoubleMatrix2D imaginary)
static DComplexMatrix1D	cplxm(IntMatrix1D ix)
static DoubleMatrix1D	dbla(int[] ix)
static DoubleMatrix1D	dblm(IntMatrix1D ix)
static double[]	dcat(double[] a, double[] b)
static DoubleMatrix2D	delete(DoubleMatrix2D m, int idx)
static DoubleMatrix2D	delete(DoubleMatrix2D m, int idx, int axis)
static DoubleMatrix1D	diff(DoubleMatrix1D x)
static IntMatrix1D	diff(IntMatrix1D x)
static double[]	drange(double stop)
static double[]	drange(double start, double stop)
static double[]	drange(double start, double stop, double step)
static double[]	drange(int stop)
static double[]	drange(int start, int stop)
static double[]	drange(int start, int stop, int step)
static int[]	icat(int[] a, int[] b)
static int[]	inta(DoubleMatrix1D d)
static IntMatrix1D	intm(DoubleMatrix1D d)
static int[]	irange(int stop)
static int[]	irange(int start, int stop)
static int[]	irange(int start, int stop, int step)
static double	max(DoubleMatrix1D a)
static int	max(int[] t)
static double	min(DoubleMatrix1D a)
static int[]	nonzero(DoubleMatrix1D a)
static int[]	nonzero(IntMatrix1D a)
static int[]	ones(int size)
static DComplexMatrix1D	polar(DoubleMatrix1D r, DoubleMatrix1D theta)
static DComplexMatrix1D	polar(DoubleMatrix1D r, DoubleMatrix1D theta, boolean radians)
static DComplexMatrix2D	polar(DoubleMatrix2D r, DoubleMatrix2D theta)
static DComplexMatrix2D	polar(DoubleMatrix2D r, DoubleMatrix2D theta, boolean radians)
static String[]	scat(String[] a, String[] b)
static IntMatrix1D	sub2ind(int rows, int cols, IntMatrix1D I, IntMatrix1D J)
static IntMatrix1D	sub2ind(int rows, int cols, IntMatrix1D I, IntMatrix1D J, boolean row_major)
static DComplexMatrix2D	unflatten(DComplexMatrix1D a, boolean col) Creates a 2-dimensional copy of the given matrix
static DoubleMatrix2D	unflatten(DoubleMatrix1D a, boolean col) Creates a 2-dimensional copy of the given matrix
static IntMatrix2D	unflatten(IntMatrix1D a)
static IntMatrix2D	unflatten(IntMatrix1D a, boolean col)
static int[]	zeros(int size)

Methods inherited from class java.lang.Object

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

Field Detail

ifunc

public static final IntFunctions ifunc

dfunc

public static final DoubleFunctions dfunc

cfunc

public static final DComplexFunctions cfunc

j

public static final double[] j

CZERO

public static final double[] CZERO

CONE

public static final double[] CONE

CNEG_ONE

public static final double[] CNEG_ONE

util

public static final Utils util

EPS

public static final double EPS

Machine epsilon.

Method Detail

irange

public static int[] irange(int stop)

Parameters:

stop -

Returns:

irange

public static int[] irange(int start,
           int stop)

Parameters:

start -

stop -

Returns:

irange

public static int[] irange(int start,
           int stop,
           int step)

Parameters:

start -

stop -

step -

Returns:

drange

public static double[] drange(int stop)

Parameters:

stop -

Returns:

drange

public static double[] drange(int start,
              int stop)

Parameters:

start -

stop -

Returns:

drange

public static double[] drange(int start,
              int stop,
              int step)

Parameters:

start -

stop -

step -

Returns:

drange

public static double[] drange(double stop)

Parameters:

stop -

Returns:

an arithmetic progression.

drange

public static double[] drange(double start,
              double stop)

Parameters:

start -

stop - an arithmetic progression.

Returns:

drange

public static double[] drange(double start,
              double stop,
              double step)

Parameters:

start -

stop -

step - increment (or decrement)

Returns:

an arithmetic progression.

zeros

public static int[] zeros(int size)

Parameters:

n -

Returns:

ones

public static int[] ones(int size)

Parameters:

size - array length

Returns:

an integer array with all elements = 1.

inta

public static int[] inta(DoubleMatrix1D d)

Parameters:

d -

Returns:

intm

public static IntMatrix1D intm(DoubleMatrix1D d)

Parameters:

d -

Returns:

dbla

public static DoubleMatrix1D dbla(int[] ix)

Parameters:

d -

Returns:

dblm

public static DoubleMatrix1D dblm(IntMatrix1D ix)

Parameters:

d -

Returns:

cplxm

public static DComplexMatrix1D cplxm(IntMatrix1D ix)

Parameters:

d -

Returns:

max

public static double max(DoubleMatrix1D a)

Parameters:

a -

Returns:

min

public static double min(DoubleMatrix1D a)

Parameters:

a -

Returns:

max

public static int max(int[] t)

Parameters:

t -

Returns:

icat

public static int[] icat(int[] a,
         int[] b)

Parameters:

a -

b -

Returns:

dcat

public static double[] dcat(double[] a,
            double[] b)

Parameters:

a -

b -

Returns:

scat

public static String[] scat(String[] a,
            String[] b)

Parameters:

a -

b -

Returns:

nonzero

public static int[] nonzero(IntMatrix1D a)

Parameters:

a -

Returns:

nonzero

public static int[] nonzero(DoubleMatrix1D a)

Parameters:

a -

Returns:

polar

public static DComplexMatrix1D polar(DoubleMatrix1D r,
                     DoubleMatrix1D theta)

Parameters:

r - polar radius.

theta - polar angle in radians.

Returns:

complex polar representation.

polar

public static DComplexMatrix1D polar(DoubleMatrix1D r,
                     DoubleMatrix1D theta,
                     boolean radians)

Parameters:

r - polar radius.

theta - polar angle.

radians - is 'theta' expressed in radians.

Returns:

complex polar representation.

polar

public static DComplexMatrix2D polar(DoubleMatrix2D r,
                     DoubleMatrix2D theta)

polar

public static DComplexMatrix2D polar(DoubleMatrix2D r,
                     DoubleMatrix2D theta,
                     boolean radians)

diff

public static IntMatrix1D diff(IntMatrix1D x)

Parameters:

x -

Returns:

[x(1)-x(0) x(2)-x(1) ... x(n)-x(n-1)]

diff

public static DoubleMatrix1D diff(DoubleMatrix1D x)

Parameters:

x -

Returns:

[x(1)-x(0) x(2)-x(1) ... x(n)-x(n-1)]

any

public static boolean any(int[] x)

Parameters:

x - an array of integers.

Returns:

true if any element of vector x is a nonzero number.

any

public static boolean any(IntMatrix1D x)

Parameters:

x - a vector of integers.

Returns:

true if any element of vector x is a nonzero number.

any

public static boolean any(DoubleMatrix1D x)

Parameters:

x - a vector of doubles.

Returns:

true if any element of vector x is a nonzero number.

any

public static IntMatrix1D any(DoubleMatrix2D x)

Parameters:

x -

Returns:

all

public static boolean all(IntMatrix1D x)

Parameters:

x - a vector of integers.

Returns:

true if all elements of 'x' are nonzero.

all

public static boolean all(DoubleMatrix1D x)

Parameters:

x - a vector of doubles.

Returns:

true if all elements of 'x' are nonzero.

complex

public static DComplexMatrix1D complex(DoubleMatrix1D real,
                       DoubleMatrix1D imaginary)

Parameters:

real - real component, may be null

imaginary - imaginary component, may be null

Returns:

a complex vector

complex

public static DComplexMatrix2D complex(DoubleMatrix2D real,
                       DoubleMatrix2D imaginary)

Parameters:

real - real component, may be null

imaginary - imaginary component, may be null

Returns:

a complex matrix

sub2ind

public static IntMatrix1D sub2ind(int rows,
                  int cols,
                  IntMatrix1D I,
                  IntMatrix1D J)

Parameters:

rows -

cols -

I -

J -

Returns:

sub2ind

public static IntMatrix1D sub2ind(int rows,
                  int cols,
                  IntMatrix1D I,
                  IntMatrix1D J,
                  boolean row_major)

Parameters:

rows -

cols -

I -

J -

row_major -

Returns:

append

public static DoubleMatrix1D append(DoubleMatrix1D x,
                    double a)

Appends a value to the given matrix.

Parameters:

x - input matrix of length n

a - value to append

Returns:

new matrix of length n + 1

append

public static IntMatrix1D append(IntMatrix1D x,
                 int a)

Appends a value to the given matrix.

Parameters:

x - input matrix of length n

a - value to append

Returns:

new matrix of length n + 1

unflatten

public static DoubleMatrix2D unflatten(DoubleMatrix1D a,
                       boolean col)

Creates a 2-dimensional copy of the given matrix

Parameters:

a - 1D input matrix

col - create a column vector?

Returns:

a 2D copy of a

unflatten

public static DComplexMatrix2D unflatten(DComplexMatrix1D a,
                         boolean col)

Creates a 2-dimensional copy of the given matrix

Parameters:

a - 1D input matrix

col - create a column vector?

Returns:

a 2D copy of a

unflatten

public static IntMatrix2D unflatten(IntMatrix1D a)

unflatten

public static IntMatrix2D unflatten(IntMatrix1D a,
                    boolean col)

delete

public static DoubleMatrix2D delete(DoubleMatrix2D m,
                    int idx)

delete

public static DoubleMatrix2D delete(DoubleMatrix2D m,
                    int idx,
                    int axis)