arc.divalent_atom_functions.DivalentAtom.getStateLifetime#

DivalentAtom.getStateLifetime(n, l, j, temperature=0, includeLevelsUpTo=0, s=0)[source]#

Returns the lifetime of the state (in s)

For non-zero temperatures, user must specify up to which principal quantum number levels, that is above the initial state, should be included in order to account for black-body induced transitions to higher lying states. See Rydberg lifetimes example snippet.

Parameters:
  • n (int,int,float) – specifies state whose lifetime we are calculating

  • l (int,int,float) – specifies state whose lifetime we are calculating

  • j (int,int,float) – specifies state whose lifetime we are calculating

  • temperature – optional. Temperature at which the atom environment is, measured in K. If this parameter is non-zero, user has to specify transitions up to which state (due to black-body decay) should be included in calculation.

  • includeLevelsUpTo (int) – optional and not needed for atom lifetimes calculated at zero temperature. At non zero temperatures, this specify maximum principal quantum number of the state to which black-body induced transitions will be included. Minimal value of the parameter in that case is \(n+1\)

  • s (float) – optional, total spin angular momentum of state. By default 0.5 for Alkali atoms.

Returns:

State lifetime in units of s (seconds)

Return type:

float

See also

getTransitionRate for calculating rates of individual transition rates between the two states