pmm_tools.models.parity_qubit_microscopic

Exact many-body model for two Kitaev chains coupled through one dot.

The Fock basis is ordered as (L_1, ..., L_N, M, R_1, ..., R_N). Hamiltonians are assembled by [second_quantization][second_quantization] and restricted to a fixed total fermion-parity block before numerical evaluation.

Functions

Name	Description
basis_indices	Return device Fock-basis indices belonging to one total parity.
clean_product_state	Return a clean dot-empty logical product state.
device_matrix_dict	Symbolic coefficients mapped to sparse device matrices.
device_operators	Return (real-parameter coefficient matrices, physical +/-1 parity).
parameter_names	Return the parameter names for a chain--dot--chain device.

basis_indicesfunction#

View source

def basis_indices(n_sites: int, parity: str = 'even') -> np.ndarray

Return device Fock-basis indices belonging to one total parity.

Parameters

Name	Type	Default	Description
n_sites	int	required	Number of sites in each chain. The device has 2 * n_sites + 1 fermionic modes including the middle dot.
parity	str	'even'	Total fermion-parity sector, "even" or "odd".

Returns

np.ndarray

Indices into the full occupation basis.

clean_product_statefunction#

View source

def clean_product_state(n_sites: int, parameters: Mapping[str, float], label: str = 'ee') -> np.ndarray

Return a clean dot-empty logical product state.

Parameters

Name	Type	Default	Description
n_sites	int	required	Number of sites in each chain.
parameters	Mapping[str, float]	required	Complete device parameter mapping. Each isolated chain is evaluated with its corresponding onsite, hopping, pairing, and phase values.
label	str	'ee'	Left/right chain parities: "ee", "eo", "oe", or "oo".

Returns

np.ndarray

Normalized product of the two isolated-chain ground states and the empty-dot state, restricted to the matching total-parity block.

device_matrix_dictfunctioncached#

View source

def device_matrix_dict(n_sites: int, parity: str | None = 'even')

Symbolic coefficients mapped to sparse device matrices.

Select physical parity "even" or "odd", or None for the full Fock basis. Phases remain symbolic; energies use one caller-chosen unit.

device_operatorsfunction#

View source

def device_operators(n_sites=2, *, phi_R=0.0)

Return (real-parameter coefficient matrices, physical +/-1 parity).

Full dense Fock ordering is (L1,...,LN,M,R1,...,RN), L1 most significant. Matrix coefficients can be complex at nonzero fixed phi_R; controls are real.

parameter_namesfunction#

View source

def parameter_names(n_sites: int) -> tuple[str, ...]

Return the parameter names for a chain--dot--chain device.

Parameters

Name	Type	Description
n_sites	int	Number of sites in each Kitaev chain.

Returns

tuple of str

Names of all onsite, hopping, pairing, phase, and dot-link parameters.