SORD#

class mlquantify.mixture.SORD(learner=None, strategy='ovr')[source]#

Sample Ordinal Distance (SORD) quantification method.

Estimates prevalence by minimizing the weighted sum of absolute score differences between test data and training classes. The method creates weighted score vectors for positive, negative, and test samples, sorts them, and computes a cumulative absolute difference as the distance measure.

Parameters:
learnerestimator, optional

Base probabilistic classifier.

References

[2] Esuli et al. (2023). Learning to Quantify. Springer.

aggregate(*args)[source]#

Aggregate binary predictions to obtain multiclass prevalence estimates.

best_mixture(predictions, pos_scores, neg_scores)[source]#

Determine the best mixture parameters for the given data.

fit(X, y)[source]#

Fit the quantifier under a binary decomposition strategy.

get_best_distance(*args, **kwargs)[source]#

Get the best distance value from the mixture fitting process.

Notes

If the quantifier has not been fitted yet, it will fit the model for getting the best distance.

classmethod get_distance(dist_train, dist_test, measure='hellinger')[source]#

Compute distance between two distributions.

get_metadata_routing()[source]#

Get metadata routing of this object.

Please check User Guide on how the routing mechanism works.

Returns:
routingMetadataRequest

A MetadataRequest encapsulating routing information.

get_params(deep=True)[source]#

Get parameters for this estimator.

Parameters:
deepbool, default=True

If True, will return the parameters for this estimator and contained subobjects that are estimators.

Returns:
paramsdict

Parameter names mapped to their values.

predict(X)[source]#

Predict class prevalences using the trained binary quantifiers.

save_quantifier(path: str | None = None) None[source]#

Save the quantifier instance to a file.

set_params(**params)[source]#

Set the parameters of this estimator.

The method works on simple estimators as well as on nested objects (such as Pipeline). The latter have parameters of the form <component>__<parameter> so that it’s possible to update each component of a nested object.

Parameters:
**paramsdict

Estimator parameters.

Returns:
selfestimator instance

Estimator instance.