USER MANUAL SWAN Cycle III version 40.72A

USER MANUAL SWAN Cycle III version 40.72A USER MANUAL SWAN Cycle III version 40.72A

sci.buu.ac.th
from sci.buu.ac.th More from this publisher
28.06.2014 Views

98 Appendix B • Replace the name by another character string at the users discretion (between quotes; this is the only occurrence where SWAN is case sensitive; e.g. for text to appear in a plot. Example: command scheme: KEYword ’City’ data command file: KEY ’Amsterdam’ data • Copy the name of the variable (without the quotes) literally followed by an = sign and a name at the users discretion (between quotes). SWAN interprets the copied name in the command file as a keyword with all the characteristics of a keyword such as ending a sequence of optional data (see below). As with other keywords the name of the variable is case-insensitive. Example: command scheme: KEYword ’City’ data command file: KEY city=’Amsterdam’ data As a rule, an error message will result if numerical data is given where character data should be given. Numerical data are simple numbers , e.g. 15 or −7 (integer data), or 13.7 or 0.8E−4 (real data). Whether or not integer number or real number should be given by the user is indicated in the description of the command scheme. Note that a decimal point is not permitted in an integer number. On the other hand, an integer number is accepted by SWAN where a real number should be given. In a command scheme, the number is always indicated with a name (which is placed between square brackets). In the command file such a name can be entered in two ways: • Replace the name by a number (not between square brackets). Example: command scheme: KEYword [nnn] command file: KEY 314 • Copy the name of the variable (without the quotes) literally followed by an = sign and the number (not between square brackets). SWAN interprets the copied name in the command file as a keyword with all the characteristics of a keyword such as ending a sequence of optional data (see below). As with other keywords the name of the variable is case-insensitive. Example: command scheme: KEYword [nnn] command file: KEY nnn=314

Required data and optional data Command syntax 99 All data must be given by the user in the command file in the same order as they appear in the command scheme. They are separated by blanks or comma’s. Required data (indicated in the description of each individual command) must be given explicitly as character string or numbers. Optional data are indicated (a) in the text of each individual command or (b) for sets of data: in parenthesis around the data concerned ( data ) For example: KEY1word KEY2word ’name’ ([nnn] [mmm]) [zzz] or (c) some optional data are indicate in the same way as optional keywords are indicated: | .....data.....| < > | .....data.....| Optional data of the kind (a) or (b) may be omitted by giving blanks between comma’s (SWAN then substitutes reasonable default values). If after a required datum all data is optional (till the next keyword or the next end-of-line), then the comma’s may be omitted too. Optional data of the kind (c) are to be treated in the same way as optional keywords. B.3 Command file and comments All text after one $ or between two $ signs on one line in the command file is ignored by SWAN as comment. Such comments may be important to the user e.g., to clarify the meaning of the commands used. In fact, this option has been used to create the edit file swan.edt (see Appendix C). Anything appearing after two $ signs is not interpreted

Required data and optional data<br />

Command syntax 99<br />

All data must be given by the user in the command file in the same order as they appear<br />

in the command scheme. They are separated by blanks or comma’s.<br />

Required data (indicated in the description of each individual command) must be given<br />

explicitly as character string or numbers.<br />

Optional data are indicated<br />

(a) in the text of each individual command or<br />

(b) for sets of data: in parenthesis around the data concerned<br />

( data )<br />

For example:<br />

KEY1word KEY2word ’name’ ([nnn] [mmm]) [zzz]<br />

or<br />

(c) some optional data are indicate in the same way as optional keywords are indicated:<br />

| .....data.....|<br />

< ><br />

| .....data.....|<br />

Optional data of the kind (a) or (b) may be omitted by giving blanks between comma’s<br />

(<strong>SWAN</strong> then substitutes reasonable default values). If after a required datum all data is<br />

optional (till the next keyword or the next end-of-line), then the comma’s may be omitted<br />

too. Optional data of the kind (c) are to be treated in the same way as optional keywords.<br />

B.3 Command file and comments<br />

All text after one $ or between two $ signs on one line in the command file is ignored<br />

by <strong>SWAN</strong> as comment. Such comments may be important to the user e.g., to clarify the<br />

meaning of the commands used. In fact, this option has been used to create the edit<br />

file swan.edt (see Appendix C). Anything appearing after two $ signs is not interpreted

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!