Struct Power 

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

Power [W = kg·m²/s³].

Implementations

impl Power

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

Create a Power from a value in watts (SI base unit).

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

Create a Power from a value in kilowatts (1 kW = 1000 W).

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

Create a Power from a value in megawatts (1 MW = 1,000,000 W).

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

Create a Power from a value in mechanical horsepower.

Exact definition: 1 hp = 33,000 ft·lbf/min = 37284993579113511/50000000000000 W. Derived from exact SI definitions: 1 ft = 381/1250 m, 1 lb = 45359237/100000000 kg, g_n = 980665/100000 m/s².

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

1 metric horsepower (PS) = 75 kgf·m/s (exact).

impl Power

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

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 Power

type Output = Power

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<&Power> for &Power

type Output = Power

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<&Power> for Power

type Output = Power

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<Power> for &Power

type Output = Power

The resulting type after applying the + operator.

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

Performs the + operation.

impl AsRef<Expr<Numeric>> for Power

fn as_ref(&self) -> &Ex

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

impl Clone for Power

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 Power

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

Formats the value using the given formatter.

impl DiffWrt<Current> for Power

type Output = Voltage

The output quantity type after differentiation.

fn diff_wrt(&self, var: &Current) -> Voltage

Differentiate this quantity with respect to the given variable.

impl DiffWrt<Voltage> for Power

type Output = Current

The output quantity type after differentiation.

fn diff_wrt(&self, var: &Voltage) -> Current

Differentiate this quantity with respect to the given variable.

impl Display for Power

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

Formats the value using the given formatter.

impl Div<i64> for Power

type Output = Power

The resulting type after applying the / operator.

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

Performs the / operation.

impl From<Power> for Qty<PowerDim>

fn from(q: Power) -> Qty<PowerDim>

Converts to this type from the input type.

impl From<Qty<Dim<PInt<UInt<UInt<UTerm, B1>, B0>>, PInt<UInt<UTerm, B1>>, NInt<UInt<UInt<UTerm, B1>, B1>>, Z0, Z0, Z0, Z0>>> for Power

fn from(q: Qty<PowerDim>) -> Power

Converts to this type from the input type.

impl FromDimExpr<Dim<PInt<UInt<UInt<UTerm, B1>, B0>>, PInt<UInt<UTerm, B1>>, NInt<UInt<UInt<UTerm, B1>, B1>>, Z0, Z0, Z0, Z0>> for Power

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

Convert from a generic Qty with the matching dimension.

impl IntWrt<Time> for Power

type Output = Energy

The output quantity type after integration.

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

Integrate this quantity with respect to the given variable.

impl Mul<&Expr<Numeric>> for Power

type Output = Power

The resulting type after applying the * operator.

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

Performs the * operation.

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

type Output = Power

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<&Power> for i64

type Output = Power

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Power> for i64

type Output = Power

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Power> for &Ex

type Output = Power

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<i64> for Power

type Output = Power

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<i64> for &Power

type Output = Power

The resulting type after applying the * operator.

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

Performs the * operation.

impl Neg for Power

type Output = Power

The resulting type after applying the - operator.

fn neg(self) -> Power

Performs the unary - operation.

impl Neg for &Power

type Output = Power

The resulting type after applying the - operator.

fn neg(self) -> Power

Performs the unary - operation.

impl Sub for Power

type Output = Power

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<&Power> for &Power

type Output = Power

The resulting type after applying the - operator.

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

Performs the - operation.