Struct Operator 

pub struct Operator { /* private fields */ }

Concrete operator returned by universal assembly.

Implementations

impl Operator

pub fn from_dense( rows: usize, columns: usize, values_row_major: Vec<Complex64>, ) -> Result<Self>

Construct a row-major dense rectangular operator.

pub fn from_triplets( rows: usize, columns: usize, triplets: impl IntoIterator<Item = (usize, usize, Complex64)>, format: MatrixFormat, ) -> Result<Self>

Construct an operator from zero-based (row, column, value) entries.

Duplicate coordinates are summed, exact numerical zeros are discarded, and the result is canonicalized for format.

pub fn to_dense(&self) -> Vec<Complex64>

Materialize a row-major dense copy of this operator.

pub fn conjugated(&self) -> Result<Self>

Return an elementwise complex-conjugated operator.

pub fn right_apply(&self, input: &[Complex64]) -> Result<Vec<Complex64>>

Row-vector action inputᵀ A without conjugating the input.

pub fn memory_bytes(&self) -> usize

Estimate bytes owned by the current materialized representation.

pub fn nnz(&self) -> usize

Count stored mathematical nonzeros.

pub fn triplets(&self) -> Vec<(usize, usize, Complex64)>

Canonical nonzero (row, column, value) entries without dense materialization.

pub fn converted(&self, format: MatrixFormat) -> Result<Self>

Convert the operator without changing its numerical values.

pub fn diagonal(&self) -> Vec<Complex64>

pub fn trace(&self) -> Result<Complex64>

pub fn scaled(&self, coefficient: impl Into<Complex64>) -> Result<Self>

pub fn add(&self, right: &Self) -> Result<Self>

pub fn subtract(&self, right: &Self) -> Result<Self>

pub fn product(&self, right: &Self) -> Result<Self>

Matrix product self * right.

pub fn projected_by(&self, projector: &Self) -> Result<Self>

Project a square operator into the column space of projector.

For a projector-like rectangular matrix P with shape (N, M), this returns P† self P with shape (M, M). The operation intentionally accepts any rectangular linear map; callers that require an isometry may validate P†P = I separately.

pub fn pow(&self, exponent: u32) -> Result<Self>

pub fn adjoint(&self) -> Result<Self>

pub fn transpose(&self) -> Result<Self>

pub fn rotated(&self, unitary: &Self, tolerance: f64) -> Result<Self>

Similarity rotation U† A U after validating unitarity.

pub fn is_hermitian(&self, tolerance: f64) -> bool

Trait Implementations

impl Clone for Operator

fn clone(&self) -> Operator

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Operator

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

Formats the value using the given formatter.

impl LinearOperator for Operator

fn shape(&self) -> (usize, usize)

Return (rows, columns).

fn format(&self) -> MatrixFormat

Report the public materialization format.

fn is_real(&self) -> bool

Whether this operator preserves real vectors exactly.

fn apply_real(&self, input: &[f64], output: &mut [f64]) -> Result<()>

Apply this operator to a real vector.

fn apply(&self, input: &[Complex64], output: &mut [Complex64]) -> Result<()>

Compute output = A * input.

fn stored_triplets(&self) -> Result<Option<Vec<(usize, usize, Complex64)>>>

Return canonical stored nonzeros when the representation already owns them.

fn shifted_solver( &self, shift: f64, ) -> Result<Option<Box<dyn ShiftedLinearSolver>>>

Prepare a reusable solver for (A - shift I) x = b, when supported.

fn apply_transpose( &self, input: &[Complex64], output: &mut [Complex64], ) -> Result<()>

Apply the algebraic transpose without conjugating either operand.

fn apply_adjoint( &self, input: &[Complex64], output: &mut [Complex64], ) -> Result<()>

Apply the conjugate transpose.