OceanWave3D README
Requirements
Installation
Project Layout
Authors and Contact A. Acknowledgment and License
OceanWave3D requires the following third-party software libraries:
For building the binary executable, proceed as follows:
Unix-based clients:
The OceanWave3D contains a distributed set of source files with the following directory tree layout:
| ---- OceanWave3D | -- build/ (optional) : build (out-of-source) directory | |
|---|---|---|
| -- trunk/ : source code | ||
| -- todo/ : contains a text file with a list of todo's for future releases |
where the source files are included in a tree structure as
| trunk/ | -- src/ : source code | |
|---|---|---|
| -- timeintegration/ : ODE solvers | ||
| -- functions/ : various functions | ||
| -- IO/ : IO methods | ||
| -- analyticalsolutions/ : various analytical solutions for wave generation, etc. | ||
| -- curvilinear/ : source for curvilinear functionality | ||
| -- fft/ : source for fft stuff | ||
| -- initialization/ : source for OceanWave3D initialization | ||
| -- main/ : driver routines | ||
| -- multigrid/ : multigrid stuff | ||
| -- pressure/ : handling of free surface pressures | ||
| -- utilities/ : useful stuff | ||
| -- variabledefs/ : global variable definitions | ||
| -- iterative/ : iterative methods for linear systems | ||
| -- doc/ : documentation (doxygen) | ||
| -- examples/ : tutorial and benchmarking applications | ||
| -- inputfiles/ : Example parameter input files for problems | ||
| -- benchmarks/ : A small benchmarking suite | ||
| -- tutorial/ : Some tutorials explaining the usage of OceanWave3D | ||
| -- utils/ : utilities for generating and processing data input and output in Matlab | ||
| -- analytical/ : analytical solutions useful for wave generation, comparison, etc. | ||
| -- matlab/ : Various matlab useful files | ||
| -- visualization/ : various utility scripts useful for visualization of output | ||
| -- verification/ : automated test suite of source code | ||
| -- thirdpartylibs/ : thidpartylibs for compilation of static libraries to be included in path |
Allan Peter Engsig-Karup (apek@dtu.dk, Lead developer/architect and maintainer) Harry B. Bingham (hbb@mek.dtu.dk, Lead developer and maintainer)
With contributions from
Guillaume Ducrozet (guillaume.ducrozet@ec-nantes.fr, developing contributor)
Ole Lindberg (developing contributor)
Bo Terp Paulsen (devloping contributor)
OceanWave3D is developed in collaboration between
Please acknowledge this software referred to as "OceanWave3D" in your work and any of the publications below by using the following references:
@ARTICLE{EngsigKarupEtAl08, AUTHOR = "Engsig-Karup, A.P. and Bingham, H.B. and Lindberg, O.", TITLE = "An efficient flexible-order model for {3D} nonlinear water waves", YEAR = "2009", JOURNAL = "Journal of Computational Physics", VOLUME = "228", PAGES = "2100-2118" }
and this chapter with general details on the properties of the model and its parallel implementation (note that this Fortran version is not yet parallel)
@inbook{EngsigKarupEtAl2013, title = "Fast hydrodynamics on heterogenous many-core hardware", publisher = "Taylor & Francis", author = "Engsig-Karup, {Allan Peter} and Glimberg, {Stefan Lemvig} and Nielsen, {Allan S.} and Ole Lindberg", note = "2013; 11", year = "2013", editor = "Rapha\'el Couturier", isbn = "978-1-4665-7162-4", pages = "251--294", booktitle = "Designing Scientific Applications on GPUs", }
OceanWave3D is distributed under the GNU General Public License (See file LICENSE) and a base code was developed at DTU Mechanics 2006-2008 by Allan P. Engsig-Karup and entirely rewritten at DTU Informatics 2008-2011 (current version) by Allan P. Engsig-Karup with contributions as mentioned below in section 4 of this file.
A GPU-accelerated massively parallel version of OceanWave3D has been proto-typed that can execute on heterogenous archictures using the CUDA programming model has been developed in collaboration between Morten Gorm Madsen (first proof-of-concept version), Stefan Lemvig Glimberg (advanced version within GPULAB library) and Allan P. Engsig-Karup. In this version of the code the multigrid preconditioned defect correction method (PDC) appeared for the first time and it accessbile in this fortran version of the code as well. This work can be cited by the following reference
@ARTICLE{EngsigKarupEtAl2011, AUTHOR = "Engsig-Karup, A. P. and Madsen, M. G. and Glimberg, S. L.", TITLE = "A massively parallel {GPU}-accelerated model for analysis of fully nonlinear free surface waves", JOURNAL = "International Journal of Numerical Methods in Fluids", YEAR = "2011", DOI = "10.1002/fld.2675" }
The properties of the PDC method is analyzed in great detail in
@ARTICLE{EngsigKarupEtAl2013, AUTHOR = "Engsig-Karup, A.P.", TITLE = "Analysis of Efficient Preconditioned Defect Correction Methods for Nonlinear Water Waves", JOURNAL = "International Journal of Numerical Methods in Fluids", YEAR = "2013", }
The splitting technique that can be used for efficient wave-structure interactions are described here
@article{DucrozetEtAl2013, title = "A non-linear wave decomposition model for efficient wave–structure interaction. Part A: Formulation, validations and analysis", publisher = "Academic Press", author = "Guillaume Ducrozet and Engsig-Karup, {Allan Peter} and Bingham, {Harry B.} and Pierre Ferrant", year = "2014", volume = "257", pages = "863--883", journal = "Journal of Computational Physics", issn = "0021-9991", }
A comparison between OceanWave3D and HOS is described here
@article{DucrozetEtAl2012, title = "A comparative study of two fast nonlinear free-surface water wave models", publisher = "John/Wiley & Sons Ltd.", author = "Guillaume Ducrozet and Bingham, {Harry B.} and Engsig-Karup, {Allan Peter} and Felicien Bonnefoy and Pierre Ferrant", year = "2012", volume = "69", pages = "1818--1834", journal = "International Journal for Numerical Methods in Fluids", issn = "0271-2091", }