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

#include <ERF_EBMOSTStress.H>

Collaboration diagram for surface_temp_eb:

Public Member Functions

 surface_temp_eb (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-3)
 
const amrex::Real alpha = myhalf
 
const amrex::Real WSMIN = amrex::Real(0.1)
 

Detailed Description

Surface temperature with constant roughness

Constructor & Destructor Documentation

◆ surface_temp_eb()

surface_temp_eb::surface_temp_eb ( amrex::Real  Tflux,
amrex::Real  Qvflux,
bool  cons_qflux 
)
inline
65  {
66  mdata.surf_temp_flux = Tflux;
67  mdata.surf_moist_flux = Qvflux;
68  spec_qflux = cons_qflux;
69  }
amrex::Real surf_moist_flux
Moisture flux.
Definition: ERF_MOSTStress.H:19
amrex::Real surf_temp_flux
Heat flux TODO: decide whether this is <θ'w'> or <θv'w'> under moist conditions.
Definition: ERF_MOSTStress.H:18
bool spec_qflux
Definition: ERF_EBMOSTStress.H:185
most_data mdata
Definition: ERF_EBMOSTStress.H:184

Member Function Documentation

◆ iterate_flux()

AMREX_GPU_DEVICE AMREX_FORCE_INLINE void surface_temp_eb::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
95  {
96  amrex::Real Rib = zero;
97  amrex::Real zeta = zero;
98  amrex::Real zeta_old = zero;
99  amrex::Real psi_m = zero;
100  amrex::Real psi_h = zero;
101  amrex::Real num = zero;
102  amrex::Real den = zero;
103  amrex::Real zref = zref_arr(i,j,0);
104  amrex::Real z0 = z0_arr(i,j,k);
105  amrex::Real umm = std::max(umm_arr(i,j,0), WSMIN);
106  amrex::Real C = std::log(zref / z0);
107 
108  // First iteration we assume neutral (L -> inf)
109  if (u_star_arr(i,j,k) == bogus_large_value) {
110  olen_arr(i,j,k) = amrex::Real(1000);
111  }
112  zeta = zref / olen_arr(i,j,k);
113 
114  // Water vapor in atmos and surface
115  amrex::Real qv_s, qv_a;
116  if (q_surf_arr(i,j,k) > zero) {
117  qv_s = q_surf_arr(i,j,k);
118  } else {
119  // First iteration and no qv_surf was specified
120  // Use mean since there will be no flux
121  qv_s = qvm_arr(i,j,0);
122  }
123  qv_a = qvm_arr(i,j,0);
124 
125  // update w* and Umagmean from Beljaars (1995)
126  if (w_star_arr) {
127  // NOTE: Thv flux is lagged, similar to WRF
128  psi_m = sfuns.calc_psi_m2(zeta);
129  psi_h = sfuns.calc_psi_h2(zeta);
130  amrex::Real ustar = mdata.kappa * umm / (C - psi_m);
131  amrex::Real tstar = mdata.kappa * (tm_arr(i,j,0) - t_surf_arr(i,j,k)) / (C - psi_h);
133  -ustar * mdata.kappa * (qv_a - qv_s) / (C - psi_h);
134  amrex::Real tflux = -ustar*tstar*(1 + amrex::Real(0.61)*qvm_arr(i,j,0)) + amrex::Real(0.61)*tm_arr(i,j,0)*qflux;
135  w_star_arr(i,j,k) = calc_wstar(tflux, pblh_arr(i,j,k), tvm_arr(i,j,0));
136  amrex::Real wstar = mdata.Bjr_beta * w_star_arr(i,j,k);
137  umm = std::sqrt(umm_arr(i,j,0)*umm_arr(i,j,0) + wstar*wstar);
138  umm = std::max(umm, WSMIN);
139  }
140 
141  // Bulk Richardson number w/ moisture
142  amrex::Real thv_s = t_surf_arr(i,j,k) * (one + amrex::Real(0.61)*qv_s);
143  amrex::Real thv_a = tm_arr(i,j,0) * (one + amrex::Real(0.61)*qv_a);
144  Rib = ( (mdata.gravity * zref) / tm_arr(i,j,0) ) *
145  ( (thv_a - thv_s) / (umm * umm) );
146  Rib = std::min(std::max(Rib,-amrex::Real(4.0)),amrex::Real(4.0));
147 
148  // Fixed point iteration on zeta
149  int iter = 0;
150  do {
151  // Transfer curr to old
152  zeta_old = zeta;
153 
154  // Stability functions
155  psi_m = sfuns.calc_psi_m2(zeta_old);
156  psi_h = sfuns.calc_psi_h2(zeta_old);
157 
158  // Limiting
159  num = std::max(C - psi_m, amrex::Real(1.0));
160  den = std::max(C - psi_h, amrex::Real(1.0));
161 
162  // Update with under relaxation
163  zeta = (one - alpha) * zeta_old + alpha * Rib * num * num / den;
164 
165  ++iter;
166  } while ( (std::abs(zeta - zeta_old) > tol) && (iter <= max_iters) );
167  AMREX_ALWAYS_ASSERT_WITH_MESSAGE(iter < max_iters,
168  "Maximum number of MOST iterations reached.");
169 
170  // Populate the stored MOST arrays
171  olen_arr(i,j,k) = zref / zeta;
172  u_star_arr(i,j,k) = mdata.kappa * umm / (C - psi_m);
173  t_star_arr(i,j,k) = mdata.kappa * (tm_arr(i,j,0) - t_surf_arr(i,j,k)) / (C - psi_h);
174  if (spec_qflux) {
175  q_surf_arr(i,j,k) = mdata.surf_moist_flux * (C - psi_h) /
176  (u_star_arr(i,j,k) * mdata.kappa) + qvm_arr(i,j,0);
177  q_star_arr(i,j,k) = -mdata.surf_moist_flux / u_star_arr(i,j,k);
178  } else {
179  q_star_arr(i,j,k) = mdata.kappa * (qvm_arr(i,j,0) - q_surf_arr(i,j,k)) / (C - psi_h);
180  }
181  }
constexpr amrex::Real bogus_large_value
Definition: ERF_Constants.H:26
constexpr amrex::Real one
Definition: ERF_Constants.H:9
constexpr amrex::Real zero
Definition: ERF_Constants.H:8
@ num
Definition: ERF_DataStruct.H:24
Real z0
Definition: ERF_InitCustomPertVels_ScalarAdvDiff.H:8
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
@ den
Definition: ERF_AdvanceWSM6.cpp:109
amrex::Real kappa
von Karman constant
Definition: ERF_MOSTStress.H:16
amrex::Real gravity
Acceleration due to gravity (m/s^2)
Definition: ERF_MOSTStress.H:17
const amrex::Real Bjr_beta
Definition: ERF_MOSTStress.H:32
AMREX_GPU_HOST_DEVICE AMREX_FORCE_INLINE amrex::Real calc_psi_h2(amrex::Real zeta) const
Definition: ERF_MOSTStress.H:67
AMREX_GPU_HOST_DEVICE AMREX_FORCE_INLINE amrex::Real calc_psi_m2(amrex::Real zeta) const
Definition: ERF_MOSTStress.H:47
const amrex::Real tol
Definition: ERF_EBMOSTStress.H:187
const amrex::Real alpha
Definition: ERF_EBMOSTStress.H:188
const amrex::Real WSMIN
Definition: ERF_EBMOSTStress.H:189
similarity_funs sfuns
Definition: ERF_EBMOSTStress.H:186
Here is the call graph for this function:

Member Data Documentation

◆ alpha

const amrex::Real surface_temp_eb::alpha = myhalf
private

Referenced by iterate_flux().

◆ mdata

most_data surface_temp_eb::mdata
private

Referenced by iterate_flux(), and surface_temp_eb().

◆ sfuns

similarity_funs surface_temp_eb::sfuns
private

Referenced by iterate_flux().

◆ spec_qflux

bool surface_temp_eb::spec_qflux
private

Referenced by iterate_flux(), and surface_temp_eb().

◆ tol

const amrex::Real surface_temp_eb::tol = amrex::Real(1.0e-3)
private

Referenced by iterate_flux().

◆ WSMIN

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

Referenced by iterate_flux().


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