hemlab / hipims-cuda

High-Performance Integrated Hydrodynamic Modelling System (HiPIMS-CUDA) for flood modelling

Introduction

HiPIMS standards for High-Performance Integrated hydrodynamic Modelling System. It uses state-of-art numerical schemes (Godunov-type finite volume) to solve the 2D shallow water equations for flood simulations. To support high-resolution flood simulations, HiPIMS is implemented on multiple GPUs (Graphics Processing Units) using CUDA/C++ languages to achieve high-performance computing. Since HiPIMS has a modular and flexible structure, it has great potential to be further developed for other applications in hydrological science as long as the problem can be solved on a uniform rectangular grid.

Using HiPIMS

HiPIMS has been embedded in Pypims, the Python APIs for HiPIMS, which provides a user-friendly integrated toolchain for preparing inputs, running HiPIMS and visualising outputs.

Contributing and Acknowledgement

HiPIMS is developed and maintained by the Hydro-Environmental Modelling Labarotory, a research hub for technological innovation and interdisciplinary collaboration. The development of HiPIMS is led by Professor Qiuhua Liang and represents the effort of nearly two decades and many researchers.

References

The implementation of this code is documented in the following papers

Xia X, Liang Q, Ming X (2019) A full-scale fluvial flood modelling framework based on a high-performance integrated hydrodynamic modelling system (HiPIMS). Advances in Water Resources, 132: 103392.

Xia X, Liang Q (2018) A new efficient implicit scheme for discretising the stiff friction terms in the shallow water equations. Advances in Water Resources, 117: 87-97.

Xia X, Liang Q, Ming X, Hou J (2017) An efficient and stable hydrodynamic model with novel source term discretization schemes for overland flow and flood simulations. Water Resources Research, 53: 3730-3759.

Xia X, Liang Q (2018) A new depth-averaged model for flow-like landslides over complex terrains with curvatures and steep slopes. Engineering Geology, 234: 174-191.

A full list of related publications can be found here. Please cite appropriate papers if you use hipims for your project.

License

The code is licensed under GPLv3. Please see LICENCE for more information.

Contact us

For more information, please contact Xiaoli Su, Jinghua Jiang, Huili Chen, or Xue Tong.

hipims-cuda's Issues

ERROR Compiling the source code

Dear Dr. Ming, Dr. Xia and HEMLab members,

I am really interested in your powerful numerical model for large-scale flood simulation by solving 2D- shallow water equations. I have read your publications about the application of the HIPIMS model. So, I would like to test this model and apply this model to my case study by starting from compiling the source code. I have followed the 8 steps that you wrote in the Userguide.md for compiling and running the model. Unfortunately, I have received serval errors while compiling the code using my Windows machine equipped with NVIDIA GPU. So, the folder 'release/bin' was created during the compiling; however, there are no executable files were created in this folder.

Honestly, I am quite new to parallel computing with CUDA Toolkit. Therefore, I would like to ask for your help to fix this problem in compiling the source code. If you have some time, please kindly check the attached screenshot showing the errors I got. With your experience, I do believe that you will figure out the cause of this error.

I am looking forward to hearing back from you.
Your help is greatly appreciated.

Yours sincerely,
Sukim

Softwares I have installed on my window machine:
1) Microsoft visual studio 2019
2) CUDA Toolkits 10.2
3) CMAKE 3.23

Different HIPIMSs ?

Hello HEMLab Team!
How does this incarnation of hipims relate to https://github.com/lukessmith/hipims-ocl ?
I see some of the same authors are involved in both projects.
I have used smith's version of hipims a lot and recently also tried this version of hipims.
Both versions seem to have different pros and cons to them, and rather different styles of coding and architecture.
Was there a special reason to start two projects?
Is one considered to be the "true" or official hipims - seeing how both projects seem to involve authors of the papers regarding hipims?

Question-Is it possible to run the model only on CPUs?

Dear HEMLab Team!

Currently, I am learning how to use the Hipims model and aimed to apply this model to my study on flood inundation simulation. Recently, I have successfully set up an ap preliminary model and run the model on GPUs in a Linux operating system. However, I would like to know how much the computational time is reduced compared to the model that runs only on CPUs. Therefore, I would like to ask if the model can be configured to run only on CPUs?

I am looking forward to hearing back from you.
Your help is greatly appreciated.

Yours sincerely,
Sukim