2.3 XAS command files

• A command file contains one line for each question (argument(s)) asked by a program.
• This line contains one or more values (individual arguments), AS MANY AS requested by the particular question.
• If a command file is used as a standard setup, each line may be terminated with comments (separated by an exclamation mark), which are useful to document what the arguments are.
• Instead of explicit arguments, one line may start with a terminal escape character (currently an exclamation mark) : in this case the program will ALWAYS prompt interactively the user for this set of arguments (unless they are passed on the run string).
• A command file is established for use (with the NEXT program only unless otherwise requested) with

  xasset command cfile

The following examples will clarify what said above.

Example 1

This file mycomfil.command corresponds to the run string used in the command invocation example. It is used in the first example of mixed mode.

pinco        ! input file name
100,120      ! centre coordinates
75           ! angle
panco        ! output file name 

Example 2

This file alldefault.command contains all default "blank" values and is used in the second example of mixed mode.

,,,,,       ! input file name
,,,,,       ! centre coordinates
,,,,,       ! angle
,,,,,       ! output file name 

Note that commas must be explicitly inserted in each line. It is NOT possible to leave a line blank, since Fortran list-directed i/o will then wrap into the next line. It is prudent (and harmless) to put MORE commas than required, particularly if one intend to use the command file as a "generic" all-default file for many different programs which may have different order and number of arguments. In this case one usually omits comments.

Example 3

This file newdefault.command contains all default "blank" values and is used in the third example of mixed mode. In this case the file names are always asked interactively or derived from the run string, since the program does not provides defaults for them.

!           ! input file name
,,,,,       ! centre coordinates
,,,,,       ! angle
!           ! output file name 

Example 4

This example is not used elsewhere. It is a standard setup file for a rotation of 45 degrees around the default centre, with filenames asked interactively.

!           ! input file name
,,,         ! centre coordinates
45          ! angle
!           ! output file name 

[Previous][Next] [Up][Down]