Poisson

class pyhf.probability.Poisson(rate)[source]

Bases: pyhf.probability._SimpleDistributionMixin

The Poisson distribution with rate parameter rate.

Example

>>> import pyhf
>>> rates = pyhf.tensorlib.astensor([5, 8])
>>> pyhf.probability.Poisson(rates)
<pyhf.probability.Poisson object at 0x...>
__init__(rate)[source]
Parameters

rate (tensor or float) – The mean of the Poisson distribution (the expected number of events)

Methods

expected_data()[source]

The expectation value of the Poisson distribution.

Example

>>> import pyhf
>>> rates = pyhf.tensorlib.astensor([5, 8])
>>> poissons = pyhf.probability.Poisson(rates)
>>> poissons.expected_data()
array([5., 8.])
Returns

The mean of the Poisson distribution (which is the rate)

Return type

Tensor