Constant

Applies a constant value to a result table.

Inputs

value
A space-separated string representing a scalar, vector, or tensor.

Outputs

table
A destination table to store the constant value.

Comments

  • A constant value table will return the same record for every item lookup, specified by value.
  • The value string must have same format as table (vector and tensor tables require multiple values). A tensor table can accept values of three or six components (representing a 2D or 3D tensor).
  • Multiple values are passed in a space-separated string.
    • The following examples show the value attribute applied to each result table type:
      • Scalar: value="1.0"
      • Vector: value=”1.0 2.0 3.0”
      • Tensor value=”1.0 2.0 3.0” (creates a 2D tensor constant value)
      • Tensor: value=”1.0 2.0 3.0 4.0 5.0 6.0” (creates a 3D tensor constant value)
  • Vector and tensor constant values are defined relative to the global coordinate system.
  • When applying this operator to a complex value table, the following rules apply:
    • If the imaginary parts are omitted, they will be assigned to 0.0.
    • Complex vector and tensor constants follow a block format where the real parts are followed by the imaginary parts:
      • Scalar: value=”Sr Si”
      • Vector: value=”Xr Yr Zr Xi Yi Zi”
      • Tensor: value=”XXr YYr XYr XXi YYi XYi” (creates a 2D tensor constant value)
      • Tensor: value=”XXr YYr ZZr XYr YZr ZXr Xxi YYi ZZi XYi YZi ZXi” (creates a 3D tensor constant value)

Syntax

Numbers in equations are converted to constant value tables. Vector and tensor values are represented using templex style arrays: vector={X,Y,Z}, tensor={XX,YY,XY}, etc. Complex values use the same syntax, and have sub-arrays for the real and imaginary parts: scalar = {{R},{I}}, vector={{Xr,Yr,Zr},{Xi,Yi,Zi}}, etc.

XML Example

<call name="Constant" value="1.0 2.0 3.0" table="dest_tab" />