Skip to content

River Boundary Conditions

River input data for NEMO consist of time series for the following physical variables:

  • River discharge in \(m^3/s\);
  • Salinity in \(psu\);

You can include any number of rivers in your simulation. To correctly generate and load your river data files, please refer to the instructions below.

Note

Currently, only climatological data for rivers are available in SURF-NEMO. This means that the river data files must include exactly 12 rows of data, one for each month.

File Placement

Click here to expand...

The input data files must be placed in a subdirectory named river_input/ inside your experiment's Base Directory. The directory structure should look like this:

graph LR
    base[🏠&nbsp Base Directory]:::leaf --> A[📁&nbsp Experiment Directory]:::leaf
    base[🏠&nbsp Base Directory]:::leaf --> A1[📁&nbsp river_input/]:::folder
    A --> B[📁&nbsp .../]:::leaf

    %% Class definitions for coloring
    classDef folder fill:#d0ebff,stroke:#339af0,stroke-width:1px;
    classDef leaf fill:#f8f9fa,stroke:#adb5bd,stroke-width:1px;

File Formatting

Click here to expand...

The data files must be saved in .dat and must contain the following columns, in the specified order:

Column Variable Data Type
1 River discharge float
2 Salinity float

Formatting Guidelines

  • Delimiter: Use semicolon (;) with no spaces to separate the columns.

Here is an example of an acceptable data formatting: 

#Discharge [m3/s] ; Salinity [psu]
4000.47;0.1
800.98;0.1
38.23;0.1
49.82;0.1
32.66;0.1
22.57;0.1
14.27;0.1
10.46;0.1
11.39;0.1
8.95;0.1
17.32;0.1
5000.38;0.1

File Naming

Click here to expand...

The files must be named exactly as specified in the River Names field within the JSON configuration section 🔗River Forcing at Domain Boundaries (e.g. River Name: BusaLevante ↔ File Name: BusaLevante.dat).