STAR*NET V6 - Circe

Chapter 5 Preparing Input Data
Legacy Inline Options
The following inline options were present in older versions but have been replaced by
improved features or new options. These inline options are still maintained for the time
being, however, to provide compatibility with existing data files.
INLINE OPTION: .INCLUDE FileName
In earlier versions of STAR*NET, there was only one primary data file for a project, but
the “.INCUDE” inline option could be used repeatedly to insert data from other files.
Since the current program version allows you to define as many data files as you wish for
a project, the “.INCLUDE” option is no longer really necessary. However, it is still
maintained in the program so that existing projects can run unchanged, and to support
users who still wish to use this feature.
To use the option, insert the “.INCLUDE” inline anywhere in the primary data file or any
included file. Whenever the program finds the option, it will start reading data from the
specified file. After data has been completely read from the included file, the program
continues reading data from the preceding data file.
#Sample file containing ".INCLUDE" inlines
.INCLUDE DAVID.001
M 2-1-3 132-33-22 1200.234
M 3-2-4 125-14-54 1422.345
M 3-2-5 155-23-34 1023.117
.INCLUDE DAVID.002
.INCLUDE NORTH40.DAT
etc...
There are a couple simple rules to remember when using this option. In the discussion of
the rules below, we call the file containing the “.INCLUDE” option the “parent” and the
file to be included, the “child.”
1. The child file inherits all options currently in affect in the parent file, however any
options set or changed within the child file are not transferred back to the parent. For
example, if you use the “.2D” inline option in the parent file, the child file inherits
the “2D” data mode. But, if the mode is changed using the “.3D” option in the child
file, the changed mode is not transferred back to the parent. The parent retains its
original “2D” data mode.
2. An “included” file may also contain an “.INCLUDE” inline option, and all the rules
mentioned above relating to parent and child files continue to apply. Also, if a path is
given with the file name, any “.INCLUDE” option lines in the child file also inherit
this path.
92