skactiveml.visualization.plot_utilities#
- skactiveml.visualization.plot_utilities(qs, X, y, candidates=None, **kwargs)[source]#
Plot the utility for the given single-annotator query strategy.
- Parameters
- qsskactiveml.base.SingleAnnotatorPoolQueryStrategy
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 qs.missing_label).
- candidatesNone or array-like of shape (n_candidates), dtype=int or array-like of shape (n_candidates, n_features), 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, *), the candidate samples are directly given in candidates (not necessarily contained in X). This is not supported by all query strategies.
- Returns
- axmatplotlib.axes.Axes
The axis on which the utilities were plotted.
- Other Parameters
- replace_nannumeric or None, default=0.0
Only used if plotting with mesh samples is not possible. If numeric, the utility of labeled samples will be plotted with value replace_nan. If None, these samples will be ignored.
- ignore_undefined_query_paramsbool, 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]], 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.
- axmatplotlib.axes.Axes, default=None
The axis on which the utility is plotted. Only if y.ndim = 1 (single annotator).
- resint, default=21
The resolution of the plot.
- contour_dictdict, default=None
Additional parameters for the utility contour.
- **kwargs
Remaining keyword arguments are passed the query function of the query strategy.
Examples using skactiveml.visualization.plot_utilities#
Query-by-Committee (QBC) with Kullback-Leibler Divergence
