qspec.simulate.gen_hyperfine_state  (  freq_0 = 0.0 ,  j = 0 ,  i = 0 ,  f = 0 ,  parity = None ,  hyper_const = None ,  ls = (0, 0) ,  jj = None ,  gj = None ,  gi = 0 ,  label = None  )[source]

Creates all substates of a hyperfine-structure state using a common label.

Parameters:

freq_0quant_like

The energetic position of the state without the hyperfine structure or the magnetic field (MHz).

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$.

paritybool

The parity $\pi$ of the state. Can be either 'even' (False) or 'odd' (True).

hyper_constIterable[array_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).

lsquant_like

A list or a single pair of electronic angular momentum and spin quantum numbers $(l_i, s_i)$ used to calculate the electronic g-factor in the LS-coupling scheme. If this is a list of LS-pairs, A list of $j_i$ quantum numbers needs to specified for the parameter jj. It is overwritten if gj is specified.

jjquant_like

A list of two electronic total angular momentum quantum numbers $(j_0, j_1)$ used to calculate the electronic g-factor in the jj-coupling scheme. Either a list of two $(l_i, s_i)$ pairs needs to be specified for the parameter ls or a list of g-factors $g_{j_i}$ for the parameter gj. The parameter gj overwrites ls. If gj is a single scalar value, it also overwrites jj.

gjarray_like

A list of two $g_{j_i}$ or a single electronic g-factor $g_J$. If gj is a list, jj is required and ls is overwritten. If gj is a scalar, both ls and jj are overwritten.

giarray_like

The nuclear g-factor $g_I$.

labelstr

The label of the states. The labels are used to link states via a DecayMap.

Returns:

(list[State], )list[qspec.simulate._simulate_cpp.State]

A list of the created states.