Struct LatticeSymmetryMap 

pub struct LatticeSymmetryMap { /* private fields */ }

Runtime-owned finite symmetry of a packed lattice state.

destinations[source] gives the target site. Each source site also owns a permutation of its local digits, allowing the same representation to cover translations, reflections, sublattice maps, and local spin inversion. Fermionic maps compute the parity of the originally occupied-orbital permutation instead of requiring a frontend-provided phase callback. Binary local permutations may also exchange empty and occupied digits. Such particle-hole flips change the mapped occupation but introduce no additional Fock-state phase; the orbital reordering alone fixes the sign.

Implementations

impl LatticeSymmetryMap

pub fn new( states_per_site: usize, destinations: impl Into<Vec<usize>>, local_permutations: Option<Vec<Vec<usize>>>, statistics: ExchangeStatistics, ) -> Result<Self>

pub fn site_permutation( states_per_site: usize, destinations: impl Into<Vec<usize>>, ) -> Result<Self>

pub fn fermionic_orbital_permutation( destinations: impl Into<Vec<usize>>, ) -> Result<Self>

pub fn sites(&self) -> usize

pub const fn states_per_site(&self) -> usize

pub fn destinations(&self) -> &[usize]

pub fn local_permutations(&self) -> &[Vec<usize>]

pub const fn statistics(&self) -> ExchangeStatistics

pub const fn period(&self) -> usize

Trait Implementations

impl Clone for LatticeSymmetryMap

fn clone(&self) -> LatticeSymmetryMap

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LatticeSymmetryMap

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

Formats the value using the given formatter.

impl SymmetryMap<ErasedState> for LatticeSymmetryMap

fn period(&self) -> usize

fn apply(&self, state: ErasedState) -> Result<(ErasedState, Complex64)>

impl<const WORDS: usize> SymmetryMap<WideState<WORDS>> for LatticeSymmetryMap

fn period(&self) -> usize

fn apply( &self, state: WideState<WORDS>, ) -> Result<(WideState<WORDS>, Complex64)>

impl SymmetryMap<u128> for LatticeSymmetryMap

fn period(&self) -> usize

fn apply(&self, state: u128) -> Result<(u128, Complex64)>