MOM6
|
Provides the K-Profile Parameterization (KPP) of Large et al., 1994, via CVMix.
The K-Profile Parameterization (KPP) of Large et al., 1994, (http://dx.doi.org/10.1029/94RG01872) is implemented via the Community Vertical Mixing package, CVmix, which is called directly by this module.
The formulation and implementation of KPP is described in great detail in the CVMix manual (written by our own Stephen Griffies).
Large et al., 1994, decompose the parameterized boundary layer turbulent flux of a scalar, \( s \), as
\[ \overline{w^\prime s^\prime} = -K \partial_z s + K \gamma_s(\sigma), \]
where \( \sigma = -z/h \) is a non-dimensional coordinate within the boundary layer of depth \( h \). \( K \) is the eddy diffusivity and is a function of position within the boundary layer as well as a function of the surface forcing:
\[ K = h w_s(\sigma) G(\sigma) . \]
Here, \( w_s \) is the vertical velocity scale of the boundary layer turbulence and \( G(\sigma) \) is a "shape function" which is described later. The last term is the "non-local transport" which involves a function \( \gamma_s(\sigma) \) that is matched to the forcing but is not actually needed in the final implementation. Instead, the entire non-local transport term can be equivalently written
\[ K \gamma_s(\sigma) = C_s G(\sigma) Q_s \]
where \( Q_s \) is the surface flux of \( s \) and \( C_s \) is a constant. The vertical structure of the redistribution (non-local) term is solely due to the shape function, \( G(\sigma) \). In our implementation of KPP, we allow the shape functions used for \( K \) and for the non-local transport to be chosen independently.
The particular shape function most widely used in the atmospheric community is
\[ G(\sigma) = \sigma (1-\sigma)^2 \]
which satisfies the boundary conditions \( G(0) = 0 \), \( G(1) = 0 \), \( G^\prime(0) = 1 \), and \( G^\prime(1) = 0 \). Large et al, 1994, alter the function so as to match interior diffusivities but we have found that this leads to inconsistencies within the formulation (see google groups thread Extreme values of non-local transport). Instead, we use either the above form, or even simpler forms that use alternative upper boundary conditions.
The KPP boundary layer depth is a function of the bulk Richardson number, Rib. But to compute Rib, we need the boundary layer depth. To address this circular logic, we compute Rib for each vertical cell in a column, assuming the BL depth equals to the depth of the given grid cell. Once we have a vertical array of Rib(k), we then call the OBLdepth routine from CVMix to compute the actual OBLdepth. We optionally then "correct" the OBLdepth by cycling through once more, this time knowing the OBLdepth from the first pass. This "correction" step is not used by NCAR. It has been found in idealized MOM6 tests to not be necessary.
Data Types | |
type | kpp_cs |
Control structure for containing KPP parameters/data. More... | |
Functions/Subroutines | |
logical function, public | kpp_init (paramFile, G, diag, Time, CS, passive) |
Initialize the CVmix KPP module and set up diagnostics Returns True if KPP is to be used, False otherwise. More... | |
subroutine, public | kpp_calculate (CS, G, GV, h, Temp, Salt, u, v, EOS, uStar, buoyFlux, Kt, Ks, Kv, nonLocalTransHeat, nonLocalTransScalar) |
KPP vertical diffusivity/viscosity and non-local tracer transport. More... | |
subroutine, public | kpp_nonlocaltransport_temp (CS, G, GV, h, nonLocalTrans, surfFlux, dt, scalar, C_p) |
Apply KPP non-local transport of surface fluxes for temperature. More... | |
subroutine, public | kpp_nonlocaltransport_saln (CS, G, GV, h, nonLocalTrans, surfFlux, dt, scalar) |
Apply KPP non-local transport of surface fluxes for salinity. This routine is a useful prototype for other material tracers. More... | |
subroutine, public | kpp_end (CS) |
Clear pointers, deallocate memory. More... | |
Variables | |
integer, parameter, private | nlt_shape_cvmix = 0 |
Use the CVmix profile. More... | |
integer, parameter, private | nlt_shape_linear = 1 |
Linear, \( G(\sigma) = 1-\sigma \). More... | |
integer, parameter, private | nlt_shape_parabolic = 2 |
Parabolic, \( G(\sigma) = (1-\sigma)^2 \). More... | |
integer, parameter, private | nlt_shape_cubic = 3 |
Cubic, \( G(\sigma) = 1 + (2\sigma-3) \sigma^2\). More... | |
integer, parameter, private | nlt_shape_cubic_lmd = 4 |
Original shape, \( G(\sigma) = \frac{27}{4} \sigma (1-\sigma)^2 \). More... | |
integer, parameter, private | sw_method_all_sw = 0 |
Use all shortwave radiation. More... | |
integer, parameter, private | sw_method_mxl_sw = 1 |
Use shortwave radiation absorbed in mixing layer. More... | |
integer, parameter, private | sw_method_lv1_sw = 2 |
Use shortwave radiation absorbed in layer 1. More... | |
logical, parameter | verbose = .False. |
subroutine, public mom_kpp::kpp_calculate | ( | type(kpp_cs), pointer | CS, |
type(ocean_grid_type), intent(in) | G, | ||
type(verticalgrid_type), intent(in) | GV, | ||
real, dimension( g %isd: g %ied, g %jsd: g %jed, g %ke), intent(in) | h, | ||
real, dimension( g %isd: g %ied, g %jsd: g %jed, g %ke), intent(in) | Temp, | ||
real, dimension( g %isd: g %ied, g %jsd: g %jed, g %ke), intent(in) | Salt, | ||
real, dimension( g %isdb: g %iedb, g %jsd: g %jed, g %ke), intent(in) | u, | ||
real, dimension( g %isd: g %ied, g %jsdb: g %jedb, g %ke), intent(in) | v, | ||
type(eos_type), pointer | EOS, | ||
real, dimension( g %isd: g %ied, g %jsd: g %jed), intent(in) | uStar, | ||
real, dimension( g %isd: g %ied, g %jsd: g %jed, g %ke+1), intent(in) | buoyFlux, | ||
real, dimension( g %isd: g %ied, g %jsd: g %jed, g %ke+1), intent(inout) | Kt, | ||
real, dimension( g %isd: g %ied, g %jsd: g %jed, g %ke+1), intent(inout) | Ks, | ||
real, dimension( g %isd: g %ied, g %jsd: g %jed, g %ke+1), intent(inout) | Kv, | ||
real, dimension( g %isd: g %ied, g %jsd: g %jed, g %ke+1), intent(inout) | nonLocalTransHeat, | ||
real, dimension( g %isd: g %ied, g %jsd: g %jed, g %ke+1), intent(inout) | nonLocalTransScalar | ||
) |
KPP vertical diffusivity/viscosity and non-local tracer transport.
cs | Control structure | |
[in] | g | Ocean grid |
[in] | gv | Ocean vertical grid |
[in] | h | Layer/level thicknesses (units of H) |
[in] | temp | potential/cons temp (deg C) |
[in] | salt | Salinity (ppt) |
[in] | u | Velocity i-component (m/s) |
[in] | v | Velocity j-component (m/s) |
eos | Equation of state | |
[in] | ustar | Surface friction velocity (m/s) |
[in] | buoyflux | Surface buoyancy flux (m2/s3) |
[in,out] | kt | (in) Vertical diffusivity of heat w/o KPP (m2/s) (out) Vertical diffusivity including KPP (m2/s) |
[in,out] | ks | (in) Vertical diffusivity of salt w/o KPP (m2/s) (out) Vertical diffusivity including KPP (m2/s) |
[in,out] | kv | (in) Vertical viscosity w/o KPP (m2/s) (out) Vertical viscosity including KPP (m2/s) |
[in,out] | nonlocaltransheat | Temp non-local transport (m/s) |
[in,out] | nonlocaltransscalar | scalar non-local transport (m/s) |
Definition at line 413 of file MOM_KPP.F90.
References nlt_shape_cubic, nlt_shape_cubic_lmd, nlt_shape_linear, nlt_shape_parabolic, sw_method_all_sw, sw_method_lv1_sw, and sw_method_mxl_sw.
subroutine, public mom_kpp::kpp_end | ( | type(kpp_cs), pointer | CS | ) |
Clear pointers, deallocate memory.
cs | Control structure |
Definition at line 1062 of file MOM_KPP.F90.
logical function, public mom_kpp::kpp_init | ( | type(param_file_type), intent(in) | paramFile, |
type(ocean_grid_type), intent(in) | G, | ||
type(diag_ctrl), intent(in), target | diag, | ||
type(time_type), intent(in) | Time, | ||
type(kpp_cs), pointer | CS, | ||
logical, intent(out), optional | passive | ||
) |
Initialize the CVmix KPP module and set up diagnostics Returns True if KPP is to be used, False otherwise.
[in] | paramfile | File parser |
[in] | g | Ocean grid |
[in] | diag | Diagnostics |
cs | Control structure | |
[out] | passive | Copy of passiveMode |
Definition at line 133 of file MOM_KPP.F90.
References mom_file_parser::closeparameterblock(), mom_error_handler::mom_error(), nlt_shape_cubic, nlt_shape_cubic_lmd, nlt_shape_cvmix, nlt_shape_linear, nlt_shape_parabolic, mom_file_parser::openparameterblock(), mom_diag_mediator::register_diag_field(), sw_method_all_sw, sw_method_lv1_sw, and sw_method_mxl_sw.
subroutine, public mom_kpp::kpp_nonlocaltransport_saln | ( | type(kpp_cs), intent(in) | CS, |
type(ocean_grid_type), intent(in) | G, | ||
type(verticalgrid_type), intent(in) | GV, | ||
real, dimension( g %isd: g %ied, g %jsd: g %jed, g %ke), intent(in) | h, | ||
real, dimension( g %isd: g %ied, g %jsd: g %jed, g %ke+1), intent(in) | nonLocalTrans, | ||
real, dimension( g %isd: g %ied, g %jsd: g %jed), intent(in) | surfFlux, | ||
real, intent(in) | dt, | ||
real, dimension( g %isd: g %ied, g %jsd: g %jed, g %ke), intent(inout) | scalar | ||
) |
Apply KPP non-local transport of surface fluxes for salinity. This routine is a useful prototype for other material tracers.
[in] | cs | Control structure |
[in] | g | Ocean grid |
[in] | gv | Ocean vertical grid |
[in] | h | Layer/level thickness (units of H) |
[in] | nonlocaltrans | Non-local transport (non-dimensional) |
[in] | surfflux | Surface flux of scalar (H/s * scalar) |
[in] | dt | Time-step (s) |
[in,out] | scalar | Scalar (scalar units) |
Definition at line 1003 of file MOM_KPP.F90.
Referenced by mom_diabatic_driver::diabatic().
subroutine, public mom_kpp::kpp_nonlocaltransport_temp | ( | type(kpp_cs), intent(in) | CS, |
type(ocean_grid_type), intent(in) | G, | ||
type(verticalgrid_type), intent(in) | GV, | ||
real, dimension( g %isd: g %ied, g %jsd: g %jed, g %ke), intent(in) | h, | ||
real, dimension( g %isd: g %ied, g %jsd: g %jed, g %ke+1), intent(in) | nonLocalTrans, | ||
real, dimension( g %isd: g %ied, g %jsd: g %jed), intent(in) | surfFlux, | ||
real, intent(in) | dt, | ||
real, dimension( g %isd: g %ied, g %jsd: g %jed, g %ke), intent(inout) | scalar, | ||
real, intent(in) | C_p | ||
) |
Apply KPP non-local transport of surface fluxes for temperature.
[in] | cs | Control structure |
[in] | g | Ocean grid |
[in] | gv | Ocean vertical grid |
[in] | h | Layer/level thickness (units of H) |
[in] | nonlocaltrans | Non-local transport (non-dimensional) |
[in] | surfflux | Surface flux of scalar (H/s * scalar) |
[in] | dt | Time-step (s) |
[in,out] | scalar | temperature |
[in] | c_p | Seawater specific heat capacity (J/(kg*K)) |
Definition at line 944 of file MOM_KPP.F90.
Referenced by mom_diabatic_driver::diabatic().
|
private |
Cubic, \( G(\sigma) = 1 + (2\sigma-3) \sigma^2\).
Definition at line 40 of file MOM_KPP.F90.
Referenced by kpp_calculate(), and kpp_init().
|
private |
Original shape, \( G(\sigma) = \frac{27}{4} \sigma (1-\sigma)^2 \).
Definition at line 41 of file MOM_KPP.F90.
Referenced by kpp_calculate(), and kpp_init().
|
private |
|
private |
Linear, \( G(\sigma) = 1-\sigma \).
Definition at line 38 of file MOM_KPP.F90.
Referenced by kpp_calculate(), and kpp_init().
|
private |
Parabolic, \( G(\sigma) = (1-\sigma)^2 \).
Definition at line 39 of file MOM_KPP.F90.
Referenced by kpp_calculate(), and kpp_init().
|
private |
Use all shortwave radiation.
Definition at line 43 of file MOM_KPP.F90.
Referenced by kpp_calculate(), and kpp_init().
|
private |
Use shortwave radiation absorbed in layer 1.
Definition at line 45 of file MOM_KPP.F90.
Referenced by kpp_calculate(), and kpp_init().
|
private |
Use shortwave radiation absorbed in mixing layer.
Definition at line 44 of file MOM_KPP.F90.
Referenced by kpp_calculate(), and kpp_init().
logical, parameter mom_kpp::verbose = .False. |
Definition at line 125 of file MOM_KPP.F90.