Enum PackedBasis 

pub enum PackedBasis {
    Spin(SpinBasis1D),
    Boson(BosonBasis1D),
    SpinlessFermion(SpinlessFermionBasis1D),
    SpinfulFermion(SpinfulFermionBasis1D),
    GeneralSpin(SpinBasisGeneral),
    GeneralBoson(BosonBasisGeneral),
    GeneralSpinlessFermion(SpinlessFermionBasisGeneral),
    GeneralSpinfulFermion(SpinfulFermionBasisGeneral),
    Tensor(Box<PackedTensorBasis>),
    Photon(Box<PackedPhotonBasis>),
    User(Box<UserBasisGeneral>),
    Reversed(Box<PackedBasis>),
}

Variants

Spin(SpinBasis1D)

Boson(BosonBasis1D)

SpinlessFermion(SpinlessFermionBasis1D)

SpinfulFermion(SpinfulFermionBasis1D)

GeneralSpin(SpinBasisGeneral)

GeneralBoson(BosonBasisGeneral)

GeneralSpinlessFermion(SpinlessFermionBasisGeneral)

GeneralSpinfulFermion(SpinfulFermionBasisGeneral)

Tensor(Box<PackedTensorBasis>)

Photon(Box<PackedPhotonBasis>)

User(Box<UserBasisGeneral>)

Reversed(Box<PackedBasis>)

Implementations

impl PackedBasis

pub fn reversed(self) -> Self

Reverse the public basis-vector order without changing physical states.

This is a general permutation view: state, index, transition row lookup, and universal operator assembly all observe the same order.

pub fn additive_quantum_number(&self, state: u128) -> Result<usize>

Additive occupation/excitation quantum number of a concrete state.

This is the runtime-selected counterpart of the typed sector metadata used by concrete bases. Composite bases sum their factor quantum numbers, so consumers such as PackedPhotonBasis do not need to special-case spin, boson, or fermion encodings.

Trait Implementations

impl Basis for PackedBasis

type State = u128

Integer-like state representation used by this basis.

fn len(&self) -> usize

Return the number of vectors in the basis.

fn state(&self, index: usize) -> Result<Self::State>

Return the encoded state at a basis index.

fn index(&self, state: Self::State) -> Result<usize>

Locate an encoded state in the basis.

fn apply_local( &self, state: Self::State, operator: &str, sites: &[usize], ) -> Result<Option<(Self::State, Complex64)>>

Apply one local operator string to one encoded state.

fn apply_local_transitions( &self, state: Self::State, operator: &str, sites: &[usize], ) -> Result<LocalTransitions<Self::State>>

Applies a local operator and returns every nonzero destination.

fn apply_local_unreduced_transitions( &self, state: Self::State, operator: &str, sites: &[usize], ) -> Result<LocalTransitions<Self::State>>

Local action before symmetry-sector reduction. Cross-sector builders use this path and let the target basis perform the reduction.

fn visit_local_unreduced_transitions<F>( &self, state: Self::State, operator: &str, sites: &[usize], visit: F, ) -> Result<()>

where Self: Sized, F: FnMut(Self::State, Complex64) -> Result<()>,

Streams unreduced destinations directly to a consumer.

fn transition_orbit_size(&self, state: Self::State) -> Result<usize>

Orbit size of a canonical source state used in projector normalization.

fn reduction_image( &self, state: Self::State, ) -> Result<Option<ReductionImage<Self::State>>>

Return the canonical reduction metadata for a physical state.

fn reduce_transition( &self, state: Self::State, source_orbit_size: usize, ) -> Result<Option<(Self::State, Complex64)>>

Map an unreduced physical target state into this basis.

fn index_transition( &self, state: Self::State, source_orbit_size: usize, ) -> Result<Option<(usize, Complex64)>>

Reduces a physical target and locates its row in one operation.

fn operator_preserves_particle_sector(&self, operator: &str) -> Result<bool>

Whether a local operator string preserves the particle-sector constraints represented by this basis. Unconstrained and custom bases accept every syntactically valid string by default.

fn operator_preserves_particle_sector_on_sites( &self, operator: &str, sites: &[usize], ) -> Result<bool>

Site-aware particle-sector check for bases whose local labels encode species as well as position.

fn is_empty(&self) -> bool

Return whether the basis contains no vectors.

impl Clone for PackedBasis

fn clone(&self) -> PackedBasis

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PackedBasis

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<BosonBasis1D> for PackedBasis

fn from(basis: BosonBasis1D) -> Self

Converts to this type from the input type.

impl From<GeneralBasis<BosonBasis1D>> for PackedBasis

fn from(basis: BosonBasisGeneral) -> Self

Converts to this type from the input type.

impl From<GeneralBasis<SpinBasis1D>> for PackedBasis

fn from(basis: SpinBasisGeneral) -> Self

Converts to this type from the input type.

impl From<GeneralBasis<SpinfulFermionBasis1D>> for PackedBasis

fn from(basis: SpinfulFermionBasisGeneral) -> Self

Converts to this type from the input type.

impl From<GeneralBasis<SpinlessFermionBasis1D>> for PackedBasis

fn from(basis: SpinlessFermionBasisGeneral) -> Self

Converts to this type from the input type.

impl From<GeneralBasis<UserBasis<u128>>> for PackedBasis

fn from(basis: UserBasisGeneral) -> Self

Converts to this type from the input type.

impl From<PackedPhotonBasis> for PackedBasis

fn from(basis: PackedPhotonBasis) -> Self

Converts to this type from the input type.

impl From<PackedTensorBasis> for PackedBasis

fn from(basis: PackedTensorBasis) -> Self

Converts to this type from the input type.

impl From<SpinBasis1D> for PackedBasis

fn from(basis: SpinBasis1D) -> Self

Converts to this type from the input type.

impl From<SpinfulFermionBasis1D> for PackedBasis

fn from(basis: SpinfulFermionBasis1D) -> Self

Converts to this type from the input type.

impl From<SpinlessFermionBasis1D> for PackedBasis

fn from(basis: SpinlessFermionBasis1D) -> Self

Converts to this type from the input type.