Struct EmlTree 

pub struct EmlTree {
    pub root: Arc<EmlNode>,
    /* private fields */
}

EML tree with metadata.

Fields

root: Arc<EmlNode>

Root node of the tree.

Implementations

impl EmlTree

pub fn eval_real(&self, ctx: &EvalCtx) -> Result<f64, EmlError>

Evaluate the tree with real-valued inputs.

Internally uses complex arithmetic when needed (e.g., ln of negative numbers). Returns the real part if the imaginary part is below threshold, otherwise returns Err(EmlError::ComplexResult).

pub fn eval_complex( &self, vars: &[Complex<f64>], ) -> Result<Complex<f64>, EmlError>

Evaluate the tree with complex-valued inputs.

Uses a stack-machine post-order traversal for numerical stability and to avoid stack overflow on deeply nested trees.

pub fn eval_batch(&self, data: &[Vec<f64>]) -> Result<Vec<f64>, EmlError>

Evaluate the tree on a batch of data points.

Each element of data is a vector of variable values for one data point. Returns a vector of results, one per data point. When the parallel feature is enabled and data.len() >= 128, evaluation is distributed across rayon threads.

impl EmlTree

pub fn lower(&self) -> LoweredOp

Lower an EML tree to a conventional operation tree.

Recognizes common EML patterns (exp, ln, arithmetic) and converts them to their standard equivalents. Unrecognized subtrees are lowered as literal exp(left) - ln(right).

pub fn eval_real_lowered(&self, ctx: &EvalCtx) -> Result<f64, EmlError>

Evaluate the tree at real-valued variables via the lowered IR.

Unlike EmlTree::eval_real, which walks the raw EML tree through complex arithmetic (and accumulates ~1e-2 precision drift on deep constructions such as Canonical::sin(x)), this method first lowers the tree (recognising sin/cos/arithmetic patterns), simplifies the lowered IR, and evaluates through the OxiOp stack machine.

Because the stack machine dispatches directly to f64::sin/f64::cos when the lowering recognised a trig pattern, the result attains full f64 precision (~1e-15).

Errors

Returns Err(EmlError::NanEncountered) if the IR evaluates to NaN.

impl EmlTree

pub fn one() -> EmlTree

Create a tree representing the constant 1.

pub fn var(index: usize) -> EmlTree

Create a tree representing variable x_index.

pub fn eml(left: &EmlTree, right: &EmlTree) -> EmlTree

Create a tree representing eml(left, right) = exp(left) - ln(right).

pub fn from_node(node: Arc<EmlNode>) -> EmlTree

Construct an EmlTree from a raw Arc<EmlNode>.

pub fn const_val(v: f64) -> EmlTree

Create a tree with a free constant leaf (active only when SymRegConfig.enable_const_leaf = true).

pub fn count_const_leaves(&self) -> usize

Count Const leaves in the tree.

pub fn num_vars(&self) -> usize

Number of distinct variables referenced.

pub fn depth(&self) -> usize

Depth of the tree (leaves have depth 0).

pub fn size(&self) -> usize

Total number of nodes in the tree.

pub fn iter_postorder(&self) -> PostOrderIter<'_>

Iterate over all nodes in post-order (left, right, parent).

impl EmlTree

pub fn to_json(&self) -> Result<String, Error>

Serialize to a JSON string.

pub fn from_json(json: &str) -> Result<EmlTree, Error>

Deserialize from a JSON string.

pub fn to_json_pretty(&self) -> Result<String, Error>

Serialize to a pretty-printed JSON string.

pub fn to_binary(&self) -> Result<Vec<u8>, Error>

Serialize to binary using oxicode.

pub fn from_binary(bytes: &[u8]) -> Result<EmlTree, Error>

Deserialize from binary bytes encoded with Self::to_binary.

Trait Implementations

impl Clone for EmlTree

fn clone(&self) -> EmlTree

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EmlTree

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for EmlTree

fn deserialize<__D>( __deserializer: __D, ) -> Result<EmlTree, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for EmlTree

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

Formats the value using the given formatter.

impl PartialEq for EmlTree

fn eq(&self, other: &EmlTree) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for EmlTree

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.