Sparse Hydrodynamic Ocean Code V5199 User Manual

SHOC User Manual

4.31.2 Multiple datafiles

At this time the specification of multiple datafiles is only permitted when defining boundary inputs, wind files, relation and resetting. Following is an example of how to substitute variable names and specify multiple time-series files for a boundary parameter:

BOUNDARY1.DATA t1.nc(salt=salinity) t2.nc(temp=tmp)

A list of files may be included in a separate text file, to which the boundary (or wind etc) specification may define, e.g. a multi-file-netcdf text file, boundary.mnc

may be generated having the following format: multi-netcdf-version 1.0 nfiles 2 file0.filename t1.nc file1.filename t2.nc

Boundary data may then be defined via (with variable substitution included):

BOUNDARY1.DATA boundary.mnc(salt=salinity)(temp=tmp)

This is a convenient method of specifying a long list of files as input.

4.31.3 Model variable initialisation

At the start of a model run, the model variables are initialised for each grid using a netCDF input file which is either generated from the parameter file using the

–g

option, or obtained from the output of a previous run. This initialisation input file for each grid is specified as follows:

INPUT_FILE in.nc

The input file may contain more than one record, the record is selected based on the

START_TIME

parameter for this run. The time in the datafile must match exactly.

4.31.4 Model variable output

SHOC provides two mechanisms for recording its results: ASCII time-series of values as computed for particular locations and as an n-dimensional netCDF datafiles.

4.31.5 ASCII time-series

ASCII time-series output files contain values for significant model variables at specific locations. A time series file is created for each location in the model domain and records are written at a pre-determined interval. Currently the output variables include time, surface elevation, current components (2D and 3D), and tracers. Non-time dependent geometry information is also provided (cell centre, bottom depth, etc.) in the header. Time series output in SHOC are referenced to the free surface, mean sea level or the bottom.

ASCII time-series are convenient for comparisons with point observations (such as tide gauges or current meters).

20/08/2015 Page 119 of 185 Version: 1.00