org.openimaj.feature

Class MultidimensionalDoubleFV

java.lang.Object

org.openimaj.feature.ArrayFeatureVector<double[]>

org.openimaj.feature.DoubleFV

org.openimaj.feature.MultidimensionalDoubleFV

All Implemented Interfaces:

Serializable, Cloneable, FeatureVector, Readable, ReadableASCII, ReadableBinary, ReadWriteable, Writeable, WriteableASCII, WriteableBinary, Concatenatable<DoubleFV,DoubleFV>

Direct Known Subclasses:

MultidimensionalHistogram

public class MultidimensionalDoubleFV
extends DoubleFV
implements Serializable, Cloneable, FeatureVector

Basic double multidimensional feature vector implementation

Author:

Jonathon Hare

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
int[]	nbins Array containing the number of bins in each dimension

Fields inherited from class org.openimaj.feature.ArrayFeatureVector

values

Constructor Summary

Constructors

Constructor and Description
MultidimensionalDoubleFV() Construct an empty feature vector
MultidimensionalDoubleFV(double[][] values) Construct from 2-dimensional array
MultidimensionalDoubleFV(double[][][] values) Construct from 3-dimensional array
MultidimensionalDoubleFV(double[] values, int... nbins) Construct from flattened values array and dimensions
MultidimensionalDoubleFV(int... nbins) Construct empty FV with given dimensions

Method Summary

Modifier and Type	Method and Description
String	asciiHeader() Header for ascii input.
MultidimensionalDoubleFV	asDoubleFV() Convert the FV to a DoubleFV representation
byte[]	binaryHeader() Header for binary input.
MultidimensionalDoubleFV	clone()
double	compare(MultidimensionalDoubleFV h, DoubleFVComparison method) Compare this FV to another with the given method.
double	get(int... coords) Get the element at the given n-dimensional coordinate
double	get(int x) Get the element at the given flat index
int[]	getCoordinates(int index) Given an index, calculate the coordinate which would map to that index using getIndex(int...)
int	getIndex(int... coords) Convert the given coordinate into a flat index value
double[]	getVector() Get the underlying flat-vector representation
void	readASCII(Scanner in) Read internal state from in.
void	readBinary(DataInput in) Read internal state from in.
void	set(double value, int... coords) Set the the element at the given n-dimensional coordinate
String	toString()
void	writeASCII(PrintWriter out) Write the content of this as ascii to out.
void	writeBinary(DataOutput out) Write the content of this as binary to out.

Methods inherited from class org.openimaj.feature.DoubleFV

asDoubleVector, compare, concatenate, concatenate, equals, getAsDouble, hashCode, length, newInstance, normaliseFV, normaliseFV, normaliseFV, normaliseFV, setFromDouble, subvector, subvector

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.openimaj.feature.FeatureVector

asDoubleVector, getAsDouble, length, newInstance, normaliseFV, normaliseFV, normaliseFV, normaliseFV, setFromDouble

Field Detail

nbins

public int[] nbins

Array containing the number of bins in each dimension

Constructor Detail

MultidimensionalDoubleFV

public MultidimensionalDoubleFV()

Construct an empty feature vector

MultidimensionalDoubleFV

public MultidimensionalDoubleFV(int... nbins)

Construct empty FV with given dimensions

Parameters:

nbins - the number of bins in each dimension

MultidimensionalDoubleFV

public MultidimensionalDoubleFV(double[] values,
                                int... nbins)

Construct from flattened values array and dimensions

Parameters:

values - the flat array of values

nbins - the number of bins in each dimension

MultidimensionalDoubleFV

public MultidimensionalDoubleFV(double[][] values)

Construct from 2-dimensional array

Parameters:

values - the 2d array

MultidimensionalDoubleFV

public MultidimensionalDoubleFV(double[][][] values)

Construct from 3-dimensional array

Parameters:

values - the 3d array

Method Detail

getVector

public double[] getVector()

Get the underlying flat-vector representation

Specified by:

getVector in interface FeatureVector

Overrides:

getVector in class ArrayFeatureVector<double[]>

Returns:

a flat 1d representation of the feature

get

public double get(int x)

Get the element at the given flat index

Overrides:

get in class DoubleFV

Parameters:

x - the flattened element index

Returns:

the value corresponding to x

getIndex

public int getIndex(int... coords)

Convert the given coordinate into a flat index value

Parameters:

coords - the coordinate

Returns:

the flattened index

set

public void set(double value,
                int... coords)

Set the the element at the given n-dimensional coordinate

Parameters:

value - the value to set

coords - the coordinates

get

public double get(int... coords)

Get the element at the given n-dimensional coordinate

Parameters:

coords - the coordinates

Returns:

the value at the given coordinates

clone

public MultidimensionalDoubleFV clone()

Overrides:

clone in class DoubleFV

toString

public String toString()

Overrides:

toString in class DoubleFV

asDoubleFV

public MultidimensionalDoubleFV asDoubleFV()

Convert the FV to a DoubleFV representation

Specified by:

asDoubleFV in interface FeatureVector

Overrides:

asDoubleFV in class DoubleFV

Returns:

the DoubleFV representation

compare

public double compare(MultidimensionalDoubleFV h,
                      DoubleFVComparison method)

Compare this FV to another with the given method.

Parameters:

h - the feature to compare against.

method - the method to compare with.

Returns:

a score determined by the comparison method.

writeBinary

public void writeBinary(DataOutput out)
                 throws IOException

Description copied from interface: WriteableBinary

Write the content of this as binary to out.

Specified by:

writeBinary in interface WriteableBinary

Overrides:

writeBinary in class DoubleFV

Parameters:

out - sink to write to

Throws:

IOException - an error writing to out

writeASCII

public void writeASCII(PrintWriter out)
                throws IOException

Description copied from interface: WriteableASCII

Write the content of this as ascii to out.

Specified by:

writeASCII in interface WriteableASCII

Overrides:

writeASCII in class DoubleFV

Parameters:

out - sink to write to

Throws:

IOException - an error writing to out

readBinary

public void readBinary(DataInput in)
                throws IOException

Description copied from interface: ReadableBinary

Read internal state from in.

Specified by:

readBinary in interface ReadableBinary

Overrides:

readBinary in class DoubleFV

Parameters:

in - source to read from.

Throws:

IOException - an error reading input

readASCII

public void readASCII(Scanner in)
               throws IOException

Description copied from interface: ReadableASCII

Read internal state from in.

Specified by:

readASCII in interface ReadableASCII

Overrides:

readASCII in class DoubleFV

Parameters:

in - source to read from.

Throws:

IOException - an error reading input

binaryHeader

public byte[] binaryHeader()

Description copied from interface: ReadableBinary

Header for binary input. Will be automatically read by IOUtils when using readBinary().

Specified by:

binaryHeader in interface ReadableBinary

Specified by:

binaryHeader in interface WriteableBinary

Overrides:

binaryHeader in class DoubleFV

Returns:

header

asciiHeader

public String asciiHeader()

Description copied from interface: ReadableASCII

Header for ascii input. Will be automatically read by IOUtils when using readASCII().

Specified by:

asciiHeader in interface ReadableASCII

Specified by:

asciiHeader in interface WriteableASCII

Overrides:

asciiHeader in class DoubleFV

Returns:

header

getCoordinates

public int[] getCoordinates(int index)

Given an index, calculate the coordinate which would map to that index using getIndex(int...)

Parameters:

index -

Returns:

the coordinates