skactiveml.visualization.plot_annotator_utilities#

skactiveml.visualization.plot_annotator_utilities(qs, X, y, candidates=None, **kwargs)[source]#

Plot the utility for the given query strategy.

Parameters
qsskactiveml.base.QueryStrategy

The query strategy for which the utility is plotted.

Xarray-like of shape (n_samples, n_features)

Training data set, usually complete, i.e. including the labeled and unlabeled samples.

yarray-like of shape (n_samples, ) or (n_samples, n_annotators)

Labels of the training data set (possibly including unlabeled ones indicated by self.MISSING_LABEL).

candidatesNone or array-like of shape (n_candidates,), dtype=int or

array-like of shape (n_candidates, n_features), optional (default=None) If candidates is None, the unlabeled samples from (X,y) are considered as candidates. If candidates is of shape (n_candidates,) and of type int, candidates is considered as the indices of the samples in (X,y). If candidates is of shape (n_candidates, n_features), the candidates are directly given in candidates (not necessarily contained in X). This is not supported by all query strategies.

Returns
axesarray-like of shape (n_annotators_to_plot,)

The axes on which the utilities were plotted.

Other Parameters
replace_nannumeric or None, optional (default=0.0)

Only used if plotting with mesh instances is not possible. If numeric, the utility of labeled instances will be plotted with value replace_nan. If None, these samples will be ignored.

ignore_undefined_query_paramsbool, optional (default=False)

If True, query parameters that are not defined in the query function are ignored and will not raise an exception.

feature_boundarray-like of shape [[xmin, ymin], [xmax, ymax]], optional
(default=None)

Determines the area in which the boundary is plotted. If candidates is not given, bound must not be None. Otherwise, the bound is determined based on the data.

axesarray-like of matplotlib.axes.Axes, optional (default=None)

The axes on which the utilities for the annotators are plotted. Only supported for y.ndim = 2 (multi annotator).

resint, optional (default=21)

The resolution of the plot.

contour_dictdict, optional (default=None)

Additional parameters for the utility contour.

plot_annotatorsNone or array-like of shape (n_annotators_to_plot,),
optional (default=None)

Contains the indices of the annotators to be plotted. If it is None, all annotators are plotted. Only supported for y.ndim = 2

(multi annotator).

**kwargs

Remaining keyword arguments are passed the query function of the query strategy.