The function of this Data Category is to define the overall administration parameters of the analysis.
This includes the type of analysis (JOB data record), various options (OPTIONS data record) controlling facilities, printing etc, and the definition of the stages of the analysis at which the user wishes to start and finish (RESTART data record).
The JOB data record defines the program and analysis type of the analysis that the user wishes to perform.
It is also used to input a 4-letter user-defined identifier for a particular run. As Aqwa-Drift, Aqwa-Fer and Aqwa-Librium have two distinct types of analysis (drift and wave frequency for Aqwa-Drift/Fer and static and dynamic stability at drift frequency for Aqwa-Librium) the user is able to select which type of analysis to perform.
The TITLE data record is used simply to input a title for the program run. This is stored and output at various stages, including the graphical plotting, and the annotation of the results.
The OPTIONS data record enables the user to select additional optional facilities and to control the quantity of printing output by the analysis. Note that the OPTIONS relating to printing are supplemented by further options in Data Category 18 (printing options). The latter are used to control output where more detailed information is required to define its extent and format.
In order to minimize the computer costs, all programs in the Aqwa suite have the facility of stopping and starting at various stages of the analysis. These stages are referred to as Restart Stages and are specified using the RESTART data record.
4.1. The JOB Data Record
1 5 11 17 --- - -- -- |JOB|X|UDJI|XX|DRIF|XX|WFRQ|
--- - -- -- | | | | | | | |
| | | |_(3)Analysis Type(A4) | | |
| | |_(2)Program Name(A4) | |
| |_(1)User Defined Job Identifier(A4) |
|_Compulsory data record keyword(A3)
(1) The 4-letter code is for the convenience of the user and is not used by the program. If the user wishes to have the same title for several runs, the 4-letter character identifier (which should always be unique) enables the user to distinguish between these runs. This is particularly relevant when using the graphics, as this code is output on every plot.
(2) An abbreviation of the program name must be input to specify the overall data input format to be expected by the program. If left blank, or the incorrect name is input, the program will output an error message and abort after the preliminary data category has been read. The accepted abbreviations for the program names are as follows:
Aqwa-Drift = DRIF
Aqwa-Fer = FER Aqwa-Line = LINE Aqwa-Librium = LIBR Aqwa-Naut = NAUT
(3) As all of the programs have two distinct types of analysis, the user may state which type of analysis is required for each run. If this field is left blank, then the default analysis type will be used. These defaults and the optional analysis types are as follows:
Aqwa-Line Default - Radiation/Diffraction analysis
Option 1 - FIXD - Structure fixed
Aqwa-Librium Default - Static AND dynamic stability
Option 1 - STAT - Static stability only Option 2 -DYNA - Dynamic stability only
Aqwa-Drift Default - Drift frequency motions only
Option 1 - WFRQ - Drift frequency AND wave frequency motions Aqwa-Fer Default - Drift frequency AND wave frequency motions
Option 1 - DRFT - Drift frequency motions only Option 2 - WFRQ - Wave frequency motions only
Aqwa-Naut Default - Time history regular wave response
Option 1 - IRRE - Time history analysis in irregular waves. This applies to both diffracting structures (when convolution is used) and Morison structures. Note that in Aqwa-Naut, wave drift force is not in-cluded in either regular or irregular waves.
4.2. The TITLE Data Record
1 6 21
--- --- --- |TITLE|XXXXXXXXXXXXXXX|THIS IS A TITLE OF THE PROGRAM RUN ...
--- --- --- | |
| |
| |_Title to be Used for Annotation of Results(15A4) |
|_Compulsory Data Record Keyword.
4.3. The NUM_CORES Data Record
Aqwa can take advanced of multi-core machines to improve computational speed during the solution stages. For more information, see Aqwa Parallel Processing Calculation in the Aqwa Theory Manual. The NUM_CORES data record specifies how many cores to use in a given analysis.
1 11 16 21
The Preliminary Data (Data Category 0)
|NUM_CORES |XXXXX| 16|
| | | |
| |_(1) Number of required cores (I5) |
|_Compulsory data record keyword (A9)
(1) For hydrodynamic diffraction analyses, the maximum number of cores used by Aqwa is the smallest of:
• The user requested number
• The total number of cores in the node on which Aqwa is executed
• The total number of available parallel licenses + 1
For time domain dynamic cable analyses, in order to maximize efficiency while minimizing total memory use, the fewest number of cores for dynamic cable parallel calculation is determined based on the total number of dynamic cables in each mooring configuration and the actual number of cores available to Aqwa. This may mean that the number of cores used (and reported in the output) may be fewer than the user requested value.
This data record is optional and only applies to Aqwa parallel processing.
4.4. The OPTIONS Data Record
1 9 14 19 24 29 --- - - - - - |OPTIONS|X|OPT1|X|OPT2|X|OPT3|X|OPT4|X|END | --- - - - - - | |
| |
| |_(1)One or more OPTIONS. Format of each Option(A4) |
|_Compulsory Data Record Keyword.
(1) Up to 14 options may be input on each options data record. Each data record must have the data record keyword OPTIONS in columns 1-7 and the last option on the last OPTIONS data record must be END as shown above. In practice, only a few options are used for any one run. It is therefore extremely unusual to input more than one OPTIONS data record.
The list of options common to all programs, and those which are have special applicability for a certain program are listed for each program in Options for Use in Running Aqwa Programs (p. 243).
4.5. The RESTART Data Record
Note
If this data record is present a REST option must be present in the list of options on the OPTIONS data record (see The OPTIONS Data Record (p. 31)).
1 9 12 21
--- - --- --- --- |RESTART|X| | |XXXXXX|FILENAME --- - --- --- ---
---The RESTART Data Record
| | | |
| | | |_(3)Optional. Name of database to be copied (without extension) | | |
| | |_(2)Finish Stage, i.e. Finish at the End of this Stage (I1) | |
| |_(1)Start stage, i.e. Start at the Beginning of this Stage (I1) |
|_Compulsory Data Record Keyword
(1) The start stage will depend on which stages have been previously run. Stages in the program may not be omitted. This means that the finish stage of the previous run must either be the previous stage or a later stage in the program analysis.
When errors are detected, the user may start the analysis again at any of the preceding stages before the error occurred. If the previous stage was correctly performed, the user instructs the program to execute the next stage, i.e. simply to continue the analysis.
Note that as no analysis is performed within Stage 3 (except for Aqwa-Line) a run starting and finishing at Stage 3 may be used, in conjunction with the PRDL option, to print out the contents of the restart file on the listing file. As the restart file is a binary file and cannot be printed out directly, this is very useful if there is some question as to the contents.
See Analysis Stages (p. 9) for a description and list of restart stages for each program.
(3) The program will automatically copy any relevant files with this name to use for the current run.
This may be .RES, .EQP and/or .POS, depending on the program which is being run. For example, using the name ABTEST1 in the Aqwa-Fer data file AFTEST2.DAT will result in:
ABTEST1.RES being copied to AFTEST2.RES ABTEST1.EQP being copied to AFTEST2.EQP.
Note that the RDEP option is still required to read the .EQP file that has been copied.
If an extension is used, for example ABTEST1.RES, only that one individual file will be copied.
The Preliminary Data (Data Category 0)