incompact3d_plunging_criterion
Plunging condition for particle-laden flows over sloping bottoms: three-dimensional turbulence-resolving simulations
Science Score: 77.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
✓CITATION.cff file
Found CITATION.cff file -
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
✓DOI references
Found 7 DOI reference(s) in README -
✓Academic publication links
Links to: zenodo.org -
✓Committers with academic emails
1 of 1 committers (100.0%) from academic institutions -
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (8.5%) to scientific vocabulary
Keywords
Repository
Plunging condition for particle-laden flows over sloping bottoms: three-dimensional turbulence-resolving simulations
Basic Info
- Host: GitHub
- Owner: fschuch
- License: gpl-3.0
- Language: Jupyter Notebook
- Default Branch: main
- Homepage: https://authors.elsevier.com/a/1dNVsMMTPhD7k
- Size: 3.6 MB
Statistics
- Stars: 2
- Watchers: 1
- Forks: 2
- Open Issues: 0
- Releases: 0
Topics
Metadata Files
README.md
Plunging condition for particle-laden flows over sloping bottoms: three-dimensional turbulence-resolving simulations
This repository contains the source code employed for our work "Plunging condition for particle-laden flows over sloping bottoms: three-dimensional turbulence-resolving simulations" (Computers & Geosciences, 2021), by:
Felipe Nornberg Schuch
School of Technology, Pontifical Catholic University of Rio Grande do Sul, Porto Alegre, Brazil.
felipe.schuch@edu.pucrs.brEckart Meiburg
Department of Mechanical Engineering, University of California Santa Barbara, Santa Barbara, USA
meiburg@engineering.ucsb.eduJorge Hugo Silvestrini
School of Technology, Pontifical Catholic University of Rio Grande do Sul, Porto Alegre, Brazil.
jorgehs@pucrs.brAbstract: Hyperpycnal flows are observed when the density of a fluid entering into a quiescent basin is greater than that of the ambient fluid. This difference can be due to temperature, salinity, turbidity, concentration, or a combination of them. Over a sloping bottom, the inflowing momentum decreases progressively until a critical point is reached where the inflow plunges under the ambient fluid and flows along the bed as an underflow density current. In the present work, a new equation is proposed in order to predict the critical depth for plunging, i.e., the plunging criterion. It differs from previous studies since it includes the role of the settling velocity and the bed slope. The high spatiotemporal resolution from twelve original numerical simulations allows us to validate the initial hypotheses established, in addition to numerical and experimental data available in the literature, and good agreement is found between them. A negative value for the mixing coefficient was observed for the first time for the hyperpycnal flow in a tilted channel. This indicates that if the settling velocity of the suspended material is high enough, the submerged flow may lose fluid to the environment (detrainment), instead of incorporating it. The proposed plunging criterion may assist in the design of future experimental or numerical works.
Keywords: Plunging flow, Plunging criterion, Turbidity current, Large-Eddy Simulation.
Navier-Stokes Solver
The numerical simulations were carried out by incompact3d, an open source tool based on Boussinesq system for incompressible fluids, designed for supercomputers. A forked version from the original code was developed for this work in order to simulate the plunging flow.
Simulations
Twelve simulations were conducted, aiming to validate the predicted plunge depth:
| Cases | Bed slope [%] | Settling velocity [-] | Initial densimetric Frounde number [-] | |-------|---------------|-----------------------|----------------------------------------| | 1.25-0 | 1.25 | 0.0 | 2.19 | | 1.25-15 | 1.25 | 0.0015 | 1.96 | | 1.25-30 | 1.25 | 0.0030 | 1.75 | | 2.5-0 | 2.50 | 0.0 | 4.66 | | 2.5-15 | 2.50 | 0.0015 | 4.16 | | 2.5-30 | 2.50 | 0.0030 | 3.72 | | 5.0-0 | 5.00 | 0.0 | 11.15 | | 5.0-15 | 5.00 | 0.0015 | 9.97 | | 5.0-30 | 5.00 | 0.0030 | 8.90 | | 10.0-0 | 10.00 | 0.0 | 28.80 | | 10.0-15 | 10.00 | 0.0015 | 25.74 | | 10.0-30 | 10.00 | 0.0030 | 23.00 |
Dataset 
Data from the Twelve simulations are included. The output files from incompact3d were converted to NetCDF aiming to be more friendly than raw binaries, they include data arrays together with metadata and the coordinates:
t: Time;x: Streamwise coordinate;y: Vertical coordinate;z: Spanwise coordinate;
Due to limitations at the storage size, the time sampling is smaller for larger arrays. There are four files for each simulated case:
3d-case-<num>.nc: Complete 3D snapshot at 12 different dimensionless times (250, 500, 750, 1,000, 1,250, 1,500, 1,750, 2,000, 3,000, 4,000, 5,000, 6,000), the arrays are:ux (x,y,z,t): Streamwise velocity;uy (x,y,z,t): Vertical velocity;uz (x,y,z,t): Spanwise velocity;phi (x,y,z,t): Concentration.
xy-planes-case-<num>.nc: Spanwise-averaged quantities with a timestep of 5 dimensionless units:ux (x,y,t): Streamwise velocity;uy (x,y,t): Vertical velocity;uz (x,y,t): Spanwise velocity;phi (x,y,t): Concentration.
LA-case-<num>.nc: The complete spatio-temporal analysis of the relevant quantities is possible in a layer-averaged context per width unit, it is based on three variables:Layer-averaged Uh (x,t);Layer-averaged U2h (x,t);Layer-averaged UCh (x,t);
that can be used to compute layer-averaged velocity U = U2h/Uh, flow depth H = (Uh)²/U2h, flow discharge Q = Uh, concentration C = UCh/Uh and local densimetric Froude number Fr. In addition to:
- utau (x,t): Spanwise-averaged bed shear velocity;
- dep (x,t): Spanwise-averaged deposition rate.
All arrays with a timestep of 2.5 dimensionless units.
steady-state-case-<num>.nc: Time (last 2,000 dimensionless units for all cases) and spanwise averaged quantities:ux (x,y): Streamwise velocity;uy (x,y): Vertical velocity;phi (x,y): Concentration.
Together with layer-averaged quantities (Uh, U2h and UCh), bed shear velocity utau and deposition rate dep, as describe previously.
Each file can be loaded with the Python package xarray (see Why xarray), for instance:
python
dataset = xr.load_dataset("<filename>")
Examples
00-LA-and-Convert-to-NetCDF.ipynb - This Notebook is presented only for reference, it was used to compute the layer-averaged quantities and to convert the raw binary data from Xcompact3d to NetCDF. These files are available at Zenodo;
01-Computing-and-Plotting.ipynb - This Notebook shows how to read, compute and plot the variables presented in our work.
Setup
The examples above are only rendered online, if you choose to install and run them locally, follow these steps:
Clone the repository:
bash git clone https://github.com/fschuch/incompact3d_plunging_criterion.gitInstall the environment. This repository includes an
environment.yamlfile containing a list of the requirements to run the examples. To install them withAnacondarun:bash conda env create -f environment.yml conda activate plunging-criterionDownload the data files from Zenodo to the root folder of this repository.
Start a Jupyter session:
bash jupyter lab
Copyright and License
Incompact3d is distributed under GNU General Public License v3.0.
Copyright (c) 2021, Felipe N. Schuch. The remaining content in this repository is under Creative Commons Attribution CC-BY 4.0.
Owner
- Name: Felipe N. Schuch
- Login: fschuch
- Kind: user
- Location: Porto Alegre, Brazil
- Company: @omnivector-solutions
- Website: fschuch.com/en
- Twitter: fschuch
- Repositories: 6
- Profile: https://github.com/fschuch
Application Engineer | HPC, STEM, CFD, Data Science | PhD Mechanical Engineer
Citation (CITATION.cff)
cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
- family-names: "Schuch"
given-names: "Felipe"
orcid: "https://orcid.org/0000-0002-6140-0273"
- family-names: "Meiburg"
given-names: "Eckart"
orcid: "https://orcid.org/0000-0003-3670-8193"
- family-names: "Silvestrini"
given-names: "Jorge"
orcid: "https://orcid.org/0000-0001-9929-9302"
title: "Plunging condition for particle-laden flows over sloping bottoms: three-dimensional turbulence-resolving simulations"
date-released: 2020-11-06
url: "https://github.com/fschuch/incompact3d_plunging_criterion"
preferred-citation:
type: article
authors:
- family-names: "Schuch"
given-names: "Felipe"
orcid: "https://orcid.org/0000-0002-6140-0273"
- family-names: "Meiburg"
given-names: "Eckart"
orcid: "https://orcid.org/0000-0003-3670-8193"
- family-names: "Silvestrini"
given-names: "Jorge"
orcid: "https://orcid.org/0000-0001-9929-9302"
doi: "10.1016/j.cageo.2021.104880"
journal: "Computers & Geosciences"
publisher: "Elsevier"
title: "Plunging criterion for particle-laden flows over sloping bottoms: Three-dimensional turbulence-resolving simulations"
volume: 156
pages: 104880
year: 2021
url: "https://www.sciencedirect.com/science/article/pii/S0098300421001710"
GitHub Events
Total
Last Year
Committers
Last synced: about 2 years ago
Top Committers
| Name | Commits | |
|---|---|---|
| Felipe N. Schuch | f****h@e****r | 21 |
Committer Domains (Top 20 + Academic)
Issues and Pull Requests
Last synced: 11 months ago
All Time
- Total issues: 0
- Total pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Total issue authors: 0
- Total pull request authors: 0
- Average comments per issue: 0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 0
- Pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Issue authors: 0
- Pull request authors: 0
- Average comments per issue: 0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0