deepcave.plugins.hyperparameter.pdp

# PartialDependencies

This module provides utilities for generating Partial Dependency Plots (PDPs).

Provided utilities include getting input and output layout (filtered or non-filtered), processing the data and loading the outputs.

## Classes

  • PartialDependencies: Generate a Partial Dependency Plot (PDP).

## Constants

GRID_POINTS_PER_AXIS : int SAMPLES_PER_HP : int MAX_SAMPLES : int MAX_SHOWN_SAMPLES : int

Classes

PartialDependencies()

Generate Partial Dependency Plots (PDP).
class deepcave.plugins.hyperparameter.pdp.PartialDependencies[source]

Bases: StaticPlugin

Generate Partial Dependency Plots (PDP).

Provided utilities include getting input and output layout (filtered or non-filtered), processing the data and loading the outputs.

static get_filter_layout(register)[source]

Get the layout for the filter block.

Parameters:

register (Callable) – Method to register (user) variables. The register_input function is located in the Plugin superclass.

Returns:

The layout for the filter block.

Return type:

List[Any]

static get_input_layout(register)[source]

Get the layout for the input block.

Parameters:

register (Callable) – Method to register (user) variables. The register_input function is located in the Plugin superclass.

Returns:

The layout for the input block.

Return type:

List[dbc.Row]

static get_output_layout(register)[source]

Get the layout for the output block.

Parameters:

register (Callable) – Method to register outputs. The register_input function is located in the Plugin superclass.

Returns:

Layout for the output block.

Return type:

dcc.Graph

static get_pdp_figure(run, inputs, outputs, show_confidence, show_ice, title=None, fontsize=None)[source]

Create a figure of the Partial Dependency Plot (PDP).

Parameters:

  • run – The selected run.

  • inputs – Input and filter values from the user.

  • outputs – Raw output from the run.

  • show_confidence – Whether to show confidence in the plot.

  • show_ice – Whether to show ice curves in the plot.

  • title – Title of the plot.

  • fontsize – Fontsize of the plot.

Returns:

The figure of the Partial Dependency Plot (PDP).

Return type:

go.Figure

load_dependency_inputs(run, previous_inputs, inputs)[source]

Work like ‘load_inputs’ but called after inputs have changed.

Note

Only the changes have to be returned. The returned dictionary will be merged with the inputs.

Parameters:

  • run – The selected run.

  • inputs – Current content of the inputs.

  • previous_inputs – Previous content of the inputs. Not used in this specific function.

Returns:

Dictionary with the changes.

Return type:

Dict[str, Any]

load_inputs()[source]

Load the content for the defined inputs in ‘get_input_layout’ and ‘get_filter_layout’.

This method is necessary to pre-load contents for the inputs. If the plugin is called for the first time, or there are no results in the cache, the plugin gets its content from this method.

Returns:

Content to be filled.

Return type:

Dict[str, Dict[str, Any]]

static load_outputs(run, inputs, outputs)[source]

Read the raw data and prepare it for the layout.

Note

The passed inputs are cleaned and therefore differ compared to ‘load_inputs’ or ‘load_dependency_inputs’. Please see ‘_clean_inputs’ for more information.

Parameters:

  • run – The selected run.

  • inputs – Input and filter values from the user.

  • outputs – Raw output from the run.

Returns:

The figure of the Partial Dependency Plot (PDP).

Return type:

go.Figure

static process(run, inputs)[source]

Return raw data based on a run and the input data.

Warning

The returned data must be JSON serializable.

Note

The passed inputs are cleaned and therefore differ compared to ‘load_inputs’ or ‘load_dependency_inputs’. Please see ‘_clean_inputs’ for more information.

Parameters:

  • run – The run to process.

  • inputs – The input data.

Returns:

A serialized dictionary.

Return type:

Dict[str, Any]

Raises:

RuntimeError – If the objective is None.

previous

deepcave.plugins.hyperparameter.parallel_coordinates

next

deepcave.plugins.hyperparameter.symbolic_explanations