cave.analyzer.parameter_importance.fanova module

class cave.analyzer.parameter_importance.fanova.Fanova(runscontainer, marginal_threshold=0.05)[source]

Bases: cave.analyzer.parameter_importance.base_parameter_importance.BaseParameterImportance

fANOVA (functional analysis of variance) computes the fraction of the variance in the cost space explained by changing a parameter by marginalizing over all other parameters, for each parameter (or for pairs of parameters). Parameters with high importance scores will have a large impact on the performance. To this end, a random forest is trained as an empirical performance model on the available empirical data from the available runhistories.

Wrapper for parameter_importance to save the importance-object/ extract the results. We want to show the top X most important parameter-fanova-plots.

Parameters

  • runscontainer (RunsContainer) – contains all important information about the configurator runs

  • marginal_threshold (float) – parameter/s must be at least this important to be mentioned

classmethod check_for_bokeh(d)

Check if there is bokeh-plots in the output of this analyzer by checking the result-dictionary for the bokeh keyword.

get_html(d=None, tooltip=None)

General reports in html-format, to be easily integrated in html-code. WORKS ALSO FOR BOKEH-OUTPUT.

Parameters

  • d (Dictionary) – a dictionary that will be later turned into a website

  • tooltip (string) – tooltip to be displayed in report. optional, will overwrite the docstrings that are used by default.

Returns

script, div – header and body part of html-code

Return type

str, str

get_jupyter()[source]

Depending on analysis, this creates jupyter-notebook compatible output.

get_name()[source]
parameter_importance(modus)
modus: str

modus for parameter importance, from [forward-selection, ablation, fanova, lpi]

plot_bokeh()

This function should recreate the bokeh-plot from scratch with as little overhead as possible. This is needed to show the bokeh plot in jupyter AND save it to the webpage. The bokeh plot needs to be recreated to be displayed in different outputs for reasons beyond out control. So save all analysis results in the class and simply redo the plotting with this function. This function needs to be called if bokeh-plots are to be displayed in notebook AND saved to html-result.

plot_whiskers()
postprocess(pimp, output_dir)[source]