*Combinations
To control the names and locations of generated keyword files, along with the required analysis combinations.
Refer to Parameters for further information on this feature.
The keyword begins with an optional line defining the base directory for the generated keyword files. This is followed by a block of lines to define the names and locations of generated keyword files, along with the required analysis combinations. The block begins with a line providing a descriptive comment on the analysis combination, a subdirectory for the generated keyword files, and the file names themselves. This is then followed by one or more lines defining the analysis combinations, via a list of variation names. The entire block may then be repeated for further analysis combinations if required.
Optional line defining the base directory for the generated keyword files.
[DIRECTORY=Base Directory]
Block of lines to define the names and locations of generated keyword files, along with the required analysis combinations.
Line providing a descriptive comment on the analysis combination, a subdirectory for the generated keyword files, and the file names themselves.
DESCRIPTION=Description [, SUBDIRECTORY=Subdirectory] [,
FILENAME=File Name]
Line defining the analysis combinations. Every variation may be included in the combination using ALL. This line defaults to “VARIATIONS=ALL” if not specified by the user.
[VARIATIONS=ALL]
Otherwise, up to 20 variation names may be specified on a single line. This is normally sufficient, but the line may be repeated if necessary.
VARIATIONS=Variation Name, Variation Name, Variation Name, etc.
Base Directory defaults to the directory of the base keyword file if omitted. Although both Subdirectory and File Name are optional inputs, at least one of these entries should be specified in order to create unique names or locations for the generated keyword files. These entries may contain combinations of standard characters and parameter values (denoted via %Parameter Name%). If omitted, Subdirectory is the same as the base directory (i.e. no subdirectory is created). If omitted, File Name is the same as the base keyword file name. Where there is a conflict between generated names, a counter will be appended to the file name (or directory name) to ensure unique names are used.
Refer to ‘Notes’ below for further details.
Input: |
Description |
Base Directory: |
The base directory for the generated keyword files. This entry is optional and defaults to the directory of the base keyword file if omitted. |
Input: |
Description |
Description: |
A descriptive comment on the analysis combination. This comment will be included in all generated keyword files for this analysis combination. |
Subdirectory: |
A subdirectory for the generated keyword files. This entry may contain combinations of standard characters and parameter values. See Note (a). |
File Name: |
The names of the generated keyword files. This entry may contain combinations of standard characters and parameter values. See Note (a). |
Included Variations: |
Either ALL or a list of the analysis combinations, defined in terms of Variation names. This entry is optional and defaults to ALL if omitted. You can specify up to 20 names per line. This is normally sufficient, but the line may be repeated if necessary. If you are using more than one line for Included Variations, you should leave the preceding columns blank for the second and subsequent lines. |
(a)The Subdirectory and File Name entries may contain combinations of standard characters and parameter values (denoted via %Parameter Name%). For example, if you had a base file name entitled “Offset.key”, you might wish to create variations such as “25m Offset.key”, “50m Offset.key” etc., in “Near” and “Far” subfolders. This could be achieved by specifying entries such as “Near\%Offset%m Offset” (Subdirectory), and “%Offset%m Offset” (File Name), assuming an Offset parameter has been defined in the Parameter Variations table. The quotation marks must be included in these two entries.