Compute vertical diffusivity using the Medium-Range Forecast (MRF) boundary layer scheme.
210 int klo = geom.Domain().smallEnd(2);
211 int khi = geom.Domain().bigEnd(2);
216 MultiFab pblh_mf(eddyViscosity.boxArray(), eddyViscosity.DistributionMap(), 1, 0);
227 const int ng_avail = std::min({cons_in.nGrowVect()[0], cons_in.nGrowVect()[1],
228 xvel.nGrowVect()[0],
xvel.nGrowVect()[1],
229 yvel.nGrowVect()[0],
yvel.nGrowVect()[1],
230 SurfLayer->get_u_star(level)->nGrowVect()[0],
231 SurfLayer->get_u_star(level)->nGrowVect()[1],
232 SurfLayer->get_olen(level)->nGrowVect()[0],
233 SurfLayer->get_olen(level)->nGrowVect()[1],
234 (terrain_blank) ? terrain_blank->nGrowVect()[0] : 1000,
235 (terrain_blank) ? terrain_blank->nGrowVect()[1] : 1000});
236 if (ng_pblh > ng_avail) {
238 +
" needs " + std::to_string(ng_pblh) +
" halo columns, but the state and "
239 "surface-layer arrays carry only " + std::to_string(ng_avail)
240 +
"; reduce erf.pblh_smoothing_passes to at most " + std::to_string(ng_avail));
245 #pragma omp parallel if (Gpu::notInLaunchRegion())
248 for (MFIter mfi(eddyViscosity,
TileNoZ()); mfi.isValid(); ++mfi) {
251 const Box& gbx = mfi.growntilebox(IntVect(1,1,0));
253 gbx.bigEnd(2) ==
khi );
256 const GeometryData gdata = geom.data();
257 const Box xybx = PerpendicularBox<ZDir>(gbx, IntVect{0, 0, 0});
267 ? amrex::grow(mfi.tilebox(), IntVect(ng_pblh,ng_pblh,0)) : gbx;
268 const Box xybx_work = PerpendicularBox<ZDir>(gbx_work, IntVect{0, 0, 0});
269 const Box xybx_tile = PerpendicularBox<ZDir>(mfi.tilebox(), IntVect{0, 0, 0});
276 FArrayBox pbl_height_predictor(xybx_work, 1, The_Async_Arena());
277 FArrayBox pbl_height_corrector(xybx_work, 1, The_Async_Arena());
278 IArrayBox pbl_index(xybx_work, 1, The_Async_Arena());
279 IArrayBox pbl_index_zero_ri(xybx_work, 1, The_Async_Arena());
280 FArrayBox hgamt_fab(xybx_work, 1, The_Async_Arena());
281 FArrayBox hgamq_fab(xybx_work, 1, The_Async_Arena());
282 FArrayBox wstar_fab(xybx_work, 1, The_Async_Arena());
283 FArrayBox vpert_fab(xybx_work, 1, The_Async_Arena());
284 FArrayBox pblh_floor_fab(xybx_work, 1, The_Async_Arena());
285 const auto& pblh_pred_arr = pbl_height_predictor.array();
286 const auto& pblh_corr_arr = pbl_height_corrector.array();
287 const auto& pblh_floor_arr = pblh_floor_fab.array();
288 const auto& pbli_arr = pbl_index.array();
289 const auto& pbli_zero_arr = pbl_index_zero_ri.array();
290 const auto& hgamt_arr = hgamt_fab.array();
291 const auto& hgamq_arr = hgamq_fab.array();
292 const auto& wstar_arr = wstar_fab.array();
293 const auto& vpert_arr = vpert_fab.array();
296 const auto& cell_data = cons_in.const_array(mfi);
297 const auto& uvel =
xvel.const_array(mfi);
298 const auto& vvel =
yvel.const_array(mfi);
301 const auto& u_star_arr = SurfLayer->get_u_star(level)->const_array(mfi);
302 const auto& t_star_arr = SurfLayer->get_t_star(level)->const_array(mfi);
303 const auto& l_obuk_arr = SurfLayer->get_olen(level)->const_array(mfi);
304 const auto& t10av_arr = SurfLayer->get_mac_avg(level, 3)->const_array(mfi);
305 const auto& q10av_arr = SurfLayer->get_mac_avg(level, 4)->const_array(mfi);
306 const auto& lmask_arr = (SurfLayer->get_lmask(level)) ?
307 SurfLayer->get_lmask(level)->const_array(mfi) :
310 const Array4<Real const> z_nd_arr = use_terrain_fitted_coords ? z_phys_nd->array(mfi)
311 : Array4<Real const>{};
322 amrex::MultiFab* q_star_mf = SurfLayer->get_q_star(level);
323 Array4<Real const> q_star_arr = (q_star_mf !=
nullptr) ? q_star_mf->const_array(mfi)
324 : Array4<Real const>{};
337 const bool l_ib = turbChoice.
pbl_ib_aware && (terrain_blank !=
nullptr);
339 "erf.pbl_ib_aware is not supported with terrain-fitted coordinates");
340 const Array4<Real const> blank_arr = l_ib ? terrain_blank->const_array(mfi) : Array4<Real const>{};
341 IArrayBox ksurf_fab(xybx_work, 1, The_Async_Arena());
342 FArrayBox zib_fab(xybx_work, 1, The_Async_Arena());
343 FArrayBox us_eff_fab(xybx_work, 1, The_Async_Arena()), ts_eff_fab(xybx_work, 1, The_Async_Arena());
344 FArrayBox qs_eff_fab(xybx_work, 1, The_Async_Arena()), ol_eff_fab(xybx_work, 1, The_Async_Arena());
345 FArrayBox t10_eff_fab(xybx_work, 1, The_Async_Arena()), q10_eff_fab(xybx_work, 1, The_Async_Arena());
346 const auto& ksurf_arr = ksurf_fab.array();
347 const auto& zib_arr = zib_fab.array();
348 const auto& us_eff_arr = us_eff_fab.array();
const auto& ts_eff_arr = ts_eff_fab.array();
349 const auto& qs_eff_arr = qs_eff_fab.array();
const auto& ol_eff_arr = ol_eff_fab.array();
350 const auto& t10_eff_arr = t10_eff_fab.array();
const auto& q10_eff_arr = q10_eff_fab.array();
352 const Real dz_ib = geom.CellSize(2);
354 const Array4<Real const>& uv_ib =
xvel.const_array(mfi);
355 const Array4<Real const>& vv_ib =
yvel.const_array(mfi);
356 const bool have_qstar = (q_star_mf !=
nullptr);
357 ParallelFor(xybx_work, [=] AMREX_GPU_DEVICE(
int i,
int j,
int) noexcept
361 for (
int kk =
klo; kk <=
khi; ++kk) {
if (blank_arr(i, j, kk) >=
Real(0.5)) {
ks = kk + 1; } }
364 ksurf_arr(i, j, 0) =
ks;
365 zib_arr(i, j, 0) = (
ks -
klo) * dz_ib;
368 const Real u_top =
myhalf * (uv_ib(i, j,
ks) + uv_ib(i + 1, j,
ks));
369 const Real v_top =
myhalf * (vv_ib(i, j,
ks) + vv_ib(i, j + 1,
ks));
370 const Real ws_top = std::sqrt(u_top * u_top + v_top * v_top);
371 us_eff_arr(i, j, 0) = amrex::max(
KAPPA * ws_top / std::log(
myhalf * dz_ib / z0_ib),
Real(1.0e-3));
372 ts_eff_arr(i, j, 0) =
Real(0);
373 qs_eff_arr(i, j, 0) =
Real(0);
374 ol_eff_arr(i, j, 0) =
Real(1.0e10);
379 us_eff_arr(i, j, 0) = u_star_arr(i, j, 0);
380 ts_eff_arr(i, j, 0) = t_star_arr(i, j, 0);
381 qs_eff_arr(i, j, 0) = have_qstar ? q_star_arr(i, j, 0) :
Real(0);
382 ol_eff_arr(i, j, 0) = l_obuk_arr(i, j, 0);
383 t10_eff_arr(i, j, 0) = t10av_arr(i, j, 0);
389 ParallelFor(xybx_work, [=] AMREX_GPU_DEVICE(
int i,
int j,
int) noexcept
391 const int ksrf = ksurf_arr(i, j, 0);
392 const Real zib = zib_arr(i, j, 0);
393 amrex::ignore_unused(zib);
394 const Real t_layer = t10_eff_arr(i, j, 0);
396 const Real t_layer_v = t_layer * (
one +
epsv * moisture_fraction);
402 zval = (use_terrain_fitted_coords)
404 : ((kpbl +
myhalf) * gdata.CellSize(2) - zib);
405 const Real theta_v =
GetThetav(i, j, kpbl, cell_data, moisture_indices);
406 const Real theta_v_klo = amrex::max(
GetThetav(i, j, ksrf, cell_data, moisture_indices),
Real(1.0));
407 const Real ws2_raw =
fourth * ( (uvel(i, j, kpbl) + uvel(i + 1, j, kpbl)) *
408 (uvel(i, j, kpbl) + uvel(i + 1, j, kpbl)) +
409 (vvel(i, j, kpbl) + vvel(i, j + 1, kpbl)) *
410 (vvel(i, j, kpbl) + vvel(i, j + 1, kpbl)) );
417 : amrex::max(ws2_raw,
Real(1.0));
418 Rib =
CONST_GRAV * zval * (theta_v - t_layer_v) / (ws2 * theta_v_klo);
421 Real zval0 = zval, Rib0 = Rib;
422 bool above_critical =
false;
423 while (!above_critical && ((kpbl + 1) <=
khi)) {
428 zval = (use_terrain_fitted_coords)
430 : ((kpbl +
myhalf) * gdata.CellSize(2) - zib);
431 const Real theta_v =
GetThetav(i, j, kpbl, cell_data, moisture_indices);
432 const Real theta_v_klo = amrex::max(
GetThetav(i, j, ksrf, cell_data, moisture_indices),
Real(1.0));
433 const Real ws2_raw =
fourth * ( (uvel(i, j, kpbl) + uvel(i + 1, j, kpbl)) *
434 (uvel(i, j, kpbl) + uvel(i + 1, j, kpbl)) +
435 (vvel(i, j, kpbl) + vvel(i, j + 1, kpbl)) *
436 (vvel(i, j, kpbl) + vvel(i, j + 1, kpbl)) );
441 : amrex::max(ws2_raw,
Real(1.0));
442 Rib =
CONST_GRAV * zval * (theta_v - t_layer_v) / (ws2 * theta_v_klo);
443 above_critical = (Rib >= Ribcr);
446 const Real pblh_emp = (use_terrain_fitted_coords)
448 :
myhalf * gdata.CellSize(2);
449 const Real z_max = (use_terrain_fitted_coords)
451 : ((
khi +
myhalf) * gdata.CellSize(2) - zib);
452 const Real pblh_max =
Real(0.9) * z_max;
453 const Real pblh_min = amrex::max(pblh_emp,
Real(10.0));
455 if (above_critical) {
457 const Real rib_diff = Rib - Rib0;
458 if (std::abs(rib_diff) >
Real(1.0e-10)) {
459 pblh_interp = zval0 + (zval - zval0) / rib_diff * (Ribcr - Rib0);
464 pblh_pred_arr(i, j, 0) = amrex::max(amrex::min(pblh_interp, pblh_max), pblh_min);
465 pbli_arr(i, j, 0) = kpbl;
467 pblh_pred_arr(i, j, 0) = pblh_min;
468 pbli_arr(i, j, 0) = ksrf + 1;
477 constexpr
Real GAMCRQ =
Real(2.e-3);
488 ParallelFor(xybx_work, [=,zero_d=
zero] AMREX_GPU_DEVICE(
int i,
int j,
int) noexcept
490 const int ksrf = ksurf_arr(i, j, 0);
491 const Real zib = zib_arr(i, j, 0);
492 amrex::ignore_unused(zib);
493 const Real t_layer = t10_eff_arr(i, j, 0);
494 Real obuk_val = ol_eff_arr(i, j, 0);
500 const Real HOL = sf * pblh_pred_arr(i, j, 0) / obuk_val;
501 const Real HOL_bounded = amrex::max(amrex::min(HOL,
Real(100.0)),
Real(-100.0));
505 const Real HOL_abs = std::abs(HOL_bounded);
506 const Real one_quarter =
Real(0.25);
507 const Real phiM = (obuk_val > 0)
508 ? (1 + 5 * HOL_bounded)
509 : std::pow(1 + 16 * HOL_abs, -one_quarter);
510 const Real phiM_safe = amrex::max(phiM,
Real(0.01));
521 const Real theta_v0 = amrex::max(
GetThetav(i, j, ksrf, cell_data, moisture_indices),
Real(1.0));
522 const Real wthv0 = amrex::max(-us_eff_arr(i,j,0) * ts_eff_arr(i,j,0),
Real(0.0));
523 const Real zi = amrex::max(pblh_pred_arr(i, j, 0),
Real(10.0));
526 Real wstar_shear = us_eff_arr(i, j, 0) / phiM_safe;
530 Real wstar = std::cbrt(wstar_shear*wstar_shear*wstar_shear +
531 wstar_conv*wstar_conv*wstar_conv);
533 wstar = amrex::max(wstar,
Real(0.01));
534 wstar = amrex::min(wstar,
Real(5.0));
536 bool SFCFLG = (obuk_val <= zero_d);
537 const Real HGAMT = (SFCFLG && enable_mrf_countergradient)
538 ? amrex::min(-const_b * us_eff_arr(i, j, 0) * ts_eff_arr(i, j, 0) / wstar, GAMCRT)
542 if (SFCFLG &&
use_moisture && enable_mrf_countergradient) {
543 const Real q_star = qs_eff_arr(i, j, 0);
544 const Real HGAMQ_calc = -const_b * us_eff_arr(i, j, 0) * q_star / wstar;
545 HGAMQ = amrex::max(amrex::min(HGAMQ_calc, GAMCRQ),
Real(0));
548 bool is_land = (lmask_arr(i,j,0) == 1);
549 if (!is_land) HGAMQ = zero_d;
552 if (moisture_indices.
qv >= 0) {
553 Real qv_klo = cell_data(i, j, ksrf, moisture_indices.
qv) / cell_data(i, j, ksrf,
Rho_comp);
557 Real qsat_klo = zero_d;
559 Real rh_klo = (qsat_klo >
Real(1.0e-10)) ? (qv_klo / qsat_klo) :
Real(0);
560 if (rh_klo >
Real(0.95)) {
561 Real rh_scaling = amrex::max(zero_d, (
Real(1) - rh_klo) /
Real(0.05));
570 if (pbli_arr(i, j, 0) <= ksrf + 1 || !enable_mrf_countergradient) {
571 vpert_arr(i, j, 0) = zero_d;
573 const Real VPERT_raw = HGAMT +
epsv * t_layer * HGAMQ;
574 const Real VPERT_capped = enable_mrf_unbounded_vpert
576 : amrex::min(VPERT_raw, GAMCRT);
577 vpert_arr(i, j, 0) = amrex::max(VPERT_capped, zero_d);
590 AMREX_GPU_DEVICE(
int i,
int j,
int) noexcept
592 const int ksrf = ksurf_arr(i, j, 0);
593 const Real zib = zib_arr(i, j, 0);
594 amrex::ignore_unused(zib);
595 const Real t_layer = t10_eff_arr(i, j, 0);
598 const Real t_layer_v = t_layer * (
one +
epsv * moisture_fraction)
599 + vpert_arr(i, j, 0);
601 Real obuk_val = ol_eff_arr(i, j, 0);
609 zval = (use_terrain_fitted_coords)
611 : ((kpbl +
myhalf) * gdata.CellSize(2) - zib);
612 const Real theta_v =
GetThetav(i, j, kpbl, cell_data, moisture_indices);
613 const Real theta_v_klo = amrex::max(
GetThetav(i, j, ksrf, cell_data, moisture_indices), one_d);
614 const Real ws2_raw =
fourth * ( (uvel(i, j, kpbl) + uvel(i + 1, j, kpbl)) *
615 (uvel(i, j, kpbl) + uvel(i + 1, j, kpbl)) +
616 (vvel(i, j, kpbl) + vvel(i, j + 1, kpbl)) *
617 (vvel(i, j, kpbl) + vvel(i, j + 1, kpbl)) );
621 : amrex::max(ws2_raw, one_d);
622 Rib =
CONST_GRAV * zval * (theta_v - t_layer_v) / (ws2 * theta_v_klo);
624 Real zval0 = zval, Rib0 = Rib;
626 bool above_critical =
false;
627 while (!above_critical && ((kpbl + 1) <=
khi)) {
632 zval = (use_terrain_fitted_coords)
634 : ((kpbl +
myhalf) * gdata.CellSize(2) - zib);
635 const Real theta_v =
GetThetav(i, j, kpbl, cell_data, moisture_indices);
636 const Real theta_v_klo = amrex::max(
GetThetav(i, j, ksrf, cell_data, moisture_indices), one_d);
637 const Real ws2_raw =
fourth * ( (uvel(i, j, kpbl) + uvel(i + 1, j, kpbl)) *
638 (uvel(i, j, kpbl) + uvel(i + 1, j, kpbl)) +
639 (vvel(i, j, kpbl) + vvel(i, j + 1, kpbl)) *
640 (vvel(i, j, kpbl) + vvel(i, j + 1, kpbl)) );
644 : amrex::max(ws2_raw, one_d);
645 Rib =
CONST_GRAV * zval * (theta_v - t_layer_v) / (ws2 * theta_v_klo);
646 above_critical = (Rib >= Ribcr);
649 const Real pblh_emp = (use_terrain_fitted_coords)
651 :
myhalf * gdata.CellSize(2);
652 const Real z_max = (use_terrain_fitted_coords)
654 : ((
khi +
myhalf) * gdata.CellSize(2) - zib);
655 const Real pblh_max =
Real(0.9) * z_max;
656 const Real pblh_min = amrex::max(pblh_emp,
Real(10.0));
658 if (above_critical) {
660 const Real rib_diff = Rib - Rib0;
661 if (std::abs(rib_diff) >
Real(1.0e-10)) {
662 pblh_interp = zval0 + (zval - zval0) / rib_diff * (Ribcr - Rib0);
667 pblh_corr_arr(i, j, 0) = amrex::max(amrex::min(pblh_interp, pblh_max), pblh_min);
668 pbli_arr(i, j, 0) = kpbl;
670 pblh_corr_arr(i, j, 0) = pblh_min;
671 pbli_arr(i, j, 0) = ksrf + 1;
673 pblh_floor_arr(i, j, 0) = pblh_min;
689 ParallelFor(xybx_work, [=] AMREX_GPU_DEVICE(
int i,
int j,
int) noexcept {
690 pblh_corr_arr(i, j, 0) += zib_arr(i, j, 0);
695 geom.Domain(), geom.periodicity());
696 ParallelFor(xybx_work, [=] AMREX_GPU_DEVICE(
int i,
int j,
int) noexcept {
697 pblh_corr_arr(i, j, 0) = amrex::max(pblh_corr_arr(i, j, 0) - zib_arr(i, j, 0), pblh_floor_arr(i, j, 0));
707 auto pblh_out = pblh_mf.array(mfi);
708 const Box& tbx = mfi.tilebox();
713 ParallelFor(tbx, [=] AMREX_GPU_DEVICE(
int i,
int j,
int k) noexcept {
714 pblh_out(i, j, k) = pblh_corr_arr(i, j, 0) + zib_arr(i, j, 0);
724 ParallelFor(xybx, [=] AMREX_GPU_DEVICE(
int i,
int j,
int) noexcept
726 const int ksrf = ksurf_arr(i, j, 0);
727 const Real zib = zib_arr(i, j, 0);
728 amrex::ignore_unused(zib);
730 Real obuk_val = ol_eff_arr(i, j, 0);
736 const Real HOL = sf * pblh_corr_arr(i, j, 0) / obuk_val;
737 const Real HOL_bounded = amrex::max(amrex::min(HOL,
Real(100.0)),
Real(-100.0));
741 const Real HOL_abs = std::abs(HOL_bounded);
742 const Real one_quarter =
Real(0.25);
747 const Real phiM = (obuk_val > 0)
748 ? (enable_qnse_d >
Real(0.5)
749 ? (1 + qnse_am_d * HOL_bounded) / (1 + qnse_bm_d * HOL_bounded)
750 : (1 + 5 * HOL_bounded))
751 : std::pow(1 + 16 * HOL_abs, -one_quarter);
752 const Real phiM_safe = amrex::max(phiM,
Real(0.01));
757 const Real theta_v0 = amrex::max(
GetThetav(i, j, ksrf, cell_data, moisture_indices),
Real(1.0));
758 const Real wthv0 = amrex::max(-us_eff_arr(i,j,0) * ts_eff_arr(i,j,0),
Real(0.0));
762 const Real zi = amrex::max(pblh_corr_arr(i, j, 0),
Real(10.0));
765 Real wstar_shear = us_eff_arr(i, j, 0) / phiM_safe;
769 Real wstar = std::cbrt(wstar_shear*wstar_shear*wstar_shear +
770 wstar_conv*wstar_conv*wstar_conv);
772 wstar = amrex::max(wstar,
Real(0.01));
773 wstar = amrex::min(wstar,
Real(5.0));
774 wstar_arr(i, j, 0) = wstar;
775 bool SFCFLG = (obuk_val <=
Real(0));
785 const Real HGAMT = (SFCFLG && enable_mrf_countergradient)
786 ? amrex::max(amrex::min(-const_b * us_eff_arr(i, j, 0)
787 * ts_eff_arr(i, j, 0) / wstar, GAMCRT),
Real(0))
791 if (SFCFLG &&
use_moisture && enable_mrf_countergradient) {
792 const Real q_star = qs_eff_arr(i, j, 0);
793 const Real HGAMQ_calc = -const_b * us_eff_arr(i, j, 0) * q_star / wstar;
794 HGAMQ = amrex::max(amrex::min(HGAMQ_calc, GAMCRQ),
Real(0));
797 bool is_land = (lmask_arr(i,j,0) == 1);
798 if (!is_land) HGAMQ =
Real(0);
801 if (moisture_indices.
qv >= 0) {
802 Real qv_klo = cell_data(i, j, ksrf, moisture_indices.
qv) / cell_data(i, j, ksrf,
Rho_comp);
808 Real rh_klo = (qsat_klo >
Real(1.0e-10)) ? (qv_klo / qsat_klo) :
Real(0);
809 if (rh_klo >
Real(0.95)) {
816 if (pbli_arr(i, j, 0) <= ksrf + 1) {
817 hgamt_arr(i, j, 0) =
Real(0);
818 hgamq_arr(i, j, 0) =
Real(0);
820 const Real pblh = pblh_corr_arr(i, j, 0);
821 if (pblh >
Real(1.0e-10)) {
822 hgamt_arr(i, j, 0) = (enable_mrf_countergradient) ? HGAMT / pblh :
Real(0);
823 hgamq_arr(i, j, 0) = (enable_mrf_countergradient &&
use_moisture) ? HGAMQ / pblh :
Real(0);
825 hgamt_arr(i, j, 0) =
Real(0);
826 hgamq_arr(i, j, 0) =
Real(0);
836 constexpr
Real Ribcr_zero =
Real(0);
838 AMREX_GPU_DEVICE(
int i,
int j,
int) noexcept
840 const int ksrf = ksurf_arr(i, j, 0);
841 const Real zib = zib_arr(i, j, 0);
842 amrex::ignore_unused(zib);
843 const Real t_layer = t10_eff_arr(i, j, 0);
845 const Real t_layer_v = t_layer * (
one +
epsv * moisture_fraction);
846 const Real t_layer_v_enhanced = t_layer_v + vpert_arr(i, j, 0);
848 int kpbl_zero = ksrf;
849 Real zval_zero, Rib_zero;
851 zval_zero = (use_terrain_fitted_coords)
853 : ((kpbl_zero +
myhalf) * gdata.CellSize(2) - zib);
854 const Real theta_v =
GetThetav(i, j, kpbl_zero, cell_data, moisture_indices);
855 const Real theta_v_klo = amrex::max(
GetThetav(i, j, ksrf, cell_data, moisture_indices), one_d);
856 const Real ws2_raw =
fourth * ( (uvel(i, j, kpbl_zero) + uvel(i + 1, j, kpbl_zero)) *
857 (uvel(i, j, kpbl_zero) + uvel(i + 1, j, kpbl_zero)) +
858 (vvel(i, j, kpbl_zero) + vvel(i, j + 1, kpbl_zero)) *
859 (vvel(i, j, kpbl_zero) + vvel(i, j + 1, kpbl_zero)) );
863 : amrex::max(ws2_raw, one_d);
864 Rib_zero =
CONST_GRAV * zval_zero * (theta_v - t_layer_v_enhanced) / (ws2 * theta_v_klo);
867 bool above_critical_zero =
false;
868 while (!above_critical_zero && ((kpbl_zero + 1) <=
khi)) {
870 zval_zero = (use_terrain_fitted_coords)
872 : ((kpbl_zero +
myhalf) * gdata.CellSize(2) - zib);
873 const Real theta_v =
GetThetav(i, j, kpbl_zero, cell_data, moisture_indices);
874 const Real theta_v_klo = amrex::max(
GetThetav(i, j, ksrf, cell_data, moisture_indices), one_d);
875 const Real ws2_raw =
fourth * ( (uvel(i, j, kpbl_zero) + uvel(i + 1, j, kpbl_zero)) *
876 (uvel(i, j, kpbl_zero) + uvel(i + 1, j, kpbl_zero)) +
877 (vvel(i, j, kpbl_zero) + vvel(i, j + 1, kpbl_zero)) *
878 (vvel(i, j, kpbl_zero) + vvel(i, j + 1, kpbl_zero)) );
882 : amrex::max(ws2_raw, one_d);
883 Rib_zero =
CONST_GRAV * zval_zero * (theta_v - t_layer_v_enhanced) / (ws2 * theta_v_klo);
884 above_critical_zero = (Rib_zero >= Ribcr_zero);
887 if (above_critical_zero) {
888 pbli_zero_arr(i, j, 0) = kpbl_zero;
890 pbli_zero_arr(i, j, 0) = ksrf + 1;
896 const Array4<Real>& K_turb = eddyViscosity.array(mfi);
905 const auto&
dxInv = geom.InvCellSizeArray();
906 const Real dz_inv = geom.InvCellSize(2);
907 const int izmin = geom.Domain().smallEnd(2);
908 const int izmax = geom.Domain().bigEnd(2);
918 ParallelFor(gbx, [=] AMREX_GPU_DEVICE(
int i,
int j,
int k) noexcept
920 const int ksrf = ksurf_arr(i, j, 0);
921 const Real zib = zib_arr(i, j, 0);
922 amrex::ignore_unused(zib);
923 Real obuk_val = ol_eff_arr(i, j, 0);
928 const Real zval = (use_terrain_fitted_coords)
930 : ((k +
myhalf) * gdata.CellSize(2) - zib);
937 if (
rho <=
Real(0) || k < ksrf) {
946 const Real met_h_zeta = (use_terrain_fitted_coords)
948 const Real dz_terrain = met_h_zeta / dz_inv;
950 constexpr
Real qc_threshold =
Real(1.0e-4);
954 if (moisture_indices.
qc >= 0) {
955 qc_mix = cell_data(i, j, k, moisture_indices.
qc) /
rho;
957 if (moisture_indices.
qi >= 0) {
958 qi_mix = cell_data(i, j, k, moisture_indices.
qi) /
rho;
961 const Real total_qcloud = qc_mix + qi_mix;
966 if (k < pbli_extent) {
967 const Real HOL = sf * pblh_corr_arr(i, j, 0) / obuk_val;
968 const Real HOL_bounded = amrex::max(amrex::min(HOL,
Real(100.0)),
Real(-100.0));
972 const Real HOL_abs = std::abs(HOL_bounded);
974 const Real one_quarter =
Real(0.25);
981 const Real phiM = (obuk_val > 0)
982 ? (enable_qnse_d >
Real(0.5)
983 ? (1 + qnse_am_d * HOL_bounded) / (1 + qnse_bm_d * HOL_bounded)
984 : (1 + 5 * HOL_bounded))
985 : std::pow(1 + 16 * HOL_abs, -one_quarter);
986 const Real phit = (obuk_val > 0)
987 ? (enable_qnse_d >
Real(0.5)
988 ? (1 + qnse_ah_d * HOL_bounded) / (1 + qnse_bh_d * HOL_bounded)
989 : (1 + 5 * HOL_bounded))
990 : std::pow(1 + 16 * HOL_abs, -
Real(0.5));
992 Real phit_cloud = phit;
993 Real phiM_cloud = phiM;
994 if (has_cloud && obuk_val >
Real(0)) {
995 Real reduction_factor =
Real(1) -
Real(0.15) * amrex::min(total_qcloud / qc_threshold,
Real(1));
997 if (enable_qnse_d >
Real(0.5)) {
998 phiM_cloud = ((1 + qnse_am_d * HOL_bounded * reduction_factor) / (1 + qnse_bm_d * HOL_bounded));
999 phit_cloud = ((1 + qnse_ah_d * HOL_bounded * reduction_factor) / (1 + qnse_bh_d * HOL_bounded));
1001 phiM_cloud =
Real(1) +
Real(5.0) * reduction_factor * sf * pblh_corr_arr(i, j, 0) / obuk_val;
1002 phit_cloud =
Real(1) +
Real(5.0) * reduction_factor * sf * pblh_corr_arr(i, j, 0) / obuk_val;
1004 }
else if (has_cloud && obuk_val <=
Real(0)) {
1005 Real cloud_boost =
Real(1.0) +
Real(0.05) * amrex::min(total_qcloud / qc_threshold,
Real(1));
1006 phiM_cloud = std::pow(
Real(1) +
Real(16.0) * HOL_abs / cloud_boost, -one_quarter);
1007 phit_cloud = std::pow(
Real(1) +
Real(16.0) * HOL_abs / cloud_boost, -
Real(0.5));
1010 const Real phiM_eff = phiM_cloud;
1011 const Real phit_eff = phit_cloud;
1013 Real Prt_base = phit_eff / phiM_eff;
1014 const Real Prt = amrex::min(amrex::max(Prt_base + const_b *
KAPPA * sf, prmin), prmax);
1019 const Real wstar = wstar_arr(i, j, 0);
1032 const Real zl1 = (use_terrain_fitted_coords)
1034 : ((ksrf +
myhalf) * gdata.CellSize(2) - zib);
1035 const Real pblh = pblh_corr_arr(i, j, 0);
1040 const Real pblh_rel = amrex::max(pblh - zl1,
Real(1.0e-4));
1041 const Real zfac = amrex::max(
Real(1) - (zval - zl1) / pblh_rel,
Real(1.0e-8));
1046 }
else if (k >= pbli_extent) {
1051 const Real lscale = (
KAPPA * zval * lambda) / (
KAPPA * zval + lambda);
1052 Real dthetadz, dudz, dvdz;
1053 ComputeVerticalDerivativesPBL(i, j, k, uvel, vvel, cell_data, izmin, izmax, pbl_derivative_dz_inv(i,j,k),
1054 c_ext_dir_on_zlo, c_ext_dir_on_zhi, u_ext_dir_on_zlo,
1055 u_ext_dir_on_zhi, v_ext_dir_on_zlo, v_ext_dir_on_zhi, dthetadz,
1056 dudz, dvdz, moisture_indices, pbl_strat);
1058 const Real dudz_safe = (k < izmax) ? dudz :
Real(0);
1059 const Real dvdz_safe = (k < izmax) ? dvdz :
Real(0);
1060 const Real wind_shear = dudz_safe * dudz_safe + dvdz_safe * dvdz_safe;
1061 const Real wind_shear_safe = std::max(wind_shear,
Real(1.0e-8));
1062 const Real theta_v = amrex::max(
GetThetav(i, j, k, cell_data, moisture_indices),
Real(1.0));
1063 const Real dtheta_v_dz = dthetadz;
1065 Real grad_Ri =
CONST_GRAV / theta_v * dtheta_v_dz / wind_shear_safe;
1066 grad_Ri = std::max(std::min(grad_Ri,
Real(100.0)), -
Real(100.0));
1068 const Real grad_Ri_safe = amrex::max(grad_Ri, -
Real(100.0));
1076 const Real sqrt_neg_Ri = std::sqrt(std::abs(grad_Ri_safe));
1078 const Real fm = (grad_Ri_safe > 0)
1080 : 1 - 8 * grad_Ri_safe / (1 +
Real(1.746) * sqrt_neg_Ri);
1081 const Real ft = (grad_Ri_safe > 0)
1083 : 1 - 8 * grad_Ri_safe / (1 +
Real(1.286) * sqrt_neg_Ri);
1084 const Real rl2wsp =
rho * lscale * lscale * std::sqrt(wind_shear);
1094 const Real Pr_mom = (grad_Ri_safe > 0) ? Pr :
Real(1);
1110 if (l_blend_length > 0.0) {
1116 l_dx, l_blend_length, l_blend_cs, l_blend_cmax,
1121 l_dx, l_blend_length, l_blend_cs, l_blend_cmax,
1128 Real rhoKmin, rhoKmax;
1131 constexpr
Real Kmax =
Real(1000.0);
1132 rhoKmin = ckz * dz_terrain *
rho;
1133 rhoKmax =
rho * Kmax;
1137 rhoKmin =
rho * Kmin;
1138 rhoKmax =
rho * Kmax;
1146 std::min(K_turb(i, j, k,
EddyDiff::Q_v), rhoKmax), rhoKmin);
1164 if (k < pbli_extent) {
1174 ParallelFor(xybx, [=] AMREX_GPU_DEVICE(
int i,
int j,
int ) noexcept
1192 SurfLayer->set_pblh(level, pblh_mf);
constexpr amrex::Real epsv
Definition: ERF_Constants.H:52
constexpr amrex::Real KAPPA
Definition: ERF_Constants.H:67
constexpr amrex::Real CONST_GRAV
Definition: ERF_Constants.H:68
AMREX_GPU_HOST_DEVICE AMREX_FORCE_INLINE amrex::Real getTgivenRandRTh(const amrex::Real rho, const amrex::Real rhotheta, const amrex::Real qv=amrex::Real(0))
Definition: ERF_EOS.H:46
AMREX_GPU_HOST_DEVICE AMREX_FORCE_INLINE amrex::Real getPgivenRTh(const amrex::Real rhotheta, const amrex::Real qv=amrex::Real(0))
Definition: ERF_EOS.H:81
#define Rho_comp
Definition: ERF_IndexDefines.H:42
#define RhoTheta_comp
Definition: ERF_IndexDefines.H:43
amrex::GpuArray< Real, AMREX_SPACEDIM > dxInv
Definition: ERF_InitCustomPertVels_ParticleTests.H:17
const int klo
Definition: ERF_InitCustomPert_ABL.H:75
const bool use_moisture
Definition: ERF_InitCustomPert_ABL.H:71
const int khi
Definition: ERF_InitCustomPert_Bubble.H:21
AMREX_ALWAYS_ASSERT(bx.length()[2]==khi+1)
AMREX_ALWAYS_ASSERT_WITH_MESSAGE(m_cloud_chamber_config.active, "Cloud Chamber: initializer reached without a parsed configuration")
AMREX_GPU_HOST_DEVICE AMREX_FORCE_INLINE void erf_qsatw(amrex::Real t, amrex::Real p, amrex::Real &qsatw)
Definition: ERF_MicrophysicsUtils.H:264
AMREX_GPU_DEVICE AMREX_FORCE_INLINE amrex::Real GetThetav(const int &i, const int &j, const int &k, const amrex::Array4< amrex::Real const > &cell_data, const MoistureComponentIndices &moisture_indices)
Definition: ERF_MoistUtils.H:74
ParallelFor(fab_box, [=] AMREX_GPU_DEVICE(int i, int j, int k) { qrcuten_arr(i, j, k)=Real(0);qscuten_arr(i, j, k)=Real(0);qicuten_arr(i, j, k)=Real(0);})
constexpr amrex::Real one
Definition: ERF_NumericalConstants.H:37
constexpr amrex::Real fourth
Definition: ERF_NumericalConstants.H:42
constexpr amrex::Real zero
Definition: ERF_NumericalConstants.H:36
constexpr amrex::Real myhalf
Definition: ERF_NumericalConstants.H:41
AMREX_GPU_DEVICE AMREX_FORCE_INLINE void ComputeVerticalDerivativesPBL(int i, int j, int k, const amrex::Array4< const amrex::Real > &uvel, const amrex::Array4< const amrex::Real > &vvel, const amrex::Array4< const amrex::Real > &cell_data, const int izmin, const int izmax, const PBLDerivativeDzInv &dz_inv, const bool c_ext_dir_on_zlo, const bool c_ext_dir_on_zhi, const bool u_ext_dir_on_zlo, const bool u_ext_dir_on_zhi, const bool v_ext_dir_on_zlo, const bool v_ext_dir_on_zhi, amrex::Real &dthetadz, amrex::Real &dudz, amrex::Real &dvdz, const MoistureComponentIndices &moisture_indices, const StratType strat=StratType::thetav)
Definition: ERF_PBLModels.H:304
void ApplyPBLHSmoothing(amrex::FArrayBox &pblh_fab, const amrex::Box &xybx_valid, const amrex::Real weight, const int passes, const amrex::Box &domain, const amrex::Periodicity &periodicity)
Apply spatial smoothing to PBLH field using 5-point stencil.
Definition: ERF_PBLModels.H:717
AMREX_GPU_HOST_DEVICE AMREX_FORCE_INLINE amrex::Real pbl_kh_blend_and_cap(amrex::Real K_h, amrex::Real dx, amrex::Real L_blend, amrex::Real C_s, amrex::Real c_max, amrex::Real SmnSmn, bool use_smag) noexcept
Apply scale-aware blending and ceiling to a single K_h value.
Definition: ERF_PBLScaleAwareBlending.H:133
amrex::Real Real
Definition: ERF_ShocInterface.H:19
AMREX_GPU_HOST_DEVICE AMREX_FORCE_INLINE amrex::Real Compute_Zrel_AtCellCenter(const int &i, const int &j, const int &k, const amrex::Array4< const amrex::Real > &z_nd)
Definition: ERF_TerrainMetrics.H:758
AMREX_GPU_HOST_DEVICE AMREX_FORCE_INLINE amrex::Real Compute_h_zeta_AtCellCenter(const int &i, const int &j, const int &k, const amrex::GpuArray< amrex::Real, AMREX_SPACEDIM > &cellSizeInv, const amrex::Array4< const amrex::Real > &z_nd)
Definition: ERF_TerrainMetrics.H:197
AMREX_FORCE_INLINE amrex::IntVect TileNoZ()
Definition: ERF_TileNoZ.H:11
@ yvel_bc
Definition: ERF_IndexDefines.H:109
@ cons_bc
Definition: ERF_IndexDefines.H:92
@ xvel_bc
Definition: ERF_IndexDefines.H:108
@ ext_dir
Definition: ERF_IndexDefines.H:300
@ Theta_v
Definition: ERF_IndexDefines.H:253
@ Turb_lengthscale
Definition: ERF_IndexDefines.H:257
@ Q_v
Definition: ERF_IndexDefines.H:256
@ Mom_v
Definition: ERF_IndexDefines.H:252
@ HGAMQ_v
Definition: ERF_IndexDefines.H:264
@ HGAMT_v
Definition: ERF_IndexDefines.H:263
@ ks
Definition: ERF_SLM.H:74
@ rho
Definition: ERF_Kessler.H:25
@ xvel
Definition: ERF_IndexDefines.H:218
@ yvel
Definition: ERF_IndexDefines.H:219
@ zi
Definition: ERF_AdvanceWDM6.cpp:276
int qi
cloud ice
Definition: ERF_DataStruct.H:251
int qv
water vapor
Definition: ERF_DataStruct.H:249
int qc
cloud liquid water
Definition: ERF_DataStruct.H:250
Functor for inverse vertical spacings for terrain-following grids using cell-center heights.
Definition: ERF_PBLModels.H:663
bool enable_mrf_unbounded_vpert
Whether MRF leaves VPERT unlimited by GAMCRT.
Definition: ERF_TurbStruct.H:996
amrex::Real pbl_blend_length
Boutle blending length L [m]. 0 = off.
Definition: ERF_TurbStruct.H:987
bool pbl_mrf_use_zero_ri_extent
Whether MRF uses the Ri=0 K-profile extent.
Definition: ERF_TurbStruct.H:997
amrex::Real qnse_ah
Definition: ERF_TurbStruct.H:1007
StratType pbl_strat_type
Definition: ERF_TurbStruct.H:819
bool enable_vh96_shear_correction
Whether Vogelezang & Holtslag (1996) shear-correction term is enabled.
Definition: ERF_TurbStruct.H:974
bool enable_mrf_cloud_adjustment
Whether MRF cloud-aware stability adjustments are enabled.
Definition: ERF_TurbStruct.H:994
amrex::Real pbl_mrf_const_b
MRF constant used to compute PBL height.
Definition: ERF_TurbStruct.H:982
amrex::Real pblh_smoothing_weight
Center-cell weight in PBLH smoothing stencil (must be in [0,1]).
Definition: ERF_TurbStruct.H:978
amrex::Real pbl_blend_cs
Smagorinsky coeff for K_h ceiling.
Definition: ERF_TurbStruct.H:988
amrex::Real qnse_bm
Definition: ERF_TurbStruct.H:1006
amrex::Real pbl_blend_c_max
Power-law ceiling coeff [m^(2/3)/s].
Definition: ERF_TurbStruct.H:989
amrex::Real qnse_bh
Definition: ERF_TurbStruct.H:1008
bool enable_qnse_stable_functions
Definition: ERF_TurbStruct.H:1003
bool enable_mrf_countergradient
Whether MRF countergradient corrections are enabled.
Definition: ERF_TurbStruct.H:991
bool enable_pblh_smoothing
Whether spatial smoothing of diagnosed PBLH is enabled.
Definition: ERF_TurbStruct.H:976
int pblh_smoothing_passes
Number of PBLH smoothing iterations to apply.
Definition: ERF_TurbStruct.H:977
amrex::Real pbl_ib_z0
Definition: ERF_TurbStruct.H:993
bool pbl_ib_aware
Definition: ERF_TurbStruct.H:992
bool pbl_mrf_highres_bounds
Whether MRF applies high-resolution grid-dependent diffusivity bounds.
Definition: ERF_TurbStruct.H:995
amrex::Real vh96_shear_const_b
Vogelezang & Holtslag (1996) shear-correction constant b.
Definition: ERF_TurbStruct.H:975
amrex::Real pbl_mrf_Ribcr
Critical bulk Richardson number for the MRF PBL scheme.
Definition: ERF_TurbStruct.H:981
amrex::Real qnse_am
Definition: ERF_TurbStruct.H:1005
amrex::Real pbl_mrf_sf
MRF surface flux value used to compute PBL height.
Definition: ERF_TurbStruct.H:983