*SetCurve() - Cartesian 3D

Sets the values associated with a 3D Cartesian curve.

Syntax

*SetCurve(crv_name, Block-X,Block-Y,Block-Z ,LIN_EXTRAP)
Block-X, Block-Y, and Block-Z can be of the following three types:
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.
Data type: varname
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.
Data type: filename
datatype
Specifies the type of data from a data file for the X, Y, or Z component of the curve.
Data type: string
request
Specifies a request from a data file for the X, Y, or Z component of the curve.
Data type: string
component
Specifies a component of a request from a data file for the X, Y, or Z component of the curve.
Data type: string
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.
Data type: NumericVector
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.
Data type: integer
v1, v2, v3,..., vn
Discrete values for the X, Y, or Z component of the curve.
Data type: real
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

*BeginMdl()

*DefineAnalysis()

*DefineSystem()

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.