Struct PackedPhotonBasis 

pub struct PackedPhotonBasis { /* private fields */ }

Runtime-erased matter basis tensored with one truncated photon mode.

Public states are rows in the unfiltered direct product, with the matter row as the major index and photon occupation as the minor index. Keeping these identifiers unchanged when a fixed-total-excitation filter is applied lets BasisProjector connect the filtered and full spaces without a photon-specific projection path.

Implementations

impl PackedPhotonBasis

pub fn new( matter: PackedBasis, photon_cutoff: usize, total_excitations: Option<usize>, ) -> Result<Self>

Construct a matter-photon product with photon occupations 0..=photon_cutoff, optionally filtered by a total additive quantum number.

pub fn matter(&self) -> &PackedBasis

pub const fn photon(&self) -> &BosonBasis1D

pub const fn photon_dimension(&self) -> usize

pub const fn full_dimension(&self) -> usize

pub const fn total_excitations(&self) -> Option<usize>

Trait Implementations

impl Basis for PackedPhotonBasis

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 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 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 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 Clone for PackedPhotonBasis

fn clone(&self) -> PackedPhotonBasis

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PackedPhotonBasis

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

Formats the value using the given formatter.

impl From<PackedPhotonBasis> for PackedBasis

fn from(basis: PackedPhotonBasis) -> Self

Converts to this type from the input type.