Reverse Polish Notation (RPN) builder. More...

#include <KokkosFunctionParser.h>

Classes
struct	Instruction
	RPN instruction. More...

struct	Variable
	Variable identifier. More...

Public Types
enum class	Opcode { NUM , VAR , NEG , NOT , ADD , SUB , MUL , DIV , AND , OR , EQ , NEQ , LT , LEQ , GT , GEQ , ABS , ACOS , ACOSH , ASIN , ASINH , ATAN , ATAN2 , ATANH , CBRT , CEIL , COS , COSH , COT , CSC , EXP , EXP2 , FLOOR , HYPOT , IF , INT , LOG , LOG2 , LOG10 , MAX , MIN , POW , SEC , SIN , SINH , SQRT , TAN , TANH , TRUNC }
	RPN opcode. More...

Public Member Functions
	RPNBuilder (const std::string &expression, const ConsoleStream *console=nullptr)
	Constructor.

void	printRPN (const ConsoleStream &console) const
	Print RPN sequence for debugging.

const std::vector< Instruction > &	getRPN () const
	Get RPN sequence.

void	addDefaultVariables ()
	Add default variables.

bool	hasDefaultVariables () const
	Get whether default variables were added.

unsigned int	addNumber (Real number)
	Add a parsed function constant.

unsigned int	addVariable (const std::string &name)
	Add a parsed function variable.

void	associateScalar (const std::string &name, const Real *scalar)
	Associate a variable with a scalar value.

void	associateField (const std::string &name, const VariableValue *field)
	Associate a variable with a field variable.

void	associateProperty (const std::string &name, const MaterialProperty< Real > *property)
	Associate a variable with a material property.

void	associateFunction (const std::string &name, const Function *function)
	Associate a variable with a function.

const std::vector< Real > &	getNumbers () const
	Get numbers used in the expression.

const std::unordered_map< std::string, Variable > &	getVariables () const
	Get variables used in the expression.

void	finalize ()
	Finalize the builder and prevent further changes.

bool	finalized () const
	Get whether the builder was finalized.


void	build (const peg::Ast &ast)
	Build RPN from AST.

void	build ()

Private Member Functions
void	builderError (const peg::Ast &ast, const std::string &message) const
	Print a pretty error showing the position of error.

void	checkFinalized ()
	Error on attempts to update the builder after finalization.

Private Attributes
PEGParser	_parser
	PEG parser.

std::vector< Instruction >	_rpn
	RPN sequence.

std::vector< Real >	_numbers
	Numbers used in the function.

std::unordered_map< std::string, Variable >	_variables
	Variables used in the function.

bool	_has_default_variables = false
	Whether default variables were added.

bool	_finalized = false
	Whether builder was finalized.

Static Private Attributes
static const std::map< std::string, Opcode >	_unary_opcode_map
	Map from unary operators to opcodes.

static const std::map< std::string, Opcode >	_binary_opcode_map
	Map from binary operators to opcodes.

static const std::map< std::string, std::pair< Opcode, unsigned int > >	_function_opcode_map
	Map from functions to opcodes and the expected number of arguments.

Detailed Description

Reverse Polish Notation (RPN) builder.

Definition at line 69 of file KokkosFunctionParser.h.

Member Enumeration Documentation

◆ Opcode

enum class Moose::Kokkos::RPNBuilder::Opcode

strong

RPN opcode.

Enumerator
NUM
VAR
NEG
NOT
ADD
SUB
MUL
DIV
AND
OR
EQ
NEQ
LT
LEQ
GT
GEQ
ABS
ACOS
ACOSH
ASIN
ASINH
ATAN
ATAN2
ATANH
CBRT
CEIL
COS
COSH
COT
CSC
EXP
EXP2
FLOOR
HYPOT
IF
INT
LOG
LOG2
LOG10
MAX
MIN
POW
SEC
SIN
SINH
SQRT
TAN
TANH
TRUNC

Definition at line 85 of file KokkosFunctionParser.h.

  {
    NUM,
    VAR,
    NEG,
    NOT,
    // Binary operators
    ADD,
    SUB,
    MUL,
    DIV,
    AND,
    OR,
    EQ,
    NEQ,
    LT,
    LEQ,
    GT,
    GEQ,
    // Functions
    ABS,
    ACOS,
    ACOSH,
    ASIN,
    ASINH,
    ATAN,
    ATAN2,
    ATANH,
    CBRT,
    CEIL,
    COS,
    COSH,
    COT,
    CSC,
    EXP,
    EXP2,
    FLOOR,
    HYPOT,
    IF,
    INT,
    LOG,
    LOG2,
    LOG10,
    MAX,
    MIN,
    POW,
    SEC,
    SIN,
    SINH,
    SQRT,
    TAN,
    TANH,
    TRUNC
  };

Constructor & Destructor Documentation

◆ RPNBuilder()

Moose::Kokkos::RPNBuilder::RPNBuilder	(	const std::string &	expression,
		const ConsoleStream *	console = `nullptr`
	)

inline

Constructor.

Parameters

expression	The function expression
console	The console object

Definition at line 77 of file KokkosFunctionParser.h.

    : _parser(expression, console)
  {
  }

Member Function Documentation

◆ addDefaultVariables()

void Moose::Kokkos::RPNBuilder::addDefaultVariables ( )

Add default variables.

◆ addNumber()

unsigned int Moose::Kokkos::RPNBuilder::addNumber ( Real number )

Add a parsed function constant.

Parameters

number The constant

Returns: The constant index

◆ addVariable()

unsigned int Moose::Kokkos::RPNBuilder::addVariable ( const std::string & name )

Add a parsed function variable.

Parameters

name	The variable name

Returns: The variable index

◆ associateField()

void Moose::Kokkos::RPNBuilder::associateField	(	const std::string &	name,
		const VariableValue *	field
	)

Associate a variable with a field variable.

Parameters

name	The variable name
variable	The pointer to the field variable

◆ associateFunction()

void Moose::Kokkos::RPNBuilder::associateFunction	(	const std::string &	name,
		const Function *	function
	)

Associate a variable with a function.

Parameters

name	The variable name
function	The pointer to the function

◆ associateProperty()

void Moose::Kokkos::RPNBuilder::associateProperty	(	const std::string &	name,
		const MaterialProperty< Real > *	property
	)

Associate a variable with a material property.

Parameters

name	The variable name
variable	The pointer to the material property

◆ associateScalar()

void Moose::Kokkos::RPNBuilder::associateScalar	(	const std::string &	name,
		const Real *	scalar
	)

Associate a variable with a scalar value.

Parameters

name	The variable name
value	The pointer to the scalar value

◆ build() [1/2]

void Moose::Kokkos::RPNBuilder::build ( )

inline

Definition at line 178 of file KokkosFunctionParser.h.

178{ build(*_parser.ast()); }

Moose::Kokkos::PEGParser::ast

auto ast() const

Get AST.

Definition KokkosFunctionParser.h:44

Moose::Kokkos::RPNBuilder::build

void build()

Definition KokkosFunctionParser.h:178

Referenced by build().

◆ build() [2/2]

void Moose::Kokkos::RPNBuilder::build ( const peg::Ast & ast )

Build RPN from AST.

Parameters

ast	The current node

◆ builderError()

void Moose::Kokkos::RPNBuilder::builderError	(	const peg::Ast &	ast,
		const std::string &	message
	)		const

private

Print a pretty error showing the position of error.

Parameters

ast	The erroneous AST node
message	The error message

◆ checkFinalized()

void Moose::Kokkos::RPNBuilder::checkFinalized ( )

private

Error on attempts to update the builder after finalization.

◆ finalize()

void Moose::Kokkos::RPNBuilder::finalize ( )

inline

Finalize the builder and prevent further changes.

Definition at line 253 of file KokkosFunctionParser.h.

253{ _finalized = true; }

Moose::Kokkos::RPNBuilder::_finalized

bool _finalized

Whether builder was finalized.

Definition KokkosFunctionParser.h:323

◆ finalized()

bool Moose::Kokkos::RPNBuilder::finalized ( ) const

inline

Get whether the builder was finalized.

Returns: Whether the builder was finalized

Definition at line 258 of file KokkosFunctionParser.h.

258{ return _finalized; }

◆ getNumbers()

const std::vector< Real > & Moose::Kokkos::RPNBuilder::getNumbers ( ) const

inline

Get numbers used in the expression.

Returns: The numbers

Definition at line 243 of file KokkosFunctionParser.h.

243{ return _numbers; }

Moose::Kokkos::RPNBuilder::_numbers

std::vector< Real > _numbers

Numbers used in the function.

Definition KokkosFunctionParser.h:311

◆ getRPN()

const std::vector< Instruction > & Moose::Kokkos::RPNBuilder::getRPN ( ) const

inline

Get RPN sequence.

Returns: The RPN sequence

Definition at line 190 of file KokkosFunctionParser.h.

190{ return _rpn; }

Moose::Kokkos::RPNBuilder::_rpn

std::vector< Instruction > _rpn

RPN sequence.

Definition KokkosFunctionParser.h:307

◆ getVariables()

const std::unordered_map< std::string, Variable > & Moose::Kokkos::RPNBuilder::getVariables ( ) const

inline

Get variables used in the expression.

Returns: The variables

Definition at line 248 of file KokkosFunctionParser.h.

248{ return _variables; }

Moose::Kokkos::RPNBuilder::_variables

std::unordered_map< std::string, Variable > _variables

Variables used in the function.

Definition KokkosFunctionParser.h:315

◆ hasDefaultVariables()

bool Moose::Kokkos::RPNBuilder::hasDefaultVariables ( ) const

inline

Get whether default variables were added.

Returns: Whether default variables were added

Definition at line 200 of file KokkosFunctionParser.h.

200{ return _has_default_variables; }

Moose::Kokkos::RPNBuilder::_has_default_variables

bool _has_default_variables

Whether default variables were added.

Definition KokkosFunctionParser.h:319

◆ printRPN()

void Moose::Kokkos::RPNBuilder::printRPN ( const ConsoleStream & console ) const

Print RPN sequence for debugging.

Parameters

console The console object

Member Data Documentation

◆ _binary_opcode_map

const std::map<std::string, Opcode> Moose::Kokkos::RPNBuilder::_binary_opcode_map

inlinestaticprivate

Initial value:

= {{"+", Opcode::ADD},
                                                                          {"-", Opcode::SUB},
                                                                          {"*", Opcode::MUL},
                                                                          {"/", Opcode::DIV},
                                                                          {"^", Opcode::POW},
                                                                          {"&", Opcode::AND},
                                                                          {"|", Opcode::OR},
                                                                          {"=", Opcode::EQ},
                                                                          {"!=", Opcode::NEQ},
                                                                          {"<", Opcode::LT},
                                                                          {"<=", Opcode::LEQ},
                                                                          {">", Opcode::GT},
                                                                          {">=", Opcode::GEQ}}

Map from binary operators to opcodes.

Definition at line 270 of file KokkosFunctionParser.h.

                                                                     {{"+", Opcode::ADD},
                                                                          {"-", Opcode::SUB},
                                                                          {"*", Opcode::MUL},
                                                                          {"/", Opcode::DIV},
                                                                          {"^", Opcode::POW},
                                                                          {"&", Opcode::AND},
                                                                          {"|", Opcode::OR},
                                                                          {"=", Opcode::EQ},
                                                                          {"!=", Opcode::NEQ},
                                                                          {"<", Opcode::LT},
                                                                          {"<=", Opcode::LEQ},
                                                                          {">", Opcode::GT},
                                                                          {">=", Opcode::GEQ}};

◆ _finalized

bool Moose::Kokkos::RPNBuilder::_finalized = false

private

Whether builder was finalized.

Definition at line 323 of file KokkosFunctionParser.h.

Referenced by finalize(), and finalized().

◆ _function_opcode_map

const std::map<std::string, std::pair<Opcode, unsigned int> > Moose::Kokkos::RPNBuilder::_function_opcode_map

inlinestaticprivate

Initial value:

=
      {{"abs", {Opcode::ABS, 1}},     {"acos", {Opcode::ACOS, 1}},   {"acosh", {Opcode::ACOSH, 1}},
       {"asin", {Opcode::ASIN, 1}},   {"asinh", {Opcode::ASINH, 1}}, {"atan", {Opcode::ATAN, 1}},
       {"atan2", {Opcode::ATAN2, 2}}, {"atanh", {Opcode::ATANH, 1}}, {"cbrt", {Opcode::CBRT, 1}},
       {"ceil", {Opcode::CEIL, 1}},   {"cos", {Opcode::COS, 1}},     {"cosh", {Opcode::COSH, 1}},
       {"cot", {Opcode::COT, 1}},     {"csc", {Opcode::CSC, 1}},     {"exp", {Opcode::EXP, 1}},
       {"exp2", {Opcode::EXP2, 1}},   {"floor", {Opcode::FLOOR, 1}}, {"hypot", {Opcode::HYPOT, 2}},
       {"if", {Opcode::IF, 3}},       {"int", {Opcode::INT, 1}},     {"log", {Opcode::LOG, 1}},
       {"log2", {Opcode::LOG2, 1}},   {"log10", {Opcode::LOG10, 1}}, {"max", {Opcode::MAX, 2}},
       {"min", {Opcode::MIN, 2}},     {"pow", {Opcode::POW, 2}},     {"sec", {Opcode::SEC, 1}},
       {"sin", {Opcode::SIN, 1}},     {"sinh", {Opcode::SINH, 1}},   {"sqrt", {Opcode::SQRT, 1}},
       {"tan", {Opcode::TAN, 1}},     {"tanh", {Opcode::TANH, 1}},   {"trunc", {Opcode::TRUNC, 1}}}

Map from functions to opcodes and the expected number of arguments.

Definition at line 287 of file KokkosFunctionParser.h.

      {{"abs", {Opcode::ABS, 1}},     {"acos", {Opcode::ACOS, 1}},   {"acosh", {Opcode::ACOSH, 1}},
       {"asin", {Opcode::ASIN, 1}},   {"asinh", {Opcode::ASINH, 1}}, {"atan", {Opcode::ATAN, 1}},
       {"atan2", {Opcode::ATAN2, 2}}, {"atanh", {Opcode::ATANH, 1}}, {"cbrt", {Opcode::CBRT, 1}},
       {"ceil", {Opcode::CEIL, 1}},   {"cos", {Opcode::COS, 1}},     {"cosh", {Opcode::COSH, 1}},
       {"cot", {Opcode::COT, 1}},     {"csc", {Opcode::CSC, 1}},     {"exp", {Opcode::EXP, 1}},
       {"exp2", {Opcode::EXP2, 1}},   {"floor", {Opcode::FLOOR, 1}}, {"hypot", {Opcode::HYPOT, 2}},
       {"if", {Opcode::IF, 3}},       {"int", {Opcode::INT, 1}},     {"log", {Opcode::LOG, 1}},
       {"log2", {Opcode::LOG2, 1}},   {"log10", {Opcode::LOG10, 1}}, {"max", {Opcode::MAX, 2}},
       {"min", {Opcode::MIN, 2}},     {"pow", {Opcode::POW, 2}},     {"sec", {Opcode::SEC, 1}},
       {"sin", {Opcode::SIN, 1}},     {"sinh", {Opcode::SINH, 1}},   {"sqrt", {Opcode::SQRT, 1}},
       {"tan", {Opcode::TAN, 1}},     {"tanh", {Opcode::TANH, 1}},   {"trunc", {Opcode::TRUNC, 1}}};

◆ _has_default_variables

bool Moose::Kokkos::RPNBuilder::_has_default_variables = false

private

Whether default variables were added.

Definition at line 319 of file KokkosFunctionParser.h.

Referenced by hasDefaultVariables().

◆ _numbers

std::vector<Real> Moose::Kokkos::RPNBuilder::_numbers

private

Numbers used in the function.

Definition at line 311 of file KokkosFunctionParser.h.

Referenced by getNumbers().

◆ _parser

PEGParser Moose::Kokkos::RPNBuilder::_parser

private

PEG parser.

Definition at line 303 of file KokkosFunctionParser.h.

Referenced by build().

◆ _rpn

std::vector<Instruction> Moose::Kokkos::RPNBuilder::_rpn

private

RPN sequence.

Definition at line 307 of file KokkosFunctionParser.h.

Referenced by getRPN().

◆ _unary_opcode_map

const std::map<std::string, Opcode> Moose::Kokkos::RPNBuilder::_unary_opcode_map

inlinestaticprivate

Initial value:

= {{"-", Opcode::NEG},

{"!", Opcode::NOT}}

Map from unary operators to opcodes.

Definition at line 264 of file KokkosFunctionParser.h.

264 {{"-", Opcode::NEG},

265 {"!", Opcode::NOT}};

◆ _variables

std::unordered_map<std::string, Variable> Moose::Kokkos::RPNBuilder::_variables

private

Variables used in the function.

Definition at line 315 of file KokkosFunctionParser.h.

Referenced by getVariables().

The documentation for this class was generated from the following file:

include/kokkos/functions/KokkosFunctionParser.h

Classes

Public Types

Public Member Functions

Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Member Enumeration Documentation

◆ Opcode

Constructor & Destructor Documentation

◆ RPNBuilder()

Member Function Documentation

◆ addDefaultVariables()

◆ addNumber()

◆ addVariable()

◆ associateField()

◆ associateFunction()

◆ associateProperty()

◆ associateScalar()

◆ build() [1/2]

◆ build() [2/2]

◆ builderError()

◆ checkFinalized()

◆ finalize()

◆ finalized()

◆ getNumbers()

◆ getRPN()

◆ getVariables()

◆ hasDefaultVariables()

◆ printRPN()

Member Data Documentation

◆ _binary_opcode_map

◆ _finalized

◆ _function_opcode_map

◆ _has_default_variables

◆ _numbers

◆ _parser

◆ _rpn

◆ _unary_opcode_map

◆ _variables