pint.eventstats.sig2sigma

pint.eventstats.sig2sigma(sig, two_tailed=True, logprob=False)[source]

Convert tail probability to “sigma” units.

Find the value of the argument for the normal distribution beyond which the integrated tail probability is sig. Note that the default is to interpret this number as the two-tailed value, as this is the quantity that goes to 0 when sig goes to 1 and is also what most people mean by “sigma”, i.e. a chance probability of 0.32 will return a value of 1 sigma.

Two-tailed: int_{-sigma}^{+sigma} norm(x) dx = sig

One-tailed: int_{-inf}^{sigma} norm(x) dx = sig

Note that if sig >= 0.5, the one-tailed result will be negative.

Parameters:
  • sig – the chance probability

  • two_tailed (bool, optional) – interpret sig as two-tailed or one-tailed probability in converting

  • logprob (bool, optional) – if True, the argument is the natural logarithm of the probability