Command Syntaxkey

The execution of Trelis is controlled either by entering commands from the command line or by reading them in from a journal file. Throughout this document, each function or process will have a description of the corresponding Trelis command; in this section, general conventions for command syntax will be described. The user can obtain a quick guide to proper command format by issuing the <keyword> help command; see Command Line Help for details.

Trelis commands are described in this manual and in the help output using the following conventions. An example of a typical Trelis command is:

Volume <range> Scheme Sweep [Source [Surface] <range>] [Target [Surface] <range>] [Rotate {on | OFF}]

The commands recognized by Trelis are free-format and abide by the following syntax conventions.

  1. Case is not significant.
  2. The "#" character in any command line begins a comment. The "#" and any characters following it on the same line are ignored. Although note that the "#" character can also be used to start an Aprepro statement. See the Aprepro documentation for more information.
  3. Commands may be abbreviated as long as enough characters are used to distinguish it from other commands.
  4. The meaning and type of command parameters depend on the keyword. Some parameters used in Trelis commands are:

    Numeric: A numeric parameter may be a real number or an integer. A real number may be in any legal C or FORTRAN numeric format (for example, 1, 0.2, -1e-2). An integer parameter may be in any legal decimal integer format (for example, 1, 100, 1000, but not 1.5, 1.0, 0x1F).

    String: A string parameter is a literal character string contained within single or double quotes. For example, 'This is a string' .

    Filename: When a command requires a filename, the filename must be enclosed in single or double quotes. If no path is specified, the file is understood to be in the current working directory. After entering a portion of a filename, typing a '?' will complete the filename, or as much of the filename as possible if there is more than one possible match.

    A filename parameter must specify a legal filename on the system on which Trelis is running. The filename may be specified using either a relative path (../Trelis/mesh.jou), a fully-qualified path (/home/jdoe/Trelis/mesh.jou), or no path; in the latter case, the file must be in the working directory (See Environment Commands for details.) Environment variables and aliases may also be used in the filename specification; for example, the C-Shell shorthand of referring to a file relative to the user's login directory (~jdoe/Trelis/mesh.jou) is valid.

    Toggle: Some commands require a "toggle" keyword to enable or disable a setting or option. Valid toggle keywords are "on", "yes", and "true" to enable the option; and "off", "no", and "false" to disable the option.

  5. Each command typically has either:

    * an action keyword or "verb" followed by a variable number of parameters. For example:

    Mesh Volume 1

    Here Mesh is the verb and Volume 1 is the parameter.

    * or a selector keyword or "noun" followed by a name and value of an attribute of the entity indicated. For example:

    Volume 1 Scheme Sweep Source 1 Target 2

    Here Volume 1 is the noun, Scheme is the attribute, and the remaining data are parameters to the Scheme keyword.

The notation conventions used in the command descriptions in this document are: