Visualize motions in 3D (only for MARIN users ! )

From MARINWiki
Jump to: navigation, search

3D visualisation

The 3D-visualisation is based exclusively on the ini-file and the res-file used for the simulation. The rootname should be the same for these two files. The 3D-visu tool can be run from the network thanks to a double click on I:\PUBLIC\aNySIMvisu\visu.bat The aNySIMvisu directory contains other folders with data that can be helpfull to the users: 1. "I:\PUBLIC\anysimvisu\sample cases" with {ini-file, res-file} examples 1. "I:\PUBLIC\anysimvisu\geom" with a collection of geometry files

The 3D visualisation requires data which are partly coming from the ini-file and partly coming from the res-file. Therefore new keywords specific to the 3D-visu must be added to the ini-file, also the list of output signals must be increased with a number of signals.

The additional keywords in the ini-file are ignored during a simulation. They are only used by the 3D-visu tool.

The following document contains information about the wave field generation: <generationdoc> and the following document about the wave field grid vertices: <verticesdoc>


Input sections

[GENERAL]

A record is added to the General section

Keyword Unit Description Option Version
VisuEFAxisVisible [-] EF axis system is displayed if 1, not visible if 0 default is 1 proto v1.0

[BODY#]

New records must be added to this section:

Keyword Unit Description Option Version
VisuSFAxisVisible - SF axis system is displayed if 1, not visible if 0 default is 1 proto v1.0
VisuGeometryFile - File name including path to the geometry file: *.flt or *.pat compulsory proto v1.0
VisuGeomLpp m Original Lpp of the geometry file, this value is used with the value of keyword Lpp to scale the geometry to the correct dimension optional proto v1.0
VisuGeomOriginPos m,m,m Position of the origin of geometry description given in the aNySIM midship-keel SF system compulsory proto v1.0
VisuAsymYawRotation deg Yaw angle between the x-axis of the geometry and the x-axis of the body SF system in aNySIM 0.0 by default proto v1.0
VisuGridCellSize m Length/breadth of square wave field panels. optional proto v1.0
VisuGridLFactor - Size of wave field in length as factor of vessel Lpp. optional proto v1.0
VisuGridBFactor - Size of wave field in width as factor of vessel beam. optional proto v1.0
VisuWindowLength - Number of samples per time window for the FFT. Must be a power of 2. optional proto v1.0
VisuWindowOverlap - Number of samples of the overlap of successive windows (for a smooth transition from one window to the next). Usually 1/4 of VisuWindowLength optional proto v1.0
VisuGridDt s Time step of wave field updates. optional, default equal to simulation time step proto v1.0
VisuWriteWave - Option to write reconstructed wave at earth-fixed wave origin. Time trace is written to file FFT_Wave.txt. optional proto v1.0
VisuWriteVertex - Option to write reconstructed wave at 1 or more wave field vertices. Array can contain 1 or more indices of vertices, see documentation for the numbering order. Time traces are written to file Vertex_Height.txt. optional proto v1.0
VisuUpdateWaveFieldPos - Optional flag (true or false) whether the wave field should follow the vessel. If true the wave field jumps to the vessel position at the end of an FFT window. optional, default = true proto v1.0

[LINE#]

When a line is used, new records must be added to this section:

Keyword Unit Description Option Version
VisuSFFairlead1Orientation -,-,- Unit vector colinear to the symmetry axis of the ring symbol that represents a fairlead default is {1.0,0.0,0.0} proto v1.0
VisuSFFairlead2Orientation -,-,- Unit vector at the second end of the line default is {1.0,0.0,0.0} proto v1.0
VisuSFBollard1Pos m,m,m Position of the vertical cylinder representing a bollard in the SF referential of the body compulsory proto v1.0
VisuSFBollard2Pos m,m,m Position of the bollard at the second end of the line compulsory proto v1.0
VisuColorRange kN,kN Minimum tension associated with the color blue, maximum tension associated with the color red (Matlab color range) optional proto v1.0
VisuSFWinchPos m,m,m Position of the winch at the first end of the line compulsory if winch proto v1.0
VisuSFWinchOrientation -,-,- Unit normal vector for the orientation of the winch default is {1.0,0.0,0.0} proto v1.0

[FENDER#]

When a fender is used, a new record must be added to this section:

Keyword Unit Description Option Version
VisuColorRange kN,kN Minimum compression force associated with the color blue, maximum force associated with the color red (Matlab color range) compulsory proto v1.0

[ENVIRONMENT]

New records must be added to this section:

Keyword Unit Description Option Version
VisuSeabedOrientation -,-,- Unit normal vector giving the orientation of the seabed {0,0,1} by default proto v1.0
VisuEnvIndicatorPos m,m,m EF-position of the environment arrows (wind, wave and current layers) compulsory proto v1.0
VisuLightSourceOrientation -,-,- Unit normal vector giving the direction of uniform light-source {-1,-1,-1} by default proto v1.0
VisuWaveFieldShowSurface 0 switch on/off the display of the solid wave surface 1 by default proto v1.0
VisuWaveFieldUseNormals 0 switch on/off the use of normals and lighting to color the waves (off: the waves are colored by mapping the waveheight on a colormap) 0 by default proto v1.0
VisuWaveFieldShowNormals 0 switch on/off the display of the normals 0 by default proto v1.0
VisuWaveFieldShowWireFrame 0 switch on/off the display of the wireframe 0 by default proto v1.0

Required output signals

Signal Alias unit
Body# EF X-position Posit, iBody, 1 m
Body# EF Y-position Posit, iBody, 2 m
Body# EF Z-position Posit, iBody, 3 m
Body# heading Posit, iBody, 6 deg
Body# roll Posit, iBody, 4 deg
Body# pitch Posit, iBody, 5 deg
MS# line# tension at fairlead TFair, iMooringSystem, iMooringLine kN
MS# line# node# EF X-position XnMs#, iMooringLine, iNode m
MS# line# node# EF Y-position YnMs#, iMooringLine, iNode m
MS# line# node# EF Z-position ZnMs#, iMooringLine, iNode m
MS# line# tension in element# TnMs#, iMooringLine, iNode kN
Length of (hawser)line# LinLen, iLine m
Tension in (hawser)line# LinTen, iLine kN
Compression force in fender# FenFPr, iFender kN
Wind speed WindSp m/s
Wind heading WindDr deg
Current speed in layer# CurrSp, iLayer m/s
Current heading in layer# CurrDr, iLayer deg
Wave height WavWdH m
Wave heading WavWdD deg
Swell height SwellH m
Swell heading SwellD deg


Input file examples

Example_3D_Visu