org.openimaj.feature

Class MultidimensionalFloatFV

java.lang.Object

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

org.openimaj.feature.FloatFV

org.openimaj.feature.MultidimensionalFloatFV

All Implemented Interfaces:

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

public class MultidimensionalFloatFV
extends FloatFV
implements Serializable, Cloneable, FeatureVector

Basic float 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
MultidimensionalFloatFV() Construct an empty feature vector
MultidimensionalFloatFV(float[][] values) Construct from 2-dimensional array
MultidimensionalFloatFV(float[][][] values) Construct from 3-dimensional array
MultidimensionalFloatFV(float[] values, int... nbins) Construct from flattened values array and dimensions
MultidimensionalFloatFV(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.
MultidimensionalFloatFV	clone()
double	compare(MultidimensionalFloatFV h, FloatFVComparison method) Compare this FV to another with the given method.
float	get(int... coords) Get the element at the given n-dimensional coordinate
float	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
float[]	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(float 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.FloatFV

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

MultidimensionalFloatFV

public MultidimensionalFloatFV()

Construct an empty feature vector

MultidimensionalFloatFV

public MultidimensionalFloatFV(int... nbins)

Construct empty FV with given dimensions

Parameters:

nbins - the number of bins in each dimension

MultidimensionalFloatFV

public MultidimensionalFloatFV(float[] 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

MultidimensionalFloatFV

public MultidimensionalFloatFV(float[][] values)

Construct from 2-dimensional array

Parameters:

values - the 2d array

MultidimensionalFloatFV

public MultidimensionalFloatFV(float[][][] values)

Construct from 3-dimensional array

Parameters:

values - the 3d array

Method Detail

getVector

public float[] getVector()

Get the underlying flat-vector representation

Specified by:

getVector in interface FeatureVector

Overrides:

getVector in class ArrayFeatureVector<float[]>

Returns:

a flat 1d representation of the feature

get

public float get(int x)

Get the element at the given flat index

Overrides:

get in class FloatFV

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(float value,
                int... coords)

Set the the element at the given n-dimensional coordinate

Parameters:

value - the value to set

coords - the coordinates

get

public float 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 MultidimensionalFloatFV clone()

Overrides:

clone in class FloatFV

toString

public String toString()

Overrides:

toString in class FloatFV

asDoubleFV

public MultidimensionalDoubleFV asDoubleFV()

Convert the FV to a DoubleFV representation

Specified by:

asDoubleFV in interface FeatureVector

Overrides:

asDoubleFV in class FloatFV

Returns:

the DoubleFV representation

compare

public double compare(MultidimensionalFloatFV h,
                      FloatFVComparison 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 FloatFV

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 FloatFV

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 FloatFV

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 FloatFV

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 FloatFV

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 FloatFV

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