Utility functions in expressions

The following table lists utility functions that might be useful in formulas for CAE expressions. In the table, v is used to denote a dimensional or dimensionless numerical argument for the function. Examples are provided that show how the expression system evaluates dimensional and dimensionless numerical arguments for each function when the expression is dimensional or dimensionless and the function is the formula for the expression.

Utility functions

Function	Description	Example
Expression dimensionality (units)	Formula for the expression	Value for the expression
KU(v)	Converts temperature to Kelvin and removes the units (1)	Unitless (None)	ku(0)	273.15
ku(0[C])	273.15
ku(–273.15[C])	0
ku(0[K])	0
Length (mm)	ku(0)	273.15[mm]
ku(0[C])	273.15[mm]
ku(–273.15[C])	0[mm]
ku(0[K])	0[mm]
RADIANS(v)	Multiplies the argument by 2π/360	Unitless (None)	radians(180)	3.14159....
radians(180[degrees])	3.14159....
radians(pi()*1[radians])	3.14159....
radians(180[mm])	3.14159....
radians(0.18[m])	3.14159....
Length (mm)	radians(180)	3.14159....[mm]
radians(180[degrees])	3.14159....[mm]
radians(pi()*1[radians])	3.14159....[mm]
radians(180[mm])	3.14159....[mm]
radians(0.18[m])	3.14159....[mm]
REMU(expression name)	Removes the units from an expression (2)	Temperature (C)	REMU(p1) p1=5[mm]	5[C]
REMU(p1) p1=5[m]	5000[C]
REMU(p1) p1[mm]=5[m]	5000[C]
REMU(p1) p1[m]=5[m]	5[C]
(1) The KU function does not limit the range of the argument to values above absolute zero. Thus, to avoid a physically impossible argument when the argument for the KU function is variable, use a conditional statement to limit the range of the KU function argument.(2) When you create a dimensional expression with a dimensional formula and the dimensions of the expression and formula for the expression do not match, the software issues an error message. As a workaround to this problem, you can use the REMU function as follows:Create a dummy expression that has the same dimensions as the formula for the original expression.Enter the formula as the formula for the dummy expression. Because the dimensions of the dummy expression and the formula match, the software does not issue an error message.For the formula of the original expression, use the REMU function with the dummy expression as the argument.Because the REMU function removes the units from the dummy expression, the software assigns the units for original expression to the numerical results from the dummy expression.For example, suppose that you create an expression named pressure1 that has the units of MPa and a formula of 2*(ug_var("temperature")-0[K]).The software issues an error message because of the dimensional mismatch.As a workaround, create a dummy expression named dummy1 that has the units of dC and the following formula:2*(ug_var("temperature")-0[K])For the expression named pressure1, enter the following formula:remu(dummy1)

How do I

Change rename and variable prefix settings

Find units and unit designations

Specify a thermal plugin function

Learn more

Inputs to expressions

Restrictions on auto-generated expressions

Fields in expressions

Units in expressions

Migrating expressions that include angular measures

Inconsistent units warnings

Look up more details

Mathematical functions in expressions

Lookup functions in expressions

Thermal-flow functions in expressions

Auto-generated expressions

Field function

Mapped field function

Mathematical operators in expressions

Temperatures in expressions

Complex numbers in expressions

Quick links

Command reference

Pre/Post video examples

Bulk Entry Descriptions

Simcenter 3D tutorials

Browse Simcenter 3D help by product area

Utility functions in expressions, Simcenter 3D 2021.1 Series

© 2020 Siemens

window.mainLanguage="en_US"

window.delivId=""

window.projectId=""

MathJax.Hub.Config({ TeX: { extensions: ["autoload-all.js"] }, tex2jax: { displayMath: [ ] }, "SVG": { scale: 125 } });