pyfli.phasor.phasorS.phasor_lifetime#

Apparent single-exponential lifetimes of a phasor relative to the universal semicircle.

Module Attributes

APPARENT_LIFETIMES

phase, modulation and normal lifetime.

Functions

_semicircle_angle(g, s)

Angle theta in [0, pi] of the semicircle point nearest to each phasor, seen from the centre (1/2, 0).

apparent_lifetimes(g, s, frequency_hz[, ...])

Phase, modulation and normal lifetimes of each phasor.

normal_lifetime(g, s, frequency_hz[, harmonic])

Normal lifetime tau_N: the lifetime of the semicircle point nearest to each phasor.

semicircle_nearest_point(g, s)

Nearest point (G_N, S_N) of the universal semicircle to each phasor (g, s).
APPARENT_LIFETIMES = ('tau_phi', 'tau_m', 'tau_n')#

phase, modulation and normal lifetime.

Type:

Keys returned by apparent_lifetimes()

semicircle_nearest_point(g, s)[source]#

Nearest point (G_N, S_N) of the universal semicircle to each phasor (g, s).

Parameters:

  • g (array_like) – Phasor coordinates (any shape).

  • s (array_like) – Phasor coordinates (any shape).

Returns:

(G_N, S_N) with the shape of g; NaN for the semicircle centre and for non-finite phasors.

Return type:

tuple[np.ndarray, np.ndarray]

normal_lifetime(g, s, frequency_hz, harmonic=1)[source]#

Normal lifetime tau_N: the lifetime of the semicircle point nearest to each phasor.

Parameters:

  • g (array_like) – IRF-calibrated phasor coordinates (any shape).

  • s (array_like) – IRF-calibrated phasor coordinates (any shape).

  • frequency_hz (float) – Laser repetition (modulation) frequency in hertz.

  • harmonic (int) – Harmonic of the phasor.

Returns:

tau_N = tan(theta / 2) / omega in nanoseconds, same shape as g: 0 at (1, 0), inf at (0, 0) (and for phasors below the axis nearest to those ends), NaN at the semicircle centre and for non-finite phasors.

Return type:

np.ndarray

apparent_lifetimes(g, s, frequency_hz, harmonic=1)[source]#

Phase, modulation and normal lifetimes of each phasor.

Parameters:

  • g (array_like) – IRF-calibrated phasor coordinates (any shape, e.g. (H, W) maps).

  • s (array_like) – IRF-calibrated phasor coordinates (any shape, e.g. (H, W) maps).

  • frequency_hz (float) – Laser repetition (modulation) frequency in hertz.

  • harmonic (int) – Harmonic of the phasor.

Returns:

{"tau_phi", "tau_m", "tau_n"} (see APPARENT_LIFETIMES), each in nanoseconds with the shape of g.

Return type:

dict[str, np.ndarray]