Logo

A physics toolbox for laser spectroscopy.

Static Badge Static Badge Static Badge

Static Badge Static Badge

© 2025 Patrick Müller. All rights reserved.

qspec.simulate.State  (  freq_j parity j i f m ls = None jj = None hyper_const = None gj = 0.0 gi = 0.0 label = None instance = None  )[source]

Class representing an atomic quantum state $|\mathrm{[label]}\pi JIFm\rangle$.

Parameters:
freq_jquant_like

The absolute frequency of the state without the hyperfine structure or the environment (MHz).

paritystr | bool

The parity $\pi$ of the state is used to check the selection rules. It can be either 'even' ('e', False) or 'odd' ('o', True).

jquant_like

The electronic total angular momentum quantum number $J$.

iquant_like

The nuclear spin quantum number $I$.

fquant_like

The total angular momentum quantum number $F$.

mquant_like

The $z$-projection quantum number $m$ of the total angular momentum f.

lsquant_like | Iterable

A list or a single pair of electronic angular momentum and spin quantum numbers $(l_i, s_i)$. If this is a list of LS-pairs, a list of $j_i$ quantum numbers can be specified for the parameter jj. IMPORTANT: Since $L$ and $S$ are not good quantum numbers, this parameter has no effect, currently.

jjquant_like | Iterable

A list of two electronic total angular momentum quantum numbers $(j_0, j_1)$ used in the jj-coupling scheme if ls is a list. IMPORTANT: Since $j_i$ are not good quantum numbers, this parameter has no effect, currently.

hyper_constarray_like

A list of the hyperfine-structure constants. Currently, constants up to the electric quadrupole order are supported ($A$, $B$). If hyper_const is a scalar, it is assumed to be the constant $A$ and the other orders are 0 (MHz).

gjscalar

The electronic g-factor $g_J$.

giscalar

The nuclear g-factor $g_I$.

labelstr

The label of the state. The label is used to link states via a DecayMap.

instanceqspec.simulate.State | ctypes.LP_c_char

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

API navigation