Skip to main content

Expr

Enum Expr 

Source
pub enum Expr {
Show 14 variants Const(f64), Var(usize), Binary(BinOp, Box<Expr>, Box<Expr>), Unary(UnaryOp, Box<Expr>), Sum(Vec<Expr>), Cse(Rc<Expr>), Funcall { id: usize, args: Vec<FuncallArg>, }, Compare(CmpOp, Box<Expr>, Box<Expr>), And(Box<Expr>, Box<Expr>), Or(Box<Expr>, Box<Expr>), Not(Box<Expr>), Cond { cond: Box<Expr>, then_: Box<Expr>, else_: Box<Expr>, }, MinList(Vec<Expr>), MaxList(Vec<Expr>),
}

Variants§

§

Const(f64)

Numeric constant.

§

Var(usize)

Variable reference (0-based index into x).

§

Binary(BinOp, Box<Expr>, Box<Expr>)

Binary op: args = [lhs, rhs].

§

Unary(UnaryOp, Box<Expr>)

Unary op.

§

Sum(Vec<Expr>)

n-ary sum (opcode o54 — variadic; we may emit it from o0 folding optimization, but the parser treats o0 as binary).

§

Cse(Rc<Expr>)

Reference to a common subexpression (.nl V segment). The payload is a shared body; many references to the same CSE share one Rc, so the parsed problem is a DAG. Walking through Cse is mathematically equivalent to inlining the body at each occurrence (every reference is an independent occurrence in the chain rule), so eval/grad/collect_vars just recurse into the inner Expr.

§

Funcall

AMPL imported (external) function call. id matches an entry in NlProblem.imported_funcs; resolution to a live shared library happens when the tape is built (see nl_external::ExternalResolver).

Fields

§

Compare(CmpOp, Box<Expr>, Box<Expr>)

Relational comparison (o22/o23/o24/o28/o29/o30). Evaluates to 1.0 when the comparison holds, else 0.0. The result is piecewise-constant, so it has zero derivative everywhere (the kink at equality is ignored — standard subgradient-free treatment, matching ASL).

§

And(Box<Expr>, Box<Expr>)

Logical AND (o21). 1.0 iff both operands are nonzero. Zero derivative (piecewise constant).

§

Or(Box<Expr>, Box<Expr>)

Logical OR (o20). 1.0 iff either operand is nonzero. Zero derivative (piecewise constant).

§

Not(Box<Expr>)

Logical NOT (o34). 1.0 iff the operand is zero. Zero derivative (piecewise constant).

§

Cond

if-then-else (o35 OPIFnl). Evaluates cond; when it is nonzero the value and all derivatives flow through then_, otherwise through else_. The branch switch is a non-smooth event the derivative ignores (it differentiates only the active branch), exactly as ASL/IPOPT does for if.

Fields

§cond: Box<Expr>
§then_: Box<Expr>
§else_: Box<Expr>
§

MinList(Vec<Expr>)

n-ary minimum (o11 MINLIST). Value is the smallest operand. Piecewise linear: the derivative flows through whichever operand is currently smallest (a subgradient; ties resolve to the first such operand), and the second derivative is identically zero — the standard AD treatment for min/max, matching ASL/IPOPT.

§

MaxList(Vec<Expr>)

n-ary maximum (o12 MAXLIST). Value is the largest operand; derivative routing mirrors Expr::MinList.

Trait Implementations§

Source§

impl Clone for Expr

Source§

fn clone(&self) -> Expr

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for Expr

Source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

§

impl !Send for Expr

§

impl !Sync for Expr

§

impl Freeze for Expr

§

impl RefUnwindSafe for Expr

§

impl Unpin for Expr

§

impl UnsafeUnpin for Expr

§

impl UnwindSafe for Expr

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> ByRef<T> for T

Source§

fn by_ref(&self) -> &T

Source§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Imply<T> for U
where T: ?Sized, U: ?Sized,

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<T> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
Source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
Source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more