File partition_single.hpp¶

class SinglePartition : public IPartition ¶

#include <partition_single.hpp>

An implementation of the class IPartition that provides random access to the indices of elements that are included in a single set.

Public Types

using const_iterator = IndexIterator ¶: An iterator that provides read-only access to the indices of the elements that are included in the partition.

Public Functions

SinglePartition(uint32 numElements)¶

Parameters:: numElements – The number of elements to be included in the partition. Must be at least 1

const_iterator cbegin() const¶

Returns a const_iterator to the beginning of the indices that are contained in the partition.

Returns:: A const_iterator to the beginning

const_iterator cend() const¶

Returns a const_iterator to the end of the indices that are contained in the partition.

Returns:: A const_iterator to the end

uint32 getNumElements() const¶

Returns the number of elements that are contained in the partition.

Returns:: The number of elements

virtual std::unique_ptr<IStoppingCriterion> createStoppingCriterion(const IStoppingCriterionFactory &factory) override¶

Creates and returns a new instance of the class IStoppingCriterion, based on the type of this partition.

Parameters:: factory – A reference to an object of type IStoppingCriterionFactory that should be used to create the instance
Returns:: An unique pointer to an object of type IStoppingCriterion that has been created

virtual std::unique_ptr<IInstanceSampling> createInstanceSampling(const IClassificationInstanceSamplingFactory &factory, const IRowWiseLabelMatrix &labelMatrix, IStatistics &statistics, const EqualWeightVector &exampleWeights) override¶

Creates and returns a new instance of the class IInstanceSampling that can be used in classification problems, based on the type of this partition.

Parameters:

factory – A reference to an object of type IClassificationInstanceSamplingFactory that should be used to create the instance
labelMatrix – A reference to an object of type IRowWiseLabelMatrix that provides row-wise access to the labels of individual training examples
statistics – A reference to an object of type IStatistics that provides access to the statistics which serve as a basis for learning rules
exampleWeights – A reference to an object of type EqualWeightVector that provides access to the weights of individual training examples

Returns:

An unique pointer to an object of type IInstanceSampling that has been created

Creates and returns a new instance of the class IInstanceSampling that can be used in classification problems, based on the type of this partition.

Parameters:

factory – A reference to an object of type IClassificationInstanceSamplingFactory that should be used to create the instance
labelMatrix – A reference to an object of type IRowWiseLabelMatrix that provides row-wise access to the labels of individual training examples
statistics – A reference to an object of type IStatistics that provides access to the statistics which serve as a basis for learning rules
exampleWeights – A reference to an object of type DenseWeightVector<float32> that provides access to the weights of individual training examples

Returns:

An unique pointer to an object of type IInstanceSampling that has been created

virtual std::unique_ptr<IInstanceSampling> createInstanceSampling(const IRegressionInstanceSamplingFactory &factory, const IRowWiseRegressionMatrix &regressionMatrix, IStatistics &statistics, const EqualWeightVector &exampleWeights) override¶

Creates and returns a new instance of the class IInstanceSampling that can be used in regression problems, based on the type of this partition.

Parameters:

factory – A reference to an object of type IRegressionInstanceSamplingFactory that should be used to create the instance
regressionMatrix – A reference to an object of type IRowWiseRegressionMatrix that provides row-wise access to the regression scores of individual training examples
statistics – A reference to an object of type IStatistics that provides access to the statistics which serve as a basis for learning rules
exampleWeights – A reference to an object of type EqualWeightVector that provides access to the weights of individual training examples

Returns:

An unique pointer to an object of type IInstanceSampling that has been created

Creates and returns a new instance of the class IInstanceSampling that can be used in regression problems, based on the type of this partition.

Parameters:

factory – A reference to an object of type IRegressionInstanceSamplingFactory that should be used to create the instance
regressionMatrix – A reference to an object of type IRowWiseRegressionMatrix that provides row-wise access to the regression scores of individual training examples
statistics – A reference to an object of type IStatistics that provides access to the statistics which serve as a basis for learning rules
exampleWeights – A reference to an object of type DenseWeightVector<float64> that provides access to the weights of individual training examples

Returns:

An unique pointer to an object of type IInstanceSampling that has been created

virtual Quality evaluateOutOfSample(const IFeatureSubspace &featureSubspace, const CoverageMask &coverageMask, const IPrediction &head) override¶

Calculates and returns a numerical score that assesses the quality of a rule’s prediction for all examples that do not belong to the current sample and are marked as covered according to a given object of type CoverageMask.

Parameters:

featureSubspace – A reference to an object of type IFeatureSubspace that should be used to evaluate the prediction
coverageMask – A reference to an object of type CoverageMask that keeps track of the examples that are covered by the rule
head – A reference to an object of type IPrediction that stores the scores that are predicted by the rule

Returns:

An object of type Quality that stores the calculated quality

virtual void recalculatePrediction(const IFeatureSubspace &featureSubspace, const CoverageMask &coverageMask, std::unique_ptr<IEvaluatedPrediction> &headPtr) override¶

Recalculates and updates a rule’s prediction based on all examples in the training set that are marked as covered according to a given object of type CoverageMask.

Parameters:

featureSubspace – A reference to an object of type IFeatureSubspace that should be used to recalculate the prediction
coverageMask – A reference to an object of type CoverageMask that keeps track of the examples that are covered by the rule
headPtr – A reference to an unique pointer that stores an object of type IEvaluatedPrediction to be updated

virtual std::unique_ptr<IMarginalProbabilityCalibrationModel> fitMarginalProbabilityCalibrationModel(const IMarginalProbabilityCalibrator &probabilityCalibrator, const IRowWiseLabelMatrix &labelMatrix, const IStatistics &statistics) override¶

Fits and returns a model for the calibration of marginal probabilities, based on the type of this partition.

Parameters:

probabilityCalibrator – A reference to an object of type IMarginalProbabilityCalibrator that should be used to fit the calibration model
labelMatrix – A reference to an object of type IRowWiseLabelMatrix that provides row-wise access to the labels of the training examples
statistics – A reference to an object of type IStatistics that provides access to statistics about the quality of predictions for training examples

Returns:

An unique pointer to an object of type IMarginalProbabilityCalibrationModel that has been fit

virtual std::unique_ptr<IJointProbabilityCalibrationModel> fitJointProbabilityCalibrationModel(const IJointProbabilityCalibrator &probabilityCalibrator, const IRowWiseLabelMatrix &labelMatrix, const IStatistics &statistics) override¶

Fits and returns a model for the calibration of joint probabilities, based on the type of this partition.

Parameters:

probabilityCalibrator – A reference to an object of type IJointProbabilityCalibrator that should be used to fit the calibration model
labelMatrix – A reference to an object of type IRowWiseLabelMatrix that provides row-wise access to the labels of the training examples
statistics – A reference to an object of type IStatistics that provides access to statistics about the quality of predictions for training examples

Returns:

An unique pointer to an object of type IJointProbabilityCalibrationModel that has been fit

Private Members

const uint32 numElements_¶