qspec.simulate.DecayMap  (  labels = None ,  a = None ,  k_max = 1 ,  instance = None  )[source]

Class linking sets of atomic states via Einstein-A coefficients. The class supports all multipole orders for electric and magnetic transitions.

Parameters:

labelsIterable[tuple] | None

An iterable of pairs of labels connected via Einstein-A coefficients. The order of each pair is arbitrary.

aIterable[scalar | dict] | None

An Iterable of Einstein-A coefficients $A_{if}$, where the states $|i\rangle$ and $|f\rangle$ have the labels specified in the list of labels. If a[i] is a single value, only the lowest allowed (not necessarily the dominant!) multipole transition will be used. Each a[i] can also be a dict with keys "e" or "m" to use either first allowed multipole order, or f'e{k}" or f'm{k}" to define specific rank-$k$ multipole transitions. (MHz).

k_maxint

The maximum considered multipole order $k_\mathrm{max}$. The default value is 1 (dipole).

instanceqspec.simulate.DecayMap | C.DecayMapHandler.value | None

An existing DecayMap instance. If this is specified, the other parameters are omitted.