Enum WidePackedBasis 

pub enum WidePackedBasis {
    Spin256(WideSpinBasis256),
    Spin1024(WideSpinBasis1024),
    Spin4096(WideSpinBasis4096),
    Spin16384(WideSpinBasis16384),
    GeneralSpin256(WideSpinBasisGeneral256),
    GeneralSpin1024(WideSpinBasisGeneral1024),
    GeneralSpin4096(WideSpinBasisGeneral4096),
    GeneralSpin16384(WideSpinBasisGeneral16384),
    Reversed(Box<WidePackedBasis>),
}

Runtime-selected wide spin basis used by persistent language-neutral models.

The enum erases only the fixed-width state storage. Local operator semantics, symmetry reduction, and universal assembly remain implemented by the same typed WideSpinBasis and GeneralBasis kernels used by native Rust callers.

Variants

Spin256(WideSpinBasis256)

Spin1024(WideSpinBasis1024)

Spin4096(WideSpinBasis4096)

Spin16384(WideSpinBasis16384)

GeneralSpin256(WideSpinBasisGeneral256)

GeneralSpin1024(WideSpinBasisGeneral1024)

GeneralSpin4096(WideSpinBasisGeneral4096)

GeneralSpin16384(WideSpinBasisGeneral16384)

Reversed(Box<WidePackedBasis>)

Implementations

impl WidePackedBasis

pub fn reversed(self) -> Self

pub fn explicit_spin_subspace(&self, states: &[ErasedState]) -> Result<Self>

Reuse this runtime-selected spin algebra on an explicitly selected set of physical states while preserving its public ordering convention.

pub fn width_bits(&self) -> usize

pub fn storage(&self) -> StateStorage

Trait Implementations

impl Basis for WidePackedBasis

type State = ErasedState

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 F: FnMut(Self::State, Complex64) -> Result<()>,

Streams unreduced destinations directly to a consumer.

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

Return the canonical reduction metadata for a physical state.

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

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

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 WidePackedBasis

fn clone(&self) -> WidePackedBasis

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WidePackedBasis

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

Formats the value using the given formatter.

impl From<GeneralBasis<WideSpinBasis<16>>> for WidePackedBasis

fn from(basis: WideSpinBasisGeneral1024) -> Self

Converts to this type from the input type.

impl From<GeneralBasis<WideSpinBasis<256>>> for WidePackedBasis

fn from(basis: WideSpinBasisGeneral16384) -> Self

Converts to this type from the input type.

impl From<GeneralBasis<WideSpinBasis<4>>> for WidePackedBasis

fn from(basis: WideSpinBasisGeneral256) -> Self

Converts to this type from the input type.

impl From<GeneralBasis<WideSpinBasis<64>>> for WidePackedBasis

fn from(basis: WideSpinBasisGeneral4096) -> Self

Converts to this type from the input type.

impl From<WideSpinBasis<16>> for WidePackedBasis

fn from(basis: WideSpinBasis1024) -> Self

Converts to this type from the input type.

impl From<WideSpinBasis<256>> for WidePackedBasis

fn from(basis: WideSpinBasis16384) -> Self

Converts to this type from the input type.

impl From<WideSpinBasis<4>> for WidePackedBasis

fn from(basis: WideSpinBasis256) -> Self

Converts to this type from the input type.

impl From<WideSpinBasis<64>> for WidePackedBasis

fn from(basis: WideSpinBasis4096) -> Self

Converts to this type from the input type.