Struct Dimensionless 

pub struct Dimensionless(/* private fields */);

Dimensionless quantity (ratios, pure numbers).

Implementations

impl Dimensionless

pub fn percent(val: &Ex) -> Self

Create a Dimensionless quantity from a value in percent (1% = 0.01).

pub fn per_mille(val: &Ex) -> Self

Create a Dimensionless quantity from a value in parts per thousand (‰).

impl Dimensionless

pub fn from_ex(ex: impl IntoEx) -> Self

Create from a symbolic expression (or anything that implements IntoEx).

pub fn checked_from_ex(ex: impl IntoEx, dims: &DimMap) -> Result<Self, String>

Create from a symbolic expression with runtime dimension validation.

Checks that the expression’s inferred dimension matches this type’s dimension using the provided DimMap. Returns an error if the dimensions don’t match.

Use this instead of from_ex when you want runtime validation of dimensional correctness (e.g., in tests or debug builds).

pub fn symbol(ctx: &Context, name: &str) -> Self

Create a named symbolic variable with this dimension.

pub fn constant(ctx: &Context, val: i64) -> Self

Create from an integer constant.

pub fn rational(ctx: &Context, p: i64, q: i64) -> Self

Create from a rational constant.

pub fn zero(ctx: &Context) -> Self

Zero value.

pub fn into_inner(self) -> Ex

Escape hatch: drop dimension, return raw Ex.

pub fn inner(&self) -> &Ex

Borrow the inner Ex.

pub fn as_qty(self) -> Qty<DimensionlessDim>

Convert to generic Qty<D>.

pub fn dim_name_str() -> &'static str

Runtime dimension name.

pub fn dim_symbol_str() -> &'static str

Runtime dimension symbol.

pub fn simplify(&self) -> Self

Apply simplify, preserving dimension.

pub fn expand(&self) -> Self

Apply expand, preserving dimension.

pub fn eval(&self) -> Self

Apply eval, preserving dimension.

pub fn subs(&self, var: &impl AsRef<Ex>, val: &impl AsRef<Ex>) -> Self

Substitute a variable.

pub fn simplify_full(&self) -> Self

Full multi-pass simplification, preserving dimension.

pub fn simplify_trig(&self) -> Self

Trigonometric simplification, preserving dimension.

pub fn simplify_powers(&self) -> Self

Power/exponent simplification, preserving dimension.

pub fn simplify_rational(&self) -> Self

Rational simplification, preserving dimension.

pub fn expand_trig(&self) -> Self

Expand trigonometric identities, preserving dimension.

pub fn expand_log(&self) -> Self

Expand logarithms where the identities hold (Ex::expand_log), preserving dimension.

pub fn log_combine(&self) -> Self

Combine logarithms where the identities hold (Ex::log_combine), preserving dimension.

pub fn trig_combine(&self) -> Self

Combine trigonometric terms, preserving dimension.

pub fn factor(&self, var: &impl AsRef<Ex>) -> Self

Factor with respect to a variable, preserving dimension.

pub fn collect(&self, var: &impl AsRef<Ex>) -> Self

Collect terms with respect to a variable, preserving dimension.

pub fn cancel(&self, var: &Ex) -> Self

Cancel common factors, preserving dimension.

pub fn together(&self) -> Self

Combine fractions over a common denominator, preserving dimension.

pub fn partial_fractions(&self, var: &impl AsRef<Ex>) -> Self

Partial-fraction decomposition with respect to a variable, preserving dimension.

pub fn rationalize_denom(&self) -> Self

Rationalize the denominator, preserving dimension.

pub fn diff(&self, var: &impl AsRef<Ex>) -> Ex

Differentiate with respect to a variable. Returns raw Ex. Wrap result in the correct output type: Acceleration::from_ex(v.diff(&t)). A converted variable (Time::minutes(τ)) is handled by the chain rule.

pub fn integrate(&self, var: &impl AsRef<Ex>) -> Ex

Integrate with respect to a variable. Returns raw Ex. A converted variable is integrated by substitution.

pub fn to_latex(&self) -> String

Render as LaTeX string.

pub fn free_symbols(&self) -> Vec<Ex>

Free symbols in the expression.

pub fn contains(&self, other: &impl AsRef<Ex>) -> bool

Whether the expression contains a given sub-expression.

pub fn term_count(&self) -> usize

Number of top-level additive terms.

pub fn count_ops(&self) -> usize

Count of internal operations.

pub fn is_zero(&self) -> bool

Is this quantity proved zero? false means “not proved”: it may still be zero. try_is_zero gives the three-valued answer.

pub fn try_is_zero(&self) -> Option<bool>

Is this quantity zero? Some(true) proved zero, Some(false) proved nonzero, None undecided (Ex::is_zero).

pub fn equals(&self, other: &Self) -> bool

Is this quantity proved equal to other? false means “not proved”: the two may still be equal. try_equals gives the three-valued answer.

pub fn try_equals(&self, other: &Self) -> Option<bool>

Is this quantity equal to other? Some(true) proved equal, Some(false) proved different, None undecided (Ex::equals).

pub fn eval_f64(&self) -> Result<f64, SymplexError>

Evaluate to f64.

pub fn eval_f64_with(&self, subs: &[(&Ex, i64)]) -> Result<f64, SymplexError>

Substitute integer values and evaluate to f64.

pub fn eval_decimal(&self, digits: u32) -> Result<String, SymplexError>

Evaluate to a decimal string with the given number of digits.

Trait Implementations

impl Add for Dimensionless

type Output = Dimensionless

The resulting type after applying the + operator.

fn add(self, rhs: Dimensionless) -> Dimensionless

Performs the + operation.

impl Add<&Dimensionless> for &Dimensionless

type Output = Dimensionless

The resulting type after applying the + operator.

fn add(self, rhs: &Dimensionless) -> Dimensionless

Performs the + operation.

impl Add<&Dimensionless> for Dimensionless

type Output = Dimensionless

The resulting type after applying the + operator.

fn add(self, rhs: &Dimensionless) -> Dimensionless

Performs the + operation.

impl Add<Dimensionless> for &Dimensionless

type Output = Dimensionless

The resulting type after applying the + operator.

fn add(self, rhs: Dimensionless) -> Dimensionless

Performs the + operation.

impl AsRef<Expr<Numeric>> for Dimensionless

fn as_ref(&self) -> &Ex

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for Dimensionless

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Dimensionless

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

Formats the value using the given formatter.

impl Display for Dimensionless

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

Formats the value using the given formatter.

impl Div<i64> for Dimensionless

type Output = Dimensionless

The resulting type after applying the / operator.

fn div(self, rhs: i64) -> Dimensionless

Performs the / operation.

impl From<Dimensionless> for Qty<DimensionlessDim>

fn from(q: Dimensionless) -> Qty<DimensionlessDim>

Converts to this type from the input type.

impl From<Qty<Dim<Z0, Z0, Z0, Z0, Z0, Z0, Z0>>> for Dimensionless

fn from(q: Qty<DimensionlessDim>) -> Dimensionless

Converts to this type from the input type.

impl FromDimExpr<Dim<Z0, Z0, Z0, Z0, Z0, Z0, Z0>> for Dimensionless

fn from_dim_expr(qty: Qty<DimensionlessDim>) -> Self

Convert from a generic Qty with the matching dimension.

impl Mul<&Dimensionless> for i64

type Output = Dimensionless

The resulting type after applying the * operator.

fn mul(self, rhs: &Dimensionless) -> Dimensionless

Performs the * operation.

impl Mul<&Expr<Numeric>> for Dimensionless

type Output = Dimensionless

The resulting type after applying the * operator.

fn mul(self, rhs: &Ex) -> Dimensionless

Performs the * operation.

impl Mul<&Expr<Numeric>> for &Dimensionless

type Output = Dimensionless

The resulting type after applying the * operator.

fn mul(self, rhs: &Ex) -> Dimensionless

Performs the * operation.

impl Mul<Dimensionless> for i64

type Output = Dimensionless

The resulting type after applying the * operator.

fn mul(self, rhs: Dimensionless) -> Dimensionless

Performs the * operation.

impl Mul<Dimensionless> for &Ex

type Output = Dimensionless

The resulting type after applying the * operator.

fn mul(self, rhs: Dimensionless) -> Dimensionless

Performs the * operation.

impl Mul<i64> for Dimensionless

type Output = Dimensionless

The resulting type after applying the * operator.

fn mul(self, rhs: i64) -> Dimensionless

Performs the * operation.

impl Mul<i64> for &Dimensionless

type Output = Dimensionless

The resulting type after applying the * operator.

fn mul(self, rhs: i64) -> Dimensionless

Performs the * operation.

impl Neg for Dimensionless

type Output = Dimensionless

The resulting type after applying the - operator.

fn neg(self) -> Dimensionless

Performs the unary - operation.

impl Neg for &Dimensionless

type Output = Dimensionless

The resulting type after applying the - operator.

fn neg(self) -> Dimensionless

Performs the unary - operation.

impl Sub for Dimensionless

type Output = Dimensionless

The resulting type after applying the - operator.

fn sub(self, rhs: Dimensionless) -> Dimensionless

Performs the - operation.

impl Sub<&Dimensionless> for &Dimensionless

type Output = Dimensionless

The resulting type after applying the - operator.

fn sub(self, rhs: &Dimensionless) -> Dimensionless

Performs the - operation.