deerlab.profile_analysis#

profile_analysis(model, y, *args, parameters='all', grids=None, samples=50, noiselvl=None, verbose=False, **kargs)[source]#

Profile likelihood analysis for uncertainty quantification

This function performs a profile likelihood analysis to estimate the uncertainty of non-linear model parameters. The profile likelihood is defined as the maximum likelihood of a model given a fixed value of the parameter of interest. This function allows to specify the model parameters to profile, the number of samples to use to estimate the profile function, and the noise level of the datasets.

Parameters:
modeldeerlab.Model

Model object describing the data. All non-linear model parameters are profiled by default.

yarray_like or list of array_like

Experimental dataset(s).

argspositional arguments

Any other positional arguments to be passed to the fit function. See the documentation of the fit function for further details.

parametersstring or list thereof

Model parameters to profile. If set to 'all' all non-linear parameters in the model are analyzed.

samplesinteger scalar

Number of points to take to estimate the profile function. Ignored if grids is specified.

gridsdict of array_like

Grids of values on which to evaluate the profile for each parameter. Must be a dictionary of grids with keys corresponding to the names of the model parameters to be profiled. Overrides the samples argument.

noiselvlfloat, optional

Noise level(s) of the datasets. If set to None it is determined automatically.

verboseboolean, optional

Specifies whether to print the progress of the bootstrap analysis on the command window, the default is false.

kargskeyword-argument pairs

Any other keyword-argument pairs to be passed to the fit function. See the documentation of the fit function for further details.

Returns:
profuqdict of deerlab.UQResult

Dictionary containing the profile uncertainty quantification for each profiled non-linear model parameter. The respective parameter’s results can be accessed via the model parameter name.