Welcome to the SURF-NEMO User Guide

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

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

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

Table of Contents

Introduction

The Structured and Unstructured grid Relocatable ocean platform for Forcasting (SURF) is an open source package devoted to generate high resolution 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. It will enable to run limited area ocean forecasts on a commercially available Personal Computer or a laptop. SURF requires to have the coarser resolution ocean forecasts for the initial and boundary conditions and the atmospheric forcing to force the circulation

This User Guide describes the overall design of the structured grid component of the SURF platform based on NEMO ocean model. In addition to step-by-step information about running the SURF 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 a case study experiment using available input datasets for the bathymetry, the coastline, the atmospheric forcing and the coarser resolution parent ocean model and the output datasets to check the correct implementation of the software.

The information about the SURF numerical platform is online also at the home page

https://www.surf-platform.org

SURF contains also the unstructured grid model SHYFEM that will be explained in a future update of the user guide.

Relocatable ocean modelling system

SURF (Trotta et al. 2016) provides a numerical platform for forecasting of hydrodynamic and thermodynamic fields at high spatial and temporal resolutions. SURF 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 the large-scale ocean model and reaching horizontal grid resolutions of a few hundred metres. For each nesting, the parent coarse-grid model provides initial and lateral boundary conditions for the SURF child components.

This relocatable ocean model system aims to be a valuable tool in support to any Decision Support System (DSS) which might need 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 is working on a virtual machine environment where the hydrodynamic NEMO model and several pre- and post-processing tools are connected to the numerical outputs and the required inputs fields. See the Installation chapter 6.1 for how to download and install the package.

A virtual machine is a software-based computer that allows you to emulate 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 operating system, commonly referred to as the host.

As virtualization software we use the free and open-source Oracle VM VirtualBox package where we install the Debian Linux operating system.

Virtual machines offer many advantages and can encapsulate an entire PC environment including the operating system, applications and all data inside a single file. Instead of installing a full bunch of softwares working together it is therefore easier to set once a packaged application. Virtual machine can be distributed as a ready-made fully configured system. A virtual machine provides advantages for configuration and distribution. Furthermore a virtual machine can be executed on various hardware platforms.

Source Code

The SURF source codes are contained in a package that is distributed as tar.gz archive. The archive contains the NEMO code, the pre- and post-processing codes and a template user-configuration file. See the Installation chapter 6.2 for how to download and install the package.

NEMO is an open source code written in Fortran 90 and is parallelized with a domain decomposition using MPI library. All outputs are done with the NetCDF library.

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

Work-Flow of SURF-NEMO platform

The schematic work-flow diagrams in figure Fig.2.1 shown the steps executed by the SURF-NEMO numerical platform. In the up-to-date version release, the steps can be grouped as follows:

  1. The initialization: the user has to specify the value 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 he wants carried out.

  2. The access and download of the input datasets: it is an automatic step where the input datasets for the selected period of simulation are downloaded from a remote or local data repositories as specify 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.

  3. The spatial numerical grid generation: it is an automatic step which will generate the horizontal and vertical grid for the nested model.

  4. The input data regridding: it is an automatic step, which generates the bottom topography, surface forcing, initial and open lateral boundary conditions datasets on the child grid.

  5. The Forecast: it is another automatic step, where the NEMO ocean model is numerical integrated and produces the final outputs

  6. The Post-processing: this step considers the visualisation and analysis procedures of the forecast and it can be activated after the run execution (i.e. compare parent/child fields, compare the simulation results with insitu or satellite datasets and convert datasets).

/img/docs/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 showing step by step how the program is completed from start to finish. We can identify 6 macro-tasks: (1) the child meshmask generation, (2) the atmospheric data regridding, (3) the ocean IC data regridding, (4) the ocean BC data regridding and OBC data extraction, (5) the ocean Model simulation and (6) the visualization and data analysis.

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

Computational jobs are not all independent of one another. The dependency flow graph of macro-tasks is shown in Figure 2.3. Each node (from A to F) represent macro-tasks, solid edges represent data dependencies among macro-tasks. From node A, tree edges can take us to node B, node C and D. Node E can start once all the lower nodes are completed.

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

These figures provide helpful reference for reading this chapter where we will describe in detail all the block executed during the program flow.

Setting up the input model parameters

The first task executed by each macro-task consists in setting-up the value of the input model parameters reading them 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 procedures executed are read_inJsonFree and read_inJsonFixed to define respectively the user-free and fixed input parameters required to execute the NEMO model and all the pre and post-processing tasks. The procedures set_pathData and set_fileData are also call to define all the paths and files name used by the program for the specific experiment.

Child Meshmask Generation

After the model configuration phase, the generation of the child grid is performed. The ocean NEMO model uses the Arakawa C grid for the spatial discretization with 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 and the relative vorticity (\(\zeta\)) and planetary vorticity (f) are defined in the center of each vertical edge. The main advantage of the C grid is that the pressure and convergence terms are computed over a distance x, which is half of that in the unstaggered grid indicating a doubling of the resolution compared to the unstuggered grid. 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.

/img/docs/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. The type of grid used in SURF is 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 direction, the respective grid sizes \(\Delta\lambda\) and \(\Delta\varphi\) (in degrees) and the longitude and latidudine \((\lambda,\varphi)_{1,1}\) of the first row and first column of T grid. On the \(\lambda\varphi\) plane, the location of the T point 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, f point of the grid are shifted by half a grid width in zonal e/o meridional direction as indicated in figure Fig. 2.4.

Bathymetry regridding

This phase will generate the bathymetric dataset on the child grid needed to generate the 3D meshmask. The procedures executed in this phase are:

  • Access and download of the bathymetry and costline datasets.

  • Manipulation of the source bathymetry dataset.

  • Spatial interpolation of the bathymetric dataset on the generated child grid.

Access and download the bathymetry and costline datasets

A procedure for checking if the necesary input dataset 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 in order to download, respectively, the costline and the bathymetry from a remote or local data repositories as specify in the configuration file setParFree.json.

Manipulating and smoothing bathymetry

Before performing the spatial interpolation, the source bathymetry data product can be manipulated if specified in the configuration file setParFree.json. There are several ways of doing this:

  • Add a constant value to the surface elevation for the whole nested region (i.e. inland body of water with water level below the global ocean level like caspian Sea).

  • Set a maximum and minimum value different from the source value (i.e. if you want a minimum depth of 5 meter or a maximum depth less then the actual depth).

  • Define the land/sea interface grid points according the input coastline.

  • Setting maximum and minimum inside sub-regions (i.e. if you want mask a certain area)

  • Smooth out bathymetry variations with the Shapiro filter. The Shapiro filter is a high order horizontal filter that efficiently remove small scale grid noise without affecting the physical structures of a field. This filter was introduced in the 1970's by Shapiro (1970) and Shapiro (1975). The Shapiro filter of the 2N accuracy order 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 totally dissipates the high frequency content (i.e. shortest wavelengths) from the the original field.

Interpolation of bathymetric data

After the manipulation bathymetry phase, the spatial interpolation of the source bathymetric dataset on the child grid can be performed. The procedures used are based on the Spherical Coordinate Remapping and Interpolation Package (SCRIP) code. The available interpolation methods 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 verical grid used in SURF corresponds to a z-coordinate vertical 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 meters) is 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 parameters to be specified. \(h_{cr}\) represents the stretching factor of the grid and \(h_{th}\) is approximately the model level at which maximum stretching occurs. This expression allow to define a stretched z-coordinate vertical levels which are smoothly distributed along the water column, with appropriate thinning designed to better resolve the surface and intermediate layers. With a partial cell parameterization, the thickness of the bottom layer is allowed to vary as a function of geographical location \((x,y)_{i,j}\) to allow a better representation of the real bathymetry.

/img/docs/meshOceTUVxy_FC.png
(A) Horizontal grid.
/img/docs/meshOceTz.png
(B) Vertical T-grid.
Example of horizontal (left) and vertical (right) numerical grid with, respectively, grid sizes of \(\Delta\lambda\) and \(\Delta\varphi\) in horizontal and \(\Delta z\) in vertical direction.

Input data Regridding

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

  • Access and download of the input datasets

  • Rotation the vector fields (if needed)

  • Extrapolation of the input datasets

  • Spatial interpolation of the source dataset on the child grid.

  • Lateral Open Boundary Condition datasets generation

Access and download of the input datasets

A procedure for checking if the necesary input dataset are present in the experiment directory $PATH_IDEXP/data/ is executed. If some of the requested data are not present then the procedures downlAtmSrc, downlOceICSrc and downlOceBCSrc are automatically executed in order to download, respectively, the atmospheric forcing and the initial and lateral boundary condition datasets for the selected period of the simulation from a remote or local data repositories as specify 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 needed in order to interpolate the horizontal velocity fields on the child grid. In an ocean model with 'distorted' grid, the velocity vectors are given according the direction of grid lines. In a staggered Arakawa C grid system the velocity field components are defined at the cell edges (gray arrows in Fig. 2.6(b)). A rotation in latitudinal and longitudinal direction of the velocity components has to be applied to turn 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 between \((x,y)\) coordinates to \((x^{'},y^{'})\) coordinates, 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 model with rotate rectangles grid the angle is near constant. For parent model with curvilinear tripolar grids (as Fig. 2.6(a)) the angle will vary through each grid cell.

/img/docs/orca_grid.png
(A)
/img/docs/rotvector.png
(B)
Example of curvilinear grid. Panel A shows an example of tripolar grid. Panel B show the horizontal velocity components defined on the source curvilinear grid (black arrows) and on the destination rectilinear lat/lon grid (red arrows) after the rotation.

Extrapolation methods

The extrapolation procedure adopt in SURF is the so-called sea-over-land (SOL) procedure that provides us with the ocean field values on the areas near the coastline where the parent model solutions are not defined. The SOL procedure extrapolates iteratively the ocean quantities on the land grid-points, so that it is possible to interpolate these quantities on the child grid. This applies also to several atmospheric fields, taking into account the atmospheric Land-Sea Mask, in order to avoid land contaminations near the land-sea boundaries.

The Sea Over Land procedure seaOverLand is applied to the Course resolution ocean fields in order to extrapolate the salinity, temperature, sea surface height and current fields to the land points. This will allow to define (by interpolation) the Ocen fields in the nested-grid points near to the coast. The some procedure is adopted for the atmospheric forcing fields, taking into account the Atm Land-Sea Mask, in order to do not have contamination from the Atm fields on the Land to the Sea points.

The source code can be found 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 used are based on the Spherical Coordinate Remapping and Interpolation Package (SCRIP) code. SCRIP is a software package which 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 in 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: Inverse-distance-weighted average of a user-specified number of nearest neighbor 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 broken into two stages. The first stage is 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 of the input fields into the generated the bathymetry, atmosferic forcing and initial and boundary conditions files necessary to run the NEMO code. The generated files will be stored in the directory $PATH_EXP/IDEXP/data/.

Lateral Open Boundary Condition

The implementation of the lateral open boundary condition for the selected nested-domain is done using the BDY module of NEMO. Two different numerical algorithms to treat open boundary conditions are adopted depending on the prognostic simulated variables. For the barotropic velocities the Flather scheme (Oddo and Pinardi, 2008) is used, while for baroclinic velocities, active tracers and sea surface height we consider the flow relaxation scheme (Engerdahl, 1995). 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 into the child grid has been split into barotropic and baroclinic components. In order to preserve the total transport after the interpolation an integral constraint method is imposed

This process involves the following steps: (1) the definition of 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, respectively, the procedures geometry_bdy and fields_bdy, (2) the writing of these data arrays to the files necessary to run the NEMO code. The algorithm 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 will be stored in the directory $PATH_EXP/IDEXP/data/.

Integral Constraint at the open boundary

The downscaling is designed in a way to ensure that the volume transport across the open boundary (OB) of the child model matches the volume transport across the corresponding section of the parent model. At the eastern/western boundaries (U-Points) have been imposed 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 extreme 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; \(U_{parent},U_{child}\) are the parent/child total zonal velocity (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 are 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. In a similar way have been imposed these conditions 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 SURF platform proceeds with numerical integration of the NEMO code. During the execution of the program, output files will be continuously updated given the fixed output frequency. You can also examine how far the run has advanced from the NEMO logfile, which is a text file NEMO produces and in which the time step is written. After the model has finished, .... will be written. The output files will be stored in the foder outdata of current experiments directory (see appendix B).

Post-processing

This step considers the visualisation and analysis procedures of the forecast and it 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 datasets.

User Configuration File: Preprocessing Sections

To execute the SURF-NEMO package, the user has to insert several model parameters in order to specify his choices concerning the simulation region, the period of the simulation, horizontal and vertical turbulence schemes, input datasets, interpolation methods, etc. These parameters are used to perform the pre- and post- processing phase and to fill the Fortran namelist needed 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 groupped, according to their functionality, in different sections of the file. In this chapter we will explore in details each section of the configuration file and for each parameters we will specify the admissible values, the unit measures and the “reference value” used for the testcase experiment (see sec. 6.4).

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

Configuration file and JSON Object Structure

The user configuration file has a JSON-based format. JSON stands for JavaScript Object Notation and is a simple, text-based way to store and transmit structured data. This format is "self-describing", easy to understand and is able to support complex data types and data structures. It is commonly used as configuration file in web applications.

JSON syntax is derived from JavaScript object notation syntax and can contains either an array of values, or an object (an associative array of name/value pairs also called 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've create an object with just one name/value pair: the 'sections' array. This array contains a certain number of objects. Each object contains 3 properties: a title that reflect the contents of the section, an alphanumeric identifier id of four digit (id=A001, A002, etc. for preprocessing sections and id=B001, B002, etc. for postprocessing sections) and an array of items delimited by square brackets. Each element of the array is a object which is identify by a name that reflect the ..., a value ...., a type ...., and a description ....

/img/docs/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 nesting domain.

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_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 ...

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 ...

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

Input parameters for physical parametrization

Section set_eos

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

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 ...

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 ...

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 ...

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 ...

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

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

fileAtmPre_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

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

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: 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

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: 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

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

fileAtmPost_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

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

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: 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

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: 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_llatInv

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

Type: bool   Ref.Value: True

fileOceICMesh_lrotVelUV

(=True) to rotate the horizzontal velocity U,V when the parent model is defined on a rotated or a curvilinear grid.

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_lrotVelUV

(=True) to rotate the horizzontal velocity U,V when the parent model is defined on a rotated or a curvilinear grid.

Type: bool   Ref.Value: False

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

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 ...

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 ...

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 ...

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 ...

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

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 figure properties

Input parameters for selecting the figure to generate

Input/Output Model Datasets

In order to execute the SURF-NEMO package, the user has to provide a number of input datasets. These include the bathymetry datasets containing the sea floor 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.

/img/docs/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/file name, 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 are relative to a specific reference level and can increases (positive) or decreases (negative) with increasing water depth. The coordiante 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 need 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 sea floor elevation (positive) increases with increasing water depth,
  • fileBat_lkeepSrcFull if the original downloaded file need to be deleted after cutted in the nested domain.

The available input bathymetry datasets inside the surf packages 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 are 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 includes 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 resolution of xx m,

  • the next highest appears as 'h' (high) with resolution of xx m,

  • the (intermediate) 'i' with resolution of xx m,

  • the (low) 'l' with resolution of xx m,

  • the (coarse) 'c' with 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 a 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 assume 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 need 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 need to impose appropriate boundary conditions at the ocean-ocean interface (i.e. the sides of the domain not bounded by land). Lateral Open Bounday 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 assume 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.

In order to perform the extrapolation (SOL) of ocean fields (see section 2.3), the parent land-sea mask file need to be provided as input datasets. The user needs to set-up the required parameters in the sections set_dataDownlOceBCMesh 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.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 assume 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 need 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 include complex amplitudes of the tide sea-surface elevations and transports for eight primary (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 need 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:

  1. the zonal components of the surface ocean stress,

  2. the meridional components of the surface ocean stress,

  3. the heat fluxes from solar Qsr,

  4. the heat fluxes from non-solar Qns radiation,

  5. the water flows exchanged with the atmosphere (E-P) (the evaporation minus precipitation budget).

In addition an optional field:

  1. the atmospheric pressure at the ocean surface (pa).

The NEMO ocean model provide 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 plataform 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 non staggered grid within a region containing the nested domain. The model assume 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 [\(Pa\)],

  • Total Cloud Cover [%].

  • Total Precipitation [\(Kgm^{-2}s^{-1}\)].

An example of CDL text rappresentation 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 rappresentation 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 need 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 make it easier to run the model without a 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 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 provide 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, and follow the installation instructions.

/img/docs/VM_install_VitualBoxsite_v2.png
Downloads VirtualBox base package.
  • In addition to the base package, download also the Extension Packs. This package provide 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 VirtualBox base package.

/img/docs/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 then 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
/img/docs/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

/img/docs/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 dialog box enter:

    • surf as login

    • surf2019 as an initial password

    You are now logged into the VM.

/img/docs/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 paritions 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_".

/img/docs/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 you computational domain.

  • increase/decrease the video memory and scale factor of your screen

/img/docs/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 teminal prompt, type the coomand:, VBoxManage modifyhd surf_scratch.vdi --resize SIZE_MB
/img/docs/VM_install5.png
Enlarge the virtual disk.
  • Restart your virtual machine and open the GParted application
  • ....
/img/docs/VM_install5.png
Enlarge the virtual disk.
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 windows 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 packages 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 modified the source code. 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 start 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 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 color 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

/img/docs/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 interfaces 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 insitu or satellite datasets and convert datasets.

/img/docs/velxy_z000_t035.png
(A) Surface current.
/img/docs/tempxy_z000_t035.png
(B) Surface temperature.
/img/docs/tempxz_y000_t035.png
(C) Cross-section of temperature.
Example figure generated using NCAR graphic packages.

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 Atmspheric 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 downscaling 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.

/img/docs/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 8.11).

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 8 Jessie. 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

  1. Engerdahl H (1995), Use of the flow relaxation scheme in a threedimensional baroclinic ocean model with realistic topography., Tellus 47A:365–382

  2. Oddo P, Pinardi N (2008), Lateral open boundary conditions for nested limited area models: A scale selective approach., Ocean Model 20:134–156

  3. Richtmyer R (1957), Difference methods for initial-value problems., Published by Interscience Publishers

  4. Shapiro R (1970), Smoothing, filtering, and boundary effects., Rev Geophys Space Phys 8:359–387

  5. Shapiro R (1975), Linear filtering., Math Comput 29:1094–1097

  6. N. Pinardi et al. (2003), The Mediterranean ocean forecasting system: first phase of implementation (1998–2001)., Annales Geophysicae, 21: 3-20