org.openimaj.feature

Class MultidimensionalLongFV

java.lang.Object

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

org.openimaj.feature.LongFV

org.openimaj.feature.MultidimensionalLongFV

All Implemented Interfaces:

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

public class MultidimensionalLongFV
extends LongFV
implements Serializable, Cloneable, FeatureVector

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

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

MultidimensionalLongFV

public MultidimensionalLongFV()

Construct an empty feature vector

MultidimensionalLongFV

public MultidimensionalLongFV(int... nbins)

Construct empty FV with given dimensions

Parameters:

nbins - the number of bins in each dimension

MultidimensionalLongFV

public MultidimensionalLongFV(long[] 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

MultidimensionalLongFV

public MultidimensionalLongFV(long[][] values)

Construct from 2-dimensional array

Parameters:

values - the 2d array

MultidimensionalLongFV

public MultidimensionalLongFV(long[][][] values)

Construct from 3-dimensional array

Parameters:

values - the 3d array

Method Detail

getVector

public long[] getVector()

Get the underlying flat-vector representation

Specified by:

getVector in interface FeatureVector

Overrides:

getVector in class ArrayFeatureVector<long[]>

Returns:

a flat 1d representation of the feature

get

public long get(int x)

Get the element at the given flat index

Overrides:

get in class LongFV

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

Set the the element at the given n-dimensional coordinate

Parameters:

value - the value to set

coords - the coordinates

get

public long 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 MultidimensionalLongFV clone()

Overrides:

clone in class LongFV

toString

public String toString()

Overrides:

toString in class LongFV

asDoubleFV

public MultidimensionalDoubleFV asDoubleFV()

Convert the FV to a DoubleFV representation

Specified by:

asDoubleFV in interface FeatureVector

Overrides:

asDoubleFV in class LongFV

Returns:

the DoubleFV representation

compare

public double compare(MultidimensionalLongFV h,
                      LongFVComparison 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 LongFV

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 LongFV

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 LongFV

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 LongFV

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 LongFV

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 LongFV

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