Struct WideSpinBasis 

pub struct WideSpinBasis<const WORDS: usize> { /* private fields */ }

Spin-half basis backed by a fixed-width state, including sites above 127.

Implementations

impl<const WORDS: usize> WideSpinBasis<WORDS>

pub fn new(sites: usize, particles: Option<usize>, pauli: bool) -> Result<Self>

pub fn from_particle_sectors( sites: usize, sectors: impl IntoIterator<Item = usize>, pauli: bool, ) -> Result<Self>

Construct a wide basis from a nonempty union of fixed-particle sectors.

pub fn with_normalization( sites: usize, particles: Option<usize>, normalization: SpinNormalization, ) -> Result<Self>

pub fn from_particle_sectors_with_normalization( sites: usize, sectors: impl IntoIterator<Item = usize>, normalization: SpinNormalization, ) -> Result<Self>

pub fn from_explicit_states_with_normalization( sites: usize, states: impl IntoIterator<Item = WideState<WORDS>>, normalization: SpinNormalization, ) -> Result<Self>

Construct the same spin algebra on an explicitly selected physical state set.

This is useful for finite-group orbit completions whose physical span is enumerable even when the unrestricted 2^sites parent is not. The selected states remain an ordinary basis: local actions leaving the set are rejected by assembly in exactly the same way as any sector basis.

pub const fn sites(&self) -> usize

pub fn particles(&self) -> Option<usize>

pub fn particle_sectors(&self) -> Option<&[usize]>

pub const fn normalization(&self) -> SpinNormalization

Trait Implementations

impl<const WORDS: usize> Basis for WideSpinBasis<WORDS>

type State = WideState<WORDS>

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 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 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_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<const WORDS: usize> Clone for WideSpinBasis<WORDS>

fn clone(&self) -> WideSpinBasis<WORDS>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<const WORDS: usize> Debug for WideSpinBasis<WORDS>

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

Formats the value using the given formatter.

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.