|
*Variation |
 
|
*Variation
|
*Variation |
|
To define parameter or keyword variations.
Refer to Keyword Based Variations for further information on this feature.
A block of two lines to define the relevant variation. The block begins with a line defining the variation name. The following lines are used to define the actual variations. The format of these lines depend on whether parameter or keyword variations are being defined. The entire block may then be repeated as often as necessary to define all the required variations.
Line defining the variation name:
NAME=Variation Name
Line defining parameter variations explicitly. This line may be repeated if required.
PARA=Parameter Name, VALUE=Value 1 [, Value 2] [, Value 3] etc.
Line defining a range of parameter variation via generation option. This line may be repeated if required.
PARA=Parameter Name, GEN=Start Value, End Value [, Increment] etc.
Line defining a keyword variation. This line may be repeated if required.
ACTION=ADD/REMOVE, KEYWORD=Keyword Name [, FILE=File Name] [, SECTION=Section Name]
Any Parameter Name referenced must be defined under *PARAMETERS. Generation option is only valid for numerical values. Increment defaults to 1.
Refer to the ‘Notes’ section below for further details.
Input: |
Description |
Variation Name: |
The name of the variation being defined. |
Parameter Name: |
The name of the parameter being varied. |
Value(s): |
The value or values being assigned to the parameter. These can be input in two different ways, namely: (i)A list of values, such as for example “4, 5, 6”. (ii)A group of consecutive values, input using the format: “7 – 9”. This definition specifies values of 7 to 9 inclusive. The specification “7 – 11 – 2” can be used to specify the values 7, 9 and 11 - that is, from 7 to 11 in steps of 2. Naturally if the value is a character expression (as opposed to a numerical value or equation), the consecutive type input is not relevant. Note also that character expression must be closed in quotation marks. |
Input: |
Description |
Variation Name: |
The name of the variation being defined. |
Action: |
The action to be taken on the keyword. The options are Add (the default) and Remove. Note that if the keyword is already present, the Add option essentially means Replace. |
Keyword: |
The relevant keyword in question. |
File: |
The file containing the keyword. This entry is optional and is only relevant when the Action is set to Add. When the action is set to Remove, naturally the File in question is the current one. |
Section: |
The section of the file containing the keyword. This entry is optional and is only relevant when the Action is set to Add. If omitted, the first occurrence of the keyword in the file is taken if the keyword appears more than once (but this would be unusual). |
(a)Variations in particular parameters (e.g. vessel offset terms) would typically be the most commonly used variations. However, for complete generality, it is also possible to add or remove entire keywords. This facility is intended to cater for variations which are difficult to accommodate using parameter variations, but the option is probably rarely invoked in practice. For example, if you wished to examine a different wave discretisation option, it might be more straightforward to replace the relevant wave loading keyword, rather than attempting to parameterise several different options within it.