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

# Introduction

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

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

https://www.surf-platform.org

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

## Relocatable ocean modelling system

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

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

## Virtual Machine Environment

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

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

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

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

## Source Code

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

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

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

# Work-Flow of the SURF-NEMO platform

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

1. Initialization: the user specifies the values of the input simulation parameters for the ocean model in the configuration file (horizontal and vertical grids, subgrid scale parameterizations, etc.) for the specific experiment selected.

2. Access and download of the input datasets: this is an automated step in which the input datasets for the selected simulation period are downloaded from remote or local data repositories, as specified in the configuration file. The input data are the bathymetry, the coastline, the atmospheric forcing and the coarse resolution parent ocean model for the initial and lateral boundary condition datasets.

3. Spatial numerical grid generation: this is an automated step that generates the horizontal and vertical grid for the nested model.

4. Input data regridding: this is an automated step that generates the bottom topography, surface forcing, initial and open lateral boundary conditions datasets on the child grid.

5. Forecast: another automated step in which the NEMO code is exectuted to produce the final outputs.

6. Post-processing: in this step the visualization and analysis procedures of the final outputs are considered. Different options of postoprocessing are available, i.e. comparing parent/child fields, comparing the simulation results with in-situ or satellite datasets and converting the datasets into what?

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

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

## Setting up the input model parameters

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

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

• Generation of the child 2D-mesh.

• Interpolation of the source bathymetric dataset on the generated child grid.

• Generation of the child 3D-meshmask.

### Horizontal grid

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

$$$$\begin{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}$$$$

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

### Bathymetry regridding

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

• Manipulating the bathymetry dataset.

• The spatial interpolation of the source bathymetric on the child grid.

### Rotation of horizontal velocity u, v

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

$$$$\begin{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}$$$$

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

### Extrapolation methods

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

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

The source code is provided in the directory $PATH_SURFNEMO/utilities/extrapol/seaoverland. ### Interpolation methods The extrapolation procedure described in the previous section provides the input data for the interpolator. The procedures are based on the Spherical Coordinate Remapping and Interpolation Package (SCRIP) code. SCRIP is a software package that computes addresses and weights for remapping and interpolating fields between grids in spherical coordinates. The package should work for any grid on the surface of a sphere. SCRIP currently supports five remapping options: • Conservative remapping: First- and second-order conservative remapping, as described by Jones (1999, Monthly Weather Review, 127, 2204-2210). • Bilinear interpolation: Slightly generalized to use a local bilinear approximation (only logically rectangular grids). • Bicubic interpolation: Similarly generalized (only logically rectangular grids). • Distance-weighted averaging: The inverse-distance-weighted average of a user-specified number of nearest neighbour values. • Particle remapping: A conservative particle (Monte-Carlo-like) remapping scheme The source code can be found in the directory $PATH_SURFNEMO/nemo/NEMOGCM/TOOLS/WEIGHTS.

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

### Integral Constraint at the open boundary

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

## Model run

Finally, the NEMO code is numerically integrated by the SURF platform. The output files are continuously updated, given a fixed output frequency, throughout the execution of the program. The logfile is a text file NEMO produces that contains data on how far the run has advanced by providing the time step. After the model run is completed, the output files are stored in the experiment directory $PATH_IDEXP/data/data00/outdata/ (see appendix B). ## Post-processing In this step the visualization and analysis procedures of the forecast are considered. These can be activated after the execution of each macro-task. The user can visualize the input, regridded and output datasets, compare parent/child fields and convert the model output datasets. # User Configuration File: Preprocessing Sections To execute the SURF-NEMO package, the user must input several model parameters to select a specific simulation region, the simulation period, horizontal and vertical turbulence schemes, input datasets, interpolation methods, etc. These parameters are used to conduct the pre- and post-processing phases and to populate the Fortran namelist required to execute the NEMO-OPA code. These choices are made by specifying the values of the input model parameters in the user configuration file "setParFree.json", where all the free-user input parameters are grouped in different sections according to their functionality. In this chapter we provide details of each section of the configuration file and specify the admissible values, the unit measures and the “reference value” used for the test case experiment for each parameter (see Section 6.4). Some of the input model parameters are fixed and defined inside the SURF source package in the file "setParFix" (see Appendix A for more details) ## Configuration file and JSON Object Structure The user configuration file has a JavaScript Object Notation (JSON)-based format. JSON is a simple, text-based method of storing and transmitting structured data. This format is "self-describing", easy to understand and can support complex data types and structures. It is commonly used for configuration files in web applications. JSON syntax is derived from JavaScript object notation syntax and can contain either an array of values or an object (an associative array of name/value pairs also referred to as properties). An array is surrounded by square brackets, [ and ], and contains a comma-separated list of values. An object is surrounded by curly brackets,{ and }, and contains a comma-separated list of name/value pairs. A name/value pair consists of a field name (in double quotes), followed by a colon (:), followed by the field value. A value in an array or object can be of type number (integer or floating-point), string (in double-quotes), boolean (true or false), another array (surrounded by square brackets, [ and ]), another object (surrounded by curly brackets, and ), or null. The JSON configuration file defined for the SURF-NEMO package is shown in Figure 3.1. At the top level, we have created the “sections” array, which is an object with just one name/value pair. This array contains various objects. Each object contains three properties: a title that reflects the contents of the section, a four-digit alphanumeric identifier ID (id = A001, A002, etc. for pre-processing sections and id = B001, B002, etc. for post-processing sections) and an array of items delimited by square brackets. Each element of the “items” array is an object that is identified by a name, a value, a data type (int, float, double, bool and string) and a brief description of the corresponding parameter. ## Genearal Input parameters ### Section set_surf The section set_surf contains the following two parameters: nnest Number of nesting domain. Type: int Ref.Value: 1 Range: 1, 2, 3 nameNestDomain Name of the nest domain to simulate. Type: string Ref.Value: gulfTaranto ### Section set_lrun The section set_lrun contains the logical parameters to activate/deactivate specific tasks. lrun_childMeshMask Enables the execution of the CHILD-MESHMASK GENERATION task. Type: bool Ref.Value: True lrun_regridPreAtm Enables the execution of the ATMOSPHERIC-DATA-REGRIDDING task. Type: bool Ref.Value: True lrun_regridPreOceIC Enables the execution of the OCEAN-IC-DATA-REGRIDDING phase. Type: bool Ref.Value: True lrun_regridPreOceBC Enables the execution of the OCEAN-BC-DATA-REGRIDDING phase. Type: bool Ref.Value: True lrun_regridPreTideBC Enables the execution of the TIDE-BC-DATA-REGRIDDING phase. Type: bool Ref.Value: True lrun_regridPreWeights Enables the computation/copy of WEIGHT-FILEs for input_fields REMAPPING (if lrun_regridPre=True). Type: bool Ref.Value: True lrun_ocean Enables the execution of the NEMO codes. Type: bool Ref.Value: True lrun_regridOutUV Enables the execution of the output-UV_fields REMAPPING (from UV GRID to T-GRID). Type: bool Ref.Value: False lrun_regridOutUVWeghts Enables the computation/copy of WHEGHT-FILEs for output-UV_fields REMAPPING (if lrun_regridOutUV-True). Type: bool Ref.Value: False lrun_shapFiltBat Enables the execution of the SHAPIRO Filter for Bathymetric datasets. Type: bool Ref.Value: True lrun_shapFiltOce Enable the execution of the SHAPIRO Filter fo Ocean datasets. Type: bool Ref.Value: False ## Input parameters for spatial grid generation ### Section set_xyGrid The section set_xyGrid contains the free input parameters required for the generation of the horizontal model grid. gr_xygridSpec Parameters specification for the horizontal grid: if = 0, the grid is function of the 5 variables (lam0,phi0,nlam,nphi,dxy) if = 1, the grid is function of the 5 variables (lam0,phi0,lam1,phi1,dxy).. Type: int Ref.Value: 0 Range: 0, 1 gr_jpidta Number of grid points in zonal direction to specify if xygridSpec=0 (if =NOTUSED, parameter not read). Type: int Ref.Value: 94 gr_jpjdta Number of grid points in meridional direction to specify if xygridSpec=0 (if =NOTUSED, parameter not read). Type: int Ref.Value: 79 gr_ppglam0 Longitude of the first raw and column T-point to specify if xygridSpec=0,1. Type: float Ref.Value: 16.4375 gr_ppglam1 Longitude of the last raw and column T-point to specify if xygridSpec=1 (if =NOTUSED, parameter not read). Type: float Ref.Value: NOTUSED gr_ppgphi0 Latitude of the first raw and column T-point to specify if xygridSpec=0,1. Type: float Ref.Value: 38.9375 gr_ppgphi1 Latitude of the last raw and column T-point to specify if xygridSpec=1 (if =NOTUSED, parameter not read). Type: float Ref.Value: NOTUSED gr_jp_cfg Child model resolution (1/gr_jp_cfg) to specify if xygridSpec=0,1. Type: float Ref.Value: 48. gr_jp_cfg_father Father model resolution (1/gr_jp_cfg_father). Type: float Ref.Value: 16. ### Section set_zGrid The section set_zGrid contains the free input parameters used to generate the vertical grid. gr_jpkdta Number of vertical levels. Type: int Ref.Value: 120 gr_zgridSpec Parameters specification for the vertical grid: if = 0, the grid is function of the 5 variables (hh0,h1,hsur,hcr,hth) if = 1, the grid is function of the 4 variables (dzmin,hmax,hcr,hth). Type: int Ref.Value: 1. Range: 0, 1 gr_ppsur Parameter h_sur for the z-coord. trasformation to specify if zgridSpec=0 (if =NOTUSED, parameter not read). Type: double Ref.Value: NOTUSED gr_ppa0 Parameter h_0 for the z-coordinate trasformation to specify if zgridSpec=0 (if =NOTUSED, parameter not read). Type: double Ref.Value: NOTUSED gr_ppa1 Parameter h_1 for the z-coordinate trasformation to specify if zgridSpec=0 (if =NOTUSED, parameter not read). Type: double Ref.Value: NOTUSED gr_ppkth Parameter h_th which gives the approximate layer number above which stretching will be maximum (usually of order nz/2) to specify if zgridSpec=0,1. Type: double Ref.Value: 100 gr_ppacr Parameter h_cr which gives the grid stretching factor (the highest gr_ppacr, the smallest the stretching) to specify if zgridSpec=0,1. Type: double Ref.Value: 30 gr_ppdzminw Depth of the top (first) model layer depth of second 'w' level to specify if zgridSpec=1 (if =NOTUSED, parameter not read). Type: double Ref.Value: 2.8 gr_pphmaxw Maximum depth of the ocean depth of the last 'w' level (set to 0.0 to be computed) to specify if zgridSpec=1 (if =NOTUSED, parameter not read). Type: double Ref.Value: 0.0 gr_dbletanh Enables the use of the double tanh function for vertical coordinates. Type: bool. Ref.Value: False. gr_ppa2 Parameter h_2 to specify if gr_dbletanh=True (if =NOTUSED, parameter not read). Type: double Ref.Value: NOTUSED gr_ppkth2 Parameter h_th2 if gr_dbletanh=True (if =NOTUSED, parameter not read). Type: double Ref.Value: NOTUSED gr_ppacr2 Parameter h_cr2 if gr_dbletanh=True (if =NOTUSED, parameter not read). Type: double Ref.Value: NOTUSED ## Input parameters for date and time simulation ### Section set_dateTime This section of the JSON file contains the free input parameters used to define the period and time discretization of the simulation. start_date Initial date of the simulation (the run starts at 00:00). Type: string Ref.Value: 20141005 ndays Total number of simulation days. Type: int Ref.Value: 2 ndays_spinup Number of spin-up days. Type: int Ref.Value: 1 Range: 0:ndays dom_rdt Simulation 'baroclinic' time step (...40, 48, 50, 60, 72, 80, 90, 100, 120, 144...). Type: float Ref.Value: 150. runMan_write Frequency of write in the output file express as the number of simulation time step. Type: int Ref.Value: 24 dom_btAuto Enables the automatically definition of baro-timestep to be just below a user defined maximum courant number dom_btCmax. Type: bool Ref.Value: False dom_btCmax Maximum courant number (allowed if dom_btAuto=True). Type: float Ref.Value: 0.8 dom_baro Number of iterations of barotropic mode during dom_rdt (allowed if dom_btAuto=False). Type: int Ref.Value: 100 runMan_rstart Start from rest (False) or from a restart file (True). Type: bool Ref.Value: True ndays_xsimu Number of days per each restart simulation. Type: float Ref.Value: 1 ## Input parameters for surface and lateral boundary conditions ### Section set_sbc This section of the JSON file contains the free input parameters used to define surface boundary condition. sbc_iformulat Surface boundary condition formulation to be used (=0)MFS bulk formulat,(=1)fluxform+ssRest,(=2)CORE formulation. Type: int Ref.Value: 0 Range: 0, 1, 2 sbc_ltimeInterp Activate, or not, the time interpolation (=False) steplike shape forcing (=True) broken line shape forcing. Type: bool Ref.Value: True sbc_zreftemp Reference height (m) for the Air Temperature and humidity (for the CORE formulation). Type: float Ref.Value: 10. sbc_zrefwind Reference height (m) for the wind vector (for the CORE formulation). Type: float Ref.Value: 10. sbc_aprdyn Enables the inclusion of atmospheric pressure gradien in ocean and ice Eqs.. Type: bool Ref.Value: False sbc_sclapr Scaling factor to convert atmospheric presure from hPa to Pa. Type: float Ref.Value: 1. ### Section set_obc This section of the JSON file contains the free input parameters used to define lateral open boundary conditions. obc_dyn2d Algorithm of boundary condition for barotropic solution: flather. Type: string Ref.Value: flather Range: flather obc_dyn2d_dta Boundary data to use: (=0)Initial condition (=1)external data (=2)tidal forcing (=3)xternal data+tidal. Type: int Ref.Value: 1 Range: 0, 1, 2 ,3 obc_dyn3d Algorithm of boundary condition for baroclinic velocities: frs, orlanski. Type: string Ref.Value: frs Range: frs, orlanski obc_dyn3d_dta Boundary data to use: (=0)Initial condition (=1)external data. Type: int Ref.Value: 1 Range: 0, 1 obc_tra Algorithm of boundary condition for active tracers: frs, orlanski. Type: string Ref.Value: frs Range: frs, orlanski obc_tra_dta Boundary data to use: (=0)Initial condition (=1)external data. Type: int Ref.Value: 1 Range: 0, 1 obc_rimwidth Width of the FRS zone. Type: int Ref.Value: 1 obc_ltimeInterp Activate, or not, the time interpolation (=False) steplike shape forcing (=True) broken line shape forcing. Type: bool Ref.Value: True obc_lvelCorr Activate the Integral Contraint method to preserve the total transport after the interpolation. Type: bool Ref.Value: False ### Section set_tide This section of the JSON file contains the free input parameters used to define the tidal components which can be added both as the equilibrium tidal sea level and/or only at the lateral boundaries latBtide_lPot Enables the use of tidal potential forcing. Type: bool Ref.Value: True latBtide_K1 Name of the Lunar diurnal K1 tidal component (if =NOTUSED, component not used). Type: string Ref.Value: K1 Range: K1 latBtide_O1 Name of the Lunar diurnal O1 tidal component (if =NOTUSED, component not used). Type: string Ref.Value: O1 Range: O1 latBtide_P1 Name of the Solar diurnal P1 tidal component (if =NOTUSED, component not used). Type: string Ref.Value: P1 Range: P1 latBtide_Q1 Name of the Larger lunar elliptic diurnal Q1 tidal component (if =NOTUSED, component not used). Type: string Ref.Value: Q1 Range: Q1 latBtide_K2 Name of the Lunisolar semidiurnal K2 tidal component (if =NOTUSED, component not used) Type: string Ref.Value: K2 Range: K2 latBtide_M2 Name of the Principal lunar semidiurnal M2 tidal component (if =NOTUSED, component not used). Type: string Ref.Value: M2 Range: M2 latBtide_N2 Name of the Larger lunar elliptic semidiurnal N2 tidal component (if =NOTUSED, component not used). Type: string Ref.Value: N2 Range: N2 latBtide_S2 Name of the Principal solar semidiurnal S2 tidal component (if =NOTUSED, component not used). Type: string Ref.Value: S2 Range: S2 latBtide_M4 Name of the Shallow water overtides of principal lunar M4 tidal component (if =NOTUSED, component not used). Type: string Ref.Value: M4 Range: M4 latBtide_Mm Name of the Lunar monthly Mm tidal component (if =NOTUSED, component not used). Type: string Ref.Value: Mm Range: Mm latBtide_Mf Name of the Lunisolar fortnightly Mf tidal component (if =NOTUSED, component not used). Type: string Ref.Value: Mf Range: Mf ## Input parameters for physical parametrization ### Section set_eos This section of the JSON file contains the free input parameters used to define equation of state of sea water. eos_type type of equation of state and Brunt-Vaisala frequency: (=-1)TEOS-10, (=0)EOS-80, (=1)S-EOS. Type: int Ref.Value: 0 Range: -1, 0, 1 eos_useCT Enables the use of Conservative Temp. ==> surface CT converted in Pot. Temp. in sbcssm. Type: bool Ref.Value: False eos_a0 S-EOS coefficients: thermal expension coefficient. Type: float Ref.Value: 0.1655 eos_b0 S-EOS coefficients: saline expension coefficient. Type: float Ref.Value: 0.76554 eos_lambda1 S-EOS coefficients: cabbeling coeff in T^2 (=0 for linear eos). Type: float Ref.Value: 0.05952 eos_lambda2 S-EOS coefficients: cabbeling coeff in S^2 (=0 for linear eos). Type: float Ref.Value: 0.00074914 eos_mu1 S-EOS coefficients: thermobaric coeff. in T (=0 for linear eos). Type: float Ref.Value: 0.0001497 eos_mu2 S-EOS coefficients: thermobaric coeff. in S (=0 for linear eos). Type: float Ref.Value: 1.109e-05 eos_nu S-EOS coefficients: cabbeling coeff in T*S (=0 for linear eos). Type: float Ref.Value: 0.0024341 ### Section set_botFric This section of the JSON file contains the free input parameters used to define the bottom friction botB_bfri2 Bottom drag coefficient (non linear case). Type: float Ref.Value: 1.e-3 botB_bfeb2 Bottom turbulent kinetic energy background (m^2/s^2). Type: float Ref.Value: 2.5e-3 ### Section set_xyturbTracers This section of the JSON file contains the free input parameters used to define the parameterization of lateral subgrid-scale diffusion for tracers. tra_typeOperator Type of the operator used (0)laplacian, (1)bilaplacian. Type: int Ref.Value: 0 Range: 0, 1 tra_eddycoeffSpec Horizontal eddy coeff. specification (0)def. by coeff. tra_eddycoeff_child, (1)def. from coeff. tra_eddycoeff_father according fat/child coeff. relation. Type: int Ref.Value: 0 Range: 0, 1 tra_eddycoeff_child Horizontal eddy diffusivity (>0 (m2/s) laplacian or < 0 (m4/s2) bilaplacian) of the child model (if =NOTUSED, parameter not read). Type: float Ref.Value: 80. tra_eddycoeff_father Horizontal eddy diffusivity (>0 (m2/s) laplacian or < 0 (m4/s2) bilaplacian) of the father model to be used in fat/child coeff. relation (if =NOTUSED, parameter not read). Type: float Ref.Value: NOTUSED tra_factor Factor to be used in fat/child coeff. relation (if laplacian:(a_child=factor*???), if bilaplacian:(a_child=factor*a_fat(Dx_child/Dx_fat)^4)). Type: float Ref.Value: 1 ### Section set_xyturbMomentum This section of the JSON file contains the free input parameters used to define the parameterization of lateral subgrid-scale viscosity for momentum. dyn_typeOperator type of the operator used (0)laplacian, (1)bilaplacian. Type: int Ref.Value: 1 Range: 0, 1 dyn_eddycoeffSpec horizontal eddy coeff. specification (0)def. by coeff. dyn_eddycoeff_child, (1)def. from coeff. dyn_eddycoeff_father according fat/chld coeff. relation. Type: int Ref.Value: 1 Range: 0, 1 dyn_eddycoeff_child horizontal eddy viscosity (>0 (m2/s) laplacian or < 0 (m4/s2) bilaplacian) of the child model (if =NOTUSED, parameter not read). Type: float Ref.Value: NOTUSED dyn_eddycoeff_father horizontal eddy viscosity (>0 (m2/s) laplacian or < 0 (m4/s2) bilaplacian) of the father model to be used in fat/child coeff. relation (if =NOTUSED, parameter not read). Type: float Ref.Value: -0.5e10 dyn_factor factor to be used in father/child coeff. relation (if laplacian:(a_child=factor*???), if bilaplacian:(a_child=factor*a_fat(Dx_child/Dx_fat)^4)). Type: float Ref.Value: 1. ### Section set_zturb This section of the JSON file contains the free input parameters used to define the vertical eddy viscosity and diffusivity coefficients zdyn_avm0 Vertical eddy viscosity [m2/s] (background Kz if not 'key_zdfcst'). Type: float Ref.Value: 1.2e-5 zdyn_avt0 Vertical eddy diffusivity [m2/s] (background Kz if not 'key_zdfcst'). Type: float Ref.Value: 1.2e-6 zdyn_avevd Evd mixing coefficient [m2/s]. Type: float Ref.Value: 10. zdynric_avmri Maximum value of the vertical viscosity. Type: float Ref.Value: 1.e-2 zdynric_alp Vertical eddy viscosity [m2/s] (background Kz if not 'key_zdfcst'). Type: float Ref.Value: 5. zdynric_ric Vertical eddy viscosity [m2/s] (background Kz if not 'key_zdfcst'). Type: float Ref.Value: 2. ## Input parameters for downloading input datasets ### Section set_dataDownlCoast_urlName This section of the JSON file contains the parameters needed to make up the URL that is required to access the input coastline datasets from a local or remote ropository. urlCoast_usr Username to access the coastline datasets from a remote ftp server. Type: string Ref.Value: usr urlCoast_pwd Password to access the coastline datasets from a remote ftp server. Type: string Ref.Value: pwd urlCoast_urlbase Parametric urlname (i.e. ftp:/... or file:///...) for the coastline datasets. Parameters: (RESCOAST). Type: string Ref.Value: file:///scratch/surf/surf_datasets/current/coastline/GSHHS_shp/(RESCOAST) urlCoast_resol Name for spatial resolution used to replace the substring (RESCOAST) on the parametric urlname (if =NOTUSED, parameter not read). Type: string Ref.Value: h Range: f, h, i, l, c ### Section set_dataDownlCoast_fileName This section of the JSON file contains the parameters for the FILENAMEs of the input coastline datasets. fileCoast_lland Enables the use of the land coastline. Type: bool Ref.Value: True fileCoast_filebaseLand Files name for NOAA coastline datasets contains boundary between land and ocean (if fileCoast_lland=True). Parameters: (RESCOAST). Type: string Ref.Value: GSHHS_(RESCOAST)_L1.shp fileCoast_llake Enables the use of the lake coastline. Type: bool Ref.Value: False fileCoast_filebaseLake Files name for NOAA coastline datasets contains boundary between lake and land (if fileCoast_llake=True). Parameters: (RESCOAST). Type: string Ref.Value: GSHHS_(RESCOAST)_L2.shp fileCoast_lislandlake Enables the use of the islelake coastline. Type: bool Ref.Value: False fileCoast_filebaseIslandlake Files name for NOAA coastline datasets contains boundary between island-in-lake and lake (if fileCoast_lislandlake=True). Parameters: (RESCOAST). Type: string Ref.Value: GSHHS_(RESCOAST)_L3.shp fileCoast_resol Name for spatial resolution used to replace the substring (RESCOAST) on the parametric file name (if =NOTUSED, parameter not read). Type: string Ref.Value: h fileCoast_lcompression (=True) if datasets you want to download are gzip compressed files (*.gz). Type: bool Ref.Value: False fileCoast_lkeepSrcFull (=True) if you want to keep in your disk the downloaded uncutted datasets. Type: bool Ref.Value: True ### Section set_dataDownlBat_urlName This section of the JSON file contains the parameters needed to make up the URL that is required to access the input bathymetry datasets from a local or remote ropository. urlBat_usr Username to access the bathymetric datasets from a remote ftp server. Type: string Ref.Value: usr urlBat_pwd Password to access the bathymetric datasets from a remote ftp server. Type: string Ref.Value: pwd urlBat_urlbase Parametric urlname (i.e. ftp:/... or file:///...) for the bathymetric datasets. Parameters: (RESOL). Type: string Ref.Value: usr urlBat_resol Name for spatial resolution used to replace the substring (RESOL) on the parametric urlname (if =NOTUSED, parameter not read). Type: string Ref.Value: h ### Section set_dataDownlBat_fileName This section of the JSON file contains the parameters for the FILENAME of the input bathymetry datasets. fileBat_filebase Parametric filename for the source bathymetric datasets. Parameters: (RESBAT). Type: string Ref.Value: macroMED_bathyGEBCO.nc fileBat_resol Name for spatial resolution used to replace the substring (RESBAT) on the parametric file name (if =NOTUSED, parameter not read). Type: string Ref.Value: NOTUSED fileBat_lcompression (=True) if datasets you want to download are gzip compressed files (*.gz). Type: bool Ref.Value: False fileBat_llonFlip (=True) if longitude coord. is in the 0 to 360 range and (=False) if longitude is in -180:+180 range. Type: string Ref.Value: macroMED_bathyGEBCO.nc fileBat_llatInv (=True) if the dataset contains latitude decreasing through the pole. Type: bool Ref.Value: False fileBat_ldepthIncr (=True) if the dataset contains sea floor elevation (positive) increases with increasing water depth. Type: bool Ref.Value: False fileBat_lkeepSrcFull (=True) if you want to keep in your disk the downloaded uncutted datasets. Type: bool Ref.Value: False ### Section set_dataDownlBat_varName This section of the JSON file contains the parameters for the VARIABLE-NAMEs of the input bathymetry datasets. srcDimBat_lon Name of the dimension for the longitude. Type: string Ref.Value: lon srcDimBat_lat Name of the dimension for the latitude. Type: string Ref.Value: lat srcCrdBat_lon Name of the coordinate variable for the longitude. Type: string Ref.Value: lon srcCrdBat_lat Name of the coordinate variable for the latitude. Type: string Ref.Value: lat srcVarBat_elev Name of the variable for the Sea Floor Elevation. Type: string Ref.Value: elevation ### Section set_dataDownlAtmMesh_urlName This section of the JSON file contains the parameters needed to make up the URL that is required to access the input atmospheric meshmask datasets from a local or remote ropository. urlAtmMesh_usr Username to access the input atmospheric meshmask datasets from a remote ftp server. Type: string Ref.Value: usr urlAtmMesh_pwd Password to access the input atmospheric meshmask datasets from a remote ftp server. Type: string Ref.Value: pwd urlAtmMesh_urlbase Parametric urlname (i.e. ftp:/... or file:///...) for input atmospheric meshmask datasets. Parameters: (FIELD),YYYY(p)MM(p)DD(p). Type: string Ref.Value: file:///scratch/surf/indata_offline/gulfTaranto_20141005/data/data00/indata/atmosphere/srcFull urlAtmMesh_velU Name for the Zonal Air Velocity used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: v10m urlAtmMesh_velV Name for the Meridional Air Velocity used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: v10m urlAtmMesh_mslp Name for the Mean Sea-Level Pressure used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: mslp urlAtmMesh_cloudCov Name for the Total Cloud Cover used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: tcc urlAtmMesh_temp Name for the Air Temperature used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: t2m urlAtmMesh_dpTemp "Name for the Dewpoint Temperature used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: d2m urlAtmMesh_prec Name for the Total Precipitation used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: precip urlAtmMesh_tauU Name for the Zonal Wind Stress used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: tauU urlAtmMesh_tauV Name for the Meridional Wind Stress used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: tauV urlAtmMesh_qtot Name for the Total Heat Flux used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: qtot urlAtmMesh_qsr Name for the Solar Radiation Penetration used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: qsr urlAtmMesh_emp Name for the Mass Flux Exchanged used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: emp urlAtmMesh_tempS Name for the Surface Temperature used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: sst urlAtmMesh_salS Name for the Surface Salinity used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: sss urlAtmMesh_umid Name for the Air Umidity used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: umid urlAtmMesh_radLW Name for the Long Wave Radiation used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: lwrd urlAtmMesh_radSW Name for the Short Wave Radiation used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: swrd urlAtmMesh_snow Name for the Solid Precipitation used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: snow ### Section set_dataDownlAtmMesh_fileName This section of the JSON file contains the parameters needed to make up the FILENAMEs of the input atmospheric meshmask datasets. fileAtmMesh_filebase_velU Parametric filename for the Zonal Air Velocity datasets before the spinup-time (if sbc_iformulat=0,2). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1). Type: string Ref.Value: YYYY(i)MM(i)DD(i)-ECMWF---AM0125-MEDATL-bYYYY(i+1)MM(i+1)DD(i+1)_an-fv05.00.nc fileAtmMesh_filebase_velV Parametric filename for the Meridional Air Velocity datasets before the spinup-time (if sbc_iformulat=0,2). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1). Type: string Ref.Value: YYYY(i)MM(i)DD(i)-ECMWF---AM0125-MEDATL-bYYYY(i+1)MM(i+1)DD(i+1)_an-fv05.00.nc fileAtmMesh_filebase_mslp Parametric filename for the Mean Sea-Level Pressure datasets before the spinup-time (if sbc_iformulat=0 or/and sbc_aprdyn). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1). Type: string Ref.Value: YYYY(i)MM(i)DD(i)-ECMWF---AM0125-MEDATL-bYYYY(i+1)MM(i+1)DD(i+1)_an-fv05.00.nc fileAtmMesh_filebase_cloudCov Parametric filename for the Total Cloud Cover datasets before the spinup-time (if sbc_iformulat=0). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1). Type: string Ref.Value: YYYY(i)MM(i)DD(i)-ECMWF---AM0125-MEDATL-bYYYY(i+1)MM(i+1)DD(i+1)_an-fv05.00.nc fileAtmMesh_filebase_temp Parametric filename for the Air Temperature datasets before the spinup-time (if sbc_iformulat=0,2). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1). Type: string Ref.Value: YYYY(i)MM(i)DD(i)-ECMWF---AM0125-MEDATL-bYYYY(i+1)MM(i+1)DD(i+1)_an-fv05.00.nc fileAtmMesh_filebase_dpTemp Parametric filename for the Dewpoint Temperature datasets before the spinup-time (if sbc_iformulat=0). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1). Type: string Ref.Value: YYYY(i)MM(i)DD(i)-ECMWF---AM0125-MEDATL-bYYYY(i+1)MM(i+1)DD(i+1)_an-fv05.00.nc fileAtmMesh_filebase_prec Parametric filename for the Total Precipitation datasets before the spinup-time (if sbc_iformulat=0,2). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1). Type: string Ref.Value: YYYY(i)MM(i)DD(i)_YYYY(i+1)MM(i+1)DD(i+1)-ECMWF---AM025-MEDATL-bYYYY(i)MM(i)DD(i)_fc00-fv02.00_PREC.nc fileAtmMesh_filebase_tauU Parametric filename for the Zonal Wind Stress datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1). Type: string Ref.Value: NOTUSED fileAtmMesh_filebase_tauV Parametric filename for the Meridional Wind Stress datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1). Type: string Ref.Value: usr fileAtmMesh_filebase_qtot Parametric filename for the Total Heat Flux datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1). Type: string Ref.Value: usr fileAtmMesh_filebase_qsr Parametric filename for the Solar Radiation Penetration datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1). Type: string Ref.Value: usr fileAtmMesh_filebase_emp Parametric filename for the Mass Flux Exchanged datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1). Type: string Ref.Value: usr fileAtmMesh_filebase_tempS Parametric filename for the Surface Temperature datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1). Type: string Ref.Value: usr fileAtmMesh_filebase_salS Parametric filename for the Surface Salinity datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1). Type: string Ref.Value: usr fileAtmMesh_filebase_umid Parametric filename for the Air Umidity datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1). Type: string Ref.Value: usr fileAtmMesh_filebase_radLW Parametric filename for the Long Wave Radiation datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1). Type: string Ref.Value: usr fileAtmMesh_filebase_radSW Parametric filename for the Short Wave Radiation datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1). Type: string Ref.Value: usr fileAtmMesh_filebase_snow Parametric filename for the Solid Precipitation datasets before the spinup-time (if sbc_iformulat=1). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1). Type: string Ref.Value: usr fileAtmMesh_lcompression (=True) if the datasets you want to download are gzip compressed files (*.gz). Type: bool Ref.Value: False fileAtmMesh_llonFlip (=True) if the longitude coord. is in the 0 to 360 range (=False) if longitude is in -180:+180 range. Type: bool Ref.Value: False fileAtmMesh_llatInv (=True) if the dataset contains latitude decreasing through the pole. Type: bool Ref.Value: True fileAtmMesh_lkeepSrcFull (=True) if you want to keep in your disk the downloaded uncutted datasets. Type: bool Ref.Value: True ### Section set_dataDownlAtmMesh_varName This section of the JSON file contains the parameters for the VARIABLE-NAMEs of the input atmospheric meshmask datasets. srcDimAtmMesh_lon Name of the dimension for the longitude. Type: string Ref.Value: lon srcDimAtmMesh_lat Name of the dimension for the latitude. Type: string Ref.Value: lat srcDimAtmMesh_time Name of the dimension for the time. Type: string Ref.Value: time srcCrdAtmMesh_lon Name of the coordinate variable containing the longitude. Type: string Ref.Value: lon srcCrdAtmMesh_lat Name of the coordinate variable containing the latitude. Type: string Ref.Value: lat srcCrdAtmMesh_time Name of the variable containing time coordinate. Type: string Ref.Value: time srcVarAtmMesh_mask Name of the variable containing the Land Sea Mask (if sbc_iformulat=0,2). Type: string Ref.Value: LSM srcVarAtmMesh_lont Name of the variable containing longitude coordinate of T-points (if sbc_iformulat=1). Type: string Ref.Value: NOTUSED srcVarAtmMesh_lonu Name of the variable containing longitude coordinate of U-points (if sbc_iformulat=1). Type: string Ref.Value: NOTUSED srcVarAtmMesh_lonv Name of the variable containing longitude coordinate of V-points (if sbc_iformulat=1). Type: string Ref.Value: NOTUSED srcVarAtmMesh_latt Name of the variable containing latitude coordinate of T-points (if sbc_iformulat=1). Type: string Ref.Value: NOTUSED srcVarAtmMesh_latu Name of the variable containing latitude coordinate of U-points (if sbc_iformulat=1). Type: string Ref.Value: NOTUSED srcVarAtmMesh_latv Name of the variable containing latitude coordinate of V-points (if sbc_iformulat=1). Type: string Ref.Value: NOTUSED srcVarAtmMesh_maskt Name of the variable containing the Land Sea Mask of T-points (if sbc_iformulat=1). Type: string Ref.Value: NOTUSED srcVarAtmMesh_masku Name of the variable containing the Land Sea Mask of U-points (if sbc_iformulat=1). Type: string Ref.Value: NOTUSED srcVarAtmMesh_maskv Name of the variable containing the Land Sea Mask of V-points (if sbc_iformulat=1). Type: string Ref.Value: NOTUSED ### Section set_dataDownlAtm_urlName_preSpinup This section of the JSON file contains the parameters needed to make up the URL that is required to access the input atmospheric datasets of the pre-Spinup period from a local or remote ropository. urlAtmPre_usr Username to access the input atmospheric datasets before the spinup-time from a remote ftp server. Type: string Ref.Value: usr urlAtmPre_pwd Password to access the input atmospheric datasets before the spinup-time from a remote ftp server. Type: string Ref.Value: pwd urlAtmPre_urlbase Parametric urlname (i.e. ftp:/... or file:///...) for atmospheric datasets before the spinup-time. Parameters: (FIELD),YYYY(p)MM(p)DD(p). Type: string Ref.Value: file:///scratch/surf/indata_offline/gulfTaranto_20141005/data/data00/indata/atmosphere/srcFull urlAtmPre_velU Name for the Zonal Air Velocity used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: v10m urlAtmPre_velV Name for the Meridional Air Velocity used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: v10m urlAtmPre_mslp Name for the Mean Sea-Level Pressure used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: mslp urlAtmPre_cloudCov Name for the Total Cloud Cover used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: tcc urlAtmPre_temp Name for the Air Temperature used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: t2m urlAtmPre_dpTemp Name for the Dewpoint Temperature used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: d2m urlAtmPre_prec Name for the Total Precipitation used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: precip urlAtmPre_tauU Name for the Zonal Wind Stress used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: tauU urlAtmPre_tauV Name for the Meridional Wind Stress used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: tauV urlAtmPre_qtot Name for the Total Heat Flux used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: qtot urlAtmPre_qsr Name for the Solar Radiation Penetration used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: qsr urlAtmPre_emp Name for the Mass Flux Exchanged used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: emp urlAtmPre_tempS Name for the Surface Temperature used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: sst urlAtmPre_salS Name for the Surface Salinity used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: sss urlAtmPre_umid Name for the Air Umidity used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: umid urlAtmPre_radLW Name for the Long Wave Radiation used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: lwrd urlAtmPre_radSW Name for the Short Wave Radiation used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: swrd urlAtmPre_snow Name for the Solid Precipitation used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: snow ### Section set_dataDownlAtm_fileName_preSpinup This section of the JSON file contains the parameters needed to make up the FILENAMEs of the input atmospheric datasets of the pre-Spinup period. fileAtmPre_lcompression (=True) if the datasets you want to download are gzip compressed files (*.gz). Type: bool Ref.Value: True fileAtmPre_iProdDate Type of production (bulletin) date (=1):fixProdDate, (=2):varProdDate-DayofWeek. Type: int Ref.Value: 1 fileAtmPre_dateProdFixed Production date used in the URL/files (if iProdDate=1). Type: string Ref.Value: 20170801 fileAtmPre_dateProdDayofWeek Production date used in the URL/files (if iProdDate=2). Type: string Ref.Value: Wednesday fileAtmPre_filebase_velU Parametric filename for the Zonal Air Velocity datasets before the spinup-time (if sbc_iformulat=0,2). Parameters: YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1). Type: string Ref.Value: YYYY(i)MM(i)DD(i)-ECMWF---AM0125-MEDATL-bYYYY(i+1)MM(i+1)DD(i+1)_an-fv05.00.nc fileAtmPre_filebase_velV 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_lstagC (=True) if the input fields are defined on a staggered Arakawa C grid (=False) if they are all defined at the T grid. Type: bool Ref.Value: True fileOceICMesh_lRegGrid (=True) the input fields are defined on a REGULAR SPHERICAL GRID, UV-rotation not activate (=False) if they are on a CURVILEAR NO-SPHERICAL GRID, UV-rotation activate. Type: bool Ref.Value: False fileOceICMesh_lkeepSrcFull (=True) if you want to keep in your disk the downloaded uncutted datasets. Type: bool Ref.Value: True ### Section set_dataDownlOceICMesh_varName This section of the JSON file contains the free input parameters used to define the VARIABLE-NAMEs of the input ocean IC meshmask datasets. srcDimOceICMesh_lont Name of the dimension for the longitude of T-points. Type: string Ref.Value: x srcDimOceICMesh_lonu Name of the dimension for the longitude of U-points. Type: string Ref.Value: x srcDimOceICMesh_lonv Name of the dimension for the longitude of V-points. Type: string Ref.Value: x srcDimOceICMesh_lonw Name of the dimension for the longitude of W-points. Type: string Ref.Value: x srcDimOceICMesh_latt Name of the dimension for the latitude of T-points. Type: string Ref.Value: y srcDimOceICMesh_latu Name of the dimension for the latitude of U-points. Type: string Ref.Value: y srcDimOceICMesh_latv Name of the dimension for the latitude of V-points. Type: string Ref.Value: y srcDimOceICMesh_latw Name of the dimension for the latitude of W-points. Type: string Ref.Value: y srcDimOceICMesh_deptht Name of the dimension for the depth of T-points. Type: string Ref.Value: z srcDimOceICMesh_depthu Name of the dimension for the depth of U-points. Type: string Ref.Value: z srcDimOceICMesh_depthv Name of the dimension for the depth of V-points. Type: string Ref.Value: z srcDimOceICMesh_depthw Name of the dimension for the depth of W-points. Type: string Ref.Value: z srcDimOceICMesh_time Name of the dimension for the time. Type: string Ref.Value: t srcCrdOceICMesh_lont Name of the coordinate variable for the longitude of T-points. Type: string Ref.Value: nav_lon srcCrdOceICMesh_lonu Name of the coordinate variable for the longitude of U-points. Type: string Ref.Value: nav_lon srcCrdOceICMesh_lonv Name of the coordinate variable for the longitude of V-points. Type: string Ref.Value: nav_lon srcCrdOceICMesh_latt Name of the coordinate variable for the latitude of T-points. Type: string Ref.Value: nav_lat srcCrdOceICMesh_latu Name of the coordinate variable for the latitude of U-points. Type: string Ref.Value: nav_lat srcCrdOceICMesh_latv Name of the coordinate variable for the latitude of V-points. Type: string Ref.Value: nav_lat srcCrdOceICMesh_deptht Name of the coordinate variable for the depth of T-points. Type: string Ref.Value: nav_lev srcCrdOceICMesh_depthw Name of the coordinate variable for the depth of W-points. Type: string Ref.Value: nav_lev srcCrdOceICMesh_time Name of the coordinate variable for the time. Type: string Ref.Value: time srcVarOceICMesh_lont Name of the variable containing the longitude of T-points. Type: string Ref.Value: glamt srcVarOceICMesh_lonu Name of the variable containing the longitude of U-points. Type: string Ref.Value: glamu srcVarOceICMesh_lonv Name of the variable containing the longitude of V-points. Type: string Ref.Value: glamv srcVarOceICMesh_lonf Name of the variable containing the longitude of F-points. Type: string Ref.Value: glamf srcVarOceICMesh_latt Name of the variable containing the latitude of T-points. Type: string Ref.Value: gphit srcVarOceICMesh_latu Name of the variable containing the latitude of U-points. Type: string Ref.Value: gphiu srcVarOceICMesh_latv Name of the variable containing the latitude of V-points. Type: string Ref.Value: gphiv srcVarOceICMesh_latf Name of the variable containing the latitude of F-points. Type: string Ref.Value: gphif srcVarOceICMesh_deptht1d Name of the variable containing the depth of T-points. Type: string Ref.Value: gdept_0 srcVarOceICMesh_depthw1d Name of the variable containing the depth of W-points. Type: string Ref.Value: gdepw_0 srcVarOceICMesh_xscalfctt Name of the scale factors in zonal direction of T-points. Type: string Ref.Value: e1t srcVarOceICMesh_xscalfctu Name of the scale factors in zonal direction of U-points. Type: string Ref.Value: e1u srcVarOceICMesh_xscalfctv Name of the scale factors in zonal direction of V-points. Type: string Ref.Value: e1v srcVarOceICMesh_xscalfctf Name of the scale factors in zonal direction of F-points. Type: string Ref.Value: e1f srcVarOceICMesh_yscalfctt Name of the scale factors in meridional direction of T-points. Type: string Ref.Value: e2t srcVarOceICMesh_yscalfctu Name of the scale factors in meridional direction of U-points. Type: string Ref.Value: e2u srcVarOceICMesh_yscalfctv Name of the scale factors in meridional direction of V-points. Type: string Ref.Value: e2v srcVarOceICMesh_yscalfctf Name of the scale factors in meridional direction of F-points. Type: string Ref.Value: e2f srcVarOceICMesh_zscalfctt1d Name of the scale factors in vertical direction of T-points. Type: string Ref.Value: e3t_0 srcVarOceICMesh_zscalfctw1d Name of the scale factors in vertical direction of W-points. Type: string Ref.Value: e3w_0 srcVarOceICMesh_maskt Name of the land-sea-mask on T-points. Type: string Ref.Value: tmask srcVarOceICMesh_masku Name of the land-sea-mask on U-points. Type: string Ref.Value: umask srcVarOceICMesh_maskv Name of the land-sea-mask on V-points. Type: string Ref.Value: vmask ### Section set_dataDownlOceIC_urlName This section of the JSON file contains the free input parameters needed to make up the URL that is required to access the input ocean IC datasets from a local or remote ropository. urlOceIC_usr Username to access the input ocean IC datasets from a remote ftp server. Type: string Ref.Value: usr urlOceIC_pwd Password to access the input ocean IC datasets from a remote ftp server. Type: string Ref.Value: pwd urlOceIC_urlbase Parametric urlname (i.e. ftp:/... or file:///...) for the input ocean IC meshmask datasets. Parameters: (FIELD),YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1). Type: string Ref.Value: file:///scratch/surf/indata_offline/gulfTaranto_20141005/data/data00/indata/ocean/oceanIC/srcFull urlOceIC_temp Name for the Temperature used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceIC_sal Name for the Salinity used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceIC_ssh Name for the Sea Surface Height used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceIC_velU Name for the Zonal Current used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceIC_velV Name for the Merid. Current used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceIC_tempGrid Name for the Temperature used to replace the substring (GRID) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceIC_salGrid Name for the Salinity used to replace the substring (GRID) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceIC_sshGrid Name for the Sea Surface Height used to replace the substring (GRID) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceIC_velUGrid Name for the Zonal Current used to replace the substring (GRID) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceIC_velVGrid Name for the Merid. Current used to replace the substring (GRID) on the parametric urlname. Type: string Ref.Value: NOTUSED ### Section set_dataDownlOceIC_fileName This section of the JSON file contains the free input parameters needed to make up the FILENAMEs of the input ocean IC datasets. fileOceIC_filebase Parametric filename for ocean IC input data. Parameters: (GRID),(FIELD),YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1). Type: string Ref.Value: EXP1_EAS1_1d_YYYY(i)MM(i)DD(i)_YYYY(i+1)MM(i+1)DD(i+1)_(GRID)_IONIAN.nc fileOceIC_iProdDate File name format to be download (=1):fixProdDate, (=2):varProdDate-DayofWeek. Type: string Ref.Value: NOTUSED fileOceIC_dateProdFixed Datasets production (if iProdDate=1) is used in the URL/files. Type: string Ref.Value: NOTUSED fileOceIC_dateProdDayofWeek Datasets production (if iProdDate=2) is used in the URL/files. Type: string Ref.Value: NOTUSED fileOceIC_temp Name for the Temperature used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceIC_sal Name for the Salinity used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceIC_ssh Name for the Sea Surface Height used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceIC_velU Name for the Zonal Current used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceIC_velV Name for the Merid. Current used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceIC_tempGrid Name for the Temperature used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceIC_salGrid Name for the Salinity used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceIC_sshGrid Name for the Sea Surface Height used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceIC_velUGrid Name for the Zonal Current used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceIC_velVGrid Name for the Merid. Current used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceIC_lcompression Enables if datasets you want to download are gzip compressed files (*.gz). Type: string Ref.Value: NOTUSED ### Section set_dataDownlOceIC_varName This section of the JSON file contains the free input parameters used to define the VARIABLE-NAMEs of the input ocean BC datasets. srcDimOceIC_lont Name of the dimension for the longitude of T-points. Type: string Ref.Value: x srcDimOceIC_lonu Name of the dimension for the longitude of U-points. Type: string Ref.Value: x srcDimOceIC_lonv Name of the dimension for the longitude of V-points. Type: string Ref.Value: x srcDimOceIC_lonw Name of the dimension for the longitude of W-points. Type: string Ref.Value: x srcDimOceIC_latt Name of the dimension for the latitude of T-points. Type: string Ref.Value: y srcDimOceIC_latu Name of the dimension for the latitude of U-points. Type: string Ref.Value: y srcDimOceIC_latv Name of the dimension for the latitude of V-points. Type: string Ref.Value: y srcDimOceIC_latw Name of the dimension for the latitude of W-points. Type: string Ref.Value: y srcDimOceIC_deptht Name of the dimension for the depth of T-points. Type: string Ref.Value: z srcDimOceIC_depthu Name of the dimension for the depth of U-points. Type: string Ref.Value: z srcDimOceIC_depthv Name of the dimension for the depth of V-points. Type: string Ref.Value: z srcDimOceIC_depthw Name of the dimension for the depth of W-points. Type: string Ref.Value: z srcDimOceIC_time Name of the dimension for the time. Type: string Ref.Value: t srcCrdOceIC_lont Name of the coordinate variable for the longitude of T-points. Type: string Ref.Value: nav_lon srcCrdOceIC_lonu Name of the coordinate variable for the longitude of U-points. Type: string Ref.Value: nav_lon srcCrdOceIC_lonv Name of the coordinate variable for the longitude of V-points. Type: string Ref.Value: nav_lon srcCrdOceIC_lonw Name of the coordinate variable for the longitude of W-points. Type: string Ref.Value: nav_lon srcCrdOceIC_latt Name of the coordinate variable for the latitude of T-points. Type: string Ref.Value: nav_lat srcCrdOceIC_latu Name of the coordinate variable for the latitude of U-points. Type: string Ref.Value: nav_lat srcCrdOceIC_latv Name of the coordinate variable for the latitude of V-points. Type: string Ref.Value: nav_lat srcCrdOceIC_latw Name of the coordinate variable for the latitude of W-points. Type: string Ref.Value: nav_lat srcCrdOceIC_deptht Name of the coordinate variable for the depth of T-points. Type: string Ref.Value: deptht srcCrdOceIC_depthu Name of the coordinate variable for the depth of U-points. Type: string Ref.Value: depthu srcCrdOceIC_depthv Name of the coordinate variable for the depth of V-points. Type: string Ref.Value: depthv srcCrdOceIC_depthw Name of the coordinate variable for the depth of W-points. Type: string Ref.Value: depthw srcCrdOceIC_time Name of the coordinate variable for the time coordinate. Type: string Ref.Value: time_counter srcVarOceIC_temp Name of the variable for the Temperature. Type: string Ref.Value: glamf srcVarOceIC_sal Name of the variable for the Salinity. Type: string Ref.Value: gphit srcVarOceIC_ssh Name of the variable for the Sea Surface Height. Type: string Ref.Value: gphiu srcVarOceIC_velU Name of the variable for the Zonal Current. Type: string Ref.Value: gphiv srcVarOceIC_velV Name of the variable for the Merid. Current. Type: string Ref.Value: vmask ### Section set_dataDownlOceBCMesh_urlName This section of the JSON file contains the free input parameters needed to make up the URL that is required to access the input ocean BC meshmask datasets from a local or remote ropository. urlOceBCMesh_usr Username to access the input ocean BC meshmask datasets from a remote ftp server. Type: string Ref.Value: usr urlOceBCMesh_pwd Password to access the input ocean BC meshmask datasets from a remote ftp server. Type: string Ref.Value: pwd urlOceBCMesh_urlbase Parametric urlname (i.e. ftp:/... or file:///...) for the input ocean BC meshmask datasets. Parameters: (FIELD). Type: string Ref.Value: file:///scratch/surf/indata_offline/gulfTaranto_20141005/data/data00/indata/ocean/oceanIC/srcFull urlOceBCMesh_lont Name for the longitude-Tgrid used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCMesh_lonu Name for the longitude-Ugrid used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCMesh_lonv Name for the longitude-Vgrid used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCMesh_lonf Name for the longitude-Fgrid used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCMesh_latt Name for the latitude-Tgrid used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCMesh_latu Name for the latitude-Ugrid used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCMesh_latv Name for the latitude-Vgrid used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCMesh_latf Name for the latitude-Fgrid used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCMesh_deptht1d Name for the depth-Tgrid used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCMesh_depthw1d Name for the depth-Wgrid used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCMesh_xscalfctt Name for the scaleFactor-Tgrid x-direction used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCMesh_xscalfctu Name for the scaleFactor-Ugrid x-direction used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCMesh_xscalfctv Name for the scaleFactor-Vgrid x-direction used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCMesh_xscalfctf Name for the scaleFactor-Fgrid x-direction used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCMesh_yscalfctt Name for the scaleFactor-Tgrid y-direction used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCMesh_yscalfctu Name for the scaleFactor-Ugrid y-direction used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCMesh_yscalfctv Name for the scaleFactor-Vgrid y-direction used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCMesh_yscalfctf Name for the scaleFactor-Fgrid y-direction used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCMesh_zscalfctt1d Name for the scaleFactor-Tgrid z-direction used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCMesh_zscalfctw1d Name for the scaleFactor-Wgrid z-direction used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCMesh_maskt Name for the LandSea-mask-Tgrid used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCMesh_masku Name for the LandSea-mask-Ugrid used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCMesh_maskv Name for the LandSea-mask-Vgrid used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED ### Section set_dataDownlOceBCMesh_fileName This section of the JSON file contains the free input parameters needed to make up the FILENAMEs of the input ocean BC meshmask datasets. fileOceBCMesh_filebase Parametric filename for ocean BC meshmask input datasets. Parameters: (FIELD). Type: string Ref.Value: meshmask_SYS4a3_IONIAN.nc fileOceBCMesh_lont Name for the longitude-Tgrid used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCMesh_lonu Name for the longitude-Tgrid used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCMesh_lonv Name for the longitude-Ugrid used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCMesh_lonf Name for the longitude-Fgrid used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCMesh_latt Name for the latitude-Tgrid used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCMesh_latu Name for the latitude-Ugrid used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCMesh_latv Name for the latitude-Vgrid used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCMesh_latf Name for the latitude-Fgrid used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCMesh_deptht1d Name for the depth-Tgrid used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCMesh_depthw1d Name for the depth-Wgrid used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCMesh_xscalfctt Name for the scaleFactor-Tgrid x-direction used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCMesh_xscalfctu Name for the scaleFactor-Ugrid x-direction used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCMesh_xscalfctv Name for the scaleFactor-Vgrid x-direction used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCMesh_xscalfctf Name for the scaleFactor-Fgrid x-direction used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCMesh_yscalfctt Name for the scaleFactor-Tgrid y-direction used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCMesh_yscalfctu Name for the scaleFactor-Ugrid y-direction used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCMesh_yscalfctv Name for the scaleFactor-Vgrid y-direction used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCMesh_yscalfctf Name for the scaleFactor-Fgrid y-direction used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCMesh_zscalfctt1d Name for the scaleFactor-Tgrid z-direction used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCMesh_zscalfctw1d Name for the scaleFactor-Wgrid z-direction used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCMesh_maskt Name for the LandSea-mask-Tgrid used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCMesh_masku Name for the LandSea-mask-Ugrid used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCMesh_maskv Name for the LandSea-mask-Vgrid used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCMesh_lcompression (=True) if the datasets you want to download are gzip compressed files (*.gz). Type: bool Ref.Value: True fileOceBCMesh_llonFlip (=True) if the longitude coord. is in the 0 to 360 range (=False) if longitude is in -180:+180 range. Type: bool Ref.Value: True fileOceBCMesh_llatInv (=True) if the dataset contains latitude decreasing through the pole. Type: bool Ref.Value: True fileOceBCMesh_lstagC (=True) if the input fields are defined on a staggered Arakawa C grid (=False) if they are all defined at the T grid. Type: bool Ref.Value: False fileOceBCMesh_lRegGrid (=True) the input fields are defined on a REGULAR SPHERICAL GRID, UV-rotation not activate (=False) if they are on a CURVILEAR NO-SPHERICAL GRID, UV-rotation activate. Type: bool Ref.Value: True fileOceBCMesh_lkeepSrcFull (=True) if you want to keep in your disk the downloaded uncutted datasets. Type: bool Ref.Value: True ### Section set_dataDownlOceBCMesh_varName This section of the JSON file contains the free input parameters used to define the VARIABLE-NAMEs of the input ocean BC meshmask datasets. srcDimOceBCMesh_lont Name of the dimension for the longitude of T-points. Type: string Ref.Value: x srcDimOceBCMesh_lonu Name of the dimension for the longitude of U-points. Type: string Ref.Value: x srcDimOceBCMesh_lonv Name of the dimension for the longitude of V-points. Type: string Ref.Value: x srcDimOceBCMesh_lonw Name of the dimension for the longitude of W-points. Type: string Ref.Value: x srcDimOceBCMesh_latt Name of the dimension for the latitude of T-points. Type: string Ref.Value: y srcDimOceBCMesh_latu Name of the dimension for the latitude of U-points. Type: string Ref.Value: y srcDimOceBCMesh_latv Name of the dimension for the latitude of V-points. Type: string Ref.Value: y srcDimOceBCMesh_latw Name of the dimension for the latitude of W-points. Type: string Ref.Value: y srcDimOceBCMesh_deptht Name of the dimension for the depth of T-points. Type: string Ref.Value: z srcDimOceBCMesh_depthu Name of the dimension for the depth of U-points. Type: string Ref.Value: z srcDimOceBCMesh_depthv Name of the dimension for the depth of V-points. Type: string Ref.Value: z srcDimOceBCMesh_depthw Name of the dimension for the depth of W-points. Type: string Ref.Value: z srcDimOceBCMesh_time Name of the dimension for the time. Type: string Ref.Value: t srcCrdOceBCMesh_lont Name of the coordinate variable for the longitude of T-points. Type: string Ref.Value: nav_lon srcCrdOceBCMesh_lonu Name of the coordinate variable for the longitude of U-points. Type: string Ref.Value: nav_lon srcCrdOceBCMesh_lonv Name of the coordinate variable for the longitude of V-points. Type: string Ref.Value: nav_lon srcCrdOceBCMesh_latt Name of the coordinate variable for the latitude of T-points. Type: string Ref.Value: nav_lat srcCrdOceBCMesh_latu Name of the coordinate variable for the latitude of U-points. Type: string Ref.Value: nav_lat srcCrdOceBCMesh_latv Name of the coordinate variable for the latitude of V-points. Type: string Ref.Value: nav_lat srcCrdOceBCMesh_deptht Name of the coordinate variable for the depth of T-points. Type: string Ref.Value: nav_lev srcCrdOceBCMesh_depthw Name of the coordinate variable for the depth of W-points. Type: string Ref.Value: nav_lev srcCrdOceBCMesh_time Name of the coordinate variable for the time. Type: string Ref.Value: time srcVarOceBCMesh_lont Name of the variable containing the longitude of T-points. Type: string Ref.Value: glamt srcVarOceBCMesh_lonu Name of the variable containing the longitude of U-points. Type: string Ref.Value: glamu srcVarOceBCMesh_lonv Name of the variable containing the longitude of V-points. Type: string Ref.Value: glamv srcVarOceBCMesh_lonf Name of the variable containing the longitude of F-points. Type: string Ref.Value: glamf srcVarOceBCMesh_latt Name of the variable containing the latitude of T-points. Type: string Ref.Value: gphit srcVarOceBCMesh_latu Name of the variable containing the latitude of U-points. Type: string Ref.Value: gphiu srcVarOceBCMesh_latv Name of the variable containing the latitude of V-points. Type: string Ref.Value: gphiv srcVarOceBCMesh_latf Name of the variable containing the latitude of F-points. Type: string Ref.Value: gphif srcVarOceBCMesh_deptht1d Name of the variable containing the depth of T-points. Type: string Ref.Value: gdept_0 srcVarOceBCMesh_depthw1d Name of the variable containing the depth of W-points. Type: string Ref.Value: gdepw_0 srcVarOceBCMesh_xscalfctt Name of the scale factors in zonal direction of T-points. Type: string Ref.Value: e1t srcVarOceBCMesh_xscalfctu Name of the scale factors in zonal direction of U-points. Type: string Ref.Value: e1u srcVarOceBCMesh_xscalfctv Name of the scale factors in zonal direction of V-points. Type: string Ref.Value: e1v srcVarOceBCMesh_xscalfctf Name of the scale factors in zonal direction of F-points. Type: string Ref.Value: e1f srcVarOceBCMesh_yscalfctt Name of the scale factors in meridional direction of T-points. Type: string Ref.Value: e2t srcVarOceBCMesh_yscalfctu Name of the scale factors in meridional direction of U-points. Type: string Ref.Value: e2u srcVarOceBCMesh_yscalfctv Name of the scale factors in meridional direction of V-points. Type: string Ref.Value: e2v srcVarOceBCMesh_yscalfctf Name of the scale factors in meridional direction of F-points. Type: string Ref.Value: e2f srcVarOceBCMesh_zscalfctt1d Name of the scale factors in vertical direction of T-points. Type: string Ref.Value: e3t_0 srcVarOceBCMesh_zscalfctw1d Name of the scale factors in vertical direction of W-points. Type: string Ref.Value: e3w_0 srcVarOceBCMesh_zscalfctu Name of the scale factors 3d in vertical direction of U-points (needed if obc_lvelCorr=True). Type: string Ref.Value: e3u srcVarOceBCMesh_zscalfctv Name of the scale factors 3d in vertical direction of V-points (needed if obc_lvelCorr=True). Type: string Ref.Value: e3v srcVarOceBCMesh_maskt Name of the land-sea-mask on T-points. Type: string Ref.Value: tmask srcVarOceBCMesh_masku Name of the land-sea-mask on U-points. Type: string Ref.Value: umask srcVarOceBCMesh_maskv Name of the land-sea-mask on V-points. Type: string Ref.Value: vmask ### Section set_dataDownlOceBC_urlName_preSpinup This section of the JSON file contains the free input parameters needed to make up the URL that is required to access the input ocean BC datasets of the pre-Spinup period from a local or remote ropository. urlOceBCPre_usr Username to access the input ocean BC datasets from a remote ftp server. Type: string Ref.Value: usr urlOceBCPre_pwd Password to access the input ocean BC datasets from a remote ftp server. Type: string Ref.Value: pwd urlOceBCPre_urlbase Parametric urlname (i.e. ftp:/... or file:///...) for the input ocean BC datasets. Parameters: (FIELD),YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1). Type: string Ref.Value: file:///scratch/surf/indata_offline/gulfTaranto_20141005/data/data00/indata/ocean/oceanIC/srcFull urlOceBCPre_temp Name for the Temperature used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCPre_sal Name for the Salinity used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCPre_ssh Name for the Sea Surface Height used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCPre_velU Name for the Zonal Current used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCPre_velV Name for the Merid. Current used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCPre_tempGrid Name for the Temperature used to replace the substring (GRID) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCPre_salGrid Name for the Salinity used to replace the substring (GRID) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCPre_sshGrid Name for the Sea Surface Height used to replace the substring (GRID) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCPre_velUGrid Name for the Zonal Current used to replace the substring (GRID) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCPre_velVGrid Name for the Merid. Current used to replace the substring (GRID) on the parametric urlname. Type: string Ref.Value: NOTUSED ### Section set_dataDownlOceBC_fileName_preSpinup This section of the JSON file contains the free input parameters needed to make up the FILENAMEs of the input ocean BC datasets of the pre-Spinup period. fileOceBCPre_filebase Parametric filename for input ocean BC datasets. Parameters: (GRID),(FIELD),YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1). Type: string Ref.Value: EXP1_EAS1_1d_YYYY(i)MM(i)DD(i)_YYYY(i+1)MM(i+1)DD(i+1)_(GRID)_IONIAN.nc fileOceBCPre_iProdDate File name format to be download (=1):fixProdDate, (=2):varProdDate-DayofWeek. Type: string Ref.Value: NOTUSED fileOceBCPre_dateProdFixed Datasets production (if iProdDate=1) is used in the URL/files. Type: string Ref.Value: NOTUSED fileOceBCPre_dateProdDayofWeek Datasets production (if iProdDate=2) is used in the URL/files. Type: string Ref.Value: NOTUSED fileOceBCPre_temp Name for the Temperature used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCPre_sal Name for the Salinity used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCPre_ssh Name for the Sea Surface Height used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCPre_velU Name for the Zonal Current used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCPre_velV Name for the Merid. Current used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCPre_tempGrid Name for the Temperature used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCPre_salGrid Name for the Salinity used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCPre_sshGrid Name for the Sea Surface Height used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCPre_velUGrid Name for the Zonal Current used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCPre_velVGrid Name for the Merid. Current used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCPre_lcompression Enables if datasets you want to download are gzip compressed files (*.gz). Type: string Ref.Value: NOTUSED ### Section set_dataDownlOceBC_varName_preSpinup This section of the JSON file contains the free input parameters used to define the VARIABLE-NAMEs of the input ocean BC datasets of the pre-Spinup period. srcDimOceBCPre_lont Name of the dimension for the longitude of T-points. Type: string Ref.Value: x srcDimOceBCPre_lonu Name of the dimension for the longitude of U-points. Type: string Ref.Value: x srcDimOceBCPre_lonv Name of the dimension for the longitude of V-points. Type: string Ref.Value: x srcDimOceBCPre_lonw Name of the dimension for the longitude of W-points. Type: string Ref.Value: x srcDimOceBCPre_latt Name of the dimension for the latitude of T-points. Type: string Ref.Value: y srcDimOceBCPre_latu Name of the dimension for the latitude of U-points. Type: string Ref.Value: y srcDimOceBCPre_latv Name of the dimension for the latitude of V-points. Type: string Ref.Value: y srcDimOceBCPre_latw Name of the dimension for the latitude of W-points. Type: string Ref.Value: y srcDimOceBCPre_deptht Name of the dimension for the depth of T-points. Type: string Ref.Value: z srcDimOceBCPre_depthu Name of the dimension for the depth of U-points. Type: string Ref.Value: z srcDimOceBCPre_depthv Name of the dimension for the depth of V-points. Type: string Ref.Value: z srcDimOceBCPre_depthw Name of the dimension for the depth of W-points. Type: string Ref.Value: z srcDimOceBCPre_time Name of the dimension for the time. Type: string Ref.Value: t srcCrdOceBCPre_lont Name of the coordinate variable for the longitude of T-points. Type: string Ref.Value: nav_lon srcCrdOceBCPre_lonu Name of the coordinate variable for the longitude of U-points. Type: string Ref.Value: nav_lon srcCrdOceBCPre_lonv Name of the coordinate variable for the longitude of V-points. Type: string Ref.Value: nav_lon srcCrdOceBCPre_lonw Name of the coordinate variable for the longitude of W-points. Type: string Ref.Value: nav_lon srcCrdOceBCPre_latt Name of the coordinate variable for the latitude of T-points. Type: string Ref.Value: nav_lat srcCrdOceBCPre_latu Name of the coordinate variable for the latitude of U-points. Type: string Ref.Value: nav_lat srcCrdOceBCPre_latv Name of the coordinate variable for the latitude of V-points. Type: string Ref.Value: nav_lat srcCrdOceBCPre_latw Name of the coordinate variable for the latitude of W-points. Type: string Ref.Value: nav_lat srcCrdOceBCPre_deptht Name of the coordinate variable for the depth of T-points. Type: string Ref.Value: deptht srcCrdOceBCPre_depthu Name of the coordinate variable for the depth of U-points. Type: string Ref.Value: depthu srcCrdOceBCPre_depthv Name of the coordinate variable for the depth of V-points. Type: string Ref.Value: depthv srcCrdOceBCPre_depthw Name of the coordinate variable for the depth of W-points. Type: string Ref.Value: depthw srcCrdOceBCPre_time Name of the coordinate variable for the time coordinate. Type: string Ref.Value: time_counter srcVarOceBCPre_temp Name of the variable for the Temperature. Type: string Ref.Value: glamf srcVarOceBCPre_sal Name of the variable for the Salinity. Type: string Ref.Value: gphit srcVarOceBCPre_ssh Name of the variable for the Sea Surface Height. Type: string Ref.Value: gphiu srcVarOceBCPre_velU Name of the variable for the Zonal Current. Type: string Ref.Value: gphiv srcVarOceBCPre_velV Name of the variable for the Merid. Current. Type: string Ref.Value: vmask ### Section set_dataDownlOceBC_urlName_postSpinup This section of the JSON file contains the free input parameters needed to make up the URL that is required to access the input ocean BC datasets of the post-Spinup period from a local or remote ropository. urlOceBCPost_usr Username to access the input ocean BC datasets from a remote ftp server. Type: string Ref.Value: usr urlOceBCPost_pwd Password to access the input ocean BC datasets from a remote ftp server. Type: string Ref.Value: pwd urlOceBCPost_urlbase Parametric urlname (i.e. ftp:/... or file:///...) for the input ocean BC datasets. Parameters: (FIELD),YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1). Type: string Ref.Value: file:///scratch/surf/indata_offline/gulfTaranto_20141005/data/data00/indata/ocean/oceanIC/srcFull urlOceBCPost_temp Name for the Temperature used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCPost_sal Name for the Salinity used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCPost_ssh Name for the Sea Surface Height used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCPost_velU Name for the Zonal Current used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCPost_velV Name for the Merid. Current used to replace the substring (FIELD) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCPost_tempGrid Name for the Temperature used to replace the substring (GRID) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCPost_salGrid Name for the Salinity used to replace the substring (GRID) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCPost_sshGrid Name for the Sea Surface Height used to replace the substring (GRID) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCPost_velUGrid Name for the Zonal Current used to replace the substring (GRID) on the parametric urlname. Type: string Ref.Value: NOTUSED urlOceBCPost_velVGrid Name for the Merid. Current used to replace the substring (GRID) on the parametric urlname. Type: string Ref.Value: NOTUSED ### Section set_dataDownlOceBC_fileName_postSpinup This section of the JSON file contains the free input parameters needed to make up the FILENAMEs of the input ocean BC datasets of the post-Spinup period. fileOceBCPost_filebase Parametric filename for input ocean BC datasets. Parameters: (GRID),(FIELD),YYYY(p)MM(p)DD(p),YYYY(i)MM(i)DD(i),YYYY(i-1)MM(i-1)DD(i-1),YYYY(i+1)MM(i+1)DD(i+1). Type: string Ref.Value: EXP1_EAS1_1d_YYYY(i)MM(i)DD(i)_YYYY(i+1)MM(i+1)DD(i+1)_(GRID)_IONIAN.nc fileOceBCPost_iProdDate File name format to be download (=1):fixProdDate, (=2):varProdDate-DayofWeek. Type: string Ref.Value: NOTUSED fileOceBCPost_dateProdFixed Datasets production (if iProdDate=1) is used in the URL/files. Type: string Ref.Value: NOTUSED fileOceBCPost_dateProdDayofWeek Datasets production (if iProdDate=2) is used in the URL/files. Type: string Ref.Value: NOTUSED fileOceBCPost_temp Name for the Temperature used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCPost_sal Name for the Salinity used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCPost_ssh Name for the Sea Surface Height used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCPost_velU Name for the Zonal Current used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCPost_velV Name for the Merid. Current used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCPost_tempGrid Name for the Temperature used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCPost_salGrid Name for the Salinity used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCPost_sshGrid Name for the Sea Surface Height used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCPost_velUGrid Name for the Zonal Current used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCPost_velVGrid Name for the Merid. Current used to replace the substring (FIELD) on the parametric filename. Type: string Ref.Value: NOTUSED fileOceBCPost_lcompression Enables if datasets you want to download are gzip compressed files (*.gz). Type: string Ref.Value: NOTUSED ### Section set_dataDownlOceBC_varName_postSpinup This section of the JSON file contains the free input parameters used to define the VARIABLE-NAMEs of the input ocean BC datasets of the post-Spinup period. srcDimOceBCPost_lont Name of the dimension for the longitude of T-points. Type: string Ref.Value: x srcDimOceBCPost_lonu Name of the dimension for the longitude of U-points. Type: string Ref.Value: x srcDimOceBCPost_lonv Name of the dimension for the longitude of V-points. Type: string Ref.Value: x srcDimOceBCPost_lonw Name of the dimension for the longitude of W-points. Type: string Ref.Value: x srcDimOceBCPost_latt Name of the dimension for the latitude of T-points. Type: string Ref.Value: y srcDimOceBCPost_latu Name of the dimension for the latitude of U-points. Type: string Ref.Value: y srcDimOceBCPost_latv Name of the dimension for the latitude of V-points. Type: string Ref.Value: y srcDimOceBCPost_latw Name of the dimension for the latitude of W-points. Type: string Ref.Value: y srcDimOceBCPost_deptht Name of the dimension for the depth of T-points. Type: string Ref.Value: z srcDimOceBCPost_depthu Name of the dimension for the depth of U-points. Type: string Ref.Value: z srcDimOceBCPost_depthv Name of the dimension for the depth of V-points. Type: string Ref.Value: z srcDimOceBCPost_depthw Name of the dimension for the depth of W-points. Type: string Ref.Value: z srcDimOceBCPost_time Name of the dimension for the time. Type: string Ref.Value: t srcCrdOceBCPost_lont Name of the coordinate variable for the longitude of T-points. Type: string Ref.Value: nav_lon srcCrdOceBCPost_lonu Name of the coordinate variable for the longitude of U-points. Type: string Ref.Value: nav_lon srcCrdOceBCPost_lonv Name of the coordinate variable for the longitude of V-points. Type: string Ref.Value: nav_lon srcCrdOceBCPost_lonw Name of the coordinate variable for the longitude of W-points. Type: string Ref.Value: nav_lon srcCrdOceBCPost_latt Name of the coordinate variable for the latitude of T-points. Type: string Ref.Value: nav_lat srcCrdOceBCPost_latu Name of the coordinate variable for the latitude of U-points. Type: string Ref.Value: nav_lat srcCrdOceBCPost_latv Name of the coordinate variable for the latitude of V-points. Type: string Ref.Value: nav_lat srcCrdOceBCPost_latw Name of the coordinate variable for the latitude of W-points. Type: string Ref.Value: nav_lat srcCrdOceBCPost_deptht Name of the coordinate variable for the depth of T-points. Type: string Ref.Value: deptht srcCrdOceBCPost_depthu Name of the coordinate variable for the depth of U-points. Type: string Ref.Value: depthu srcCrdOceBCPost_depthv Name of the coordinate variable for the depth of V-points. Type: string Ref.Value: depthv srcCrdOceBCPost_depthw Name of the coordinate variable for the depth of W-points. Type: string Ref.Value: depthw srcCrdOceBCPost_time Name of the coordinate variable for the time coordinate. Type: string Ref.Value: time_counter srcVarOceBCPost_temp Name of the variable for the Temperature. Type: string Ref.Value: glamf srcVarOceBCPost_sal Name of the variable for the Salinity. Type: string Ref.Value: gphit srcVarOceBCPost_ssh Name of the variable for the Sea Surface Height. Type: string Ref.Value: gphiu srcVarOceBCPost_velU Name of the variable for the Zonal Current. Type: string Ref.Value: gphiv srcVarOceBCPost_velV parametric the Merid. Current. Type: string Ref.Value: vmask ### Section set_dataDownlTideMesh_urlName This section of the JSON file contains the parameters needed to make up the URL that is required to access the input tidal forcing meshmask datasets from a local or remote ropository. urlTideMesh_usr Username to access the input tidal forcing meshmask datasets from a remote ftp server. Type: string Ref.Value: usr urlTideMesh_pwd Password to access the input tidal forcing meshmask datasets from a remote ftp server. Type: string Ref.Value: pwd urlTideMesh_urlbase Parametric urlname (i.e. ftp:/... or file:///...) for input tidal forcing meshmask datasets. Parameters: (CONS),YYYY(p)MM(p)DD(p). Type: string Ref.Value: file:///scratch/surf/surf_datasets/current/tide/TPXO8_atlas_30_v1_nc urlTideMesh_K1 Name for tidal constituent K1 used to replace the substring (CONS) on the parametrinc urlname. Type: string Ref.Value: K1 urlTideMesh_O1 Name for tidal constituent O1 used to replace the substring (CONS) on the parametrinc urlname. Type: string Ref.Value: O1 urlTideMesh_P1 Name for tidal constituent P1 used to replace the substring (CONS) on the parametrinc urlname. Type: string Ref.Value: P1 urlTideMesh_Q1 Name for tidal constituent Q1 used to replace the substring (CONS) on the parametrinc urlname. Type: string Ref.Value: Q1 urlTideMesh_K2 Name for tidal constituent K2 used to replace the substring (CONS) on the parametrinc urlname. Type: string Ref.Value: K2 urlTideMesh_M2 Name for tidal constituent M2 used to replace the substring (CONS) on the parametrinc urlname. Type: string Ref.Value: M2 urlTideMesh_N2 Name for tidal constituent N2 used to replace the substring (CONS) on the parametrinc urlname. Type: string Ref.Value: N2 urlTideMesh_S2 Name for tidal constituent S2 used to replace the substring (CONS) on the parametrinc urlname. Type: string Ref.Value: S2 urlTideMesh_M4 Name for tidal constituent M4 used to replace the substring (CONS) on the parametrinc urlname. Type: string Ref.Value: M4 urlTideMesh_Mm Name for tidal constituent Mm used to replace the substring (CONS) on the parametrinc urlname. Type: string Ref.Value: Mm urlTideMesh_Mf Name for tidal constituent Mf used to replace the substring (CONS) on the parametrinc urlname. Type: string Ref.Value: Mf ### Section set_dataDownlTideMesh_fileName This section of the JSON file contains the parameters needed to make up the FILENAMEs of the input tidal forcing meshmask datasets. fileTideMesh_filebase_bathy Parametric filename for tidal forcing meshmask input datasets. Parameters: (CONS). Type: string Ref.Value: grid_tpxo8(CONS).nc fileTideMesh_K1 Name for tidal constituent K1 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used) Type: string Ref.Value: atlas_30_v1 fileTideMesh_O1 Name for tidal constituent O1 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used) Type: string Ref.Value: atlas_30_v1 fileTideMesh_P1 Name for tidal constituent P1 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used) Type: string Ref.Value: atlas_30_v1 fileTideMesh_Q1 Name for tidal constituent Q1 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used) Type: string Ref.Value: atlas_30_v1 fileTideMesh_K2 Name for tidal constituent K2 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used) Type: string Ref.Value: atlas_30_v1 fileTideMesh_M2 Name for tidal constituent M2 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used) Type: string Ref.Value: atlas_30_v1 fileTideMesh_N2 Name for tidal constituent N2 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used) Type: string Ref.Value: atlas_30_v1 fileTideMesh_S2 Name for tidal constituent S2 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used) Type: string Ref.Value: atlas_30_v1 fileTideMesh_M4 Name for tidal constituent M4 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used) Type: string Ref.Value: atlas_30_v1 fileTideMesh_Mm Name for tidal constituent Mm used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used) Type: string Ref.Value: atlas_30_v1 fileTideMesh_Mf Name for tidal constituent Mf used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used) Type: string Ref.Value: atlas_30_v1 fileTideMesh_lcompression (=True) if the datasets you want to download are gzip compressed files (*.gz). Type: bool Ref.Value: False fileTideMesh_llonFlip (=True) if the longitude coord. is in the 0 to 360 range (=False) if longitude is in -180:+180 range. Type: bool Ref.Value: False fileTideMesh_llatInv (=True) if the dataset contains latitude decreasing through the pole. Type: bool Ref.Value: True fileTideMesh_lkeepSrcFull (=True) if you want to keep in your disk the downloaded uncutted datasets. Type: bool Ref.Value: True ### Section set_dataDownlTideMesh_varName This section of the JSON file contains the parameters for the VARIABLE-NAMEs of the input tidal forcing meshmask datasets. srcDimTideMesh_lont Name of the dimension for the longitude of T-points. Type: string Ref.Value: nx srcDimTideMesh_lonu Name of the dimension for the longitude of U-points. Type: string Ref.Value: nx srcDimTideMesh_lonv Name of the dimension for the longitude of V-points. Type: string Ref.Value: nx srcDimTideMesh_latt Name of the dimension for the latitude of T-points. Type: string Ref.Value: ny srcDimTideMesh_latu Name of the dimension for the latitude of U-points. Type: string Ref.Value: ny srcDimTideMesh_latv Name of the dimension for the latitude of V-points. Type: string Ref.Value: ny srcCrdTideMesh_lont Name of the variable containing longitude coordinate of T-points (if sbc_iformulat=1). Type: string Ref.Value: lon_z srcCrdTideMesh_lonu Name of the variable containing longitude coordinate of U-points (if sbc_iformulat=1). Type: string Ref.Value: lon_v srcCrdTideMesh_lonv Name of the variable containing longitude coordinate of V-points (if sbc_iformulat=1). Type: string Ref.Value: lon_v srcCrdTideMesh_latt Name of the variable containing latitude coordinate of T-points (if sbc_iformulat=1). Type: string Ref.Value: lat_z srcCrdTideMesh_latu Name of the variable containing latitude coordinate of U-points (if sbc_iformulat=1). Type: string Ref.Value: lat_u srcCrdTideMesh_latv Name of the variable containing latitude coordinate of V-points (if sbc_iformulat=1). Type: string Ref.Value: lat_v srcVarTideMesh_batt Name of the variable containing the Land Sea Mask of T-points (if sbc_iformulat=1). Type: string Ref.Value: hz srcVarTideMesh_batu Name of the variable containing the Land Sea Mask of U-points (if sbc_iformulat=1). Type: string Ref.Value: hz srcVarTideMesh_batv Name of the variable containing the Land Sea Mask of V-points (if sbc_iformulat=1). Type: string Ref.Value: hz ### Section set_dataDownlTide_urlName This section of the JSON file contains the parameters needed to make up the URL that is required to access the input tidal forcing datasets from a local or remote ropository. urlTide_usr Username to access the input tidal forcing datasets from a remote ftp server. Type: string Ref.Value: usr urlTide_pwd Password to access the input tidal forcing datasets from a remote ftp server. Type: string Ref.Value: pwd urlTide_urlbase Parametric urlname (i.e. ftp:/... or file:///...) for input tidal forcing datasets. Parameters: (CONS),YYYY(p)MM(p)DD(p). Type: string Ref.Value: file:///scratch/surf/surf_datasets/current/tide/TPXO8_atlas_30_v1_nc urlTide_K1 Name for tidal constituent K1 used to replace the substring (CONS) on the parametrinc urlname. Type: string Ref.Value: K1 urlTide_O1 Name for tidal constituent O1 used to replace the substring (CONS) on the parametrinc urlname. Type: string Ref.Value: O1 urlTide_P1 Name for tidal constituent P1 used to replace the substring (CONS) on the parametrinc urlname. Type: string Ref.Value: P1 urlTide_Q1 Name for tidal constituent Q1 used to replace the substring (CONS) on the parametrinc urlname. Type: string Ref.Value: Q1 urlTide_K2 Name for tidal constituent K2 used to replace the substring (CONS) on the parametrinc urlname. Type: string Ref.Value: K2 urlTide_M2 Name for tidal constituent M2 used to replace the substring (CONS) on the parametrinc urlname. Type: string Ref.Value: M2 urlTide_N2 Name for tidal constituent N2 used to replace the substring (CONS) on the parametrinc urlname. Type: string Ref.Value: N2 urlTide_S2 Name for tidal constituent S2 used to replace the substring (CONS) on the parametrinc urlname. Type: string Ref.Value: S2 urlTide_M4 Name for tidal constituent M4 used to replace the substring (CONS) on the parametrinc urlname. Type: string Ref.Value: M4 urlTide_Mm Name for tidal constituent Mm used to replace the substring (CONS) on the parametrinc urlname. Type: string Ref.Value: Mm urlTide_Mf Name for tidal constituent Mf used to replace the substring (CONS) on the parametrinc urlname. Type: string Ref.Value: Mf ### Section set_dataDownlTide_fileName This section of the JSON file contains the parameters needed to make up the FILENAMEs of the input tidal forcing meshmask datasets. fileTide_filebase_elev Parametric filename for the Tidal elevation complex amplitude (Imag part) datasets (if =NOTUSED, file not used). Parameters: (CONS), (RESTIDE). Type: string Ref.Value: grid_tpxo8(CONS).nc fileTide_filebase_velU Parametric filename for the Tidal WE transport complex amplitude (Imag part) datasets (if =NOTUSED, file not used). Parameters: (CONS), (RESTIDE). Type: string Ref.Value: grid_tpxo8(CONS).nc fileTide_filebase_velV Parametric filename for the Tidal SN transport complex amplitude (Imag part) datasets (if =NOTUSED, file not used). Parameters: (CONS), (RESTIDE). Type: string Ref.Value: grid_tpxo8(CONS).nc fileTide_K1 Name for tidal constituent K1 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used) Type: string Ref.Value: atlas_30_v1 fileTide_O1 Name for tidal constituent O1 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used) Type: string Ref.Value: atlas_30_v1 fileTide_P1 Name for tidal constituent P1 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used) Type: string Ref.Value: atlas_30_v1 fileTide_Q1 Name for tidal constituent Q1 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used) Type: string Ref.Value: atlas_30_v1 fileTide_K2 Name for tidal constituent K2 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used) Type: string Ref.Value: atlas_30_v1 fileTide_M2 Name for tidal constituent M2 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used) Type: string Ref.Value: atlas_30_v1 fileTide_N2 Name for tidal constituent N2 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used) Type: string Ref.Value: atlas_30_v1 fileTide_S2 Name for tidal constituent S2 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used) Type: string Ref.Value: atlas_30_v1 fileTide_M4 Name for tidal constituent M4 used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used) Type: string Ref.Value: atlas_30_v1 fileTide_Mm Name for tidal constituent Mm used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used) Type: string Ref.Value: atlas_30_v1 fileTide_Mf Name for tidal constituent Mf used to replace the substring (CONS) on the parametrinc filename (if =NOTUSED, component not used) Type: string Ref.Value: atlas_30_v1 fileTide_lcompression (=True) if the datasets you want to download are gzip compressed files (*.gz). Type: bool Ref.Value: False ### Section set_dataDownlTide_varName This section of the JSON file contains the parameters for the VARIABLE-NAMEs of the input tidal forcing meshmask datasets. srcDimTide_lont Name of the dimension for the longitude of T-points. Type: string Ref.Value: nx srcDimTide_lonu Name of the dimension for the longitude of U-points. Type: string Ref.Value: nx srcDimTide_lonv Name of the dimension for the longitude of V-points. Type: string Ref.Value: nx srcDimTide_latt Name of the dimension for the latitude of T-points. Type: string Ref.Value: ny srcDimTide_latu Name of the dimension for the latitude of U-points. Type: string Ref.Value: ny srcDimTide_latv Name of the dimension for the latitude of V-points. Type: string Ref.Value: ny srcCrdTide_lont Name of the variable containing longitude coordinate of T-points (if sbc_iformulat=1). Type: string Ref.Value: lon_z srcCrdTide_lonu Name of the variable containing longitude coordinate of U-points (if sbc_iformulat=1). Type: string Ref.Value: lon_v srcCrdTide_lonv Name of the variable containing longitude coordinate of V-points (if sbc_iformulat=1). Type: string Ref.Value: lon_v srcCrdTide_latt Name of the variable containing latitude coordinate of T-points (if sbc_iformulat=1). Type: string Ref.Value: lat_z srcCrdTide_latu Name of the variable containing latitude coordinate of U-points (if sbc_iformulat=1). Type: string Ref.Value: lat_u srcCrdTide_latv Name of the variable containing latitude coordinate of V-points (if sbc_iformulat=1). Type: string Ref.Value: lat_v srcVarTide_elevIm Name of the variable for the Tidal elevation complex amplitude (Imag part) of the Lunar diurnal K1 tidal component datasets (if =NOTUSED, file not used). Type: string Ref.Value: hIm srcVarTide_elevRe Name of the variable for the Tidal elevation complex amplitude (Real part) of the Lunar diurnal K1 tidal component datasets (if =NOTUSED, file not used). Type: string Ref.Value: hRe srcVarTide_velUIm Name of the variable for the Tidal WE transport complex amplitude (Imag part) of the Lunar diurnal K1 tidal component datasets (if =NOTUSED, file not used). Type: string Ref.Value: uIm srcVarTide_velURe Name of the variable for the Tidal WE transport complex amplitude (Real part) of the Lunar diurnal K1 tidal component datasets (if =NOTUSED, file not used). Type: string Ref.Value: uRe srcVarTide_velVIm Name of the variable for the Tidal SN transport complex amplitude (Imag part) of the Lunar diurnal K1 tidal component datasets (if =NOTUSED, file not used). Type: string Ref.Value: vIm srcVarTide_velVRe Name of the variable for the Tidal SN transport complex amplitude (Real part) of the Lunar diurnal K1 tidal component datasets (if =NOTUSED, file not used). Type: string Ref.Value: vRe ## Input parameters for manipulate Bathymetry ### Section set_manipolBat This section of the JSON file contains the free input parameters used to define ... manipBat_seaLevel Value to be add to bathymetry in order to modify the surface elevation (es. caspian Sea 28 meter). Type: float Ref.Value: 0.0 manipBat_minDepth Minimum bathy value of the whole domain (at sea gridpoints). Type: float Ref.Value: 5.0 manipBat_maxDepth Maximum bathy value of the whole domain (at sea gridpoints). Type: float Ref.Value: 22000.0 manipBat_lmoveDepth Enables the modification of bathy (to a given value >=0) inside rectangular regions. Type: bool Ref.Value: True manipBatMoveDepth_lonWest Longitude of the western boundary of rectangular regions where you want to move the depth. Type: float Ref.Value: 18.0 manipBatMoveDepth_lonEast Longitude of the eastern boundary of rectangular regions where you want to move the depth. Type: float Ref.Value: 18.375 manipBatMoveDepth_latSout Latitude of the southern boundary of rectangular regions where you want to move the depth. Type: float Ref.Value: 40.3 manipBatMoveDepth_latNort Latitude of the northern boundary of rectangular regions where you want to move the depth. Type: float Ref.Value: 40.5625 manipBatMoveDepth_depth Depth of rectangular regions where you want to move the depth (if=0.0 you add land points). Type: float Ref.Value: 0.0 ## Input parameters for shapiro filter datasets ### Section set_shapFiltBat This section of the JSON file contains the free input parameters used to define ... norder_shapFiltBat Order of the Shapiro Filter for the bathymetry data. Type: int Ref.Value: 2 nloop_shapFiltBat Numer of application of the Shapiro Filter for the bathymetry data. Type: int Ref.Value: 4 ### Section set_shapFiltOce This section of the JSON file contains the free input parameters used to define ... norder_shapFiltOce Order of the Shapiro Filter for the ocean output data. Type: int Ref.Value: 2 nloop_shapFiltOce Numer of application of the Shapiro Filter for the ocean output data. Type: int Ref.Value: 10 ## Input parameters for interpolation methods ### Section set_interpMethodBat This section of the JSON file contains the free input parameters used to define interpolation method to be used for the Sea Floor Elevation. interpMethodBat_elev Remapping method to use for the for the Sea Floor Elevation: bilin,bicub,distwgt. Type: string Ref.Value: bilin ### Section set_interpMethodAtm This section of the JSON file contains the free input parameters used to define interpolation method to be used for the atmospheric forcing fields. interpMethodAtm_velU Remapping method to use for the zonal component of air velocity (if sbc_iformulat=0,2): bilin,bicub,distwgt. Type: string Ref.Value: bilin interpMethodAtm_velV Remapping method to use for the meridional componente of air velocity (if sbc_iformulat=0,2): bilin,bicub,distwgt. Type: string Ref.Value: bilin interpMethodAtm_temp Remapping method to use for the Air Temperature (if sbc_iformulat=0,2): bilin,bicub,distwgt. Type: string Ref.Value: bilin interpMethodAtm_dpTemp Remapping method to use for the Dewpoint Temperature (if sbc_iformulat=0): bilin,bicub,distwgt. Type: string Ref.Value: bilin interpMethodAtm_mslp Remapping method to use for the mean sea level pressure (if sbc_iformulat=0): bilin,bicub,distwgt. Type: string Ref.Value: bilin interpMethodAtm_cloudCover Remapping method to use for the Dewpoint Temperature (if sbc_iformulat=0): bilin,bicub,distwgt. Type: string Ref.Value: bilin interpMethodAtm_prec Remapping method to use for the Total Precipitation (if sbc_iformulat=0,2): bilin,bicub,distwgt. Type: string Ref.Value: bilin interpMethodAtm_tauU Remapping method to use for the Zonal Wind Stress (if sbc_iformulat=1): bilin,bicub,distwgt. Type: string Ref.Value: bilin interpMethodAtm_tauV Remapping method to use for the Meridional Wind Stress (if sbc_iformulat=1): bilin,bicub,distwgt. Type: string Ref.Value: bilin interpMethodAtm_qtot Remapping method to use for the Total Heat Flux (if sbc_iformulat=1): bilin,bicub,distwgt. Type: string Ref.Value: bilin interpMethodAtm_qsr Remapping method to use for the Solar Radiation Penetration (if sbc_iformulat=1): bilin,bicub,distwgt. Type: string Ref.Value: bilin interpMethodAtm_emp Remapping method to use for the Mass Flux Exchanged (if sbc_iformulat=1): bilin,bicub,distwgt. Type: string Ref.Value: bilin interpMethodAtm_tempS Remapping method to use for the Surface Temperature (if sbc_iformulat=1): bilin,bicub,distwgt. Type: string Ref.Value: bilin interpMethodAtm_salS Remapping method to use for the Surface Salinity (if sbc_iformulat=1): bilin,bicub,distwgt. Type: string Ref.Value: bilin interpMethodAtm_umid Remapping method to use for the Air Umidity (if sbc_iformulat=2): bilin,bicub,distwgt. Type: string Ref.Value: bilin interpMethodAtm_radLW Remapping method to use for the Long Wave Radiation (if sbc_iformulat=2): bilin,bicub,distwgt. Type: string Ref.Value: bilin interpMethodAtm_radSW Remapping method to use for the Short Wave Radiation (if sbc_iformulat=2): bilin,bicub,distwgt. Type: string Ref.Value: bilin interpMethodAtm_snow Remapping method to use for the Solid Precipitation (if sbc_iformulat=2): bilin,bicub,distwgt. Type: string Ref.Value: bilin ### Section set_interpMethodOceIC This section of the JSON file contains the free input parameters used to define interpolation method to be used for the ocean IC fields. interpMethodOceIC_temp Remapping method to use for the Temperature: bilin,bicub,distwgt. Type: string Ref.Value: bilin interpMethodOceIC_sal Remapping method to use for the Salinity: bilin,bicub,distwgt. Type: string Ref.Value: bilin interpMethodOceIC_ssh Remapping method to use for the Sea Surface Height: bilin,bicub,distwgt. Type: string Ref.Value: bilin interpMethodOceIC_velU Remapping method to use for the Zonal Current: bilin,bicub,distwgt. Type: string Ref.Value: bilin interpMethodOceIC_velV Remapping method to use for the Meridional Current: bilin,bicub,distwgt. Type: string Ref.Value: bilin ### Section set_interpMethodOceBC This section of the JSON file contains the free input parameters used to define interpolation method to be used for the ocean BC fields interpMethodOceBC_temp Remapping method to use for the Temperature: bilin,bicub,distwgt. Type: string Ref.Value: bilin interpMethodOceBC_sal Remapping method to use for the Salinity: bilin,bicub,distwgt. Type: string Ref.Value: bilin interpMethodOceBC_ssh Remapping method to use for the Sea Surface Height: bilin,bicub,distwgt. Type: string Ref.Value: bilin interpMethodOceBC_velU Remapping method to use for the Zonal Current: bilin,bicub,distwgt. Type: string Ref.Value: bilin interpMethodOceBC_velV Remapping method to use for the Meridional Current: bilin,bicub,distwgt. Type: string Ref.Value: bilin ### Section set_interpMethodTide This section of the JSON file contains the free input parameters used to define interpolation method to be used for the tidal forcing fields interpMethodTide_elev Remapping method to use for the Tidal elevation: bilin,bicub,distwgt. Type: string Ref.Value: bilin interpMethodTide_velU Remapping method to use for the Tidal Zonal transport: bilin,bicub,distwgt. Type: string Ref.Value: bilin interpMethodTide_velV Remapping method to use for the Tidal Meridional transport: bilin,bicub,distwgt. Type: string Ref.Value: bilin ## Input parameters for the selection of variables to be saved in the output file ### Section set_lvarOceOutT This section of the JSON file contains the free input parameters used to define ... lvarOceOutT_temp Enables if you want write Temperature (votemper) field in the output file. Type: bool Ref.Value: True lvarOceOutT_sal Enables if you want write Salinity (vosaline) field in the output file. Type: bool Ref.Value: True lvarOceOutT_tempS Enables if you want write Surface Temperature (sosstsst) field in the output file. Type: bool Ref.Value: False lvarOceOutT_salS Enables if you want write Surface Salinity (sosaline) field in the output file. Type: bool Ref.Value: False lvarOceOutT_ssh Enables if you want write Sea Surface Height (sossheig) field in the output file. Type: bool Ref.Value: True lvarOceOutT_fluxWater_up Enables if you want write Net Upward Water Flux (sowaflup) field in the output file. Type: bool Ref.Value: False lvarOceOutT_fluxSalt_down Enables if you want write downward salt flux (sosfldow) field in the output file. Type: bool Ref.Value: False lvarOceOutT_fluxHeat_down Enables if you want write Net Downward Heat Flux (sohefldo) field in the output file. Type: bool Ref.Value: False lvarOceOutT_fluxHeatS_damp Enables if you want write Surface Heat Flux: Damping (sohefldp) field in the output file. Type: bool Ref.Value: False lvarOceOutT_fluxWaterS_damp Enables if you want write Surface Water Flux: Damping (sowafldp) field in the output file. Type: bool Ref.Value: False lvarOceOutT_fluxSaltS_damp Enables if you want write Surface salt flux: damping (sosafldp) field in the output file. Type: bool Ref.Value: False lvarOceOutT_runoffs Enables if you want write River runoffs (sorunoff) field in the output file. Type: bool Ref.Value: False lvarOceOutT_tempConcen Enables if you want write Concentration/Dilution term on temperature (sosst_cd) field in the output file. Type: bool Ref.Value: False lvarOceOutT_salConcen Enables if you want write Concentration/Dilution term on salinity (sosss_cd) field in the output file. Type: bool Ref.Value: False lvarOceOutT_radSW Enables if you want write Shortwave Radiation (soshfldo) field in the output file. Type: bool Ref.Value: False lvarOceOutT_depthTurb Enables if you want write Turbocline Depth (somixhgt) field in the output file. Type: bool Ref.Value: False lvarOceOutT_mld Enables if you want write Mixed Layer Depth 0.01 (somxl010) field in the output file. Type: bool Ref.Value: False lvarOceOutT_iceFrac Enables if you want write Ice fraction (soicecov) field in the output file. Type: bool Ref.Value: False lvarOceOutT_wind10 Enables if you want write wind speed at 10m (sowindsp) field in the output file. Type: bool Ref.Value: False lvarOceOutT_bowlin Enables if you want write Bowl Index (sobowlin) field in the output file. Type: bool Ref.Value: False ### Section set_lvarOceOutU This section of the JSON file contains the free input parameters used to define ... lvarOceOutU_velU Enables if you want write Zonal Current (vozocrtx) field in the output file. Type: bool Ref.Value: True lvarOceOutU_tauU Enables if you want write Zonal Wind Stress (sozotaux) field in the output file. Type: bool Ref.Value: False ### Section set_lvarOceOutV This section of the JSON file contains the free input parameters used to define ... lvarOceOutV_velV Enables if you want write Meridional Current (vomecrty) field in the output file. Type: bool Ref.Value: True lvarOceOutV_tauV Enables if you want write Meridional Wind Stress (sometauy) field in the output file. Type: bool Ref.Value: False ### Section set_lvarOceOutW This section of the JSON file contains the free input parameters used to define ... lvarOceOutW_velW Enables if you want write Vertical Velocity (vovecrtz) field in the output file. Type: bool Ref.Value: False lvarOceOutW_eddyDiffW Enables if you want write Vertical Eddy Diffusivity (votkeavt) field in the output file. Type: bool Ref.Value: False lvarOceOutW_eddyViscW Enables if you want write Vertical Eddy Viscosity (votkeavm) field in the output file. Type: bool Ref.Value: False ## Input parameters for data compression ### Section set_lzip This section of the JSON file contains the free input parameters used to define ... lzip_indata Enables/disable gzip compression of the Indata Bat,Atm,OceIC,OceBC files. Type: bool Ref.Value: False lzip_extrapdata Enables/disable gzip compression of the Extrapdata Atm,OceIC,OceBC files. Type: bool Ref.Value: False lzip_indata Enables/disable gzip compression of the Regriddata Bat,Atm,OceIC,OceBC,OceBCbdy files. Type: bool Ref.Value: False lzip_indata Enables/disable gzip compression of the Outdata Ocean files. Type: bool Ref.Value: False # User Configuration File: Postprocessing Sections In this chapter we continue to explore the contents of the configuration file. In particular we will examine in details the sections B used to manage the post-processing procedures for the visualization of input/output datasets, the comparison of child/parent fields and the comparison of the simulation result with insitu or satellite datasets. ## Input parameters for selecting the figure to generate ### Section set_lplot The section set_lrun contains the logical parameters to activate/deactivate specific plot. lplot_domain Enable/disable the plotting of the user defined Domains. Type: bool Ref.Value: True lplot_indata Enable/disable the plotting of the Input Bat,Atm,OceIC,OceBC data. Type: bool Ref.Value: True lplot_extrapdata Enable/disable the plotting of the Extrapolated Atm,OceIC,OceBC data. Type: bool Ref.Value: True lplot_intUVdata Enable/disable the plotting of the Interpolated OceIC(U,V),OceBC(U,V) data. Type: bool Ref.Value: True lplot_rotUVdata Enable/disable the plotting of the Rotated OceIC(U,V),OceBC(U,V) data. Type: bool Ref.Value: True lplot_regriddata Enable/disable the plotting of the Regridded Bat,Atm,OceIC,OceBC,OceBCbdy data. Type: bool Ref.Value: True lplot_outdata Enable/disable the plotting of the Output Ocean data. Type: bool Ref.Value: True lplot_chlVSpar Enable/disable the plotting of the child VS. parent Ocean fields. Type: bool Ref.Value: False lplot_surfVSctd Enable/disable the plotting of the surf VS. ctd Ocean fields. Type: bool Ref.Value: False lplot_surfVSmooring Enable/disable the plotting of the surf VS. mooring Ocean fields. Type: bool Ref.Value: True lplot_surfVSferrybox Enable/disable the plotting of the surf VS. ferrybox Ocean fields. Type: bool Ref.Value: False lplot_surfVSsat Enable/disable the plotting of the surf VS. satellite Ocean fields. Type: bool Ref.Value: False ### Section set_visual_lplot The section set_lrun contains the logical parameters to activate/deactivate specific plot. lplotChildMesh Enable/disable the plotting of the Child MeshMask fields. Type: bool Ref.Value: True lplotBat Enable/disable the plotting of the Bathymetry fields. Type: bool Ref.Value: True lplotAtm Enable/disable the plotting of the Atmspheric fields. Type: bool Ref.Value: True lplotOceIC Enable/disable the plotting of the Initial Condition Ocean fields. Type: bool Ref.Value: True lplotOceBC Enable/disable the plotting of the Open Boundary Condition Ocean fields. Type: bool Ref.Value: True lplotOceBCbdy Enable/disable the plotting of the Open Boundary Condition Ocean fields. Type: bool Ref.Value: True lplotTide Enable/disable the plotting of the Tidal fields. Type: bool Ref.Value: True lplotTidebdy Enable/disable the plotting of the Tidal fields. Type: bool Ref.Value: True lplotOceOut Enable/disable the plotting of the Output Ocean fields. Type: bool Ref.Value: False ## Input parameters for figure properties ### Section set_lplot The section set_visual_fileImg contains the logical parameters to . fileImg_type Type of the image file to generate. Type: string Ref.Value: png fileImg_wkWidth Horizontal resolution (number of pixels) of the image file. Type: int Ref.Value: 2400 fileImg_wkHeight Vertical resolution (number of pixels) of the image file. Type: int Ref.Value: 2400 ### Section set_visual_lvis The section set_visual_lvis contains the logical parameters to . lvis_title Enable/disable the visibility of a given string as the main title. Type: bool Ref.Value: True lvis_mplotDif Enable/disable the plotting of the Bathymetry fields. Type: bool Ref.Value: True lvis_leftString Enable/disable the visibility of a given string above the plot’s upper boundary and left. Type: bool Ref.Value: True lvis_rightString Enable/disable the visibility of a given string above the plot’s upper boundary and right. Type: bool Ref.Value: True lvis_axisLab Enable/disable the visibility of the X an Y axis title. Type: bool Ref.Value: True lvis_tickmarks Enable/disable the visibility of the right, left, top and bottom tick marks. Type: bool Ref.Value: True lvis_borders Enable/disable the visibility of the right, left, top and bottom borders. Type: bool Ref.Value: True lvis_mapFillOn Enable/disable the visibility of the map area fill. Type: bool Ref.Value: True lvis_mapOutlineOn Enable/disable the visibility of the map area outlines. Type: bool Ref.Value: True lvis_vecRefAnnoOn Enable/disable the visibility of the reference vector annotation. Type: bool Ref.Value: True lvis_labbarOn Enable/disable the visibility of the LabelBar. Type: bool Ref.Value: True lvis_labbarLabelsOn Enable/disable the visibility of the LabelBar. Type: bool Ref.Value: True lvis_panelbarOn Enable/disable the visibility of the PannelBar. Type: bool Ref.Value: True lvis_infoContourOn Enable/disable the visibility of the info contour. Type: bool Ref.Value: True lvis_grid Enable/disable the visibility of the mesh grid. Type: bool Ref.Value: True lvis_myCoastline Enable/disable the visibility of the user coastline. Type: bool Ref.Value: True lvis_fillcurves Enables the filling of the area between two curves. Type: bool Ref.Value: True lvis_boxNest Enable/disable the visibility of the nest rectangular box. Type: bool Ref.Value: True ### Section set_visual_graph The section set_visual_graph contains the logical parameters to . graph_projection Projection used for the map transformation. (es. CylindricalEquidistant,Mercator,...). Type: string Ref.Value: Mercator graph_fillMode How ContourPlot performs fill: (=AreaFill), (=RasterFill),(=CellFill). Type: string Ref.Value: AreaFill graph_minDistVec Minimum distance (in NDC space) that is to separate the data locations of neighboring vectors. Type: float Ref.Value: 0.015 graph_thickArrowVec Thickness of the line used to draw vector line arrows. Type: float Ref.Value: 2.0 graph_refMagnVecAtm Reference magnitude used for the wind vector field. Type: float Ref.Value: 3.0 graph_refMagnVecOce Reference magnitude used for the current vector field. Type: float Ref.Value: 0.6 graph_styleVec Style of glyph used to represent the vector magnitude and direction: (=LineArrow) ... (=CurlyVector) .... Type: string Ref.Value: CurlyVector graph_iPlOrient Panels orientation in the multi plots figure: (=0)vertical, (=1)horizontal. Type: int Ref.Value: 1 graph_nlevsBar Number of the .... Type: int Ref.Value: 21 graph_polymarkerSize Size used to draw the marker in the polymarker plots. Type: float Ref.Value: 0.01 graph_markLineMode Draw the curves using lines only (=Lines), markers only (=Markers), both lines and markers (=MarkLines). Type: string Ref.Value: MarkLines graph_lineThick Thickness of the line used to draw the curves. Type: float Ref.Value: 2.5 graph_markerSize Size used to draw the marker in the xy-plots. Type: float Ref.Value: 0.01 graph_markers Style of the markers in the xy-plots. Type: float Ref.Value: 16 graph_boxThick Thickness of the line used to draw the box. Type: float Ref.Value: 8.0 graph_boxColor Color of the line used to draw the box. Type: string Ref.Value: red # Input/Output Model Datasets In order to execute the SURF-NEMO package, the user has to provide several input datasets. These include the bathymetry datasets containing the seafloor elevation, the coastline datasets delineating borders between land and sea areas, the initial condition dataset containing the initial values of model-predicted variables and the boundary condition datasets containing the values of the variables needed to impose the boundary conditions on flows of mass, momentum and energy for the primitive equation at the surface and lateral open boundaries of the domain. In Figure 5.1 are summarized the interfaces and the external forcings acting on a typical computational domain. ## Input Datasets The input model datasets are provided in the classic NetCDF format for bathymetry, initial and lateral boundary condition. NetCDF is a widely used file format in atmospheric and oceanic research which allows storage of different types of array based data, along with a short data description. The coastline datasets are instead provided in Shapefile format, a digital vector data format for geographic information system (GIS) software. SURF allows also to use, if needed, two different model type of input data during the execution (i.e. analysis data for the spinup time and forecast data after). The user has to set-up few parameters in the configuration file  setParFree.json  in order to specify the values of path/filename, dimensions/variables name and characteristics of data. ### Bathymetry Dataset The bathymetry dataset contains the sea floor elevation. This dataset is required to generate the child meshmask file. The user needs to set-up the required parameters in the sections set_dataDownlBat of the configuration file. The data are distributed on a curvilinear spherical grid (regular or not) within a region containing the nested domain. The bathymetry file contains the elevation variable (in meters) at a certain horizontal resolution. The elevation is relative to a specific reference level and can increases (positive) or decreases (negative) with increasing water depth. The coordinate variables (latitude/longitude) can be a one- or two-dimensional array. An example of CDL text representation of this file is shown in Listing 5.1. netcdf bathymetry_filename { dimensions: x = 300; y = 200; variables: \\ float lon(y,x); lon: units = "degrees_east"; float lat(y,x); lat: units = "degrees_north"; float elevation(y,x); elevation: units = "m"; }  Listing 5.1: Example of a netCDF file for bathymetry. The user needs to specify the following logical parameters in section set_dataDownlBat_fileName of the user-configuration file: • fileBat_lcompression if the file to download is compressed (.gzip) or not, • fileBat_llonFlip if the longitude coordinate is defined in the rage [0:360] or [-180:+180], • fileBat_llatInv if the dataset contains latitude decreasing through the pole, • fileBat_ldepthIncr if the dataset contains seafloor elevation (positive) increases with increasing water depth, • fileBat_lkeepSrcFull if the original downloaded file needs to be deleted after cutted in the nested domain. The available input bathymetry datasets inside the surf package is the General Bathymetric Chart of the Oceans (GEBCO), a publicly available bathymetry data sets with global coverage at 30 arc-second resolution. ### Coastline Dataset The coastline dataset contains borders between land and sea areas and is stored into shapefiles. The coastline is required in the child meshmask generation phase. The user needs to set-up the required parameters in the sections set_dataDownlCoast of the configuration file. The available input coastline datasets inside the surf packages is the Global Self-consistent Hierarchical High-resolution Geography (GSHHG) dataset produced by the National Oceanic and Atmospheric Association (NOAA). The datasets include 20 shapefiles which provides a consistent set of hierarchically arranged closed polygons from which the shorelines are constructed. The GSHHS data are split into separate shapefiles at five different resolutions: • the highest resolution is designated 'f' (full) with a resolution of xx m, • the next highest appears as 'h' (high) with a resolution of xx m, • the (intermediate) 'i' with a resolution of xx m, • the (low) 'l' with a resolution of xx m, • the (coarse) 'c' with a resolution of xx m. For each level of resolution Shorelines are organized into four levels: boundary between land and ocean (L1), boundary between lake and land (L2), boundary between island-in-lake and lake (L3), and boundary between pond-in-island and island (L4). These datasets use the geographic coordinate system WGS84 (simple latitudes and longitudes; decimal degrees) . ### Initial Condition Datasets In order to start a model run, the initial values for the model prognostic variables need to be specified. These include temperature, salinity, sea surface height, zonal and meridional velocity components fields. Initial condition datasets are normally provided by coarse grid model outputs. The user needs to set-up the required parameters in the sections set_dataDownlOceIC of the configuration file. The data can be distributed on a curvilinear spherical grid (regular or not) with unstaggered or staggered Arakawa-C grid arrangement within a region containing the nested domain. The model assumes that all the input ocean variables are defined on the same grid. The coarse-resolution ocean files contain the following variables at a certain horizontal resolution. • Potential Temperature [$$C$$], • Salinity [$$PSU$$], • Sea surface height [$$m$$], • Zonal velocity [$$ms^{-1}$$], • Meridional Velocity [$$ms^{-1}$$]. An example of CDL text representation of this file is shown in Listing 5.2. netcdf fields_filename { dimensions: x = 40 ; y = 35 ; z = 72 ; time = UNLIMITED ; // (1 currently) variables: float lont(y, x) ; lont:units = "degrees_east" ; float latt(y, x) ; latt:units = "degrees_north" ; float deptht(z) ; deptht:units = "m" ; double time(time) ; time_counter:units = "seconds since 1970-01-01 00:00:00" ; float temperature(time, z, y, x) ; temperature:units = "degC" ; } dimensions : x = 677; y = 253; z = 72; t = UNLIMITED; // (7 currently) variables : \\ float lont(x); lont: units = "degrees_east"; float latt(y); latt: units = "degrees_north"; float deptht(z); deptht: units = "m"; double time(t); time: units = "seconds since 1970-01-01 00:00:00"; float temperature(t,z,y,x); temperature: units = "degC"; }  Listing 5.2: Example of a netCDF file for the Initial Condition temperature In order to perform the extrapolation (SOL) of ocean fields (see section 2.3), the parent land-sea mask file needs to be provided as input datasets. The user needs to set-up the required parameters in the sections set_dataDownlOceICMesh of the configuration file. This file contains all the information of the coarse-resolution ocean model grids and it includes the following variables: • longitude on TUVF grid points [$$degree$$], • latitude on TUVF grid points [$$degree$$], • depth on TUVF grid points [$$m$$], • land-sea mask on TUVF grid points [0-1], • scalefactor on TUVF grid points [$$m$$], • scalefactor on TUVF grid points [$$m$$], • scalefactor on TUVF grid points [$$m$$]. An example of CDL text representation of this file is shown in Listing 5.3. netcdf meshmask_filename { dimensions : x = 677; y = 253; z = 72; t = UNLIMITED; // (7 currently) variables : \\ float lon(y,x); float lat(y,x); float lev(z); double time(t); byte tmask(t,z,y,x); byte umask(t,z,y,x); byte vmask(t,z,y,x); byte fmask(t,z,y,x); float glamt(t,y,x); float glamu(t,y,x); float glamv(t,y,x); float glamf(t,y,x); float gphit(t,y,x); float gphiu(t,y,x); float gphiv(t,y,x); float gphif(t,y,x); double e1t(t,y,x); double e1u(t,y,x); double e1v(t,y,x); double e1f(t,y,x); double e2t(t,y,x); double e2u(t,y,x); double e2v(t,y,x); double e2f(t,y,x); double e3t(t,z,y,x); double e3u(t,z,y,x); double e3v(t,z,y,x); double e3w(t,z,y,x); }  Listing 5.3: Example of a netCDF file for the Initial Condition meshmask. ### Lateral Open Boundary Condition Datasets In order to integrate the primitive equations, the NEMO ocean model needs to impose appropriate boundary conditions at the ocean-ocean interface (i.e. the sides of the domain not bounded by land). Lateral Open Boundary values for the model prognostic variables need to be specified for all the simulation period. These include temperature, salinity, sea surface height, and velocity fields. The user needs to set-up the required parameters in the sections set_dataDownlOceBC_preSpinup and set_dataDownlOceBC_postSpinup of the configuration file. The data can be distributed on a curvilinear spherical grid (regular or not) with unstaggered or staggered Arakawa-C grid arrangement within a region containing the nested domain. The model assumes that all the input ocean variables in pre- and post- spinup period are defined on the same grid. The coarse-resolution ocean files contain the following variables at a certain horizontal resolution and temporal frequency. • Potential Temperature [$$C$$], • Salinity [$$PSU$$], • Sea surface height [$$m$$], • Zonal velocity [$$ms^{-1}$$], • Meridional Velocity [$$ms^{-1}$$]. An example of CDL text representation of this file is shown in Listing 5.4. netcdf fields_filename { dimensions : x = 677; y = 253; z = 72; t = UNLIMITED; // (7 currently) variables : \\ float lont(x); lont: units = "degrees_east"; float latt(y); latt: units = "degrees_north"; float deptht(z); deptht: units = "m"; double time(t); time: units = "seconds since 1970-01-01 00:00:00"; float temperature(t,z,y,x); temperature: units = "degC"; }  Listing 5.4: Example of a netCDF file for Open boundary Condition temperature. In order to perform the extrapolation (SOL) of ocean fields (see section 2.3), the parent land-sea mask file needs to be provided as input datasets. The user needs to set-up the required parameters in the sections set_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 assumes that all the input tidal harmonic variables are defined on the same grid. The barotropic tide files contain for each harmonic constituents the following variables at a certain horizontal resolution. • Tidal elevation complex amplitude, Real and Imaginary part [$$mm$$], • Tidal WE transport complex amplitude, Real and Imaginary part [$$cm^2/s$$], • Tidal SN transport complex amplitude, Real and Imaginary part [$$cm^2/s$$], An example of CDL text representation of this file is shown in Listing 5.6. netcdf uv.k1_tpxo8_atlas_30c_v1 { dimensions: nx = 10800 ; ny = 5401 ; variables: double lon_u(nx) ; lon_u:units = "degree_east" ; double lat_u(ny) ; lat_u:units = "degree_north" ; double lon_v(nx) ; lon_v:units = "degree_east" ; double lat_v(ny) ; lat_v:units = "degree_north" ; int uRe(nx, ny) ; uRe:units = "centimeter^2/sec" ; int uIm(nx, ny) ; uIm:units = "centimeter^2/sec" ; int vRe(nx, ny) ; vRe:units = "centimeter^2/sec" ; int vIm(nx, ny) ; vIm:units = "centimeter^2/sec" ; }  Listing 5.6: Example of a netCDF file for the Zonal and meridional Tidal transport for the constituent K1. The tidal model bathymetry file needs to be provided as input datasets. The user needs to set-up the required parameters in the sections set_dataDownlTideMesh of the configuration file. This file contains all the information of the tidal model grids and depth grid and it includes the following variables: • longitude on TUV grid points [$$degree$$], • latitude on TUV grid points [$$degree$$], • Bathymetry at TUV grid points [$$m$$]. An example of CDL text representation of this file is shown in Listing 5.7. netcdf grid_tpxo8atlas_30_v1 { dimensions: nx = 10800 ; ny = 5401 ; variables: double lon_z(nx) ; lon_z:units = "degree_east" ; double lat_z(ny) ; lat_z:units = "degree_north" ; double lon_u(nx) ; lon_u:units = "degree_east" ; double lat_u(ny) ; lat_u:units = "degree_north" ; double lon_v(nx) ; lon_v:units = "degree_east" ; double lat_v(ny) ; lat_v:units = "degree_north" ; float hz(nx, ny) ; hz:units = "meter" ; float hu(nx, ny) ; hu:units = "meter" ; float hv(nx, ny) ; hv:units = "meter" ; }  Listing 5.7: Example of a netCDF file for the Initial Condition meshmask. The available input barotropic tide datasets inside the surf packages are derived from the Topex Poseidon cross-over (TPX08-ATLAS) global inverse tide model obtained with the software package OTIS (OSU Tidal Inversion Software) implementing methods described in Egbert and Erofeeva, 2002. The TPX08 tidal model consists of a multi-resolution bathymetric grid solution, with a 1/6 solution in the global open ocean, and a 1/30 local resolution solution to improve modelling in complex shallow-water environments. It includes complex amplitudes of the tide sea-surface elevations and transports for eight primaries (M2, S2, N2, K2, K1, O1, P1, Q1), two long-period (Mf, Mm) and 3 non-linear (M4, MS4, MN4) harmonic constituents. ### Atmospheric Forcing Datasets In order to integrate the primitive equations, the NEMO ocean model needs to impose appropriate boundary conditions on flows of mass, momentum and energy at the atmosphere-ocean interface. It must be provided on the integration domain the following six fields: 1. the zonal components of the surface ocean stress, 2. the meridional components of the surface ocean stress, 3. the heat fluxes from solar Qsr, 4. the heat fluxes from non-solar Qns radiation, 5. the water flows exchanged with the atmosphere (E-P) (the evaporation minus precipitation budget). In addition an optional field: 1. the atmospheric pressure at the ocean surface (pa). The NEMO ocean model provides different ways to provide the first six fields to the ocean which are controlled by namelist variables (see NEMO Manual). The choice of the atmospheric forcing formulation in SURF platform is obtained by setting the parameter sbc_iformulat in the user configuration file: • sbc_iformulat=0 for the MFS bulk formulae, • sbc_iformulat=1 for the the Flux formulation, • sbc_iformulat=2 for the CORE bulk formula. The data are distributed on a regular unstaggered grid within a region containing the nested domain. The model assumes that input atmospheric variables in pre- and post- spinup period are defined on the same mesh but allowed different mesh for different variables. The user needs to set-up the required parameters in the sections set_dataDownlAtm_preSpinup and set_dataDownlAtm_postSpinup of the configuration file. (1) The choice of MFS bulk formulae is obtained by setting the parameter sbc_iformulat=0 in the user configuration file. The atmospheric forcing files contain the following variables at a certain horizontal resolution and temporal frequency: • 10 m zonal wind component [$$ms^{-1}$$], • 10 m meridional wind component [$$ms^{-1}$$], • 2m Air Temperature [$$K$$], • 2m Dew Point Temperature [$$K$$], • Mean Sea Level Pressure [$$hPa$$], • Total Cloud Cover [%]. • Total Precipitation [$$Kgm^{-2}s^{-1}$$]. An example of CDL text representation for the atmospheric forcing file with temporal frequency of 3 hours is shown in box in Listing 5.8. netcdf atmFields_filename { dimensions : lon = 245; lat = 73; time = UNLIMITED; // (8 currently) variables : \\ float lon(lon); lon: units = "degrees_east"; float lat(lat); lat: units = "degrees_north"; float time(time); time: units = "seconds since 1970-01-01 00:00:00"; float T2M(time,lat,lon); T2M: units = "K"; }  Listing 5.8: Example of a netCDF file for the Atmospheric Forcing temperature. (2) The choice of Core bulk formulae is obtained by setting the parameter sbc_iformulat=2 in the user configuration file. The atmospheric forcing files contain the following variables at a certain horizontal resolution and temporal frequency: • 10 m zonal wind component [$$ms^{-1}$$], • 10 m meridional wind component [$$ms^{-1}$$], • 2m Temperature [$$K$$], • 2m Specific humidity [$$\%$$], • Incoming long-wave radiation [$$W m^{-2}$$], • Incoming short-wave radiation [$$W m^{-2}$$], • Total precipitation (liquid+solid) [$$Kg m^{-2} s^{-1}$$], • Solid precipitation [$$Kg m^{-2} s^{-1}$$]. An example of CDL text representation for the atmospheric forcing file with temporal frequency of 3 hours is shown in box in Listing 5.9. netcdf atmFields_filename { dimensions : lon = 245; lat = 73; time = UNLIMITED; // (8 currently) variables : \\ float lon(lon); lon: units = "degrees_east"; float lat(lat); lat: units = "degrees_north"; float time(time); time: units = "seconds since 1970-01-01 00:00:00"; float T2M(time,lat,lon); T2M: units = "K"; }  Listing 5.9: Example of a netCDF file for the Atmospheric Forcing temperature. (3) The choice of Flux formulation is obtained by setting the parameter sbc_iformulat=1 in the user configuration file. The atmospheric forcing files contain the following variables at a certain horizontal resolution and temporal frequency: • Zonal wind stress [0 - 1], • Meridional Wind stress [0 - 1], • Total heat flux [0 - 1], • Solar Radiation Penetration [0 - 1], • Mass flux exchanged [0 - 1], • Surface Temperature [0 - 1], • Surface Salinity [0 - 1]. An example of CDL text representation for the atmospheric forcing file with temporal frequency of 3 hours is shown in box in Listing 5.10. netcdf atmFields_filename { dimensions : lon = 245; lat = 73; time = UNLIMITED; // (8 currently) variables : \\ float lon(lon); lon: units = "degrees_east"; float lat(lat); lat: units = "degrees_north"; float time(time); time: units = "seconds since 1970-01-01 00:00:00"; float T2M(time,lat,lon); T2M: units = "K"; }  Listing 5.10: Example of a netCDF file for the Atmospheric Forcing temperature. In order to perform the extrapolation (SOL) of atmospheric fields (see section 2.3), the atmospheric meshmask file needs to be provided as input datasets. The user needs to set-up the required parameters in the sections set_dataDownlAtmMesh of the configuration file. The atmospheric meshmask file contains the land-sea mask [0-1] variable. An example of CDL text representation of the atmospheric land-sea mask is shown in Listing 5.11. The time dimension and coordinate variable can also be omitted. netcdf meshmask_filename { dimensions : lon = 245; lat = 73; time = UNLIMITED; // (1 currently) variables : \\ float lon(lon); lon: units = "degrees_east"; float lat(lat); lat: units = "degrees_north"; float time(time); time: units = "seconds since 1970-01-01 00:00:00"; float LSM(time,lat,lon); LSM: units = "0-1"; }  Listing 5.11: Example of a netCDF file for the Atmospheric Forcing meshmask. ## Output Datasets The output model datasets are provided in the NetCDF format .. the meshmask file, the output files for T, U ,V, W grids and the restart file. ### Meshmask dataset This file contains all the information of the child ocean model grids and it includes the following variables: • longitude on TUVF grid points [$$degree$$], • latitude on TUVF grid points [$$degree$$], • depth on TUVF grid points [$$m$$], • land-sea mask on TUVF grid points [0-1], • scalefactor on TUVF grid points [$$m$$], • scalefactor on TUVF grid points [$$m$$], • scalefactor on TUVF grid points [$$m$$]. An example of CDL text representation of this file is shown in Listing 5.21. netcdf meshmask_filename { dimensions : x = 677; y = 253; z = 72; t = UNLIMITED; // (7 currently) variables : \\ float lon(y,x); float lat(y,x); float lev(z); double time(t); byte tmask(t,z,y,x); byte umask(t,z,y,x); byte vmask(t,z,y,x); byte fmask(t,z,y,x); float glamt(t,y,x); float glamu(t,y,x); float glamv(t,y,x); float glamf(t,y,x); float gphit(t,y,x); float gphiu(t,y,x); float gphiv(t,y,x); float gphif(t,y,x); double e1t(t,y,x); double e1u(t,y,x); double e1v(t,y,x); double e1f(t,y,x); double e2t(t,y,x); double e2u(t,y,x); double e2v(t,y,x); double e2f(t,y,x); double e3t(t,z,y,x); double e3u(t,z,y,x); double e3v(t,z,y,x); double e3w(t,z,y,x); }  Listing 5.21: CDL example for the meshmask datasets. ### Ocean Output Datasets …contains: (1) This output file SURF_1h_YYYYMMDD0_YYYYMMDD1_grid_T contains hourly fields defined on the Arakawa-T grid within the chid nested domain. This file contains the following variables: • Temperature [$$C$$], • Salinity [$$PSU$$], • Sea Surface temperature [$$C$$], • Sea Surface salinity [$$PSU$$], • Sea Surface Height [$$m$$], • Net Upward Water Flux [$$Kg=m2=s$$], • concentration/dilution water flux [$$Kg=m2=s$$], • Surface Salt Flux [$$Kg=m2=s$$], • Net Downward Heat Flux [$$W=m2$$], • Shortwave Radiation [$$W=m2$$], • Turbocline Depth [$$m$$], • Mixed Layer Depth 0.01 [$$W=m2$$], • Ice fraction [$$0;1$$], • wind speed at 10m [$$m=s$$], • Surface Heat Flux: Damping [$$W=m2$$], • Surface Water Flux: Damping [$$Kg=m2=s$$], • Surface salt flux: damping [$$Kg=m2=s$$], • Bowl Index[$$W point$$]. An example of CDL text representation of this file is shown in Listing 5.22. netcdf fields_filename { dimensions : lon = 677; lat = 253; depth = 72; time = UNLIMITED; // (7 currently ) variables : \\ float lont (x); lont : units = " degrees_east "; float latt (y); latt : units = " degrees_north "; float deptht (z); deptht : units = "m"; double time (t); time : units = " seconds since 1970-01-01 00:00:00"; float temperature (t, z, y, x); temperature : units = " degC "; }  Listing 5.22: CDL example for the bdyV_u3d data. (2) This output file SURF_1h_YYYYMMDD0_YYYYMMDD1_grid_U contains hourly fields defined on the Arakawa-U grid within the chid nested domain. This file contains the following variables: • Zonal Current [$$m/s$$], • Wind Stress along zonal-axis [$$N/m^2$$], An example of CDL text representation of this file is shown in Listing 5.23. netcdf fields_filename { dimensions : lon = 677; lat = 253; depth = 72; time = UNLIMITED; // (7 currently ) variables : \\ float lont (x); lont : units = " degrees_east "; float latt (y); latt : units = " degrees_north "; float deptht (z); deptht : units = "m"; double time (t); time : units = " seconds since 1970-01-01 00:00:00"; float temperature (t, z, y, x); temperature : units = " degC "; }  Listing 5.23: CDL example for the bdyV_u3d data. (3) This output file SURF_1h_YYYYMMDD0_YYYYMMDD1_grid_V contains hourly fields defined on the Arakawa-V grid within the chid nested domain. This file contains the following variables: • Meridional Current [$$m/s$$], • Wind Stress along meridional-axis [$$N/m^2$$], An example of CDL text representation of this file is shown in Listing 5.23. netcdf fields_filename { dimensions : lon = 677; lat = 253; depth = 72; time = UNLIMITED; // (7 currently) variables : \\ float lont(x); lont: units = "degrees_east"; float latt(y); latt: units = "degrees_north"; float deptht(z); deptht: units = "m"; double time(t); time: units = "seconds since 1970-01-01 00:00:00"; float temperature(t,z,y,x); temperature: units = "degC"; }  (4) This output file SURF_1h_YYYYMMDD0_YYYYMMDD1_grid_W contains hourly fields defined on the Arakawa-W grid within the chid nested domain. This file contains the following variables: • Vertical velocity [$$m/s$$], • Vertical Eddy Viscosity [$$m^2/s$$], • Vertical Eddy Diffusivity [$$m^2/s$$]. An example of CDL text representation of this file is shown in Listing 5.23. netcdf fields_filename { dimensions : lon = 677; lat = 253; depth = 72; time = UNLIMITED; // (7 currently) variables : \\ float lont(x); lont: units = "degrees_east"; float latt(y); latt: units = "degrees_north"; float deptht(z); deptht: units = "m"; double time(t); time: units = "seconds since 1970-01-01 00:00:00"; float temperature(t,z,y,x); temperature: units = "degC"; }  ### Restart dataset The restart file can be used as initial conditions for research ... This file contains all the information of the child ocean model grids and it includes the following variables: • longitude on TUVF grid points [$$degree$$], • latitude on TUVF grid points [$$degree$$], • depth on TUVF grid points [$$m$$], An example of CDL text representation of this file is shown in Listing 5.21. netcdf SURF_restart_20141005 { dimensions: x = 94 ; y = 79 ; z = 120 ; t = UNLIMITED ; // (1 currently) variables: float nav_lon(y, x) ; float nav_lat(y, x) ; float nav_lev(z) ; double time_counter(t) ; double kt ; double ndastp ; double adatrj ; double utau_b(t, y, x) ; double vtau_b(t, y, x) ; double qns_b(t, y, x) ; double emp_b(t, y, x) ; double sfx_b(t, y, x) ; double sbc_hc_b(t, y, x) ; double sbc_sc_b(t, y, x) ; double qsr_hc_b(t, z, y, x) ; double fraqsr_1lev(t, y, x) ; double rdt ; double rdttra1 ; double ub(t, z, y, x) ; double vb(t, z, y, x) ; double tb(t, z, y, x) ; double sb(t, z, y, x) ; double rotb(t, z, y, x) ; double hdivb(t, z, y, x) ; double sshb(t, y, x) ; double un(t, z, y, x) ; double vn(t, z, y, x) ; double tn(t, z, y, x) ; double sn(t, z, y, x) ; double rotn(t, z, y, x) ; double hdivn(t, z, y, x) ; double sshn(t, y, x) ; double rhop(t, z, y, x) ; }  Listing 5.21: CDL example for the meshmask datasets. # Quick Start Guide This chapter describes how you can quickly get started with the SURF platform. We show how to download and install the SURF Virtual Machine and all the SURF packages. We describe how to compile (if needed) the source codes. We present how to execute a case study (template) experiment in the Gulf of Taranto and view the results. Finally we show how the user-configuration file of a template experiment can be modified in order to execute and analysis new experiments. The template experiment makes it easier to run the model without detailed knowledge of the underlying scientific basis. Only a limited number of default values need to be changed for most applications. A more specific scientific background is required if for example, the user intends to perform experiments with different turbulence or numerical schemes or with alternative settings of model parameters. It is then recommended to read first the NEMO Model Description document and relative article. See also the video tutorials available online here explain the basic features of the SURF platform and designed for beginners who want to learn SURF step by step. ## Download and Install SURF Virtual Machine The SURF platform will be provided as a Virtual Machine (VM). It is packaged and distributed as a ZIP Compressed Archive file (with a .zip extension). The general scheme adopted to manage the versions provides that the releases contain in the name indications of the version in the format:  surf_vm_VERSION.zip  where VERSION is a number (e.g. surf_vm_1.01.zip for the current version). The instructions below explain how to download, install and configure the SURF VM in Oracle VirtualBox • Navigate to https://www.virtualbox.org/ and click on Downloads button. Choose the VirtualBox base package (version >=6) corresponding to the host operating system of your computer (i.e. Windows, Mac, Linux). Save the corresponding file on your computer, double-click it to open it, and follow the installation instructions. • In addition to the base package, download also the Extension Packs. This package provides additional functionality to the base package, such as virtual USB device, remote desktop support, ecc. To install this extension, simply double-click on the package file and follow the installation instructions. Please install the same version extension pack as your installed version of the VirtualBox base package. • Download the current version (v1.01) of the SURF virtual machine from SURF web-page. In the virtual machines is installed the Debian GNU/Linux 8.11 operating system. The Guest Additions have been also installed to optimize the guest operating system for better performance and usability. Extract than the package in your VirtualBox directory which Oracle VM VirtualBox creates in the current system user's home directory (i.e. /Users/USERNAME/VirtualBox VMs/ for Mac user). unzip surf_1.01.zip • Open the VirtualBox software. From the menu, choose Machine > add and navigate to the file surf.vbox. This file is an XML file that contains settings of the Machine. This will add the Virtual Machine surf to the list of Virtual Machine • To start the VM surf, you can double-click on its entry in the list in the VirtualBox Manager window or select its entry and press the Start button at the top of the window. A window opens. The VM Login should look like the figure 6.5 . In the login dialogue box enter: • surf as login • surf2019 as an initial password You are now logged into the VM. ### Disk Partitions mounted on the SURF Virtual Machine The SURF Virtual Machine package contains two VDI (VirtualBox Disk Image) files: • surf.vdi containing the Debian GNU/Linux operating system (version 10.3) • surf_scratch.vdi thought to contain source code files, datasets sample and experiments. From the guest operating system you can see the list of partitions by typing the following command:  sudo fdisk -l  It is divided into two main partitions: • the disk /dev/sda "mounted" as filesystems to the root directory / • the disk /dev/sdb "mounted" in the directory /scratch. Optionally you can mount other physical hard disks with VirtualBox (see the VirtualBox Manual for details). VirtualBox has the ability to mount a shared folder between host and guest in order to access files of your host system from within the guest system. There are a few steps involved: • Shut down the virtual OS before you can edit settings. • Select the surf VM in the VirtualBox Manager and click Settings. • Select Shared Folders, and click the Plus button to add a new shared folder. Specify the host folder you want to share. • Select auto-mount and then click OK. • You can now re-start the VM surf. The shared folder is mounted into the /media directory, along with the prefix "sf_". ### Changing Configuration on the SURF Virtual Machine By default, the VM surf is configurated as in table Table 6.1 . You can keep all defaults parameters or if it is not adequate for your application you can change settings. To change the configuration you need to shut down the virtual OS before you can edit settings. • Select the surf VM in the VirtualBox Manager, right-click it and choose Setting. • increase/decrease the number of cores based on your performance desires. • increase/decrease the number of GB of RAM allocated to your VM according to the size of your computational domain. • increase/decrease the video memory and scale factor of your screen If you want to add more storage space to a VM you can also expande the virtual hard disk. There are a few steps involved: • With the VM Power off, open a terminal and move to the location of the surf_scratch.vdi file that you want to resize, • At the terminal prompt, type the command:, VBoxManage modifyhd surf_scratch.vdi --resize SIZE_MB • Restart the SURF VM and open the GParted application from the Application Menu • Select the /dev/sdb partition (an unlocated drive space is now available). Resize to the unalocated area Table 6.1 Virtual Machine Summary Fields. Parameter Description Values Name Name given the VM surf Guest OS Operating system running on this VM Debian Linux Memory Amount of memory available to this VM 2 [GB] Cores Number of CPU cores being used by this VM 2 Disk Capacity Total disk capacity available to this VM 40 [GB] Network Adapters Number of network adapters available to this VM 1 IP Address IP address assigned to the VM x ## Download and Install SURF packages Once logged in, open a new terminal window and go to the directory /scratch. The scratch directory follows the directory structure as shown in Fig. B.1. The VM you have installed does not contain the SURF packages (source codes and static datasets) and you need to download and install them. The SURF packages are packaged and distributed as a GZIP Compressed Tar Archive file (with a .tar.gz extension). The general scheme adopted to manage the versions provides that the releases contain in the name indications of the version in the format: packageName_<VERSION>.tar.gz where <VERSION> is a number (e.g. surf_nemo_1.01.tar.gz for the current version of the surf_nemo package). The instructions below explain how to install the package in the VM: • Once logged in the VM surf, download the current version of the SURF-NEMO (surf_nemo_1.01.tar.gz) and SURF-DATASETS (surf_datasets_1.01.tar.gz) packages directly from the SURF web-page and save it in the directory /scratch/surf/surf_install/releases/ (for simplicity, we abbreviate this location as $SURF_RELEASES).

• Go to the directory $SURF_RELEASES and run the installation bash script install.sh followed by the package name. For the SURF-NEMO packages type: cd$SURF_RELEASES ; install.sh surf_nemo_1.01.tar.gz

For the SURF-DATASETS packages type:

cd $SURF_RELEASES ; install.sh surf_datasets_1.01.tar.gz The installation process will extract the archive in the directory /scratch/surf/surf_nemo/ and /scratch/surf/surf_datasets/, respectively, and will create a symbolic link current in this directory that points to the extracted folder (for simplicity, we abbreviate this location as $SURF_NEMO, \$SURF_DATASETS, respectively).

For a detailed description of the directory structure and contents of each package refer to the Appendix B.

## Compiling the source code

After the installation of the SURF-NEMO package is finished, you need to compile the source codes in order to create the executable files needed to perform specific tasks. The executable files should not be recreated unless you need to modify the source code. The compilation is performed with the Unix/Linux make utility using the following tools: (1) fortran 90 compiler, (2) C-preprocessor cpp, (3) a compiled MPI library for simulations in parallel mode. (4) a compiled netCDF library to read and write data in portable netCDF format. All these tools are already present and compiled in the SURF platform.

To compile the source codes go to the directory /scratch/surf/surf_nemo/current/scripts/ and run the compilation bash script compile.sh followed by the package name (or by the word 'all' to compile all the packages):

 cd /scratch/surf/surf_nemo/current/scripts; ./compile_codes.sh all 

Compilation could take a few minutes and it will create the executable files for each program present in the SURF-NEMO package.

## Running the case study: Gulf of Taranto

As case study we implement the SURF platform in the Gulf of Taranto in the northern Ionian Sea (fig xx). The nesting simulation starts on 5 October 2014 at 00:00 and run until 7 October 2014 at 24:00. In order to execute this case study experiment, you can follow these steps:

• Download the input datasets (gulfTaranto_20141005.tar.gz) of this case study directly from the web-repository (https://www.surf-platform.org) and extract it in the directory /scratch/surf/indata_offline/

tar -zxvf gulfTaranto_20141005.tar.gz

Note If you want to change the local repository path to some other location of your choice make sure to change the path in the configuration file.

• Create a new folder in the directory /scratch/from_GUI/ and let's call it gulfTaranto_20141005. This is the Experiment ID name which uniquely identifies the experiment.

cd /scratch/from_GUI/; mkdir gulfTaranto_20141005
• Copy the template configuration file /scratch/surf/surf_nemo/current/setParFree.json in the directory /scratch/from_GUI/gulfTaranto_20141005/ which contains the configuration for this case study.

 necd; cp setParFree.json /scratch/from_GUI/gulfTaranto_20141005/
• After that, from the directory /scratch/surf/surf_nemo/current/scripts/, you just need to execute the Julia script run_exp.jl followed by the experiment ID gulfTaranto_20141005

 julia run_exp.jl gulfTaranto_20141005

This will create the folder gulfTaranto_20141005 in the directory /scratch/surf/experiments/ with a directory tree as in fig.x.1 (refer to the Appendix B for more details)

You can activate/deactivate specific tasks by setting logical parameters to True/False in the section set_lrun of the configuration file setParFree.json

lrun_childMeshmask to enable the execution of the CHILD-MESHMASK GENERATION task.

lrun_regridPreAtm to enable the execution of the ATMOSPHERIC-DATA-REGRIDDING task.

lrun_regridPreOceIC to enable the execution of the OCEAN-IC-DATA-REGRIDDING task.

lrun_regridPreOceBC to enable the execution of the OCEAN-BC-DATA-REGRIDDING task.

lrun_regridPreWeights if you want to compute (=True) or just copy (=False) the WEIGHT-FILEs for REMAPPING in the Regridding phase.

lrun_ocean to enable the execution of the NEMO code.

{
"id":"A001","title":"set_lrun",
"items": [
"value": "True"
},
{"name": "lrun_regridPreAtm",
"value": "True"
},
{"name": "lrun_regridPreOceIC",
"value": "True"
},
{"name": "lrun_regridPreOceBC",
"value": "True"
},
{"name": "lrun_regridPreWeights",
"value ": "True"
},
{"name": "lrun_ocean",
"value": "True"
}
]
}


## Post-processing the results

The surf package is provided together with open source tools for data visualization and post-processing your data. You will find the free software packages NcView with a graphical user interface and a suite of procedure using NCAR Graphics package with NCL and Python interface you can call from Command Line.

However, it is very well possible to use other (free or commercial) graphic software such as Pynoply or several scripting languages such as Julia, IDL, Matlab, as long as they can read the netCDF format.

### Visualizing the results with Ncview

Ncview is a tool for visualizing netCDF data files. It is very easy to use, because of its graphical user interface. However, its possibilities are limited. Typically you would use ncview to get a quick and easy, push-button look at your netCDF files. You can view simple movies of the data, view along various dimensions, take a look at the actual data values, change colour maps, invert the data, etc. In order to start this program type ncview followed by the filename of the dataset you want to visualize, example type the following command

 ncview SURF_1h_20141006_20141006_grid_T.nc 

An example of the user interface in NcView is given in figure Fig. 6.7

### Analyzing and Visualizing results using NCAR graphic packages

NCAR Graphics is a collection of graphics libraries that support the display of scientific data. One possible interface available for visualizing data with these libraries is with the NCAR Command Language (NCL), an open-source interpreted programming language, developed at NCAR and designed for the analysis and visualization of geoscientific data.

The SURF-NEMO package include, as postprocessing, a suite of NCL functions to visualize the input/output datasets, compare the child/parent fields, compare the simulation result with in-situ or satellite datasets and convert datasets.

In order to Post-processing the results of an existing experiment, you need to execute the Julia script run_postProc.jl followed by the experiment ID. Example for the case study experiment type the following command:

 julia run_postproc.jl gulfTaranto_20141005 

You can activate/deactivate specific tasks by setting logical parameters to True/False in the sections set_lrun_post and set_visual_lplot of the configuration file setParFree.json

lrun_visDom to enable the plotting of the user-defined domains.

lrun_visIndata to enable the plotting of the Indata Bat, Atm, OceIC, OceBC fields.

lrun_visExtrapdata to enable the plotting of the Extrapdata Atm, OceIC, OceBC fields.

lrun_visRegriddata to enable the execution of the OCEAN-IC-DATA-REGRIDDING task.

lrun_visOutdata to enable the execution of the OCEAN-BC-DATA-REGRIDDING task.

lrun_chlVSpar if you want to compute (=True) or just copy (=False) the WEIGHT-FILEs for REMAPPING in the Regridding phase.

lrun_surfVSctd enables the execution of the NEMO code.

lrun_surfVSsat enables the execution of the NEMO code.

lrun_surfVSmooring enables the execution of the NEMO code.

lrun_surfVSferrybox enables the execution of the NEMO code.

{
"id":"B000","title":"set_lrun_post",
"items": [
{"name": "lrun_visDom",
"value": "True"
},
{"name": "lrun_visIndata",
"value": "True"
},
{"name": "lrun_visExtrapdata",
"value": "True"
},
{"name": "lrun_visRegriddata",
"value": "True"
},
{"name": "lrun_visOutdata",
"value ": "True"
},
{"name": "lrun_chlVSpar",
"value": "True"
},
{"name": "lrun_surfVSctd",
"value": "True"
},
{"name": "lrun_surfVSsat",
"value": "True"
},
{"name": "lrun_surfVSmooring",
"value": "True"
},
{"name": "lrun_surfVSferrybox",
"value": "True"
}
]
}


lplotMesh to enable plotting of the Child MeshMask fields.

lplotBat to enable the plotting of the Bathymetry fields.

lplotAtm to enable the plotting of the Atmospheric fields.

lplotOceIC to enable the plotting of the Initial Condition Ocean fields.

lplotOceBC to enable the plotting of the Open Boundary Condition Ocean fields.

lplotOceBCbdy to enable the plotting of the Open Boundary Condition Ocean fields.

lplotOceOut to enable the plotting of the Output Ocean fields.

{
"id":"B001","title":"set_visual_lplot",
"items": [
{"name": "lplotMesh",
"value": "True"
},
{"name": "lplotBat",
"value": "True"
},
{"name": "lplotAtm",
"value": "True"
},
{"name": "lplotOceIC",
"value": "True"
},
{"name": "lplotOceBC",
"value": "True"
},
{"name": "lplotOceBCbdy",
"value": "True"
},
{"name": "lplotOceOut",
"value": "True"
}
]
}


### Make a new experiments

Let's assume you want to study the circulation of the Sermilik fjord in Greenland from 1 February 2017 at 00:00 to 7 February 2017 at 24:00 ... add more details.

• Choose the name of experiment ID (e.g. greenlandFjord_20170201) and create the folder

cd /scratch/from_GUI/ ; mkdir greenlandFjord_20170201 
• Copy the template configuration file /scratch/surf/surf_nemo/current/setParFree.json in the directory /scratch/from_GUI/greenlandFjord_20170201

 cp /scratch/surf/surf_nemo/current/setParFree.json ./greenlandFjord_20170201/ 
• Modify the user configuration file setParFree.json according to your needs

 param1 = xxx param2 = xxx param3 = xxx param4 = xxx 
• From the directory /scratch/surf/surf_nemo/current/scripts/, execute the Julia script run_exp.jl followed by the experiment ID greenlandFjord_20170201

 cd /scratch/surf/surf_nemo/current/scripts/ ; julia run_exp.jl greenlandFjord_20170201 
• After running the simulation, you can display the simulation results by using the Julia script run_postproc.jl followed by the experiment ID greenlandFjord_20170201

 julia run_postproc.jl greenlandFjord_20170201 

In principle you can simply use the template model and modify it to your needs, and not be too much concerned with the input files they create. But our advice is never to use the template model as black boxes. It is therefore important to understand how the codes work, which options they have and how their input files are structured.

### Multiple downscaling experiments

SURF-NEMO package includes multiple nesting capability (i.e. consecutive nested models can be implemented with increasing grid resolutions). Let's assume you want to downscale from an existing experiment (e.g. from the template experiment gulfTaranto_20141005) in order to increase the spatial resolution to 800m ... add details.

• Go to the existing experiment directory

cd /scratch/surf/experiments/gulfTaranto_20141005/
• Modify the user configuration file setParFree.json according to your needs

 param1 = xxx param2 = xxx param3 = xxx param4 = xxx 
• From the directory /scratch/surf/experiments/gulfTaranto_20141005/code/ocean/scripts/, execute the Julia script run_exp.jl followed by the experiment ID gulfTaranto_20141005

cd /scratch/surf/experiments/gulfTaranto_20141005/code/ocean/scripts/ ; julia run_exp.jl gulfTaranto_20141005 
• After running the simulation, you can display the simulation results by using the julia script run_postproc.jl followed by the experiment ID gulfTaranto_20141005

julia run_postproc.jl gulfTaranto_20141005

# A. Reference Configuration

### A.1. Reference Configuration for NEMO

Part of the input model parameters are fixed and defined inside the SURF source package in the file 'setParFix:ncl'..... The Monotonic Upstream Scheme for Conservation Laws (MUSCL) was used for the tracer advection and the Energy and Enstrophy conservative (EEN) scheme was used for the momentum advection (Arakawa and Lamb 1981; Barnier et al. 2006). No-slip conditions on closed lateral boundaries were applied and the bottom friction was param- eterised by a quadratic function.

# B. Scratch Partition and its directory structures

As shown in chapter 6.1.1 the VM surf is divided into two partitions: the disk /dev/sda "mounted" in the root directory / and the disk /dev/sdb "mounted" in the directory /scratch. The scratch partition contains all the SURF packages and follows the directory structure as shown in figure B.1: The up-to-date version release is structured as follow:

• The directory surf_install/ contains the utilities necessary to manage all the operations of creation and installation of each package of the SURF platform.
• The directory surf_datasets/ contains a list of static input datasets needed to run the SURF_NEMO package. With 'static' we mean here datasets which do not depend on the selected simulation period; i.e. bathymetry, coastline, parent meshmask, weight for remapping, meshmask and bathymetry remapped on the child grid.
• The directory surf_nemo/ contains the sources code of the SURF-NEMO package.
• The directory experiments/ contains all the experiments you have executed.

We describe here the contents of these directories.

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

### CDO - (v1.8.1)

The Climate Data Operator (CDO) software is a collection of many operators for standard processing of climate and forecast model data. The operators include simple statistical and arithmetic functions, data selection and subsampling tools, and spatial interpolation. CDO was developed to have the same set of processing functions for GRIB [GRIB] and NetCDF [NetCDF] datasets in one package.

### curl - (v7.52.1)

curl is free and open source software used in command lines or scripts to transfer files/data from or to a server using FTP, HTTP, HTTPS, SCP, SFTP, SMB and other supported protocols on Linux or Unix-like system.

### HDF5 - (v1.8.18)

The Hierarchical Data Format (HDF5) is a data model, library, and file format for storing and managing data. It supports an unlimited variety of datatypes, and is designed for flexible and efficient I/O and for high volume and complex data. HDF5 is portable and is extensible, allowing applications to evolve in their use of HDF5. The HDF5 Technology suite includes tools and applications for managing, manipulating, viewing, and analyzing data in the HDF5 format.

### Julia - (v1.4.1)

Julia is a high-level, high-performance, dynamic programming language. While it is a general purpose language and can be used to write any application, many of its features are well-suited for high-performance numerical analysis and computational science.

### MPICH2 - (v3.2)

MPICH, formerly known as MPICH2, is a freely available, high performance and widely portable implementation of the Message Passing Interface (MPI) standard. It efficiently supports different computation and communication platforms including commodity clusters, SMPs, massively parallel systems, and high-speed networks.

### NCL - (v6.4.0)

The NCAR Command Language (NCL) is a free interpreted language designed specifically for scientific data processing and visualization.

### Ncview - (v2.1.7)

Ncview is a visual browser for netCDF format files. Typically you would use ncview to get a quick and easy, push-button look at your netCDF files. You can view simple movies of the data, view along various dimensions, take a look at the actual data values, change color maps, invert the data, etc.

### NetCDF - (4.4.1.1)

Network Common Data Form (NetCDF) is a set of software libraries and machine-independent data formats that support the creation, access, and sharing of array-oriented scientific data. It is also a community standard for sharing scientific data.

### Python - (3.6.9)

Python is an interpreted, high-level, general-purpose programming language.

### Szip - (v2.1)

Szip compression software, providing lossless compression of scientific data.

### UDUNITS - (v2.2.24)

The UDUNITS package supports units of physical quantities. Its C library provides for arithmetic manipulation of units and for conversion of numeric values between compatible units. The package contains an extensive unit database, which is in XML format and user-extendable. The package also contains a command-line utility for investigating units and converting values.

### XIOS

XIOS is library designed to manage NETCDF outputs of climate models.

### zlib - (v1.2.11)

The zlib compression library provides in-memory compression and decompression functions, including integrity checks of the uncompressed data.

# D. Bibliography

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

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

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

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

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

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