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.
Note: The documentation is also available in PDF format: surf_nemo_1.01_beta.pdf.
You can download the new SURF-NEMO release from the page https://www.surf-platform.org
Copyright:
SURF is a free and open source software packages distributed under the terms of the GNU General Public License (GPLv3).
Table of Contents
- 1. Introduction
- 2. Work-Flow of SURF-NEMO platform
- 3. User Configuration File: Preprocessing sections
- 3.1 Configuration file and JSON Object Structure
- 3.2 Genearal Input parameters
- 3.3 Input parameters for spatial grid generation
- 3.4 Input parameters for date and time
- 3.5 Input parameters for surface and lateral boundary conditions
- 3.6 Input parameters for physical parametrization
- 3.7 Input parameters for downloading input datasets
- 3.8 Input parameters for manipulate Bathymetry
- 3.9 Input parameters for shapiro filter datasets
- 3.10 Input parameters for interpolation methods
- 3.11 Input parameters for the selection of variables to be saved in the output file
- 3.12 Input parameters for data compression
- 4. User Configuration File: Postprocessing sections
- 5. Input/Output Model Datasets
- 6. Quick Start Guide
- A. Reference Configuration
- B. Scratch Partition and its directory structures
- C. Linux Root Partition and the installed packages
- D. Bibliography
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
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:
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.
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.
The spatial numerical grid generation: it is an automatic step which will generate the horizontal and vertical grid for the nested model.
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.
The Forecast: it is another automatic step, where the NEMO ocean model is numerical integrated and produces the final outputs
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).
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.
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.
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.
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.
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.
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 ....
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.

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:
the zonal components of the surface ocean stress,
the meridional components of the surface ocean stress,
the heat fluxes from solar Qsr,
the heat fluxes from non-solar Qns radiation,
the water flows exchanged with the atmosphere (E-P) (the evaporation minus precipitation budget).
In addition an optional field:
the atmospheric pressure at the ocean surface (pa).
The NEMO ocean model 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.
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.
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";
}
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";
}
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.
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.
-
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
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 Machinesurf
to the list of Virtual Machine
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.
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_".
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
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
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 scriptinstall.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 linkcurrent
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 scriptrun_exp.jl
followed by the experiment IDgulfTaranto_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
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.
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 foldercd /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 needsparam1 = xxx
param2 = xxx
param3 = xxx
param4 = xxx -
From the directory
/scratch/surf/surf_nemo/current/scripts/
, execute the julia scriptrun_exp.jl
followed by the experiment IDgreenlandFjord_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 IDgreenlandFjord_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 needsparam1 = xxx
param2 = xxx
param3 = xxx
param4 = xxx -
From the directory
/scratch/surf/experiments/gulfTaranto_20141005/code/ocean/scripts/
, execute the julia scriptrun_exp.jl
followed by the experiment IDgulfTaranto_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 IDgulfTaranto_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.
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
-
Engerdahl H (1995), Use of the flow relaxation scheme in a threedimensional baroclinic ocean model with realistic topography., Tellus 47A:365–382
-
Oddo P, Pinardi N (2008), Lateral open boundary conditions for nested limited area models: A scale selective approach., Ocean Model 20:134–156
-
Richtmyer R (1957), Difference methods for initial-value problems., Published by Interscience Publishers
-
Shapiro R (1970), Smoothing, filtering, and boundary effects., Rev Geophys Space Phys 8:359–387
-
Shapiro R (1975), Linear filtering., Math Comput 29:1094–1097
-
N. Pinardi et al. (2003), The Mediterranean ocean forecasting system: first phase of implementation (1998–2001)., Annales Geophysicae, 21: 3-20