zfit.pdf.
SumPDF
Bases: zfit.models.functor.BaseFunctor
zfit.models.functor.BaseFunctor
Create the sum of the pdfs with fracs as coefficients or the yields, if extended pdfs are given.
If all pdfs are extended, the fracs is optional and the (normalized) yields will be used as fracs. If fracs is given, this will be used as the fractions, regardless of whether the pdfs have a yield or not.
The parameters of the SumPDF are the fractions that are used to multiply the output of each daughter pdf. They can be accessed with pdf.params and have names f”frac_{i}” with i starting from 0 and going to the number of pdfs given.
To get the component outputs of this pdf, e.g. to plot it, use pdf.params.values() to iterate through the fracs and pdfs to get the pdfs. For example
for pdf, frac in zip(sumpdf.pdfs, sumpdf.params.values()): frac_integral = pdf.integrate(...) * frac
pdfs (List[ZfitPDF]) – The pdfs to be added.
List
ZfitPDF
fracs (Optional[~ParamTypeInput]) –
Optional
Coefficients for the linear combination of the pdfs. Optional if all pdfs are extended.
len(frac) == len(basic) - 1 results in the interpretation of a non-extended pdf. The last coefficient will equal to 1 - sum(frac)
len(frac) == len(pdf): the fracs will be used as is and no normalization attempt is taken.
name (str) – This is the stub description for names. Change it in docs/subst_types.txt.
str
ModelIncompatibleError: If model is incompatible.
add_cache_deps
Add dependencies that render the cache invalid if they change.
cache_deps (Union[ForwardRef, Iterable[ForwardRef]]) –
Union
ForwardRef
Iterable
allow_non_cachable (bool) – If True, allow cache_dependents to be non-cachables. If False, any cache_dependents that is not a ZfitCachable will raise an error.
bool
TypeError – if one of the cache_dependents is not a ZfitCachable _and_ allow_non_cachable if False.
analytic_integrate
Analytical integration over function and raise Error if not possible.
limits (Union[Tuple[Tuple[float, …]], Tuple[float, …], bool, ForwardRef]) – the limits to integrate over
Tuple
float
norm_range (Union[Tuple[Tuple[float, …]], Tuple[float, …], bool, ForwardRef]) – the limits to normalize over
Union[float, Tensor]
Tensor
The integral value
AnalyticIntegralNotImplementedError – If no analytical integral is available (for this limits).
NormRangeNotImplementedError – if the norm_range argument is not supported. This means that no analytical normalization is available, explicitly: the analytical integral over the limits = norm_range is not available.
apply_yield
If a norm_range is given, the value will be multiplied by the yield.
value (Union[float, Tensor]) –
norm_range (Union[ZfitLimit, Tensor, ndarray, Iterable[float], float, Tuple[float], List[float], bool, None]) –
ZfitLimit
ndarray
None
log (bool) –
Numerical
as_func
Return a Function with the function model(x, norm_range=norm_range).
norm_range (Union[Tuple[Tuple[float, …]], Tuple[float, …], bool, ForwardRef]) –
convert_sort_space
Convert the inputs (using eventually obs, axes) to ZfitSpace and sort them according to own obs.
ZfitSpace
obs (Union[str, Iterable[str], Space, ZfitLimit, Tensor, ndarray, Iterable[float], float, Tuple[float], List[float], bool, None]) –
Space
axes (Union[int, Iterable[int], None]) –
int
limits (Union[ZfitLimit, Tensor, ndarray, Iterable[float], float, Tuple[float], List[float], bool, None]) –
Returns:
Optional[ZfitSpace]
copy
Creates a copy of the model.
Note: the copy model may continue to depend on the original initialization arguments.
**override_parameters – String/value dictionary of initialization arguments to override with new value.
BasePDF
of self.parameters and override_parameters, i.e., dict(self.parameters, **override_parameters).
create_extended
Return an extended version of this pdf with yield yield_. The parameters are shared.
yield –
name_addition –
create_projection_pdf
Create a PDF projection by integrating out some of the dimensions.
The new projection pdf is still fully dependent on the pdf it was created with.
limits_to_integrate (Union[ZfitLimit, Tensor, ndarray, Iterable[float], float, Tuple[float], List[float], bool, None]) –
A pdf without the dimensions from limits_to_integrate.
create_sampler
Create a Sampler that acts as Data but can be resampled, also with changed parameters and n.
Sampler
If limits is not specified, space is used (if the space contains limits). If n is None and the model is an extended pdf, ‘extended’ is used by default.
n (Union[int, Tensor, str]) –
The number of samples to be generated. Can be a Tensor that will be or a valid string. Currently implemented:
’extended’: samples poisson(yield) from each pdf that is extended.
limits (Union[Tuple[Tuple[float, …]], Tuple[float, …], bool, ForwardRef]) – From which space to sample.
fixed_params (Union[bool, List[ZfitParameter], Tuple[ZfitParameter]]) – A list of Parameters that will be fixed during several resample calls. If True, all are fixed, if False, all are floating. If a Parameter is not fixed and its value gets updated (e.g. by a Parameter.set_value() call), this will be reflected in resample. If fixed, the Parameter will still have the same value as the Sampler has been created with when it resamples.
ZfitParameter
Parameter
py:class:~`zfit.core.data.Sampler`
NotExtendedPDFError – if ‘extended’ is chosen (implicitly by default or explicitly) as an option for n but the pdf itself is not extended.
ValueError – if n is an invalid string option.
InvalidArgumentError – if n is not specified and pdf is not extended.
dtype
The dtype of the object
DType
get_cache_deps
Return a set of all independent Parameter that this object depends on.
only_floating (bool) – If True, only return floating Parameter
OrderedSet
get_dependencies
DEPRECATED FUNCTION
Warning: THIS FUNCTION IS DEPRECATED. It will be removed in a future version. Instructions for updating: Use get_params instead if you want to retrieve the independent parameters or get_cache_deps in case you need the numerical cache dependents (advanced).
get_params
Recursively collect parameters that this object depends on according to the filter criteria.
parameters that are fixed.
True: only return parameters that fulfil this criterion
only parameters that are not floating.
floating (Optional[bool]) – if a parameter is floating, e.g. if floating() returns True
floating()
is_yield (Optional[bool]) – if a parameter is a yield of the _current_ model. This won’t be applied recursively, but may include yields if they do also represent a parameter parametrizing the shape. So if the yield of the current model depends on other yields (or also non-yields), this will be included. If, however, just submodels depend on a yield (as their yield) and it is not correlated to the output of our model, they won’t be included.
extract_independent (Optional[bool]) – If the parameter is an independent parameter, i.e. if it is a ZfitIndependentParameter.
Set[ZfitParameter]
Set
get_yield
Return the yield (only for extended models).
Optional[Parameter]
The yield of the current model or None
is_extended
Flag to tell whether the model is extended or not.
A boolean.
log_pdf
Log probability density function normalized over norm_range.
x (Union[float, Tensor]) – float or double Tensor.
norm_range (Union[Tuple[Tuple[float, …]], Tuple[float, …], bool, ForwardRef]) – Space to normalize over
A Tensor of type self.dtype.
models
Return the models of this Functor. Can be pdfs or funcs.
List[ZfitModel]
ZfitModel
name
The name of the object.
norm_range
Return the current normalization range. If None and the obs have limits, they are returned.
Union[Space, None, bool]
The current normalization range.
normalization
Return the normalization of the function (usually the integral over limits).
limits (Union[Tuple[Tuple[float, …]], Tuple[float, …], bool, ForwardRef]) – The limits on where to normalize over
The normalization value
numeric_integrate
Numerical integration over the model.
register_additional_repr
Register an additional attribute to add to the repr.
keyword argument. The value has to be gettable from the instance (has to be an (any) –
or callable method of self. (attribute) –
register_analytic_integral
Register an analytic integral with the class.
func (Callable) –
Callable
A function that calculates the (partial) integral over the axes limits. The signature has to be the following:
x (ZfitData, None): the data for the remaining axes in a partialintegral. If it is not a partial integral, this will be None. limits (ZfitSpace): the limits to integrate over. norm_range (ZfitSpace, None): Normalization range of the integral.If not supports_supports_norm_range, this will be None. params (Dict[param_name, zfit.Parameters]): The parameters of the model. model (ZfitModel):The model that is being integrated.
ZfitData
integral. If it is not a partial integral, this will be None.
limits (ZfitSpace): the limits to integrate over.
If not supports_supports_norm_range, this will be None.
params (Dict[param_name, zfit.Parameters]): The parameters of the model.
zfit.Parameters
model (ZfitModel):The model that is being integrated.
limits (Union[Tuple[Tuple[float, …]], Tuple[float, …], bool, ForwardRef]) – If a :py:class:~`zfit.Space` is given, it is used as limits. Otherwise arguments to instantiate a Range class can be given as follows.|limits_init|
priority (Union[int, float]) – Priority of the function. If multiple functions cover the same space, the one with the highest priority will be used.
supports_multiple_limits (bool) – If True, the limits given to the integration function can have multiple limits. If False, only simple limits will pass through and multiple limits will be auto-handled.
supports_norm_range (bool) – If True, norm_range argument to the function may not be None. If False, norm_range will always be None and care is taken of the normalization automatically.
register_cacher
Register a cacher that caches values produces by this instance; a dependent.
cacher (Union[ForwardRef, Iterable[ForwardRef]]) –
register_inverse_analytic_integral
Register an inverse analytical integral, the inverse (unnormalized) cdf.
func (Callable) – A function with the signature func(x, params), where x is a Data object and params is a dict.
reset_cache_self
Clear the cache of self and all dependent cachers.
sample
Sample n points within limits from the model.
limits (Union[Tuple[Tuple[float, …]], Tuple[float, …], bool, ForwardRef]) – In which region to sample in
SampleData
SampleData(n_obs, n_samples)
NotExtendedPDFError – if ‘extended’ is (implicitly by default or explicitly) chosen as an option for n but the pdf itself is not extended.
set_norm_range
Set the normalization range (temporarily if used with contextmanager).
set_yield
Make the model extended by setting a yield. If possible, prefer to use create_extended.
This does not alter the general behavior of the PDF. The pdf and integrate and similar methods will continue to return the same - normalized to 1 - values. However, not only can this parameter be accessed via get_yield, the methods ext_pdf and ext_integral provide a version of pdf and integrate respecetively that is multiplied by the yield.
These can be useful for plotting and for binned likelihoods.
() (value) –
unnormalized_pdf
PDF “unnormalized”. Use functions for unnormalized pdfs. this is only for performance in special cases. (deprecated)
Warning: THIS FUNCTION IS DEPRECATED. It will be removed in a future version. Instructions for updating: Use pdf(norm_range=False) instead
x (Union[float, Tensor]) – The value, have to be convertible to a Tensor
component_norm_range (Union[ZfitLimit, Tensor, ndarray, Iterable[float], float, Tuple[float], List[float], bool, None]) – The normalization range for the components. Needed for
composition (certain) – pdfs.
1-dimensional tf.Tensor containing the unnormalized pdf.
tf.Tensor
update_integration_options
Set the integration options.
draws_per_dim – The draws for MC integration to do
mc_sampler –