2
INDEX
1. Input & output file
1.1. Work flow
1.2. Format files
2. XML for GenCase
2.1. Main structure
2.2. SPH constants
2.3. MK configuration
2.4. Geometry
2.4.1. Domain limits
2.4.2. Drawing commands
Command lists
Drawing settings
VTK output
MK selection
Transformations
Draw lines
Draw triangles
Draw boxes
Draw polyhedrons
Draw rounded shapes
Draw bathymetry
External geometries
Filling domains
Redraw commands
Freedraw mode
Layers
Variables
2.5. Initial transformations
2.5.1. Velocity
2.5.2. Position
2.6. Floating objects
2.7. Properties for MK
2.8. Motion
2.8.1. Simple rectilinear
2.8.2. Combined motions
2.8.3. Hierarchical motions
2.8.4. Accelerated rectilinear
2.8.5. Rotational
2.8.6. Circular
2.8.7. Sinusoidal
2.8.8. External motion
3. XML for DualSPHysics
3.1. Special features
3.1.1. Paddle wave generation
Regular waves using piston
Irregular waves using piston
Regular waves using flap
Irregular waves using flap
Solitary waves using piston
3.1.2. Active absorption
3.1.3. Passive absorption
3.1.4. Multi-Layer pistons
3.1.5. Relaxation zone
Regular & irregular waves
External velocity (coupling)
Uniform velocity profile
3.1.6. Gauge system
3.1.7. Imposed acceleration
3.1.8. Saves simulation Dt
3.1.9. Variable output data
3.2. Execution parameters
3.2.1. Double precision
3.2.2. Time integration scheme
3.2.3. Kernel function
3.2.4. Viscosity treatment
3.2.5. Density Diffusion Term
3.2.6. Shifting algorithm
3.2.7. Interaction between solids
3.2.8. Time step computation
3.2.9. Simulation time
3.2.10. Excluding particles
3.2.11. Simulation domain
3.2.12. Periodic conditions
3.3. Particle information
3.4. Constants for simulation
4. Simulation output
4.1. Log file
4.2. Other files
1.1. Input & output files: Work flow
Post-Processing Pre-Processing
3
BOUNDARYVTKPARTVTK
MEASURETOOL
Points.txt
Fixed.vtk
Moving_xxxx.vtk
Floating_xxxx.vtk
PartFluid.vtk
PartBound.vtk
PartMoving.vtk
PartFloating.vtk
Pressure.csv
Velocity.csv
Height_xxxx.vtk
Acceleration.ascii
ISOSURFACE
Surface_xxxx.vtk
Slice_xxxx.vtk
PointsPos.csv
GENCASE
Case_Def.xml
object.vtk
object.stl
object.ply
DUALSPHYSICS
Run.outPart_xxxx.bi4
Case_All.vtk
Case_Bound.vtk
Case_Fluid.vtk
Case__Actual.vtk
Case__Dp.vtk
Case.xml
Case.bi4
mov.dat
forces.csv
Part_Head.ibi4
PartOut.obi4PartFloat.fbi4
Data for moving
boundaries
Constants and configuration
parameters for simulation
Binary file with particle
data at initial instant
Text file with
execution log
Binary file with basic
information to execute
the post-processing tools
Binary file with excluded
particles during simulation
Created by GenCase BUT it can
also be created by the user
Created by the user
1.1. Input & output files: Work flow
4
GENCASE
Case_Def.xml
object.vtk
object.stl
object.ply
DUALSPHYSICS
Run.out
Part_xxxx.bi4
Case_All.vtk
Case_Bound.vtk
Case_Fluid.vtk
Case__Actual.vtk
Case__Dp.vtk
Case.xml
Case.bi4
mov.dat
forces.csv
Part_Head.ibi4
PartOut.obi4
PartFloat.fbi4
Data of forces
exerted on fluid
Binary file with particle
data at output time
Binary file with information
of the floating objects
XML File
• The eXtensible Markup Language is textual data format compatible
with any hardware and software.
• Information is structured and organised by using labels.
• They can be easily edited using any text editor.
BINARY File
• Binary format consumes six times less memory than text format.
• Reading or writing is several times faster using a binary format.
• A special code is required to read the data (JPartDataBi4.cpp/.h).
• “.bi4” is the new binary format that also includes double precision.
• The user can also define new arrays that post-processing tools can
automatic manage.
VTK File
• VTK (Visualization ToolKit) files are used for final visualization
• These files are generated as a pre-processing step by GenCase or as
output by DualSPHysics and post-processing tools.
• VTK files of POLYDATA type with legacy-binary format is used.
• VTK format is supported for many visualization applications, such as
ParaView that is open-source and multi-platform .
Case_Def.xml
Case.xml
Part_Head.ibi4
Part_xxxx.bi4
PartOut.obi4
PartFloat.fbi4
Case.bi4
1.2. Input & output files: Format files
5
Particles_xxxx.vtk
Surface_xxxx.vtk
Slices_xxxx.vtk
Velocity_xxxx.vtk
Height_xxxx.vtk
