AqwaReader Manual

ANSYS, Inc. Release 2024 R1

Southpointe January 2024
2600 Ansys Drive
Canonsburg, PA 15317 ANSYS, Inc. and
ansysinfo@ansys.com ANSYS Europe,
Ltd. are UL
http://www.ansys.com registered ISO
(T) 724-746-3304 9001: 2015
(F) 724-514-9494 companies.
Copyright and Trademark Information

© 2024 ANSYS, Inc. Unauthorized use, distribution or duplication is prohibited.

ANSYS, Ansys Workbench, AUTODYN, CFX, FLUENT and any and all ANSYS, Inc. brand, product, service and feature
names, logos and slogans are registered trademarks or trademarks of ANSYS, Inc. or its subsidiaries located in the
United States or other countries. ICEM CFD is a trademark used by ANSYS, Inc. under license. CFX is a trademark
of Sony Corporation in Japan. All other brand, product, service and feature names or trademarks are the property
of their respective owners. FLEXlm and FLEXnet are trademarks of Flexera Software LLC.

Disclaimer Notice

THIS ANSYS SOFTWARE PRODUCT AND PROGRAM DOCUMENTATION INCLUDE TRADE SECRETS AND ARE CONFID-
ENTIAL AND PROPRIETARY PRODUCTS OF ANSYS, INC., ITS SUBSIDIARIES, OR LICENSORS. The software products
and documentation are furnished by ANSYS, Inc., its subsidiaries, or affiliates under a software license agreement
that contains provisions concerning non-disclosure, copying, length and nature of use, compliance with exporting
laws, warranties, disclaimers, limitations of liability, and remedies, and other provisions. The software products
and documentation may be used, disclosed, transferred, or copied only in accordance with the terms and conditions
of that software license agreement.

ANSYS, Inc. and ANSYS Europe, Ltd. are UL registered ISO 9001: 2015 companies.

U.S. Government Rights

For U.S. Government users, except as specifically granted by the ANSYS, Inc. software license agreement, the use,
duplication, or disclosure by the United States Government is subject to restrictions stated in the ANSYS, Inc.
software license agreement and FAR 12.212 (for non-DOD licenses).

Third-Party Software

See the legal information in the product help files for the complete Legal Notice for ANSYS proprietary software
and third-party software. If you are unable to access the Legal Notice, contact ANSYS, Inc.

Published in the U.S.A.

Table of Contents
1. AqwaReader Manual ............................................................................................................................... 1

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
Published: 2023-10-23 iii
 Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
iv Published: 2023-10-23
Chapter 1: AqwaReader Manual
AqwaReader is a stand-alone program run from the Windows command line, which allows you to nav-
igate through an Aqwa database file (for example, a restart (RES) or plotting (PLT) file) and extract results
from it.

Using AqwaReader from the Windows Command Line

The example below is based on the data files found in the Aqwa training folder located in \ANSYS
Inc\v241\aqwa\training. You will need to execute the file Run_Training.bat (found in the
training directory) to perform a simple Aqwa analysis before trying to view any database files.

Note:

Run_Training.bat can be run from the command line. You may need to move the "training"
folder to another location on your computer if you get a write permission error when you
try to execute Run_Training.bat. If you move the training folder, rather than executing
Run_Training.bat, execute the following command from the command line while in the
training folder:

"C:\Program Files\Ansys Inc\v241\aqwa\bin\winx64\Aqwa.exe" std

training.com

To run AqwaReader, from the Windows command line enter the command:

"C:\Program Files\ANSYS Inc\v241\aisol\workbench.bat" -cmd "C:\Program

Files\ANSYS Inc\v241\aisol\bin\winx64\AqwaReader.exe"

Note:

You cannot run AqwaReader directly. It has to go through workbench.bat to ensure that
the required libraries are loaded.

Running this command will display the following information:

AqwaReader can be configured in two ways: step-by-step, or by command line
arguments. If the user just runs the command "AqwaReader" without any arguments,
the program is configured through a series of input prompts. When the program exits
successfully the user is presented with a set of command line arguments, which can
be used to exactly repeat the previous operation. These arguments can be used as a
template to run the program repeatedly (e.g. from a script), for batch extraction of
results over multiple frequencies, directions, time steps, etc.

To avoid mistakes, the new user is recommended to use step-by-step configuration to

generate command line arguments.

The command line argument descriptors are as follows:

--Type [string] Operation type

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
Published: 2023-10-23 1
AqwaReader Manual

--InFile [string] Input file (as generated by an Aqwa analysis)

--OutFile [string] Output file
--Format [string] Output file format
--Unit [string] Length unit of data in input file
--Struct [integer] Structure number
--Freq [integer] Frequency index in the hydrodynamic database
--Dir [integer] Direction index in the hydrodynamic database
--Comp [string] Pressure component identifier (I/D/R/H combination)
--Ampl [float] Incident wave amplitude
--Phase [float] Incident wave phase angle
--Cable [integer] Cable number
--Tether [integer] Tether number
--Step [integer] Time step number
--Config [integer] Mooring configuration number
--SpecGr [integer] Spectral group number
--PLT1 [integer] Index at the first level of the Aqwa plotting (PLT) file
--PLT2 [integer] Index at the second level of the Aqwa plotting (PLT) file
--PLT3 [integer] Index at the third level of the Aqwa plotting (PLT) file
--PLT4 [integer] Index at the fourth level of the Aqwa plotting (PLT) file
--ResType [integer] Index of the moonpool related hydrodynamic data type
--SubType [integer] Index of the moonpool related hydrodynamic data sub-type
--Moonpl1 [integer] Moonpool number among moonpools of the specified structure
--Exdend1 [integer] Index of the specified moonpool extension
--Dof1 [integer] Index of the moonpool pressure mode or structure rigid body motion
--Struct2 [integer] Structure number for the moonpool related matrix element column index
--Moonpl2 [integer] Moonpool number for the moonpool related matrix element column index
--Exdend2 [integer] Index of the moonpool extension for the moonpool related matrix element column index
--Dof2 [integer] Index of DOF for the moonpool related matrix element column index

****************************************************************************************

Available operations:
- 1. Get geometry and mesh from an Aqwa input (DAT) file or restart (RES) file
- 2. Get graphical results from an Aqwa plotting (PLT) file
- 3. Get hydrodynamic panel pressures from a Hydrodynamic Diffraction (Aqwa-Line) restart (RES) file
- 4. Get RAO-based node positions from a Hydrodynamic Diffraction (Aqwa-Line) restart (RES) file
- 5. Get frequency statistical results from a frequency domain Hydrodynamic Response (Aqwa-Fer) results (
- 6. Get positions and tensions from a stability or time domain Hydrodynamic Response (Aqwa-Librium, Aqwa
- 7. Get node motions and forces from a stability or time domain Hydrodynamic Response (Aqwa-Librium, Aqw
- 8. Get element forces and stresses from a stability or time domain Hydrodynamic Response (Aqwa-Librium,
- 9. Get multi-directional quadratic transfer functions (QTFs) from a Hydrodynamic Diffraction (Aqwa-Line
- 10. Get moonpool pressure mode hydrostatic stiffness matrix from a Hydrodynamic Diffraction (Aqwa-Line)
- 11. Get moonpool pressure mode added mass or damping from a Hydrodynamic Diffraction (Aqwa-Line) restart
- 12. Get moonpool pressure mode RAO or first order wave force from a Hydrodynamic Diffraction (Aqwa-Line)

Select an operation:

After some informational text, there is a prompt to select an operation number. For example, to read
graphical results, enter the value 2 (corresponding to the operation 'Get graphical results from an Aqwa
plotting (PLT) file').

Next the program asks you to enter the (relative or absolute) path to the input file. For example, to
access Hydrodynamic Diffraction results in an Aqwa Workbench project, your path would look something
like:

<path_to_your_project>\<project_name>_files\dp0\AQW\AQW\AQ\Analysis\Ana-
lysis.plt

You can then specify the (relative or absolute) output file path to which AqwaReader will write values
in the comma-separated values (CSV) format (or you can enter "stdout" to just write the values to screen).
Select an operation: 2

Select an Aqwa file to read data from. Valid file extensions:

- plt: Aqwa plotting (PLT) file

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
2 Published: 2023-10-23
 Enter (relative or absolute) path to input file: antakbuy.plt
Full path for input file: C:\Aqwa\training\antakbuy.plt
Checking file access...
File accessed OK

Output file will be written in csv format

Specify output file (absolute or relative path; any file extension will be ignored), or enter 'stdout' for standar
Full path for output file: C:\Aqwa\training\outfile.csv
Checking directory exists...
Directory accessed OK

For each of the structures with which you have carried out an analysis, you can then set up the results
type by selecting from the displayed option lists.

In the example below, you are extracting information for the first structure (option 1: Structure Number
1) of the COG position (option 1: POSITION OF COG) along the Z-direction (option 3: in Z direction).
The selected input file contains a single first level option "Motion Analysis Time History -", which is used by de

The selected input file contains the following second level options:
- 1. Structure Number 1
- 2. Structure Number 2

Select a second level option number: 1

The selected input file contains the following third level options:
- 1. POSITION OF COG
- 2. VELOCITY OF COG
- 3. ACCELERATION OF COG
- 4. RAO BASED POSITION
- 5. RAO BASED VELOCITY
- 6. GRAVITY FORCE
- 7. HYDROSTATIC FORCE
- 8. MORISON DRAG FORCE
- 9. FROUDE KRYLOV FORCE
- 10. CURRENT DRAG FORCE
- 11. WIND FORCE
- 12. DIFFRACTION FORCE
- 13. LINEAR DAMPING FORCE
- 14. MOORING FORCE
- 15. RADIATION FORCE
- 16. TOTAL REACTION FORCE
- 17. TOTAL FORCE
- 18. ERROR PER TIMESTEP

Select a third level option number: 1

The selected input file contains the following fourth level options:
- 1. in X direction
- 2. in Y direction
- 3. in Z direction
- 4. about X axis
- 5. about Y axis
- 6. about Z axis

Select a fourth level option number: 3

After AqwaReader has successfully completed, it displays a set of arguments that can be used to exactly
repeat the previous operation. For example:
Data input complete. Generating output file...
Aqwa Reader has complete successfully.
****************************************************************************************
To exactly repeat this operation (without prompts), use the command:
AqwaReader --Type "Graphical" --InFile "C:\Aqwa\training\antakbuy.plt" --OutFile "C:\Aqwa\training\outfile" --Format

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
Published: 2023-10-23 3
AqwaReader Manual

You can then copy and paste the displayed commands into a script (remembering to put "..\..\work-
bench.bat -cmd" on the front of the command) with different values for the PLT command line options.

Caution:

The integer values of the PLT options mean different things in different analyses so you
should always check that you are getting the right output. The first lines of the output CSV
file show you what it contains. To illustrate this, consider the following example from a dif-
ferent analysis that was performed in Workbench.

To plot the pitch RAO in 0° wave direction, select option 1 (STRUCTURE 1 PARAMETERS
VERSUS FREQUENCY), then option 5 (DIRECTION NUMBER 5), then option 1 (FREE FLOATING
RAOS), then option 5 (PITCH(Y)). This will generate a command line similar to:
AqwaReader --Type "Graphical" --InFile "<path_to_your_project>\<project_name>_files\dp0\AQW\AQW\AQ\Analysis\Ana

where the wave direction index will depend on the number of wave directions in the analysis.

Release 2024 R1 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates.
4 Published: 2023-10-23