TemplateModel
- class sherpa.models.template.TemplateModel(name='templatemodel', pars=(), parvals=None, templates=None)[source] [edit on github]
Bases:
ArithmeticModel
Combine TableModel instances.
- Parameters:
name (str) – The name of the model
pars (sequence of sherpa.models.parameter.Parameter) – The parameters.
parvals (sequence of sequence of float) – The parameter values for each template.
templates (sequence of TableModel) – The template for each element of parvals.
See also
Attributes Summary
The maximum size of the cache.
The dimensionality of the model, if defined, or None.
The hard maximum values for the thawed parameters.
The hard minimum values for the thawed parameters.
The maximum limits of the thawed parameters.
The minimum limits of the thawed parameters.
The thawed parameters of the model.
Methods Summary
apply
(outer, *otherargs, **otherkwargs)Clear the cache.
Display the cache status.
calc
(p, x0[, x1])Evaluate the model on a grid.
fold
(data)Ensure the templates match the data filtering.
freeze
()Freeze any thawed parameters of the model.
get_x
()Return the x (independent) axis for the selected template.
get_y
()Return the y (dependent) axis for the selected template.
guess
(dep, *args, **kwargs)Set an initial guess for the parameter values.
query
(p)Return the template for a given set of parameters.
reset
()Reset the parameter values.
set_center
(*args, **kwargs)startup
([cache])Called before a model may be evaluated multiple times.
teardown
()Called after a model may be evaluated multiple times.
thaw
()Thaw any frozen parameters of the model.
Attributes Documentation
- cache = 5
The maximum size of the cache.
- ndim = None
The dimensionality of the model, if defined, or None.
- thawedparhardmaxes
The hard maximum values for the thawed parameters.
The minimum and maximum range of the parameters can be changed with thawedparmins and thawedparmaxes but only within the range given by thawedparhardmins to thawparhardmaxes.
See also
- thawedparhardmins
The hard minimum values for the thawed parameters.
The minimum and maximum range of the parameters can be changed with thawedparmins and thawedparmaxes but only within the range given by thawedparhardmins to thawparhardmaxes.
See also
- thawedparmaxes
The maximum limits of the thawed parameters.
Get or set the maximum limits of the thawed parameters of the model as a list of numbers. If there are no thawed parameters then [] is used. The ordering matches that of the pars attribute.
See also
thawedpars
,thawedarhardmaxes
,thawedparmins
- thawedparmins
The minimum limits of the thawed parameters.
Get or set the minimum limits of the thawed parameters of the model as a list of numbers. If there are no thawed parameters then [] is used. The ordering matches that of the pars attribute.
See also
thawedpars
,thawedarhardmins
,thawedparmaxes
- thawedpars
The thawed parameters of the model.
Get or set the thawed parameters of the model as a list of numbers. If there are no thawed parameters then [] is used. The ordering matches that of the pars attribute.
See also
Methods Documentation
- apply(outer, *otherargs, **otherkwargs) [edit on github]
- cache_clear() [edit on github]
Clear the cache.
- cache_status() [edit on github]
Display the cache status.
Information on the cache - the number of “hits”, “misses”, and “requests” - is displayed at the INFO logging level.
Example
>>> pl.cache_status() powlaw1d.pl size: 5 hits: 633 misses: 240 check= 873
- calc(p, x0, x1=None, *args, **kwargs)[source] [edit on github]
Evaluate the model on a grid.
- Parameters:
p (sequence of numbers) – The parameter values to use. The order matches the
pars
field.*args – The model grid. The values can be scalar or arrays, and the number depends on the dimensionality of the model and whether it is being evaluated over an integrated grid or at a point (or points).
**kwargs – Any model-specific values that are not parameters.
- fold(data)[source] [edit on github]
Ensure the templates match the data filtering.
- Parameters:
data (sherpa.data.Data instance) –
- freeze() [edit on github]
Freeze any thawed parameters of the model.
- get_center() [edit on github]
- get_x()[source] [edit on github]
Return the x (independent) axis for the selected template.
- Returns:
x
- Return type:
sequence of float
- get_y()[source] [edit on github]
Return the y (dependent) axis for the selected template.
- Returns:
y
- Return type:
sequence of float
- guess(dep, *args, **kwargs) [edit on github]
Set an initial guess for the parameter values.
Attempt to set the parameter values, and ranges, for the model to match the data values. This is intended as a rough guess, so it is expected that the model is only evaluated a small number of times, if at all.
- query(p)[source] [edit on github]
Return the template for a given set of parameters.
- reset() [edit on github]
Reset the parameter values.
Restores each parameter to the last value it was set to. This allows the parameters to be easily reset after a fit.
- set_center(*args, **kwargs) [edit on github]
- startup(cache=False) [edit on github]
Called before a model may be evaluated multiple times.
- Parameters:
cache (bool, optional) – Should a cache be used when evaluating the models.
See also
- teardown() [edit on github]
Called after a model may be evaluated multiple times.
See also
- thaw() [edit on github]
Thaw any frozen parameters of the model.
Those parameters that are marked as “always frozen” are skipped.