fitbenchmarking.utils.options module

This file will handle all interaction with the options configuration file.

class fitbenchmarking.utils.options.Options(file_name=None, additional_options=None)

Bases: object

An options class to store and handle all options for fitbenchmarking

DEFAULTS = {'DASH': {'port': 4000}, 'FITTING': {'algorithm_type': ['all'], 'cost_func_type': ['weighted_nlls'], 'hes_method': ['best_available'], 'jac_method': ['best_available'], 'max_runtime': 600, 'num_runs': 5, 'software': ['scipy', 'scipy_ls']}, 'HESSIAN': {'analytic': ['default'], 'best_available': ['default'], 'default': ['default'], 'numdifftools': ['central'], 'scipy': ['2-point']}, 'JACOBIAN': {'analytic': ['default'], 'best_available': ['default'], 'default': ['default'], 'numdifftools': ['central'], 'scipy': ['2-point']}, 'LOGGING': {'append': False, 'external_output': 'log_only', 'file_name': 'fitbenchmarking.log', 'level': 'INFO'}, 'MINIMIZERS': {'bumps': ['amoeba', 'lm-bumps', 'newton', 'scipy-leastsq'], 'ceres': ['Levenberg_Marquardt', 'Dogleg', 'BFGS', 'LBFGS', 'steepest_descent', 'Fletcher_Reeves', 'Polak_Ribiere', 'Hestenes_Stiefel'], 'dfo': ['dfols'], 'gofit': ['multistart'], 'gradient_free': ['HillClimbingOptimizer', 'RepulsingHillClimbingOptimizer', 'SimulatedAnnealingOptimizer', 'RandomSearchOptimizer', 'RandomRestartHillClimbingOptimizer', 'RandomAnnealingOptimizer', 'ParallelTemperingOptimizer', 'ParticleSwarmOptimizer', 'EvolutionStrategyOptimizer'], 'gsl': ['lmsder', 'lmder', 'nmsimplex', 'nmsimplex2', 'conjugate_pr', 'conjugate_fr', 'vector_bfgs', 'vector_bfgs2', 'steepest_descent'], 'horace': ['lm-lsqr'], 'levmar': ['levmar'], 'lmfit': ['powell', 'cobyla', 'slsqp', 'nelder', 'least_squares', 'leastsq', 'newton', 'tnc', 'lbfgsb', 'bfgs', 'cg', 'ampgo'], 'mantid': ['BFGS', 'Conjugate gradient (Fletcher-Reeves imp.)', 'Conjugate gradient (Polak-Ribiere imp.)', 'Damped GaussNewton', 'Levenberg-Marquardt', 'Levenberg-MarquardtMD', 'Simplex', 'SteepestDescent', 'Trust Region'], 'matlab': ['Nelder-Mead Simplex'], 'matlab_curve': ['Levenberg-Marquardt', 'Trust-Region'], 'matlab_opt': ['levenberg-marquardt', 'trust-region-reflective'], 'matlab_stats': ['Levenberg-Marquardt'], 'minuit': ['migrad', 'simplex'], 'nlopt': ['LN_BOBYQA', 'LN_NEWUOA', 'LN_NEWUOA_BOUND', 'LN_PRAXIS', 'LD_SLSQP', 'LD_VAR2', 'LD_VAR1', 'AUGLAG', 'AUGLAG_EQ', 'LN_NELDERMEAD', 'LN_SBPLX', 'LN_COBYLA', 'LD_CCSAQ', 'LD_MMA', 'LD_TNEWTON_PRECOND_RESTART', 'LD_TNEWTON_PRECOND', 'LD_TNEWTON_RESTART', 'LD_TNEWTON', 'LD_LBFGS'], 'paramonte': ['paraDram_sampler'], 'ralfit': ['gn', 'gn_reg', 'hybrid', 'hybrid_reg', 'newton', 'newton_reg'], 'scipy': ['Nelder-Mead', 'Powell', 'CG', 'BFGS', 'Newton-CG', 'L-BFGS-B', 'TNC', 'SLSQP', 'COBYLA'], 'scipy_go': ['differential_evolution', 'dual_annealing'], 'scipy_leastsq': ['lm-leastsq'], 'scipy_ls': ['lm-scipy', 'trf', 'dogbox'], 'theseus': ['Levenberg_Marquardt', 'Gauss-Newton']}, 'OUTPUT': {'checkpoint_filename': 'checkpoint.json', 'cmap_range': [0.2, 0.8], 'colour_map': 'magma_r', 'colour_ulim': 100, 'comparison_mode': 'both', 'make_plots': True, 'pbar': True, 'results_browser': True, 'results_dir': 'fitbenchmarking_results', 'run_dash': True, 'run_name': '', 'table_type': ['acc', 'runtime', 'compare', 'local_min', 'emissions']}, 'RUNTIME': {'runtime_metric': 'mean'}}

DEFAULT_DASH = {'port': 4000}

DEFAULT_FITTING = {'algorithm_type': ['all'], 'cost_func_type': ['weighted_nlls'], 'hes_method': ['best_available'], 'jac_method': ['best_available'], 'max_runtime': 600, 'num_runs': 5, 'software': ['scipy', 'scipy_ls']}

DEFAULT_HESSIAN = {'analytic': ['default'], 'best_available': ['default'], 'default': ['default'], 'numdifftools': ['central'], 'scipy': ['2-point']}

DEFAULT_JACOBIAN = {'analytic': ['default'], 'best_available': ['default'], 'default': ['default'], 'numdifftools': ['central'], 'scipy': ['2-point']}

DEFAULT_LOGGING = {'append': False, 'external_output': 'log_only', 'file_name': 'fitbenchmarking.log', 'level': 'INFO'}

DEFAULT_MINIMZERS = {'bumps': ['amoeba', 'lm-bumps', 'newton', 'scipy-leastsq'], 'ceres': ['Levenberg_Marquardt', 'Dogleg', 'BFGS', 'LBFGS', 'steepest_descent', 'Fletcher_Reeves', 'Polak_Ribiere', 'Hestenes_Stiefel'], 'dfo': ['dfols'], 'gofit': ['multistart'], 'gradient_free': ['HillClimbingOptimizer', 'RepulsingHillClimbingOptimizer', 'SimulatedAnnealingOptimizer', 'RandomSearchOptimizer', 'RandomRestartHillClimbingOptimizer', 'RandomAnnealingOptimizer', 'ParallelTemperingOptimizer', 'ParticleSwarmOptimizer', 'EvolutionStrategyOptimizer'], 'gsl': ['lmsder', 'lmder', 'nmsimplex', 'nmsimplex2', 'conjugate_pr', 'conjugate_fr', 'vector_bfgs', 'vector_bfgs2', 'steepest_descent'], 'horace': ['lm-lsqr'], 'levmar': ['levmar'], 'lmfit': ['powell', 'cobyla', 'slsqp', 'nelder', 'least_squares', 'leastsq', 'newton', 'tnc', 'lbfgsb', 'bfgs', 'cg', 'ampgo'], 'mantid': ['BFGS', 'Conjugate gradient (Fletcher-Reeves imp.)', 'Conjugate gradient (Polak-Ribiere imp.)', 'Damped GaussNewton', 'Levenberg-Marquardt', 'Levenberg-MarquardtMD', 'Simplex', 'SteepestDescent', 'Trust Region'], 'matlab': ['Nelder-Mead Simplex'], 'matlab_curve': ['Levenberg-Marquardt', 'Trust-Region'], 'matlab_opt': ['levenberg-marquardt', 'trust-region-reflective'], 'matlab_stats': ['Levenberg-Marquardt'], 'minuit': ['migrad', 'simplex'], 'nlopt': ['LN_BOBYQA', 'LN_NEWUOA', 'LN_NEWUOA_BOUND', 'LN_PRAXIS', 'LD_SLSQP', 'LD_VAR2', 'LD_VAR1', 'AUGLAG', 'AUGLAG_EQ', 'LN_NELDERMEAD', 'LN_SBPLX', 'LN_COBYLA', 'LD_CCSAQ', 'LD_MMA', 'LD_TNEWTON_PRECOND_RESTART', 'LD_TNEWTON_PRECOND', 'LD_TNEWTON_RESTART', 'LD_TNEWTON', 'LD_LBFGS'], 'paramonte': ['paraDram_sampler'], 'ralfit': ['gn', 'gn_reg', 'hybrid', 'hybrid_reg', 'newton', 'newton_reg'], 'scipy': ['Nelder-Mead', 'Powell', 'CG', 'BFGS', 'Newton-CG', 'L-BFGS-B', 'TNC', 'SLSQP', 'COBYLA'], 'scipy_go': ['differential_evolution', 'dual_annealing'], 'scipy_leastsq': ['lm-leastsq'], 'scipy_ls': ['lm-scipy', 'trf', 'dogbox'], 'theseus': ['Levenberg_Marquardt', 'Gauss-Newton']}

DEFAULT_OUTPUT = {'checkpoint_filename': 'checkpoint.json', 'cmap_range': [0.2, 0.8], 'colour_map': 'magma_r', 'colour_ulim': 100, 'comparison_mode': 'both', 'make_plots': True, 'pbar': True, 'results_browser': True, 'results_dir': 'fitbenchmarking_results', 'run_dash': True, 'run_name': '', 'table_type': ['acc', 'runtime', 'compare', 'local_min', 'emissions']}

DEFAULT_RUNTIME = {'runtime_metric': 'mean'}

VALID = {'DASH': {}, 'FITTING': {'algorithm_type': ['all', 'ls', 'deriv_free', 'general', 'simplex', 'trust_region', 'levenberg-marquardt', 'gauss_newton', 'bfgs', 'conjugate_gradient', 'steepest_descent', 'global_optimization', 'MCMC'], 'cost_func_type': ['nlls', 'weighted_nlls', 'hellinger_nlls', 'loglike_nlls', 'poisson'], 'hes_method': ['best_available', 'scipy', 'analytic', 'default', 'numdifftools'], 'jac_method': ['best_available', 'scipy', 'analytic', 'default', 'numdifftools'], 'software': ['bumps', 'ceres', 'dfo', 'gofit', 'gradient_free', 'gsl', 'horace', 'levmar', 'lmfit', 'mantid', 'matlab', 'matlab_curve', 'matlab_opt', 'matlab_stats', 'minuit', 'nlopt', 'paramonte', 'ralfit', 'scipy', 'scipy_ls', 'scipy_leastsq', 'scipy_go', 'theseus']}, 'HESSIAN': {'analytic': ['default'], 'best_available': ['default'], 'default': ['default'], 'numdifftools': ['central', 'complex', 'multicomplex', 'forward', 'backward'], 'scipy': ['2-point', '3-point', 'cs']}, 'JACOBIAN': {'analytic': ['default', 'sparse'], 'best_available': ['default'], 'default': ['default'], 'numdifftools': ['central', 'complex', 'multicomplex', 'forward', 'backward'], 'scipy': ['2-point', '3-point', 'cs', '2-point_sparse']}, 'LOGGING': {'append': [True, False], 'external_output': ['debug', 'display', 'log_only'], 'level': ['NOTSET', 'DEBUG', 'INFO', 'WARNING', 'ERROR', 'CRITICAL']}, 'MINIMIZERS': {'bumps': ['amoeba', 'lm-bumps', 'newton', 'de', 'scipy-leastsq', 'dream'], 'ceres': ['Levenberg_Marquardt', 'Dogleg', 'BFGS', 'LBFGS', 'steepest_descent', 'Fletcher_Reeves', 'Polak_Ribiere', 'Hestenes_Stiefel'], 'dfo': ['dfols'], 'gofit': ['alternating', 'multistart', 'regularisation'], 'gradient_free': ['HillClimbingOptimizer', 'RepulsingHillClimbingOptimizer', 'SimulatedAnnealingOptimizer', 'RandomSearchOptimizer', 'RandomRestartHillClimbingOptimizer', 'RandomAnnealingOptimizer', 'ParallelTemperingOptimizer', 'ParticleSwarmOptimizer', 'EvolutionStrategyOptimizer', 'BayesianOptimizer', 'TreeStructuredParzenEstimators', 'DecisionTreeOptimizer'], 'gsl': ['lmsder', 'lmder', 'nmsimplex', 'nmsimplex2', 'conjugate_pr', 'conjugate_fr', 'vector_bfgs', 'vector_bfgs2', 'steepest_descent'], 'horace': ['lm-lsqr'], 'levmar': ['levmar'], 'lmfit': ['differential_evolution', 'brute', 'basinhopping', 'powell', 'cobyla', 'slsqp', 'emcee', 'nelder', 'least_squares', 'trust-ncg', 'trust-exact', 'trust-krylov', 'trust-constr', 'dogleg', 'leastsq', 'newton', 'tnc', 'lbfgsb', 'bfgs', 'cg', 'ampgo', 'shgo', 'dual_annealing'], 'mantid': ['BFGS', 'Conjugate gradient (Fletcher-Reeves imp.)', 'Conjugate gradient (Polak-Ribiere imp.)', 'Damped GaussNewton', 'Levenberg-Marquardt', 'Levenberg-MarquardtMD', 'Simplex', 'SteepestDescent', 'Trust Region', 'FABADA'], 'matlab': ['Nelder-Mead Simplex'], 'matlab_curve': ['Levenberg-Marquardt', 'Trust-Region'], 'matlab_opt': ['levenberg-marquardt', 'trust-region-reflective'], 'matlab_stats': ['Levenberg-Marquardt'], 'minuit': ['migrad', 'simplex'], 'nlopt': ['LN_BOBYQA', 'LN_NEWUOA', 'LN_NEWUOA_BOUND', 'LN_PRAXIS', 'LD_SLSQP', 'LD_VAR2', 'LD_VAR1', 'AUGLAG', 'AUGLAG_EQ', 'LN_NELDERMEAD', 'LN_SBPLX', 'LN_COBYLA', 'LD_CCSAQ', 'LD_MMA', 'LD_TNEWTON_PRECOND_RESTART', 'LD_TNEWTON_PRECOND', 'LD_TNEWTON_RESTART', 'LD_TNEWTON', 'LD_LBFGS', 'GN_DIRECT', 'GN_DIRECT_L', 'GN_DIRECT_L_RAND', 'GNL_DIRECT_NOSCAL', 'GN_DIRECT_L_NOSCAL', 'GN_DIRECT_L_RAND_NOSCAL', 'GN_ORIG_DIRECT', 'GN_ORIG_DIRECT_L', 'GN_CRS2_LM', 'G_MLSL_LDS', 'G_MLSL', 'GD_STOGO', 'GD_STOGO_RAND', 'GN_AGS', 'GN_ISRES'], 'paramonte': ['paraDram_sampler'], 'ralfit': ['gn', 'gn_reg', 'hybrid', 'hybrid_reg', 'newton', 'newton_reg', 'newton-tensor', 'newton-tensor_reg'], 'scipy': ['Nelder-Mead', 'Powell', 'CG', 'BFGS', 'Newton-CG', 'L-BFGS-B', 'TNC', 'SLSQP', 'COBYLA', 'trust-ncg', 'trust-exact', 'trust-krylov', 'trust-constr', 'dogleg'], 'scipy_go': ['differential_evolution', 'shgo', 'dual_annealing'], 'scipy_leastsq': ['lm-leastsq'], 'scipy_ls': ['lm-scipy', 'trf', 'dogbox'], 'theseus': ['Levenberg_Marquardt', 'Gauss-Newton']}, 'OUTPUT': {'append': [True, False], 'colour_map': ['magma', 'inferno', 'plasma', 'viridis', 'cividis', 'twilight', 'twilight_shifted', 'turbo', 'Blues', 'BrBG', 'BuGn', 'BuPu', 'CMRmap', 'GnBu', 'Greens', 'Greys', 'OrRd', 'Oranges', 'PRGn', 'PiYG', 'PuBu', 'PuBuGn', 'PuOr', 'PuRd', 'Purples', 'RdBu', 'RdGy', 'RdPu', 'RdYlBu', 'RdYlGn', 'Reds', 'Spectral', 'Wistia', 'YlGn', 'YlGnBu', 'YlOrBr', 'YlOrRd', 'afmhot', 'autumn', 'binary', 'bone', 'brg', 'bwr', 'cool', 'coolwarm', 'copper', 'cubehelix', 'flag', 'gist_earth', 'gist_gray', 'gist_heat', 'gist_ncar', 'gist_rainbow', 'gist_stern', 'gist_yarg', 'gnuplot', 'gnuplot2', 'gray', 'hot', 'hsv', 'jet', 'nipy_spectral', 'ocean', 'pink', 'prism', 'rainbow', 'seismic', 'spring', 'summer', 'terrain', 'winter', 'Accent', 'Dark2', 'Paired', 'Pastel1', 'Pastel2', 'Set1', 'Set2', 'Set3', 'tab10', 'tab20', 'tab20b', 'tab20c', 'grey', 'gist_grey', 'gist_yerg', 'Grays', 'magma_r', 'inferno_r', 'plasma_r', 'viridis_r', 'cividis_r', 'twilight_r', 'twilight_shifted_r', 'turbo_r', 'Blues_r', 'BrBG_r', 'BuGn_r', 'BuPu_r', 'CMRmap_r', 'GnBu_r', 'Greens_r', 'Greys_r', 'OrRd_r', 'Oranges_r', 'PRGn_r', 'PiYG_r', 'PuBu_r', 'PuBuGn_r', 'PuOr_r', 'PuRd_r', 'Purples_r', 'RdBu_r', 'RdGy_r', 'RdPu_r', 'RdYlBu_r', 'RdYlGn_r', 'Reds_r', 'Spectral_r', 'Wistia_r', 'YlGn_r', 'YlGnBu_r', 'YlOrBr_r', 'YlOrRd_r', 'afmhot_r', 'autumn_r', 'binary_r', 'bone_r', 'brg_r', 'bwr_r', 'cool_r', 'coolwarm_r', 'copper_r', 'cubehelix_r', 'flag_r', 'gist_earth_r', 'gist_gray_r', 'gist_heat_r', 'gist_ncar_r', 'gist_rainbow_r', 'gist_stern_r', 'gist_yarg_r', 'gnuplot_r', 'gnuplot2_r', 'gray_r', 'hot_r', 'hsv_r', 'jet_r', 'nipy_spectral_r', 'ocean_r', 'pink_r', 'prism_r', 'rainbow_r', 'seismic_r', 'spring_r', 'summer_r', 'terrain_r', 'winter_r', 'Accent_r', 'Dark2_r', 'Paired_r', 'Pastel1_r', 'Pastel2_r', 'Set1_r', 'Set2_r', 'Set3_r', 'tab10_r', 'tab20_r', 'tab20b_r', 'tab20c_r'], 'comparison_mode': ['abs', 'rel', 'both'], 'external_output': ['debug', 'display', 'log_only'], 'level': ['NOTSET', 'DEBUG', 'INFO', 'WARNING', 'ERROR', 'CRITICAL'], 'make_plots': [True, False], 'pbar': [True, False], 'results_browser': [True, False], 'run_dash': [True, False], 'table_type': ['acc', 'runtime', 'compare', 'local_min', 'emissions']}, 'RUNTIME': ['mean', 'minimum', 'maximum', 'first', 'median', 'harmonic', 'trim']}

VALID_DASH = {}

VALID_FITTING = {'algorithm_type': ['all', 'ls', 'deriv_free', 'general', 'simplex', 'trust_region', 'levenberg-marquardt', 'gauss_newton', 'bfgs', 'conjugate_gradient', 'steepest_descent', 'global_optimization', 'MCMC'], 'cost_func_type': ['nlls', 'weighted_nlls', 'hellinger_nlls', 'loglike_nlls', 'poisson'], 'hes_method': ['best_available', 'scipy', 'analytic', 'default', 'numdifftools'], 'jac_method': ['best_available', 'scipy', 'analytic', 'default', 'numdifftools'], 'software': ['bumps', 'ceres', 'dfo', 'gofit', 'gradient_free', 'gsl', 'horace', 'levmar', 'lmfit', 'mantid', 'matlab', 'matlab_curve', 'matlab_opt', 'matlab_stats', 'minuit', 'nlopt', 'paramonte', 'ralfit', 'scipy', 'scipy_ls', 'scipy_leastsq', 'scipy_go', 'theseus']}

VALID_HESSIAN = {'analytic': ['default'], 'best_available': ['default'], 'default': ['default'], 'numdifftools': ['central', 'complex', 'multicomplex', 'forward', 'backward'], 'scipy': ['2-point', '3-point', 'cs']}

VALID_JACOBIAN = {'analytic': ['default', 'sparse'], 'best_available': ['default'], 'default': ['default'], 'numdifftools': ['central', 'complex', 'multicomplex', 'forward', 'backward'], 'scipy': ['2-point', '3-point', 'cs', '2-point_sparse']}

VALID_LOGGING = {'append': [True, False], 'external_output': ['debug', 'display', 'log_only'], 'level': ['NOTSET', 'DEBUG', 'INFO', 'WARNING', 'ERROR', 'CRITICAL']}

VALID_MINIMIZERS = {'bumps': ['amoeba', 'lm-bumps', 'newton', 'de', 'scipy-leastsq', 'dream'], 'ceres': ['Levenberg_Marquardt', 'Dogleg', 'BFGS', 'LBFGS', 'steepest_descent', 'Fletcher_Reeves', 'Polak_Ribiere', 'Hestenes_Stiefel'], 'dfo': ['dfols'], 'gofit': ['alternating', 'multistart', 'regularisation'], 'gradient_free': ['HillClimbingOptimizer', 'RepulsingHillClimbingOptimizer', 'SimulatedAnnealingOptimizer', 'RandomSearchOptimizer', 'RandomRestartHillClimbingOptimizer', 'RandomAnnealingOptimizer', 'ParallelTemperingOptimizer', 'ParticleSwarmOptimizer', 'EvolutionStrategyOptimizer', 'BayesianOptimizer', 'TreeStructuredParzenEstimators', 'DecisionTreeOptimizer'], 'gsl': ['lmsder', 'lmder', 'nmsimplex', 'nmsimplex2', 'conjugate_pr', 'conjugate_fr', 'vector_bfgs', 'vector_bfgs2', 'steepest_descent'], 'horace': ['lm-lsqr'], 'levmar': ['levmar'], 'lmfit': ['differential_evolution', 'brute', 'basinhopping', 'powell', 'cobyla', 'slsqp', 'emcee', 'nelder', 'least_squares', 'trust-ncg', 'trust-exact', 'trust-krylov', 'trust-constr', 'dogleg', 'leastsq', 'newton', 'tnc', 'lbfgsb', 'bfgs', 'cg', 'ampgo', 'shgo', 'dual_annealing'], 'mantid': ['BFGS', 'Conjugate gradient (Fletcher-Reeves imp.)', 'Conjugate gradient (Polak-Ribiere imp.)', 'Damped GaussNewton', 'Levenberg-Marquardt', 'Levenberg-MarquardtMD', 'Simplex', 'SteepestDescent', 'Trust Region', 'FABADA'], 'matlab': ['Nelder-Mead Simplex'], 'matlab_curve': ['Levenberg-Marquardt', 'Trust-Region'], 'matlab_opt': ['levenberg-marquardt', 'trust-region-reflective'], 'matlab_stats': ['Levenberg-Marquardt'], 'minuit': ['migrad', 'simplex'], 'nlopt': ['LN_BOBYQA', 'LN_NEWUOA', 'LN_NEWUOA_BOUND', 'LN_PRAXIS', 'LD_SLSQP', 'LD_VAR2', 'LD_VAR1', 'AUGLAG', 'AUGLAG_EQ', 'LN_NELDERMEAD', 'LN_SBPLX', 'LN_COBYLA', 'LD_CCSAQ', 'LD_MMA', 'LD_TNEWTON_PRECOND_RESTART', 'LD_TNEWTON_PRECOND', 'LD_TNEWTON_RESTART', 'LD_TNEWTON', 'LD_LBFGS', 'GN_DIRECT', 'GN_DIRECT_L', 'GN_DIRECT_L_RAND', 'GNL_DIRECT_NOSCAL', 'GN_DIRECT_L_NOSCAL', 'GN_DIRECT_L_RAND_NOSCAL', 'GN_ORIG_DIRECT', 'GN_ORIG_DIRECT_L', 'GN_CRS2_LM', 'G_MLSL_LDS', 'G_MLSL', 'GD_STOGO', 'GD_STOGO_RAND', 'GN_AGS', 'GN_ISRES'], 'paramonte': ['paraDram_sampler'], 'ralfit': ['gn', 'gn_reg', 'hybrid', 'hybrid_reg', 'newton', 'newton_reg', 'newton-tensor', 'newton-tensor_reg'], 'scipy': ['Nelder-Mead', 'Powell', 'CG', 'BFGS', 'Newton-CG', 'L-BFGS-B', 'TNC', 'SLSQP', 'COBYLA', 'trust-ncg', 'trust-exact', 'trust-krylov', 'trust-constr', 'dogleg'], 'scipy_go': ['differential_evolution', 'shgo', 'dual_annealing'], 'scipy_leastsq': ['lm-leastsq'], 'scipy_ls': ['lm-scipy', 'trf', 'dogbox'], 'theseus': ['Levenberg_Marquardt', 'Gauss-Newton']}

VALID_OUTPUT = {'append': [True, False], 'colour_map': ['magma', 'inferno', 'plasma', 'viridis', 'cividis', 'twilight', 'twilight_shifted', 'turbo', 'Blues', 'BrBG', 'BuGn', 'BuPu', 'CMRmap', 'GnBu', 'Greens', 'Greys', 'OrRd', 'Oranges', 'PRGn', 'PiYG', 'PuBu', 'PuBuGn', 'PuOr', 'PuRd', 'Purples', 'RdBu', 'RdGy', 'RdPu', 'RdYlBu', 'RdYlGn', 'Reds', 'Spectral', 'Wistia', 'YlGn', 'YlGnBu', 'YlOrBr', 'YlOrRd', 'afmhot', 'autumn', 'binary', 'bone', 'brg', 'bwr', 'cool', 'coolwarm', 'copper', 'cubehelix', 'flag', 'gist_earth', 'gist_gray', 'gist_heat', 'gist_ncar', 'gist_rainbow', 'gist_stern', 'gist_yarg', 'gnuplot', 'gnuplot2', 'gray', 'hot', 'hsv', 'jet', 'nipy_spectral', 'ocean', 'pink', 'prism', 'rainbow', 'seismic', 'spring', 'summer', 'terrain', 'winter', 'Accent', 'Dark2', 'Paired', 'Pastel1', 'Pastel2', 'Set1', 'Set2', 'Set3', 'tab10', 'tab20', 'tab20b', 'tab20c', 'grey', 'gist_grey', 'gist_yerg', 'Grays', 'magma_r', 'inferno_r', 'plasma_r', 'viridis_r', 'cividis_r', 'twilight_r', 'twilight_shifted_r', 'turbo_r', 'Blues_r', 'BrBG_r', 'BuGn_r', 'BuPu_r', 'CMRmap_r', 'GnBu_r', 'Greens_r', 'Greys_r', 'OrRd_r', 'Oranges_r', 'PRGn_r', 'PiYG_r', 'PuBu_r', 'PuBuGn_r', 'PuOr_r', 'PuRd_r', 'Purples_r', 'RdBu_r', 'RdGy_r', 'RdPu_r', 'RdYlBu_r', 'RdYlGn_r', 'Reds_r', 'Spectral_r', 'Wistia_r', 'YlGn_r', 'YlGnBu_r', 'YlOrBr_r', 'YlOrRd_r', 'afmhot_r', 'autumn_r', 'binary_r', 'bone_r', 'brg_r', 'bwr_r', 'cool_r', 'coolwarm_r', 'copper_r', 'cubehelix_r', 'flag_r', 'gist_earth_r', 'gist_gray_r', 'gist_heat_r', 'gist_ncar_r', 'gist_rainbow_r', 'gist_stern_r', 'gist_yarg_r', 'gnuplot_r', 'gnuplot2_r', 'gray_r', 'hot_r', 'hsv_r', 'jet_r', 'nipy_spectral_r', 'ocean_r', 'pink_r', 'prism_r', 'rainbow_r', 'seismic_r', 'spring_r', 'summer_r', 'terrain_r', 'winter_r', 'Accent_r', 'Dark2_r', 'Paired_r', 'Pastel1_r', 'Pastel2_r', 'Set1_r', 'Set2_r', 'Set3_r', 'tab10_r', 'tab20_r', 'tab20b_r', 'tab20c_r'], 'comparison_mode': ['abs', 'rel', 'both'], 'external_output': ['debug', 'display', 'log_only'], 'level': ['NOTSET', 'DEBUG', 'INFO', 'WARNING', 'ERROR', 'CRITICAL'], 'make_plots': [True, False], 'pbar': [True, False], 'results_browser': [True, False], 'run_dash': [True, False], 'table_type': ['acc', 'runtime', 'compare', 'local_min', 'emissions']}

VALID_RUNTIME = ['mean', 'minimum', 'maximum', 'first', 'median', 'harmonic', 'trim']

VALID_SECTIONS = ['MINIMIZERS', 'FITTING', 'JACOBIAN', 'HESSIAN', 'OUTPUT', 'LOGGING', 'RUNTIME', 'DASH']

property minimizers: Returns the minimizers in a software package

read_value(func, option, additional_options)

Helper function which loads in the value

Parameters:

func (callable) – configparser function
option (str) – option to be read for file
additional_options – A dictionary of options

input by the user into the command line. :type additional_options: dict

Returns:: value of the option
Return type:: list/str/int/bool

property results_dir: str: Returns the directory to store the results in.

write(file_name)

Write the contents of the options object to a new options file.

Parameters:: file_name (str) – The path to the new options file

write_to_stream(file_object)

Write the contents of the options object to a file object.

fitbenchmarking.utils.options.find_options_file(options_file: str, additional_options: dict) → Options

Attempts to find the options file and creates an Options object for it. Wildcards are accepted in the parameters of this function.

Parameters:

options_file (str) – The path or glob pattern for an options file.
additional_options (dict) – A dictionary of options input by the user into the command line.

Returns:

An Options object.

Return type:

fitbenchmarking.utils.options.Options

fitbenchmarking.utils.options.read_list(s)

Utility function to allow lists to be read by the config parser

Parameters:: s (string) – string to convert to a list
Returns:: list of items
Return type:: list of str

fitbenchmarking.utils.options.read_range(s)

Utility function to allow ranges to be read by the config parser

Parameters:: s (string) – string to convert to a list
Returns:: two element list [lower_lim, upper lim]
Return type:: list