Struct Length 

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

Length [m].

Implementations

impl Length

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

Create a Length from a value in meters (SI base unit).

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

Create a Length from a value in kilometers.

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

Create a Length from a value in centimeters.

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

Create a Length from a value in millimeters.

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

Create a Length from a value in micrometers.

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

Create a Length from a value in inches (1 in = 0.0254 m exactly).

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

Create a Length from a value in feet (1 ft = 0.3048 m exactly).

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

Create a Length from a value in yards (1 yd = 0.9144 m exactly).

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

Create a Length from a value in miles (1 mi = 1609.344 m exactly).

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

1 nautical mile = 1852 m (exact).

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

1 fathom = 2 yards (exact).

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

1 mil = 0.001 inches (exact). Used in PCB design.

impl Length

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<LengthDim>

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 logarithmic identities, preserving dimension.

pub fn log_combine(&self) -> Self

Combine logarithmic terms, 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))

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

Integrate with respect to a variable. Returns raw Ex.

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

Check whether this quantity is provably zero.

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

Check symbolic equality with another quantity of the same type.

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 Length

type Output = Length

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<&Length> for &Length

type Output = Length

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<&Length> for Length

type Output = Length

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<Length> for &Length

type Output = Length

The resulting type after applying the + operator.

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

Performs the + operation.

impl AsRef<Expr<Numeric>> for Length

fn as_ref(&self) -> &Ex

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

impl Clone for Length

fn clone(&self) -> Length

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Length

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

Formats the value using the given formatter.

impl DiffWrt<Angle> for Length

type Output = Length

The output quantity type after differentiation.

fn diff_wrt(&self, var: &Angle) -> Length

Differentiate this quantity with respect to the given variable.

impl DiffWrt<Length> for Energy

type Output = Force

The output quantity type after differentiation.

fn diff_wrt(&self, var: &Length) -> Force

Differentiate this quantity with respect to the given variable.

impl DiffWrt<Length> for Momentum

type Output = Stiffness

The output quantity type after differentiation.

fn diff_wrt(&self, var: &Length) -> Stiffness

Differentiate this quantity with respect to the given variable.

impl DiffWrt<Length> for Force

type Output = Stiffness

The output quantity type after differentiation.

fn diff_wrt(&self, var: &Length) -> Stiffness

Differentiate this quantity with respect to the given variable.

impl DiffWrt<Time> for Length

type Output = Velocity

The output quantity type after differentiation.

fn diff_wrt(&self, var: &Time) -> Velocity

Differentiate this quantity with respect to the given variable.

impl Display for Length

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

Formats the value using the given formatter.

impl Div<i64> for Length

type Output = Length

The resulting type after applying the / operator.

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

Performs the / operation.

impl From<Length> for Qty<LengthDim>

fn from(q: Length) -> Qty<LengthDim>

Converts to this type from the input type.

impl From<Qty<Dim<PInt<UInt<UTerm, B1>>, Z0, Z0, Z0, Z0, Z0, Z0>>> for Length

fn from(q: Qty<LengthDim>) -> Length

Converts to this type from the input type.

impl FromDimExpr<Dim<PInt<UInt<UTerm, B1>>, Z0, Z0, Z0, Z0, Z0, Z0>> for Length

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

Convert from a generic Qty with the matching dimension.

impl IntWrt<Angle> for Length

type Output = Length

The output quantity type after integration.

fn integrate_wrt(&self, var: &Angle) -> Length

Integrate this quantity with respect to the given variable.

impl IntWrt<Length> for Force

type Output = Energy

The output quantity type after integration.

fn integrate_wrt(&self, var: &Length) -> Energy

Integrate this quantity with respect to the given variable.

impl IntWrt<Length> for Stiffness

type Output = Force

The output quantity type after integration.

fn integrate_wrt(&self, var: &Length) -> Force

Integrate this quantity with respect to the given variable.

impl Mul<&Expr<Numeric>> for Length

type Output = Length

The resulting type after applying the * operator.

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

Performs the * operation.

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

type Output = Length

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<&Length> for i64

type Output = Length

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Length> for i64

type Output = Length

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Length> for &Ex

type Output = Length

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<i64> for Length

type Output = Length

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<i64> for &Length

type Output = Length

The resulting type after applying the * operator.

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

Performs the * operation.

impl Neg for Length

type Output = Length

The resulting type after applying the - operator.

fn neg(self) -> Length

Performs the unary - operation.

impl Neg for &Length

type Output = Length

The resulting type after applying the - operator.

fn neg(self) -> Length

Performs the unary - operation.

impl Sub for Length

type Output = Length

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<&Length> for &Length

type Output = Length

The resulting type after applying the - operator.

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

Performs the - operation.