/CHAPSim1.0

An incompressible Direct Numerical Simulation (DNS) code for pipe and channel flow and heat transfer

Primary LanguageGnuplotGNU General Public License v3.0GPL-3.0

About CHAPSim

A CHannel And Pipe flow simulation solver, CHAPSim, is described here. CHAPSim is an incompressible Direct Numerical Simulation (DNS) code for flow and heat transfer with MPI parallelization. This repository contains the latest stable version.

Code Development History

The early version of CHAPSim was developed by Dr Mehdi Seddighi-Moornani in f77 platform for simulations of unsteady turbulent flows in a channel during his PhD study starting from 2007. The code has later been revamped by Dr Wei Wang for solving thermo-fluids problems in f90 platform in 2014/2015. All this early development work was carried out while Drs Seddighi-Moornani and Wang were working with Professor Shuisheng He at Universities of Aberdeen and Sheffield. In 2020, CHAPSim was selected by CCP.NTH to be developed as an open-source community code in partnership with STFC Daresbury Laboratory (Contact: Dr Wei Wang), Liverpool John Moores University (Contact: Dr Mehdi Seddighi) and University of Sheffield (Contact: Professor Shuisheng He) and released under the GNU General Public License, that is a free, copyleft license.

License

GNU General Public License This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License or (at your option) any later version. This program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. Also, add information on how to contact you by electronic and paper mail.

Contact: Main contributors


Code Description

CHAPSim is a Fortran-MPI based finite difference code to solve the conservative variables (${\rho u, \rho v, \rho w, \rho h}$) in Navier-Stokes equations with heat transfer.

Methods
Parallel MPI
Mesh Structured, generated on the fly
Spacial Discretization Finite Difference
Nonlinear terms Divergence form
2nd order spacial accuracy
explicit Runge-Kutta & Adams-Bashforth method for temporal discretization
Viscous terms implicit Crank-Nicolson method for temporal discretization
Pressure FFT and Fractional step method
Thermodynamics Quasi-incompressible flow
Thermal properties updated by table-searching or specified functions of temperature

Code Building

Source Download and Compilation

Acquire the source code by cloning the git repository:

git clone git@github.com:CHAPSim/CHAPSim1.0.git​

Compile the codes:

mkdir bin obj
make all

Run the code:

mpirun -n 4 ./bin/CHAPSim

Updating an existing source tree

If you have previously downloaded CHAPSim using git clone, you can update the existing source tree using git pull rather than starting a new:

cd CHAPSim
git pull && make