[11395] | 1 | MODULE isfhdiv |
---|
[12077] | 2 | !!====================================================================== |
---|
| 3 | !! *** MODULE isfhdiv *** |
---|
| 4 | !! ice shelf horizontal divergence module : update the horizontal divergence |
---|
| 5 | !! with the ice shelf melt and coupling correction |
---|
| 6 | !!====================================================================== |
---|
| 7 | !! History : 4.0 ! 2019-09 (P. Mathiot) Original code |
---|
| 8 | !!---------------------------------------------------------------------- |
---|
[11395] | 9 | |
---|
[12077] | 10 | !!---------------------------------------------------------------------- |
---|
| 11 | !! isf_hdiv : update the horizontal divergence with the ice shelf |
---|
| 12 | !! melt and coupling correction |
---|
| 13 | !!---------------------------------------------------------------------- |
---|
| 14 | |
---|
| 15 | USE isf_oce ! ice shelf |
---|
| 16 | |
---|
[11852] | 17 | USE dom_oce ! time and space domain |
---|
[12489] | 18 | USE phycst , ONLY: r1_rho0 ! physical constant |
---|
[11852] | 19 | USE in_out_manager ! |
---|
[11395] | 20 | |
---|
[11403] | 21 | IMPLICIT NONE |
---|
[11395] | 22 | |
---|
[11403] | 23 | PRIVATE |
---|
[11395] | 24 | |
---|
[11403] | 25 | PUBLIC isf_hdiv |
---|
[12340] | 26 | !! * Substitutions |
---|
| 27 | # include "do_loop_substitute.h90" |
---|
[13237] | 28 | # include "domzgr_substitute.h90" |
---|
[11395] | 29 | |
---|
| 30 | CONTAINS |
---|
| 31 | |
---|
[12068] | 32 | SUBROUTINE isf_hdiv( kt, Kmm, phdiv ) |
---|
[11395] | 33 | !!---------------------------------------------------------------------- |
---|
| 34 | !! *** SUBROUTINE isf_hdiv *** |
---|
| 35 | !! |
---|
[11541] | 36 | !! ** Purpose : update the horizontal divergence with the ice shelf contribution |
---|
| 37 | !! (parametrisation, explicit, ice sheet coupling conservation |
---|
| 38 | !! increment) |
---|
[11395] | 39 | !! |
---|
| 40 | !!---------------------------------------------------------------------- |
---|
| 41 | REAL(wp), DIMENSION(:,:,:), INTENT( inout ) :: phdiv ! horizontal divergence |
---|
| 42 | !!---------------------------------------------------------------------- |
---|
[11423] | 43 | INTEGER, INTENT(in) :: kt |
---|
[12068] | 44 | INTEGER, INTENT(in) :: Kmm ! ocean time level index |
---|
[11395] | 45 | ! |
---|
[11521] | 46 | IF ( ln_isf ) THEN |
---|
| 47 | ! |
---|
| 48 | ! ice shelf cavity contribution |
---|
| 49 | IF ( ln_isfcav_mlt ) CALL isf_hdiv_mlt(misfkt_cav, misfkb_cav, rhisf_tbl_cav, rfrac_tbl_cav, fwfisf_cav, fwfisf_cav_b, phdiv) |
---|
| 50 | ! |
---|
| 51 | ! ice shelf parametrisation contribution |
---|
| 52 | IF ( ln_isfpar_mlt ) CALL isf_hdiv_mlt(misfkt_par, misfkb_par, rhisf_tbl_par, rfrac_tbl_par, fwfisf_par, fwfisf_par_b, phdiv) |
---|
| 53 | ! |
---|
[11541] | 54 | ! ice sheet coupling contribution |
---|
[11852] | 55 | IF ( ln_isfcpl .AND. kt /= 0 ) THEN |
---|
[11541] | 56 | ! |
---|
[12077] | 57 | ! Dynamical stability at start up after change in under ice shelf cavity geometry is achieve by correcting the divergence. |
---|
| 58 | ! This is achieved by applying a volume flux in order to keep the horizontal divergence after remapping |
---|
| 59 | ! the same as at the end of the latest time step. So correction need to be apply at nit000 (euler time step) and |
---|
| 60 | ! half of it at nit000+1 (leap frog time step). |
---|
[12068] | 61 | IF ( kt == nit000 ) CALL isf_hdiv_cpl(Kmm, risfcpl_vol , phdiv) |
---|
| 62 | IF ( kt == nit000+1 ) CALL isf_hdiv_cpl(Kmm, risfcpl_vol*0.5_wp, phdiv) |
---|
[11541] | 63 | ! |
---|
| 64 | ! correct divergence every time step to remove any trend due to coupling |
---|
| 65 | ! conservation option |
---|
[12068] | 66 | IF ( ln_isfcpl_cons ) CALL isf_hdiv_cpl(Kmm, risfcpl_cons_vol, phdiv) |
---|
[11541] | 67 | ! |
---|
| 68 | END IF |
---|
[11423] | 69 | ! |
---|
| 70 | END IF |
---|
[11395] | 71 | ! |
---|
| 72 | END SUBROUTINE isf_hdiv |
---|
| 73 | |
---|
| 74 | SUBROUTINE isf_hdiv_mlt(ktop, kbot, phtbl, pfrac, pfwf, pfwf_b, phdiv) |
---|
| 75 | !!---------------------------------------------------------------------- |
---|
| 76 | !! *** SUBROUTINE sbc_isf_div *** |
---|
| 77 | !! |
---|
[11541] | 78 | !! ** Purpose : update the horizontal divergence with the ice shelf inflow |
---|
[11395] | 79 | !! |
---|
[11541] | 80 | !! ** Method : pfwf is positive (outflow) and expressed as kg/m2/s |
---|
| 81 | !! increase the divergence |
---|
[11395] | 82 | !! |
---|
[11541] | 83 | !! ** Action : phdivn increased by the ice shelf outflow |
---|
[11395] | 84 | !!---------------------------------------------------------------------- |
---|
| 85 | REAL(wp), DIMENSION(jpi,jpj,jpk), INTENT(inout) :: phdiv |
---|
| 86 | !!---------------------------------------------------------------------- |
---|
| 87 | INTEGER , DIMENSION(jpi,jpj), INTENT(in ) :: ktop , kbot |
---|
| 88 | REAL(wp), DIMENSION(jpi,jpj), INTENT(in ) :: pfrac, phtbl |
---|
| 89 | REAL(wp), DIMENSION(jpi,jpj), INTENT(in ) :: pfwf , pfwf_b |
---|
| 90 | !!---------------------------------------------------------------------- |
---|
| 91 | INTEGER :: ji, jj, jk ! dummy loop indices |
---|
| 92 | INTEGER :: ikt, ikb |
---|
[11541] | 93 | REAL(wp), DIMENSION(jpi,jpj) :: zhdiv |
---|
[11395] | 94 | !!---------------------------------------------------------------------- |
---|
| 95 | ! |
---|
| 96 | !== fwf distributed over several levels ==! |
---|
| 97 | ! |
---|
| 98 | ! compute integrated divergence correction |
---|
[12489] | 99 | zhdiv(:,:) = 0.5_wp * ( pfwf(:,:) + pfwf_b(:,:) ) * r1_rho0 / phtbl(:,:) |
---|
[11395] | 100 | ! |
---|
| 101 | ! update divergence at each level affected by ice shelf top boundary layer |
---|
[13295] | 102 | DO_2D( 1, 1, 1, 1 ) |
---|
[12340] | 103 | ikt = ktop(ji,jj) |
---|
| 104 | ikb = kbot(ji,jj) |
---|
| 105 | ! level fully include in the ice shelf boundary layer |
---|
| 106 | DO jk = ikt, ikb - 1 |
---|
| 107 | phdiv(ji,jj,jk) = phdiv(ji,jj,jk) + zhdiv(ji,jj) |
---|
[11395] | 108 | END DO |
---|
[12340] | 109 | ! level partially include in ice shelf boundary layer |
---|
| 110 | phdiv(ji,jj,ikb) = phdiv(ji,jj,ikb) + zhdiv(ji,jj) * pfrac(ji,jj) |
---|
| 111 | END_2D |
---|
[11395] | 112 | ! |
---|
| 113 | END SUBROUTINE isf_hdiv_mlt |
---|
| 114 | |
---|
[12068] | 115 | SUBROUTINE isf_hdiv_cpl(Kmm, pqvol, phdiv) |
---|
[11521] | 116 | !!---------------------------------------------------------------------- |
---|
| 117 | !! *** SUBROUTINE isf_hdiv_cpl *** |
---|
| 118 | !! |
---|
[11541] | 119 | !! ** Purpose : update the horizontal divergence with the ice shelf |
---|
| 120 | !! coupling conservation increment |
---|
[11521] | 121 | !! |
---|
[11541] | 122 | !! ** Method : pqvol is positive (outflow) and expressed as m3/s |
---|
| 123 | !! increase the divergence |
---|
[11521] | 124 | !! |
---|
[11541] | 125 | !! ** Action : phdivn increased by the ice shelf outflow |
---|
| 126 | !! |
---|
[11521] | 127 | !!---------------------------------------------------------------------- |
---|
[11423] | 128 | REAL(wp), DIMENSION(jpi,jpj,jpk), INTENT(inout) :: phdiv |
---|
[11521] | 129 | !!---------------------------------------------------------------------- |
---|
[12068] | 130 | INTEGER, INTENT(in) :: Kmm ! ocean time level index |
---|
[11529] | 131 | REAL(wp), DIMENSION(jpi,jpj,jpk), INTENT(in ) :: pqvol |
---|
[11521] | 132 | !!---------------------------------------------------------------------- |
---|
| 133 | INTEGER :: jk |
---|
| 134 | !!---------------------------------------------------------------------- |
---|
| 135 | ! |
---|
[11423] | 136 | DO jk=1,jpk |
---|
[13237] | 137 | phdiv(:,:,jk) = phdiv(:,:,jk) + pqvol(:,:,jk) * r1_e1e2t(:,:) & |
---|
| 138 | & / e3t(:,:,jk,Kmm) |
---|
[11423] | 139 | END DO |
---|
[11521] | 140 | ! |
---|
| 141 | END SUBROUTINE isf_hdiv_cpl |
---|
[11423] | 142 | |
---|
[11395] | 143 | END MODULE isfhdiv |
---|