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

#include <ERF_MOSTStress.H>

Collaboration diagram for surface_temp_mod_charnock:

Public Member Functions

 surface_temp_mod_charnock (amrex::Real zref, amrex::Real Tflux, amrex::Real Qvflux, amrex::Real depth, 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< 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 = 1.0e-3
 
const amrex::Real tol_z = 1.0e-10
 
const amrex::Real alpha = 0.5
 
const amrex::Real WSMIN = 0.1
 

Detailed Description

Surface temperature with modified charnock roughness

Constructor & Destructor Documentation

◆ surface_temp_mod_charnock()

surface_temp_mod_charnock::surface_temp_mod_charnock ( amrex::Real  zref,
amrex::Real  Tflux,
amrex::Real  Qvflux,
amrex::Real  depth,
bool  cons_qflux 
)
inline
1373  {
1374  mdata.zref = zref;
1375  mdata.surf_temp_flux = Tflux;
1376  mdata.surf_moist_flux = Qvflux;
1377  mdata.Cnk_d = depth;
1378  mdata.Cnk_b = mdata.Cnk_b1 * std::log(mdata.Cnk_b2 / mdata.Cnk_d);
1379  spec_qflux = cons_qflux;
1380  }
amrex::Real surf_moist_flux
Moisture flux.
Definition: ERF_MOSTStress.H:20
amrex::Real zref
Reference height (m)
Definition: ERF_MOSTStress.H:15
amrex::Real Cnk_b2
Modified Charnock Eq (4) https://doi.org/10.1175/JAMC-D-17-0137.1.
Definition: ERF_MOSTStress.H:24
amrex::Real Cnk_b
Definition: ERF_MOSTStress.H:26
amrex::Real Cnk_d
Modified Charnock Eq (4) https://doi.org/10.1175/JAMC-D-17-0137.1.
Definition: ERF_MOSTStress.H:25
amrex::Real Cnk_b1
Modified Charnock Eq (4) https://doi.org/10.1175/JAMC-D-17-0137.1.
Definition: ERF_MOSTStress.H:23
amrex::Real surf_temp_flux
Heat flux TODO: decide whether this is <θ'w'> or <θv'w'> under moist conditions.
Definition: ERF_MOSTStress.H:19
most_data mdata
Definition: ERF_MOSTStress.H:1511
bool spec_qflux
Definition: ERF_MOSTStress.H:1512

Member Function Documentation

◆ iterate_flux()

AMREX_GPU_DEVICE AMREX_FORCE_INLINE void surface_temp_mod_charnock::iterate_flux ( const int &  i,
const int &  j,
const int &  k,
const int &  max_iters,
const amrex::Array4< 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
1405  {
1406  amrex::Real Rib = 0.0;
1407  amrex::Real zeta = 0.0;
1408  amrex::Real zeta_old = 0.0;
1409  amrex::Real psi_m = 0.0;
1410  amrex::Real psi_h = 0.0;
1411  amrex::Real num = 0.0;
1412  amrex::Real den = 0.0;
1413  amrex::Real z0 = z0_arr(i,j,k);
1414  amrex::Real z0_old = z0;
1415  amrex::Real ustar = 0.0;
1416  amrex::Real umm = std::max(umm_arr(i,j,k), WSMIN);
1417  amrex::Real C = std::log(mdata.zref / z0);
1418 
1419  // First iteration we assume neutral (L -> inf)
1420  if (u_star_arr(i,j,k) == 1.E34) { olen_arr(i,j,k) = 1.0e3; }
1421  zeta = mdata.zref / olen_arr(i,j,k);
1422 
1423  // Water vapor in atmos and surface
1424  amrex::Real qv_s, qv_a;
1425  if (q_surf_arr(i,j,k) > 0.) {
1426  qv_s = q_surf_arr(i,j,k);
1427  } else {
1428  // First iteration and no qv_surf was specified
1429  // Use mean since there will be no flux
1430  qv_s = qvm_arr(i,j,k);
1431  }
1432  qv_a = qvm_arr(i,j,k);
1433 
1434  // update w* and Umagmean from Beljaars (1995)
1435  if (w_star_arr) {
1436  // NOTE: Thv flux is lagged, similar to WRF
1437  psi_m = sfuns.calc_psi_m2(zeta);
1438  psi_h = sfuns.calc_psi_h2(zeta);
1439  ustar = mdata.kappa * umm / (C - psi_m);
1440  amrex::Real tstar = mdata.kappa * (tm_arr(i,j,k) - t_surf_arr(i,j,k)) / (C - psi_h);
1442  -ustar * mdata.kappa * (qv_a - qv_s) / (C - psi_h);
1443  amrex::Real tflux = -ustar*tstar*(1 + 0.61*qvm_arr(i,j,k)) + 0.61*tm_arr(i,j,k)*qflux;
1444  w_star_arr(i,j,k) = calc_wstar(tflux, pblh_arr(i,j,k), tvm_arr(i,j,k));
1445  amrex::Real wstar = mdata.Bjr_beta * w_star_arr(i,j,k);
1446  umm = std::sqrt(umm_arr(i,j,k)*umm_arr(i,j,k) + wstar*wstar);
1447  umm = std::max(umm, WSMIN);
1448  }
1449 
1450  // Bulk Richardson number w/ moisture
1451  amrex::Real thv_s = t_surf_arr(i,j,k) * (1.0 + 0.61*qv_s);
1452  amrex::Real thv_a = tm_arr(i,j,k) * (1.0 + 0.61*qv_a);
1453  Rib = ( (mdata.gravity * mdata.zref) / tm_arr(i,j,k) ) *
1454  ( (thv_a - thv_s) / (umm * umm) );
1455  Rib = std::min(std::max(Rib,-4.0),4.0);
1456 
1457  // Fixed point iteration on zeta
1458  int iter = 0;
1459  do {
1460  // Transfer curr to old
1461  zeta_old = zeta;
1462 
1463  // Stability functions
1464  psi_m = sfuns.calc_psi_m2(zeta_old);
1465  psi_h = sfuns.calc_psi_h2(zeta_old);
1466 
1467  // Fixed point iteration on roughness
1468  int iter_z = 0;
1469  do {
1470  // Transfer curr to old
1471  z0_old = z0;
1472 
1473  // Update
1474  C = std::log(mdata.zref / z0_old);
1475  ustar = mdata.kappa * umm / (C - psi_m);
1476  z0 = std::exp( (2.7*ustar - 1.8/mdata.Cnk_b) / (ustar + 0.17/mdata.Cnk_b) );
1477 
1478  ++iter_z;
1479  } while ( (std::abs(z0 - z0_old) > tol_z) && (iter_z <= max_iters) );
1480  AMREX_ALWAYS_ASSERT_WITH_MESSAGE(iter_z < max_iters,
1481  "Maximum number of MOST roughness iterations reached.");
1482  C = std::log(mdata.zref / z0);
1483 
1484  // Limiting
1485  num = std::max(C - psi_m, 1.0);
1486  den = std::max(C - psi_h, 1.0);
1487 
1488  // Update with under relaxation
1489  zeta = (1.0 - alpha) * zeta_old + alpha * Rib * num * num / den;
1490 
1491  ++iter;
1492  } while ( (std::abs(zeta - zeta_old) > tol) && (iter <= max_iters) );
1493  AMREX_ALWAYS_ASSERT_WITH_MESSAGE(iter < max_iters,
1494  "Maximum number of MOST iterations reached.");
1495 
1496  // Populate the stored MOST arrays
1497  z0_arr(i,j,k) = z0;
1498  olen_arr(i,j,k) = mdata.zref / zeta;
1499  u_star_arr(i,j,k) = mdata.kappa * umm / (C - psi_m);
1500  t_star_arr(i,j,k) = mdata.kappa * (tm_arr(i,j,k) - t_surf_arr(i,j,k)) / (C - psi_h);
1501  if (spec_qflux) {
1502  q_surf_arr(i,j,k) = mdata.surf_moist_flux * (C - psi_h) /
1503  (u_star_arr(i,j,k) * mdata.kappa) + qvm_arr(i,j,k);
1504  q_star_arr(i,j,k) = -mdata.surf_moist_flux / u_star_arr(i,j,k);
1505  } else {
1506  q_star_arr(i,j,k) = mdata.kappa * (qvm_arr(i,j,k) - q_surf_arr(i,j,k)) / (C - psi_h);
1507  }
1508  }
@ num
Definition: ERF_DataStruct.H:22
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=0.0)
Definition: ERF_Wstar.H:13
amrex::Real kappa
von Karman constant
Definition: ERF_MOSTStress.H:17
amrex::Real gravity
Acceleration due to gravity (m/s^2)
Definition: ERF_MOSTStress.H:18
const amrex::Real Bjr_beta
Definition: ERF_MOSTStress.H:33
AMREX_GPU_HOST_DEVICE AMREX_FORCE_INLINE amrex::Real calc_psi_h2(amrex::Real zeta) const
Definition: ERF_MOSTStress.H:68
AMREX_GPU_HOST_DEVICE AMREX_FORCE_INLINE amrex::Real calc_psi_m2(amrex::Real zeta) const
Definition: ERF_MOSTStress.H:48
similarity_funs sfuns
Definition: ERF_MOSTStress.H:1513
const amrex::Real tol
Definition: ERF_MOSTStress.H:1514
const amrex::Real tol_z
Definition: ERF_MOSTStress.H:1515
const amrex::Real WSMIN
Definition: ERF_MOSTStress.H:1517
const amrex::Real alpha
Definition: ERF_MOSTStress.H:1516
Here is the call graph for this function:

Member Data Documentation

◆ alpha

const amrex::Real surface_temp_mod_charnock::alpha = 0.5
private

Referenced by iterate_flux().

◆ mdata

most_data surface_temp_mod_charnock::mdata
private

◆ sfuns

similarity_funs surface_temp_mod_charnock::sfuns
private

Referenced by iterate_flux().

◆ spec_qflux

bool surface_temp_mod_charnock::spec_qflux
private

◆ tol

const amrex::Real surface_temp_mod_charnock::tol = 1.0e-3
private

Referenced by iterate_flux().

◆ tol_z

const amrex::Real surface_temp_mod_charnock::tol_z = 1.0e-10
private

Referenced by iterate_flux().

◆ WSMIN

const amrex::Real surface_temp_mod_charnock::WSMIN = 0.1
private

Referenced by iterate_flux().


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