___________________________________________________________________
| |
| INCLUDE |
|_________________________________________________________________|
MEANING: Causes NM-TRAN to read control stream records from a dif-
ferent file.
CONTEXT: NM-TRAN Control Record
USAGE:
INCLUDE filename [ n ]
SAMPLE:
INCLUDE datadef
DISCUSSION:
This record causes NM-TRAN to read control stream records from a dif-
ferent file. The record must start with the characters INCLUDE or
include. $INCLUDE and $include are also recognized.
OPTIONS:
filename
Name of the file to be read. Required. Filename may not contain
embedded spaces. If it contains commas, semicolons, or
parentheses, then it must be surrounded by single quotes ' or
double quotes ". Filename may also contain equal signs if it is
enclosed in quotes.
n Optional. The number of copies of the file. Default is 1.
NMTRAN opens the named file and reads it to end-of-file. The contents
of the file may be any portion of an NM-TRAN control stream, e.g.,
control records and/or abbreviated code. After reaching end-of-file,
if the number of copies is greater than 1, NM-TRAN rewinds the file
and re-reads it the specified number of times. After reaching end-
of-file on the final (or only) copy, NMTRAN resumes reading the origi-
nal control stream after the include record.
There may be more than one include record anywhere in the control
stream, but they may not be nested. That is, an included file may not
contain include records.
If an error is detected in the NMTRAN input, the line number displayed
is cumulative. The number of the line in the included file is added
to the number of lines already read from the control stream and any
previous include files, as if the included file(s) are physically part
of the control stream.
EXAMPLE:
$PROBLEM model A with data set 3
include data3def
include modela
$THETA 1.3 4
$OMEGA .04
$SIGMA 1
$ESTIMATION
The file data3def contains the $INPUT and $DATA statements. The file
modela contains the $SUBROUTINE statement, $PK block, and $ERROR
block.
REFERENCES: None.
Go to main index.
Created by nmhelp2html v. 1.0 written by Niclas Jonsson (Modified by AJB 5/2006,11/2007)