lti::geometricFeatures::parameters Class Reference

the parameters for the class geometricFeatures More...

#include <ltiGeometricFeatures.h>

Inheritance diagram for lti::geometricFeatures::parameters:

[legend]

Collaboration diagram for lti::geometricFeatures::parameters:

[legend]

List of all members.

Public Types
enum	eBoundaryDefinition { CentralBoundary, OuterBoundary, Approximation }
Public Member Functions
	parameters ()
	parameters (const parameters &other)
	~parameters ()
const char *	getTypeName () const
parameters &	copy (const parameters &other)
virtual functor::parameters *	clone () const
virtual bool	write (ioHandler &handler, const bool complete=true) const
virtual bool	read (ioHandler &handler, const bool complete=true)
Public Attributes
bool	calcFeatureGroup1
bool	calcFeatureGroup2
bool	calcFeatureGroup3
bool	calcFeatureGroup4
eBoundaryDefinition	boundaryDefinition

Detailed Description

the parameters for the class geometricFeatures

Member Enumeration Documentation

enum lti::geometricFeatures::parameters::eBoundaryDefinition

Boundary definition.

The boundary definition to be used (default: CentralBoundary).

Enumerator:

CentralBoundary

The central boundary is the line drawn from the center of each borderPoint to the center of the following borderPoint, and from the last one's center to the first one's (with sub-pixel accuracy, meaning that the length is the same as it were in continuous space).

A single pixel has a central boundary length of 0 and an area of 0. A tiny rectangle with upper left corner at (0,0) and bottom right corner at (1,1) has an outer boundary length of 4 and an area of 1.

Note: We define that objects with an area of 0 have the same COG as by the OuterBoundary definition.

Disadvantages: Very large objects may lead to numerical problems in feature group 2 (and thus above).

Formulas taken from: Carsten Steger: On the Calculation of Arbitrary Moments of Polygons; Technical Report FGBV-96-05, Forschungsgruppe Bildverstehen (FG BV), Informatik IX, Technische Universit�t M�nchen, October 1996

http://www9.informatik.tu-muenchen.de/people/steger/publications.html

OuterBoundary

The outer boundary delimits the borderPoints completely, ie a single pixel has an outer boundary length of 4 and an area of 1.

A tiny rectangle with upper left corner at (0,0) and bottom right corner at (1,1) has an outer boundary length of 8 and an area of 4. I.e. the boundary is considered to be part of the object (completely).

Disadvantages: By this definition, a square and a circle with equal side length resp. diameter have the same boundary length if the square is parallel to the coordinate axes. This contradicts intuition and renders features like compactness rather meaningless. Also, an object's boundary length is very susceptible to rotation.

Approximation

"Approximation" uses CentralBoundary for the calculation of feature group 4 and the bordersize, and OuterBoundary for all others.

Disadvantages: This definition is mathematically inconsistent, e.g. especially very small objects may have a compactness greater than 1.

Constructor & Destructor Documentation

lti::geometricFeatures::parameters::parameters ( )

default constructor

Reimplemented from lti::globalFeatureExtractor::parameters.

lti::geometricFeatures::parameters::parameters ( const parameters & other )

copy constructor

Parameters:

other

the parameters object to be copied

Reimplemented from lti::globalFeatureExtractor::parameters.

lti::geometricFeatures::parameters::~parameters ( ) [virtual]

destructor

Reimplemented from lti::globalFeatureExtractor::parameters.

Member Function Documentation

virtual functor::parameters* lti::geometricFeatures::parameters::clone ( ) const [virtual]

returns a pointer to a clone of the parameters

Reimplemented from lti::globalFeatureExtractor::parameters.

parameters& lti::geometricFeatures::parameters::copy ( const parameters & other )

copy the contents of a parameters object

Parameters:

other

the parameters object to be copied

Returns:: a reference to this parameters object

Reimplemented from lti::globalFeatureExtractor::parameters.

const char* lti::geometricFeatures::parameters::getTypeName ( ) const [virtual]

returns name of this type

Reimplemented from lti::globalFeatureExtractor::parameters.

virtual bool lti::geometricFeatures::parameters::read	(	ioHandler &	handler,
		const bool	complete = `true`
	)			`[virtual]`

read the parameters from the given ioHandler

Parameters:

	handler	the ioHandler to be used
	complete	if true (the default) the enclosing begin/end will be also written, otherwise only the data block will be written.

Returns:: true if write was successful

Reimplemented from lti::functor::parameters.

virtual bool lti::geometricFeatures::parameters::write	(	ioHandler &	handler,
		const bool	complete = `true`
	)			const `[virtual]`

write the parameters in the given ioHandler

Parameters:

	handler	the ioHandler to be used
	complete	if true (the default) the enclosing begin/end will be also written, otherwise only the data block will be written.