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 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
- axmatplotlib.axes.Axes
The axis 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.
- axmatplotlib.axes.Axes, optional (default=None)
The axis on which the utility is plotted. Only if y.ndim = 1 (single annotator).
- resint, optional (default=21)
The resolution of the plot.
- contour_dictdict, optional (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
