*SetCurve() - Cartesian 3D
Sets the values associated with a 3D Cartesian curve.
Syntax
*SetCurve(crv_name, Block-X,Block-Y,Block-Z ,LIN_EXTRAP)
FILE: "[path]/filename", datatype, request, component
MATH: expr
VALUE: numpts, v1, v2, v3, ..., vn
Arguments
- crv_name
- The variable name of an existing curve of type Cartesian 3D.
- FILE
- Indicates that the data for the X, Y, or Z component of the curve comes from a file.
- "[path]/filename"
- Filename for the X, Y, or Z component of the curve.
- datatype
- Specifies the type of data from a data file for the X, Y, or Z component of the curve.
- request
- Specifies a request from a data file for the X, Y, or Z component of the curve.
- component
- Specifies a component of a request from a data file for the X, Y, or Z component of the curve.
- MATH
- Indicates that the X, Y, or Z component of the curve is an expression.
- expr
- A mathematical expression for the X, Y, or Z component of the curve.
- VALUE
- Indicates that the data for the X, Y, or Z component of the curve is specified as discrete values.
- numpts
- An integer that indicates the number of points in the X, Y, or Z component of the curve.
- v1, v2, v3,..., vn
- Discrete values for the X, Y, or Z component of the curve.
- LIN_EXTRAP
- Flags the solver to linearly extrapolate beyond the final point in the curve.
Example
*SetCurve(crv_1, VALUE, 3, 10.2, 13.4, 15.7, MATH, 1:3:1, FILE,
"/homes/users/john/crv_data.dat", "Unknown", "Block 1", "Column 1")
*SetCurve(crv_1, VALUE, 3, 1.0, 1.0, 1.0, VALUE, 3, 2.0, 2.0, 2.0, VALUE, 3, 3.0, 3.0, 3.0)
Context
Comments
The X, Y, and Z components of a curve can be of different types. For example, the X component can be a mathematical expression while the Y component can refer to a plot file.
The length of each vector of curve data must be the same.