USER MANUAL
June 2016
This document has been prepared for the users of HydroStar for version V7.3 and above and
deals with the aspects related to the computation of first and second order loads and motions
for arbitrary bodies in deep and finite depth waters, with or without forward speed.
Research Department
BUREAU VERITAS
92571 Neuilly-Sur-Seine
Tel: +33 (0)1 55 24 70 00
Fax: +33 (0)1 55 24 70 26
c
Bureau Veritas
Contacts:
Guillaume de HAUTECLOCQUE
e-mail: guillaume.de-hauteclocque@bureauveritas.com
Charles MONROY
e-mail: charles.monroy@bureauveritas.com
Cong YU
e-mail: cong.yu@cn.bureauveritas.com
Version 6.00:
• Correction of bug in hsrdf for finite water depth and when no symmetry condition was
used (example, multi-body in finite water depth).
• Correction of bug in hsmcn on the hydrostatic stiffness for the applications with tanks
• Modification of hsmcn for the applications with tanks: the global mechanical properties
including the liquid in tanks must be given
• Modification of the limit on the number of characters of the input files. The name of the
input files was limited in the previous versions to 15 characters and has been extended to
80 characters
• Modification of the limit on the number of characters of the FILENAME used in the input
file of hsrdf and hsmcn . In the previous versions the limit was 3 characters. It has been
extended to 15 characters.
• Modification of hsrsn . Not only the resonance frequencies are displayed in the screen,
but also the Eigen vectors associates to each resonant mode.
• Use of "LU decomposition" for the solution of the linear system instead of "Gauss Elimi-
nation".
• Modification of computation progress display in hsrsn . The computation time for each
frequency as well as the remaining computation time are displayed in the screen.
Version 6.10:
• Middle-Field implementation improved in hsqtf , the control surface can now coincide
with the free surface, this leads to better convergence
• Manual updated (phase convention error corrected and more details about the 2nd order
calculations)
• Spectral tool "StarSpec v1.10’ included. hspec and hslps are available in HydroStar console.
For further information, refer to StarSpec user guide.
Version 6.11:
• HSlec (bug fixed) : Automatic free-surface generation in some multi-body cases fixed
• HSchk (bug fixed) : Visualisation of sections for bodies with very low draft
• HSmcn (new) : Calculation of multi-body cases with internal tanks (in only one body)
• HSmcn (improved) : Beam damping model linearisation improved for better convergence
• HSqtf (bug fixed) : Number of heading in HSqtf calculation not limited to 50 anymore
• HSrao (bug fixed) : Ariane7 output when HSdft is not run works
• HSpec (bug fixed) : Problem with m2 calculation when using both speed and spreading
fixed
• HSqtf (bug fixed) : Correction of vertical 2nd order loads (Affected only moments Mx
and My with Near-Field formulation.)
Version 7.00:
• General (new) : MPI parallelization of HSrdf, HSdft, HSqtf, HSprs, HSamg , HSwld and
HSmod (see 12)
• HSpg2 (new) : High frequency 2nd order loads (see section 10.4)
• General (Warning) : Temporary binary files are not compatible with previous version,
Project has to be performed with v7.0 from the start (hslec ).
• HSmcn (new) : Can take into account internal tanks in different bodies (6.2.6)
• HSqtf/HSdft (bug fixed): Correction in the calculation of vertical moment (My and Mx)
second order loads.
• HSrao (new) : New RAO format, file contains both amplitude and phase.
• HSrao (new) : Picture output to different format (jpg, png, eps, emf...)
• HSpec (new) : Time domain reconstruction, rainflow counting (see StarSpec user manual)
NOTE : The HSrao module has been re-written and the output format changed. If for some
reason the old-formats required, the old executable is available with the command ’old-hsrao’.
Version 7.01:
• HSpec (new) : Enhanced design wave calculation (see StarSpec user manual).
• HSrao (bug fixed) : Header of RWE raos now displays the correct forward speed value.
Version 7.02:
• HSpec (bug fixed) : RAO symmetrisation when heading provided from 180 to 360
Version 7.03:
• HSrdf (bug fixed) : problem with forward speed and no symmetry (x64 only)
Version 7.1:
• HSrao (new) : Output of pressure inside tank (INTANKPRS, see section 11.1.5)
• HSprv (new) : New module to output paraview animations (see section 13)
• HSrao (new) : Option "AT" for decomposed pressure (see section 11.1.5)
• HSwld (new) : Internal load calculation with additional stiffness matrix (see section 7.1)
• HSpec (new) : Output of roll RAOs for each sea-state when stochastic linearisation is
used.
• HSdft (improved) : For calculation with forward speed, convective term taken into ac-
count.
• HSrsn (new) : Output of the amount of wave damping in percentage of the critical
damping for each eigen mode.
• Manual (improved) : Additional explanations and corrections have been included in the
manual
Version 7.2:
• StarViewer (New) : Interactive tools to visualize RAOs and QTFs (svplt command)
• Wave calculator (New) : Interactive tools that solves the scattering relationship (com-
mand "wavecalc")
• General (New) : Command "testRLM" to test the license in the dos shell
• Documentation : Tutorials added (Quadratic roll damping, internal loads for non-slender
bodies)
• HSdft/HSqtf (bug correction) : Calculation of 2nd order vertical loads with non vertical
waterline panels (correction in HSlec).
• HSdft (bug correction): Mean drift calculation with forward speed, when several headings
are calculated
Version 7.21:
Version 7.22:
• HSchk (Improved) : Tank meshes are also checked (not only hull)
• General : MPI library switched from MPICH2 to intelMPI (intelMPI does not require
administrator privilege to run properly)
• General : From v7.3 HydroStar supports only 64bits OS. HydroStar v7.25 is the last
version supporting 32bits OS
• StarViewer (change) : "hsplt" command now launches StarViewer. Old display (gnuplot)
is moved to "gnplt"
• HStat (New) : More general way to input mass distribution (see 7.1)
Release Notes 1
Introduction 1
1 Getting Started 4
1.1 Hardware configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.2 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.3 HydroStar interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.4 Running tests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2 Overview 7
2.1 HydroStar structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2.2 Conventions used in HydroStar . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
2.3 Units used in HydroStar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
4 Mesh Generation 41
4.1 Mesh conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
4.2 Single simple geometry mesh generation . . . . . . . . . . . . . . . . . . . . . . 42
4.3 Bodies composed by various simple geometries . . . . . . . . . . . . . . . . . . . 47
4.3.1 Example of Input file for hsmsh . . . . . . . . . . . . . . . . . . . . . . . 52
4.3.2 Generating the mesh using hsmsh . . . . . . . . . . . . . . . . . . . . . . 52
4.4 Use AMG to generate Mesh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
4.5 Mesh equilibrium . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
4.6 Mesh cutting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
6 Motion Computation 64
6.1 Input data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
6.2 Input file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
6.2.1 Centre of Gravity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
6.2.2 Gyration Radius . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
6.2.3 Inertia Matrix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
6.2.4 Stiffness Matrix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
6.2.5 Damping Matrix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
6.2.6 Internal tank in multi-body calculation . . . . . . . . . . . . . . . . . . . 73
6.2.7 Adding Morison elements to the model . . . . . . . . . . . . . . . . . . . 73
6.2.8 Wave-current interaction formulation . . . . . . . . . . . . . . . . . . . . 76
6.2.9 Pendulum mechanics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
6.3 Computing the vessel’s motions . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
8 Waves visualization 85
A Examples A–1
A.1 Example 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A–1
A.2 Example 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A–16
HydroStar is the hydrodynamic software developed in Bureau Veritas since 1991, that provides
a complete solution of first order problem of wave diffraction and radiation and also the QTF
of second order low-frequency wave loads for floating body with or without forward speed in
deep water and in finite water depth. Theoretical details can be found in the numerous papers
available in the "Doc" folder of HydroStar installation directory. [1] provides a good overview
of the theoretical background of hydrostar.
For the versions 4.0 and above, the QTF (Quadratic Transfer Function) of second-order
wave loading can be computed by using three different formulations: the new middle-field
formulation plus the classical near-field formulation consisting of direct pressure integration
and the far-field formulation derived from the theorem of momentum conservation. In version
5.0 the near-field and middle-field formulations have been extended to the case of cross waves
not only for the calculation of mean drift loads but also for the QTF of low-frequency loads.
Additionally, the control surface needed when middle-field is used can be now automatically
generated by the program.
• Fairly perfect fluid formulation: In the classical potential theory there’s no limit
in predicting resonant wave kinematics while the resonant motion is in reality largely
damped by different mechanisms. In order to avoid unrealistic resonant wave motion, we
have added a fictitious force to the momentum equation in the same way as Guével (1982)
to represent the energy dissipation of various sources without modifying the inviscid and
irrotational properties. As a result a dissipation term is present in the classical boundary
condition over the free surface. The formulation of the so-called "fairly-perfect fluid"
is a sound-basis applicable for a number of analysis. One example of application is the
prediction of wave kinematics in the gap between two vessels in side-by-side configuration.
• Green function and influence coefficients: The integral equation of the first-order
boundary value problem is derived by making use of the Green theorem. The Green
function involved in the wave diffraction and radiation problem is then formulated as the
fundamental solution expressed by the Fourier-Hankel integral. The finite depth Green
function is decomposed into the deepwater Green function and two regular functions rep-
resenting the effect of the seabed. The regular functions are then evaluated accurately and
At the first-order, the effects of directionality may be obtained by a simple sum of the
effects of the uni-directional waves independently. However, for the second-order loads,
the interaction between two waves coming from different directions may lead to additional
loading term that could represent an important part of the total second-order load acting
on the system. In HydroStar , the near-field and the middle-field formulations have been
extended to the case of cross waves. Not only the mean drift loads, but also the full QTF
of low-frequency loads can be computed.
In order to simplify the understanding of this user manual, the first two chapters provide
preliminary information on the installation and conventions used in the software, followed by
the chapters which are organized in the order of the execution of HydroStar in its common
applications.
Getting Started
This chapter provides instructions for the installation of HydroStar and for making test runs in
order to check if the installation was well done.
1.2 Installation
In order to install HydroStar , the user must follow the steps below:
1. Install the program Run the "HydroStar_vx.x" installer and follow the instruction (re-
quires administration privilege). The setup of HydroStar can be now downloaded on the
website www.veristar.com.
2. Install the licence To install the license, use the shortcut "Set license" that should have
been created in "start => Program/Bureau Veritas/HydroStar". If your license is a
node-locked one, browse to your license file and click install. If the license is a server one,
indicate the server name and port (default is 5053) and click install.
If there’s any problem in installing HydroStar please contact your local HydroStar support.
Hstar>>
To find out the working directory, type "pwd" and to change directory, just type cd
"path":
Hstar>>pwd
C:/BVeritas/Hydrostar
Hstar>>cd c:/hydro/study
Hstar>>man
To run the test examples the user may follow the instructions provided in the following
chapters of this manual
Overview
• Multi-body interaction
• Inputs for air gap analysis, green water & slamming estimation
Some secondary modules are available in addition to the ones listed above. Those modules
are used or for pre-processing purpose or for checking any result at intermediate stage of the
calculation.
The figure 2.1 represents a scheme of HydroStar including all of its modules.
The origin of the reference system used by HydroStar is at the free surface level. However, at
any input file, the user is able to define the z-coordinates with respect to any other point (e.g.
keel of the vessel). Let’s call this additional reference system as "user reference system".
The "user reference system" is only used for the input data. It needs to be parallel and
with its origin at the same vertical line as HydroStar reference system. If the origin of the
vertical axis is not at the free surface, the user needs to input the keyword (ZFSURFACE)
followed by the z-coordinate of the free surface given in the "user reference system". For
example, the user may define the z-coordinates of the mesh with respect to keel in the input
for hslec if in the same input file he defines ZFSURFACE equal to the draft. By default, the
ZFSURFACE is equal to 0 corresponding to HydroStar reference system.
NOTE: The keyword ZFSURFACE should be used in every input file where the origin of
the "user reference system" is not at the free surface. The results are always given in HydroStar
reference system (z=0 at the free surface).
The vessels translations surge, sway and heave are the motions in Ox, Oy and Oz re-
spectively. The vessel’s rotations roll, pitch and yaw are defined as follows:
• Roll is the rotation around the axis parallel to Ox through the reference point;
• Pitch is the rotation around the axis parallel to Oy through the reference point;
• Yaw is the rotation around the axis parallel to Oz through the reference point.
Regular incoming waves are described by their amplitude (a), frequency (ω) in rad/s and
heading (β). The wave heading is defined by the angle between the propagation direction and
the positive direction of the axis Ox.
270°
315° 225°
x
0
0° 180°
AF Midship FP
45° 135°
90°
If the wave reference point is taken equal to the calculation point, X = Xcal and Y = Ycal , the
incident wave elevation is given by (see also fig 2.3):
elevation
Figure 2.3:
Any other physical value of responses like vessel’s motions is written in the way:
U (t) = u cos(ωt + φ) (2.4)
with the amplitude u and the phase φ. The ratio between the response amplitude and wave
amplitude is called RAO:
RAO = u/a (2.5)
φ is often called as phase lead as it represents an advance comparing to waves. φ is the value
ouput by HSRAO when specifying the keyword PHASE
From HydroStar v7.00, all RAOs are output in this convention (Including RAO in
real/imaginary format, which where output with another convention in earlier releases)
NOTE 1: Attention should be made to the definition of the wave reference point
(REFWAVE) and to the calculation point, also called reference point (REFPOINT). The first
one defines the point where the wave is maximum at the instant zero. The other is the reference
point located on the body for the calculations. By default those points are taken equal to the
center of buoyancy for the radiation and diffraction computations (hsrdf ). For the motions
computations (hsmcn ), the default reference point is the center of gravity whereas the wave
origin is kept at the center of buoyancy. Obviously all the results obtained in hsrdf in the center
of buoyancy are transferred to the center of gravity, consistently, for the computations in hsmcn .
Length (L) m
Surface (S) m2
Volume (V ) m3
Mass (M ) Kg
Inertia (I) Kg.m2
Mass density (r) Kg/m3
Time (t) s
Gravity (g) m/s2
Forces (F ) N (= Kg · m/s2 )
Moments (M ) N ·m
Pressure (P ) m in waterhead
Speed m/s
The input of the mesh is performed by HydroStar using the module hslec (see fig 3.1).
Project
hslec
hschk
To run this module, the user is supposed to have already prepared the mesh. For preparation
of the mesh, refer to Chapter 3.
The hull geometry shall be represented by flat quadrilaterals or flat triangulars with
the normal vector oriented towards the fluid (see fig 3.2).
n1 n1
n4
−
→
n −
→
n
n2 n2
n3 n3
COORDINATES
where:
The format of the definition of the panel connectivity in the input file is as follows:
ENDPANEL
where:
The following key words shall be used in the input file for hslec module:
(default= no of lines on
NBNODES number of nodes
the nodes definition)
(default= no of lines on
NBPANEL number of panels
the panels definition)
ZONEDAMPING xmin xmax dltx ymin ymax dlty epslon dissipation zone
The figure (see fig 3.3) contains an example of the input file for hslec .
NBBODY 1
SYMMETRY_BODY 11
RHO 1025.0
GRAVITY 9.81
COORDINATES
1 0.10005E+02 0.00000E+00 -0.10821E+02
2 0.10005E+02 0.11428E+01 -0.92114E+01
.. .. .. ..
ENDCOORDINATES
PANEL TYPE 0
1 2 17 16
2 3 18 17
.. .. .. ..
ENDPANEL
ENDFILE
In the following sections of this chapter, some specific fonctionalities on the input of
the mesh are described in more details.
In case the mesh generated contains also the part of the vessel above the waterline, the mesh
should be divided into two parts: the submerged part actually used in the calculations and the
upper part only used for visualization. It means that during the construction of the mesh all
panels and nodes composing the submerged part should be grouped together in one block of
data (nodes and coordinates). In addition, there should be no panels cutted by the free surface.
When defining coordinates and nodes of the mesh, the user needs to specify which pan-
els compose the submerged part and which panels compose the upper part by given the first
and last panel number of each part.
The file displayed in figure 3.4 exemplifies the input file for hslec considering also the
part of the body above waterline.
PROJECT: SHIP
USER: BV
NBBODY 1
SYMMETRY_BODY ] 11
NUMFHULL 1 1 2105
NUMFPONT 1 2106 3758
COORDINATES
1 0.000000 0.000000 0.000000
2 8.140500 0.000000 -11.444000
.. .. .. ..
.. .. .. ..
3918 5.490700 0.000000 -10.874000
3919 5.577100 0.000000 -6.665400
ENDCOORDINATES
PANEL TYPE 0
2 3 37 36
3 4 38 37
.. .. .. ..
.. .. .. ..
3433 3434 3908 3907
3434 3435 3909 3908
ENDPANEL
ENDFILE
Figure 3.4: Example considering the part of the body above waterline
In the file above, the part of the hull below waterline is defined by the panels from 1
to 2105 identified by the keyword NUMFHULL, while the part of the hull above the
waterline is defined by the panels from 2106 to 3758 that can be identified by the keyword
NUMFPONT. In this case all the coordinates of nodes and panels are defined together,
although the user can clearly observe that the data can divided in two blocks. Another
possibility is to repeat the keywords COORDINATES & ENDCOORDINATES and
PANELS & ENDPANELS to define as many blocks of data as wanted.
The symmetry property is not used in the case of multi-body mesh. The whole hull
should be modelled.
It’s important to remark that the identification numbers of the nodes shall be unique.
It means that, in principal, there should be only one node with a certain identification number.
However, in case of multi-body it’s normally the case that the meshes are prepared separately
and the nodes number may be repeated for the two meshes. In order to solve this problem, the
keyword NODE0 is used after the keywords COORDINATES and PANELS to shift the nodes
numbers by the value defined after NODE0 and to guarantee that there’s no other node with
the same number.
Another useful possibility is to translate (in x- and y- direction) and rotate the mesh
(in the horizontal plane) by using the keywords TRANS and ROTA after the keyword COOR-
DINATES.
The reference systems are centered on the reference point of each body, but the axis re-
main parallel to the global mesh reference system.
The file displayed in figure 3.5 gives an example of input file for hslec .
NBBODY 2
NUMPANEL 1 1 728
NUMPANEL 2 2537 4942
NUMFPONT 1 729 2536
NUMFPONT 2 4943 7304
COORDINATES
1 0.83862E+01 0.00000E+00 -0.43537E+01
2 0.83862E+01 0.64438E+00 -0.37057E+01
.. .. .. ..
.. .. .. ..
6889 0.23743E+03 0.00000E+00 0.18145E+02
6890 0.23743E+03 0.00000E+00 0.18145E+02
ENDCOORDINATES
PANEL TYPE 0
1 2 21 20
2 3 22 21
.. .. .. ..
.. .. .. ..
6851 6808 6807 6850
6852 6809 6808 6851
ENDPANEL
ENDFILE
In the example file in figure 3.5, the command TRANS is used to translate the nodes
coordinates of the second body by 0.0m in the longitudinal direction and by −50.0m in the
transverse direction. The keyword ROTA is used to rotate the mesh by a angle of 0.2deg in the
horizontal plane. Thus, the nodes coordinates given in the input file are modified as follows:
x_no = x_no cos(θ) − y_no sin(θ) + trans_x
y_no = y_no sin(θ) + y_no cos(θ) + trans_y
Also, it should be noticed that the nodes numbers given for the two bodies are re-
peated. In this case, the keyword NODE0 has been used to shift the nodes numbers of the
second body by a value of 10000 which has been considered sufficiently big to avoid having
two nodes with the same number. In fact the nodes numbers of the second body will be equal
to no_node=no_node+no_NODE0
The mesh of the damping zone is made by HydroStar. It can have rectangular or cir-
cular shape. The following keywords should by included in the input file for hslec :
where:
ZONEDAMPING rmin rmax dltr θmin θmax dltθ epslon CTR xctr yctr
where:
rmin is the minimum radius value of the circular damping zone
dltr is the length of the panels of the damping zone mesh in the radial direction
dltθ is the delta angle of for the panels definition of the circular damping zone mesh
The file displayed in figure 3.8 gives an example of input file for hslec including a circu-
lar damping zone. The user may include several damping zones by repeating the command
line ZONEDAMPING.
PROJECT MONOCOLUMN
ZONEDAMPING 0.0 34.5 3.45 0.0 90.0 7.50 0.10 CTR 0.0 0.0
SYMMETRY_BODY 1 2
NUMPANEL 1 1 468
ZFSURFACE 38.0
COORDINATES
1 47.50000 0.00000 0.00000
2 47.09363 6.19999 0.00000
.. .. .. ..
.. .. .. ..
1727 5.22105 39.65779 50.00000
1728 0.00000 40.00000 50.00000
ENDCOORDINATES
PANEL TYPE 0
1 2 21 20
2 3 22 21
.. .. .. ..
.. .. .. ..
1723 1724 1726 1725
1725 1726 1728 1727
ENDPANEL
ENDFILE
In addition to the keywords used to described in the above sections, the following key-
words should be included to the input file for hslec with the aim of defining the mesh of the
tank(s):
The coordinates and panels of the tanks are defined in the same way as for the hull mesh. The
normal vectors of the panels used to describe the tanks are defined towards the fluid inside the
tank. The tanks meshes may be defined with respect to any point. By default the origin of
the tank mesh reference system is assumed to be at the free surface of the tank, otherwise the
value z_fsf should be provided in order to define the position of the free surface with respect
to the origin chosen to describe the tank mesh. If the tank is full, z_fsf should correspond
to the highest z-value of the tank in the origin chosen to describe the tank mesh. The REF-
PTANK defines the coordinates of the origin of the tank mesh in the hull mesh reference system.
For the definition of the panels of the tanks another value can be defined at the end of
the command line as below:
It should be mentioned that for the radiation problem inside the tanks, no damping is
obtained. However, in reality the energy is dissipated by viscous effects. The dissipation
parameter epsilon is used to simulate the effects of the viscousity within the assumptions of
the potential theory. It’s in fact an artificial damping and the epsilon parameter needs to be
calibrated against model tests. In addition, in this method, all the dissipation is assumed to
occur at the tanks walls.
The figure 3.9 presents an example of input file for hslec including two tanks. In this
example the origin of the tanks reference systems is located in the aft bulkhead and at the
bottom of each tank. In this way the value z_fsf defines the z-coordinate of the free surface of
the tank with respect to its bottom. Also in this example the REFPTANK coordinates are in
fact the coordinates of a point located at the centreline of the tank, at the aft bulkhead and
at the bottom of the tank expressed in the global system.
PROJECT TANKS
USER BV
SYMMETRY_BODY 1 1
NUMPANEL 1 1 1210
NBTANK 1
SYMMTANK 1 2
NUMTANK 1 1211 2366 1.42
REFPTANK 1 168.0 0.0 0.0 1025.0
COORDINATES 0
1 0.00000E+00 0.00000E+00 0.00000E+00
2 0.81405E+01 0.00000E+00 -0.11444E+02
...
...
3918 0.54907E+01 0.00000E+00 -0.10874E+02
3919 0.55771E+01 0.00000E+00 -0.66654E+01
ENDCOORDINATES
PANEL TYPE 0
2 3 37 36
3 4 38 37
...
...
3433 3434 3908 3907
3434 3435 3909 3908
ENDPANEL
ENDFILE
• For wave-current interaction, the surface geometry is arbitrary (elliptic shape is generally
the most efficient).
• For high-frequency second-order loads, the free-surface must be circular (the integral
being slowly convergent, semi-analytical integral are used for the "far-field" domain, those
analytical development are only available for a circular domain). Moreover, in the current
version of HydroStar, the free-surface has to be centered on (0.0 , 0.0)
example :
AUTOMATIC_SURF 300 12 136. 0.
RING 300 500 12 20
• Go to the work directory where the file is stored (see item 1.3 for information);
Before reading the mesh, the user needs to create a project. the project name chosen
is used to name all the binary files generated by HydroStar and used as input files for
the various modules as well as the control files that give intermediate results of the
calculations.
• To create a new project for which the results are stored (if the project is not created, the
default name used by HydroStar is "PRO"):
Hstar>>proj ship
Hstar>ship>
If other projects already exist in the working directory, the user may list all the
existing projects by typing:
Hstar>>lsproj
Hstar>ship>hslec shiplec.don
• It will appear, in HydroStar window, the values used as input data, the reference point
of incident wave and the positions of the reference point and the centre of buoyancy.
Hstar>proj>hsinf -g
• Number of symmetries;
• Number of panels;
• Body surface;
• Body’s volume;
• Centre of buoyancy
Hstar>proj>hschk
• Overlapped panels;
• Holes (neighbor-absences);
A report is printed on the screen giving the number of panels presenting any inconsistency.
hslec
hschk
hsrdf
hschk
hstat
hsrdf
Hstar>proj>hstat
• Hull Volume;
• Waterplane Area;
• Waterplane Inertia;
Figure 3.13:
3.11.1 Hview
hschk
hview
hsrdf
The visualization of the mesh is performed by HVIEW by just typing the command “hview” in
HydroStar window (see fig 3.16):
Hstar>proj>hview
Another window will be opened to display the mesh read by HydroStar (see fig 3.15). The
different component of the mesh (tanks, waterplane part, etc...) can be hidden or displayed
using the selection tree.
In contrast to Hvisu (3.11.2), the various component are all loaded in the viewer and can
be hidden/displayed by using the selection tree.
hschk
hvisu
hsrdf
The visualization of the mesh is performed by VISU4D by just typing the command “hvisu” in
HydroStar window (see fig 3.16):
Hstar>proj>hvisu
Another window will be opened for VISU4D with the mesh read by HydroStar (see fig 3.17).
In order to visualize the upper part of the mesh and the water-plane mesh given in in-
put file, the user has to type the command:
Hstar>proj>hvisu -t
And then obtain a picture of the complete mesh (see fig 3.19).
In case tanks are included in the input file for hslec, the user may visualize the hull
Hstar>proj>hvisu -T
NOTE: The command hvisu -T with T in capital letter (for the visualization of tanks)
should not be confused with the command hvisu -t (for the visualization of upper part of hull
and mesh for elimination of irregular frequencies).
Figure 3.18:
Figure 3.19:
There’s also the possibility of visualizing only a part of the mesh by typing:
Hstar>proj>hvisu -c
Then, the point where the user wants to cut the mesh will be required:
Through VISU4D, the user is able to change the visualization mode, the point of view,
to zoom in and out and rotate the mesh in a very user-friendly interface.
Please refer to appendix C in order to get more details about the use of VISU4D.
Mesh Generation
HydroStar provides two automatic mesh generators for simple geometries. The first one is
dedicated to single simple geometries, such like cylinders, barges, spheres, ect. The second one
is dedicated to bodies composed by several simple geometries.
In addition, the module AMG (Automatic Mesh Generation) provides the possibility of
automatic generation of ship meshes by just inputting the stations coordinates and some infor-
mation about the aft and forward parts of the vessel. This module can be used independently
from HydroStar .
Depending on the case, the file header might have to be adjusted manually (multi-body
analysis or coupling with sloshing...).
For instance, to convert a mesh from Wamit to HydroStar, the syntax would be :
Hstar>>convert wamitFile.gdf hydrostarFile.hst
The "convert" tool can also modify the number of symmetry used in the mesh. For example,
to convert half a hull (symmetry=1) to a full mesh (symmetry=0), the command would be :
Hstar>>convert -sym 1 0 sym1.hst sym0.hst
Warning : When the number of symmetry is increased (for instance with -sym 0 1), the
converter simply remove all starboard panels, which is of course only applicable to specific
cases.
• Cylinder
• Semi-sphere
• Elliptical cylinder
• box
The following commands shall be input in HydroStar window for the generation of each
type of geometry mentioned above:
• Cylinder:
i) Type "hsmsh -cs[symmetry_code]"
where:
=0 if no symmetry
symmetry_code =1 if symmetric around x axis
=2 if symmetric around x and y axi
ii) HydroStar will then require the following values in order to define the mesh:
R = radius of the cylinder;
H = height of the cylinder;
ntheta = number of panels along the circumference;
nH = number of panels in the cylinder height;
nR = number of panels in radial direction in the bottom of the cylinder.
Hstar>>cyl>>hsmsh -cs2
R,H,ntheta(0->PI/2),nH,nR(fond)=: 15 40 20 20 15
Output mesh file name : cyls2.dat
• Semi-sphere:
i) Type "hsmsh -ds[symmetry_code]"
where:
=0 if no symmetry
symmetry_code =1 if symmetric around x axis
=2 if symmetric around x and y axi
ii) HydroStar will then require the following values in order to define the mesh:
R = radius of the cylinder;
ntheta = number of panels along the circumference around z axis;
nphi = number of panels along the circumference around x / y axis
Hstar>>dsphe>>hsmsh -ds2
R,ntheta(0->PI/2),nphi = : 10 20 20
Output mesh file name : dsphs2.dat
• Elliptical Cylinder:
i) Type "hsmsh -es2"
ii) HydroStar will then require the following values in order to define the mesh:
iii) HydroStar generates a file named "cyls2.dat" with the appropriate format already
described here above.
Hstar>>ellyp>>hsmsh -es2
a,b,H,ntheta(0->PI/2),nH,nR(fond) = : 20 10 10 20 10 10
Outputmesh file name : cyls2.dat
• Box:
i) Type "hsmsh -bte"
ii) HydroStar will then require the following values in order to define the mesh:
L = length of the box;
B = breadth of the box;
T = height of the box;
nL = number of panels in length;
nB = number of panels in breadth;
nT = number of panels in height.
iii) HydroStar generates a file named "boite.don" with the appropriate format already
described here above.
Hstar>>boite>>hsmsh -bte
L,B,T= : 20 10 5
nL,nB,nT= : 20 10 5
Output mesh file name : boite.don
TYPE 1
OBS: This module only generates the mesh up to the free surface level.
The user may define rules for the discretization of the mesh. This option allows to re-
fine the mesh close to the free surface and/or close to the keel.
RULE id_rl cos(A1) cos(A2) (Rule for the refinement of the mesh)
where:
cos(A1) is the cosine of the first refinement angle
cos(A2) is the cosine of the second refinement angle
For example, if the user defines "RULE 1 0.0 0.0", which corresponds to A1 =90 and
A2 =90, the mesh will be uniform. If the user defines "RULE 1 0.90 0.0" the mesh will be more
refined at the left side.
After defining nodes and rules for the refinement of the mesh, the user can define ele-
ments or geometries to be meshed. Different elements can be used and composed together into
a single mesh:
• PATCH: A patch is a flat panel described by four nodes A B C D. In case of triangles, one
node should be repeated in the definition of the panel. The normal is oriented following
the right-hand rule.
where:
nb_el(AB) & nb_el(BC) correspond to the number of elements along the side
from node A to node B and the number of elements along the side from node B and C,
respectively.
id_rl(AB) & id_rl(BC) correspond to the refinement rule applied to the sides AB
and BC, respectively.
As an example, a barge can be decomposed in several "PATCHS" like in figure 4.7 below:
• CIRSEG: This type of element is used to represent a segment of circle as in the figure
4.8, where C is the node at the centre of the circle, R is the radius of the circle. A
and B are the two nodes that compose the segment. A segment of circle is defined as below:
CIRSEG CTR id_nd(C) RAD R ANG ang1 ang2 NODE id_nd(A) id_nd(B) C_NB
nb_el(AB) C_RULE id_rl(AB) H_NB nb_el(R) H_RULE id_rl(R)
where:
ang1 & ang2 are the first and last angle for the definition of the segment, respec-
tively. In the figure 4.8 the first angle is 0 deg and the last angle is 90 deg.
nb_el(AB) & nb_el(R) correspond to the number of elements in the segment from node
A to node B and the number of elements in the direction of the radius of the circle (R),
respectively.
• CIRCYL: It’s used to generate vertical cylinders or segments of cylinders like in figure
4.9. The following keywords are used to define a cylinder or a part of it:
CIRCYL CTR id_nd(A) id_nd(B) RAD radius(A) radius(B) ANG ang1 ang2 C_NB
nb_el(arc) C_RULE id_rl(arc) H_NB nb_el(height) H_RULE id_rl(height)
where:
radius(A) & radius(B) are the radius of the cylinder at the horizontal plane pass-
ing by node A, and the radius of the cylinder at the horizontal plane passing by node B,
respectively. In this way the radius of the cylinder may vary along its height.
ang1 & ang2 are the first and last angle for that define the cylinder in degrees.
For example, a cylinder with ang1 = 0.0 and ang2 = 360.0 means a complete cylinder.
nb_el(arc) & nb_el(height) correspond to the number of elements along the arc of
the cylinder and along the height of it, respectively.
#Nodes for the definition of the mesh (up to free surface only)
NODE 1 0.000 0.000 0.000
NODE 2 0.000 0.000 4.000
NODE 3 0.000 0.000 42.000
NODE 4 26.625 0.000 0.000
NODE 5 18.830 18.830 0.000
NODE 6 0.000 26.625 0.000
#Refinement Rules
RULE 0 0.00 0.00 #Uniform mesh
RULE 10 -0.95 0.00
RULE 99 -0.95 0.95
ENDFILE
NOTE: When the keyword INVERSE is used at the end of the command lines used to
generate the elements of the mesh, it means that the orientation of the normal vector is
inversed.
Hstar>>hsmsh inputfile
Immediately after running hsmsh the user may visualize the mesh generated by typing:
Hstar>>hvisu
The figure 4.11 represents the mesh generated using the example file in figure 4.10.
The input file for hslec named "proj.hst" is generated in the working directory.
Be carefull : In the new mesh reference the position of the center of gravity
will be changed !
Compared to a mesh directly generated at the equilibrate draft, the panel near the free
surface can not be as regular and refined.
Hstar>>hsbln input.bln
Hstar>>hscut input.cut
The radiation solutions are the potential flow around the vessel when the vessel moves in
the otherwise quiescent fluid. The added-mass is defined by the load on the vessel due
to its unit acceleration while the radiation damping is the ratio between the load and
vessel’s velocity. The matrices of added-mass and radiation damping are of 6 x 6 dimen-
sions for a single body and 6N x 6N dimensions for multi-body, where N is the number of bodies.
The diffraction solutions are the potential flow around the vessel remaining immobile in
incoming waves. The wave excitation loads are obtained by integrating the dynamic pressure
on the fixed vessel in incoming waves.
The module hsrdf of HydroStar solves the problem of diffraction and radiation around
fixed and floating bodies and it’s based on the following:
• Reference length;
The following keywords shall be used in the input file for hsrdf execution:
REFPOINT ibd x_ref, y_ref, z_ref reference point of the body (COB;0)
REFWAVE x_wave, y_wave reference point for incoming waves (COB)
* Note : When using SIDEWALL option, the keyword should be kept in the next module
that require a pressure calculation (HSprs, HSdft). HSqtf does not support yet the SIDEWALL
option.
The picture displayed in figure 5.1 presents an example of input file for hsrdf module:
FILENAME w26
FREQUENCY TYPE 2
WMIN 0.05
WMAX 1.45
WSTP 0.10
ENDFREQUENCY
HEADINGS TYPE 1
180.0 225.0 270.0 315.0 360.0
ENDHEADINGS
SPEEDS TYPE 0
1 0.0
ENDSPEEDS
WATERDEPTH infinity
ENDFILE
For a ship, the lowest irregular frequency is close to that estimated by above formula using
ship’s length, width and draught.
For a body of arbitrary geometry, the lowest irregular frequency is larger than that for a
box which can surround the body.
The irregular frequencies are eliminated in HydroStar by generating a mesh on the vessel’s
water-plane (that not necessarily covers all the water-plane area), and modifying the original
integral equation by extending the singularity support to the internal water-plane. Theoretical
details can be found in [9].
The user has the possibility of changing the ratio between the panel size of the mesh
and the panel size of the water-plane by inputting a value for COEFZ0 in the hull mesh in-
put file in order to get better accuracy of results for high frequency values, if desired (see fig 5.2).
In the following sea (|β| < π/2), ω can be close to zero. To avoid the singularity, spe-
cial treatments are provided in hsmcn (keyword ZEROENCFREQ). The boundary condition on
ship hull is linearized over uniform flow.
current interaction problem is equivalent to the sea-keeping problem of a body advancing with
a forward speed in the opposite direction of the current. The main asset of this formulation
is to respect completely the first order free surface condition taking into account terms of
order τ and neglecting only terms of order τ 2 , with τ = U ωe /g. The problem is solved with
the use of a modified Green function taking into account a low forward speed. First order
quantities like wave elevations are supposed to be slightly more accurately estimated with this
formulation, but the main objective of this method is to better evaluate second-order wave drift
forces in presence of a small current. To that end, interaction effects of steady flow on wave
diffraction-radiation has to be taken into account in the first order problem.
However, this method has a few drawbacks compared to the more simple encounter fre-
quency approximation. Firstly, its validity is restricted to low forward speeds. The formulation
can give inconsistent results for high numbers of τ . Then, it is more CPU-time demanding,
since three linear systems need to be solved (instead of one for the classical method). Finally,
with this method it is also necessary to mesh the free surface (see Fig.5.3).
Figure 5.3: In the wave-current formulation, it is necessary to also mesh the free surface. Here
we see the academic case of a truncated cylinder and its surrounding free surface.
There are a few incompatibilities if one chooses to use the wave-current interaction formu-
lation in the current version of HydroStar: only one body can be taken into account and the
program does not deal with internal tanks.
Theoretical details about wave-current interaction can be found in [6] and [7].
specified test or to limit the test duration in order to reduce the effects of wave reflections.
In the source panel method we use the Tank Green Function (TGF) which satisfies the
linearized free surface conditions as well as the conditions at the tank bottom and walls. In
fact the TGF may be written as a formal sum of Green Functions in open sea representing the
infinity images of the singularity with respect to the side walls.
∞
G (M, M ) =0
G0 (M, Mn0 ) (5.3)
X
n=−∞
where G0 (M, Mn0 ) is the open sea Green Function representing the potential at M due to the
nth image of the source at Mn0 .
However, the convergence of the direct computation of the infinite series is very slow.
A more efficient method consists to decompose the finite water depth TGF into two parts: a
finite series of the open sea Green Functions and an asymptotic part which may be regarded as
the remaining terms of the infinite series and expressed by two single integrals whose kernels
decrease exponentially with the integral variable.
2N +1 ∞
G= G0n + G02n + G02n+1 + G0−2n + G0−2n−1 (5.4)
X X
n=−2N −1 n=N +1
The main advantage of the above decomposition is the rapid convergence of the asymp-
totic part.
More theoretical details can be found in [10].
Hstar>proj>hsrdf input.rdf
The user has the possibility of running several times hsrdf in order to compute the
wave diffraction and radiation for additional frequencies that may be necessary just changing
the extension of results file in the input file and the definition of the wave frequencies. For
example, from looking at the RAO files, the user may notice some complementary frequencies,
e.g. on the resonance region, to perform a new run. Different runs of hsrdf can be combined
at the input file for hsmcn.
Several interpolation are available, the Overhauser spline is recommended. However, for
particular case where the hydrodynamic coefficients present sharp peaks, "Hermite" interpola-
tion can be more robust. (The required derivatives are evaluated so that the resulting Hermit
spline does not overshoot the original data.)
Hstar>proj>hstnk projrdf.don
The results obtained from hsrdf and hstnk will be combined when the motion computa-
tion will be done. Theoretical details can be found in [8]
Note : In case the tanks are full (no free-surface, the top of the tank is meshed), the
keyword FULLTANK should be added to the input file.
Motion Computation
The Newton’s Second law was applied to describe the motions of floating bodies and the
following motion equation was derived and it:
STIFFNESS_MATRIX TYPE itype BODY no_bodyi no_bodyj start line of stiffness matrix
definition
Stiffness_lines
ENDSTIFFNESS_MATRIX end line of stiffness matrix
definition
If itype = 0: the full stiffness matrix shall be given
(
The picture 6.1 presents an example of input file for hsmcn module:
FILENAME w26
MASS_BODY 1 1.13253E+08
COGPOINT_BODY 1 137.081 0.000 3.136
GYRADIUS_BODY 1 13.462 67.602 68.776 0.000 4.632 0.000
REFLENGTH 1.00
RHO 1025.0
REFWAVE 0.000 0.000
LINVISCOUSDAMPING 1 5.0 %
ENDFILE
In case of single body the keyword BODY may be omitted. However, in case of multi-
body it’s necessary to include it. If it’s not included all the values given are atributed to BODY
1 by default. Special attention should be paid to the stiffness matrices in case of multi-body,
where the numbers of the two bodies have to be given after the keyword BODY.
In case the user defines the mass of the body, gyration radius, centre of gravity and
reference point, the inertia matrix calculated by HydroStar has the following shape:
M 0 0 0 M.ZGC −M.YGC
0 M 0 −M.ZGC 0 M.XGC
0 0 M M.YGC −M.XGC 0
[M ] =
0
−M.ZGC M.YGC I44 I45 I46
0
M.ZGC −M.XGC I54 I55 I56
−M.YGC M.XGC 0 I64 I65 I66
where:
with:
+ XG , YG and ZG being the position of the centre of gravity in the mesh reference;
+ XCal , YCal and ZCal being the position of the calculation point.
M
Z
· I45 = I54 = − (x − XCal ) (y − YCal ) dm = I45G − M × XGC × YGC
M
Z
· I46 = I64 = − (x − XCal ) (z − ZCal ) dm = I64G − M × XGC × ZGC
M
Z
· I56 = I65 = − (y − YCal ) (z − ZCal ) dm = I56G − M × YGC × ZGC
M
The user can input the full Inertia matrix or choose to input the following data:
where:
In the case of a single body the matrix has the dimension 6x6. However in case of
multi-body the full stiffness matrix has the size 6Nx6N, where N is the number of bodies.
In order to simplify the input of data, the matrix in case of multi-body is divided in NxN
sub-matrices in the following way:
In the above matrix, the sub-matrices [K_BODY i i] with (i= 1, .., N ), represent the
stiffness of the bodyi due to the motions of the body i itself. The sub-matrices [K_BODY
i j] represent the stiffness of the body i due to the motions of the body j. And finally the
sub-matrices [K_BODY j i] represent the stiffness of the body j due to the motions of the body i.
In summary, when specifying the stiffness matrix in case of multi-body, the user needs
to define two bodies numbers after the keyword BODY. In the case of single body this keyword
can be omitted as by default HydroStar assumes BODY 1.
As an example, in case there are two bodies connected to each other the user may de-
fine four stiffness matrices as below:
Roll Damping
As it is written above, the appendages are generally not modellized in HydroStar mesh.
Moreover, the fluid model used in HydroStar is the perfect flow model without viscosity. But
viscosity and appendages increase the damping for roll motion in such an extent that it can’t
be neglicted. We suggest to use one of the following approximations to have a more realistic
roll damping:
· Linear damping in percentage of the critical damping is mostly used because it is certainly
the easiest way for ships and the one that need the less computation. We suggest these
approximation for ships:
where:
· ITH formulation should be used when the user have any geometrical informations about
the appendages. The ITH formulation is a semi-empirical formula. It separates the several
sources of roll damping according to :
where:
+ BF is the frictional dampings caused by the skin friction stress on the hull in roll
motions;
+ BE is the eddy making damping caused by the flow separation on the bottom of the
ship hull near the stem and stern and near the bilge circle at the midship portion;
+ BL is the lift damping corresponding to the linear part of the lifting effects on the
hull in roll motion when the ship has forward speed;
+ BW is the wave radiation damping, which is generated by the motions of the ship.
This parcel of damping is linear and is computed in the module hsrdf in HydroStar
4;
+ BBKN is the normal force on the bilge keels;
+ BBKH is the component representing the pressure changes on the hull due to the
presence of the bilge keels;
+ BBKW is the wave making damping caused by the bilge keels;
+ BSK is the normal force on skeg.
The input data required for the use of this formulation are the dimensions of the bilge keel
and skeg (if any) according to the figure 6.2.
x
xbk1 span
xbk2
height SKEG
BILGE
KEEL
length
Figure 6.2:
One should always compare its inputs with model tests, if one has some available. They are
still the most reliable method for the evaluation of the damping for roll motion.
A new module has been implemented in HydroStar which performs the estimation of
the roll damping by using the ITH formulation. This module is called hsdmp and the results
obtained are the critical damping as it’s a reference value, the estimated linear and quadratic
damping to be used as input for hsmcn.
The input file has the same format as the one for hsmcn with the addition of the fol-
lowing keywords:
The module hsdmp is used before hsmcn and to run it the user only needs to type:
Hstar>proj>hsdmp input.dmp
After obtaining the estimation for linear and quadratic damping, the user needs to modify the
input file for hsmcn in order to include those values.
TANK_TABLE
TANK itank BODY body
TANK itank2 BODY body2
...
ENDTANK_TABLE
The number of tank in the tank table should match the number of tank calculated in hstnk
brackets rigidifying the structure) generate very low diffracted and radiated waves, therefore
the force acting on them can be expressed through the use of the Morison equation.
By default, in HydroStar , both the motion of the structure and the undisturbed incident
wave field are taken into account in order to compute the Morison force on the structure.
In HydroStar , the Morison elements are constituted of circular beams with user-defined drag
and added mass coefficients. The user may make use of fictitious beams to model elements that
are already modelled through panels. To show consistency, fictitious beams have to be defined
without mass (Cm = 0) but with a drag coefficient larger than zero (Cd > 0).
To define the elements, the user has to include the following lines in the mechanical input
file:
In the description of the Morison elements above, (x1,y1,z1) represent the three coordinates
of the position of one extremity of the element and (x2,y2,z2) the coordinates of the other
extremity in the mesh coordinate system. D stands for the diameter of the tube element. Cd is
the drag coefficient of the element, while Cm is the added mass coefficient of the element. The
optional keyword N seg stands for the number of segments in the discretization of the element.
An example of a SPAR platform with additional Morison elements is shown in figure 6.3.
The user has the option to include the effects of the radiated and diffracted fields for the
evaluation of the velocity acting on the Morison element. This can be activated through the
keyword DIFF_RAD to put in the mechanical input file. By default, it is inactive as it can
be CPU-time consuming.
As we operate in frequential domain, the drag term in the Morison equation has to be linearized.
There are two strategies for the linearization of this term.
· Regular wave linearization. In this case, the linearized drag term takes the following
8
form: FL = 21 ρ Cd D 3Π kU kU which is similar to quadratic roll linearization explained in
section 6.2.5. In this case, the user should specify the wave amplitude with the keyword
WAVEAMPLITUDE .
For stochastic linearization, the user needs to define a specific seastate for which a
spectral computation will be performed. In the mechanical input file, the sea state will
be defined as follows:
STOCHASTIC_MORISON
SPECTRUM PARAMETERS RELHEAD SPREADING VAL
ENDSTOCHASTIC_MORISON
STOCHASTIC_MORISON
JONSWAP HS 7.1 TP 16.0 GAMMA 1.0 RELHEAD 0.0 NO
ENDSTOCHASTIC_MORISON
where x, y, and z are the coordinate of the crane tip and L the length of the cable.
Note :
1-The given mass for the floating body does not take into account the pendulum mass
2-The reference point should be set to G, center of gravity of the whole system "ship + pendu-
lum".
3-The gyration radius (or mass matrix) is expressed with regards to G.
4-Available for single body calculation only.
Hstar>proj>hsmcn input.mcn
The global wave efforts are computed by HydroStar using the hswld module. To compute
these efforts, the inertia of each section is required. Those inertia matrix can either be set up
manually, or calculated by hstat module
where:
nb sequential number of the mass item
M ass mass item value
x1 position of the begin of the mass item
x2 position of the end of the mass item
xG longitudinal position of gravity centre of the mass item
yr gyration radius of the mass item around longitudinal axis in the centreline
of the vessel and with z-coordinate equal to the vertical centre of gravity (figure 7.1)
of the mass item
zG vertical position of gravity centre of the mass item
SECTION TYPE type_nb to start the input of sections to compute the loads
[nb_sec] xs , ys , zs to end the definition of sections
ENDSECTION
where:
type_nb = 0 if the sequential number of the sections is given
xs, ys, zs = position of the section
NOTE 1 : On each segment, the density is considered linear. If a linear density variation
can not achieve the centre of gravity position (with regard the the item boundary), a warning
message "Inconsistent item" is displayed.
NOTE 2 : If additional damping has been defined by the user, this "global" damping has
to be dispatched over the sections to get a balanced model. By default, the additional damping
is dispatched between 0.1L and 0.9L. The way to dispatch the damping over the section can
be fully customized later on (Keyword VISC44 in the generated project_wld.don). Additional
stiffness is handled the same way.
The file which exemplifies the mass distribution file is displayed in figure 7.2.
ZFSURFACE 27.47 m
DISMASS TYPE 0
1 Hull fore part 1152.55 146.00 158.22 151.05 18.02 17.56
2 Hull middle part 16341.00 -91.80 146.00 27.10 18.02 17.56
.. .. .. .. .. .. .. ..
.. .. .. .. .. .. .. ..
102 TCBB8 5389.87 -101.38 -71.88 -86.63 18.02 16.44
103 Sloptk 4214.00 -108.88 -101.38 -105.13 18.02 16.44
ENDDISMASS
SECTION TYPE 0
1 -165.15 0 0
2 -165 0 0
.. .. .. ..
.. .. .. ..
34 155 0 0
35 165 0 0
ENDSECTION
ENDFILE
The user is able to Visualized the mass distribution and sections by typing "hsview mass-
Distribution.wld":
Hstar>proj>hview massDistribution.wld
With the above file hstat generates the input file for hswld which consists on the inertia
matrix for each defined section.
Hstar>proj>hstat massDistribution.wld
HydroStar will perform the calculation of the mass properties. Those are compared
with the hydrostatic properties of the hull. If there is a mismatch (i.e. mass not corresponding
to displacement, or CoB not vertically aligned with CoG), it’s up to the user decide to keep
the original mass distribution, or to automatically correct it to match mesh properties. (the
correction is simply a scaling and a horizontal offset of the mass distribution)
Then, the file proj_wld.don will be created in the user’s work directory.
A by-product of this module is the still water loads that are calculated and output in
"tmp/stillWaterLoads.dat".
Eventually, the loads can be computed using hswld module by typing "hswld proj_wld.don".
Hstar>proj>hswld proj_wld.don
The following key words shall be used in the input file for hswld:
NOTE: The inertia matrix should be defined in accordance with the matrix defined in item
6.2, where the calculation point is located in the section and the centre of gravity is the centre
of gravity of the loading condition.
The picture, displayed in figure 7.4, gives an example of the input file for hswld.
# Project : Semi-Sub
# User : BV
#
MASS_BODY 1 2.2643E+07
YSECTION_No 1
REFPOINT 0.0000 0.0000 -4.63
COGFROMSB 0.22947 -21.000 -4.63
VIS44PC 0.00000E+00
INERTMATRIX
0.11647E+08 0.00000E+00 0.00000E+00 0.00000E+00 -0.53926E+08 -0.24499E+09
0.00000E+00 0.11647E+08 0.00000E+00 0.53926E+08 0.00000E+00 0.26726E+07
0.00000E+00 0.00000E+00 0.11647E+08 0.24499E+09 -0.26726E+07 0.00000E+00
0.00000E+00 0.53926E+08 0.24499E+09 0.47231E+10 -0.23747E+09 0.58046E+09
-0.53926E+08 0.00000E+00 -0.26726E+07 -0.23747E+09 0.10017E+11 0.15830E+10
-0.24499E+09 0.26726E+07 0.00000E+00 0.58046E+09 0.15830E+10 0.74257E+10
ENDSECTION
YSECTION_No 2
REFPOINT 0.0000 0.0000 -4.63
COGFROMSB 0.0000 0.0000 -4.63
VIS44PC 0.00000E+00
INERTMATRIX
0.22643E+08 0.00000E+00 0.00000E+00 0.00000E+00 -0.10484E+09 0.00000E+00
0.00000E+00 0.22643E+08 0.00000E+00 0.10484E+09 0.00000E+00 0.00000E+00
0.00000E+00 0.00000E+00 0.22643E+08 0.00000E+00 0.00000E+00 0.00000E+00
0.00000E+00 0.10484E+09 0.00000E+00 0.18787E+11 -0.11268E+09 0.52149E+09
-0.10484E+09 0.00000E+00 0.00000E+00 -0.11268E+09 0.18711E+11 -0.29881E+09
0.00000E+00 0.00000E+00 0.00000E+00 0.52149E+09 -0.29881E+09 0.25348E+11
ENDSECTION
ENDFILE
Waves visualization
The module hswav of HydroStar generates the files for the visualization of waves by the
program BV-VSHIP, that can be included as optional software in HydroStar package.
• Vessel’s motions;
• Pressures on the hull;
• Waves on the free surface around the ship.
The following key words shall be used in the input file for hswav:
VSHIP FILE fileroot fileroot is used to the root part of output files
or
ENDFILE
The input file displayed in figure 8.1 gives an example for hswav.
XMIN -200.0
XMAX 500.0
DLTX 10.0
YMIN -100.0
YMAX 100.0
DLTY 5.0
The hswav can only be performed after the calculation of the motions by hsmcn.
Hstar>proj>hswav input.wav
HydroStar will generate a folder named “.../wav” in the work directory, in which the fol-
lowing output files are stored:
The file Fileroot.bvh shall be openned using BV-VSHIPin order to obtain the requested
visualization.
For further details about BV-VSHIP, please refer to the Vship Visualizer User’s Guide.
The pressure (relative wave elevation) and the wave elevation are calculated using the module
hsprs after the calculation of the motions.
The total relative pressure is made of the following components (that can be output
individually):
• Incident wave
• Diffracted wave
• Hydrostatic due to the ship motion (still water pressure is not included)
When forward speed is set, the encounter frequency approximation is used. Pressure output
includes the so-called "mj terms"
The user shall define the points to calculate the pressure/wave elevation by making use of
the following keywords in the input data:
Hstar>proj>hsprs input.prs
The user is able to check the file generated by typing “hschk input.prs”:
ZFSURFACE 11.000 m
POINTS
1 -200.00 0.00 11.0
2 -190.00 0.00 11.0
3 -180.00 0.00 11.0
4 -170.00 0.00 11.0
ENDPTS
COEFINC 1.0
COEFRDF 1.0
COEFHDS 0.0
ENDFILE
Hstar>proj>hschk input.prs
Then the points at which the pressure will be calculated can be visualized together
with the mesh:
Hstar>proj>hvisu -p
In the case where the user has performed the resolution of the first-order radiation-
diffraction with a low forward speed through the wave-current formulation and has previously
specified WAVECUR in the mechanical input file, the keyword WAVECUR has to be specified
in the input file of hsprs.
The low-frequency loads can be described as being the quadratic function of the bichromatic
incident and diffraction/radiation wave fields. The QTF (Quadratic Transfer Function) of
low-frequency loads needs the solution of the second order problem except for the diagonal
terms equal to the mean drift loads which can be directly obtained from the first order results.
The complete low-frequency loads are composed of two parts: one depending on the
quadratic products of the first-order wave fields, and the second depending on the second order
potentials which can be represented by two Haskind integrals on the body surface, in addition
to the second order Froude-Krylov forces. Thus, we may write the jth component of the QTF
as:
Further more, the QTF Fj− (ωj , ωk ) is assumed to be regular function of (ωj , ωk ) and a
Taylor expansion with respect ∆ = (ωj − ωk ) to can be developed:
The approximation proposed by Newman (1974), which consists of using only the drift
loads is qualified by zeroth-order approximation. The approximation considering all terms
except of the free surface integral is of order O(∆ω), one order higher than Newman’s
approximation.
There are two classical formulations to solve the second order low frequency loads prob-
lem. The near field formulation needs the evaluation of first-order wave field around the hull
and along the waterline, as well as the first-order motions. Another formulation based on
the momentum theorem for the horizontal drift forces has been developed by Maruo (1960)
and extended to the moment around the vertical axis by Newman (1967). This formulation
involving first-order wave field in the far field is often called far-field formulation and preferable
in practice thanks to its better convergence and stability. However, the far field formulation
can not provide the vertical drift loads which can be important in shallow water case, and the
low-frequency loads (QTF) which are critically important in shallow water.
The recent work (Chen, 2004) unblocks this situation by developing a new formulation
for the calculation of the second order low frequency loads. Starting with the most general
near field formulation, and then obtaining a near field formulation by making use of two
variants of Stokes theorems, the analysis in a finite volume limited by the hull and a control
surface surrounding the body yields new middle-field formulation. This formulation combines
the advantages of both near field and far field formulation, providing good numerical precision
and possibility of accessing to all components of drift loads and low frequency loads (QTF) as
the near field formulation.
HydroStar provides the possibility of computing the second order wave loads by making
use of any of the three formulation that were briefly described above and also to consider the
O[(∆ω)] for the integral over the free surface. In the versions 5.0 and above of HydroStar the
formulations for the computation of second order wave loads in unidirectional waves have been
extended to the case of multi-directional waves (cross waves). Both the classical near-field
formulation and the new middle-field formulation can be used used.
More theoretical details about second-order loads can be found in [1], [4] , [3] and [2].
For the computation of the mean drift loads in uni-directional waves, we use the mod-
ule hsdft. The user can choose between three formulations: near field, far field and
middle-field. When the middle-field formulation is chosen, the user needs to define a control
surface mesh.
NOTE: Although the middle field formulation is general, only the horizontal load components
can be calculated using the module hsdft, for HydroStar versions up to 6.10.
• Choice of formulation;
The control surface mesh to be used for hsdft is to be opened at the free surface (open
box). In order to define a box the following keywords should be used:
NOTE: The automatic control surface mesh generated by HydroStar is not to be used for
hsdft.
NFORMULE YES
FFORMULE YES
MFORMULE NO
ENDFILE
Hstar>proj>hschk input.dft
After checking the control surface mesh, the user is able to visualize it just typing “hvisu -b:
Hstar>proj>hvisu -b
Then, VISU4D window will be opened and both the hull mesh and the control surface
mesh can be visualized (see fig 10.2).
Figure 10.2:
Hstar>proj>hsdft
• With input file: Type “hsdft” followed by the input file name:
Hstar>proj>hsdft input.dft
NFORMULE No
FFORMULE No
MFORMULE YES
NBBOITE 1
XCSURFACE 1 -5.0 5.0 0.1
YCSURFACE 1 -1.0 1.0 0.1
ZCSURFACE 1 -2.0 0.0 0.1
MULTIDIRECTIONELLE
ENDFILE
NOTE: As explained above, only one formulation can be used per time. In case several
formulations are chosen, the last one given in the input file will be used.
Hstar>proj>hsmdf input.mdf
The following information should be given in the input file for full QTF computation:
• Choice of formulation (near-field or middle field). Only one formulation can be chosen;
• Wave frequencies;
NOTE: It’s important to note that the diffraction-radiation computations (hsrdf should be
performed not only for the wave frequencies but also for the difference-frequencies
The control surface mesh for the modules hsamg and hsqtf is different than the one used for
hsdft as it is to be closed at the free surface between the control surface envelope mesh and
the hull mesh. An adequate control surface mesh is automatically generated by HydroStar.
NBBOITE nb
CSFILE AUTO BODY ib zmin , zmax , dz, optional_parameters
where:
The figure 10.5 exemplifies the input file for the QTF computation.
Hstar>proj>hsamg input.qtf
NBBOITE 1
CSFILE AUTO BODY 1 -20.0 0.0 1.0 0.5 1.0 1.0 5
MULTIDIRECTIONELLE
ENDFILE
MODE SUM
ENDFILE
Note 1 : A free-surface mesh must have been described in the mesh file read by HSlec (see
chapter 3). The free surface must be circular and centered on (x,y)=(0,0).
Note 2 : Only available with 0 or 1 symmetry
After performing the calculations, the user is able to construct the following transfer functions
by using the command “hsrao”:
• Drift loads;
NOTE: In case of forward speed the added mass and damping coefficients depend on the
heading. In those cases, the user needs to define the heading to output the results (keyword
BETA). Otherwise the first heading used in the calculations will be taken by default.
Note : HSprs must have been run with the keyword "INTANK" (See chapter 9)
Note 1 : By default, the radiated pressure are expressed with reference to the CoB.
Note 2 : Pression decomposition requires the keyword WAVEDECOMPOSITION in HSprs
input file.
Note 3 : Velocity decomposition requires the keyword SPEEDDECOMPOSITION in HSprs
input file
11.1.7 Mean drift loads in uni and bi-directional waves (after run-
ning hsdft or hsmdf)
NOTE: As HSqtf computes the second-order loads with only one formulation at once, the
keywords PRE / CSF / MOM are not taken into account here
NOTE: For the QTF construction in uni-directional waves only one of the keywords BETA
or DIFF should be given while for the QTF in bi-directional waves both values should be
provided
NOTE: Since HydroStar v7.00, the RAO file contains both amplitude and phase (or COS +
SIN component), so that the keywords AMP and PHASE (or COS and SIN) result in the same
RAO output, only the gnuplot file is different
11.2 Examples
11.2.1 One body
The figure 11.1 exemplifies the input file for hsrao.
Hstar>proj>hsrao input.rao
HydroStar will create a folder named “rao” in the working directory with the output
files required by the user.
The output files have the following format (see fig 11.3):
At the end of RAO files’ generation by hsrao, a file named “project_name.gnu” is created.
This file contains the macros to make curves of RAOs by using the software - gnuplot*, that
is provided in the same package as HydroStar.
Hstar>proj>hsplt
or
Hstar>proj>hsplt rao/project_name.gnu
Then, a series of graphics including the same number of RAOs curves as that of wave
headings in the motion computation will be obtained.
NOTE: The automatic display of the graphics may not work if the user does not define a
project name in the beginning of the job.
*
c gnuplot dated 1986-1993, 1998, 1999 is attributed to Thomas William, Kolin Kel-
ley and many others.
OPERATION
file4.rao = file2.rao OPERATOR2 file1.rao
file5.rao = file4.rao OPERATOR1
ENDOPERATION
Parallel computation
t(1)
S(NP roc ) = (12.1)
t(NP roc )
Figure 12.1 shows speedup of the parallelization for the program hsrdf (diffraction-radiation
computation). As expected, we reach approximately an ideal linear speedup when the number
of frequencies is a multiple of the number of processors (symbols in red on the figure).There is
a slight uncertainty on the time execution on one processor depending on which processor of
the machine the computation has run, this explains the presence of points slightly above the
line defined by S(NP roc ) = NP roc (which is theoretically impossible).
25
Parallel / Sequential 20
15
10
0
0 5 10 15 20 25
Number of processors
Hstar>proj>hsrdf -n 6 input.rdf
Please note that the number of allowed processors should not exceed the number of fre-
quencies specified in the input file input.rdf .
• hsrdf
• hsmod
• hstnk
• hsprs
• hswld
• hsdft
• hsamg
• hsqtf
They can be launched in the same way as explained in the previous paragraph.
12.4 Requirements
To be able to run parallel calculation, IntelMPI must be installed (included as an option in
HydroStar installer).
This only had to be done once; the hstar2paraview button will be ready for the next
times.
Examples
A.1 Example 1
Considering a floating cylinder with the following geometric properties:
Provide the first order and the second order loads on the body:
Hstar>>cd c:/hydro/study
Hstar>>pwd
c:/hydro/study
Hstar>>proj cylinder
Hstar>cylinder>
it’s possible to generate the mesh using HydroStar (see item 3.2):
Hstar>cylinder>hsmsh -cs2
R,H,ntheta(0->PI/2),nH,nR(fond)=: 12.5 37.5 20 30 10
Hstar>cylinder>ed cyls2.dat
Then, a notepad window will be opened with the mesh generated (see fig A.1):
Figure A.1:
Hstar>cylinder>hslec cyls2.dat
Nb of bodies to be analysed 1
Nb of symmetry of hull geometry 2
Nb of panels on hull 790
Nb segments along waterline 20
Nb panels on the waterplanes 41
Nb panels over the free surface 0
Nb hull panels over the waterline 0
Hstar>cylinder>hvisu
ahsuni:
3364 points renumerotes => 3201 points
ahsuni:voir points en double
CPU time of operation was 0.27 seconds
The window of VISU4D will be opened with the visualization of the mesh (see fig A.2):
Figure A.2:
An input file is necessary to perform the diffraction and radiation computation (see fig A.3).
Figure A.3:
Then, the user is able to start the calculation (see fig A.4).
Figure A.4:
For this module another input file is necessary containing the mechanical properties of the
body. As the goal of the analysis described in the beginning of this item 9 is to calculate the
first and second order loads on the body, the properties of mass and inertia considered in the
example input file (see fig A.5) are big enough in order to fix the body.
Figure A.5:
Then, the user is able to compute the body’s motions (see fig A.6):
Figure A.6:
The computation of the second order loads is only possible after the computation of the
body’s motions; an input file is only necessary in case the user wants to make use of middle
field formulation. In this case, an input file shall be provided (see fig A.7).
Figure A.7:
In case that a control surface is inputted for the computation by middle field, the user has
the possibility of checking (see fig A.8) and visualising (see fig A.9) the mesh before starting
the calculation.
Figure A.8:
Then a VISU4D window will appear with both the body and the control surface meshes
(see fig A.9).
Figure A.9:
NOTE: The user may choose between checking the control surface mesh before or after the
second order computation.
Figure A.10:
The user has to define, in an input file, which transfer functions he wants to construct. In
this specific example, the first order and second order loads were required. This way, the input
file displayed in figure A.11 was elaborated
With the input file, the computation can start (see fig A.12).
Figure A.11:
Figure A.12:
Hstar>cylinder>hsplt
or
Hstar>cylinder>hsplt cylinder.gnu
The gnuplot window will appear with a series of graphic containing all the requested
RAOs (see fig A.13).
Figure A.13:
The example presented in figure A.13 has semi-analytical solution available in the
literature, in case the user wants to compare with the numerical results obtained.
A.2 Example 2
Considering a ship in deep water depth, the following transfer functions and coefficients are
required:
1. Amplitude of ship’s motions (surge, sway, heave, roll, pitch and yaw);
4. Second Order Loads Fx, Fy and Mz using near field and middle field formulations.
Hstar>>cd c:/hydro/study
Hstar>>pwd
c:/hydro/study
Hstar>>proj ship
Hstar>ship>
For complex geometries like a ship, the user has to generate the mesh using a mesh
generator and then create a file in the format requested by HydroStar (see fig A.14)
Figure A.14:
Hstar>ship>hslec ship.hst
PROJECT: Ship
USER: Bureau Veritas
Nb of bodies to be analysed 1
Nb of symmetry of hull geometry 1
Nb of panels on hull 2105
Nb segments along waterline 118
Nb panels on the waterplanes 413
Nb panels over the free surface 0
Nb hull panels over the waterline 1653
ahsuni:
4492 points renumerotes => 4347 points
ahsuni:voir points en double
CPU time of operation was 0.31 seconds
The window of VISU4D will be opened with the visualization of the mesh:
Figure A.15:
Figure A.16:
Figure A.17:
The input file displayed in figure A.20 was elaborated, as the middle field computation
was requested.
Figure A.18:
Figure A.19:
Figure A.20:
Figure A.21:
As explained in the previous example, the control surface can be checked (see fig A.22)
and visualized (see fig A.23) before or after the second order computation.
Figure A.22:
The following input file was elaborated according to the requirements in the description in
figure A.24.
Figure A.23:
Figure A.24:
Hstar>ship>hsplt
Figure A.25:
Figure A.26:
Index of commands
• hslec
NUMTANK id_tk first_panel last_panel first and last panel of the tank mesh
REFPTANK id_tk x_ref y_ref z_ref rho reference point of the tank in the
global reference system
• hsrdf
If itype = 1,
frequency_lines = freq1, freq2, freq3... several frequencies at the same line without
identification number
If itype = 2,
WMIN min_freq minimum frequency
frequency_lines = WMAX max_freq maximum frequency
WSTP step_freq Step of wave frequency
If itype = 1,
heading_lines = head1, head2,head3... several headings at the same line without
identification number
If itype = 2,
HMIN min_freq minimum heading
heading_lines = HMAX max_freq maximum heading
HSTP step_freq step of wave headings
NBFREQUENCY no_freq total number of wave frequencies
NBHEADING no_head total number of wave headings
WATERDEPTH value_depth water depth value or infinite (default = inf)
or inf
REFPOINT_BODY no_body x_ref, y_ref, z_ref reference point of the body (default=CoB)
REFWAVE x_wave, y_wave reference point for incoming waves
(default=CoB)
• hsmcn
• hswav
• hsdft
• hsrao
CONNFZ key − words Vertical connection force at the connection point of multi-
bodies
VISU4D interface
VISU4D was developed by Bureau Veritas and provide the visualization of HydroStar meshing
by typing hvisu on HydroStar window.
White panels mode provide the visualisation of the panels in white colour (see fig C.1);
Wireframe mode provides the visualisation of only the borders of the panels (see fig C.2);
Normals mode provides the visualisation of the normal orientation by means of two
different colours (see fig C.3);
Standard view mode provides the visualisation of the mesh through a standard render
mode (see fig C.4).
When using the commands “hvisu -t” for visualising the upper part of the body and/or
also the panels over the water-plane (see fig C.5), or “hvisu -b” for visualising the control
surface (see fig C.6), the new mode of visualisation “écustomized view” is activated.
Through this mode the user can visualise the mesh of the hull like in normals mode and
the upper part or the control surface like in wireframe mode (see fig C.5).
There are two ways of changing the point of view with VISU4D: using the “point of view
window” (see fig C.7) and selecting the desired angles of visualisation.
Or by using the arrows in the keyboard: the right / left arrows change the phi angle,
and the up / down arrows change the theta angles.
Also, it’s possible to select directly the planes of visualization, like in the example
displayed in figure C.8.
• Making a zoom:
To zoom it’s necessary to select the region of the mesh to zoom by drawing a window
using the left button of the mouse (see fig C.9).
The user is also able to unzoom and reproduce the zoom, by clicking on menubar buttons:
– to unzoom;
– to reproduce the zoom.
[1] X.-B. Chen. Hydrodynamics in offshore and naval applications - part i. In 6th International
Conference on Hydrodynamics, Perth, Australia, 2004.
[2] X.B. Chen. Etude des réponses du second ordre d’une structure soumise à une houle
aléatoire. PhD thesis, Univ. Nantes, ENSM., 1988.
[3] X.B. Chen. Approximation on the quadratic transfer function of low-frequency loads. Proc.
7th Intl Conf. Behaviour Off. Structures, BOSS’94, pages 289–302., 1994.
[4] X.B. Chen. Middle-field formulation for the computation of wave-drift loads. Journal of
Engineering Mathematics, 2006.
[5] Orozco J.M., X.B. Chen, and Malenica S. Some aspects of seakeeping of the floating body
with attached pendulum. Maritime Transportation and Exploitation of Ocean and Coastal
Resources, 2005.
[6] Malenica, S., Derbanne, Q., Zalar, M., and Chen, X.-B. Wave-current-floating body in-
teractions in water of finite depth. In 13th International Offshore and Polar Engineering
Conference, Hawai, 2003.
[7] Monroy, C., Chen, X-B., and Giorgiutti, Y. First and second order wave-current in-
teractions for floating bodies. In 31st International Conference on Offshore and Artic
Engineering, Rio de Janeiro, Brazil, 2012.
[8] Malenica Š., Zalar M., and Chen X.B. Dynamic coupling of seakeeping and sloshing. In
13th International Offshore and Polar Engineering Conference, Hawai, 2003.
[9] Malenica Š and & Chen X.B. On the irregular frequencies appearing in wave diffraction-
radiation solutions. Intl J. Offshore Polar Engg, pages 2, 110–14., 1998.
[10] Chen X.B. On the side wall efects upon bodies of arbitrary geometry in wave tanks.
Applied Ocean Research, pages 337–345, 1994.
Acknowledgment
Many thanks to the developers of the following open sources projects :
-Gnuplot http://www.gnuplot.info/ (used for data plotting)
-Paraview http://www.paraview.org/ (used for 3D visualization and animation)
-Latex http://www.latex-project.org/ (redaction of this user manual)