plot_parallel_coordinate

method plot_parallel_coordinate(models=None, params=None, metric=0, title=None, legend=None, figsize=None, filename=None, display=True)[source]

Plot high-dimensional parameter relationships in a study.

Every line of the plot represents one trial. This plot is only available for models that ran hyperparameter tuning.

Parameters

models: int, str, Model or None, default=None

Model to plot. If None, all models are selected. Note that leaving the default option could raise an exception if there are multiple models. To avoid this, call the plot directly from a model, e.g. atom.lr.plot_parallel_coordinate().

params: str, slice, sequence or None, default=None

Hyperparameters to plot. Use a sequence or add + between options to select more than one. If None, all the model's hyperparameters are selected.

metric: int or str, default=0

Metric to plot (only for multi-metric runs).

title: str, dict or None, default=None

Title for the plot.

If None, no title is shown.
If str, text for the title.
If dict, title configuration.

legend: str, dict or None, default=None

Does nothing. Implemented for continuity of the API.

figsize: tuple or None, default=None

Figure's size in pixels, format as (x, y). If None, it adapts the size to the number of hyperparameters shown.

filename: str or None, default=None

Save the plot using this name. Use "auto" for automatic naming. The type of the file depends on the provided name (.html, .png, .pdf, etc...). If filename has no file type, the plot is saved as html. If None, the plot is not saved.

display: bool or None, default=True

Whether to render the plot. If None, it returns the figure.

Returns

go.Figure or None

Plot object. Only returned if display=None.

Example

>>> from atom import ATOMClassifier
>>> from sklearn.datasets import load_breast_cancer

>>> X, y = load_breast_cancer(return_X_y=True, as_frame=True)

>>> atom = ATOMClassifier(X, y)
>>> atom.run("RF", n_trials=15)
>>> atom.plot_parallel_coordinate(params=slice(1, 5))