Package viper.descriptors

Provides the classes necessary to read comparable Descriptors in from a file.

See:
Description

Interface Summary

DescriptorData	A set of descriptors that can be associated with multiple source media files.
DescriptorList	A DescriptorList contains all Descriptors associated with a given file.

Class Summary

CanonicalFileDescriptor	This class holds a FILE Information descriptor and can perform some standard operations.
Converter	Class for converting from old .gtf format to new XML format.
DescAggregate	Acts as a composition of Descriptors.
DescHolder	Implements the DescriptorData interface for the old data file format, as well as the XML format.
DescPrototype	The DescPrototype is a descriptor object that does not contain data and supports
Descriptor	This class represents a Descriptor of a given visual element in a video file.
DescriptorConfigs	A collection of Descriptor Objects that supports various operations on them, such as comparison between to DescVector, collection of statistics, reading and printing from files, and various others.
DescSingle	This class represents a Descriptor of a given visual element in a video file.
DescVector	A collection of Descriptor Objects that supports various operations on them, such as comparison between to DescVector, collection of statistics, reading and printing from files, and various others.
ImportExport	Methods for importing and exporting to the old .gtf file format.
UnitTest	Testsuite for the geometry descriptors.

Exception Summary

EndOfBlockException	Thrown if there is a data block overrun in the VReader.
ImproperDescriptorException	Indicates a descriptor was attempted to be used that was not defined in the descriptor config section.

Package viper.descriptors Description

Provides the classes necessary to read comparable Descriptors in from a file.

A Descriptor is a description of some action, event, object, state, etc. found in a video file. It can be as simple as a boolean value and as complex as tracking moving text in a bounding box as it changes color. This is acomplished by specifiying Attributes. These objects can then be compared to determine accuracy, or distance.

Distance is defined as a measure of the difference between two things, with certain desireable properties. Theseproperties are:

• Positiveness: If A != B, then dist(A,B)) > 0. If A == B, then dist(A,B) = 0.
• Symmetry: dist(A,B) = dist(B,A)
• Triangle Inequality: dist(A,C) < dist(A,B) + dist(B,C)

The distances between Descriptors are all bounded by 1, which means they are never greater than 1.