fitbenchmarking.core.results_output module

Functions that create the tables, support pages, figures, and indexes.

fitbenchmarking.core.results_output.create_directories(options, group_name)

Create the directory structure ready to store the results

Parameters
Returns

paths to the top level group results, support pages, and figures directories

Return type

(str, str, str)

fitbenchmarking.core.results_output.create_plots(options, results, best_results, figures_dir)

Create a plot for each result and store in the figures directory

Parameters

  • options (fitbenchmarking.utils.options.Options) – The options used in the fitting problem and plotting

  • results (list of list of fitbenchmarking.utils.fitbm_result.FittingResult) – results nested array of objects

  • best_results (list[dict[str: fitbenchmarking.utils.fitbm_result.FittingResult]]) – best result for each problem seperated by cost function

  • figures_dir (str) – Path to directory to store the figures in

fitbenchmarking.core.results_output.create_problem_level_index(options, table_names, group_name, group_dir, table_descriptions)

Generates problem level index page.

Parameters

  • options (fitbenchmarking.utils.options.Options) – The options used in the fitting problem and plotting

  • table_names (list) – list of table names

  • group_name (str) – name of the problem group

  • group_dir (str) – Path to the directory where the index should be stored

  • table_descriptions (dict) – dictionary containing descriptions of the tables and the comparison mode

fitbenchmarking.core.results_output.preprocess_data(results: list[FittingResult])

Generate a dictionary of results lists sorted into the correct order with rows and columns as the key and list elements respectively.

This is used to create HTML and txt tables. This is stored in self.sorted_results

Parameters

results (list[fitbenchmarking.utils.fitbm_result.FittingResult]) – The results to process

Returns

The best result grouped by row and category (cost function), The sorted results grouped by row and category

Return type

dict[str, dict[str, utils.fitbm_result.FittingResult]], dict[str, dict[str, list[utils.fitbm_result.FittingResult]]]

fitbenchmarking.core.results_output.save_results(options, results, group_name, failed_problems, unselected_minimizers)

Create all results files and store them. Result files are plots, support pages, tables, and index pages.

Parameters
Params unselected_minimizers

Dictionary containing unselected minimizers based on the algorithm_type option

Returns

Path to directory of group results

Return type

str