1.3. Output Data Format

Three different files (see Table 1.2: Types of Output Formats and Contents ) could be output, based on your requirement. The format and details of the contents are given in this chapter.

1.3.1. *.ahd File

This is an Ansys Neutral file, which contains the following sub-sections:

1.3.1.1. File Title

This section contains the Aqwa2Neut version number, the copyright statement, the hydrodynamic database name (without an extension), the structure sequence number, the date and time when this file was generated, and the phase reference information.


Note:  For a structure in a hydrodynamic interaction structure group, the phase is referenced to the center of gravity (COG) of the first structure in that group.


1.3.1.2. Wave Period

Data ExampleDescription

PERD

3

6.283186E+01 7.853982E+00 3.490659E+00

Head of section

Number of wave periods of the structure specified by Arg2

Wave periods in seconds, up to 10 values per line

1.3.1.3. Wave Direction

Data ExampleDescription

DIRN

3

-9.000000E+01 -4.500000E+01 9.000000E+01

Head of section

Number of wave directions of the structure specified by Arg2

Wave periods in degrees, up to 10 values per line

1.3.1.4. General Global Parameters

Data ExampleDescription

GENE

1.000000E+03 1.025000E+03 9.806650E+00 2

Head of section

Water depth and density, acceleration due to gravity, structure symmetry indicator


Note:  The structure symmetry indicator here is defined in the following structural hull surface symmetric cases:

=0, no symmetry

=1, port-starboard symmetry

=2, fore-aft symmetry

=3, port-starboard and fore-aft symmetry


1.3.1.5. Submerged Panel Information

This section lists the nodal coordinates of each submerged quadrilateral and triagonal panel, including diffraction panels on the moonpool hull surfaces (if available). The third and fourth nodal coordinates are identical for any triagonal panel.

Data ExampleDescription

HYDR

1800

7.474338E+01 8.000000E+01 … -2.505109E+00

. . .

-3.500000E+01 1.000000E+02 … -2.500000E+00

Head of section

Total number of submerged panels on whole hull surface

Coordinates of four nodes of each panel

(Each element per line)

1.3.1.6. Hydrodynamic Pressure RAO on Underwater Panel

Data ExampleDescription

PRES

1 1 1 1 8.326482E+01 1.733430E+02

1 1 1 2 5.397807E+01 1.725890E+02

. . .

3 3 2 900 2.026657E+02 -9.241322E+01

Head of section

Wave period#, direction#, symmetric quadrant#, panel#, pressure amplitude and phase in degrees

(Each element per line)


Note:  The symmetric quadrant# is defined as:

=1, original defined part

=2, fore-aft symmetric mirror part, or port-starboard mirror part if no fore-aft symmetry

=3, port-starboard mirror part for double symmetry

=4, both port-starboard and fore-aft mirror part


The figure above shows the quadrant definition of a structure with both port-starboard and fore-aft symmetries.

1.3.1.7. Submerged Portion of Morison (Circular or Slender Tube) Element Information

Data ExampleDescription

MORI

4

-1.338000E-14 1.100000E+02 -1.600000E+01 … -1.800000E+01

. . .

-1.338000E-14 1.100000E+02 -2.200000E+01 … -2.400000E+01

Head of section

Number of tube elements on the structure specified by Arg2

The coordinates of both ends of each tube element

(Each element per line)

1.3.1.8. Hydrodynamic Properties for Morison (Circular or Slender Tube) Element

This section starts with the head of WKIN.

Data Example

WKIN

1 1 1 1 1.003998E+04 -7.552587E+00 1.021469E+00 -7.553463E+00

1.828502E-08 0.000000E+00 1.177030E-01 1.713469E+02 1.422377E-01 -9.755307E+01

1.828502E-09 0.000000E+00 1.177030E-02 8.134686E+01 1.422377E-02 1.724469E+02

1 1 2 1 1.001140E+04 -7.552589E+00 1.021469E+00 -7.553463E+00

1.521766E-08 0.000000E+00 1.174471E-01 1.713487E+02 1.368054E-01 -9.755041E+01

1.521766E-09 0.000000E+00 1.174471E-02 8.134869E+01 1.368054E-02 1.724496E+02

. . .

3 3 2 4 2.492100E+01 -8.863081E+01 1.064647E+00 -1.022414E+02

2.100582E-08 0.000000E+00 9.376872E-03 -9.893481E+01 5.666318E-04 1.759362E+02

3.781048E-08 -6.068127E+01 1.687837E-02 1.710652E+02 1.019937E-03 8.593623E+01

The hydrodynamic properties at each end of a tube element are listed:

  • Frequency#, direction#, end# (1 or 2), tube element#, pressure RAO amplitude and its phase in degrees, disturbed wave elevation RAO amplitude and its phase in degrees (on the first line)

  • Disturbed wave fluid particle velocity component amplitude/unit incident wave amplitude, fluid particle velocity component phase for X-, Y-, and Z-directions respectively (on the second line)

  • Disturbed wave fluid particle acceleration component amplitude/unit incident wave amplitude and its phase for X-, Y-, and Z-directions respectively (on the third line)

1.3.1.9. Motion RAOs of the Structure

This section starts with the head of RAOs, follows the coordinate of the structure’s COG, then prints out the rigid body RAOs at each wave condition.

Data Example

RAOS

-1.535147E-18 1.100000E+02 -2.294689E-03

1 1 2.784748E-07 1.093613E+01 1.190639E+00 -9.857194E+01 1.009199E+00 -7.553491E+00

6.968560E-02 -9.852795E+01 2.228333E-07 -7.664600E+00 8.980071E-08 -7.664600E+00

1 2 8.389516E-01 8.457838E+01 8.414857E-01 -9.672118E+01 1.008428E+00 -5.313809E+00

4.924569E-02 -9.665730E+01 4.926293E-02 -9.542229E+01 3.434754E-02 -5.528811E+00

. . .

3 3 2.388124E-09 2.082282E+03 5.006407E-03 2.086029E+03 2.149719E-04 2.235996E+03

6.742916E-03 2.153189E+03 1.999369E-08 2.082282E+03 2.417742E-08 2.082282E+03

For each pair of wave frequency and wave direction, the rigid body motion RAOs are listed:

  • Wave frequency#, wave direction#, translational RAO amplitude and phase in degrees (on the first line)

  • Rotational RAO amplitude in degrees and phase in degrees for X-, Y-, and Z-axes (on the second line)

1.3.1.10. Rigid Body Mass Matrix

This section starts with the head of MASS, follows the coordinate of the structure's COG, and then lists the 6x6 matrix of the structural mass and moment of inertia.

Data Example

MASS

-1.535147E-18 1.100000E+02 -2.294689E-03

4.161978E+07 0.000000E+00 0.000000E+00 0.000000E+00 0.000000E+00 0.000000E+00

0.000000E+00 4.161978E+07 0.000000E+00 0.000000E+00 0.000000E+00 0.000000E+00

0.000000E+00 0.000000E+00 4.161978E+07 0.000000E+00 0.000000E+00 0.000000E+00

0.000000E+00 0.000000E+00 0.000000E+00 1.245694E+10 2.117582E-22 2.487256E-05

0.000000E+00 0.000000E+00 0.000000E+00 2.117582E-22 9.991993E+10 -5.960464E-08

0.000000E+00 0.000000E+00 0.000000E+00 2.487256E-05 -5.960464E-08 1.125300E+11

1.3.1.11. Equivalent Acceleration RAOs of the Structure

This section starts with the head of MASS, follows the coordinate of the structure's COG, then the translational equivalent acceleration RAOs (see Effective Nodal Acceleration RAOs) and the rotational acceleration RAOs of the structure at each wave condition are listed.

Data Example

GRAO

-1.535147E-18 1.100000E+02 -2.294689E-03

1 1 3.547333E-08 -6.461435E+00 2.279588E-05 -7.488667E+01 1.009199E-02 -1.875535E+02

6.968561E-04 8.147206E+01 2.228334E-09 -7.664600E+00 8.980071E-10 -7.664600E+00

1 2 5.284973E-01 -9.542162E+01 5.301221E-01 8.327782E+01 6.453942E-01 -1.853138E+02

. . .

3.151724E-02 8.334270E+01 3.152828E-02 8.457772E+01 2.198243E-02 1.744712E+02

3 3 9.928569E-09 2.082282E+03 1.580860E-02 2.262171E+03 6.965090E-04 2.055996E+03

2.184704E-02 1.973189E+03 6.477955E-08 2.082282E+03 7.833484E-08 2.082282E+03

For each pair of wave frequency and wave direction, the equivalent acceleration RAOs (including equivalent gravity effects) are listed as follows:

  • Wave frequency#, wave direction#, translational equivalent acceleration RAO amplitude and phase in degrees (on the first line)

  • Rotational acceleration RAO amplitude in degrees and phase in degrees for X-, Y-, and Z-axes (on the second line)

1.3.2. *.aqw File

This is an Aqwa-Wave Neutral file, which contains the following sub-sections:

1.3.2.1. File Title

This section contains the Aqwa2Neut version number, the copyright statement, the hydrodynamic database name (without an extension), the structure sequence number, the date and time when this file was generated, and the phase reference information.


Note:  For a structure in a hydrodynamic interaction structure group, the phase is referenced to the center of gravity (COG) of the first structure in that group.


1.3.2.2. Wave Period

Data ExampleDescription

PERD

3

6.283186E+01 7.853982E+00 3.490659E+00

Head of section

Number of wave periods of the structure specified by Arg2

Wave periods in seconds, up to 10 values per line

1.3.2.3. Wave Direction

Data ExampleDescription

DIRN

3

-9.000000E+01 -4.500000E+01 9.000000E+01

Head of section

Number of wave directions of the structure specified by Arg2

Wave periods in degrees, up to 10 values per line

1.3.2.4. Submerged Panel Information

This section lists the nodal coordinates of each submerged quadrilateral and triagonal panel, including the diffraction panels on the moonpool hull surfaces (if available).

Data ExampleDescription

HYDR

1.000000E+00 9.806650E+00

0 1

1800

7.474338E+01 8.000000E+01 -2.501363E+00 ... -2.505109E+00

. . .

-3.500000E+01 1.000000E+02 -5.000000E+00 ... -2.500000E+00

Head of section

1.0, acceleration due to gravity

Indicators of post-starboard and fore-aft symmetries

Total number of submerged panels on whole hull surface

Coordinates of four nodes of each panel

(Each element per line)


Note:  The third and fourth nodal coordinates are identical for any triagonal panel.

For the indicator of the structure surface post-starboard symmetry:

=0, no symmetry

=1, port-starboard symmetry

For the indicator of the structure surface fore-aft symmetry:

=0, no symmetry

=1, port-starboard symmetry


1.3.2.5. Hydrodynamic Pressure on Submerged Panel

This section starts with the header of PRES, then follows the pressure data for each submerged hull surface panel.

Data Example

PRES

6.283186E+01 -9.000000E+01 1 1 8.326482E+01 1.733430E+02 -8.325195E+01 -1.464111E+00

6.283186E+01 -9.000000E+01 1 2 5.397807E+01 1.725890E+02 -5.397754E+01 -2.388916E-01

. . .

3.490659E+00 9.000000E+01 2 900 2.026657E+02 -9.241322E+01 1.960361E+02 -5.141223E+01

The output data for each panel per line consists of the following:

Wave period in seconds, direction in degrees, symmetric quadrant#, panel#, pressure RAO amplitude and its phase in degrees, including real and imaginary parts of pressure RAO.


Note:  The symmetric quadrant# is defined as:

=1, original defined part

=2, fore-aft symmetric mirror part, or port-starboard mirror part if there is no fore-aft symmetry

=3, port-starboard mirror part for double symmetry

=4, both port-starboard and fore-aft mirror part


1.3.2.6. Rigid Body Mass Matrix

This section starts with the head of MASS, follows the coordinate of the structure’s COG, and then lists the 6x6 matrix of the structural ass and moment of inertia.

Data Example

MASS

-1.535147E-18 1.100000E+02 -2.294689E-03

4.161978E+07 0.000000E+00 0.000000E+00 0.000000E+00 0.000000E+00 0.000000E+00

0.000000E+00 4.161978E+07 0.000000E+00 0.000000E+00 0.000000E+00 0.000000E+00

0.000000E+00 0.000000E+00 4.161978E+07 0.000000E+00 0.000000E+00 0.000000E+00

0.000000E+00 0.000000E+00 0.000000E+00 1.245694E+10 2.117582E-22 2.487256E-05

0.000000E+00 0.000000E+00 0.000000E+00 2.117582E-22 9.991993E+10 -5.960464E-08

0.000000E+00 0.000000E+00 0.000000E+00 2.487256E-05 -5.960464E-08 1.125300E+11

1.3.3. *.ahf File

This is an Ansys Neutral file, which contains the panel geometric information and the first order hydrodynamic force distribution on the submerged hull surface panels, the submerged tube geometric information and the wave elevations, pressures/velocities/accelerations of submerged sections of the tubes.

The force on the submerged hull surface panel includes the effective gravity force component, which is described in Total First Order Hydrodynamic Force at Panel Centroid in *.ahf File.

1.3.3.1. File Title

This section contains the Aqwa2Neut version number, the copyright statement, the hydrodynamic database name (without an extension), the structure sequence number, the date and time when this file was generated, and the phase reference information.


Note:  For a structure in a hydrodynamic interaction structure group, the phase is referenced to the center of gravity (COG) of the first structure in that group.


1.3.3.2. Wave Period

Data ExampleDescription

PERD

3

6.283186E+01 7.853982E+00 3.490659E+00

Head of section

Number of wave periods of the structure specified by Arg2

Wave periods in seconds, up to 10 values per line

1.3.3.3. Wave Direction

Data ExampleDescription

DIRN

3

-9.000000E+01 -4.500000E+01 9.000000E+01

Head of section

Number of wave directions of the structure specified by Arg2

Wave periods in degrees, up to 10 values per line

1.3.3.4. General Global Parameters

Data ExampleDescription

GENE

1.000000E+03 1.025000E+03 9.806650E+00 2

Head of section

Water depth and density, acceleration due to gravity, structure symmetry indicator


Note:  The symmetry indicator here is defined in the following structural hull surface symmetric cases:

=0, no symmetry

=1, port-starboard symmetry

=2, fore-aft symmetry

=3, port-starboard and fore-aft symmetry


1.3.3.5. Submerged Panel Information

This section lists the nodal coordinates of each submerged quadrilateral and triagonal panel. The submerged external hull surface panels and the diffraction panels on the moonpool hull surfaces (if available) are included. The third and fourth nodal coordinates are identical for any triagonal panel.

Data ExampleDescription

HYDR

1800

7.474338E+01 8.000000E+01 … -2.505109E+00

. . .

-3.500000E+01 1.000000E+02 … -2.500000E+00

Head of section

Total number of submerged panels on whole hull surface

Coordinates of four nodes of each panel

(Each element per line)

This section lists the nodal coordinates of each submerged quadrilateral and triagonal panel, including the diffraction panels on the moonpool hull surfaces (if available). The third and fourth nodal coordinates are identical for any triagonal panel.

Data ExampleDescription

HYDR

1800

7.474338E+01 8.000000E+01 … -2.505109E+00

. . .

-3.500000E+01 1.000000E+02 … -2.500000E+00

Head of section

Total number of submerged panels on whole hull surface

Coordinates of four nodes of each panel

(Each element per line)

1.3.3.6. Hydrodynamic Force on Submerged Panels

This section starts with the head of FORC, then follows the force data for each submerged hull surface panel.

Data Example

FORC

1 1 1 1 3.631375E-04 1.505261E+02 5.105616E+02 1.733430E+02 2.817958E+02 -9.852795E+01

1 1 1 2 1.225392E-04 1.505261E+02 3.357336E+02 1.725890E+02 9.509081E+01 -9.852795E+01

. . .

3 3 2 900 9.941300E-05 -1.261393E+02 1.266661E+03 8.758663E+01 2.772560E+01 1.731890E+02

The output data for each panel per line consists of the following:

Wave period#, direction#, symmetric quadrant#, panel#, the first order hydrodynamic force RAO amplitude and phase in degrees in X-, Y-, and Z-direction respectively.


Note:  The symmetric quadrant# is defined as:

=1, original defined part

=2, fore-aft symmetric mirror part, or port-starboard mirror part if there is no fore-aft symmetry

=3, port-starboard mirror part for double symmetry

=4, both port-starboard and fore-aft mirror part


1.3.3.7. Submerged Portion of Morison (Circular or Slender Tube) Element Information

Data ExampleDescription

MORI

4

-1.338000E-14 1.100000E+02 -1.600000E+01 … -1.800000E+01

. . .

-1.338000E-14 1.100000E+02 -2.200000E+01 … -2.400000E+01

Head of section

Number of tube elements on the structure specified by Arg2

The coordinates of both ends of each tube element

(Each element per line)

1.3.3.8. Hydrodynamic Properties for Morison (Circular or Slender Tube) Element

This section starts with the head of WKIN.

Data Example

WKIN

1 1 1 1 1.003998E+04 -7.552587E+00 1.021469E+00 -7.553463E+00

1.828502E-08 0.000000E+00 1.177030E-01 1.713469E+02 1.422377E-01 -9.755307E+01

1.828502E-09 0.000000E+00 1.177030E-02 8.134686E+01 1.422377E-02 1.724469E+02

1 1 2 1 1.001140E+04 -7.552589E+00 1.021469E+00 -7.553463E+00

1.521766E-08 0.000000E+00 1.174471E-01 1.713487E+02 1.368054E-01 -9.755041E+01

1.521766E-09 0.000000E+00 1.174471E-02 8.134869E+01 1.368054E-02 1.724496E+02

. . .

3 3 2 4 2.492100E+01 -8.863081E+01 1.064647E+00 -1.022414E+02

2.100582E-08 0.000000E+00 9.376872E-03 -9.893481E+01 5.666318E-04 1.759362E+02

3.781048E-08 -6.068127E+01 1.687837E-02 1.710652E+02 1.019937E-03 8.593623E+01

The hydrodynamic properties at each end of a tube element are as follows:

  • Frequency#, direction#, end# (1 or 2), tube element#, pressure RAO amplitude and its phase in degrees, disturbed wave elevation RAO amplitude and its phase in degrees (on the first line)

  • Disturbed wave fluid particle velocity component amplitude/unit incident wave amplitude, fluid particle velocity component phase for X-, Y-, and Z-directions respectively (on the second)

  • Disturbed wave fluid particle acceleration component amplitude/unit incident wave amplitude and its phase for X-, Y-, and Z-directions respectively (on the third line)

1.3.3.9. Motion RAOs of the Structure

This section starts with the head of RAOS, follows the coordinate of the structure’s COG, and then outputs the RAOs at each wave condition.

Data Example

RAOS

-1.535147E-18 1.100000E+02 -2.294689E-03

1 1 2.784748E-07 1.093613E+01 1.190639E+00 -9.857194E+01 1.009199E+00 -7.553491E+00

6.968560E-02 -9.852795E+01 2.228333E-07 -7.664600E+00 8.980071E-08 -7.664600E+00

1 2 8.389516E-01 8.457838E+01 8.414857E-01 -9.672118E+01 1.008428E+00 -5.313809E+00

4.924569E-02 -9.665730E+01 4.926293E-02 -9.542229E+01 3.434754E-02 -5.528811E+00

. . .

3 3 2.388124E-09 2.082282E+03 5.006407E-03 2.086029E+03 2.149719E-04 2.235996E+03

6.742916E-03 2.153189E+03 1.999369E-08 2.082282E+03 2.417742E-08 2.082282E+03

For each pair of wave frequency and wave direction, the rigid body motion RAOs are listed:

  • Wave frequency#, wave direction#, translational RAO component amplitude and phase in degrees (on the first line)

  • Rotational RAO component amplitude in degrees and phase in degrees for X-, Y-, and Z-axes (on the second line)

1.3.3.10. Rigid Body Mass Matrix

This section starts with the head of MASS, then follows the coordinate of the structure’s COG. The 6x6 matrix of the structural ass and moment of inertia is listed.

Data Example

MASS

-1.535147E-18 1.100000E+02 -2.294689E-03

4.161978E+07 0.000000E+00 0.000000E+00 0.000000E+00 0.000000E+00 0.000000E+00

0.000000E+00 4.161978E+07 0.000000E+00 0.000000E+00 0.000000E+00 0.000000E+00

0.000000E+00 0.000000E+00 4.161978E+07 0.000000E+00 0.000000E+00 0.000000E+00

0.000000E+00 0.000000E+00 0.000000E+00 1.245694E+10 2.117582E-22 2.487256E-05

0.000000E+00 0.000000E+00 0.000000E+00 2.117582E-22 9.991993E+10 -5.960464E-08

0.000000E+00 0.000000E+00 0.000000E+00 2.487256E-05 -5.960464E-08 1.125300E+11

1.3.3.11. Acceleration RAOs of the Structure

This section starts with the head of ARAO, follows the coordinate of the structure’s COG, then outputs the acceleration RAOs at each wave condition.

Data Example

ARAO

-1.535147E-18 1.100000E+02 -2.294689E-03

1 1 2.784748E-09 -7.664600E+00 1.190639E-02 8.142807E+01 1.009199E-02 -1.875535E+02

6.968561E-04 8.147206E+01 2.228334E-09 -7.664600E+00 8.980071E-10 -7.664600E+00

1 2 5.369290E-01 -9.542162E+01 5.385510E-01 8.327883E+01 6.453942E-01 -1.853138E+02

3.151724E-02 8.334270E+01 3.152828E-02 8.457772E+01 2.198243E-02 1.744712E+02

. . .

3 3 7.737522E-09 2.082282E+03 1.622076E-02 1.906029E+03 6.965090E-04 2.055996E+03

2.184704E-02 1.973189E+03 6.477955E-08 2.082282E+03 7.833484E-08 2.082282E+03

For each pair of wave frequency and wave direction, the rigid body motion acceleration RAOs are listed:

  • Wave frequency#, wave direction#, translational acceleration RAO amplitude and phase in degrees (on the first line)

  • Rotational acceleration RAO amplitude in degrees and phase in degrees for X-, Y-, and Z-axes (on the second line)

1.3.4. Error Code Explanations

The error codes may be output when running the program. The error codes and their explanations are listed in Table 1.3: Error Codes and Explanations.

Table 1.3: Error Codes and Explanations

Error CodeExplanation
1001No Aqwa2Neut argument is defined
1002Aqwa database file does not exist
1003Structure number is less than 1
1004Arg3 is not properly defined
1005Arg3 > 5
1006Arg4 is not properly defined
1007Failed to read Aqwa model *.dat file
1008Failed to create *.xml file
1009Failed to read *.res file
1010Arg2 (Structure#) is outside the range of structures in the model
1012Aqwa database has hydrostatic data only
1013Aqwa model has no panel element
1014Not valid for forward speed case
1015Allocation failed
1016Failed to access *.PAC file
1017Failed to access *.USS file