ERF
Energy Research and Forecasting: An Atmospheric Modeling Code
surface_flux Struct Reference

#include <ERF_MOSTStress.H>

Collaboration diagram for surface_flux:

Public Member Functions

 surface_flux (amrex::Real Tflux, amrex::Real Qvflux, bool cons_qflux)
 
AMREX_GPU_DEVICE AMREX_FORCE_INLINE void iterate_flux (const int &i, const int &j, const int &k, const int &max_iters, const amrex::Array4< const amrex::Real > &zref_arr, const amrex::Array4< const amrex::Real > &z0_arr, const amrex::Array4< const amrex::Real > &umm_arr, const amrex::Array4< const amrex::Real > &tm_arr, const amrex::Array4< const amrex::Real > &tvm_arr, const amrex::Array4< const amrex::Real > &qvm_arr, const amrex::Array4< amrex::Real > &u_star_arr, const amrex::Array4< amrex::Real > &w_star_arr, const amrex::Array4< amrex::Real > &t_star_arr, const amrex::Array4< amrex::Real > &q_star_arr, const amrex::Array4< amrex::Real > &t_surf_arr, const amrex::Array4< amrex::Real > &q_surf_arr, const amrex::Array4< amrex::Real > &olen_arr, const amrex::Array4< amrex::Real > &pblh_arr, const amrex::Array4< amrex::Real > &, const amrex::Array4< amrex::Real > &, const amrex::Array4< amrex::Real > &) const
 

Private Attributes

most_data mdata
 
bool spec_qflux
 
similarity_funs sfuns
 
const amrex::Real tol = amrex::Real(1.0e-5)
 
const amrex::Real WSMIN = amrex::Real(0.1)
 
const amrex::Real USTARMIN = amrex::Real(0.001)
 
const amrex::Real alpha = amrex::Real(0.5)
 

Detailed Description

Surface flux with constant roughness

Constructor & Destructor Documentation

◆ surface_flux()

surface_flux::surface_flux ( amrex::Real  Tflux,
amrex::Real  Qvflux,
bool  cons_qflux 
)
inline

Construct specified-flux, constant-roughness MOST data.

Parameters
[in]Tfluxprescribed heat flux
[in]Qvfluxprescribed moisture flux
[in]cons_qfluxwhether the moisture flux is specified
505  {
506  mdata.surf_temp_flux = Tflux;
507  mdata.surf_moist_flux = Qvflux;
508  spec_qflux = cons_qflux;
509  }
amrex::Real surf_moist_flux
Moisture flux.
Definition: ERF_MOSTUtils.H:16
amrex::Real surf_temp_flux
Heat flux TODO: decide whether this is <θ'w'> or <θv'w'> under moist conditions.
Definition: ERF_MOSTUtils.H:15
most_data mdata
Definition: ERF_MOSTStress.H:627
bool spec_qflux
Definition: ERF_MOSTStress.H:628

Member Function Documentation

◆ iterate_flux()

AMREX_GPU_DEVICE AMREX_FORCE_INLINE void surface_flux::iterate_flux ( const int &  i,
const int &  j,
const int &  k,
const int &  max_iters,
const amrex::Array4< const amrex::Real > &  zref_arr,
const amrex::Array4< const amrex::Real > &  z0_arr,
const amrex::Array4< const amrex::Real > &  umm_arr,
const amrex::Array4< const amrex::Real > &  tm_arr,
const amrex::Array4< const amrex::Real > &  tvm_arr,
const amrex::Array4< const amrex::Real > &  qvm_arr,
const amrex::Array4< amrex::Real > &  u_star_arr,
const amrex::Array4< amrex::Real > &  w_star_arr,
const amrex::Array4< amrex::Real > &  t_star_arr,
const amrex::Array4< amrex::Real > &  q_star_arr,
const amrex::Array4< amrex::Real > &  t_surf_arr,
const amrex::Array4< amrex::Real > &  q_surf_arr,
const amrex::Array4< amrex::Real > &  olen_arr,
const amrex::Array4< amrex::Real > &  pblh_arr,
const amrex::Array4< amrex::Real > &  ,
const amrex::Array4< amrex::Real > &  ,
const amrex::Array4< amrex::Real > &   
) const
inline

Iterate MOST state for one surface point.

Calling sequence
i, j, k, max_iters, zref_arr, z0_arr, umm_arr, tm_arr, tvm_arr, qvm_arr, u_star_arr, w_star_arr, t_star_arr, q_star_arr, t_surf_arr, q_surf_arr, olen_arr, pblh_arr, Hwave_arr, Lwave_arr, eta_arr.
544  {
545  int iter = 0;
546  amrex::Real ustar = zero;
547  amrex::Real wstar = zero;
548  amrex::Real tflux = zero;
549  amrex::Real qflux = zero;
550  amrex::Real zeta = zero;
551  amrex::Real psi_m = zero;
552  amrex::Real psi_h = zero;
554  amrex::Real zref = zref_arr(i,j,k);
555  amrex::Real umm = std::max(umm_arr(i,j,k), WSMIN);
556  if (u_star_arr(i,j,k) == bogus_large_value) {
557  u_star_arr(i,j,k) = mdata.kappa * umm / std::log(zref / z0_arr(i,j,k));
558  } else {
559  Olen = olen_arr(i,j,k);
560  zeta = zref / Olen;
561  psi_m = sfuns.calc_psi_m(zeta);
562  psi_h = sfuns.calc_psi_h(zeta);
563  }
564  do {
565  ustar = u_star_arr(i,j,k);
566  qflux = (spec_qflux) ? mdata.surf_moist_flux :
567  -(qvm_arr(i,j,k) - q_surf_arr(i,j,k)) * ustar * mdata.kappa /
568  (std::log(zref / z0_arr(i,j,k)) - psi_h); // <w'Qv'>
569  tflux = mdata.surf_temp_flux*(one + epsv*qvm_arr(i,j,k)) + qflux*epsv*tm_arr(i,j,k);
570  if (w_star_arr) {
571  // update w* and Umagmean
572  w_star_arr(i,j,k) = calc_wstar(tflux, pblh_arr(i,j,k), tvm_arr(i,j,k));
573  wstar = mdata.Bjr_beta * w_star_arr(i,j,k);
574  //umm = std::sqrt(umm_arr(i,j,k)*umm_arr(i,j,k) + wstar*wstar);
575  amrex::Real umm_new = std::sqrt(umm_arr(i,j,k)*umm_arr(i,j,k) + wstar*wstar);
576  umm = (one - alpha) * umm + alpha * umm_new;
577  umm = std::max(umm, WSMIN);
578  }
579  //Olen = -ustar * ustar * ustar * tvm_arr(i,j,k) / (mdata.kappa * mdata.gravity * tflux);
580  //zeta = zref / Olen;
581  amrex::Real ustar_floor = amrex::max(ustar, USTARMIN);
582  Olen = -ustar_floor * ustar_floor * ustar_floor * tvm_arr(i,j,k) /
583  (mdata.kappa * mdata.gravity * tflux);
584  zeta = zref / Olen;
585  zeta = amrex::max(amrex::min(zeta, amrex::Real(100.0)), -amrex::Real(100.0));
586  psi_m = sfuns.calc_psi_m(zeta);
587  psi_h = sfuns.calc_psi_h(zeta);
588  //u_star_arr(i,j,k) = mdata.kappa * umm / (std::log(zref / z0_arr(i,j,k)) - psi_m);
589  {
590  amrex::Real ustar_new = mdata.kappa * umm / (std::log(zref / z0_arr(i,j,k)) - psi_m);
591  u_star_arr(i,j,k) = (one - alpha) * ustar + alpha * ustar_new;
592  }
593  ++iter;
594  } while ((std::abs(u_star_arr(i,j,k) - ustar) > tol) && iter <= max_iters);
595  AMREX_ALWAYS_ASSERT_WITH_MESSAGE(iter < max_iters,
596  "Maximum number of MOST iterations reached.");
597 
598  // Populate the stored MOST arrays
599  olen_arr(i,j,k) = Olen;
600  /*t_surf_arr(i,j,k) = mdata.surf_temp_flux * (std::log(zref / z0_arr(i,j,k)) - psi_h) /
601  (u_star_arr(i,j,k) * mdata.kappa) + tm_arr(i,j,k);
602  t_star_arr(i,j,k) = -mdata.surf_temp_flux / u_star_arr(i,j,k);
603  if (spec_qflux) {
604  q_surf_arr(i,j,k) = mdata.surf_moist_flux * (std::log(zref / z0_arr(i,j,k)) - psi_h) /
605  (u_star_arr(i,j,k) * mdata.kappa) + qvm_arr(i,j,k);
606  q_star_arr(i,j,k) = -mdata.surf_moist_flux / u_star_arr(i,j,k);
607  } else {
608  q_star_arr(i,j,k) = mdata.kappa * (qvm_arr(i,j,k) - q_surf_arr(i,j,k)) /
609  (std::log(zref / z0_arr(i,j,k)) - psi_h);
610  }*/
611  amrex::Real ustar_final = amrex::max(u_star_arr(i,j,k), USTARMIN);
612  t_surf_arr(i,j,k) = mdata.surf_temp_flux * (std::log(zref / z0_arr(i,j,k)) - psi_h) /
613  (ustar_final * mdata.kappa) + tm_arr(i,j,k);
614  t_star_arr(i,j,k) = -mdata.surf_temp_flux / ustar_final;
615  if (spec_qflux) {
616  q_surf_arr(i,j,k) = mdata.surf_moist_flux * (std::log(zref / z0_arr(i,j,k)) - psi_h) /
617  (ustar_final * mdata.kappa) + qvm_arr(i,j,k);
618  q_star_arr(i,j,k) = -mdata.surf_moist_flux / ustar_final;
619  } else {
620  q_star_arr(i,j,k) = mdata.kappa * (qvm_arr(i,j,k) - q_surf_arr(i,j,k)) /
621  (std::log(zref / z0_arr(i,j,k)) - psi_h);
622  }
623 
624  }
constexpr amrex::Real epsv
Definition: ERF_Constants.H:40
constexpr amrex::Real bogus_large_value
Definition: ERF_Constants.H:17
AMREX_ALWAYS_ASSERT_WITH_MESSAGE(m_cloud_chamber_config.active, "Cloud Chamber: initializer reached without a parsed configuration")
constexpr amrex::Real one
Definition: ERF_NumericalConstants.H:30
constexpr amrex::Real zero
Definition: ERF_NumericalConstants.H:29
amrex::Real Real
Definition: ERF_ShocInterface.H:19
AMREX_GPU_DEVICE AMREX_FORCE_INLINE amrex::Real calc_wstar(const amrex::Real &ust, const amrex::Real &tst, const amrex::Real &qst, const amrex::Real &pblh, const amrex::Real &th, const amrex::Real &thv, const amrex::Real &qv=amrex::Real(0))
Definition: ERF_Wstar.H:13
amrex::Real kappa
von Karman constant
Definition: ERF_MOSTUtils.H:13
amrex::Real gravity
Acceleration due to gravity (m/s^2)
Definition: ERF_MOSTUtils.H:14
const amrex::Real Bjr_beta
Definition: ERF_MOSTUtils.H:29
AMREX_GPU_HOST_DEVICE AMREX_FORCE_INLINE amrex::Real calc_psi_m(amrex::Real zeta) const
Definition: ERF_MOSTUtils.H:102
AMREX_GPU_HOST_DEVICE AMREX_FORCE_INLINE amrex::Real calc_psi_h(amrex::Real zeta) const
Definition: ERF_MOSTUtils.H:121
similarity_funs sfuns
Definition: ERF_MOSTStress.H:629
const amrex::Real USTARMIN
Definition: ERF_MOSTStress.H:632
const amrex::Real WSMIN
Definition: ERF_MOSTStress.H:631
const amrex::Real tol
Definition: ERF_MOSTStress.H:630
const amrex::Real alpha
Definition: ERF_MOSTStress.H:633
Here is the call graph for this function:

Member Data Documentation

◆ alpha

const amrex::Real surface_flux::alpha = amrex::Real(0.5)
private

Referenced by iterate_flux().

◆ mdata

most_data surface_flux::mdata
private

Referenced by iterate_flux(), and surface_flux().

◆ sfuns

similarity_funs surface_flux::sfuns
private

Referenced by iterate_flux().

◆ spec_qflux

bool surface_flux::spec_qflux
private

Referenced by iterate_flux(), and surface_flux().

◆ tol

const amrex::Real surface_flux::tol = amrex::Real(1.0e-5)
private

Referenced by iterate_flux().

◆ USTARMIN

const amrex::Real surface_flux::USTARMIN = amrex::Real(0.001)
private

Referenced by iterate_flux().

◆ WSMIN

const amrex::Real surface_flux::WSMIN = amrex::Real(0.1)
private

Referenced by iterate_flux().


The documentation for this struct was generated from the following file: