Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 33 additions & 12 deletions docs/Software/Available_Applications/Delft3D.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
created_at: '2020-06-26T06:09:34Z'
description: How to run Delft3D hydrodynamic and morphodynamic modelling on NeSI.
tags:
- hydrodynamics
- morphodynamics
Expand All @@ -8,9 +9,23 @@ tags:
- wave modelling
---

{% set app_name = page.title | trim %}
{% set app_name = "Delft3D_FM" %}
{% set app = applications[app_name] %}
{% include "partials/app_header.html" %}

{{ app.description }}
{% include "partials/app/app_homepage.html" -%}
{% include "partials/app/app_warnings.html" -%}

!!! note "Module names"
`Delft3D_FM` contains solvers for both structured and unstructured meshes.
`Delft3D` contains only the structured mesh solvers and is kept for backwards compatibility.

## Available Modules

{% include "partials/app/app_version.html" -%}
{% set app = applications["Delft3D"] %}
{% include "partials/app/app_version.html" -%}
Comment on lines +25 to +27
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

Oh, how generous of ye to include the same version snippet twice. Did ye think we'd miss it the first time? Or is your memory as leaky as a sieve? One include be plenty, matey. Strike the second one from the log!

Suggested change
{% include "partials/app/app_version.html" -%}
{% include "partials/app/app_version.html" -%}
{% include "partials/app/app_version.html" -%}



## Example scripts

Expand All @@ -23,8 +38,10 @@ tags:
#!/bin/bash -e

#SBATCH --job-name Delft3D
#SBATCH --account nesi99991
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

low

Spaces instead of tabs for the Slurm header? I didn't realize we were writin' a novel. Follow the Code (Style Guide, line 402), unless ye find it too difficult to press the right key.

Suggested change
#SBATCH --account nesi99991
#SBATCH --account nesi99991
References
  1. Use tab for your Slurm header delimiter. (link)

#SBATCH --time 00:05:00 # Walltime
#SBATCH --mem 512M # Total Memory

module load Delft3D/{{app.default}}

d_hydro test_input.xml
Expand All @@ -33,27 +50,29 @@ tags:
=== "Shared Memory"

For domain based decompositions. Use `--cpus-per-task` to allocate resources.
Each subdomain runs in a separate thread, inside one executable. Limited to one node.
Each subdomain runs in a separate thread inside one executable. Limited to one node.

```sl
#!/bin/bash -e

#SBATCH --job-name Delft3D
#SBATCH --account nesi99991
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

low

More spaces where a tab should be? Ye be testin' my patience, landlubber. Use a tab as the delimiter per the guide, or ye'll be scrubbin' the decks.

Suggested change
#SBATCH --account nesi99991
#SBATCH --account nesi99991
References
  1. Use tab for your Slurm header delimiter. (link)

#SBATCH --time 00:05:00 # Walltime
#SBATCH --cpus-per-task 4
#SBATCH --mem 2G # Total Memory

module load Delft3D/{{app.default}}

srun d_hydro test_input.xml
```

=== "Distributed Memory"

Domain is split automatically in stripwise partitions.
Can run across multiple nodes. Use `--ntasks` to allocate resources.
Domain is split automatically into stripwise partitions and can run across multiple nodes.
Use `--ntasks` to allocate resources.

Cannot be used in conjunction with:

- DomainDecomposition
- Fluid mud
- Coup online
Expand All @@ -71,13 +90,15 @@ tags:
```sl
#!/bin/bash -e

#SBATCH --job-name Delft3D_distributed
#SBATCH --job-name Delft3D
#SBATCH --account nesi99991
Comment on lines +93 to +94
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

low

Arrr, another one! Do ye have a grudge against the tab key? Fix these Slurm header delimiters as well, lest the whole script be lookin' like a mess of seaweed.

Suggested change
#SBATCH --job-name Delft3D
#SBATCH --account nesi99991
#SBATCH --job-name Delft3D
#SBATCH --account nesi99991
References
  1. Use tab for your Slurm header delimiter. (link)

#SBATCH --time 00:05:00 # Walltime
#SBATCH --mem-per-cpu 1G
#SBATCH --mem-per-cpu 1G

module load Delft3D/{{app.default}}

srun d_hydro test_input.xml
```

!!! warning
Trying to use more tasks than there are partitions in your model will cause failure.
!!! warning
Trying to use more tasks than there are partitions in your model will cause failure.
Loading