org.openimaj.image.feature.dense.gradient.dsift

Class FloatDSIFTKeypoint

java.lang.Object

org.openimaj.math.geometry.point.Point2dImpl

org.openimaj.feature.local.SpatialLocation

org.openimaj.image.feature.dense.gradient.dsift.FloatDSIFTKeypoint

All Implemented Interfaces:

Serializable, Cloneable, FeatureVectorProvider<FloatFV>, LocalFeature<SpatialLocation,FloatFV>, LocalFeatureVectorProvider<SpatialLocation,FloatFV>, Location, LocationProvider<SpatialLocation>, Readable, ReadableASCII, ReadableBinary, ReadWriteable, VariableLength, Writeable, WriteableASCII, WriteableBinary, Coordinate, Point2d

public class FloatDSIFTKeypoint
extends SpatialLocation

Dense SIFT keypoint with a location and float feature vector. Also includes the energy of the feature prior to normalisation in case low-contrast features need removing.

Author:

Jonathon Hare (jsh2@ecs.soton.ac.uk)

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
Q	descriptor The descriptor (normalised)
float	energy The energy of the descriptor prior to normalisation; computed as the sum of descriptor values divided by the number of sample pixels used to create it (hence comparable across different window sizes).

Fields inherited from class org.openimaj.math.geometry.point.Point2dImpl

x, y

Constructor Summary

Constructors

Constructor and Description
FloatDSIFTKeypoint() Construct with the default feature vector length for SIFT (128).
FloatDSIFTKeypoint(float x, float y, float[] descriptor, float energy) Construct with the given parameters.
FloatDSIFTKeypoint(int length) Construct with the given feature vector length.

Method Summary

Modifier and Type	Method and Description
String	asciiHeader() Header for ascii input.
byte[]	binaryHeader() Header for binary input.
FloatFV	getFeatureVector() Get the FeatureVector associated with this object.
SpatialLocation	getLocation() Get the location associated with this object.
void	readASCII(Scanner in) Read internal state from in.
void	readBinary(DataInput in) Read internal state from in.
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.local.SpatialLocation

clone, getDimensions, getOrdinate

Methods inherited from class org.openimaj.math.geometry.point.Point2dImpl

copy, copyFrom, createRandomPoint, createRandomPoint, equals, fromDoubleArray, getX, getY, hashCode, minus, setOrdinate, setX, setY, transform, translate, translate

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.openimaj.math.geometry.point.Coordinate

setOrdinate

Field Detail

energy

public float energy

The energy of the descriptor prior to normalisation; computed as the sum of descriptor values divided by the number of sample pixels used to create it (hence comparable across different window sizes). Can be used to remove low-contrast descriptors.

descriptor

public Q descriptor

The descriptor (normalised)

Constructor Detail

FloatDSIFTKeypoint

public FloatDSIFTKeypoint()

Construct with the default feature vector length for SIFT (128).

FloatDSIFTKeypoint

public FloatDSIFTKeypoint(int length)

Construct with the given feature vector length.

Parameters:

length - the length of the feature vector

FloatDSIFTKeypoint

public FloatDSIFTKeypoint(float x,
                          float y,
                          float[] descriptor,
                          float energy)

Construct with the given parameters.

Parameters:

x - the x-ordinate of the keypoint

y - the y-ordinate of the keypoint

descriptor - the feature vector of the keypoint

energy - the energy of the keypoint

Method Detail

getFeatureVector

public FloatFV getFeatureVector()

Description copied from interface: FeatureVectorProvider

Get the FeatureVector associated with this object.

Returns:

the feature vector.

toString

public String toString()

Overrides:

toString in class Point2dImpl

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 SpatialLocation

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 SpatialLocation

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 SpatialLocation

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 SpatialLocation

Parameters:

in - source to read from.

Throws:

IOException - an error reading input

getLocation

public SpatialLocation getLocation()

Description copied from interface: LocationProvider

Get the location associated with this object.

Specified by:

getLocation in interface LocationProvider<SpatialLocation>

Returns:

the location.

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 SpatialLocation

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 SpatialLocation

Returns:

header