PUBLIC

NumPerfCrossValBC::NumPerfCrossValBC(UIntT,UIntT) NumPerfCrossValBC::NumPerfCrossValBC(istream &) NumPerfCrossValBC::NumPerfCrossValBC(const NumPerfCrossValBC &) NumPerfCrossValBC::Copy(void) const NumPerfCrossValBC::PMC(const NumVLDataSetC &,NumClassifySupervisedC &,const NumErrorC &) const NumPerfCrossValBC::GetInfo(void) const NumPerfCrossValBC::Save(ostream &) const NumPerformanceBC::Copy(void) const NumPerformanceBC::PMC(const NumVLDataSetC &,NumClassifySupervisedC &,const NumErrorC &) const NumPerformanceBC::GetInfo(void) const NumPerformanceBC::GetName(void) const NumPerformanceBC::Save(ostream &) const BodyRefCounterVC::Copy(void) const BodyRefCounterVC::operator==(const BodyRefCounterVC &) const BodyRefCounterVC::operator!=(const BodyRefCounterVC &) const BodyRefCounterVC::Save(ostream &) const BodyRefCounterC::AddReference(void) BodyRefCounterC::RemoveReference(void) BodyRefCounterC::SetConst(void) const BodyRefCounterC::SetConst(void) BodyRefCounterC::IsConst(void) const BodyRefCounterC::IsNotConst(void) const BodyRefCounterC::ToBeDeleted(void) const BodyRefCounterC::ToBeDeletedRemoveIgnoreNoRemove(void) BodyRefCounterC::ToBeDeletedRemove(void) BodyRefCounterC::BodyMightBeDeleted(void) const BodyRefCounterC::IsCountZero(void) const BodyRefCounterC::BRCPtrCanDeleteObject(void) const BodyRefCounterC::Count(void) const BodyRefCounterC::operator=(const BodyRefCounterC &) BodyRefCounterC::IsValidObject(void) const BodyRefCounterC::UserBitTest(IntT) const BodyRefCounterC::UserBitSet(IntT,BooleanT) BodyRefCounterC::UserBitZero(IntT) BodyRefCounterC::ReportBRCError(char *) BodyRefCounterC::Hash(void) const BodyRefCounterC::SetUndeletable(void) BodyRefCounterC::ReportInvalidObject(char *) const RefCounterBaseC::Label(void) const

NumPerfCrossValBC
Performance evaluation using data Cross Validation method.
include	"amma/Num/NumPerfCrossValB.hh"
User Level:	Default
Library:	NumPerformance
Example:	testNumPerformance.cc
Section:	Pattern Recognition.Performance Evaluation.Implementation
In Scope:	std

Comments:
This is the implementation class of hold out method of classification performance evaluation for the PatternRec toolbox. The NumPerfCrossValC handle class should be used.

public NumPerformanceBC

UIntT _numSamples;

Amount of data set to use for testing

UIntT _offsetIncr;

Test data offset increment

NumPerfCrossValBC(UIntT numSamples,UIntT offsetIncr)

Default constructor

numSamples	amount of data set to use for testing at each iteration
offsetIncr	test set offset increment

The test set offset increment is used to distinguish between normal cross validation and rotation cross validation. In the normal case it is unity and for rotation it is equal to numSamples so that nonoverlapping test sets are extracted.

NumPerfCrossValBC(istream & in)

Constructs from stream

NumPerfCrossValBC(const NumPerfCrossValBC & oth)

Copy constructor.

BodyRefCounterVC & Copy() const

Makes a deep copy and is virtual

RealT PMC(const NumVLDataSetC & data,NumClassifySupervisedC & classifier,const NumErrorC & error) const

Determines probability of misclassification

data	data set containing feature vectors and correct labels
classifier	classifier to test
error	error counting method

Determines the average probability of misclassification of the given classifier using the supplied error counting method. Cross validation is used to split the sample data into test and training data by taking all n possible sets of consecutive test data of size numSamples and using the remainder for training. The estimates of PMC obtained for each test set are averaged together to give a final estimate.

const StringC GetInfo() const

Prints derived class information

BooleanT Save(ostream & out) const

Writes object to stream, can be loaded using constructor

BodyRefCounterVC & Copy() const

Makes a deep copy and is virtual
As the copy constructor but is virtual so can be called from a base class reference.

RealT PMC(const NumVLDataSetC & data,NumClassifySupervisedC & classifier,const NumErrorC & error) const

Determines probability of misclassification

data	data set containing feature vectors and correct labels
classifier	classifier to test
error	error counting method

A derived class must provide a method for splitting the data into test and training data and then determining the average probability of misclassification of the given classifier using the supplied error counting method.

const StringC GetInfo() const

Prints derived class information

const StringC GetName() const

Derived class type

BooleanT Save(ostream & out) const

Writes object to stream, can be loaded using constructor

BodyRefCounterVC & Copy() const

Creat a copy of this object.

BooleanT operator==(const BodyRefCounterVC & oth) const

Compair identitys.

BooleanT operator!=(const BodyRefCounterVC & oth) const

Compair identitys.

BooleanT Save(ostream & out) const

Save to ostream.

void AddReference()

Another reference to the object has been created.

void RemoveReference()

One reference to the object was deleted.
Locking scheme -------------- The object is possible to lock (to make constant). The scheme assumes that the object is created, it can be locked, after that it can only be destroyed. The locked object cannot be unlocked. This locking scheme is very useful during debugging, using assert() function, when it is necassary to check that object is treated as constant and the constancy is not violated by any casting or passing through the copy constructor of shared objects.

void SetConst(void) const

This locks the object.
Often objects you wish to lock are already const.

void SetConst(void)

This locks the object.

BooleanT IsConst(void) const

Returns TRUE if the object is locked, ie. it is assumed to be constant.

BooleanT IsNotConst(void) const

Returns TRUE if the object is unlocked.
ie. there is no special information if the object is constant or not. Counter state information -------------------------

BooleanT ToBeDeleted() const

Returns TRUE if there is only one reference to the object and the whole object or its reference counting part can be deleted.

BooleanT ToBeDeletedRemoveIgnoreNoRemove()

Decrement refrence by 1 return true if this leaves no refrences to the object.

BooleanT ToBeDeletedRemove()

Decrement refrence by 1 return true if this leaves no refrences to the object. This also checks the NoRemove flag.

BooleanT BodyMightBeDeleted() const

Returns TRUE if the reference counted part of the object can be deleted, ie. flag NOREMOVE is false .

BooleanT IsCountZero() const

Are there any refrences left ?

BooleanT BRCPtrCanDeleteObject() const

Used by BRRCPtrC to establish if an object has ZERO refrences and can be deleted.

IntT Count() const

Returns the current state of the counter, ie. how many references to this object exist.

const BodyRefCounterC & operator=(const BodyRefCounterC & b)

It has not meaning to assign object 'b' to this object because it would destroy a history of the object which is counted. So this is a dummy function.

BooleanT IsValidObject() const

Test if object is valid.
When amma check is disabled this always returns true.

BooleanT UserBitTest(IntT x) const

Test user flag.

void UserBitSet(IntT x,BooleanT setit = TRUE)

Test user flag.

void UserBitZero(IntT x)

Set bit to zero.

void ReportBRCError(char * Msg)

Report error, used in BRCPtrC.

UIntT Hash() const

Hash on address of object.

void SetUndeletable()

Make object undeletable.
Usefull to prevent recursive deleting in graph structures. Only hackers need this function.

void ReportInvalidObject(char * Msg = 0) const

Tell user about validation failure.

LabelT Label() const

Returns the label of this reference counter.
The member function is useful mainly to recognize objects during debugging. The value of the label is uniquely defined pointer.