Struct HilbertState 

pub struct HilbertState { /* private fields */ }

A strong type representing a Quantum State Vector (Ket) |ψ>.

This represents a Minimal Left Ideal of the algebra Cl(10) (or others), acting as the Hilbert Space.

Invariants

• The coefficients are always Complex<f64>.
• The Metric is fixed at construction time (preventing mixed-algebra operations).

Implementations

impl HilbertState

pub fn new_spin10( data: Vec<Complex<f64>>, ) -> Result<Self, CausalMultiVectorError>

Creates a new Hilbert State for the Grand Unified Algebra (Spin(10)). This enforces the metric Cl(10) (NonEuclidean, 10D).

pub fn new( data: Vec<Complex<f64>>, metric: Metric, ) -> Result<Self, CausalMultiVectorError>

Generic constructor for other quantum systems (e.g. Qubits / Cl(2)).

pub fn new_unchecked(data: Vec<Complex<f64>>, metric: Metric) -> Self

pub fn from_multivector(mv: CausalMultiVector<Complex<f64>>) -> Self

pub fn into_inner(self) -> CausalMultiVector<Complex<f64>>

Unwraps the state to access the underlying algebraic object. Useful when you need to perform raw geometric operations.

pub fn as_inner(&self) -> &CausalMultiVector<Complex<f64>>

Borrows the underlying algebraic object.

pub fn mv(&self) -> &CausalMultiVector<Complex<f64>>

Trait Implementations

impl Add for HilbertState

type Output = HilbertState

The resulting type after applying the + operator.

fn add(self, rhs: Self) -> Self::Output

Performs the + operation.

impl Clone for HilbertState

fn clone(&self) -> HilbertState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HilbertState

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

Formats the value using the given formatter.

impl Default for HilbertState

fn default() -> Self

Returns the “default value” for a type.

impl Display for HilbertState

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

Formats the value using the given formatter.

impl Mul<Complex<f64>> for HilbertState

type Output = HilbertState

The resulting type after applying the * operator.

fn mul(self, rhs: Complex<f64>) -> Self::Output

Performs the * operation.

impl PartialEq for HilbertState

fn eq(&self, other: &HilbertState) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl TryFrom<&HilbertState> for HopfState

Conversion: Quantum State (Spinor) -> Topological Rotor (Hopf).

Maps a 2-level Quantum System (Qubit) into the geometry of the 3-Sphere. $\psi = \alpha|0\rangle + \beta|1\rangle \to R \in S^3$.

This allows you to calculate the “Hopf Invariant” or “Berry Phase” of a quantum state.

type Error = CausalMultiVectorError

The type returned in the event of a conversion error.

fn try_from(quantum_state: &HilbertState) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<HopfState> for HilbertState

Conversion: Topological Rotor (Hopf) -> Quantum State (Spinor).

Maps a geometric orientation back into Quantum Hilbert Space. Useful for initializing a Qubit based on a geometric rotation.

type Error = CausalMultiVectorError

The type returned in the event of a conversion error.

fn try_from(hopf: HopfState) -> Result<Self, Self::Error>

Performs the conversion.

impl StructuralPartialEq for HilbertState