quchip.engine.basis

Local energy-basis resolution and explicit transformation records.

Functions

resolve_device_basis(device, *, basis[, levels])

Resolve a device from its exact authored static Hamiltonian.

resolve_local_basis(hamiltonian, *[, basis, ...])

Resolve one fixed local solver basis from a static authored Hamiltonian.

semantic_to_solver_transform(device, record)

Map semantic local levels into the resolved solver basis when needed.

Classes

BasisRecord(kind, vectors, energies, ...)

One device's fixed authored-to-solver transformation.
class quchip.engine.basis.BasisRecord(kind, vectors, energies, energy_vectors, native_dim, resolved_dim)[source]

Bases: object

One device’s fixed authored-to-solver transformation.

Parameters:

  • kind (Literal['native', 'eigen'])

  • vectors (Any)

  • energies (Any)

  • energy_vectors (Any)

  • native_dim (int)

  • resolved_dim (int)

kind: Literal['native', 'eigen']
vectors: Any
energies: Any
energy_vectors: Any
native_dim: int
resolved_dim: int
property projector: Any

Projector onto the retained authored subspace.

transform_operator(operator)[source]

Apply the recorded authored-to-solver transformation to an operator.

Parameters:

operator (Any)

Return type:

Any

level_operator()[source]

Return the energy-level index operator in the resolved solver basis.

Return type:

Any

quchip.engine.basis.resolve_local_basis(hamiltonian, *, basis='native', levels=None)[source]

Resolve one fixed local solver basis from a static authored Hamiltonian.

Parameters:

  • hamiltonian (Any)

  • basis (Literal['native', 'eigen'])

  • levels (int | None)

Return type:

BasisRecord

quchip.engine.basis.resolve_device_basis(device, *, basis, levels=None)[source]

Resolve a device from its exact authored static Hamiltonian.

Parameters:

  • device (Any)

  • basis (Literal['native', 'eigen'])

  • levels (int | None)

Return type:

BasisRecord

quchip.engine.basis.semantic_to_solver_transform(device, record)[source]

Map semantic local levels into the resolved solver basis when needed.

Fock devices label authored occupation states. Other local spaces label energy-ordered states. None means those labels already coincide with solver indices, allowing sparse band decomposition to stay sparse.

Parameters:
Return type:

Any | None