Welcome to the SURF-NEMO User Guide

This user guide provide documentation for the Structured and Unstructured grid Relocatable ocean platform for Forecasting (SURF) (release version 1.01).

Please read the release notes to see what has changed since the previous release.

Note: The documentation is also available in PDF format: surf_nemo_1.01.pdf.

You can download the new SURF-NEMO release from the page https://www.surf-platform.org

Copyright:

SURF is a free and open source software packages distributed under the terms of the GNU General Public License (GPLv3).

Table of Contents

1. Introduction
2. Work-Flow of SURF-NEMO platform
3. User Configuration File: Preprocessing sections
4. User Configuration File: Postprocessing sections
- 4.1 Input parameters for selecting the figure to generate
- 4.2 Input parameters for figure properties
5. Input/Output Model Datasets
- 5.1. Input Datasets
- 5.2. Output Datasets
6. Quick Start Guide
A. Reference Configuration
- A.1. Reference Configuration for NEMO
B. Scratch Partition and its directory structures
C. Linux Root Partition and the installed packages
- C.1. Debian partition
- C.2. Installed packages
D. Bibliography

Introduction

The Structured and Unstructured grid Relocatable ocean platform for Forecasting (SURF) is an open-source package designed to generate high-resolution, nested model set-ups for oceanic forecasts over limited domains of interest. It is designed to be set up by relatively non-expert users in any region of the World Ocean using a configuration file. The package will enable limited area ocean forecasts to be run on any commercially available personal computer or laptop. SURF requires coarser-resolution ocean forecasts for the initial and boundary conditions and atmospheric forcing to force the circulation.

This User Guide describes the overall design of the structured grid component of the SURF platform based on the NEMO ocean model (SURF-NEMO). In addition to step-by-step information about running the platform, the User Guide gives a detailed description of the scripts organization and the data structures, so that SURF can be modified/integrated by users. This User Guide gives also provides a case study using available input datasets for bathymetry, the coastline, atmospheric forcing, and the coarser-resolution parent ocean model along with output datasets to check the correct implementation of the software.

Information about the SURF numerical platform is also provided on the home page

https://www.surf-platform.org

SURF also contains the unstructured grid model SHYFEM, which will be explained in a future update of the User Guide.

Relocatable ocean modelling system

SURF-NEMO (Trotta et al. 2016, 2021) provides a numerical platform for forecasting hydrodynamic and thermodynamic fields at high spatial and temporal resolutions. SURF-NEMO is designed to be embedded in any region of a larger-scale ocean prediction system, at coarser-resolution, and includes multiple nesting capabilities (i.e., consecutive nested models can be implemented with increasing grid resolutions), starting with the first nesting in a large-scale ocean model and reaching horizontal grid resolutions of a few hundred metres. For each nesting, the parent coarse-grid model provides the initial and lateral boundary conditions for the SURF child components.

This relocatable ocean model system is intended to be a valuable tool that supports other Decision Support System (DSS) that may require hydrodynamic, temperature and salinity forecasts at high resolution, such as oil spill monitoring, search and rescue operations, navigation routing, fisheries and tourism.

Virtual Machine Environment

SURF-NEMO is based on a virtual machine environment in which the hydrodynamic NEMO model and several pre- and post-processing tools are connected to the required input fields and the numerical outputs of the limited area simulation. The Installation Chapter (6.1) provides details of how to download and install the package.

A virtual machine is a software-based computer that enables the emulation of operating systems with "virtual" access to hardware resources such as CPU, RAM, networking and storage. The operating system that runs inside a virtual machine is called the guest, which appears in a window on your computer's own operating system, commonly referred to as the host.

The virtualization software used is the free and open-source Oracle VM VirtualBox package, on which the Debian Linux operating system was installed.

Virtual machines offer many advantages and can encapsulate an entire PC environment including the operating system, applications and all data, inside a single file. As a packaged application, it is easier to set up than installing a full suite of software that must work together. The virtual machine can be distributed as a ready-made and fully configured system, anf thus has advantages for configuration and distribution. A virtual machine can also run on various hardware platforms.

Source Code

The SURF source codes are contained in a package distributed as a tar.gz archive. The archive contains the NEMO code, the pre- and post-processing codes and a template user-configuration file. The Installation Chapter (6.2) describes how to download and install the package.

NEMO consists of open-source code written in Fortran 90 and is parallelized with a domain decomposition using the MPI library. The model outputs from the SURF-NEMO simulations are all in NetCDF format.

The pre- and post-processing code are developed in Julia, NCL, Python and Fortran programming languages. The NetCDF Operator (NCO) and Climate Data Operators (CDO) are used to facilitate the manipulation of the NetCDF datasets. These tools are specifically developed and optimised for SURF to reduce the computation latency and to ensure efficient memory usage. Currently, pre- and post-processing can only be run in serial mode (i.e., only executed on one processor). The structure of the SURF source code package is shown in appendix B.

Work-Flow of the SURF-NEMO platform

The schematic work-flow diagrams in Fig. 2.1 shown the steps involved in the SURF-NEMO numerical platform. The steps in the most recent version release are grouped as follows:

Initialization: the user specifies the values of the input simulation parameters for the ocean model in the configuration file (horizontal and vertical grids, subgrid scale parameterizations, etc.) for the specific experiment selected.
Access and download of the input datasets: this is an automated step in which the input datasets for the selected simulation period are downloaded from remote or local data repositories, as specified in the configuration file. The input data are the bathymetry, the coastline, the atmospheric forcing and the coarse resolution parent ocean model for the initial and lateral boundary condition datasets.
Spatial numerical grid generation: this is an automated step that generates the horizontal and vertical grid for the nested model.
Input data regridding: this is an automated step that generates the bottom topography, surface forcing, initial and open lateral boundary conditions datasets on the child grid.
Forecast: another automated step in which the NEMO code is exectuted to produce the final outputs.
Post-processing: in this step the visualization and analysis procedures of the final outputs are considered. Different options of postoprocessing are available, i.e. comparing parent/child fields, comparing the simulation results with in-situ or satellite datasets and converting the datasets into what?

/docs/surf_nemo/assets/img/workflow_schematic.png — Work-flow of the Relocatable SURF-NEMO platform.

The graphical calling function flow shown in Figure 2.2 represent all paths traversed through a program during its execution and shows how the program is completed from start to finish, step-by-step. The six macro-tasks identified are: (1) child meshmask generation; (2) atmospheric data regridding; (3) ocean IC data regridding; (4) ocean BC data regridding and OBC data extraction; (5) ocean model simulation; and (6) visualization and data analysis.

/docs/surf_nemo/assets/img/workflow_sequential.png — Graphical calling function flow of the Relocatable SURF-NEMO platform.

The computational tasks are not independent of each other. The dependency flow graph of the macrotasks is given in Figure 2.3. Each node (from A to F) represents a macro-task and the solid edges represent data dependencies among these macro-tasks. From node A, tree edge can take us to node B, node C and D. Node E can begin once all the lower nodes are completed.

/docs/surf_nemo/assets/img/workflow_dependency.png — Dependency flow graph of macro-tasks.

Setting up the input model parameters

The first task executed by each macro-task consists of setting up the values of the input model parameters, which are obtained from the configuration files setParFree.json and setParFixed.json. The configuration file structure and the input parameters are described in Chapter 3 and Appendix A. In this phase, the read_inJsonFree and read_inJsonFixed procedures are executed to respectively define the user-free and fixed input parameters required to execute the NEMO model and all of the pre- and post-processing tasks. The procedures set_pathData and set_fileData are also called to define all of the paths and file names used by the program for the specific numerical simulation.

Child Meshmask Generation

The child grid is generated after the model configuration phase. The NEMO model uses the Arakawa C grid for spatial discretization, with the state variables defined on the staggered grid illustrated in Figure 2.4. In the C grid the scalar quantities (temperature T, salinity S, pressure p, density $\rho$) are defined at the center of each grid volume. The velocity field components (zonal u, meridional v and vertical w) are shifted by half a grid width in their respective direction so that they are defined at the edges of the grid volumes. The procedures executed in this phase are:

Generation of the child 2D-mesh.
Interpolation of the source bathymetric dataset on the generated child grid.
Generation of the child 3D-meshmask.

/docs/surf_nemo/assets/img/ArakawaC.png — The staggered Arakawa C-grid used by NEMO ocean model.

Horizontal grid

The horizontal grid generation is managed by the NEMO-MESH code. SURF uses ONLY a rectangular (or latitude-longitude) grid in a spherical coordinate system $\lambda,\varphi$. The horizontal grid (expressed in degrees) is generated by specifying the number of points $n_{\lambda}$ and $n_{\varphi}$,respectively, in zonal and meridional directions, and the respective grid sizes $\Delta\lambda$ and $\Delta\varphi$ (in degrees) and the longitude and latitude $(\lambda,\varphi)_{1,1}$ of the first row and first column of the T grid. On the $\lambda\varphi$ plane, the location of the T points of the grid are:

$$ \begin{equation} \begin{array}{ll} \lambda_{i,j} = \lambda_{11} + (i-1) \Delta \lambda \hspace{0.5cm} \mbox{with} \hspace{0.2cm} i=1.....n_\lambda \\ \varphi_{i,j} = \varphi_{11} + (j-1) \Delta \varphi \hspace{0.5cm} \mbox{with} \hspace{0.2cm} j=1.....n_\varphi \end{array} \end{equation} $$

The u, v points of the grid are shifted by half a grid width in the zonal e/o meridional direction, as indicated in Fig. 2.4.

Bathymetry regridding

In this phase the bathymetric dataset is interpolated on the child grid, which is required to generate the 3D meshmask. The procedures in this phase are:

Accessing and downloading the source bathymetry and the coastline datasets.
Manipulating the bathymetry dataset.
The spatial interpolation of the source bathymetric on the child grid.

Access the bathymetry and coastline datasets

A procedure for checking if the necessary input datasets are present in the experiment directory $PATH_IDEXP/data/data00/indata/ is executed. If some of the requested data are not present then the procedures downlCoastlineInfile and downlBathyInfile are automatically executed to download the coastline and the bathymetry, respectively, from remote or local data repositories as specified in the configuration file setParFree.json.

Manipulating and smoothing bathymetry

Before conducting the spatial interpolation on the child grid, the source bathymetry data product can be manipulated if specified in the configuration file setParFree.json. Several methods can be used:

Add a constant value to the surface elevation for the whole nested region (e.g., an inland body of water with water level below the global ocean level such as the Caspian Sea).
Set maximum and minimum values that are different from the source value (e.g., if a minimum depth of 5 metres or a maximum depth of less than the actual depth is required).
Define the land/sea interface grid points according to the input coastline.
Set maximums and minimums inside sub-regions (e.g., to mask a specific area)
Smooth out bathymetry variations with the Shapiro filter. This is a high order horizontal filter that efficiently removes small scale grid noise without affecting the physical structures of a field. A Shapiro filter of a 2N order of accuracy is applied to a variable based on the expression:
$$ \begin{equation} \label{eq:shapiro_filter} \tilde{w_i} = F^{2N}(w_i) = \left[ I + (-1)^{N-1} \frac{\delta^{2N}}{2^{2N}} \right] (w_i) = w_i + (-1)^{N-1} \frac{\delta^{2N} w_i}{2^{2N}} \end{equation} $$
where $\tilde{w_i}$ is the filtered value of variable $w$ at point $x_i$, $I$ is the identity operator and $\delta^{2N}$ is the even composition of the standard difference operator $\delta$ (Richtmyer, 1957). This filter is a discrete symmetric operator with a (2N + 1) point stencil. It acts as a low-pass filter that preserves the low-frequency content (i.e., largest wavelengths) and completely dissipates the high-frequency content (i.e., shortest wavelengths) from the original field.

Interpolation of bathymetric data

The spatial interpolation of the source bathymetric dataset on the child grid can be conducted after the manipulation of the source bathymetry phase. The procedures are based on the Spherical Coordinate Remapping and Interpolation Package (SCRIP) code. The interpolation methods available are listed and described in Section 3.

Meshmask and Vertical grid

The vertical grid generation is managed by the NEMO-MESH code. The type of vertical grid used in SURF corresponds to geopotential z-coordinate levels with partial bottom cell representation of the bathymetry. After the bathymetry $z = H(\lambda,\varphi)$ and the number of levels $n_{z}$ have been specified, the vertical location of w- and t-levels (expressed in metres) are defined, except in the bottom layer, from the following analytic expression:

$$ \begin{equation} z(k) = h_{sur} - h_{0} k - h_{1} log [cosh (( k - h_{th}) h_{cr})] \end{equation} $$

where the coefficients $h_{sur}$, $h_0$, $h_1$, $h_{th}$ and $h_{cr}$ are the parameters to be specified. $h_{cr}$ represents the stretching factor of the grid and $h_{th}$ is the approximate model level at which maximum stretching occurs. This expression enables stretched z-coordinate vertical levels to be defined, which are smoothly distributed along the water column, with appropriate thinning designed to better resolve the surface and intermediate layers. Through partial cell parameterization, the thickness of the bottom layer can vary as a function of the geographical location $(x,y)_{i,j}$ which allows a better representation of the real bathymetry.

/docs/surf_nemo/assets/img/meshOceTUVxy_FC.png — (A) Horizontal grid.

/docs/surf_nemo/assets/img/meshOceTz.png — (A) Horizontal grid.

Input data Regridding

Regridding, also called remapping, is the process of changing the grid (from a source to a destination grid) underlying the field data values while preserving the qualities of the original data. In this section we describe the spatial extrapolation and interpolation procedure used in in SURF to remap the input fields on the child grid. This phase will generate the surface forcing, initial and open lateral boundary condition datasets on the child grid. The procedures in this phase are:

Accessing and downloading the input datasets
Rotation of the vector fields (if required)
Extrapolation of the input datasets
Spatial interpolation of the source dataset on the child grid
Lateral Open Boundary Condition dataset generation

Access and download of the input datasets

A procedure for checking if the necessary input datasets are in the experiment directory $PATH_IDEXP/data/ is executed. If any of the requested data are not present then the procedures downlAtmSrc, downlOceICSrc and downlOceBCSrc are automatically executed to respectively download the atmospheric forcing and the initial and lateral boundary condition datasets for the selected period of the simulation from remote or local data repositories, as specified in the configuration file setParFree.json.

Rotation of horizontal velocity u, v

When the parent coarse resolution model is defined on a rotated or a curvilinear grid (e.g., the global tripolar grid, Fig. 2.6(a)) one more step is required to interpolate the horizontal velocity fields on the child grid. In an ocean model with a “distorted” grid, the velocity vectors are obtained according to the direction of the grid lines. In a staggered Arakawa C grid system, the velocity field components are defined at the cell edges (the gray arrows in Fig. 2.6(b)). A rotation in the latitudinal and longitudinal directions of the velocity components must be applied to change the vectors from the local system $(x,y)$ to a geographical system $(x^{'},y^{'})$, so that U gives the zonal component (W-E direction) and V the meridional component (S-N direction) of the velocity vector. Therefore, to transform the $(x,y)$ coordinates to the $(x^{'},y^{'})$ coordinates, the vectors must be rotated according to vectors need to be rotated according to

$$ \begin{equation} \begin{array}{ll} U^{'}(x_{t}^{'},y_{t}^{'}) = U(x_{t},y_{t})*cos(\alpha_{t}) - V(x_{t},y_{t})*sin(\alpha_{t}) \\ V^{'}(x_{t}^{'},y_{t}^{'}) = U(x_{t},y_{t})*sin(\alpha_{t}) + V(x_{t},y_{t})*cos(\alpha_{t}) \end{array} \end{equation} $$

For parent models with rotated rectangle grids, the angle is almost constant. For those with curvilinear tripolar grids (as shown in Fig. 2.6(a)) the angle will vary within each grid cell.

/docs/surf_nemo/assets/img/orca_grid.png — (A)

/docs/surf_nemo/assets/img/rotvector.png — (A)

Extrapolation methods

The extrapolation procedure used in SURF is referred to as the sea-over-land (SOL) procedure, and provides the ocean field values for areas near the coastline where the parent model solutions are not defined. The SOL procedure iteratively extrapolates the ocean quantities on the land grid-points, so they can be interpolated on the child grid. This also applies to several atmospheric fields and takes into account the atmospheric land-sea mask, to avoid land contaminations near the land-sea boundaries.

The SOL procedure is applied to the coarse resolution ocean fields to extrapolate the salinity, temperature, sea surface height and current fields to the land points. The ocean fields in the nested-grid points near to the coast can then be defined (by interpolation). The procedure applied for the atmospheric forcing fields takes into account the atmospheric land-sea mask to ensure there is no contamination from the land atmospheric fields to the sea points.

The source code is provided in the directory $PATH_SURFNEMO/utilities/extrapol/seaoverland.

Interpolation methods

The extrapolation procedure described in the previous section provides the input data for the interpolator. The procedures are based on the Spherical Coordinate Remapping and Interpolation Package (SCRIP) code. SCRIP is a software package that computes addresses and weights for remapping and interpolating fields between grids in spherical coordinates. The package should work for any grid on the surface of a sphere. SCRIP currently supports five remapping options:

Conservative remapping: First- and second-order conservative remapping, as described by Jones (1999, Monthly Weather Review, 127, 2204-2210).
Bilinear interpolation: Slightly generalized to use a local bilinear approximation (only logically rectangular grids).
Bicubic interpolation: Similarly generalized (only logically rectangular grids).
Distance-weighted averaging: The inverse-distance-weighted average of a user-specified number of nearest neighbour values.
Particle remapping: A conservative particle (Monte-Carlo-like) remapping scheme

The source code can be found in the directory $PATH_SURFNEMO/nemo/NEMOGCM/TOOLS/WEIGHTS.

Regridding can be separated into two stages. The first stage is the generation of an interpolation weight matrix that describes how points in the source grid contribute to points in the destination grid. The second stage is the multiplication of values on the source grid by the interpolation weight matrix to produce the appropriate values on the destination grid.

The SCRIP spatial interpolation procedure is applied to the input fields for the generated bathymetry, atmospheric forcing and initial and boundary conditions files that are necessary to run the NEMO code. The generated files are stored in the directory $PATH_EXP/IDEXP/data/.

Lateral Open Boundary Condition

The lateral open boundary condition for the selected nested-domain is implemented using the BDY module of NEMO. Two numerical algorithms are used to treat open boundary conditions depending on the prognostic simulated variables. The Flather scheme (Oddo and Pinardi, 2008) is used for barotropic velocities, while the flow relaxation scheme (Engerdahl, 1995) is considered for baroclinic velocities, active tracers and sea surface height. In our formulation, we provide external data along straight open boundary lines, and the relaxation area is equal to one internal grid point. As the parent coarse resolution ocean model provides only the total velocity field, the interpolated total velocity field in the child grid is split into barotropic and baroclinic components. An integral constraint method is imposed to preserve the total transport after the interpolation.

This process involves the following steps: (1) defining the open boundary geometry (for each of the T, U and V grids) and physical fields (active tracers, sea-surface height, barotropic and baroclinic velocities) at the open boundary points using the geometry_bdy and fields_bdy procedures, respectively; (2) writing these data arrays to the files that are necessary to run the NEMO code. The algorithms used for the different fields are the Flather radiation scheme for the barotropic velocities and the sea surface height and the Flow relaxation scheme for the baroclinic velocities and active tracers. The generated files are stored in the directory $PATH_EXP/IDEXP/data/.

Integral Constraint at the open boundary

The downscaling is designed to ensure that the volume transport across the open boundary (OB) of the child model matches that across the corresponding section of the parent model. At the eastern/western boundaries U-Points are imposed using the following conditions $$ \begin{equation} \begin{array}{ll} \int_{y_2}^{y_1} \int_{-H_{child}}^{\eta_{child}} U_{child} dz dy = \int_{y_2}^{y_1} \int_{-H_{parent}}^{\eta_{parent}} U_{parent} dz dy \end{array} \end{equation} $$ where $y_1, y_2$ are the extremes of the open boundary section; $\eta_{child}, H_{child}$ are the surface elevation and the bathymetry of the child model at the boundary, respectively; $\eta_{parent}, H_{parent}$ are the surface elevation and the bathymetry of the parent model at the boundary, respectively; and $U_{parent},U_{child}$ are the parent/child total zonal velocities (normal velocity to the W/E boundaries). The corrected velocity component normal to the boundary $V_{child}$ is given (see N. Pinardi et al., 2003) by: $$ \begin{equation} \begin{array}{ll} U_{child} (x,y,z,t) = U_{interp} - U_{correction} \end{array} \end{equation} $$ where $U_{interp}$ is the $U_{parent}$ interpolated on the child open boundary points and the velocity correction is given by $$ \begin{equation} \begin{array}{ll} U_{correction} = \frac{M_{interp} - M_{parent}}{S} \end{array} \end{equation} $$ where $ M_{interp} = \int_{y_2}^{y_1} \int_{-H_{child}}^{\eta_{child}} U_{interp} dz dy $ is the volume transport across the OB, the $ M_{parent} = \int_{y_2}^{y_1} \int_{-H_{parent}}^{\eta_{parent}} U_{parent} dz dy $ is the volume transport across the corresponding OB and $ S = \int_{y_2}^{y_1} \int_{-H_{child}}^{\eta_{child}} dz dy $ is the area of the section. These conditions are similarly imposed for the meridional velocity at the northern/southern boundaries (V-Points). The Integral Constraint procedure ensures that the interpolation does not modify the net transport across the child model lateral open boundary.

Model run

Finally, the NEMO code is numerically integrated by the SURF platform. The output files are continuously updated, given a fixed output frequency, throughout the execution of the program. The logfile is a text file NEMO produces that contains data on how far the run has advanced by providing the time step. After the model run is completed, the output files are stored in the experiment directory $PATH_IDEXP/data/data00/outdata/ (see appendix B).

Post-processing

In this step the visualization and analysis procedures of the forecast are considered. These can be activated after the execution of each macro-task. The user can visualize the input, regridded and output datasets, compare parent/child fields and convert the model output datasets.

User Configuration File: Preprocessing Sections

To execute the SURF-NEMO package, the user must input several model parameters to select a specific simulation region, the simulation period, horizontal and vertical turbulence schemes, input datasets, interpolation methods, etc. These parameters are used to conduct the pre- and post-processing phases and to populate the Fortran namelist required to execute the NEMO-OPA code.

These choices are made by specifying the values of the input model parameters in the user configuration file "setParFree.json", where all the free-user input parameters are grouped in different sections according to their functionality. In this chapter we provide details of each section of the configuration file and specify the admissible values, the unit measures and the “reference value” used for the test case experiment for each parameter (see Section 6.4).

Some of the input model parameters are fixed and defined inside the SURF source package in the file "setParFix" (see Appendix A for more details)

Configuration file and JSON Object Structure

The user configuration file has a JavaScript Object Notation (JSON)-based format. JSON is a simple, text-based method of storing and transmitting structured data. This format is "self-describing", easy to understand and can support complex data types and structures. It is commonly used for configuration files in web applications.

JSON syntax is derived from JavaScript object notation syntax and can contain either an array of values or an object (an associative array of name/value pairs also referred to as properties). An array is surrounded by square brackets, [ and ], and contains a comma-separated list of values. An object is surrounded by curly brackets,{ and }, and contains a comma-separated list of name/value pairs. A name/value pair consists of a field name (in double quotes), followed by a colon (:), followed by the field value. A value in an array or object can be of type number (integer or floating-point), string (in double-quotes), boolean (true or false), another array (surrounded by square brackets, [ and ]), another object (surrounded by curly brackets, and ), or null.

The JSON configuration file defined for the SURF-NEMO package is shown in Figure 3.1. At the top level, we have created the “sections” array, which is an object with just one name/value pair. This array contains various objects. Each object contains three properties: a title that reflects the contents of the section, a four-digit alphanumeric identifier ID (id = A001, A002, etc. for pre-processing sections and id = B001, B002, etc. for post-processing sections) and an array of items delimited by square brackets. Each element of the “items” array is an object that is identified by a name, a value, a data type (int, float, double, bool and string) and a brief description of the corresponding parameter.

/docs/surf_nemo/assets/img/jsonFile.png — JSON representation for the SURF-NEMO user-configuration file.

Genearal Input parameters

Section set_surf

The section set_surf contains the following two parameters:

nnest

Number of nesting domain.

Type: int Ref.Value: 1 Range: 1, 2, 3

nameNestDomain

Name of the nest domain to simulate.

Type: string Ref.Value: gulfTaranto

Section set_lrun

The section set_lrun contains the logical parameters to activate/deactivate specific tasks.

lrun_childMeshMask

Enables the execution of the CHILD-MESHMASK GENERATION task.

Type: bool Ref.Value: True

lrun_regridPreAtm

Enables the execution of the ATMOSPHERIC-DATA-REGRIDDING task.

Type: bool Ref.Value: True

lrun_regridPreOceIC

Enables the execution of the OCEAN-IC-DATA-REGRIDDING phase.

Type: bool Ref.Value: True

lrun_regridPreOceBC

Enables the execution of the OCEAN-BC-DATA-REGRIDDING phase.

Type: bool Ref.Value: True

lrun_regridPreTideBC

Enables the execution of the TIDE-BC-DATA-REGRIDDING phase.

Type: bool Ref.Value: True

lrun_regridPreWeights

Enables the computation/copy of WEIGHT-FILEs for input_fields REMAPPING (if lrun_regridPre=True).

Type: bool Ref.Value: True

lrun_ocean

Enables the execution of the NEMO codes.

Type: bool Ref.Value: True

lrun_regridOutUV

Enables the execution of the output-UV_fields REMAPPING (from UV GRID to T-GRID).

Type: bool Ref.Value: False

lrun_regridOutUVWeghts

Enables the computation/copy of WHEGHT-FILEs for output-UV_fields REMAPPING (if lrun_regridOutUV-True).

Type: bool Ref.Value: False

lrun_shapFiltBat

Enables the execution of the SHAPIRO Filter for Bathymetric datasets.

Type: bool Ref.Value: True

lrun_shapFiltOce

Enable the execution of the SHAPIRO Filter fo Ocean datasets.

Type: bool Ref.Value: False

Input parameters for spatial grid generation

Section set_xyGrid

The section set_xyGrid contains the free input parameters required for the generation of the horizontal model grid.

gr_xygridSpec

Parameters specification for the horizontal grid: if = 0, the grid is function of the 5 variables (lam0,phi0,nlam,nphi,dxy) if = 1, the grid is function of the 5 variables (lam0,phi0,lam1,phi1,dxy)..

Type: int Ref.Value: 0 Range: 0, 1

gr_jpidta

Number of grid points in zonal direction to specify if xygridSpec=0 (if =NOTUSED, parameter not read).

Type: int Ref.Value: 94

gr_jpjdta

Number of grid points in meridional direction to specify if xygridSpec=0 (if =NOTUSED, parameter not read).

Type: int Ref.Value: 79

gr_ppglam0

Longitude of the first raw and column T-point to specify if xygridSpec=0,1.

Type: float Ref.Value: 16.4375

gr_ppglam1

Longitude of the last raw and column T-point to specify if xygridSpec=1 (if =NOTUSED, parameter not read).

Type: float Ref.Value: NOTUSED

gr_ppgphi0

Latitude of the first raw and column T-point to specify if xygridSpec=0,1.

Type: float Ref.Value: 38.9375

gr_ppgphi1

Latitude of the last raw and column T-point to specify if xygridSpec=1 (if =NOTUSED, parameter not read).

Type: float Ref.Value: NOTUSED

gr_jp_cfg

Child model resolution (1/gr_jp_cfg) to specify if xygridSpec=0,1.

Type: float Ref.Value: 48.

gr_jp_cfg_father

Father model resolution (1/gr_jp_cfg_father).

Type: float Ref.Value: 16.

Section set_zGrid

The section set_zGrid contains the free input parameters used to generate the vertical grid.

gr_jpkdta

Number of vertical levels.

Type: int Ref.Value: 120

gr_zgridSpec

Parameters specification for the vertical grid: if = 0, the grid is function of the 5 variables (hh0,h1,hsur,hcr,hth) if = 1, the grid is function of the 4 variables (dzmin,hmax,hcr,hth).

Type: int Ref.Value: 1. Range: 0, 1

gr_ppsur

Parameter h_sur for the z-coord. trasformation to specify if zgridSpec=0 (if =NOTUSED, parameter not read).

Type: double Ref.Value: NOTUSED

gr_ppa0

Parameter h_0 for the z-coordinate trasformation to specify if zgridSpec=0 (if =NOTUSED, parameter not read).

Type: double Ref.Value: NOTUSED

gr_ppa1

Parameter h_1 for the z-coordinate trasformation to specify if zgridSpec=0 (if =NOTUSED, parameter not read).

Type: double Ref.Value: NOTUSED

gr_ppkth

Parameter h_th which gives the approximate layer number above which stretching will be maximum (usually of order nz/2) to specify if zgridSpec=0,1.

Type: double Ref.Value: 100

gr_ppacr

Parameter h_cr which gives the grid stretching factor (the highest gr_ppacr, the smallest the stretching) to specify if zgridSpec=0,1.

Type: double Ref.Value: 30

gr_ppdzminw

Depth of the top (first) model layer depth of second 'w' level to specify if zgridSpec=1 (if =NOTUSED, parameter not read).

Type: double Ref.Value: 2.8

gr_pphmaxw

Maximum depth of the ocean depth of the last 'w' level (set to 0.0 to be computed) to specify if zgridSpec=1 (if =NOTUSED, parameter not read).

Type: double Ref.Value: 0.0

gr_dbletanh

Enables the use of the double tanh function for vertical coordinates.

Type: bool. Ref.Value: False.

gr_ppa2

Parameter h_2 to specify if gr_dbletanh=True (if =NOTUSED, parameter not read).

Type: double Ref.Value: NOTUSED

gr_ppkth2

Parameter h_th2 if gr_dbletanh=True (if =NOTUSED, parameter not read).

Type: double Ref.Value: NOTUSED

gr_ppacr2

Parameter h_cr2 if gr_dbletanh=True (if =NOTUSED, parameter not read).

Type: double Ref.Value: NOTUSED

Input parameters for date and time simulation

Section set_dateTime

This section of the JSON file contains the free input parameters used to define the period and time discretization of the simulation.

start_date

Initial date of the simulation (the run starts at 00:00).

Type: string Ref.Value: 20141005

ndays

Total number of simulation days.

Type: int Ref.Value: 2

ndays_spinup

Number of spin-up days.

Type: int Ref.Value: 1 Range: 0:ndays

dom_rdt

Simulation 'baroclinic' time step (...40, 48, 50, 60, 72, 80, 90, 100, 120, 144...).

Type: float Ref.Value: 150.

runMan_write

Frequency of write in the output file express as the number of simulation time step.

Type: int Ref.Value: 24

dom_btAuto

Enables the automatically definition of baro-timestep to be just below a user defined maximum courant number dom_btCmax.

Type: bool Ref.Value: False

dom_btCmax

Maximum courant number (allowed if dom_btAuto=True).

Type: float Ref.Value: 0.8

dom_baro

Number of iterations of barotropic mode during dom_rdt (allowed if dom_btAuto=False).

Type: int Ref.Value: 100

runMan_rstart

Start from rest (False) or from a restart file (True).

Type: bool Ref.Value: True

ndays_xsimu

Number of days per each restart simulation.

Type: float Ref.Value: 1

Input parameters for surface and lateral boundary conditions

Section set_sbc

This section of the JSON file contains the free input parameters used to define surface boundary condition.

sbc_iformulat

Surface boundary condition formulation to be used (=0)MFS bulk formulat,(=1)fluxform+ssRest,(=2)CORE formulation.

Type: int Ref.Value: 0 Range: 0, 1, 2

sbc_ltimeInterp

Activate, or not, the time interpolation (=False) steplike shape forcing (=True) broken line shape forcing.

Type: bool Ref.Value: True

sbc_zreftemp

Reference height (m) for the Air Temperature and humidity (for the CORE formulation).

Type: float Ref.Value: 10.

sbc_zrefwind

Reference height (m) for the wind vector (for the CORE formulation).

Type: float Ref.Value: 10.

sbc_aprdyn

Enables the inclusion of atmospheric pressure gradien in ocean and ice Eqs..

Type: bool Ref.Value: False

sbc_sclapr

Scaling factor to convert atmospheric presure from hPa to Pa.

Type: float Ref.Value: 1.

Section set_obc

This section of the JSON file contains the free input parameters used to define lateral open boundary conditions.

obc_dyn2d

Algorithm of boundary condition for barotropic solution: flather.

Type: string Ref.Value: flather Range: flather

obc_dyn2d_dta

Boundary data to use: (=0)Initial condition (=1)external data (=2)tidal forcing (=3)xternal data+tidal.

Type: int Ref.Value: 1 Range: 0, 1, 2 ,3

obc_dyn3d

Algorithm of boundary condition for baroclinic velocities: frs, orlanski.

Type: string Ref.Value: frs Range: frs, orlanski

obc_dyn3d_dta

Boundary data to use: (=0)Initial condition (=1)external data.

Type: int Ref.Value: 1 Range: 0, 1

obc_tra

Algorithm of boundary condition for active tracers: frs, orlanski.

Type: string Ref.Value: frs Range: frs, orlanski

obc_tra_dta

Boundary data to use: (=0)Initial condition (=1)external data.

Type: int Ref.Value: 1 Range: 0, 1

obc_rimwidth

Width of the FRS zone.

Type: int Ref.Value: 1

obc_ltimeInterp

Activate, or not, the time interpolation (=False) steplike shape forcing (=True) broken line shape forcing.

Type: bool Ref.Value: True

obc_lvelCorr

Activate the Integral Contraint method to preserve the total transport after the interpolation.

Type: bool Ref.Value: False

Section set_tide

This section of the JSON file contains the free input parameters used to define the tidal components which can be added both as the equilibrium tidal sea level and/or only at the lateral boundaries

latBtide_lPot

Enables the use of tidal potential forcing.

Type: bool Ref.Value: True

latBtide_K1

Name of the Lunar diurnal K1 tidal component (if =NOTUSED, component not used).

Type: string Ref.Value: K1 Range: K1

latBtide_O1

Name of the Lunar diurnal O1 tidal component (if =NOTUSED, component not used).

Type: string Ref.Value: O1 Range: O1

latBtide_P1

Name of the Solar diurnal P1 tidal component (if =NOTUSED, component not used).

Type: string Ref.Value: P1 Range: P1

latBtide_Q1

Name of the Larger lunar elliptic diurnal Q1 tidal component (if =NOTUSED, component not used).

Type: string Ref.Value: Q1 Range: Q1

latBtide_K2

Name of the Lunisolar semidiurnal K2 tidal component (if =NOTUSED, component not used)

Type: string Ref.Value: K2 Range: K2

latBtide_M2

Name of the Principal lunar semidiurnal M2 tidal component (if =NOTUSED, component not used).

Type: string Ref.Value: M2 Range: M2

latBtide_N2

Name of the Larger lunar elliptic semidiurnal N2 tidal component (if =NOTUSED, component not used).

Type: string Ref.Value: N2 Range: N2

latBtide_S2

Name of the Principal solar semidiurnal S2 tidal component (if =NOTUSED, component not used).

Type: string Ref.Value: S2 Range: S2

latBtide_M4

Name of the Shallow water overtides of principal lunar M4 tidal component (if =NOTUSED, component not used).

Type: string Ref.Value: M4 Range: M4

latBtide_Mm

Name of the Lunar monthly Mm tidal component (if =NOTUSED, component not used).

Type: string Ref.Value: Mm Range: Mm

latBtide_Mf

Name of the Lunisolar fortnightly Mf tidal component (if =NOTUSED, component not used).

Type: string Ref.Value: Mf Range: Mf

Input parameters for physical parametrization

Section set_eos

This section of the JSON file contains the free input parameters used to define equation of state of sea water.

eos_type

type of equation of state and Brunt-Vaisala frequency: (=-1)TEOS-10, (=0)EOS-80, (=1)S-EOS.

Type: int Ref.Value: 0 Range: -1, 0, 1

eos_useCT

Enables the use of Conservative Temp. ==> surface CT converted in Pot. Temp. in sbcssm.

Type: bool Ref.Value: False

eos_a0

S-EOS coefficients: thermal expension coefficient.

Type: float Ref.Value: 0.1655

eos_b0

S-EOS coefficients: saline expension coefficient.

Type: float Ref.Value: 0.76554

eos_lambda1

S-EOS coefficients: cabbeling coeff in T^2 (=0 for linear eos).

Type: float Ref.Value: 0.05952

eos_lambda2

S-EOS coefficients: cabbeling coeff in S^2 (=0 for linear eos).

Type: float Ref.Value: 0.00074914

eos_mu1

S-EOS coefficients: thermobaric coeff. in T (=0 for linear eos).

Type: float Ref.Value: 0.0001497

eos_mu2

S-EOS coefficients: thermobaric coeff. in S (=0 for linear eos).

Type: float Ref.Value: 1.109e-05

eos_nu

S-EOS coefficients: cabbeling coeff in T*S (=0 for linear eos).

Type: float Ref.Value: 0.0024341

Section set_botFric

This section of the JSON file contains the free input parameters used to define the bottom friction

botB_bfri2

Bottom drag coefficient (non linear case).

Type: float Ref.Value: 1.e-3

botB_bfeb2

Bottom turbulent kinetic energy background (m^2/s^2).

Type: float Ref.Value: 2.5e-3

Section set_xyturbTracers

This section of the JSON file contains the free input parameters used to define the parameterization of lateral subgrid-scale diffusion for tracers.

tra_typeOperator

Type of the operator used (0)laplacian, (1)bilaplacian.

Type: int Ref.Value: 0 Range: 0, 1

tra_eddycoeffSpec

Horizontal eddy coeff. specification (0)def. by coeff. tra_eddycoeff_child, (1)def. from coeff. tra_eddycoeff_father according fat/child coeff. relation.

Type: int Ref.Value: 0 Range: 0, 1

tra_eddycoeff_child

Horizontal eddy diffusivity (>0 (m2/s) laplacian or < 0 (m4/s2) bilaplacian) of the child model (if =NOTUSED, parameter not read).

Type: float Ref.Value: 80.

tra_eddycoeff_father

Horizontal eddy diffusivity (>0 (m2/s) laplacian or < 0 (m4/s2) bilaplacian) of the father model to be used in fat/child coeff. relation (if =NOTUSED, parameter not read).

Type: float Ref.Value: NOTUSED

tra_factor

Factor to be used in fat/child coeff. relation (if laplacian:(a_child=factor*???), if bilaplacian:(a_child=factor*a_fat(Dx_child/Dx_fat)^4)).

Type: float Ref.Value: 1

Section set_xyturbMomentum

This section of the JSON file contains the free input parameters used to define the parameterization of lateral subgrid-scale viscosity for momentum.

dyn_typeOperator

type of the operator used (0)laplacian, (1)bilaplacian.

Type: int Ref.Value: 1 Range: 0, 1

dyn_eddycoeffSpec

horizontal eddy coeff. specification (0)def. by coeff. dyn_eddycoeff_child, (1)def. from coeff. dyn_eddycoeff_father according fat/chld coeff. relation.

Type: int Ref.Value: 1 Range: 0, 1

dyn_eddycoeff_child

horizontal eddy viscosity (>0 (m2/s) laplacian or < 0 (m4/s2) bilaplacian) of the child model (if =NOTUSED, parameter not read).

Type: float Ref.Value: NOTUSED

dyn_eddycoeff_father

horizontal eddy viscosity (>0 (m2/s) laplacian or < 0 (m4/s2) bilaplacian) of the father model to be used in fat/child coeff. relation (if =NOTUSED, parameter not read).

Type: float Ref.Value: -0.5e10

dyn_factor

factor to be used in father/child coeff. relation (if laplacian:(a_child=factor*???), if bilaplacian:(a_child=factor*a_fat(Dx_child/Dx_fat)^4)).

Type: float Ref.Value: 1.

Section set_zturb

This section of the JSON file contains the free input parameters used to define the vertical eddy viscosity and diffusivity coefficients

zdyn_avm0

Vertical eddy viscosity [m2/s] (background Kz if not 'key_zdfcst').

Type: float Ref.Value: 1.2e-5

zdyn_avt0

Vertical eddy diffusivity [m2/s] (background Kz if not 'key_zdfcst').

Type: float Ref.Value: 1.2e-6

zdyn_avevd

Evd mixing coefficient [m2/s].

Type: float Ref.Value: 10.

zdynric_avmri

Maximum value of the vertical viscosity.

Type: float Ref.Value: 1.e-2

zdynric_alp

Vertical eddy viscosity [m2/s] (background Kz if not 'key_zdfcst').

Type: float Ref.Value: 5.

zdynric_ric

Vertical eddy viscosity [m2/s] (background Kz if not 'key_zdfcst').

Type: float Ref.Value: 2.

Input parameters for downloading input datasets

Section set_dataDownlCoast_urlName

This section of the JSON file contains the parameters needed to make up the URL that is required to access the input coastline datasets from a local or remote ropository.

urlCoast_usr

Username to access the coastline datasets from a remote ftp server.

Type: string Ref.Value: usr

urlCoast_pwd

Password to access the coastline datasets from a remote ftp server.

Type: string Ref.Value: pwd

urlCoast_urlbase

Parametric urlname (i.e. ftp:/... or file:///...) for the coastline datasets. Parameters: (RESCOAST).

Type: string Ref.Value: file:///scratch/surf/surf_datasets/current/coastline/GSHHS_shp/(RESCOAST)

urlCoast_resol

Name for spatial resolution used to replace the substring (RESCOAST) on the parametric urlname (if =NOTUSED, parameter not read).

Type: string Ref.Value: h Range: f, h, i, l, c

Section set_dataDownlCoast_fileName

This section of the JSON file contains the parameters for the FILENAMEs of the input coastline datasets.

fileCoast_lland

Enables the use of the land coastline.

Type: bool Ref.Value: True

fileCoast_filebaseLand

Files name for NOAA coastline datasets contains boundary between land and ocean (if fileCoast_lland=True). Parameters: (RESCOAST).

Type: string Ref.Value: GSHHS_(RESCOAST)_L1.shp

fileCoast_llake

Enables the use of the lake coastline.

Type: bool Ref.Value: False

fileCoast_filebaseLake

Files name for NOAA coastline datasets contains boundary between lake and land (if fileCoast_llake=True). Parameters: (RESCOAST).

Type: string Ref.Value: GSHHS_(RESCOAST)_L2.shp

fileCoast_lislandlake

Enables the use of the islelake coastline.

Type: bool Ref.Value: False

fileCoast_filebaseIslandlake

Files name for NOAA coastline datasets contains boundary between island-in-lake and lake (if fileCoast_lislandlake=True). Parameters: (RESCOAST).

Type: string Ref.Value: GSHHS_(RESCOAST)_L3.shp

fileCoast_resol

Name for spatial resolution used to replace the substring (RESCOAST) on the parametric file name (if =NOTUSED, parameter not read).

Type: string Ref.Value: h

fileCoast_lcompression

(=True) if datasets you want to download are gzip compressed files (*.gz).

Type: bool Ref.Value: False

fileCoast_lkeepSrcFull

(=True) if you want to keep in your disk the downloaded uncutted datasets.

Type: bool Ref.Value: True

Section set_dataDownlBat_urlName

This section of the JSON file contains the parameters needed to make up the URL that is required to access the input bathymetry datasets from a local or remote ropository.

urlBat_usr

Username to access the bathymetric datasets from a remote ftp server.

Type: string Ref.Value: usr

urlBat_pwd

Password to access the bathymetric datasets from a remote ftp server.

Type: string Ref.Value: pwd

urlBat_urlbase

Parametric urlname (i.e. ftp:/... or file:///...) for the bathymetric datasets. Parameters: (RESOL).

Type: string Ref.Value: usr

urlBat_resol

Name for spatial resolution used to replace the substring (RESOL) on the parametric urlname (if =NOTUSED, parameter not read).

Type: string Ref.Value: h

Section set_dataDownlBat_fileName

This section of the JSON file contains the parameters for the FILENAME of the input bathymetry datasets.

fileBat_filebase

Parametric filename for the source bathymetric datasets. Parameters: (RESBAT).

Type: string Ref.Value: macroMED_bathyGEBCO.nc

fileBat_resol

Name for spatial resolution used to replace the substring (RESBAT) on the parametric file name (if =NOTUSED, parameter not read).

Type: string Ref.Value: NOTUSED

fileBat_lcompression

(=True) if datasets you want to download are gzip compressed files (*.gz).

Type: bool Ref.Value: False

fileBat_llonFlip

(=True) if longitude coord. is in the 0 to 360 range and (=False) if longitude is in -180:+180 range.

Type: string Ref.Value: macroMED_bathyGEBCO.nc

fileBat_llatInv

(=True) if the dataset contains latitude decreasing through the pole.

Type: bool Ref.Value: False

fileBat_ldepthIncr

(=True) if the dataset contains sea floor elevation (positive) increases with increasing water depth.

Type: bool Ref.Value: False

fileBat_lkeepSrcFull

(=True) if you want to keep in your disk the downloaded uncutted datasets.

Type: bool Ref.Value: False

Section set_dataDownlBat_varName

This section of the JSON file contains the parameters for the VARIABLE-NAMEs of the input bathymetry datasets.

srcDimBat_lon

Name of the dimension for the longitude.

Type: string Ref.Value: lon

srcDimBat_lat

Name of the dimension for the latitude.

Type: string Ref.Value: lat

srcCrdBat_lon

Name of the coordinate variable for the longitude.

Type: string Ref.Value: lon

srcCrdBat_lat

Name of the coordinate variable for the latitude.

Type: string Ref.Value: lat

srcVarBat_elev

Name of the variable for the Sea Floor Elevation.

Type: string Ref.Value: elevation

Section set_dataDownlAtmMesh_urlName

This section of the JSON file contains the parameters needed to make up the URL that is required to access the input atmospheric meshmask datasets from a local or remote ropository.

urlAtmMesh_usr

Username to access the input atmospheric meshmask datasets from a remote ftp server.

Type: string Ref.Value: usr

urlAtmMesh_pwd

Password to access the input atmospheric meshmask datasets from a remote ftp server.

Type: string Ref.Value: pwd

urlAtmMesh_urlbase

Parametric urlname (i.e. ftp:/... or file:///...) for input atmospheric meshmask datasets. Parameters: (FIELD),YYYY(p)MM(p)DD(p).

Type: string Ref.Value: file:///scratch/surf/indata_offline/gulfTaranto_20141005/data/data00/indata/atmosphere/srcFull

urlAtmMesh_velU

Name for the Zonal Air Velocity used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: v10m

urlAtmMesh_velV

Name for the Meridional Air Velocity used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: v10m

urlAtmMesh_mslp

Name for the Mean Sea-Level Pressure used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: mslp

urlAtmMesh_cloudCov

Name for the Total Cloud Cover used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: tcc

urlAtmMesh_temp

Name for the Air Temperature used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: t2m

urlAtmMesh_dpTemp

"Name for the Dewpoint Temperature used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: d2m

urlAtmMesh_prec

Name for the Total Precipitation used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: precip

urlAtmMesh_tauU

Name for the Zonal Wind Stress used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: tauU

urlAtmMesh_tauV

Name for the Meridional Wind Stress used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: tauV

urlAtmMesh_qtot

Name for the Total Heat Flux used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: qtot

urlAtmMesh_qsr

Name for the Solar Radiation Penetration used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: qsr

urlAtmMesh_emp

Name for the Mass Flux Exchanged used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: emp

urlAtmMesh_tempS

Name for the Surface Temperature used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: sst

urlAtmMesh_salS

Name for the Surface Salinity used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: sss

urlAtmMesh_umid

Name for the Air Umidity used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: umid

urlAtmMesh_radLW

Name for the Long Wave Radiation used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: lwrd

urlAtmMesh_radSW

Name for the Short Wave Radiation used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: swrd

urlAtmMesh_snow

Name for the Solid Precipitation used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: snow

Section set_dataDownlAtmMesh_fileName

This section of the JSON file contains the parameters needed to make up the FILENAMEs of the input atmospheric meshmask datasets.

fileAtmMesh_filebase_velU

Parametric filename for the Zonal Air Velocity datasets before the spinup-time (if sbc_iformulat=0,2). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: YYYY(i)MM(i)DD(i)-ECMWF---AM0125-MEDATL-bYYYY(i+1)MM(i+1)DD(i+1)_an-fv05.00.nc

fileAtmMesh_filebase_velV

Parametric filename for the Meridional Air Velocity datasets before the spinup-time (if sbc_iformulat=0,2). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: YYYY(i)MM(i)DD(i)-ECMWF---AM0125-MEDATL-bYYYY(i+1)MM(i+1)DD(i+1)_an-fv05.00.nc

fileAtmMesh_filebase_mslp

Parametric filename for the Mean Sea-Level Pressure datasets before the spinup-time (if sbc_iformulat=0 or/and sbc_aprdyn). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: YYYY(i)MM(i)DD(i)-ECMWF---AM0125-MEDATL-bYYYY(i+1)MM(i+1)DD(i+1)_an-fv05.00.nc

fileAtmMesh_filebase_cloudCov

Parametric filename for the Total Cloud Cover datasets before the spinup-time (if sbc_iformulat=0). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: YYYY(i)MM(i)DD(i)-ECMWF---AM0125-MEDATL-bYYYY(i+1)MM(i+1)DD(i+1)_an-fv05.00.nc

fileAtmMesh_filebase_temp

Parametric filename for the Air Temperature datasets before the spinup-time (if sbc_iformulat=0,2). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: YYYY(i)MM(i)DD(i)-ECMWF---AM0125-MEDATL-bYYYY(i+1)MM(i+1)DD(i+1)_an-fv05.00.nc

fileAtmMesh_filebase_dpTemp

Parametric filename for the Dewpoint Temperature datasets before the spinup-time (if sbc_iformulat=0). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: YYYY(i)MM(i)DD(i)-ECMWF---AM0125-MEDATL-bYYYY(i+1)MM(i+1)DD(i+1)_an-fv05.00.nc

fileAtmMesh_filebase_prec

Parametric filename for the Total Precipitation datasets before the spinup-time (if sbc_iformulat=0,2). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: YYYY(i)MM(i)DD(i)_YYYY(i+1)MM(i+1)DD(i+1)-ECMWF---AM025-MEDATL-bYYYY(i)MM(i)DD(i)_fc00-fv02.00_PREC.nc

fileAtmMesh_filebase_tauU

Parametric filename for the Zonal Wind Stress datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: NOTUSED

fileAtmMesh_filebase_tauV

Parametric filename for the Meridional Wind Stress datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: usr

fileAtmMesh_filebase_qtot

Parametric filename for the Total Heat Flux datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: usr

fileAtmMesh_filebase_qsr

Parametric filename for the Solar Radiation Penetration datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: usr

fileAtmMesh_filebase_emp

Parametric filename for the Mass Flux Exchanged datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: usr

fileAtmMesh_filebase_tempS

Parametric filename for the Surface Temperature datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: usr

fileAtmMesh_filebase_salS

Parametric filename for the Surface Salinity datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: usr

fileAtmMesh_filebase_umid

Parametric filename for the Air Umidity datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: usr

fileAtmMesh_filebase_radLW

Parametric filename for the Long Wave Radiation datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: usr

fileAtmMesh_filebase_radSW

Parametric filename for the Short Wave Radiation datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: usr

fileAtmMesh_filebase_snow

Parametric filename for the Solid Precipitation datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: usr

fileAtmMesh_lcompression

(=True) if the datasets you want to download are gzip compressed files (*.gz).

Type: bool Ref.Value: False

fileAtmMesh_llonFlip

(=True) if the longitude coord. is in the 0 to 360 range (=False) if longitude is in -180:+180 range.

Type: bool Ref.Value: False

fileAtmMesh_llatInv

(=True) if the dataset contains latitude decreasing through the pole.

Type: bool Ref.Value: True

fileAtmMesh_lkeepSrcFull

(=True) if you want to keep in your disk the downloaded uncutted datasets.

Type: bool Ref.Value: True

Section set_dataDownlAtmMesh_varName

This section of the JSON file contains the parameters for the VARIABLE-NAMEs of the input atmospheric meshmask datasets.

srcDimAtmMesh_lon

Name of the dimension for the longitude.

Type: string Ref.Value: lon

srcDimAtmMesh_lat

Name of the dimension for the latitude.

Type: string Ref.Value: lat

srcDimAtmMesh_time

Name of the dimension for the time.

Type: string Ref.Value: time

srcCrdAtmMesh_lon

Name of the coordinate variable containing the longitude.

Type: string Ref.Value: lon

srcCrdAtmMesh_lat

Name of the coordinate variable containing the latitude.

Type: string Ref.Value: lat

srcCrdAtmMesh_time

Name of the variable containing time coordinate.

Type: string Ref.Value: time

srcVarAtmMesh_mask

Name of the variable containing the Land Sea Mask (if sbc_iformulat=0,2).

Type: string Ref.Value: LSM

srcVarAtmMesh_lont

Name of the variable containing longitude coordinate of T-points (if sbc_iformulat=1).

Type: string Ref.Value: NOTUSED

srcVarAtmMesh_lonu

Name of the variable containing longitude coordinate of U-points (if sbc_iformulat=1).

Type: string Ref.Value: NOTUSED

srcVarAtmMesh_lonv

Name of the variable containing longitude coordinate of V-points (if sbc_iformulat=1).

Type: string Ref.Value: NOTUSED

srcVarAtmMesh_latt

Name of the variable containing latitude coordinate of T-points (if sbc_iformulat=1).

Type: string Ref.Value: NOTUSED

srcVarAtmMesh_latu

Name of the variable containing latitude coordinate of U-points (if sbc_iformulat=1).

Type: string Ref.Value: NOTUSED

srcVarAtmMesh_latv

Name of the variable containing latitude coordinate of V-points (if sbc_iformulat=1).

Type: string Ref.Value: NOTUSED

srcVarAtmMesh_maskt

Name of the variable containing the Land Sea Mask of T-points (if sbc_iformulat=1).

Type: string Ref.Value: NOTUSED

srcVarAtmMesh_masku

Name of the variable containing the Land Sea Mask of U-points (if sbc_iformulat=1).

Type: string Ref.Value: NOTUSED

srcVarAtmMesh_maskv

Name of the variable containing the Land Sea Mask of V-points (if sbc_iformulat=1).

Type: string Ref.Value: NOTUSED

Section set_dataDownlAtm_urlName_preSpinup

This section of the JSON file contains the parameters needed to make up the URL that is required to access the input atmospheric datasets of the pre-Spinup period from a local or remote ropository.

urlAtmPre_usr

Username to access the input atmospheric datasets before the spinup-time from a remote ftp server.

Type: string Ref.Value: usr

urlAtmPre_pwd

Password to access the input atmospheric datasets before the spinup-time from a remote ftp server.

Type: string Ref.Value: pwd

urlAtmPre_urlbase

Parametric urlname (i.e. ftp:/... or file:///...) for atmospheric datasets before the spinup-time. Parameters: (FIELD),YYYY(p)MM(p)DD(p).

Type: string Ref.Value: file:///scratch/surf/indata_offline/gulfTaranto_20141005/data/data00/indata/atmosphere/srcFull

urlAtmPre_velU

Name for the Zonal Air Velocity used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: v10m

urlAtmPre_velV

Name for the Meridional Air Velocity used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: v10m

urlAtmPre_mslp

Name for the Mean Sea-Level Pressure used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: mslp

urlAtmPre_cloudCov

Name for the Total Cloud Cover used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: tcc

urlAtmPre_temp

Name for the Air Temperature used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: t2m

urlAtmPre_dpTemp

Name for the Dewpoint Temperature used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: d2m

urlAtmPre_prec

Name for the Total Precipitation used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: precip

urlAtmPre_tauU

Name for the Zonal Wind Stress used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: tauU

urlAtmPre_tauV

Name for the Meridional Wind Stress used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: tauV

urlAtmPre_qtot

Name for the Total Heat Flux used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: qtot

urlAtmPre_qsr

Name for the Solar Radiation Penetration used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: qsr

urlAtmPre_emp

Name for the Mass Flux Exchanged used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: emp

urlAtmPre_tempS

Name for the Surface Temperature used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: sst

urlAtmPre_salS

Name for the Surface Salinity used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: sss

urlAtmPre_umid

Name for the Air Umidity used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: umid

urlAtmPre_radLW

Name for the Long Wave Radiation used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: lwrd

urlAtmPre_radSW

Name for the Short Wave Radiation used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: swrd

urlAtmPre_snow

Name for the Solid Precipitation used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: snow

Section set_dataDownlAtm_fileName_preSpinup

This section of the JSON file contains the parameters needed to make up the FILENAMEs of the input atmospheric datasets of the pre-Spinup period.

fileAtmPre_lcompression

(=True) if the datasets you want to download are gzip compressed files (*.gz).

Type: bool Ref.Value: True

fileAtmPre_iProdDate

Type of production (bulletin) date (=1):fixProdDate, (=2):varProdDate-DayofWeek.

Type: int Ref.Value: 1

fileAtmPre_dateProdFixed

Production date used in the URL/files (if iProdDate=1).

Type: string Ref.Value: 20170801

fileAtmPre_dateProdDayofWeek

Production date used in the URL/files (if iProdDate=2).

Type: string Ref.Value: Wednesday

fileAtmPre_filebase_velU

Parametric filename for the Zonal Air Velocity datasets before the spinup-time (if sbc_iformulat=0,2). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: YYYY(i)MM(i)DD(i)-ECMWF---AM0125-MEDATL-bYYYY(i+1)MM(i+1)DD(i+1)_an-fv05.00.nc

fileAtmPre_filebase_velV

Type: string Ref.Value: YYYY(i)MM(i)DD(i)-ECMWF---AM0125-MEDATL-bYYYY(i+1)MM(i+1)DD(i+1)_an-fv05.00.nc

fileAtmPre_filebase_mslp

Type: string Ref.Value: YYYY(i)MM(i)DD(i)-ECMWF---AM0125-MEDATL-bYYYY(i+1)MM(i+1)DD(i+1)_an-fv05.00.nc

fileAtmPre_filebase_cloudCov

Parametric filename for the Total Cloud Cover datasets before the spinup-time (if sbc_iformulat=0). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: YYYY(i)MM(i)DD(i)-ECMWF---AM0125-MEDATL-bYYYY(i+1)MM(i+1)DD(i+1)_an-fv05.00.nc

fileAtmPre_filebase_temp

Parametric filename for the Air Temperature datasets before the spinup-time (if sbc_iformulat=0,2). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: YYYY(i)MM(i)DD(i)-ECMWF---AM0125-MEDATL-bYYYY(i+1)MM(i+1)DD(i+1)_an-fv05.00.nc

fileAtmPre_filebase_dpTemp

Parametric filename for the Dewpoint Temperature datasets before the spinup-time (if sbc_iformulat=0). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: YYYY(i)MM(i)DD(i)-ECMWF---AM0125-MEDATL-bYYYY(i+1)MM(i+1)DD(i+1)_an-fv05.00.nc

fileAtmPre_filebase_tauU

Parametric filename for the Zonal Wind Stress datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: YYYY(i)MM(i)DD(i)_YYYY(i+1)MM(i+1)DD(i+1)-ECMWF---AM025-MEDATL-bYYYY(i)MM(i)DD(i)_fc00-fv02.00_PREC.nc

fileAtmPre_filebase_tauV

Type: string Ref.Value: NOTUSED

fileAtmPre_filebase_qtot

Parametric filename for the Total Heat Flux datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: NOTUSED

fileAtmPre_filebase_qsr

Type: string Ref.Value: NOTUSED

fileAtmPre_filebase_emp

Parametric filename for the Mass Flux Exchanged datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: NOTUSED

fileAtmPre_filebase_tempS

Parametric filename for the Surface Temperature datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: NOTUSED

fileAtmPre_filebase_salS

Parametric filename for the Surface Salinity datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: NOTUSED

fileAtmPre_filebase_umid

Parametric filename for the Air Umidity datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: NOTUSED

fileAtmPre_filebase_radLW

Parametric filename for the Long Wave Radiation datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: NOTUSED

fileAtmPre_filebase_radSW

Parametric filename for the Short Wave Radiation datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: NOTUSED

fileAtmPre_filebase_snow

Parametric filename for the Solid Precipitation datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: NOTUSED

Section set_dataDownlAtm_varName_preSpinup

This section of the JSON file contains the parameters for the VARIABLE-NAMEs of the input atmospheric datasets of the pre-Spinup period.

srcDimAtmPre_lon

Name of the dimension for the longitude (if sbc_iformulat=0,2).

Type: string Ref.Value: lon

srcDimAtmPre_lont

Name of the dimension for the longitude of T-points (if sbc_iformulat=1).

Type: string Ref.Value: lont

srcDimAtmPre_lonu

Name of the dimension for the longitude of U-points (if sbc_iformulat=1).

Type: string Ref.Value: lonu

srcDimAtmPre_lonv

Name of the dimension for the longitude of V-points (if sbc_iformulat=1).

Type: string Ref.Value: lonv

srcDimAtmPre_lat

Name of the dimension for the latitude (if sbc_iformulat=0,2).

Type: string Ref.Value: lat

srcDimAtmPre_latt

Name of the dimension for the latitude of T-points (if sbc_iformulat=1).

Type: string Ref.Value: latt

srcDimAtmPre_latu

Name of the dimension for the latitude of U-points (if sbc_iformulat=1).

Type: string Ref.Value: latu

srcDimAtmPre_latv

Name of the dimension for the latitude of V-points (if sbc_iformulat=1).

Type: string Ref.Value: latv

srcDimAtmPre_time

Name of the dimension for the time.

Type: string Ref.Value: time

srcCrdAtmPre_lon

Name of the coordinate variable containing the longitude (if sbc_iformulat=0,2).

Type: string Ref.Value: lon

srcCrdAtmPre_lont

Name of the coordinate variable containing the longitude of T-points (if sbc_iformulat=1).

Type: string Ref.Value: NOTUSED

srcCrdAtmPre_lonu

Name of the coordinate variable containing the longitude of U-points (if sbc_iformulat=1).

Type: string Ref.Value: NOTUSED

srcCrdAtmPre_lonv

Name of the coordinate variable containing the longitude of V-points (if sbc_iformulat=1).

Type: string Ref.Value: NOTUSED

srcCrdAtmPre_lat

Name of the coordinate variable containing the latitude (if sbc_iformulat=0,2).

Type: string Ref.Value: lat

srcCrdAtmPre_latt

Name of the coordinate variable containing the latitude of T-points (if sbc_iformulat=1).

Type: string Ref.Value: NOTUSED

srcCrdAtmPre_latu

Name of the coordinate variable containing the latitude of U-points (if sbc_iformulat=1).

Type: string Ref.Value: NOTUSED

srcCrdAtmPre_latv

Name of the coordinate variable containing the latitude of V-points (if sbc_iformulat=1).

Type: string Ref.Value: NOTUSED

srcCrdAtmPre_time

Name of the variable containing time coordinate.

Type: string Ref.Value: time

srcVarAtmPre_velU

Name of the variable for 10 metre zonal component of air velocity (if sbc_iformulat=0,2).

Type: string Ref.Value: U10M

srcVarAtmPre_velV

Name of the variable for 10 metre meridional componente of air velocity (if sbc_iformulat=0,2).

Type: string Ref.Value: V10M

srcVarAtmPre_mslp

Name of the variable for Mean Sea-Level Pressure (if sbc_iformulat=0 or/and sbc_aprdyn).

Type: string Ref.Value: MSL

srcVarAtmPre_cloudCov

Name of the variable for Total Cloud Cover (if sbc_iformulat=0).

Type: string Ref.Value: TCC

srcVarAtmPre_temp

Name of the variable for 2 metre temperature (if sbc_iformulat=0,2).

Type: string Ref.Value: T2M

srcVarAtmPre_dpTemp

Name of the variable for 2 metre Dewpoint Temperature (if sbc_iformulat=0).

Type: string Ref.Value: D2M

srcVarAtmPre_prec

Name of the variable for Total Precipitation (if sbc_iformulat=0,2).

Type: string Ref.Value: PREC

srcVarAtmPre_tauU

Name of the variable for tauU (if sbc_iformulat=1).

Type: string Ref.Value: tauU

srcVarAtmPre_tauV

Name of the variable for tauV (if sbc_iformulat=1).

Type: string Ref.Value: tauV

srcVarAtmPre_qtot

Name of the variable for qtot (if sbc_iformulat=1).

Type: string Ref.Value: NOTUSED

srcVarAtmPre_qsr

Name of the variable for qsr (if sbc_iformulat=1).

Type: string Ref.Value: NOTUSED

srcVarAtmPre_emp

Name of the variable for emp (if sbc_iformulat=1).

Type: string Ref.Value: NOTUSED

srcVarAtmPre_tempS

Name of the variable for tempS (if sbc_iformulat=1).

Type: string Ref.Value: NOTUSED

srcVarAtmPre_salS

Name of the variable for salS (if sbc_iformulat=1).

Type: string Ref.Value: NOTUSED

srcVarAtmPre_umid

Name of the variable for 2 metre umidity (if sbc_iformulat=2).

Type: string Ref.Value: NOTUSED

srcVarAtmPre_radLW

Name of the variable for Long Wave Radiation (if sbc_iformulat=2).

Type: string Ref.Value: NOTUSED

srcVarAtmPre_radSW

Name of the variable for Short Wave Radiation (if sbc_iformulat=2).

Type: string Ref.Value: NOTUSED

srcVarAtmPre_snow

Name of the variable for Solid Precipitation (if sbc_iformulat=2).

Type: string Ref.Value: NOTUSED

Section set_dataDownlAtm_urlName_postSpinup

This section of the JSON file contains the parameters needed to make up the URL that is required to access the input atmospheric datasets of the post-Spinup period from a local or remote ropository.

urlAtmPost_usr

Username to access the input atmospheric datasets before the spinup-time from a remote ftp server.

Type: string Ref.Value: usr

urlAtmPost_pwd

Password to access the input atmospheric datasets before the spinup-time from a remote ftp server.

Type: string Ref.Value: pwd

urlAtmPost_urlbase

Parametric urlname (i.e. ftp:/... or file:///...) for atmospheric datasets before the spinup-time. Parameters: (FIELD),YYYY(p)MM(p)DD(p).

Type: string Ref.Value: file:///scratch/surf/indata_offline/gulfTaranto_20141005/data/data00/indata/atmosphere/srcFull

urlAtmPost_velU

Name for the Zonal Air Velocity used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: v10m

urlAtmPost_velV

Name for the Meridional Air Velocity used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: v10m

urlAtmPost_mslp

Name for the Mean Sea-Level Pressure used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: mslp

urlAtmPost_cloudCov

Name for the Total Cloud Cover used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: tcc

urlAtmPost_temp

Name for the Air Temperature used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: t2m

urlAtmPost_dpTemp

Name for the Dewpoint Temperature used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: d2m

urlAtmPost_prec

Name for the Total Precipitation used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: precip

urlAtmPost_tauU

Name for the Zonal Wind Stress used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: tauU

urlAtmPost_tauV

Name for the Meridional Wind Stress used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: tauV

urlAtmPost_qtot

Name for the Total Heat Flux used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: qtot

urlAtmPost_qsr

Name for the Solar Radiation Penetration used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: qsr

urlAtmPost_emp

Name for the Mass Flux Exchanged used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: emp

urlAtmPost_tempS

Name for the Surface Temperature used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: sst

urlAtmPost_salS

Name for the Surface Salinity used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: sss

urlAtmPost_umid

Name for the Air Umidity used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: umid

urlAtmPost_radLW

Name for the Long Wave Radiation used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: lwrd

urlAtmPost_radSW

Name for the Short Wave Radiation used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: swrd

urlAtmPost_snow

Name for the Solid Precipitation used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: snow

Section set_dataDownlAtm_fileName_postSpinup

This section of the JSON file contains the parameters needed to make up the FILENAMEs of the input atmospheric datasets of the post-Spinup period.

fileAtmPost_lcompression

(=True) if the datasets you want to download are gzip compressed files (*.gz).

Type: bool Ref.Value: True

fileAtmPost_iProdDate

Type of production (bulletin) date (=1):fixProdDate, (=2):varProdDate-DayofWeek.

Type: int Ref.Value: 1

fileAtmPost_dateProdFixed

Production date used in the URL/files (if iProdDate=1).

Type: string Ref.Value: 20170801

fileAtmPost_dateProdDayofWeek

Production date used in the URL/files (if iProdDate=2).

Type: string Ref.Value: Wednesday

fileAtmPost_filebase_velU

Parametric filename for the Zonal Air Velocity datasets before the spinup-time (if sbc_iformulat=0,2). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: YYYY(i)MM(i)DD(i)-ECMWF---AM0125-MEDATL-bYYYY(i+1)MM(i+1)DD(i+1)_an-fv05.00.nc

fileAtmPost_filebase_velV

Type: string Ref.Value: YYYY(i)MM(i)DD(i)-ECMWF---AM0125-MEDATL-bYYYY(i+1)MM(i+1)DD(i+1)_an-fv05.00.nc

fileAtmPost_filebase_mslp

Type: string Ref.Value: YYYY(i)MM(i)DD(i)-ECMWF---AM0125-MEDATL-bYYYY(i+1)MM(i+1)DD(i+1)_an-fv05.00.nc

fileAtmPost_filebase_cloudCov

Parametric filename for the Total Cloud Cover datasets before the spinup-time (if sbc_iformulat=0). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: YYYY(i)MM(i)DD(i)-ECMWF---AM0125-MEDATL-bYYYY(i+1)MM(i+1)DD(i+1)_an-fv05.00.nc

fileAtmPost_filebase_temp

Parametric filename for the Air Temperature datasets before the spinup-time (if sbc_iformulat=0,2). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: YYYY(i)MM(i)DD(i)-ECMWF---AM0125-MEDATL-bYYYY(i+1)MM(i+1)DD(i+1)_an-fv05.00.nc

fileAtmPost_filebase_dpTemp

Parametric filename for the Dewpoint Temperature datasets before the spinup-time (if sbc_iformulat=0). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: YYYY(i)MM(i)DD(i)-ECMWF---AM0125-MEDATL-bYYYY(i+1)MM(i+1)DD(i+1)_an-fv05.00.nc

fileAtmPost_filebase_tauU

Parametric filename for the Zonal Wind Stress datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: YYYY(i)MM(i)DD(i)_YYYY(i+1)MM(i+1)DD(i+1)-ECMWF---AM025-MEDATL-bYYYY(i)MM(i)DD(i)_fc00-fv02.00_PREC.nc

fileAtmPost_filebase_tauV

Type: string Ref.Value: NOTUSED

fileAtmPost_filebase_qtot

Parametric filename for the Total Heat Flux datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: NOTUSED

fileAtmPost_filebase_qsr

Type: string Ref.Value: NOTUSED

fileAtmPost_filebase_emp

Parametric filename for the Mass Flux Exchanged datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: NOTUSED

fileAtmPost_filebase_tempS

Parametric filename for the Surface Temperature datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: NOTUSED

fileAtmPost_filebase_salS

Parametric filename for the Surface Salinity datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: NOTUSED

fileAtmPost_filebase_umid

Parametric filename for the Air Umidity datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: NOTUSED

fileAtmPost_filebase_radLW

Parametric filename for the Long Wave Radiation datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: NOTUSED

fileAtmPost_filebase_radSW

Parametric filename for the Short Wave Radiation datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: NOTUSED

fileAtmPost_filebase_snow

Parametric filename for the Solid Precipitation datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: NOTUSED

Section set_dataDownlAtm_varName_postSpinup

This section of the JSON file contains the parameters for the VARIABLE-NAMEs of the input atmospheric datasets of the post-Spinup period.

srcDimAtmPost_lon

Name of the dimension for the longitude (if sbc_iformulat=0,2).

Type: string Ref.Value: lon

srcDimAtmPost_lont

Name of the dimension for the longitude of T-points (if sbc_iformulat=1).

Type: string Ref.Value: lont

srcDimAtmPost_lonu

Name of the dimension for the longitude of U-points (if sbc_iformulat=1).

Type: string Ref.Value: lonu

srcDimAtmPost_lonv

Name of the dimension for the longitude of V-points (if sbc_iformulat=1).

Type: string Ref.Value: lonv

srcDimAtmPost_lat

Name of the dimension for the latitude (if sbc_iformulat=0,2).

Type: string Ref.Value: lat

srcDimAtmPost_latt

Name of the dimension for the latitude of T-points (if sbc_iformulat=1).

Type: string Ref.Value: latt

srcDimAtmPost_latu

Name of the dimension for the latitude of U-points (if sbc_iformulat=1).

Type: string Ref.Value: latu

srcDimAtmPost_latv

Name of the dimension for the latitude of V-points (if sbc_iformulat=1).

Type: string Ref.Value: latv

srcDimAtmPost_time

Name of the dimension for the time.

Type: string Ref.Value: time

srcCrdAtmPost_lon

Name of the coordinate variable containing the longitude (if sbc_iformulat=0,2).

Type: string Ref.Value: lon

srcCrdAtmPost_lont

Name of the coordinate variable containing the longitude of T-points (if sbc_iformulat=1).

Type: string Ref.Value: NOTUSED

srcCrdAtmPost_lonu

Name of the coordinate variable containing the longitude of U-points (if sbc_iformulat=1).

Type: string Ref.Value: NOTUSED

srcCrdAtmPost_lonv

Name of the coordinate variable containing the longitude of V-points (if sbc_iformulat=1).

Type: string Ref.Value: NOTUSED

srcCrdAtmPost_lat

Name of the coordinate variable containing the latitude (if sbc_iformulat=0,2).

Type: string Ref.Value: lat

srcCrdAtmPost_latt

Name of the coordinate variable containing the latitude of T-points (if sbc_iformulat=1).

Type: string Ref.Value: NOTUSED

srcCrdAtmPost_latu

Name of the coordinate variable containing the latitude of U-points (if sbc_iformulat=1).

Type: string Ref.Value: NOTUSED

srcCrdAtmPost_latv

Name of the coordinate variable containing the latitude of V-points (if sbc_iformulat=1).

Type: string Ref.Value: NOTUSED

srcCrdAtmPost_time

Name of the variable containing time coordinate.

Type: string Ref.Value: time

srcVarAtmPost_velU

Name of the variable for 10 metre zonal component of air velocity (if sbc_iformulat=0,2).

Type: string Ref.Value: U10M

srcVarAtmPost_velV

Name of the variable for 10 metre meridional componente of air velocity (if sbc_iformulat=0,2).

Type: string Ref.Value: V10M

srcVarAtmPost_mslp

Name of the variable for Mean Sea-Level Pressure (if sbc_iformulat=0 or/and sbc_aprdyn).

Type: string Ref.Value: MSL

srcVarAtmPost_cloudCov

Name of the variable for Total Cloud Cover (if sbc_iformulat=0).

Type: string Ref.Value: TCC

srcVarAtmPost_temp

Name of the variable for 2 metre temperature (if sbc_iformulat=0,2).

Type: string Ref.Value: T2M

srcVarAtmPost_dpTemp

Name of the variable for 2 metre Dewpoint Temperature (if sbc_iformulat=0).

Type: string Ref.Value: D2M

srcVarAtmPost_prec

Name of the variable for Total Precipitation (if sbc_iformulat=0,2).

Type: string Ref.Value: PREC

srcVarAtmPost_tauU

Name of the variable for tauU (if sbc_iformulat=1).

Type: string Ref.Value: tauU

srcVarAtmPost_tauV

Name of the variable for tauV (if sbc_iformulat=1).

Type: string Ref.Value: tauV

srcVarAtmPost_qtot

Name of the variable for qtot (if sbc_iformulat=1).

Type: string Ref.Value: NOTUSED

srcVarAtmPost_qsr

Name of the variable for qsr (if sbc_iformulat=1).

Type: string Ref.Value: NOTUSED

srcVarAtmPost_emp

Name of the variable for emp (if sbc_iformulat=1).

Type: string Ref.Value: NOTUSED

srcVarAtmPost_tempS

Name of the variable for tempS (if sbc_iformulat=1).

Type: string Ref.Value: NOTUSED

srcVarAtmPost_salS

Name of the variable for salS (if sbc_iformulat=1).

Type: string Ref.Value: NOTUSED

srcVarAtmPost_umid

Name of the variable for 2 metre umidity (if sbc_iformulat=2).

Type: string Ref.Value: NOTUSED

srcVarAtmPost_radLW

Name of the variable for Long Wave Radiation (if sbc_iformulat=2).

Type: string Ref.Value: NOTUSED

srcVarAtmPost_radSW

Name of the variable for Short Wave Radiation (if sbc_iformulat=2).

Type: string Ref.Value: NOTUSED

srcVarAtmPost_snow

Name of the variable for Solid Precipitation (if sbc_iformulat=2).

Type: string Ref.Value: NOTUSED

Section set_dataDownlOceICMesh_urlName

This section of the JSON file contains the free input parameters needed to make up the URL that is required to access the input ocean IC meshmask datasets from a local or remote ropository.

urlOceICMesh_usr

Username to access the input ocean IC meshmask datasets from a remote ftp server.

Type: string Ref.Value: usr

urlOceICMesh_pwd

Password to access the input ocean IC meshmask datasets from a remote ftp server.

Type: string Ref.Value: pwd

urlOceICMesh_urlbase

Parametric urlname (i.e. ftp:/... or file:///...) for the input ocean IC meshmask datasets. Parameters: (FIELD).

Type: string Ref.Value: file:///scratch/surf/indata_offline/gulfTaranto_20141005/data/data00/indata/ocean/oceanIC/srcFull

urlOceICMesh_lont

Name for the longitude-Tgrid used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceICMesh_lonu

Name for the longitude-Ugrid used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceICMesh_lonv

Name for the longitude-Vgrid used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceICMesh_lonf

Name for the longitude-Fgrid used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceICMesh_latt

Name for the latitude-Tgrid used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceICMesh_latu

Name for the latitude-Ugrid used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceICMesh_latv

Name for the latitude-Vgrid used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceICMesh_latf

Name for the latitude-Fgrid used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceICMesh_deptht1d

Name for the depth-Tgrid used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceICMesh_depthw1d

Name for the depth-Wgrid used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceICMesh_xscalfctt

Name for the scaleFactor-Tgrid x-direction used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceICMesh_xscalfctu

Name for the scaleFactor-Ugrid x-direction used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceICMesh_xscalfctv

Name for the scaleFactor-Vgrid x-direction used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceICMesh_xscalfctf

Name for the scaleFactor-Fgrid x-direction used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceICMesh_yscalfctt

Name for the scaleFactor-Tgrid y-direction used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceICMesh_yscalfctu

Name for the scaleFactor-Ugrid y-direction used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceICMesh_yscalfctv

Name for the scaleFactor-Vgrid y-direction used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceICMesh_yscalfctf

Name for the scaleFactor-Fgrid y-direction used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceICMesh_zscalfctt1d

Name for the scaleFactor-Tgrid z-direction used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceICMesh_zscalfctw1d

Name for the scaleFactor-Wgrid z-direction used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceICMesh_maskt

Name for the LandSea-mask-Tgrid used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceICMesh_masku

Name for the LandSea-mask-Ugrid used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceICMesh_maskv

Name for the LandSea-mask-Vgrid used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

Section set_dataDownlOceICMesh_fileName

This section of the JSON file contains the free input parameters needed to make up the FILENAMEs of the input ocean IC meshmask datasets.

fileOceICMesh_filebase

Parametric filename for ocean IC meshmask input datasets. Parameters: (FIELD).

Type: string Ref.Value: meshmask_SYS4a3_IONIAN.nc

fileOceICMesh_lont

Name for the longitude-Tgrid used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceICMesh_lonu

Name for the longitude-Tgrid used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceICMesh_lonv

Name for the longitude-Ugrid used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceICMesh_lonf

Name for the longitude-Fgrid used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceICMesh_latt

Name for the latitude-Tgrid used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceICMesh_latu

Name for the latitude-Ugrid used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceICMesh_latv

Name for the latitude-Vgrid used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceICMesh_latf

Name for the latitude-Fgrid used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceICMesh_deptht1d

Name for the depth-Tgrid used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceICMesh_depthw1d

Name for the depth-Wgrid used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceICMesh_xscalfctt

Name for the scaleFactor-Tgrid x-direction used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceICMesh_xscalfctu

Name for the scaleFactor-Ugrid x-direction used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceICMesh_xscalfctv

Name for the scaleFactor-Vgrid x-direction used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceICMesh_xscalfctf

Name for the scaleFactor-Fgrid x-direction used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceICMesh_yscalfctt

Name for the scaleFactor-Tgrid y-direction used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceICMesh_yscalfctu

Name for the scaleFactor-Ugrid y-direction used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceICMesh_yscalfctv

Name for the scaleFactor-Vgrid y-direction used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceICMesh_yscalfctf

Name for the scaleFactor-Fgrid y-direction used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceICMesh_zscalfctt1d

Name for the scaleFactor-Tgrid z-direction used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceICMesh_zscalfctw1d

Name for the scaleFactor-Wgrid z-direction used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceICMesh_maskt

Name for the LandSea-mask-Tgrid used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceICMesh_masku

Name for the LandSea-mask-Ugrid used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceICMesh_maskv

Name for the LandSea-mask-Vgrid used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceICMesh_lcompression

(=True) if the datasets you want to download are gzip compressed files (*.gz).

Type: bool Ref.Value: True

fileOceICMesh_llonFlip

(=True) if the longitude coord. is in the 0 to 360 range (=False) if longitude is in -180:+180 range.

Type: bool Ref.Value: True

fileOceICMesh_lstagC

(=True) if the input fields are defined on a staggered Arakawa C grid (=False) if they are all defined at the T grid.

Type: bool Ref.Value: True

fileOceICMesh_lRegGrid

(=True) the input fields are defined on a REGULAR SPHERICAL GRID, UV-rotation not activate (=False) if they are on a CURVILEAR NO-SPHERICAL GRID, UV-rotation activate.

Type: bool Ref.Value: False

fileOceICMesh_lkeepSrcFull

(=True) if you want to keep in your disk the downloaded uncutted datasets.

Type: bool Ref.Value: True

Section set_dataDownlOceICMesh_varName

This section of the JSON file contains the free input parameters used to define the VARIABLE-NAMEs of the input ocean IC meshmask datasets.

srcDimOceICMesh_lont

Name of the dimension for the longitude of T-points.

Type: string Ref.Value: x

srcDimOceICMesh_lonu

Name of the dimension for the longitude of U-points.

Type: string Ref.Value: x

srcDimOceICMesh_lonv

Name of the dimension for the longitude of V-points.

Type: string Ref.Value: x

srcDimOceICMesh_lonw

Name of the dimension for the longitude of W-points.

Type: string Ref.Value: x

srcDimOceICMesh_latt

Name of the dimension for the latitude of T-points.

Type: string Ref.Value: y

srcDimOceICMesh_latu

Name of the dimension for the latitude of U-points.

Type: string Ref.Value: y

srcDimOceICMesh_latv

Name of the dimension for the latitude of V-points.

Type: string Ref.Value: y

srcDimOceICMesh_latw

Name of the dimension for the latitude of W-points.

Type: string Ref.Value: y

srcDimOceICMesh_deptht

Name of the dimension for the depth of T-points.

Type: string Ref.Value: z

srcDimOceICMesh_depthu

Name of the dimension for the depth of U-points.

Type: string Ref.Value: z

srcDimOceICMesh_depthv

Name of the dimension for the depth of V-points.

Type: string Ref.Value: z

srcDimOceICMesh_depthw

Name of the dimension for the depth of W-points.

Type: string Ref.Value: z

srcDimOceICMesh_time

Name of the dimension for the time.

Type: string Ref.Value: t

srcCrdOceICMesh_lont

Name of the coordinate variable for the longitude of T-points.

Type: string Ref.Value: nav_lon

srcCrdOceICMesh_lonu

Name of the coordinate variable for the longitude of U-points.

Type: string Ref.Value: nav_lon

srcCrdOceICMesh_lonv

Name of the coordinate variable for the longitude of V-points.

Type: string Ref.Value: nav_lon

srcCrdOceICMesh_latt

Name of the coordinate variable for the latitude of T-points.

Type: string Ref.Value: nav_lat

srcCrdOceICMesh_latu

Name of the coordinate variable for the latitude of U-points.

Type: string Ref.Value: nav_lat

srcCrdOceICMesh_latv

Name of the coordinate variable for the latitude of V-points.

Type: string Ref.Value: nav_lat

srcCrdOceICMesh_deptht

Name of the coordinate variable for the depth of T-points.

Type: string Ref.Value: nav_lev

srcCrdOceICMesh_depthw

Name of the coordinate variable for the depth of W-points.

Type: string Ref.Value: nav_lev

srcCrdOceICMesh_time

Name of the coordinate variable for the time.

Type: string Ref.Value: time

srcVarOceICMesh_lont

Name of the variable containing the longitude of T-points.

Type: string Ref.Value: glamt

srcVarOceICMesh_lonu

Name of the variable containing the longitude of U-points.

Type: string Ref.Value: glamu

srcVarOceICMesh_lonv

Name of the variable containing the longitude of V-points.

Type: string Ref.Value: glamv

srcVarOceICMesh_lonf

Name of the variable containing the longitude of F-points.

Type: string Ref.Value: glamf

srcVarOceICMesh_latt

Name of the variable containing the latitude of T-points.

Type: string Ref.Value: gphit

srcVarOceICMesh_latu

Name of the variable containing the latitude of U-points.

Type: string Ref.Value: gphiu

srcVarOceICMesh_latv

Name of the variable containing the latitude of V-points.

Type: string Ref.Value: gphiv

srcVarOceICMesh_latf

Name of the variable containing the latitude of F-points.

Type: string Ref.Value: gphif

srcVarOceICMesh_deptht1d

Name of the variable containing the depth of T-points.

Type: string Ref.Value: gdept_0

srcVarOceICMesh_depthw1d

Name of the variable containing the depth of W-points.

Type: string Ref.Value: gdepw_0

srcVarOceICMesh_xscalfctt

Name of the scale factors in zonal direction of T-points.

Type: string Ref.Value: e1t

srcVarOceICMesh_xscalfctu

Name of the scale factors in zonal direction of U-points.

Type: string Ref.Value: e1u

srcVarOceICMesh_xscalfctv

Name of the scale factors in zonal direction of V-points.

Type: string Ref.Value: e1v

srcVarOceICMesh_xscalfctf

Name of the scale factors in zonal direction of F-points.

Type: string Ref.Value: e1f

srcVarOceICMesh_yscalfctt

Name of the scale factors in meridional direction of T-points.

Type: string Ref.Value: e2t

srcVarOceICMesh_yscalfctu

Name of the scale factors in meridional direction of U-points.

Type: string Ref.Value: e2u

srcVarOceICMesh_yscalfctv

Name of the scale factors in meridional direction of V-points.

Type: string Ref.Value: e2v

srcVarOceICMesh_yscalfctf

Name of the scale factors in meridional direction of F-points.

Type: string Ref.Value: e2f

srcVarOceICMesh_zscalfctt1d

Name of the scale factors in vertical direction of T-points.

Type: string Ref.Value: e3t_0

srcVarOceICMesh_zscalfctw1d

Name of the scale factors in vertical direction of W-points.

Type: string Ref.Value: e3w_0

srcVarOceICMesh_maskt

Name of the land-sea-mask on T-points.

Type: string Ref.Value: tmask

srcVarOceICMesh_masku

Name of the land-sea-mask on U-points.

Type: string Ref.Value: umask

srcVarOceICMesh_maskv

Name of the land-sea-mask on V-points.

Type: string Ref.Value: vmask

Section set_dataDownlOceIC_urlName

This section of the JSON file contains the free input parameters needed to make up the URL that is required to access the input ocean IC datasets from a local or remote ropository.

urlOceIC_usr

Username to access the input ocean IC datasets from a remote ftp server.

Type: string Ref.Value: usr

urlOceIC_pwd

Password to access the input ocean IC datasets from a remote ftp server.

Type: string Ref.Value: pwd

urlOceIC_urlbase

Parametric urlname (i.e. ftp:/... or file:///...) for the input ocean IC meshmask datasets. Parameters: (FIELD),YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: file:///scratch/surf/indata_offline/gulfTaranto_20141005/data/data00/indata/ocean/oceanIC/srcFull

urlOceIC_temp

Name for the Temperature used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceIC_sal

Name for the Salinity used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceIC_ssh

Name for the Sea Surface Height used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceIC_velU

Name for the Zonal Current used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceIC_velV

Name for the Merid. Current used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceIC_tempGrid

Name for the Temperature used to replace the substring (GRID) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceIC_salGrid

Name for the Salinity used to replace the substring (GRID) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceIC_sshGrid

Name for the Sea Surface Height used to replace the substring (GRID) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceIC_velUGrid

Name for the Zonal Current used to replace the substring (GRID) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceIC_velVGrid

Name for the Merid. Current used to replace the substring (GRID) on the parametric urlname.

Type: string Ref.Value: NOTUSED

Section set_dataDownlOceIC_fileName

This section of the JSON file contains the free input parameters needed to make up the FILENAMEs of the input ocean IC datasets.

fileOceIC_filebase

Parametric filename for ocean IC input data. Parameters: (GRID),(FIELD),YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: EXP1_EAS1_1d_YYYY(i)MM(i)DD(i)_YYYY(i+1)MM(i+1)DD(i+1)_(GRID)_IONIAN.nc

fileOceIC_iProdDate

File name format to be download (=1):fixProdDate, (=2):varProdDate-DayofWeek.

Type: string Ref.Value: NOTUSED

fileOceIC_dateProdFixed

Datasets production (if iProdDate=1) is used in the URL/files.

Type: string Ref.Value: NOTUSED

fileOceIC_dateProdDayofWeek

Datasets production (if iProdDate=2) is used in the URL/files.

Type: string Ref.Value: NOTUSED

fileOceIC_temp

Name for the Temperature used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceIC_sal

Name for the Salinity used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceIC_ssh

Name for the Sea Surface Height used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceIC_velU

Name for the Zonal Current used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceIC_velV

Name for the Merid. Current used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceIC_tempGrid

Name for the Temperature used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceIC_salGrid

Name for the Salinity used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceIC_sshGrid

Name for the Sea Surface Height used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceIC_velUGrid

Name for the Zonal Current used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceIC_velVGrid

Name for the Merid. Current used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceIC_lcompression

Enables if datasets you want to download are gzip compressed files (*.gz).

Type: string Ref.Value: NOTUSED

Section set_dataDownlOceIC_varName

This section of the JSON file contains the free input parameters used to define the VARIABLE-NAMEs of the input ocean BC datasets.

srcDimOceIC_lont

Name of the dimension for the longitude of T-points.

Type: string Ref.Value: x

srcDimOceIC_lonu

Name of the dimension for the longitude of U-points.

Type: string Ref.Value: x

srcDimOceIC_lonv

Name of the dimension for the longitude of V-points.

Type: string Ref.Value: x

srcDimOceIC_lonw

Name of the dimension for the longitude of W-points.

Type: string Ref.Value: x

srcDimOceIC_latt

Name of the dimension for the latitude of T-points.

Type: string Ref.Value: y

srcDimOceIC_latu

Name of the dimension for the latitude of U-points.

Type: string Ref.Value: y

srcDimOceIC_latv

Name of the dimension for the latitude of V-points.

Type: string Ref.Value: y

srcDimOceIC_latw

Name of the dimension for the latitude of W-points.

Type: string Ref.Value: y

srcDimOceIC_deptht

Name of the dimension for the depth of T-points.

Type: string Ref.Value: z

srcDimOceIC_depthu

Name of the dimension for the depth of U-points.

Type: string Ref.Value: z

srcDimOceIC_depthv

Name of the dimension for the depth of V-points.

Type: string Ref.Value: z

srcDimOceIC_depthw

Name of the dimension for the depth of W-points.

Type: string Ref.Value: z

srcDimOceIC_time

Name of the dimension for the time.

Type: string Ref.Value: t

srcCrdOceIC_lont

Name of the coordinate variable for the longitude of T-points.

Type: string Ref.Value: nav_lon

srcCrdOceIC_lonu

Name of the coordinate variable for the longitude of U-points.

Type: string Ref.Value: nav_lon

srcCrdOceIC_lonv

Name of the coordinate variable for the longitude of V-points.

Type: string Ref.Value: nav_lon

srcCrdOceIC_lonw

Name of the coordinate variable for the longitude of W-points.

Type: string Ref.Value: nav_lon

srcCrdOceIC_latt

Name of the coordinate variable for the latitude of T-points.

Type: string Ref.Value: nav_lat

srcCrdOceIC_latu

Name of the coordinate variable for the latitude of U-points.

Type: string Ref.Value: nav_lat

srcCrdOceIC_latv

Name of the coordinate variable for the latitude of V-points.

Type: string Ref.Value: nav_lat

srcCrdOceIC_latw

Name of the coordinate variable for the latitude of W-points.

Type: string Ref.Value: nav_lat

srcCrdOceIC_deptht

Name of the coordinate variable for the depth of T-points.

Type: string Ref.Value: deptht

srcCrdOceIC_depthu

Name of the coordinate variable for the depth of U-points.

Type: string Ref.Value: depthu

srcCrdOceIC_depthv

Name of the coordinate variable for the depth of V-points.

Type: string Ref.Value: depthv

srcCrdOceIC_depthw

Name of the coordinate variable for the depth of W-points.

Type: string Ref.Value: depthw

srcCrdOceIC_time

Name of the coordinate variable for the time coordinate.

Type: string Ref.Value: time_counter

srcVarOceIC_temp

Name of the variable for the Temperature.

Type: string Ref.Value: glamf

srcVarOceIC_sal

Name of the variable for the Salinity.

Type: string Ref.Value: gphit

srcVarOceIC_ssh

Name of the variable for the Sea Surface Height.

Type: string Ref.Value: gphiu

srcVarOceIC_velU

Name of the variable for the Zonal Current.

Type: string Ref.Value: gphiv

srcVarOceIC_velV

Name of the variable for the Merid. Current.

Type: string Ref.Value: vmask

Section set_dataDownlOceBCMesh_urlName

This section of the JSON file contains the free input parameters needed to make up the URL that is required to access the input ocean BC meshmask datasets from a local or remote ropository.

urlOceBCMesh_usr

Username to access the input ocean BC meshmask datasets from a remote ftp server.

Type: string Ref.Value: usr

urlOceBCMesh_pwd

Password to access the input ocean BC meshmask datasets from a remote ftp server.

Type: string Ref.Value: pwd

urlOceBCMesh_urlbase

Parametric urlname (i.e. ftp:/... or file:///...) for the input ocean BC meshmask datasets. Parameters: (FIELD).

Type: string Ref.Value: file:///scratch/surf/indata_offline/gulfTaranto_20141005/data/data00/indata/ocean/oceanIC/srcFull

urlOceBCMesh_lont

Name for the longitude-Tgrid used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCMesh_lonu

Name for the longitude-Ugrid used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCMesh_lonv

Name for the longitude-Vgrid used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCMesh_lonf

Name for the longitude-Fgrid used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCMesh_latt

Name for the latitude-Tgrid used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCMesh_latu

Name for the latitude-Ugrid used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCMesh_latv

Name for the latitude-Vgrid used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCMesh_latf

Name for the latitude-Fgrid used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCMesh_deptht1d

Name for the depth-Tgrid used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCMesh_depthw1d

Name for the depth-Wgrid used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCMesh_xscalfctt

Name for the scaleFactor-Tgrid x-direction used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCMesh_xscalfctu

Name for the scaleFactor-Ugrid x-direction used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCMesh_xscalfctv

Name for the scaleFactor-Vgrid x-direction used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCMesh_xscalfctf

Name for the scaleFactor-Fgrid x-direction used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCMesh_yscalfctt

Name for the scaleFactor-Tgrid y-direction used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCMesh_yscalfctu

Name for the scaleFactor-Ugrid y-direction used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCMesh_yscalfctv

Name for the scaleFactor-Vgrid y-direction used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCMesh_yscalfctf

Name for the scaleFactor-Fgrid y-direction used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCMesh_zscalfctt1d

Name for the scaleFactor-Tgrid z-direction used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCMesh_zscalfctw1d

Name for the scaleFactor-Wgrid z-direction used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCMesh_maskt

Name for the LandSea-mask-Tgrid used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCMesh_masku

Name for the LandSea-mask-Ugrid used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCMesh_maskv

Name for the LandSea-mask-Vgrid used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

Section set_dataDownlOceBCMesh_fileName

This section of the JSON file contains the free input parameters needed to make up the FILENAMEs of the input ocean BC meshmask datasets.

fileOceBCMesh_filebase

Parametric filename for ocean BC meshmask input datasets. Parameters: (FIELD).

Type: string Ref.Value: meshmask_SYS4a3_IONIAN.nc

fileOceBCMesh_lont

Name for the longitude-Tgrid used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCMesh_lonu

Name for the longitude-Tgrid used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCMesh_lonv

Name for the longitude-Ugrid used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCMesh_lonf

Name for the longitude-Fgrid used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCMesh_latt

Name for the latitude-Tgrid used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCMesh_latu

Name for the latitude-Ugrid used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCMesh_latv

Name for the latitude-Vgrid used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCMesh_latf

Name for the latitude-Fgrid used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCMesh_deptht1d

Name for the depth-Tgrid used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCMesh_depthw1d

Name for the depth-Wgrid used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCMesh_xscalfctt

Name for the scaleFactor-Tgrid x-direction used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCMesh_xscalfctu

Name for the scaleFactor-Ugrid x-direction used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCMesh_xscalfctv

Name for the scaleFactor-Vgrid x-direction used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCMesh_xscalfctf

Name for the scaleFactor-Fgrid x-direction used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCMesh_yscalfctt

Name for the scaleFactor-Tgrid y-direction used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCMesh_yscalfctu

Name for the scaleFactor-Ugrid y-direction used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCMesh_yscalfctv

Name for the scaleFactor-Vgrid y-direction used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCMesh_yscalfctf

Name for the scaleFactor-Fgrid y-direction used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCMesh_zscalfctt1d

Name for the scaleFactor-Tgrid z-direction used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCMesh_zscalfctw1d

Name for the scaleFactor-Wgrid z-direction used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCMesh_maskt

Name for the LandSea-mask-Tgrid used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCMesh_masku

Name for the LandSea-mask-Ugrid used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCMesh_maskv

Name for the LandSea-mask-Vgrid used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCMesh_lcompression

(=True) if the datasets you want to download are gzip compressed files (*.gz).

Type: bool Ref.Value: True

fileOceBCMesh_llonFlip

(=True) if the longitude coord. is in the 0 to 360 range (=False) if longitude is in -180:+180 range.

Type: bool Ref.Value: True

fileOceBCMesh_llatInv

(=True) if the dataset contains latitude decreasing through the pole.

Type: bool Ref.Value: True

fileOceBCMesh_lstagC

(=True) if the input fields are defined on a staggered Arakawa C grid (=False) if they are all defined at the T grid.

Type: bool Ref.Value: False

fileOceBCMesh_lRegGrid

(=True) the input fields are defined on a REGULAR SPHERICAL GRID, UV-rotation not activate (=False) if they are on a CURVILEAR NO-SPHERICAL GRID, UV-rotation activate.

Type: bool Ref.Value: True

fileOceBCMesh_lkeepSrcFull

(=True) if you want to keep in your disk the downloaded uncutted datasets.

Type: bool Ref.Value: True

Section set_dataDownlOceBCMesh_varName

This section of the JSON file contains the free input parameters used to define the VARIABLE-NAMEs of the input ocean BC meshmask datasets.

srcDimOceBCMesh_lont

Name of the dimension for the longitude of T-points.

Type: string Ref.Value: x

srcDimOceBCMesh_lonu

Name of the dimension for the longitude of U-points.

Type: string Ref.Value: x

srcDimOceBCMesh_lonv

Name of the dimension for the longitude of V-points.

Type: string Ref.Value: x

srcDimOceBCMesh_lonw

Name of the dimension for the longitude of W-points.

Type: string Ref.Value: x

srcDimOceBCMesh_latt

Name of the dimension for the latitude of T-points.

Type: string Ref.Value: y

srcDimOceBCMesh_latu

Name of the dimension for the latitude of U-points.

Type: string Ref.Value: y

srcDimOceBCMesh_latv

Name of the dimension for the latitude of V-points.

Type: string Ref.Value: y

srcDimOceBCMesh_latw

Name of the dimension for the latitude of W-points.

Type: string Ref.Value: y

srcDimOceBCMesh_deptht

Name of the dimension for the depth of T-points.

Type: string Ref.Value: z

srcDimOceBCMesh_depthu

Name of the dimension for the depth of U-points.

Type: string Ref.Value: z

srcDimOceBCMesh_depthv

Name of the dimension for the depth of V-points.

Type: string Ref.Value: z

srcDimOceBCMesh_depthw

Name of the dimension for the depth of W-points.

Type: string Ref.Value: z

srcDimOceBCMesh_time

Name of the dimension for the time.

Type: string Ref.Value: t

srcCrdOceBCMesh_lont

Name of the coordinate variable for the longitude of T-points.

Type: string Ref.Value: nav_lon

srcCrdOceBCMesh_lonu

Name of the coordinate variable for the longitude of U-points.

Type: string Ref.Value: nav_lon

srcCrdOceBCMesh_lonv

Name of the coordinate variable for the longitude of V-points.

Type: string Ref.Value: nav_lon

srcCrdOceBCMesh_latt

Name of the coordinate variable for the latitude of T-points.

Type: string Ref.Value: nav_lat

srcCrdOceBCMesh_latu

Name of the coordinate variable for the latitude of U-points.

Type: string Ref.Value: nav_lat

srcCrdOceBCMesh_latv

Name of the coordinate variable for the latitude of V-points.

Type: string Ref.Value: nav_lat

srcCrdOceBCMesh_deptht

Name of the coordinate variable for the depth of T-points.

Type: string Ref.Value: nav_lev

srcCrdOceBCMesh_depthw

Name of the coordinate variable for the depth of W-points.

Type: string Ref.Value: nav_lev

srcCrdOceBCMesh_time

Name of the coordinate variable for the time.

Type: string Ref.Value: time

srcVarOceBCMesh_lont

Name of the variable containing the longitude of T-points.

Type: string Ref.Value: glamt

srcVarOceBCMesh_lonu

Name of the variable containing the longitude of U-points.

Type: string Ref.Value: glamu

srcVarOceBCMesh_lonv

Name of the variable containing the longitude of V-points.

Type: string Ref.Value: glamv

srcVarOceBCMesh_lonf

Name of the variable containing the longitude of F-points.

Type: string Ref.Value: glamf

srcVarOceBCMesh_latt

Name of the variable containing the latitude of T-points.

Type: string Ref.Value: gphit

srcVarOceBCMesh_latu

Name of the variable containing the latitude of U-points.

Type: string Ref.Value: gphiu

srcVarOceBCMesh_latv

Name of the variable containing the latitude of V-points.

Type: string Ref.Value: gphiv

srcVarOceBCMesh_latf

Name of the variable containing the latitude of F-points.

Type: string Ref.Value: gphif

srcVarOceBCMesh_deptht1d

Name of the variable containing the depth of T-points.

Type: string Ref.Value: gdept_0

srcVarOceBCMesh_depthw1d

Name of the variable containing the depth of W-points.

Type: string Ref.Value: gdepw_0

srcVarOceBCMesh_xscalfctt

Name of the scale factors in zonal direction of T-points.

Type: string Ref.Value: e1t

srcVarOceBCMesh_xscalfctu

Name of the scale factors in zonal direction of U-points.

Type: string Ref.Value: e1u

srcVarOceBCMesh_xscalfctv

Name of the scale factors in zonal direction of V-points.

Type: string Ref.Value: e1v

srcVarOceBCMesh_xscalfctf

Name of the scale factors in zonal direction of F-points.

Type: string Ref.Value: e1f

srcVarOceBCMesh_yscalfctt

Name of the scale factors in meridional direction of T-points.

Type: string Ref.Value: e2t

srcVarOceBCMesh_yscalfctu

Name of the scale factors in meridional direction of U-points.

Type: string Ref.Value: e2u

srcVarOceBCMesh_yscalfctv

Name of the scale factors in meridional direction of V-points.

Type: string Ref.Value: e2v

srcVarOceBCMesh_yscalfctf

Name of the scale factors in meridional direction of F-points.

Type: string Ref.Value: e2f

srcVarOceBCMesh_zscalfctt1d

Name of the scale factors in vertical direction of T-points.

Type: string Ref.Value: e3t_0

srcVarOceBCMesh_zscalfctw1d

Name of the scale factors in vertical direction of W-points.

Type: string Ref.Value: e3w_0

srcVarOceBCMesh_zscalfctu

Name of the scale factors 3d in vertical direction of U-points (needed if obc_lvelCorr=True).

Type: string Ref.Value: e3u

srcVarOceBCMesh_zscalfctv

Name of the scale factors 3d in vertical direction of V-points (needed if obc_lvelCorr=True).

Type: string Ref.Value: e3v

srcVarOceBCMesh_maskt

Name of the land-sea-mask on T-points.

Type: string Ref.Value: tmask

srcVarOceBCMesh_masku

Name of the land-sea-mask on U-points.

Type: string Ref.Value: umask

srcVarOceBCMesh_maskv

Name of the land-sea-mask on V-points.

Type: string Ref.Value: vmask

Section set_dataDownlOceBC_urlName_preSpinup

This section of the JSON file contains the free input parameters needed to make up the URL that is required to access the input ocean BC datasets of the pre-Spinup period from a local or remote ropository.

urlOceBCPre_usr

Username to access the input ocean BC datasets from a remote ftp server.

Type: string Ref.Value: usr

urlOceBCPre_pwd

Password to access the input ocean BC datasets from a remote ftp server.

Type: string Ref.Value: pwd

urlOceBCPre_urlbase

Parametric urlname (i.e. ftp:/... or file:///...) for the input ocean BC datasets. Parameters: (FIELD),YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: file:///scratch/surf/indata_offline/gulfTaranto_20141005/data/data00/indata/ocean/oceanIC/srcFull

urlOceBCPre_temp

Name for the Temperature used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCPre_sal

Name for the Salinity used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCPre_ssh

Name for the Sea Surface Height used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCPre_velU

Name for the Zonal Current used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCPre_velV

Name for the Merid. Current used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCPre_tempGrid

Name for the Temperature used to replace the substring (GRID) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCPre_salGrid

Name for the Salinity used to replace the substring (GRID) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCPre_sshGrid

Name for the Sea Surface Height used to replace the substring (GRID) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCPre_velUGrid

Name for the Zonal Current used to replace the substring (GRID) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCPre_velVGrid

Name for the Merid. Current used to replace the substring (GRID) on the parametric urlname.

Type: string Ref.Value: NOTUSED

Section set_dataDownlOceBC_fileName_preSpinup

This section of the JSON file contains the free input parameters needed to make up the FILENAMEs of the input ocean BC datasets of the pre-Spinup period.

fileOceBCPre_filebase

Parametric filename for input ocean BC datasets. Parameters: (GRID),(FIELD),YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: EXP1_EAS1_1d_YYYY(i)MM(i)DD(i)_YYYY(i+1)MM(i+1)DD(i+1)_(GRID)_IONIAN.nc

fileOceBCPre_iProdDate

File name format to be download (=1):fixProdDate, (=2):varProdDate-DayofWeek.

Type: string Ref.Value: NOTUSED

fileOceBCPre_dateProdFixed

Datasets production (if iProdDate=1) is used in the URL/files.

Type: string Ref.Value: NOTUSED

fileOceBCPre_dateProdDayofWeek

Datasets production (if iProdDate=2) is used in the URL/files.

Type: string Ref.Value: NOTUSED

fileOceBCPre_temp

Name for the Temperature used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCPre_sal

Name for the Salinity used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCPre_ssh

Name for the Sea Surface Height used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCPre_velU

Name for the Zonal Current used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCPre_velV

Name for the Merid. Current used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCPre_tempGrid

Name for the Temperature used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCPre_salGrid

Name for the Salinity used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCPre_sshGrid

Name for the Sea Surface Height used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCPre_velUGrid

Name for the Zonal Current used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCPre_velVGrid

Name for the Merid. Current used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCPre_lcompression

Enables if datasets you want to download are gzip compressed files (*.gz).

Type: string Ref.Value: NOTUSED

Section set_dataDownlOceBC_varName_preSpinup

This section of the JSON file contains the free input parameters used to define the VARIABLE-NAMEs of the input ocean BC datasets of the pre-Spinup period.

srcDimOceBCPre_lont

Name of the dimension for the longitude of T-points.

Type: string Ref.Value: x

srcDimOceBCPre_lonu

Name of the dimension for the longitude of U-points.

Type: string Ref.Value: x

srcDimOceBCPre_lonv

Name of the dimension for the longitude of V-points.

Type: string Ref.Value: x

srcDimOceBCPre_lonw

Name of the dimension for the longitude of W-points.

Type: string Ref.Value: x

srcDimOceBCPre_latt

Name of the dimension for the latitude of T-points.

Type: string Ref.Value: y

srcDimOceBCPre_latu

Name of the dimension for the latitude of U-points.

Type: string Ref.Value: y

srcDimOceBCPre_latv

Name of the dimension for the latitude of V-points.

Type: string Ref.Value: y

srcDimOceBCPre_latw

Name of the dimension for the latitude of W-points.

Type: string Ref.Value: y

srcDimOceBCPre_deptht

Name of the dimension for the depth of T-points.

Type: string Ref.Value: z

srcDimOceBCPre_depthu

Name of the dimension for the depth of U-points.

Type: string Ref.Value: z

srcDimOceBCPre_depthv

Name of the dimension for the depth of V-points.

Type: string Ref.Value: z

srcDimOceBCPre_depthw

Name of the dimension for the depth of W-points.

Type: string Ref.Value: z

srcDimOceBCPre_time

Name of the dimension for the time.

Type: string Ref.Value: t

srcCrdOceBCPre_lont

Name of the coordinate variable for the longitude of T-points.

Type: string Ref.Value: nav_lon

srcCrdOceBCPre_lonu

Name of the coordinate variable for the longitude of U-points.

Type: string Ref.Value: nav_lon

srcCrdOceBCPre_lonv

Name of the coordinate variable for the longitude of V-points.

Type: string Ref.Value: nav_lon

srcCrdOceBCPre_lonw

Name of the coordinate variable for the longitude of W-points.

Type: string Ref.Value: nav_lon

srcCrdOceBCPre_latt

Name of the coordinate variable for the latitude of T-points.

Type: string Ref.Value: nav_lat

srcCrdOceBCPre_latu

Name of the coordinate variable for the latitude of U-points.

Type: string Ref.Value: nav_lat

srcCrdOceBCPre_latv

Name of the coordinate variable for the latitude of V-points.

Type: string Ref.Value: nav_lat

srcCrdOceBCPre_latw

Name of the coordinate variable for the latitude of W-points.

Type: string Ref.Value: nav_lat

srcCrdOceBCPre_deptht

Name of the coordinate variable for the depth of T-points.

Type: string Ref.Value: deptht

srcCrdOceBCPre_depthu

Name of the coordinate variable for the depth of U-points.

Type: string Ref.Value: depthu

srcCrdOceBCPre_depthv

Name of the coordinate variable for the depth of V-points.

Type: string Ref.Value: depthv

srcCrdOceBCPre_depthw

Name of the coordinate variable for the depth of W-points.

Type: string Ref.Value: depthw

srcCrdOceBCPre_time

Name of the coordinate variable for the time coordinate.

Type: string Ref.Value: time_counter

srcVarOceBCPre_temp

Name of the variable for the Temperature.

Type: string Ref.Value: glamf

srcVarOceBCPre_sal

Name of the variable for the Salinity.

Type: string Ref.Value: gphit

srcVarOceBCPre_ssh

Name of the variable for the Sea Surface Height.

Type: string Ref.Value: gphiu

srcVarOceBCPre_velU

Name of the variable for the Zonal Current.

Type: string Ref.Value: gphiv

srcVarOceBCPre_velV

Name of the variable for the Merid. Current.

Type: string Ref.Value: vmask

Section set_dataDownlOceBC_urlName_postSpinup

This section of the JSON file contains the free input parameters needed to make up the URL that is required to access the input ocean BC datasets of the post-Spinup period from a local or remote ropository.

urlOceBCPost_usr

Username to access the input ocean BC datasets from a remote ftp server.

Type: string Ref.Value: usr

urlOceBCPost_pwd

Password to access the input ocean BC datasets from a remote ftp server.

Type: string Ref.Value: pwd

urlOceBCPost_urlbase

Parametric urlname (i.e. ftp:/... or file:///...) for the input ocean BC datasets. Parameters: (FIELD),YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: file:///scratch/surf/indata_offline/gulfTaranto_20141005/data/data00/indata/ocean/oceanIC/srcFull

urlOceBCPost_temp

Name for the Temperature used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCPost_sal

Name for the Salinity used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCPost_ssh

Name for the Sea Surface Height used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCPost_velU

Name for the Zonal Current used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCPost_velV

Name for the Merid. Current used to replace the substring (FIELD) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCPost_tempGrid

Name for the Temperature used to replace the substring (GRID) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCPost_salGrid

Name for the Salinity used to replace the substring (GRID) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCPost_sshGrid

Name for the Sea Surface Height used to replace the substring (GRID) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCPost_velUGrid

Name for the Zonal Current used to replace the substring (GRID) on the parametric urlname.

Type: string Ref.Value: NOTUSED

urlOceBCPost_velVGrid

Name for the Merid. Current used to replace the substring (GRID) on the parametric urlname.

Type: string Ref.Value: NOTUSED

Section set_dataDownlOceBC_fileName_postSpinup

This section of the JSON file contains the free input parameters needed to make up the FILENAMEs of the input ocean BC datasets of the post-Spinup period.

fileOceBCPost_filebase

Parametric filename for input ocean BC datasets. Parameters: (GRID),(FIELD),YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1).

Type: string Ref.Value: EXP1_EAS1_1d_YYYY(i)MM(i)DD(i)_YYYY(i+1)MM(i+1)DD(i+1)_(GRID)_IONIAN.nc

fileOceBCPost_iProdDate

File name format to be download (=1):fixProdDate, (=2):varProdDate-DayofWeek.

Type: string Ref.Value: NOTUSED

fileOceBCPost_dateProdFixed

Datasets production (if iProdDate=1) is used in the URL/files.

Type: string Ref.Value: NOTUSED

fileOceBCPost_dateProdDayofWeek

Datasets production (if iProdDate=2) is used in the URL/files.

Type: string Ref.Value: NOTUSED

fileOceBCPost_temp

Name for the Temperature used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCPost_sal

Name for the Salinity used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCPost_ssh

Name for the Sea Surface Height used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCPost_velU

Name for the Zonal Current used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCPost_velV

Name for the Merid. Current used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCPost_tempGrid

Name for the Temperature used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCPost_salGrid

Name for the Salinity used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCPost_sshGrid

Name for the Sea Surface Height used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCPost_velUGrid

Name for the Zonal Current used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCPost_velVGrid

Name for the Merid. Current used to replace the substring (FIELD) on the parametric filename.

Type: string Ref.Value: NOTUSED

fileOceBCPost_lcompression

Enables if datasets you want to download are gzip compressed files (*.gz).

Type: string Ref.Value: NOTUSED

Section set_dataDownlOceBC_varName_postSpinup

This section of the JSON file contains the free input parameters used to define the VARIABLE-NAMEs of the input ocean BC datasets of the post-Spinup period.

srcDimOceBCPost_lont

Name of the dimension for the longitude of T-points.

Type: string Ref.Value: x

srcDimOceBCPost_lonu

Name of the dimension for the longitude of U-points.

Type: string Ref.Value: x

srcDimOceBCPost_lonv

Name of the dimension for the longitude of V-points.

Type: string Ref.Value: x

srcDimOceBCPost_lonw

Name of the dimension for the longitude of W-points.

Type: string Ref.Value: x

srcDimOceBCPost_latt

Name of the dimension for the latitude of T-points.

Type: string Ref.Value: y

srcDimOceBCPost_latu

Name of the dimension for the latitude of U-points.

Type: string Ref.Value: y

srcDimOceBCPost_latv

Name of the dimension for the latitude of V-points.

Type: string Ref.Value: y

srcDimOceBCPost_latw

Name of the dimension for the latitude of W-points.

Type: string Ref.Value: y

srcDimOceBCPost_deptht

Name of the dimension for the depth of T-points.

Type: string Ref.Value: z

srcDimOceBCPost_depthu

Name of the dimension for the depth of U-points.

Type: string Ref.Value: z

srcDimOceBCPost_depthv

Name of the dimension for the depth of V-points.

Type: string Ref.Value: z

srcDimOceBCPost_depthw

Name of the dimension for the depth of W-points.

Type: string Ref.Value: z

srcDimOceBCPost_time

Name of the dimension for the time.

Type: string Ref.Value: t

srcCrdOceBCPost_lont

Name of the coordinate variable for the longitude of T-points.

Type: string Ref.Value: nav_lon

srcCrdOceBCPost_lonu

Name of the coordinate variable for the longitude of U-points.

Type: string Ref.Value: nav_lon

srcCrdOceBCPost_lonv

Name of the coordinate variable for the longitude of V-points.

Type: string Ref.Value: nav_lon

srcCrdOceBCPost_lonw

Name of the coordinate variable for the longitude of W-points.

Type: string Ref.Value: nav_lon

srcCrdOceBCPost_latt

Name of the coordinate variable for the latitude of T-points.

Type: string Ref.Value: nav_lat

srcCrdOceBCPost_latu

Name of the coordinate variable for the latitude of U-points.

Type: string Ref.Value: nav_lat

srcCrdOceBCPost_latv

Name of the coordinate variable for the latitude of V-points.

Type: string Ref.Value: nav_lat

srcCrdOceBCPost_latw

Name of the coordinate variable for the latitude of W-points.

Type: string Ref.Value: nav_lat

srcCrdOceBCPost_deptht

Name of the coordinate variable for the depth of T-points.

Type: string Ref.Value: deptht

srcCrdOceBCPost_depthu

Name of the coordinate variable for the depth of U-points.

Type: string Ref.Value: depthu

srcCrdOceBCPost_depthv

Name of the coordinate variable for the depth of V-points.

Type: string Ref.Value: depthv

srcCrdOceBCPost_depthw

Name of the coordinate variable for the depth of W-points.

Type: string Ref.Value: depthw

srcCrdOceBCPost_time

Name of the coordinate variable for the time coordinate.

Type: string Ref.Value: time_counter

srcVarOceBCPost_temp

Name of the variable for the Temperature.

Type: string Ref.Value: glamf

srcVarOceBCPost_sal

Name of the variable for the Salinity.

Type: string Ref.Value: gphit

srcVarOceBCPost_ssh

Name of the variable for the Sea Surface Height.

Type: string Ref.Value: gphiu

srcVarOceBCPost_velU

Name of the variable for the Zonal Current.

Type: string Ref.Value: gphiv

srcVarOceBCPost_velV

parametric the Merid. Current.

Type: string Ref.Value: vmask

Section set_dataDownlTideMesh_urlName

This section of the JSON file contains the parameters needed to make up the URL that is required to access the input tidal forcing meshmask datasets from a local or remote ropository.

urlTideMesh_usr

Username to access the input tidal forcing meshmask datasets from a remote ftp server.

Type: string Ref.Value: usr

urlTideMesh_pwd

Password to access the input tidal forcing meshmask datasets from a remote ftp server.

Type: string Ref.Value: pwd

urlTideMesh_urlbase

Parametric urlname (i.e. ftp:/... or file:///...) for input tidal forcing meshmask datasets. Parameters: (CONS),YYYY(p)MM(p)DD(p).

Type: string Ref.Value: file:///scratch/surf/surf_datasets/current/tide/TPXO8_atlas_30_v1_nc

urlTideMesh_K1

Name for tidal constituent K1 used to replace the substring (CONS) on the parametrinc urlname.

Type: string Ref.Value: K1

urlTideMesh_O1

Name for tidal constituent O1 used to replace the substring (CONS) on the parametrinc urlname.

Type: string Ref.Value: O1

urlTideMesh_P1

Name for tidal constituent P1 used to replace the substring (CONS) on the parametrinc urlname.

Type: string Ref.Value: P1

urlTideMesh_Q1

Name for tidal constituent Q1 used to replace the substring (CONS) on the parametrinc urlname.

Type: string Ref.Value: Q1

urlTideMesh_K2

Name for tidal constituent K2 used to replace the substring (CONS) on the parametrinc urlname.

Type: string Ref.Value: K2

urlTideMesh_M2

Name for tidal constituent M2 used to replace the substring (CONS) on the parametrinc urlname.

Type: string Ref.Value: M2

urlTideMesh_N2

Name for tidal constituent N2 used to replace the substring (CONS) on the parametrinc urlname.

Type: string Ref.Value: N2

urlTideMesh_S2

Name for tidal constituent S2 used to replace the substring (CONS) on the parametrinc urlname.

Type: string Ref.Value: S2

urlTideMesh_M4

Name for tidal constituent M4 used to replace the substring (CONS) on the parametrinc urlname.

Type: string Ref.Value: M4

urlTideMesh_Mm

Name for tidal constituent Mm used to replace the substring (CONS) on the parametrinc urlname.

Type: string Ref.Value: Mm

urlTideMesh_Mf

Name for tidal constituent Mf used to replace the substring (CONS) on the parametrinc urlname.

Type: string Ref.Value: Mf

Section set_dataDownlTideMesh_fileName

This section of the JSON file contains the parameters needed to make up the FILENAMEs of the input tidal forcing meshmask datasets.

fileTideMesh_filebase_bathy

Parametric filename for tidal forcing meshmask input datasets. Parameters: (CONS).

Type: string Ref.Value: grid_tpxo8(CONS).nc

fileTideMesh_K1

Name for tidal constituent K1 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used)

Type: string Ref.Value: atlas_30_v1

fileTideMesh_O1

Name for tidal constituent O1 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used)

Type: string Ref.Value: atlas_30_v1

fileTideMesh_P1

Name for tidal constituent P1 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used)

Type: string Ref.Value: atlas_30_v1

fileTideMesh_Q1

Name for tidal constituent Q1 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used)

Type: string Ref.Value: atlas_30_v1

fileTideMesh_K2

Name for tidal constituent K2 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used)

Type: string Ref.Value: atlas_30_v1

fileTideMesh_M2

Name for tidal constituent M2 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used)

Type: string Ref.Value: atlas_30_v1

fileTideMesh_N2

Name for tidal constituent N2 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used)

Type: string Ref.Value: atlas_30_v1

fileTideMesh_S2

Name for tidal constituent S2 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used)

Type: string Ref.Value: atlas_30_v1

fileTideMesh_M4

Name for tidal constituent M4 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used)

Type: string Ref.Value: atlas_30_v1

fileTideMesh_Mm

Name for tidal constituent Mm used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used)

Type: string Ref.Value: atlas_30_v1

fileTideMesh_Mf

Name for tidal constituent Mf used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used)

Type: string Ref.Value: atlas_30_v1

fileTideMesh_lcompression

(=True) if the datasets you want to download are gzip compressed files (*.gz).

Type: bool Ref.Value: False

fileTideMesh_llonFlip

(=True) if the longitude coord. is in the 0 to 360 range (=False) if longitude is in -180:+180 range.

Type: bool Ref.Value: False

fileTideMesh_llatInv

(=True) if the dataset contains latitude decreasing through the pole.

Type: bool Ref.Value: True

fileTideMesh_lkeepSrcFull

(=True) if you want to keep in your disk the downloaded uncutted datasets.

Type: bool Ref.Value: True

Section set_dataDownlTideMesh_varName

This section of the JSON file contains the parameters for the VARIABLE-NAMEs of the input tidal forcing meshmask datasets.

srcDimTideMesh_lont

Name of the dimension for the longitude of T-points.

Type: string Ref.Value: nx

srcDimTideMesh_lonu

Name of the dimension for the longitude of U-points.

Type: string Ref.Value: nx

srcDimTideMesh_lonv

Name of the dimension for the longitude of V-points.

Type: string Ref.Value: nx

srcDimTideMesh_latt

Name of the dimension for the latitude of T-points.

Type: string Ref.Value: ny

srcDimTideMesh_latu

Name of the dimension for the latitude of U-points.

Type: string Ref.Value: ny

srcDimTideMesh_latv

Name of the dimension for the latitude of V-points.

Type: string Ref.Value: ny

srcCrdTideMesh_lont

Name of the variable containing longitude coordinate of T-points (if sbc_iformulat=1).

Type: string Ref.Value: lon_z

srcCrdTideMesh_lonu

Name of the variable containing longitude coordinate of U-points (if sbc_iformulat=1).

Type: string Ref.Value: lon_v

srcCrdTideMesh_lonv

Name of the variable containing longitude coordinate of V-points (if sbc_iformulat=1).

Type: string Ref.Value: lon_v

srcCrdTideMesh_latt

Name of the variable containing latitude coordinate of T-points (if sbc_iformulat=1).

Type: string Ref.Value: lat_z

srcCrdTideMesh_latu

Name of the variable containing latitude coordinate of U-points (if sbc_iformulat=1).

Type: string Ref.Value: lat_u

srcCrdTideMesh_latv

Name of the variable containing latitude coordinate of V-points (if sbc_iformulat=1).

Type: string Ref.Value: lat_v

srcVarTideMesh_batt

Name of the variable containing the Land Sea Mask of T-points (if sbc_iformulat=1).

Type: string Ref.Value: hz

srcVarTideMesh_batu

Name of the variable containing the Land Sea Mask of U-points (if sbc_iformulat=1).

Type: string Ref.Value: hz

srcVarTideMesh_batv

Name of the variable containing the Land Sea Mask of V-points (if sbc_iformulat=1).

Type: string Ref.Value: hz

Section set_dataDownlTide_urlName

This section of the JSON file contains the parameters needed to make up the URL that is required to access the input tidal forcing datasets from a local or remote ropository.

urlTide_usr

Username to access the input tidal forcing datasets from a remote ftp server.

Type: string Ref.Value: usr

urlTide_pwd

Password to access the input tidal forcing datasets from a remote ftp server.

Type: string Ref.Value: pwd

urlTide_urlbase

Parametric urlname (i.e. ftp:/... or file:///...) for input tidal forcing datasets. Parameters: (CONS),YYYY(p)MM(p)DD(p).

Type: string Ref.Value: file:///scratch/surf/surf_datasets/current/tide/TPXO8_atlas_30_v1_nc

urlTide_K1

Name for tidal constituent K1 used to replace the substring (CONS) on the parametrinc urlname.

Type: string Ref.Value: K1

urlTide_O1

Name for tidal constituent O1 used to replace the substring (CONS) on the parametrinc urlname.

Type: string Ref.Value: O1

urlTide_P1

Name for tidal constituent P1 used to replace the substring (CONS) on the parametrinc urlname.

Type: string Ref.Value: P1

urlTide_Q1

Name for tidal constituent Q1 used to replace the substring (CONS) on the parametrinc urlname.

Type: string Ref.Value: Q1

urlTide_K2

Name for tidal constituent K2 used to replace the substring (CONS) on the parametrinc urlname.

Type: string Ref.Value: K2

urlTide_M2

Name for tidal constituent M2 used to replace the substring (CONS) on the parametrinc urlname.

Type: string Ref.Value: M2

urlTide_N2

Name for tidal constituent N2 used to replace the substring (CONS) on the parametrinc urlname.

Type: string Ref.Value: N2

urlTide_S2

Name for tidal constituent S2 used to replace the substring (CONS) on the parametrinc urlname.

Type: string Ref.Value: S2

urlTide_M4

Name for tidal constituent M4 used to replace the substring (CONS) on the parametrinc urlname.

Type: string Ref.Value: M4

urlTide_Mm

Name for tidal constituent Mm used to replace the substring (CONS) on the parametrinc urlname.

Type: string Ref.Value: Mm

urlTide_Mf

Name for tidal constituent Mf used to replace the substring (CONS) on the parametrinc urlname.

Type: string Ref.Value: Mf

Section set_dataDownlTide_fileName

This section of the JSON file contains the parameters needed to make up the FILENAMEs of the input tidal forcing meshmask datasets.

fileTide_filebase_elev

Parametric filename for the Tidal elevation complex amplitude (Imag part) datasets (if =NOTUSED, file not used). Parameters: (CONS), (RESTIDE).

Type: string Ref.Value: grid_tpxo8(CONS).nc

fileTide_filebase_velU

Parametric filename for the Tidal WE transport complex amplitude (Imag part) datasets (if =NOTUSED, file not used). Parameters: (CONS), (RESTIDE).

Type: string Ref.Value: grid_tpxo8(CONS).nc

fileTide_filebase_velV

Parametric filename for the Tidal SN transport complex amplitude (Imag part) datasets (if =NOTUSED, file not used). Parameters: (CONS), (RESTIDE).

Type: string Ref.Value: grid_tpxo8(CONS).nc

fileTide_K1

Name for tidal constituent K1 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used)

Type: string Ref.Value: atlas_30_v1

fileTide_O1

Name for tidal constituent O1 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used)

Type: string Ref.Value: atlas_30_v1

fileTide_P1

Name for tidal constituent P1 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used)

Type: string Ref.Value: atlas_30_v1

fileTide_Q1

Name for tidal constituent Q1 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used)

Type: string Ref.Value: atlas_30_v1

fileTide_K2

Name for tidal constituent K2 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used)

Type: string Ref.Value: atlas_30_v1

fileTide_M2

Name for tidal constituent M2 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used)

Type: string Ref.Value: atlas_30_v1

fileTide_N2

Name for tidal constituent N2 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used)

Type: string Ref.Value: atlas_30_v1

fileTide_S2

Name for tidal constituent S2 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used)

Type: string Ref.Value: atlas_30_v1

fileTide_M4

Name for tidal constituent M4 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used)

Type: string Ref.Value: atlas_30_v1

fileTide_Mm

Name for tidal constituent Mm used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used)

Type: string Ref.Value: atlas_30_v1

fileTide_Mf

Name for tidal constituent Mf used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used)

Type: string Ref.Value: atlas_30_v1

fileTide_lcompression

(=True) if the datasets you want to download are gzip compressed files (*.gz).

Type: bool Ref.Value: False

Section set_dataDownlTide_varName

This section of the JSON file contains the parameters for the VARIABLE-NAMEs of the input tidal forcing meshmask datasets.

srcDimTide_lont

Name of the dimension for the longitude of T-points.

Type: string Ref.Value: nx

srcDimTide_lonu

Name of the dimension for the longitude of U-points.

Type: string Ref.Value: nx

srcDimTide_lonv

Name of the dimension for the longitude of V-points.

Type: string Ref.Value: nx

srcDimTide_latt

Name of the dimension for the latitude of T-points.

Type: string Ref.Value: ny

srcDimTide_latu

Name of the dimension for the latitude of U-points.

Type: string Ref.Value: ny

srcDimTide_latv

Name of the dimension for the latitude of V-points.

Type: string Ref.Value: ny

srcCrdTide_lont

Name of the variable containing longitude coordinate of T-points (if sbc_iformulat=1).

Type: string Ref.Value: lon_z

srcCrdTide_lonu

Name of the variable containing longitude coordinate of U-points (if sbc_iformulat=1).

Type: string Ref.Value: lon_v

srcCrdTide_lonv

Name of the variable containing longitude coordinate of V-points (if sbc_iformulat=1).

Type: string Ref.Value: lon_v

srcCrdTide_latt

Name of the variable containing latitude coordinate of T-points (if sbc_iformulat=1).

Type: string Ref.Value: lat_z

srcCrdTide_latu

Name of the variable containing latitude coordinate of U-points (if sbc_iformulat=1).

Type: string Ref.Value: lat_u

srcCrdTide_latv

Name of the variable containing latitude coordinate of V-points (if sbc_iformulat=1).

Type: string Ref.Value: lat_v

srcVarTide_elevIm

Name of the variable for the Tidal elevation complex amplitude (Imag part) of the Lunar diurnal K1 tidal component datasets (if =NOTUSED, file not used).

Type: string Ref.Value: hIm

srcVarTide_elevRe

Name of the variable for the Tidal elevation complex amplitude (Real part) of the Lunar diurnal K1 tidal component datasets (if =NOTUSED, file not used).

Type: string Ref.Value: hRe

srcVarTide_velUIm

Name of the variable for the Tidal WE transport complex amplitude (Imag part) of the Lunar diurnal K1 tidal component datasets (if =NOTUSED, file not used).

Type: string Ref.Value: uIm

srcVarTide_velURe

Name of the variable for the Tidal WE transport complex amplitude (Real part) of the Lunar diurnal K1 tidal component datasets (if =NOTUSED, file not used).

Type: string Ref.Value: uRe

srcVarTide_velVIm

Name of the variable for the Tidal SN transport complex amplitude (Imag part) of the Lunar diurnal K1 tidal component datasets (if =NOTUSED, file not used).

Type: string Ref.Value: vIm

srcVarTide_velVRe

Name of the variable for the Tidal SN transport complex amplitude (Real part) of the Lunar diurnal K1 tidal component datasets (if =NOTUSED, file not used).

Type: string Ref.Value: vRe

Input parameters for manipulate Bathymetry

Section set_manipolBat

This section of the JSON file contains the free input parameters used to define ...

manipBat_seaLevel

Value to be add to bathymetry in order to modify the surface elevation (es. caspian Sea 28 meter).

Type: float Ref.Value: 0.0

manipBat_minDepth

Minimum bathy value of the whole domain (at sea gridpoints).

Type: float Ref.Value: 5.0

manipBat_maxDepth

Maximum bathy value of the whole domain (at sea gridpoints).

Type: float Ref.Value: 22000.0

manipBat_lmoveDepth

Enables the modification of bathy (to a given value >=0) inside rectangular regions.

Type: bool Ref.Value: True

manipBatMoveDepth_lonWest

Longitude of the western boundary of rectangular regions where you want to move the depth.

Type: float Ref.Value: 18.0

manipBatMoveDepth_lonEast

Longitude of the eastern boundary of rectangular regions where you want to move the depth.

Type: float Ref.Value: 18.375

manipBatMoveDepth_latSout

Latitude of the southern boundary of rectangular regions where you want to move the depth.

Type: float Ref.Value: 40.3

manipBatMoveDepth_latNort

Latitude of the northern boundary of rectangular regions where you want to move the depth.

Type: float Ref.Value: 40.5625

manipBatMoveDepth_depth

Depth of rectangular regions where you want to move the depth (if=0.0 you add land points).

Type: float Ref.Value: 0.0

Input parameters for shapiro filter datasets

Section set_shapFiltBat

This section of the JSON file contains the free input parameters used to define ...

norder_shapFiltBat

Order of the Shapiro Filter for the bathymetry data.

Type: int Ref.Value: 2

nloop_shapFiltBat

Numer of application of the Shapiro Filter for the bathymetry data.

Type: int Ref.Value: 4

Section set_shapFiltOce

This section of the JSON file contains the free input parameters used to define ...

norder_shapFiltOce

Order of the Shapiro Filter for the ocean output data.

Type: int Ref.Value: 2

nloop_shapFiltOce

Numer of application of the Shapiro Filter for the ocean output data.

Type: int Ref.Value: 10

Input parameters for interpolation methods

Section set_interpMethodBat

This section of the JSON file contains the free input parameters used to define interpolation method to be used for the Sea Floor Elevation.

interpMethodBat_elev

Remapping method to use for the for the Sea Floor Elevation: bilin,bicub,distwgt.

Type: string Ref.Value: bilin

Section set_interpMethodAtm

This section of the JSON file contains the free input parameters used to define interpolation method to be used for the atmospheric forcing fields.

interpMethodAtm_velU

Remapping method to use for the zonal component of air velocity (if sbc_iformulat=0,2): bilin,bicub,distwgt.

Type: string Ref.Value: bilin

interpMethodAtm_velV

Remapping method to use for the meridional componente of air velocity (if sbc_iformulat=0,2): bilin,bicub,distwgt.

Type: string Ref.Value: bilin

interpMethodAtm_temp

Remapping method to use for the Air Temperature (if sbc_iformulat=0,2): bilin,bicub,distwgt.

Type: string Ref.Value: bilin

interpMethodAtm_dpTemp

Remapping method to use for the Dewpoint Temperature (if sbc_iformulat=0): bilin,bicub,distwgt.

Type: string Ref.Value: bilin

interpMethodAtm_mslp

Remapping method to use for the mean sea level pressure (if sbc_iformulat=0): bilin,bicub,distwgt.

Type: string Ref.Value: bilin

interpMethodAtm_cloudCover

Remapping method to use for the Dewpoint Temperature (if sbc_iformulat=0): bilin,bicub,distwgt.

Type: string Ref.Value: bilin

interpMethodAtm_prec

Remapping method to use for the Total Precipitation (if sbc_iformulat=0,2): bilin,bicub,distwgt.

Type: string Ref.Value: bilin

interpMethodAtm_tauU

Remapping method to use for the Zonal Wind Stress (if sbc_iformulat=1): bilin,bicub,distwgt.

Type: string Ref.Value: bilin

interpMethodAtm_tauV

Remapping method to use for the Meridional Wind Stress (if sbc_iformulat=1): bilin,bicub,distwgt.

Type: string Ref.Value: bilin

interpMethodAtm_qtot

Remapping method to use for the Total Heat Flux (if sbc_iformulat=1): bilin,bicub,distwgt.

Type: string Ref.Value: bilin

interpMethodAtm_qsr

Remapping method to use for the Solar Radiation Penetration (if sbc_iformulat=1): bilin,bicub,distwgt.

Type: string Ref.Value: bilin

interpMethodAtm_emp

Remapping method to use for the Mass Flux Exchanged (if sbc_iformulat=1): bilin,bicub,distwgt.

Type: string Ref.Value: bilin

interpMethodAtm_tempS

Remapping method to use for the Surface Temperature (if sbc_iformulat=1): bilin,bicub,distwgt.

Type: string Ref.Value: bilin

interpMethodAtm_salS

Remapping method to use for the Surface Salinity (if sbc_iformulat=1): bilin,bicub,distwgt.

Type: string Ref.Value: bilin

interpMethodAtm_umid

Remapping method to use for the Air Umidity (if sbc_iformulat=2): bilin,bicub,distwgt.

Type: string Ref.Value: bilin

interpMethodAtm_radLW

Remapping method to use for the Long Wave Radiation (if sbc_iformulat=2): bilin,bicub,distwgt.

Type: string Ref.Value: bilin

interpMethodAtm_radSW

Remapping method to use for the Short Wave Radiation (if sbc_iformulat=2): bilin,bicub,distwgt.

Type: string Ref.Value: bilin

interpMethodAtm_snow

Remapping method to use for the Solid Precipitation (if sbc_iformulat=2): bilin,bicub,distwgt.

Type: string Ref.Value: bilin

Section set_interpMethodOceIC

This section of the JSON file contains the free input parameters used to define interpolation method to be used for the ocean IC fields.

interpMethodOceIC_temp

Remapping method to use for the Temperature: bilin,bicub,distwgt.

Type: string Ref.Value: bilin

interpMethodOceIC_sal

Remapping method to use for the Salinity: bilin,bicub,distwgt.

Type: string Ref.Value: bilin

interpMethodOceIC_ssh

Remapping method to use for the Sea Surface Height: bilin,bicub,distwgt.

Type: string Ref.Value: bilin

interpMethodOceIC_velU

Remapping method to use for the Zonal Current: bilin,bicub,distwgt.

Type: string Ref.Value: bilin

interpMethodOceIC_velV

Remapping method to use for the Meridional Current: bilin,bicub,distwgt.

Type: string Ref.Value: bilin

Section set_interpMethodOceBC

This section of the JSON file contains the free input parameters used to define interpolation method to be used for the ocean BC fields

interpMethodOceBC_temp

Remapping method to use for the Temperature: bilin,bicub,distwgt.

Type: string Ref.Value: bilin

interpMethodOceBC_sal

Remapping method to use for the Salinity: bilin,bicub,distwgt.

Type: string Ref.Value: bilin

interpMethodOceBC_ssh

Remapping method to use for the Sea Surface Height: bilin,bicub,distwgt.

Type: string Ref.Value: bilin

interpMethodOceBC_velU

Remapping method to use for the Zonal Current: bilin,bicub,distwgt.

Type: string Ref.Value: bilin

interpMethodOceBC_velV

Remapping method to use for the Meridional Current: bilin,bicub,distwgt.

Type: string Ref.Value: bilin

Section set_interpMethodTide

This section of the JSON file contains the free input parameters used to define interpolation method to be used for the tidal forcing fields

interpMethodTide_elev

Remapping method to use for the Tidal elevation: bilin,bicub,distwgt.

Type: string Ref.Value: bilin

interpMethodTide_velU

Remapping method to use for the Tidal Zonal transport: bilin,bicub,distwgt.

Type: string Ref.Value: bilin

interpMethodTide_velV

Remapping method to use for the Tidal Meridional transport: bilin,bicub,distwgt.

Type: string Ref.Value: bilin

Input parameters for the selection of variables to be saved in the output file

Section set_lvarOceOutT

This section of the JSON file contains the free input parameters used to define ...

lvarOceOutT_temp

Enables if you want write Temperature (votemper) field in the output file.

Type: bool Ref.Value: True

lvarOceOutT_sal

Enables if you want write Salinity (vosaline) field in the output file.

Type: bool Ref.Value: True

lvarOceOutT_tempS

Enables if you want write Surface Temperature (sosstsst) field in the output file.

Type: bool Ref.Value: False

lvarOceOutT_salS

Enables if you want write Surface Salinity (sosaline) field in the output file.

Type: bool Ref.Value: False

lvarOceOutT_ssh

Enables if you want write Sea Surface Height (sossheig) field in the output file.

Type: bool Ref.Value: True

lvarOceOutT_fluxWater_up

Enables if you want write Net Upward Water Flux (sowaflup) field in the output file.

Type: bool Ref.Value: False

lvarOceOutT_fluxSalt_down

Enables if you want write downward salt flux (sosfldow) field in the output file.

Type: bool Ref.Value: False

lvarOceOutT_fluxHeat_down

Enables if you want write Net Downward Heat Flux (sohefldo) field in the output file.

Type: bool Ref.Value: False

lvarOceOutT_fluxHeatS_damp

Enables if you want write Surface Heat Flux: Damping (sohefldp) field in the output file.

Type: bool Ref.Value: False

lvarOceOutT_fluxWaterS_damp

Enables if you want write Surface Water Flux: Damping (sowafldp) field in the output file.

Type: bool Ref.Value: False

lvarOceOutT_fluxSaltS_damp

Enables if you want write Surface salt flux: damping (sosafldp) field in the output file.

Type: bool Ref.Value: False

lvarOceOutT_runoffs

Enables if you want write River runoffs (sorunoff) field in the output file.

Type: bool Ref.Value: False

lvarOceOutT_tempConcen

Enables if you want write Concentration/Dilution term on temperature (sosst_cd) field in the output file.

Type: bool Ref.Value: False

lvarOceOutT_salConcen

Enables if you want write Concentration/Dilution term on salinity (sosss_cd) field in the output file.

Type: bool Ref.Value: False

lvarOceOutT_radSW

Enables if you want write Shortwave Radiation (soshfldo) field in the output file.

Type: bool Ref.Value: False

lvarOceOutT_depthTurb

Enables if you want write Turbocline Depth (somixhgt) field in the output file.

Type: bool Ref.Value: False

lvarOceOutT_mld

Enables if you want write Mixed Layer Depth 0.01 (somxl010) field in the output file.

Type: bool Ref.Value: False

lvarOceOutT_iceFrac

Enables if you want write Ice fraction (soicecov) field in the output file.

Type: bool Ref.Value: False

lvarOceOutT_wind10

Enables if you want write wind speed at 10m (sowindsp) field in the output file.

Type: bool Ref.Value: False

lvarOceOutT_bowlin

Enables if you want write Bowl Index (sobowlin) field in the output file.

Type: bool Ref.Value: False

Section set_lvarOceOutU

This section of the JSON file contains the free input parameters used to define ...

lvarOceOutU_velU

Enables if you want write Zonal Current (vozocrtx) field in the output file.

Type: bool Ref.Value: True

lvarOceOutU_tauU

Enables if you want write Zonal Wind Stress (sozotaux) field in the output file.

Type: bool Ref.Value: False

Section set_lvarOceOutV

This section of the JSON file contains the free input parameters used to define ...

lvarOceOutV_velV

Enables if you want write Meridional Current (vomecrty) field in the output file.

Type: bool Ref.Value: True

lvarOceOutV_tauV

Enables if you want write Meridional Wind Stress (sometauy) field in the output file.

Type: bool Ref.Value: False

Section set_lvarOceOutW

This section of the JSON file contains the free input parameters used to define ...

lvarOceOutW_velW

Enables if you want write Vertical Velocity (vovecrtz) field in the output file.

Type: bool Ref.Value: False

lvarOceOutW_eddyDiffW

Enables if you want write Vertical Eddy Diffusivity (votkeavt) field in the output file.

Type: bool Ref.Value: False

lvarOceOutW_eddyViscW

Enables if you want write Vertical Eddy Viscosity (votkeavm) field in the output file.

Type: bool Ref.Value: False

Input parameters for data compression

Section set_lzip

This section of the JSON file contains the free input parameters used to define ...

lzip_indata

Enables/disable gzip compression of the Indata Bat,Atm,OceIC,OceBC files.

Type: bool Ref.Value: False

lzip_extrapdata

Enables/disable gzip compression of the Extrapdata Atm,OceIC,OceBC files.

Type: bool Ref.Value: False

lzip_indata

Enables/disable gzip compression of the Regriddata Bat,Atm,OceIC,OceBC,OceBCbdy files.

Type: bool Ref.Value: False

lzip_indata

Enables/disable gzip compression of the Outdata Ocean files.

Type: bool Ref.Value: False

User Configuration File: Postprocessing Sections

In this chapter we continue to explore the contents of the configuration file. In particular we will examine in details the sections B used to manage the post-processing procedures for the visualization of input/output datasets, the comparison of child/parent fields and the comparison of the simulation result with insitu or satellite datasets.

Input parameters for selecting the figure to generate

Section set_lplot

The section set_lrun contains the logical parameters to activate/deactivate specific plot.

lplot_domain

Enable/disable the plotting of the user defined Domains.

Type: bool Ref.Value: True

lplot_indata

Enable/disable the plotting of the Input Bat,Atm,OceIC,OceBC data.

Type: bool Ref.Value: True

lplot_extrapdata

Enable/disable the plotting of the Extrapolated Atm,OceIC,OceBC data.

Type: bool Ref.Value: True

lplot_intUVdata

Enable/disable the plotting of the Interpolated OceIC(U,V),OceBC(U,V) data.

Type: bool Ref.Value: True

lplot_rotUVdata

Enable/disable the plotting of the Rotated OceIC(U,V),OceBC(U,V) data.

Type: bool Ref.Value: True

lplot_regriddata

Enable/disable the plotting of the Regridded Bat,Atm,OceIC,OceBC,OceBCbdy data.

Type: bool Ref.Value: True

lplot_outdata

Enable/disable the plotting of the Output Ocean data.

Type: bool Ref.Value: True

lplot_chlVSpar

Enable/disable the plotting of the child VS. parent Ocean fields.

Type: bool Ref.Value: False

lplot_surfVSctd

Enable/disable the plotting of the surf VS. ctd Ocean fields.

Type: bool Ref.Value: False

lplot_surfVSmooring

Enable/disable the plotting of the surf VS. mooring Ocean fields.

Type: bool Ref.Value: True

lplot_surfVSferrybox

Enable/disable the plotting of the surf VS. ferrybox Ocean fields.

Type: bool Ref.Value: False

lplot_surfVSsat

Enable/disable the plotting of the surf VS. satellite Ocean fields.

Type: bool Ref.Value: False

Section set_visual_lplot

The section set_lrun contains the logical parameters to activate/deactivate specific plot.

lplotChildMesh

Enable/disable the plotting of the Child MeshMask fields.

Type: bool Ref.Value: True

lplotBat

Enable/disable the plotting of the Bathymetry fields.

Type: bool Ref.Value: True

lplotAtm

Enable/disable the plotting of the Atmspheric fields.

Type: bool Ref.Value: True

lplotOceIC

Enable/disable the plotting of the Initial Condition Ocean fields.

Type: bool Ref.Value: True

lplotOceBC

Enable/disable the plotting of the Open Boundary Condition Ocean fields.

Type: bool Ref.Value: True

lplotOceBCbdy

Enable/disable the plotting of the Open Boundary Condition Ocean fields.

Type: bool Ref.Value: True

lplotTide

Enable/disable the plotting of the Tidal fields.

Type: bool Ref.Value: True

lplotTidebdy

Enable/disable the plotting of the Tidal fields.

Type: bool Ref.Value: True

lplotOceOut

Enable/disable the plotting of the Output Ocean fields.

Type: bool Ref.Value: False

Input parameters for figure properties

Section set_lplot

The section set_visual_fileImg contains the logical parameters to .

fileImg_type

Type of the image file to generate.

Type: string Ref.Value: png

fileImg_wkWidth

Horizontal resolution (number of pixels) of the image file.

Type: int Ref.Value: 2400

fileImg_wkHeight

Vertical resolution (number of pixels) of the image file.

Type: int Ref.Value: 2400

Section set_visual_lvis

The section set_visual_lvis contains the logical parameters to .

lvis_title

Enable/disable the visibility of a given string as the main title.

Type: bool Ref.Value: True

lvis_mplotDif

Enable/disable the plotting of the Bathymetry fields.

Type: bool Ref.Value: True

lvis_leftString

Enable/disable the visibility of a given string above the plot’s upper boundary and left.

Type: bool Ref.Value: True

lvis_rightString

Enable/disable the visibility of a given string above the plot’s upper boundary and right.

Type: bool Ref.Value: True

lvis_axisLab

Enable/disable the visibility of the X an Y axis title.

Type: bool Ref.Value: True

lvis_tickmarks

Enable/disable the visibility of the right, left, top and bottom tick marks.

Type: bool Ref.Value: True

lvis_borders

Enable/disable the visibility of the right, left, top and bottom borders.

Type: bool Ref.Value: True

lvis_mapFillOn

Enable/disable the visibility of the map area fill.

Type: bool Ref.Value: True

lvis_mapOutlineOn

Enable/disable the visibility of the map area outlines.

Type: bool Ref.Value: True

lvis_vecRefAnnoOn

Enable/disable the visibility of the reference vector annotation.

Type: bool Ref.Value: True

lvis_labbarOn

Enable/disable the visibility of the LabelBar.

Type: bool Ref.Value: True

lvis_labbarLabelsOn

Enable/disable the visibility of the LabelBar.

Type: bool Ref.Value: True

lvis_panelbarOn

Enable/disable the visibility of the PannelBar.

Type: bool Ref.Value: True

lvis_infoContourOn

Enable/disable the visibility of the info contour.

Type: bool Ref.Value: True

lvis_grid

Enable/disable the visibility of the mesh grid.

Type: bool Ref.Value: True

lvis_myCoastline

Enable/disable the visibility of the user coastline.

Type: bool Ref.Value: True

lvis_fillcurves

Enables the filling of the area between two curves.

Type: bool Ref.Value: True

lvis_boxNest

Enable/disable the visibility of the nest rectangular box.

Type: bool Ref.Value: True

Section set_visual_graph

The section set_visual_graph contains the logical parameters to .

graph_projection

Projection used for the map transformation. (es. CylindricalEquidistant,Mercator,...).

Type: string Ref.Value: Mercator

graph_fillMode

How ContourPlot performs fill: (=AreaFill), (=RasterFill),(=CellFill).

Type: string Ref.Value: AreaFill

graph_minDistVec

Minimum distance (in NDC space) that is to separate the data locations of neighboring vectors.

Type: float Ref.Value: 0.015

graph_thickArrowVec

Thickness of the line used to draw vector line arrows.

Type: float Ref.Value: 2.0

graph_refMagnVecAtm

Reference magnitude used for the wind vector field.

Type: float Ref.Value: 3.0

graph_refMagnVecOce

Reference magnitude used for the current vector field.

Type: float Ref.Value: 0.6

graph_styleVec

Style of glyph used to represent the vector magnitude and direction: (=LineArrow) ... (=CurlyVector) ....

Type: string Ref.Value: CurlyVector

graph_iPlOrient

Panels orientation in the multi plots figure: (=0)vertical, (=1)horizontal.

Type: int Ref.Value: 1

graph_nlevsBar

Number of the ....

Type: int Ref.Value: 21

graph_polymarkerSize

Size used to draw the marker in the polymarker plots.

Type: float Ref.Value: 0.01

graph_markLineMode

Draw the curves using lines only (=Lines), markers only (=Markers), both lines and markers (=MarkLines).

Type: string Ref.Value: MarkLines

graph_lineThick

Thickness of the line used to draw the curves.

Type: float Ref.Value: 2.5

graph_markerSize

Size used to draw the marker in the xy-plots.

Type: float Ref.Value: 0.01

graph_markers

Style of the markers in the xy-plots.

Type: float Ref.Value: 16

graph_boxThick

Thickness of the line used to draw the box.

Type: float Ref.Value: 8.0

graph_boxColor

Color of the line used to draw the box.

Type: string Ref.Value: red

Input/Output Model Datasets

In order to execute the SURF-NEMO package, the user has to provide several input datasets. These include the bathymetry datasets containing the seafloor elevation, the coastline datasets delineating borders between land and sea areas, the initial condition dataset containing the initial values of model-predicted variables and the boundary condition datasets containing the values of the variables needed to impose the boundary conditions on flows of mass, momentum and energy for the primitive equation at the surface and lateral open boundaries of the domain. In Figure 5.1 are summarized the interfaces and the external forcings acting on a typical computational domain.

/docs/surf_nemo/assets/img/CondContorno.png — Schematized representation of the interface and external forcing acting on a typical computational domain.

Input Datasets

The input model datasets are provided in the classic NetCDF format for bathymetry, initial and lateral boundary condition. NetCDF is a widely used file format in atmospheric and oceanic research which allows storage of different types of array based data, along with a short data description. The coastline datasets are instead provided in Shapefile format, a digital vector data format for geographic information system (GIS) software. SURF allows also to use, if needed, two different model type of input data during the execution (i.e. analysis data for the spinup time and forecast data after). The user has to set-up few parameters in the configuration file setParFree.json in order to specify the values of path/filename, dimensions/variables name and characteristics of data.

Bathymetry Dataset

The bathymetry dataset contains the sea floor elevation. This dataset is required to generate the child meshmask file. The user needs to set-up the required parameters in the sections set_dataDownlBat of the configuration file. The data are distributed on a curvilinear spherical grid (regular or not) within a region containing the nested domain.

The bathymetry file contains the elevation variable (in meters) at a certain horizontal resolution. The elevation is relative to a specific reference level and can increases (positive) or decreases (negative) with increasing water depth. The coordinate variables (latitude/longitude) can be a one- or two-dimensional array. An example of CDL text representation of this file is shown in Listing 5.1.

netcdf bathymetry_filename {
dimensions:
   x = 300;
   y = 200;
variables: \\
   float lon(y,x);
      lon: units = "degrees_east";
   float lat(y,x);
      lat: units = "degrees_north";
   float elevation(y,x);
      elevation: units = "m";
}

Listing 5.1: Example of a netCDF file for bathymetry.

The user needs to specify the following logical parameters in section set_dataDownlBat_fileName of the user-configuration file:

fileBat_lcompression if the file to download is compressed (.gzip) or not,
fileBat_llonFlip if the longitude coordinate is defined in the rage [0:360] or [-180:+180],
fileBat_llatInv if the dataset contains latitude decreasing through the pole,
fileBat_ldepthIncr if the dataset contains seafloor elevation (positive) increases with increasing water depth,
fileBat_lkeepSrcFull if the original downloaded file needs to be deleted after cutted in the nested domain.

The available input bathymetry datasets inside the surf package is the General Bathymetric Chart of the Oceans (GEBCO), a publicly available bathymetry data sets with global coverage at 30 arc-second resolution.

Coastline Dataset

The coastline dataset contains borders between land and sea areas and is stored into shapefiles. The coastline is required in the child meshmask generation phase. The user needs to set-up the required parameters in the sections set_dataDownlCoast of the configuration file.

The available input coastline datasets inside the surf packages is the Global Self-consistent Hierarchical High-resolution Geography (GSHHG) dataset produced by the National Oceanic and Atmospheric Association (NOAA). The datasets include 20 shapefiles which provides a consistent set of hierarchically arranged closed polygons from which the shorelines are constructed. The GSHHS data are split into separate shapefiles at five different resolutions:

the highest resolution is designated 'f' (full) with a resolution of xx m,
the next highest appears as 'h' (high) with a resolution of xx m,
the (intermediate) 'i' with a resolution of xx m,
the (low) 'l' with a resolution of xx m,
the (coarse) 'c' with a resolution of xx m.

For each level of resolution Shorelines are organized into four levels: boundary between land and ocean (L1), boundary between lake and land (L2), boundary between island-in-lake and lake (L3), and boundary between pond-in-island and island (L4). These datasets use the geographic coordinate system WGS84 (simple latitudes and longitudes; decimal degrees)

Initial Condition Datasets

In order to start a model run, the initial values for the model prognostic variables need to be specified. These include temperature, salinity, sea surface height, zonal and meridional velocity components fields. Initial condition datasets are normally provided by coarse grid model outputs. The user needs to set-up the required parameters in the sections set_dataDownlOceIC of the configuration file. The data can be distributed on a curvilinear spherical grid (regular or not) with unstaggered or staggered Arakawa-C grid arrangement within a region containing the nested domain. The model assumes that all the input ocean variables are defined on the same grid.

The coarse-resolution ocean files contain the following variables at a certain horizontal resolution.

Potential Temperature [$C$],
Salinity [$PSU$],
Sea surface height [$m$],
Zonal velocity [$ms^{-1}$],
Meridional Velocity [$ms^{-1}$].

An example of CDL text representation of this file is shown in Listing 5.2.

netcdf fields_filename {
dimensions:
   x = 40 ;
   y = 35 ;
   z = 72 ;
   time = UNLIMITED ; // (1 currently)
variables:
   float lont(y, x) ;
      lont:units = "degrees_east" ;
   float latt(y, x) ;
      latt:units = "degrees_north" ;
   float deptht(z) ;
      deptht:units = "m" ;
   double time(time) ;
      time_counter:units = "seconds since
                   1970-01-01 00:00:00" ;
   float temperature(time, z, y, x) ;
      temperature:units = "degC" ;
}


dimensions :
x = 677;
y = 253;
z = 72;
t = UNLIMITED; // (7 currently)
variables : \\
float lont(x);
      lont: units = "degrees_east";
float latt(y);
      latt: units = "degrees_north";
float deptht(z);
      deptht: units = "m";
double time(t);
       time: units = "seconds since
                1970-01-01 00:00:00";
float temperature(t,z,y,x);
      temperature: units = "degC";
}

Listing 5.2: Example of a netCDF file for the Initial Condition temperature

In order to perform the extrapolation (SOL) of ocean fields (see section 2.3), the parent land-sea mask file needs to be provided as input datasets. The user needs to set-up the required parameters in the sections set_dataDownlOceICMesh of the configuration file.

This file contains all the information of the coarse-resolution ocean model grids and it includes the following variables:

longitude on TUVF grid points [$degree$],
latitude on TUVF grid points [$degree$],
depth on TUVF grid points [$m$],
land-sea mask on TUVF grid points [0-1],
scalefactor on TUVF grid points [$m$],
scalefactor on TUVF grid points [$m$],
scalefactor on TUVF grid points [$m$].

An example of CDL text representation of this file is shown in Listing 5.3.

netcdf meshmask_filename {
dimensions :
   x = 677;
   y = 253;
   z = 72;
   t = UNLIMITED; // (7 currently)
variables : \\
   float lon(y,x);
   float lat(y,x);
   float lev(z);
   double time(t);
   byte tmask(t,z,y,x);
   byte umask(t,z,y,x);
   byte vmask(t,z,y,x);
   byte fmask(t,z,y,x);
   float glamt(t,y,x);
   float glamu(t,y,x);
   float glamv(t,y,x);
   float glamf(t,y,x);
   float gphit(t,y,x);
   float gphiu(t,y,x);
   float gphiv(t,y,x);
   float gphif(t,y,x);
   double e1t(t,y,x);
   double e1u(t,y,x);
   double e1v(t,y,x);
   double e1f(t,y,x);
   double e2t(t,y,x);
   double e2u(t,y,x);
   double e2v(t,y,x);
   double e2f(t,y,x);
   double e3t(t,z,y,x);
   double e3u(t,z,y,x);
   double e3v(t,z,y,x);
   double e3w(t,z,y,x);
}

Listing 5.3: Example of a netCDF file for the Initial Condition meshmask.

Lateral Open Boundary Condition Datasets

In order to integrate the primitive equations, the NEMO ocean model needs to impose appropriate boundary conditions at the ocean-ocean interface (i.e. the sides of the domain not bounded by land). Lateral Open Boundary values for the model prognostic variables need to be specified for all the simulation period. These include temperature, salinity, sea surface height, and velocity fields. The user needs to set-up the required parameters in the sections set_dataDownlOceBC_preSpinup and set_dataDownlOceBC_postSpinup of the configuration file. The data can be distributed on a curvilinear spherical grid (regular or not) with unstaggered or staggered Arakawa-C grid arrangement within a region containing the nested domain. The model assumes that all the input ocean variables in pre- and post- spinup period are defined on the same grid.

The coarse-resolution ocean files contain the following variables at a certain horizontal resolution and temporal frequency.

Potential Temperature [$C$],
Salinity [$PSU$],
Sea surface height [$m$],
Zonal velocity [$ms^{-1}$],
Meridional Velocity [$ms^{-1}$].

An example of CDL text representation of this file is shown in Listing 5.4.

netcdf fields_filename {
dimensions :
   x = 677;
   y = 253;
   z = 72;
   t = UNLIMITED; // (7 currently)
variables : \\
   float lont(x);
         lont: units = "degrees_east";
   float latt(y);
         latt: units = "degrees_north";
   float deptht(z);
         deptht: units = "m";
   double time(t);
          time: units = "seconds since
                   1970-01-01 00:00:00";
   float temperature(t,z,y,x);
         temperature: units = "degC";
}

Listing 5.4: Example of a netCDF file for Open boundary Condition temperature.

This file contains all the information of the coarse-resolution ocean model grids and it includes the following variables:

longitude on TUVF grid points [$degree$],
latitude on TUVF grid points [$degree$],
depth on TUVF grid points [$m$],
land-sea mask on TUVF grid points [0-1],
scalefactor on TUVF grid points [$m$],
scalefactor on TUVF grid points [$m$],
scalefactor on TUVF grid points [$m$].

An example of CDL text representation of this file is shown in Listing 5.5.

netcdf meshmask_filename {
dimensions :
   x = 677;
   y = 253;
   z = 72;
   t = UNLIMITED; // (7 currently)
variables : \\
   float lon(y,x);
   float lat(y,x);
   float lev(z);
   double time(t);
   byte tmask(t,z,y,x);
   byte umask(t,z,y,x);
   byte vmask(t,z,y,x);
   byte fmask(t,z,y,x);
   float glamt(t,y,x);
   float glamu(t,y,x);
   float glamv(t,y,x);
   float glamf(t,y,x);
   float gphit(t,y,x);
   float gphiu(t,y,x);
   float gphiv(t,y,x);
   float gphif(t,y,x);
   double e1t(t,y,x);
   double e1u(t,y,x);
   double e1v(t,y,x);
   double e1f(t,y,x);
   double e2t(t,y,x);
   double e2u(t,y,x);
   double e2v(t,y,x);
   double e2f(t,y,x);
   double e3t(t,z,y,x);
   double e3u(t,z,y,x);
   double e3v(t,z,y,x);
   double e3w(t,z,y,x);
}

Listing 5.5: Example of a netCDF file for the Initial Condition meshmask.

Tidal Datasets for the open boundaries

For the barotropic solution, there is also the option to use tidal harmonic forcing at open boundaries in addition to other external data. These include the constituents for amplitude and phase of surface height and velocity. The user needs to set-up the required parameters in the sections set_dataDownlTide of the configuration file. The data are distributed on a regular curvilinear spherical grid with unstaggered or staggered Arakawa-C grid arrangement within a region containing the nested domain. The model assumes that all the input tidal harmonic variables are defined on the same grid.

The barotropic tide files contain for each harmonic constituents the following variables at a certain horizontal resolution.

Tidal elevation complex amplitude, Real and Imaginary part [$mm$],
Tidal WE transport complex amplitude, Real and Imaginary part [$cm^2/s$],
Tidal SN transport complex amplitude, Real and Imaginary part [$cm^2/s$],

An example of CDL text representation of this file is shown in Listing 5.6.

netcdf uv.k1_tpxo8_atlas_30c_v1 {
dimensions:
   nx = 10800 ;
   ny = 5401 ;
variables:
   double lon_u(nx) ;
      lon_u:units = "degree_east" ;
   double lat_u(ny) ;
      lat_u:units = "degree_north" ;
   double lon_v(nx) ;
      lon_v:units = "degree_east" ;
   double lat_v(ny) ;
      lat_v:units = "degree_north" ;
   int uRe(nx, ny) ;
      uRe:units = "centimeter^2/sec" ;
   int uIm(nx, ny) ;
      uIm:units = "centimeter^2/sec" ;
   int vRe(nx, ny) ;
      vRe:units = "centimeter^2/sec" ;
   int vIm(nx, ny) ;
      vIm:units = "centimeter^2/sec" ;
}

Listing 5.6: Example of a netCDF file for the Zonal and meridional Tidal transport for the constituent K1.

The tidal model bathymetry file needs to be provided as input datasets. The user needs to set-up the required parameters in the sections set_dataDownlTideMesh of the configuration file.

This file contains all the information of the tidal model grids and depth grid and it includes the following variables:

longitude on TUV grid points [$degree$],
latitude on TUV grid points [$degree$],
Bathymetry at TUV grid points [$m$].

An example of CDL text representation of this file is shown in Listing 5.7.

netcdf grid_tpxo8atlas_30_v1 {
dimensions:
   nx = 10800 ;
   ny = 5401 ;
variables:
   double lon_z(nx) ;
      lon_z:units = "degree_east" ;
   double lat_z(ny) ;
      lat_z:units = "degree_north" ;
   double lon_u(nx) ;
      lon_u:units = "degree_east" ;
   double lat_u(ny) ;
      lat_u:units = "degree_north" ;
   double lon_v(nx) ;
      lon_v:units = "degree_east" ;
   double lat_v(ny) ;
      lat_v:units = "degree_north" ;
   float hz(nx, ny) ;
      hz:units = "meter" ;
   float hu(nx, ny) ;
      hu:units = "meter" ;
   float hv(nx, ny) ;
      hv:units = "meter" ;
}

Listing 5.7: Example of a netCDF file for the Initial Condition meshmask.

The available input barotropic tide datasets inside the surf packages are derived from the Topex Poseidon cross-over (TPX08-ATLAS) global inverse tide model obtained with the software package OTIS (OSU Tidal Inversion Software) implementing methods described in Egbert and Erofeeva, 2002. The TPX08 tidal model consists of a multi-resolution bathymetric grid solution, with a 1/6 solution in the global open ocean, and a 1/30 local resolution solution to improve modelling in complex shallow-water environments. It includes complex amplitudes of the tide sea-surface elevations and transports for eight primaries (M2, S2, N2, K2, K1, O1, P1, Q1), two long-period (Mf, Mm) and 3 non-linear (M4, MS4, MN4) harmonic constituents.

Atmospheric Forcing Datasets

In order to integrate the primitive equations, the NEMO ocean model needs to impose appropriate boundary conditions on flows of mass, momentum and energy at the atmosphere-ocean interface. It must be provided on the integration domain the following six fields:

the zonal components of the surface ocean stress,
the meridional components of the surface ocean stress,
the heat fluxes from solar Qsr,
the heat fluxes from non-solar Qns radiation,
the water flows exchanged with the atmosphere (E-P) (the evaporation minus precipitation budget).

In addition an optional field:

the atmospheric pressure at the ocean surface (pa).

The NEMO ocean model provides different ways to provide the first six fields to the ocean which are controlled by namelist variables (see NEMO Manual). The choice of the atmospheric forcing formulation in SURF platform is obtained by setting the parameter sbc_iformulat in the user configuration file:

sbc_iformulat=0 for the MFS bulk formulae,
sbc_iformulat=1 for the the Flux formulation,
sbc_iformulat=2 for the CORE bulk formula.

The data are distributed on a regular unstaggered grid within a region containing the nested domain. The model assumes that input atmospheric variables in pre- and post- spinup period are defined on the same mesh but allowed different mesh for different variables. The user needs to set-up the required parameters in the sections set_dataDownlAtm_preSpinup and set_dataDownlAtm_postSpinup of the configuration file.

(1) The choice of MFS bulk formulae is obtained by setting the parameter sbc_iformulat=0 in the user configuration file.

The atmospheric forcing files contain the following variables at a certain horizontal resolution and temporal frequency:

10 m zonal wind component [$ms^{-1}$],
10 m meridional wind component [$ms^{-1}$],
2m Air Temperature [$K$],
2m Dew Point Temperature [$K$],
Mean Sea Level Pressure [$hPa$],
Total Cloud Cover [%].
Total Precipitation [$Kgm^{-2}s^{-1}$].

An example of CDL text representation for the atmospheric forcing file with temporal frequency of 3 hours is shown in box in Listing 5.8.

netcdf atmFields_filename {
dimensions :
   lon = 245;
   lat = 73;
   time = UNLIMITED; // (8 currently)
variables : \\
   float lon(lon);
         lon: units = "degrees_east";
   float lat(lat);
         lat: units = "degrees_north";
   float time(time);
         time: units = "seconds since
                  1970-01-01 00:00:00";
   float T2M(time,lat,lon);
         T2M: units = "K";
}

Listing 5.8: Example of a netCDF file for the Atmospheric Forcing temperature.

(2) The choice of Core bulk formulae is obtained by setting the parameter sbc_iformulat=2 in the user configuration file.

The atmospheric forcing files contain the following variables at a certain horizontal resolution and temporal frequency:

10 m zonal wind component [$ms^{-1}$],
10 m meridional wind component [$ms^{-1}$],
2m Temperature [$K$],
2m Specific humidity [$\%$],
Incoming long-wave radiation [$W m^{-2}$],
Incoming short-wave radiation [$W m^{-2}$],
Total precipitation (liquid+solid) [$Kg m^{-2} s^{-1}$],
Solid precipitation [$Kg m^{-2} s^{-1}$].

An example of CDL text representation for the atmospheric forcing file with temporal frequency of 3 hours is shown in box in Listing 5.9.

netcdf atmFields_filename {
dimensions :
   lon = 245;
   lat = 73;
   time = UNLIMITED; // (8 currently)
variables : \\
   float lon(lon);
         lon: units = "degrees_east";
   float lat(lat);
         lat: units = "degrees_north";
   float time(time);
         time: units = "seconds since
                  1970-01-01 00:00:00";
   float T2M(time,lat,lon);
         T2M: units = "K";
}

Listing 5.9: Example of a netCDF file for the Atmospheric Forcing temperature.

(3) The choice of Flux formulation is obtained by setting the parameter sbc_iformulat=1 in the user configuration file.

The atmospheric forcing files contain the following variables at a certain horizontal resolution and temporal frequency:

Zonal wind stress [0 - 1],
Meridional Wind stress [0 - 1],
Total heat flux [0 - 1],
Solar Radiation Penetration [0 - 1],
Mass flux exchanged [0 - 1],
Surface Temperature [0 - 1],
Surface Salinity [0 - 1].

An example of CDL text representation for the atmospheric forcing file with temporal frequency of 3 hours is shown in box in Listing 5.10.

netcdf atmFields_filename {
dimensions :
   lon = 245;
   lat = 73;
   time = UNLIMITED; // (8 currently)
variables : \\
   float lon(lon);
         lon: units = "degrees_east";
   float lat(lat);
         lat: units = "degrees_north";
   float time(time);
         time: units = "seconds since
                  1970-01-01 00:00:00";
   float T2M(time,lat,lon);
         T2M: units = "K";
}

Listing 5.10: Example of a netCDF file for the Atmospheric Forcing temperature.

In order to perform the extrapolation (SOL) of atmospheric fields (see section 2.3), the atmospheric meshmask file needs to be provided as input datasets. The user needs to set-up the required parameters in the sections set_dataDownlAtmMesh of the configuration file.

The atmospheric meshmask file contains the land-sea mask [0-1] variable.

An example of CDL text representation of the atmospheric land-sea mask is shown in Listing 5.11. The time dimension and coordinate variable can also be omitted.

netcdf meshmask_filename {
dimensions :
   lon = 245;
   lat = 73;
   time = UNLIMITED; // (1 currently)
variables : \\
   float lon(lon);
         lon: units = "degrees_east";
   float lat(lat);
         lat: units = "degrees_north";
   float time(time);
         time: units = "seconds since
                  1970-01-01 00:00:00";
   float LSM(time,lat,lon);
         LSM: units = "0-1";
}

Listing 5.11: Example of a netCDF file for the Atmospheric Forcing meshmask.

Output Datasets

The output model datasets are provided in the NetCDF format .. the meshmask file, the output files for T, U ,V, W grids and the restart file.

Meshmask dataset

This file contains all the information of the child ocean model grids and it includes the following variables:

longitude on TUVF grid points [$degree$],
latitude on TUVF grid points [$degree$],
depth on TUVF grid points [$m$],
land-sea mask on TUVF grid points [0-1],
scalefactor on TUVF grid points [$m$],
scalefactor on TUVF grid points [$m$],
scalefactor on TUVF grid points [$m$].

An example of CDL text representation of this file is shown in Listing 5.21.

netcdf meshmask_filename {
dimensions :
   x = 677;
   y = 253;
   z = 72;
   t = UNLIMITED; // (7 currently)
variables : \\
   float lon(y,x);
   float lat(y,x);
   float lev(z);
   double time(t);
   byte tmask(t,z,y,x);
   byte umask(t,z,y,x);
   byte vmask(t,z,y,x);
   byte fmask(t,z,y,x);
   float glamt(t,y,x);
   float glamu(t,y,x);
   float glamv(t,y,x);
   float glamf(t,y,x);
   float gphit(t,y,x);
   float gphiu(t,y,x);
   float gphiv(t,y,x);
   float gphif(t,y,x);
   double e1t(t,y,x);
   double e1u(t,y,x);
   double e1v(t,y,x);
   double e1f(t,y,x);
   double e2t(t,y,x);
   double e2u(t,y,x);
   double e2v(t,y,x);
   double e2f(t,y,x);
   double e3t(t,z,y,x);
   double e3u(t,z,y,x);
   double e3v(t,z,y,x);
   double e3w(t,z,y,x);
}

Listing 5.21: CDL example for the meshmask datasets.

Ocean Output Datasets

…contains:

(1) This output file SURF_1h_YYYYMMDD0_YYYYMMDD1_grid_T contains hourly fields defined on the Arakawa-T grid within the chid nested domain.

This file contains the following variables:

Temperature [$C$],
Salinity [$PSU$],
Sea Surface temperature [$C$],
Sea Surface salinity [$PSU$],
Sea Surface Height [$m$],
Net Upward Water Flux [$Kg=m2=s$],
concentration/dilution water flux [$Kg=m2=s$],
Surface Salt Flux [$Kg=m2=s$],
Net Downward Heat Flux [$W=m2$],
Shortwave Radiation [$W=m2$],
Turbocline Depth [$m$],
Mixed Layer Depth 0.01 [$W=m2$],
Ice fraction [$0;1$],
wind speed at 10m [$m=s$],
Surface Heat Flux: Damping [$W=m2$],
Surface Water Flux: Damping [$Kg=m2=s$],
Surface salt flux: damping [$Kg=m2=s$],
Bowl Index[$W point$].

An example of CDL text representation of this file is shown in Listing 5.22.

netcdf fields_filename {
dimensions :
   lon = 677;
   lat = 253;
   depth = 72;
   time = UNLIMITED; // (7 currently )
variables : \\
   float lont (x);
         lont : units = " degrees_east ";
   float latt (y);
         latt : units = " degrees_north ";
   float deptht (z);
         deptht : units = "m";
   double time (t);
         time : units = " seconds since
                   1970-01-01 00:00:00";
   float temperature (t, z, y, x);
         temperature : units = " degC ";
}

Listing 5.22: CDL example for the bdyV_u3d data.

(2) This output file SURF_1h_YYYYMMDD0_YYYYMMDD1_grid_U contains hourly fields defined on the Arakawa-U grid within the chid nested domain.

This file contains the following variables:

Zonal Current [$m/s$],
Wind Stress along zonal-axis [$N/m^2$],

An example of CDL text representation of this file is shown in Listing 5.23.

netcdf fields_filename {
dimensions :
   lon = 677;
   lat = 253;
   depth = 72;
   time = UNLIMITED; // (7 currently )
variables : \\
   float lont (x);
         lont : units = " degrees_east ";
   float latt (y);
         latt : units = " degrees_north ";
   float deptht (z);
         deptht : units = "m";
   double time (t);
         time : units = " seconds since
                   1970-01-01 00:00:00";
   float temperature (t, z, y, x);
         temperature : units = " degC ";
}

Listing 5.23: CDL example for the bdyV_u3d data.

(3) This output file SURF_1h_YYYYMMDD0_YYYYMMDD1_grid_V contains hourly fields defined on the Arakawa-V grid within the chid nested domain.

This file contains the following variables:

Meridional Current [$m/s$],
Wind Stress along meridional-axis [$N/m^2$],

An example of CDL text representation of this file is shown in Listing 5.23.

netcdf fields_filename {
dimensions :
   lon = 677;
   lat = 253;
   depth = 72;
   time = UNLIMITED; // (7 currently)
variables : \\
   float lont(x);
         lont: units = "degrees_east";
   float latt(y);
         latt: units = "degrees_north";
   float deptht(z);
         deptht: units = "m";
   double time(t);
         time: units = "seconds since
                  1970-01-01 00:00:00";
   float temperature(t,z,y,x);
         temperature: units = "degC";
}

Listing 5.24: CDL example for the bdyV_u3d data.

(4) This output file SURF_1h_YYYYMMDD0_YYYYMMDD1_grid_W contains hourly fields defined on the Arakawa-W grid within the chid nested domain.

This file contains the following variables:

Vertical velocity [$m/s$],
Vertical Eddy Viscosity [$m^2/s$],
Vertical Eddy Diffusivity [$m^2/s$].

An example of CDL text representation of this file is shown in Listing 5.23.

netcdf fields_filename {
dimensions :
   lon = 677;
   lat = 253;
   depth = 72;
   time = UNLIMITED; // (7 currently)
variables : \\
   float lont(x);
         lont: units = "degrees_east";
   float latt(y);
         latt: units = "degrees_north";
   float deptht(z);
         deptht: units = "m";
   double time(t);
         time: units = "seconds since
                  1970-01-01 00:00:00";
   float temperature(t,z,y,x);
         temperature: units = "degC";
}

Listing 5.24: CDL example for the bdyV_u3d data.

Restart dataset

The restart file can be used as initial conditions for research ...

This file contains all the information of the child ocean model grids and it includes the following variables:

longitude on TUVF grid points [$degree$],
latitude on TUVF grid points [$degree$],
depth on TUVF grid points [$m$],

An example of CDL text representation of this file is shown in Listing 5.21.

netcdf SURF_restart_20141005 {
dimensions:
	x = 94 ;
	y = 79 ;
	z = 120 ;
	t = UNLIMITED ; // (1 currently)
variables:
	float nav_lon(y, x) ;
	float nav_lat(y, x) ;
	float nav_lev(z) ;
	double time_counter(t) ;
	double kt ;
	double ndastp ;
	double adatrj ;
	double utau_b(t, y, x) ;
	double vtau_b(t, y, x) ;
	double qns_b(t, y, x) ;
	double emp_b(t, y, x) ;
	double sfx_b(t, y, x) ;
	double sbc_hc_b(t, y, x) ;
	double sbc_sc_b(t, y, x) ;
	double qsr_hc_b(t, z, y, x) ;
	double fraqsr_1lev(t, y, x) ;
	double rdt ;
	double rdttra1 ;
	double ub(t, z, y, x) ;
	double vb(t, z, y, x) ;
	double tb(t, z, y, x) ;
	double sb(t, z, y, x) ;
	double rotb(t, z, y, x) ;
	double hdivb(t, z, y, x) ;
	double sshb(t, y, x) ;
	double un(t, z, y, x) ;
	double vn(t, z, y, x) ;
	double tn(t, z, y, x) ;
	double sn(t, z, y, x) ;
	double rotn(t, z, y, x) ;
	double hdivn(t, z, y, x) ;
	double sshn(t, y, x) ;
	double rhop(t, z, y, x) ;
}

Listing 5.21: CDL example for the meshmask datasets.

Quick Start Guide

This chapter describes how you can quickly get started with the SURF platform. We show how to download and install the SURF Virtual Machine and all the SURF packages. We describe how to compile (if needed) the source codes. We present how to execute a case study (template) experiment in the Gulf of Taranto and view the results. Finally we show how the user-configuration file of a template experiment can be modified in order to execute and analysis new experiments. The template experiment makes it easier to run the model without detailed knowledge of the underlying scientific basis. Only a limited number of default values need to be changed for most applications. A more specific scientific background is required if for example, the user intends to perform experiments with different turbulence or numerical schemes or with alternative settings of model parameters. It is then recommended to read first the NEMO Model Description document and relative article.

See also the video tutorials available online here explain the basic features of the SURF platform and designed for beginners who want to learn SURF step by step.

Download and Install SURF Virtual Machine

The SURF platform will be provided as a Virtual Machine (VM). It is packaged and distributed as a ZIP Compressed Archive file (with a .zip extension). The general scheme adopted to manage the versions provides that the releases contain in the name indications of the version in the format:


            surf_vm_VERSION.zip

where VERSION is a number (e.g. surf_vm_1.01.zip for the current version). The instructions below explain how to download, install and configure the SURF VM in Oracle VirtualBox

Navigate to https://www.virtualbox.org/ and click on Downloads button. Choose the VirtualBox base package (version >=6) corresponding to the host operating system of your computer (i.e. Windows, Mac, Linux). Save the corresponding file on your computer, double-click it to open it, and follow the installation instructions.

/docs/surf_nemo/assets/img/VM_install_VitualBoxsite_v2.png — Downloads VirtualBox base package.

In addition to the base package, download also the Extension Packs. This package provides additional functionality to the base package, such as virtual USB device, remote desktop support, ecc. To install this extension, simply double-click on the package file and follow the installation instructions. Please install the same version extension pack as your installed version of the VirtualBox base package.

/docs/surf_nemo/assets/img/VM_install_VirtualBoxExtentionPacks.png — Downloads VirtualBox Extension Packs.

Download the current version (v1.01) of the SURF virtual machine from SURF web-page. In the virtual machines is installed the Debian GNU/Linux 8.11 operating system. The Guest Additions have been also installed to optimize the guest operating system for better performance and usability. Extract than the package in your VirtualBox directory which Oracle VM VirtualBox creates in the current system user's home directory (i.e. /Users/USERNAME/VirtualBox VMs/ for Mac user).
unzip surf_1.01.zip

/docs/surf_nemo/assets/img/VM_install_downlVMsurf.png — Downloads SURF Virtual Machine.

Open the VirtualBox software. From the menu, choose Machine > add and navigate to the file surf.vbox. This file is an XML file that contains settings of the Machine. This will add the Virtual Machine surf to the list of Virtual Machine

/docs/surf_nemo/assets/img/VM_install_openVMsurf.png — Add SURF-VM in VirtualBox.

To start the VM surf, you can double-click on its entry in the list in the VirtualBox Manager window or select its entry and press the Start button at the top of the window. A window opens. The VM Login should look like the figure 6.5 . In the login dialogue box enter:
- surf as login
- surf2019 as an initial password
You are now logged into the VM.

/docs/surf_nemo/assets/img/VM_install_login.png — Start SURF-VM.

Disk Partitions mounted on the SURF Virtual Machine

The SURF Virtual Machine package contains two VDI (VirtualBox Disk Image) files:

surf.vdi containing the Debian GNU/Linux operating system (version 10.3)
surf_scratch.vdi thought to contain source code files, datasets sample and experiments.

From the guest operating system you can see the list of partitions by typing the following command:


            sudo fdisk -l

It is divided into two main partitions:

the disk /dev/sda "mounted" as filesystems to the root directory /
the disk /dev/sdb "mounted" in the directory /scratch.

Optionally you can mount other physical hard disks with VirtualBox (see the VirtualBox Manual for details). VirtualBox has the ability to mount a shared folder between host and guest in order to access files of your host system from within the guest system. There are a few steps involved:

Shut down the virtual OS before you can edit settings.
Select the surf VM in the VirtualBox Manager and click Settings.
Select Shared Folders, and click the Plus button to add a new shared folder. Specify the host folder you want to share.
Select auto-mount and then click OK.
You can now re-start the VM surf. The shared folder is mounted into the /media directory, along with the prefix "sf_".

/docs/surf_nemo/assets/img/VM_install_sharefolder.png — Mount shared folders.

Changing Configuration on the SURF Virtual Machine

By default, the VM surf is configurated as in table Table 6.1 . You can keep all defaults parameters or if it is not adequate for your application you can change settings. To change the configuration you need to shut down the virtual OS before you can edit settings.

Select the surf VM in the VirtualBox Manager, right-click it and choose Setting.
increase/decrease the number of cores based on your performance desires.
increase/decrease the number of GB of RAM allocated to your VM according to the size of your computational domain.
increase/decrease the video memory and scale factor of your screen

/docs/surf_nemo/assets/img/VM_install4.png — Change VM configurations.

If you want to add more storage space to a VM you can also expande the virtual hard disk. There are a few steps involved:

With the VM Power off, open a terminal and move to the location of the surf_scratch.vdi file that you want to resize,
At the terminal prompt, type the command:, VBoxManage modifyhd surf_scratch.vdi --resize SIZE_MB

/docs/surf_nemo/assets/img/VM_install5.png — Enlarge the virtual disk.

Restart the SURF VM and open the GParted application from the Application Menu
Select the /dev/sdb partition (an unlocated drive space is now available). Resize to the unalocated area

Table 6.1 Virtual Machine Summary Fields.
Parameter	Description	Values
Name	Name given the VM	surf
Guest OS	Operating system running on this VM	Debian Linux
Memory	Amount of memory available to this VM	2 [GB]
Cores	Number of CPU cores being used by this VM	2
Disk Capacity	Total disk capacity available to this VM	40 [GB]
Network Adapters	Number of network adapters available to this VM	1
IP Address	IP address assigned to the VM	x

Download and Install SURF packages

Once logged in, open a new terminal window and go to the directory /scratch. The scratch directory follows the directory structure as shown in Fig. B.1. The VM you have installed does not contain the SURF packages (source codes and static datasets) and you need to download and install them. The SURF packages are packaged and distributed as a GZIP Compressed Tar Archive file (with a .tar.gz extension). The general scheme adopted to manage the versions provides that the releases contain in the name indications of the version in the format:

packageName_<VERSION>.tar.gz

where <VERSION> is a number (e.g. surf_nemo_1.01.tar.gz for the current version of the surf_nemo package). The instructions below explain how to install the package in the VM:

Once logged in the VM surf, download the current version of the SURF-NEMO (surf_nemo_1.01.tar.gz) and SURF-DATASETS (surf_datasets_1.01.tar.gz) packages directly from the SURF web-page and save it in the directory /scratch/surf/surf_install/releases/ (for simplicity, we abbreviate this location as $SURF_RELEASES).
Go to the directory $SURF_RELEASES and run the installation bash script install.sh followed by the package name. For the SURF-NEMO packages type:
cd $SURF_RELEASES ; install.sh surf_nemo_1.01.tar.gz
For the SURF-DATASETS packages type:
cd $SURF_RELEASES ; install.sh surf_datasets_1.01.tar.gz
The installation process will extract the archive in the directory /scratch/surf/surf_nemo/ and /scratch/surf/surf_datasets/, respectively, and will create a symbolic link current in this directory that points to the extracted folder (for simplicity, we abbreviate this location as $SURF_NEMO, $SURF_DATASETS, respectively).

For a detailed description of the directory structure and contents of each package refer to the Appendix B.

Compiling the source code

After the installation of the SURF-NEMO package is finished, you need to compile the source codes in order to create the executable files needed to perform specific tasks. The executable files should not be recreated unless you need to modify the source code. The compilation is performed with the Unix/Linux make utility using the following tools: (1) fortran 90 compiler, (2) C-preprocessor cpp, (3) a compiled MPI library for simulations in parallel mode. (4) a compiled netCDF library to read and write data in portable netCDF format. All these tools are already present and compiled in the SURF platform.

To compile the source codes go to the directory /scratch/surf/surf_nemo/current/scripts/ and run the compilation bash script compile.sh followed by the package name (or by the word 'all' to compile all the packages):


         cd  /scratch/surf/surf_nemo/current/scripts;  ./compile_codes.sh all

Compilation could take a few minutes and it will create the executable files for each program present in the SURF-NEMO package.

Running the case study: Gulf of Taranto

As case study we implement the SURF platform in the Gulf of Taranto in the northern Ionian Sea (fig xx). The nesting simulation starts on 5 October 2014 at 00:00 and run until 7 October 2014 at 24:00. In order to execute this case study experiment, you can follow these steps:

Download the input datasets (gulfTaranto_20141005.tar.gz) of this case study directly from the web-repository (https://www.surf-platform.org) and extract it in the directory /scratch/surf/indata_offline/
tar -zxvf gulfTaranto_20141005.tar.gz
Note If you want to change the local repository path to some other location of your choice make sure to change the path in the configuration file.
Create a new folder in the directory /scratch/from_GUI/ and let's call it gulfTaranto_20141005. This is the Experiment ID name which uniquely identifies the experiment.
cd /scratch/from_GUI/; mkdir gulfTaranto_20141005
Copy the template configuration file /scratch/surf/surf_nemo/current/setParFree.json in the directory /scratch/from_GUI/gulfTaranto_20141005/ which contains the configuration for this case study.
necd; cp setParFree.json /scratch/from_GUI/gulfTaranto_20141005/
After that, from the directory /scratch/surf/surf_nemo/current/scripts/, you just need to execute the Julia script run_exp.jl followed by the experiment ID gulfTaranto_20141005
julia run_exp.jl gulfTaranto_20141005
This will create the folder gulfTaranto_20141005 in the directory /scratch/surf/experiments/ with a directory tree as in fig.x.1 (refer to the Appendix B for more details)

You can activate/deactivate specific tasks by setting logical parameters to True/False in the section set_lrun of the configuration file setParFree.json

lrun_childMeshmask to enable the execution of the CHILD-MESHMASK GENERATION task.

lrun_regridPreAtm to enable the execution of the ATMOSPHERIC-DATA-REGRIDDING task.

lrun_regridPreOceIC to enable the execution of the OCEAN-IC-DATA-REGRIDDING task.

lrun_regridPreOceBC to enable the execution of the OCEAN-BC-DATA-REGRIDDING task.

lrun_regridPreWeights if you want to compute (=True) or just copy (=False) the WEIGHT-FILEs for REMAPPING in the Regridding phase.

lrun_ocean to enable the execution of the NEMO code.

{
"id":"A001","title":"set_lrun",
"items": [
      {"name": "lrun_childMeshMask",
      "value": "True"
      },
      {"name": "lrun_regridPreAtm",
      "value": "True"
      },
      {"name": "lrun_regridPreOceIC",
      "value": "True"
      },
      {"name": "lrun_regridPreOceBC",
      "value": "True"
      },
      {"name": "lrun_regridPreWeights",
      "value ": "True"
      },
      {"name": "lrun_ocean",
      "value": "True"
      }
   ]
}

Post-processing the results

The surf package is provided together with open source tools for data visualization and post-processing your data. You will find the free software packages NcView with a graphical user interface and a suite of procedure using NCAR Graphics package with NCL and Python interface you can call from Command Line.

However, it is very well possible to use other (free or commercial) graphic software such as Pynoply or several scripting languages such as Julia, IDL, Matlab, as long as they can read the netCDF format.

Visualizing the results with Ncview

Ncview is a tool for visualizing netCDF data files. It is very easy to use, because of its graphical user interface. However, its possibilities are limited. Typically you would use ncview to get a quick and easy, push-button look at your netCDF files. You can view simple movies of the data, view along various dimensions, take a look at the actual data values, change colour maps, invert the data, etc. In order to start this program type ncview followed by the filename of the dataset you want to visualize, example type the following command


            ncview SURF_1h_20141006_20141006_grid_T.nc

An example of the user interface in NcView is given in figure Fig. 6.7

/docs/surf_nemo/assets/img/ncview.png — Screenshot of using NcView.

Analyzing and Visualizing results using NCAR graphic packages

NCAR Graphics is a collection of graphics libraries that support the display of scientific data. One possible interface available for visualizing data with these libraries is with the NCAR Command Language (NCL), an open-source interpreted programming language, developed at NCAR and designed for the analysis and visualization of geoscientific data.

The SURF-NEMO package include, as postprocessing, a suite of NCL functions to visualize the input/output datasets, compare the child/parent fields, compare the simulation result with in-situ or satellite datasets and convert datasets.

/docs/surf_nemo/assets/img/velxy_z000_t035.png — (A) Surface current.

/docs/surf_nemo/assets/img/tempxy_z000_t035.png — (A) Surface current.

In order to Post-processing the results of an existing experiment, you need to execute the Julia script run_postProc.jl followed by the experiment ID. Example for the case study experiment type the following command:


            julia run_postproc.jl gulfTaranto_20141005

You can activate/deactivate specific tasks by setting logical parameters to True/False in the sections set_lrun_post and set_visual_lplot of the configuration file setParFree.json

lrun_visDom to enable the plotting of the user-defined domains.

lrun_visIndata to enable the plotting of the Indata Bat, Atm, OceIC, OceBC fields.

lrun_visExtrapdata to enable the plotting of the Extrapdata Atm, OceIC, OceBC fields.

lrun_visRegriddata to enable the execution of the OCEAN-IC-DATA-REGRIDDING task.

lrun_visOutdata to enable the execution of the OCEAN-BC-DATA-REGRIDDING task.

lrun_chlVSpar if you want to compute (=True) or just copy (=False) the WEIGHT-FILEs for REMAPPING in the Regridding phase.

lrun_surfVSctd enables the execution of the NEMO code.

lrun_surfVSsat enables the execution of the NEMO code.

lrun_surfVSmooring enables the execution of the NEMO code.

lrun_surfVSferrybox enables the execution of the NEMO code.

{
  "id":"B000","title":"set_lrun_post",
  "items": [
     {"name": "lrun_visDom",
     "value": "True"
     },
     {"name": "lrun_visIndata",
     "value": "True"
     },
     {"name": "lrun_visExtrapdata",
     "value": "True"
     },
     {"name": "lrun_visRegriddata",
     "value": "True"
     },
     {"name": "lrun_visOutdata",
     "value ": "True"
     },
     {"name": "lrun_chlVSpar",
     "value": "True"
     },
     {"name": "lrun_surfVSctd",
     "value": "True"
     },
     {"name": "lrun_surfVSsat",
     "value": "True"
     },
     {"name": "lrun_surfVSmooring",
     "value": "True"
     },
     {"name": "lrun_surfVSferrybox",
     "value": "True"
     }
  ]
}

lplotMesh to enable plotting of the Child MeshMask fields.

lplotBat to enable the plotting of the Bathymetry fields.

lplotAtm to enable the plotting of the Atmospheric fields.

lplotOceIC to enable the plotting of the Initial Condition Ocean fields.

lplotOceBC to enable the plotting of the Open Boundary Condition Ocean fields.

lplotOceBCbdy to enable the plotting of the Open Boundary Condition Ocean fields.

lplotOceOut to enable the plotting of the Output Ocean fields.

{
   "id":"B001","title":"set_visual_lplot",
      "items": [
      {"name": "lplotMesh",
      "value": "True"
      },
      {"name": "lplotBat",
      "value": "True"
      },
      {"name": "lplotAtm",
      "value": "True"
      },
      {"name": "lplotOceIC",
      "value": "True"
      },
      {"name": "lplotOceBC",
      "value": "True"
      },
      {"name": "lplotOceBCbdy",
      "value": "True"
      },
      {"name": "lplotOceOut",
      "value": "True"
      }
   ]
}

Make a new experiments

Let's assume you want to study the circulation of the Sermilik fjord in Greenland from 1 February 2017 at 00:00 to 7 February 2017 at 24:00 ... add more details.

Choose the name of experiment ID (e.g. greenlandFjord_20170201) and create the folder
cd /scratch/from_GUI/ ; mkdir greenlandFjord_20170201
Copy the template configuration file /scratch/surf/surf_nemo/current/setParFree.json in the directory /scratch/from_GUI/greenlandFjord_20170201
cp /scratch/surf/surf_nemo/current/setParFree.json ./greenlandFjord_20170201/
Modify the user configuration file setParFree.json according to your needs
param1 = xxx param2 = xxx param3 = xxx param4 = xxx
From the directory /scratch/surf/surf_nemo/current/scripts/, execute the Julia script run_exp.jl followed by the experiment ID greenlandFjord_20170201
cd /scratch/surf/surf_nemo/current/scripts/ ; julia run_exp.jl greenlandFjord_20170201
After running the simulation, you can display the simulation results by using the Julia script run_postproc.jl followed by the experiment ID greenlandFjord_20170201
julia run_postproc.jl greenlandFjord_20170201

In principle you can simply use the template model and modify it to your needs, and not be too much concerned with the input files they create. But our advice is never to use the template model as black boxes. It is therefore important to understand how the codes work, which options they have and how their input files are structured.

Multiple downscaling experiments

SURF-NEMO package includes multiple nesting capability (i.e. consecutive nested models can be implemented with increasing grid resolutions). Let's assume you want to downscale from an existing experiment (e.g. from the template experiment gulfTaranto_20141005) in order to increase the spatial resolution to 800m ... add details.

Go to the existing experiment directory
cd /scratch/surf/experiments/gulfTaranto_20141005/
Modify the user configuration file setParFree.json according to your needs
param1 = xxx param2 = xxx param3 = xxx param4 = xxx
From the directory /scratch/surf/experiments/gulfTaranto_20141005/code/ocean/scripts/, execute the Julia script run_exp.jl followed by the experiment ID gulfTaranto_20141005
cd /scratch/surf/experiments/gulfTaranto_20141005/code/ocean/scripts/ ; julia run_exp.jl gulfTaranto_20141005
After running the simulation, you can display the simulation results by using the julia script run_postproc.jl followed by the experiment ID gulfTaranto_20141005
julia run_postproc.jl gulfTaranto_20141005

A. Reference Configuration

A.1. Reference Configuration for NEMO

Part of the input model parameters are fixed and defined inside the SURF source package in the file 'setParFix:ncl'..... The Monotonic Upstream Scheme for Conservation Laws (MUSCL) was used for the tracer advection and the Energy and Enstrophy conservative (EEN) scheme was used for the momentum advection (Arakawa and Lamb 1981; Barnier et al. 2006). No-slip conditions on closed lateral boundaries were applied and the bottom friction was param- eterised by a quadratic function.

B. Scratch Partition and its directory structures

As shown in chapter 6.1.1 the VM surf is divided into two partitions: the disk /dev/sda "mounted" in the root directory / and the disk /dev/sdb "mounted" in the directory /scratch. The scratch partition contains all the SURF packages and follows the directory structure as shown in figure B.1: The up-to-date version release is structured as follow:

The directory surf_install/ contains the utilities necessary to manage all the operations of creation and installation of each package of the SURF platform.
The directory surf_datasets/ contains a list of static input datasets needed to run the SURF_NEMO package. With 'static' we mean here datasets which do not depend on the selected simulation period; i.e. bathymetry, coastline, parent meshmask, weight for remapping, meshmask and bathymetry remapped on the child grid.
The directory surf_nemo/ contains the sources code of the SURF-NEMO package.
The directory experiments/ contains all the experiments you have executed.

We describe here the contents of these directories.

/docs/surf_nemo/assets/img/surf_tree01.png — Fig. B.1 SURF package directories tree.

B.1. The surf_install directory structure

The SURF-INSTALL package is pre-installed in the SURF platform and it is located in the directory /scratch/surf/surf_install. The folder surf_install_1.00 has the directory structure as in figure B.1:

The folder scripts/ containing the bash scripts to install (install.sh) and to create (dorelease.sh) packages release.
The text file ChangeLog.txt containing documentation of all notable changes to the 'surf_install' package.
The text file ReadMe.txt describing of the contents of the 'surf_install' package.
The bash file vertion.sh containing the version number of the 'surf_install' package. This number is displayed in the upper-right corner of VM desktop

B.2. The surf_nemo directory structure

Once installed (see section 6.2), the SURF-NEMO package is located in the directory /scratch/surf/surf_nemo/. The folder surf_nemo_1.00 has the directory structure as in figure B.1:

The folder nemo/ contains the source code of the NEMO ocean model (v3.6).
The folder scripts/ contains the scripts for the pre- and post-processing needed to execute the relocatable SURF model.
The folder utilities/ contains the source code of several utility functions used for specific tasks in the pre-/post-processing.
The json file setParFree.json of the template configuration file for the case study experiment.
The text file ChangeLog.txt containing the documentation of all notable changes to the 'surf_nemo' package.
The text file ReadMe.txt describing of the contents of the 'surf_nemo' package.
The text file Licence.txt containing the product licensing information.
The bash file vertion.sh containing the version number of the 'surf_nemo' package. This number is displayed in the upper-right corner of VM desktop.

B.3. The surf_datasets directory structure

Once installed (see section xx), the SURF-DATASETS package is located in the directory /scratch/surf/surf_datasets. The folder surf_datasets_1.00 has the directory structure as in figure B.1:

The folder bathymetry/ contains the GEBCO Bathymetric datasets at 30 arc seconds resolution.
The folder coastline/ contains the GSHHG coastline datasets provided by the NOAA National Geophysical Data Center (NGDC).
The folder meshmask/ contains the meshmask files of the parent ocean model and atmosphere source.
The folder experiments_regrid/ used when you want execute the SURF platform operationally. It contains the weight files for remapping ocean and atmospheric input data, the meshmask and bathymetry remapped on the child grid.
The text file ChangeLog.txt containing the documentation of all notable changes to the 'surf_datasets' package.
The text file ReadMe.txt describing of the contents of the 'surf_datasets' package.
The bash file vertion.sh containing the version number of the 'surf_datasets' package. This number is displayed in the upper-right corner of VM desktop.

B.4. The experiments directory

Once the experiment is executed (i.e. expID), it is located in the directory /scratch/surf/experiments/. The folder expID has the directory structure as in figure B.1:

A copy of the configuration file setParFree.json (copied from the directory surf/from_GUI/expID/).
The folder code/ contains a copy of the source code (from the directory surf/surf_nemo/current/) used to execute the simulation.
The folder data/ contains all the data used in the experiment: the original input data (data/indata/), the extrapolated data (data/extrapoldata/), the regridded data (data/regriddata/) and the output data (./data/outdata/) The input datasets are downloaded from a local or web repositories for the selected period of simulation.
The folder figure/ contains all the plots of the original input data (figure/indata/), extrapolated data (figure/extrapoldata/), regridded data (figure/regriddata/), output data (./figure/outdata/), comparison between child and the parent coarse resolution data,...

C. Linux Root Partition and the installed packages

As shown in chapter 6.1.1 the VM surf is divided into two partitions: the disk /dev/sda "mounted" in the root directory / and the disk /dev/sdb "mounted" in the directory /scratch. The root partition contains Debian GNU/Linux operating system (version 10.7).

C.1. Debian partition

The operating system installed in the Virtual Machine is Debian. Debian is a free operating system (OS) that use the Linux kernel. It comes with over 59000 packages, precompiled software bundled up in a nice format for easy installation on your machine.

In the current VM is installed Debian 10 buster. You can find the list of packages here.

C.1. Installed packages

CDO - (v1.8.1)

The Climate Data Operator (CDO) software is a collection of many operators for standard processing of climate and forecast model data. The operators include simple statistical and arithmetic functions, data selection and subsampling tools, and spatial interpolation. CDO was developed to have the same set of processing functions for GRIB [GRIB] and NetCDF [NetCDF] datasets in one package.

curl - (v7.52.1)

curl is free and open source software used in command lines or scripts to transfer files/data from or to a server using FTP, HTTP, HTTPS, SCP, SFTP, SMB and other supported protocols on Linux or Unix-like system.

HDF5 - (v1.8.18)

The Hierarchical Data Format (HDF5) is a data model, library, and file format for storing and managing data. It supports an unlimited variety of datatypes, and is designed for flexible and efficient I/O and for high volume and complex data. HDF5 is portable and is extensible, allowing applications to evolve in their use of HDF5. The HDF5 Technology suite includes tools and applications for managing, manipulating, viewing, and analyzing data in the HDF5 format.

Julia - (v1.4.1)

Julia is a high-level, high-performance, dynamic programming language. While it is a general purpose language and can be used to write any application, many of its features are well-suited for high-performance numerical analysis and computational science.

MPICH2 - (v3.2)

MPICH, formerly known as MPICH2, is a freely available, high performance and widely portable implementation of the Message Passing Interface (MPI) standard. It efficiently supports different computation and communication platforms including commodity clusters, SMPs, massively parallel systems, and high-speed networks.

NCL - (v6.4.0)

The NCAR Command Language (NCL) is a free interpreted language designed specifically for scientific data processing and visualization.

Ncview - (v2.1.7)

Ncview is a visual browser for netCDF format files. Typically you would use ncview to get a quick and easy, push-button look at your netCDF files. You can view simple movies of the data, view along various dimensions, take a look at the actual data values, change color maps, invert the data, etc.

NetCDF - (4.4.1.1)

Network Common Data Form (NetCDF) is a set of software libraries and machine-independent data formats that support the creation, access, and sharing of array-oriented scientific data. It is also a community standard for sharing scientific data.

Python - (3.6.9)

Python is an interpreted, high-level, general-purpose programming language.

Szip - (v2.1)

Szip compression software, providing lossless compression of scientific data.

UDUNITS - (v2.2.24)

The UDUNITS package supports units of physical quantities. Its C library provides for arithmetic manipulation of units and for conversion of numeric values between compatible units. The package contains an extensive unit database, which is in XML format and user-extendable. The package also contains a command-line utility for investigating units and converting values.

XIOS

XIOS is library designed to manage NETCDF outputs of climate models.

zlib - (v1.2.11)

The zlib compression library provides in-memory compression and decompression functions, including integrity checks of the uncompressed data.

D. Bibliography

Engerdahl H (1995), Use of the flow relaxation scheme in a threedimensional baroclinic ocean model with realistic topography., Tellus 47A:365–382
Oddo P, Pinardi N (2008), Lateral open boundary conditions for nested limited area models: A scale selective approach., Ocean Model 20:134–156
Richtmyer R (1957), Difference methods for initial-value problems., Published by Interscience Publishers
Shapiro R (1970), Smoothing, filtering, and boundary effects., Rev Geophys Space Phys 8:359–387
Shapiro R (1975), Linear filtering., Math Comput 29:1094–1097
N. Pinardi et al. (2003), The Mediterranean ocean forecasting system: first phase of implementation (1998–2001)., Annales Geophysicae, 21: 3-20