dome_initialization module reference

Configures the model for the “DOME” experiment. DOME = Dynamics of Overflows and Mixing Experiment.

More…

Functions/Subroutines

dome_initialize_topography()

This subroutine sets up the DOME topography.

dome_initialize_thickness()

This subroutine initializes layer thicknesses for the DOME experiment.

dome_initialize_sponges()

This subroutine sets the inverse restoration time (Idamp), and ! the values towards which the interface heights and an arbitrary ! number of tracers should be restored within each sponge.

dome_set_obc_data()

This subroutine sets the properties of flow at open boundary conditions.

Detailed Description

Configures the model for the “DOME” experiment. DOME = Dynamics of Overflows and Mixing Experiment.

Function/Subroutine Documentation

subroutine dome_initialization/dome_initialize_topography(D, G, param_file, max_depth, US)

This subroutine sets up the DOME topography.

Parameters

  • g :: [in] The dynamic horizontal grid type

  • d :: [out] Ocean bottom depth in m or Z if US is present

  • param_file :: [in] Parameter file structure

  • max_depth :: [in] Maximum model depth in the units of D

  • us :: [in] A dimensional unit scaling type

Call to

mom_error_handler::mom_mesg

Called from

mom_fixed_initialization::mom_initialize_topography

subroutine dome_initialization/dome_initialize_thickness(h, G, GV, param_file, just_read_params)

This subroutine initializes layer thicknesses for the DOME experiment.

Parameters

  • g :: [in] The ocean’s grid structure.

  • gv :: [in] The ocean’s vertical grid structure.

  • h :: [out] The thickness that is being initialized [H ~> m or kg m-2].

  • param_file :: [in] A structure indicating the open file to parse for model parameter values.

  • just_read_params :: [in] If present and true, this call will only read parameters without changing h.

Call to

mom_error_handler::mom_mesg

subroutine dome_initialization/dome_initialize_sponges(G, GV, US, tv, PF, CSp)

This subroutine sets the inverse restoration time (Idamp), and ! the values towards which the interface heights and an arbitrary ! number of tracers should be restored within each sponge. The ! interface height is always subject to damping, and must always be ! the first registered field. !

Parameters

  • g :: [in] The ocean’s grid structure.

  • gv :: [in] The ocean’s vertical grid structure.

  • us :: [in] A dimensional unit scaling type

  • tv :: [in] A structure containing pointers to any available thermodynamic fields, including potential temperature and salinity or mixed layer density. Absent fields have NULL ptrs.

  • pf :: [in] A structure indicating the open file to parse for model parameter values.

  • csp :: A pointer that is set to point to the control structure for this module.

Call to

mom_sponge::initialize_sponge mom_error_handler::mom_error mom_sponge::set_up_sponge_field

Called from

mom_state_initialization::mom_initialize_state

subroutine dome_initialization/dome_set_obc_data(OBC, tv, G, GV, US, param_file, tr_Reg)

This subroutine sets the properties of flow at open boundary conditions. This particular example is for the DOME inflow describe in Legg et al. 2006.

Parameters

  • obc :: This open boundary condition type specifies whether, where, and what open boundary conditions are used.

  • tv :: [in] A structure containing pointers to any available thermodynamic fields, including potential temperature and salinity or mixed layer density. Absent fields have NULL ptrs.

  • g :: [in] The ocean’s grid structure.

  • gv :: [in] The ocean’s vertical grid structure.

  • us :: [in] A dimensional unit scaling type

  • param_file :: [in] A structure indicating the open file to parse for model parameter values.

  • tr_reg :: Tracer registry.

Call to

mom_error_handler::mom_error mom_open_boundary::register_segment_tracer mom_tracer_registry::tracer_name_lookup