MOM6
|
Accelerations due to the Coriolis force and momentum advection.
This file contains the subroutine that calculates the time derivatives of the velocities due to Coriolis acceleration and momentum advection. This subroutine uses either a vorticity advection scheme from Arakawa and Hsu, Mon. Wea. Rev. 1990, or Sadourny's (JAS 1975) energy conserving scheme. Both have been modified to use general orthogonal coordinates as described in Arakawa and Lamb, Mon. Wea. Rev. 1981. Both schemes are second order accurate, and allow for vanishingly small layer thicknesses. The Arakawa and Hsu scheme globally conserves both total energy and potential enstrophy in the limit of nondivergent flow. Sadourny's energy conserving scheme conserves energy if the flow is nondivergent or centered difference thickness fluxes are used.
Two sets of boundary conditions have been coded in the definition of relative vorticity. These are written as: NOSLIP defined (in spherical coordinates): relvort = dv/dx (east & west), with v = 0. relvort = -sec(Q) * d(u cos(Q))/dy (north & south), with u = 0.
NOSLIP not defined (free slip): relvort = 0 (all boundaries)
with Q temporarily defined as latitude. The free slip boundary condition is much more natural on a C-grid.
A small fragment of the grid is shown below:
j+1 x ^ x ^ x At x: q, CoriolisBu j+1 > o > o > At ^: v, CAv, vh j x ^ x ^ x At >: u, CAu, uh, a, b, c, d j > o > o > At o: h, KE j-1 x ^ x ^ x i-1 i i+1 At x & ^: i i+1 At > & o:
The boundaries always run through q grid points (x).
Data Types | |
type | coriolisadv_cs |
Control structure for mom_coriolisadv. More... | |
Functions/Subroutines | |
subroutine, public | coradcalc (u, v, h, uh, vh, CAu, CAv, OBC, AD, G, GV, CS) |
Calculates the Coriolis and momentum advection contributions to the acceleration. More... | |
subroutine | gradke (u, v, h, KE, KEx, KEy, k, OBC, G, CS) |
Calculates the acceleration due to the gradient of kinetic energy. More... | |
subroutine, public | coriolisadv_init (Time, G, param_file, diag, AD, CS) |
Initializes the control structure for coriolisadv_cs. More... | |
subroutine, public | coriolisadv_end (CS) |
Destructor for coriolisadv_cs. More... | |
Variables | |
integer, parameter | sadourny75_energy = 1 |
integer, parameter | arakawa_hsu90 = 2 |
integer, parameter | robust_enstro = 3 |
integer, parameter | sadourny75_enstro = 4 |
integer, parameter | arakawa_lamb81 = 5 |
integer, parameter | al_blend = 6 |
character *(20), parameter | sadourny75_energy_string = "SADOURNY75_ENERGY" |
character *(20), parameter | arakawa_hsu_string = "ARAKAWA_HSU90" |
character *(20), parameter | robust_enstro_string = "ROBUST_ENSTRO" |
character *(20), parameter | sadourny75_enstro_string = "SADOURNY75_ENSTRO" |
character *(20), parameter | arakawa_lamb_string = "ARAKAWA_LAMB81" |
character *(20), parameter | al_blend_string = "ARAKAWA_LAMB_BLEND" |
integer, parameter | ke_arakawa = 10 |
integer, parameter | ke_simple_gudonov = 11 |
integer, parameter | ke_gudonov = 12 |
character *(20), parameter | ke_arakawa_string = "KE_ARAKAWA" |
character *(20), parameter | ke_simple_gudonov_string = "KE_SIMPLE_GUDONOV" |
character *(20), parameter | ke_gudonov_string = "KE_GUDONOV" |
integer, parameter | pv_adv_centered = 21 |
integer, parameter | pv_adv_upwind1 = 22 |
character *(20), parameter | pv_adv_centered_string = "PV_ADV_CENTERED" |
character *(20), parameter | pv_adv_upwind1_string = "PV_ADV_UPWIND1" |
subroutine, public mom_coriolisadv::coradcalc | ( | real, dimension(szib_(g),szj_(g),szk_(g)), intent(in) | u, |
real, dimension(szi_(g),szjb_(g),szk_(g)), intent(in) | v, | ||
real, dimension(szi_(g),szj_(g),szk_(g)), intent(in) | h, | ||
real, dimension(szib_(g),szj_(g),szk_(g)), intent(in) | uh, | ||
real, dimension(szi_(g),szjb_(g),szk_(g)), intent(in) | vh, | ||
real, dimension(szib_(g),szj_(g),szk_(g)), intent(out) | CAu, | ||
real, dimension(szi_(g),szjb_(g),szk_(g)), intent(out) | CAv, | ||
type(ocean_obc_type), pointer | OBC, | ||
type(accel_diag_ptrs), intent(inout) | AD, | ||
type(ocean_grid_type), intent(in) | G, | ||
type(verticalgrid_type), intent(in) | GV, | ||
type(coriolisadv_cs), pointer | CS | ||
) |
Calculates the Coriolis and momentum advection contributions to the acceleration.
[in] | g | Ocen grid structure |
[in] | gv | Vertical grid structure |
[in] | u | Zonal velocity (m/s) |
[in] | v | Meridional velocity (m/s) |
[in] | h | Layer thickness (m or kg/m2) |
[in] | uh | Zonal transport u*h*dy (m3/s or kg/s) |
[in] | vh | Meridional transport v*h*dx (m3/s or kg/s) |
[out] | cau | Zonal acceleration due to Coriolis and momentum advection, in m/s2. |
[out] | cav | Meridional acceleration due to Coriolis and momentum advection, in m/s2. |
obc | Open boundary control structure | |
[in,out] | ad | Storage for acceleration diagnostics |
cs | Control structure for MOM_CoriolisAdv |
Definition at line 107 of file MOM_CoriolisAdv.F90.
References al_blend, arakawa_hsu90, arakawa_lamb81, gradke(), mom_error_handler::mom_error(), mom_open_boundary::obc_direction_n, pv_adv_centered, pv_adv_upwind1, robust_enstro, sadourny75_energy, and sadourny75_enstro.
Referenced by mom_dynamics_legacy_split::step_mom_dyn_legacy_split(), mom_dynamics_split_rk2::step_mom_dyn_split_rk2(), mom_dynamics_unsplit::step_mom_dyn_unsplit(), and mom_dynamics_unsplit_rk2::step_mom_dyn_unsplit_rk2().
subroutine, public mom_coriolisadv::coriolisadv_end | ( | type(coriolisadv_cs), pointer | CS | ) |
Destructor for coriolisadv_cs.
cs | Control structure fro MOM_CoriolisAdv |
Definition at line 1045 of file MOM_CoriolisAdv.F90.
subroutine, public mom_coriolisadv::coriolisadv_init | ( | type(time_type), intent(in), target | Time, |
type(ocean_grid_type), intent(in) | G, | ||
type(param_file_type), intent(in) | param_file, | ||
type(diag_ctrl), intent(inout), target | diag, | ||
type(accel_diag_ptrs), intent(inout), target | AD, | ||
type(coriolisadv_cs), pointer | CS | ||
) |
Initializes the control structure for coriolisadv_cs.
[in] | time | Current model time |
[in] | g | Ocean grid structure |
[in] | param_file | Runtime parameter handles |
[in,out] | diag | Diagnostics control structure |
[in,out] | ad | Strorage for acceleration diagnostics |
cs | Control structure fro MOM_CoriolisAdv |
Definition at line 875 of file MOM_CoriolisAdv.F90.
References al_blend, al_blend_string, arakawa_hsu90, arakawa_hsu_string, arakawa_lamb81, arakawa_lamb_string, ke_arakawa, ke_arakawa_string, ke_gudonov, ke_gudonov_string, ke_simple_gudonov, ke_simple_gudonov_string, mom_error_handler::mom_error(), mom_error_handler::mom_mesg(), pv_adv_centered, pv_adv_centered_string, pv_adv_upwind1, pv_adv_upwind1_string, mom_diag_mediator::register_diag_field(), robust_enstro, robust_enstro_string, sadourny75_energy, sadourny75_energy_string, sadourny75_enstro, sadourny75_enstro_string, and mom_string_functions::uppercase().
|
private |
Calculates the acceleration due to the gradient of kinetic energy.
[in] | g | Ocen grid structure |
[in] | u | Zonal velocity (m/s) |
[in] | v | Meridional velocity (m/s) |
[in] | h | Layer thickness (m or kg/m2) |
[out] | ke | Kinetic energy (m2/s2) |
[out] | kex | Zonal acceleration due to kinetic energy gradient (m/s2) |
[out] | key | Meridional acceleration due to kinetic energy gradient (m/s2) |
[in] | k | Layer number to calculate for |
obc | Open boundary control structure | |
cs | Control structure for MOM_CoriolisAdv |
Definition at line 791 of file MOM_CoriolisAdv.F90.
References ke_arakawa, ke_gudonov, and ke_simple_gudonov.
Referenced by coradcalc().
|
private |
Definition at line 83 of file MOM_CoriolisAdv.F90.
Referenced by coradcalc(), and coriolisadv_init().
|
private |
Definition at line 89 of file MOM_CoriolisAdv.F90.
Referenced by coriolisadv_init().
|
private |
Definition at line 79 of file MOM_CoriolisAdv.F90.
Referenced by coradcalc(), and coriolisadv_init().
|
private |
Definition at line 85 of file MOM_CoriolisAdv.F90.
Referenced by coriolisadv_init().
|
private |
Definition at line 82 of file MOM_CoriolisAdv.F90.
Referenced by coradcalc(), and coriolisadv_init().
|
private |
Definition at line 88 of file MOM_CoriolisAdv.F90.
Referenced by coriolisadv_init().
|
private |
Definition at line 91 of file MOM_CoriolisAdv.F90.
Referenced by coriolisadv_init(), and gradke().
|
private |
Definition at line 94 of file MOM_CoriolisAdv.F90.
Referenced by coriolisadv_init().
|
private |
Definition at line 93 of file MOM_CoriolisAdv.F90.
Referenced by coriolisadv_init(), and gradke().
|
private |
Definition at line 96 of file MOM_CoriolisAdv.F90.
Referenced by coriolisadv_init().
|
private |
Definition at line 92 of file MOM_CoriolisAdv.F90.
Referenced by coriolisadv_init(), and gradke().
|
private |
Definition at line 95 of file MOM_CoriolisAdv.F90.
Referenced by coriolisadv_init().
|
private |
Definition at line 98 of file MOM_CoriolisAdv.F90.
Referenced by coradcalc(), and coriolisadv_init().
|
private |
Definition at line 100 of file MOM_CoriolisAdv.F90.
Referenced by coriolisadv_init().
|
private |
Definition at line 99 of file MOM_CoriolisAdv.F90.
Referenced by coradcalc(), and coriolisadv_init().
|
private |
Definition at line 101 of file MOM_CoriolisAdv.F90.
Referenced by coriolisadv_init().
|
private |
Definition at line 80 of file MOM_CoriolisAdv.F90.
Referenced by coradcalc(), and coriolisadv_init().
|
private |
Definition at line 86 of file MOM_CoriolisAdv.F90.
Referenced by coriolisadv_init().
integer, parameter mom_coriolisadv::sadourny75_energy = 1 |
Definition at line 78 of file MOM_CoriolisAdv.F90.
Referenced by coradcalc(), and coriolisadv_init().
|
private |
Definition at line 84 of file MOM_CoriolisAdv.F90.
Referenced by coriolisadv_init().
|
private |
Definition at line 81 of file MOM_CoriolisAdv.F90.
Referenced by coradcalc(), and coriolisadv_init().
|
private |
Definition at line 87 of file MOM_CoriolisAdv.F90.
Referenced by coriolisadv_init().