namespace dense_water_initialization

Overview

Initialization routines for the dense water formation and overflow experiment. More…

namespace dense_water_initialization {

// global functions

subroutine, public dense_water_initialize_topography(D D, G G, param_file param_file, max_depth max_depth);

subroutine, public dense_water_initialize_ts(
    G G,
    GV GV,
    param_file param_file,
    eqn_of_state eqn_of_state,
    T T,
    S S,
    h h,
    just_read_params just_read_params
    );

subroutine, public dense_water_initialize_sponges(
    G G,
    GV GV,
    tv tv,
    param_file param_file,
    use_ALE use_ALE,
    CSp CSp,
    ACSp ACSp
    );

} // namespace dense_water_initialization

Detailed Documentation

Initialization routines for the dense water formation and overflow experiment.

This experiment consists of a shelf accumulating dense water, which spills over an upward slope and a sill, before flowing down a slope into an open ocean region. It’s intended as a test of one of the motivating situations for the adaptive coordinate.

The nondimensional widths of the 5 regions are controlled by the DENSE_WATER_DOMAIN_PARAMS, and the heights of the sill and shelf as a fraction of the total domain depth are controlled by DENSE_WATER_SILL_HEIGHT and DENSE_WATER_SHELF_HEIGHT.

The density in the domain is governed by a linear equation of state, and is set up with a mixed layer of non-dimensional depth DENSE_WATER_MLD below which there is a linear stratification from S_REF, increasing by S_RANGE to the bottom.

To force the experiment, there are sponges on the inflow and outflow of the domain. The inflow sponge has a salinity anomaly of DENSE_WATER_EAST_SPONGE_SALT through the entire depth. The outflow sponge simply restores to the initial condition. Both sponges have controllable widths and restoring timescales.

Global Functions

subroutine, public dense_water_initialize_topography(
    D D,
    G G,
    param_file param_file,
    max_depth max_depth
    )

Initialize the topography field for the dense water experiment.

Parameters:

g	The dynamic horizontal grid type
d	Ocean bottom depth in the units of depth_max
param_file	Parameter file structure
max_depth	Maximum ocean depth in arbitrary units

subroutine, public dense_water_initialize_ts(
    G G,
    GV GV,
    param_file param_file,
    eqn_of_state eqn_of_state,
    T T,
    S S,
    h h,
    just_read_params just_read_params
    )

Initialize the temperature and salinity for the dense water experiment.

Parameters:

g	Horizontal grid control structure
gv	Vertical grid control structure
param_file	Parameter file structure
eqn_of_state	EOS structure
t	Output temperature [degC]
s	Output salinity [ppt]
h	Layer thicknesses [H ~> m or kg m-2]
just_read_params	If present and true, this call will only read parameters without changing h.

subroutine, public dense_water_initialize_sponges(
    G G,
    GV GV,
    tv tv,
    param_file param_file,
    use_ALE use_ALE,
    CSp CSp,
    ACSp ACSp
    )

Initialize the restoring sponges for the dense water experiment.

Parameters:

g	Horizontal grid control structure
gv	Vertical grid control structure
tv	Thermodynamic variables
param_file	Parameter file structure
use_ale	ALE flag
csp	Layered sponge control structure pointer
acsp	ALE sponge control structure pointer