Mathematical expression parser and evaluator. More...

#include <string>
#include <vector>
#include <functional>

Include dependency graph for MathExpr.hpp:

This graph shows which files directly or indirectly include this file:

Classes
struct	openswmm::mathexpr::Token

struct	openswmm::mathexpr::Expression

Namespaces
namespace	openswmm

namespace	openswmm::mathexpr

Enumerations
enum class	openswmm::mathexpr::TokenType : int { openswmm::mathexpr::NUMBER = 0 , openswmm::mathexpr::VARIABLE = 1 , openswmm::mathexpr::ADD = 2 , openswmm::mathexpr::SUB = 3 , openswmm::mathexpr::MUL = 4 , openswmm::mathexpr::DIV = 5 , openswmm::mathexpr::POW = 6 , openswmm::mathexpr::NEG = 7 , openswmm::mathexpr::LPAREN = 8 , openswmm::mathexpr::RPAREN = 9 , openswmm::mathexpr::FUNC_ABS = 10 , openswmm::mathexpr::FUNC_SGN = 11 , openswmm::mathexpr::FUNC_SQRT = 12 , openswmm::mathexpr::FUNC_LOG = 13 , openswmm::mathexpr::FUNC_EXP = 14 , openswmm::mathexpr::FUNC_SIN = 15 , openswmm::mathexpr::FUNC_COS = 16 , openswmm::mathexpr::FUNC_TAN = 17 , openswmm::mathexpr::FUNC_ASIN = 18 , openswmm::mathexpr::FUNC_ACOS = 19 , openswmm::mathexpr::FUNC_ATAN = 20 , openswmm::mathexpr::FUNC_STEP = 21 , openswmm::mathexpr::FUNC_MIN = 22 , openswmm::mathexpr::FUNC_MAX = 23 , openswmm::mathexpr::COMMA = 24 , openswmm::mathexpr::FUNC_COT = 25 , openswmm::mathexpr::FUNC_SINH = 26 , openswmm::mathexpr::FUNC_COSH = 27 , openswmm::mathexpr::FUNC_TANH = 28 , openswmm::mathexpr::FUNC_COTH = 29 , openswmm::mathexpr::FUNC_LOG10 = 30 , openswmm::mathexpr::FUNC_ACOT = 31 }

Functions
int	openswmm::mathexpr::parse (const std::string &expr_str, Expression &result)
	Tokenize an infix expression and construct its postfix representation.

const std::vector< std::string > &	openswmm::mathexpr::function_names ()
	Return recognized built-in function names in stable token order.

int	openswmm::mathexpr::bind_variables (Expression &expr, const char const name_table, int n_vars)
	Bind each variable token to the first matching table entry.

int	openswmm::mathexpr::compute_max_stack_depth (const Expression &expr)
	Compute the peak operand-stack occupancy implied by postfix tokens.

double	openswmm::mathexpr::evaluate (const Expression &expr, const std::function< double(const std::string &)> &var_lookup)
	Evaluate postfix tokens with a synchronous named-variable callback.

double	openswmm::mathexpr::evaluate (const Expression &expr, const double *vars, int n_vars)
	Evaluate using variable indices stored in a compiled expression.

double	openswmm::mathexpr::evaluate_fast (const Expression &expr, const double *vars) noexcept
	Evaluate the supported postfix subset with a fixed 32-value stack.

Detailed Description

Mathematical expression parser and evaluator.

Parses infix expressions (e.g., "C * exp(-0.1 * DT)") into postfix (RPN) token lists using the Shunting-yard algorithm. Evaluation uses a simple stack machine.

Used by:

Control rules (IF conditions with expressions)
Treatment functions (pollutant concentration formulas)
Groundwater custom deep flow expressions

Note: Legacy reference: src/legacy/engine/mathexpr.c

Author: Caleb Buahin caleb.nosp@m..bua.nosp@m.hin@g.nosp@m.mail.nosp@m..com

License: Apache-2.0

Classes

Namespaces

Enumerations

Functions

Detailed Description