ERF
Energy Research and Forecasting: An Atmospheric Modeling Code
ERF_ShocTypes.H File Reference
#include "ERF_DataStruct.H"
#include <AMReX_FArrayBox.H>
#include <AMReX_Geometry.H>
#include <AMReX_GpuQualifiers.H>
#include <AMReX_ParmParse.H>
#include <AMReX_Vector.H>
#include <algorithm>
#include <cctype>
#include <string>
Include dependency graph for ERF_ShocTypes.H:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes

struct  ShocRuntimeOptions
 
struct  ShocColumnLayout
 
struct  ShocColumnData
 

Functions

bool validate_shoc_runtime_options_message (const ShocRuntimeOptions &opts, std::string &error_message)
 
void read_shoc_runtime_options (ShocRuntimeOptions &opts)
 
void validate_shoc_runtime_options (const ShocRuntimeOptions &opts)
 
AMREX_GPU_HOST_DEVICE AMREX_FORCE_INLINE bool shoc_valid_comp (int comp, int ncomp)
 
template<typename T >
AMREX_GPU_HOST_DEVICE AMREX_FORCE_INLINE T shoc_clamp (T value, T lo, T hi)
 

Function Documentation

◆ read_shoc_runtime_options()

void read_shoc_runtime_options ( ShocRuntimeOptions opts)
inline
165 {
166  amrex::ParmParse pp("erf.shoc");
167 
168  pp.query("lambda_low", opts.lambda_low);
169  pp.query("lambda_high", opts.lambda_high);
170  pp.query("lambda_slope", opts.lambda_slope);
171  pp.query("lambda_thresh", opts.lambda_thresh);
172  pp.query("thl2tune", opts.thl2tune);
173  pp.query("qw2tune", opts.qw2tune);
174  pp.query("qwthl2tune", opts.qwthl2tune);
175  pp.query("w2tune", opts.w2tune);
176  pp.query("length_fac", opts.length_fac);
177  pp.query("c_diag_3rd_mom", opts.c_diag_3rd_mom);
178  pp.query("coeff_kh", opts.coeff_kh);
179  pp.query("coeff_km", opts.coeff_km);
180  pp.query("top_taper_depth", opts.top_taper_depth);
181  pp.query("top_taper_min_factor", opts.top_taper_min_factor);
182  pp.query("shoc_1p5tke", opts.shoc_1p5tke);
183  pp.query("extra_shoc_diags", opts.extra_shoc_diags);
184  pp.query("apply_tms", opts.apply_tms);
185  pp.query("check_flux_state", opts.check_flux_state);
186  pp.query("column_conservation_check", opts.column_conservation_check);
187  pp.query("debug_summary", opts.debug_summary);
188  pp.query("allow_tendency_microphysics_overlap", opts.allow_tendency_microphysics_overlap);
189  pp.query("signed_tke_production", opts.signed_tke_production);
190  pp.query("debug_bad_column", opts.debug_bad_column);
191  pp.query("debug_bad_column_abort", opts.debug_bad_column_abort);
192  pp.query("debug_bad_column_max_reports", opts.debug_bad_column_max_reports);
193  pp.query("debug_bad_column_theta_tend_threshold", opts.debug_bad_column_theta_tend_threshold);
194  pp.query("debug_bad_column_q_tend_threshold", opts.debug_bad_column_q_tend_threshold);
195  pp.query("debug_bad_column_brunt_threshold", opts.debug_bad_column_brunt_threshold);
196  pp.query("debug_bad_column_min_dz", opts.debug_bad_column_min_dz);
197  pp.query("debug_bad_column_scalar_moment_threshold", opts.debug_bad_column_scalar_moment_threshold);
198  pp.query("debug_disable_pdf_cloud_increment", opts.debug_disable_pdf_cloud_increment);
199  pp.query("debug_disable_theta_state_update", opts.debug_disable_theta_state_update);
200  pp.query("debug_disable_moisture_state_update", opts.debug_disable_moisture_state_update);
201  pp.query("debug_disable_tke_state_update", opts.debug_disable_tke_state_update);
202 
203  // SolverChoice parses these too, since the dycore must know which component
204  // owns vertical diffusion before any SHOC driver exists. Both go through the
205  // same reader so the two views of the inputs cannot diverge.
207 }
ParmParse pp("prob")
void read_shoc_transport_modes(ShocTransportMode &transport_mode, ShocMomentumTransport &momentum_transport)
Read the native SHOC transport modes from the erf.shoc input namespace.
Definition: ERF_ShocTransportStruct.H:138
int debug_bad_column_max_reports
Definition: ERF_ShocTypes.H:47
ShocTransportMode transport_mode
Definition: ERF_ShocTypes.H:43
bool debug_disable_moisture_state_update
Definition: ERF_ShocTypes.H:55
bool shoc_1p5tke
Definition: ERF_ShocTypes.H:35
amrex::Real debug_bad_column_q_tend_threshold
Definition: ERF_ShocTypes.H:49
amrex::Real coeff_kh
Definition: ERF_ShocTypes.H:30
amrex::Real top_taper_depth
Definition: ERF_ShocTypes.H:32
amrex::Real debug_bad_column_scalar_moment_threshold
Definition: ERF_ShocTypes.H:52
amrex::Real lambda_high
Definition: ERF_ShocTypes.H:19
amrex::Real w2tune
Definition: ERF_ShocTypes.H:26
amrex::Real debug_bad_column_min_dz
Definition: ERF_ShocTypes.H:51
amrex::Real qwthl2tune
Definition: ERF_ShocTypes.H:25
bool debug_disable_pdf_cloud_increment
Definition: ERF_ShocTypes.H:53
amrex::Real c_diag_3rd_mom
Definition: ERF_ShocTypes.H:29
ShocMomentumTransport momentum_transport
Definition: ERF_ShocTypes.H:44
bool column_conservation_check
Definition: ERF_ShocTypes.H:39
amrex::Real lambda_thresh
Definition: ERF_ShocTypes.H:21
bool extra_shoc_diags
Definition: ERF_ShocTypes.H:36
amrex::Real coeff_km
Definition: ERF_ShocTypes.H:31
bool debug_disable_theta_state_update
Definition: ERF_ShocTypes.H:54
amrex::Real debug_bad_column_theta_tend_threshold
Definition: ERF_ShocTypes.H:48
amrex::Real lambda_slope
Definition: ERF_ShocTypes.H:20
amrex::Real lambda_low
Definition: ERF_ShocTypes.H:18
bool debug_bad_column
Definition: ERF_ShocTypes.H:45
bool signed_tke_production
Definition: ERF_ShocTypes.H:42
amrex::Real debug_bad_column_brunt_threshold
Definition: ERF_ShocTypes.H:50
bool debug_disable_tke_state_update
Definition: ERF_ShocTypes.H:56
bool apply_tms
Definition: ERF_ShocTypes.H:37
bool debug_bad_column_abort
Definition: ERF_ShocTypes.H:46
bool allow_tendency_microphysics_overlap
Definition: ERF_ShocTypes.H:41
bool check_flux_state
Definition: ERF_ShocTypes.H:38
amrex::Real length_fac
Definition: ERF_ShocTypes.H:28
amrex::Real top_taper_min_factor
Definition: ERF_ShocTypes.H:33
amrex::Real thl2tune
Definition: ERF_ShocTypes.H:23
amrex::Real qw2tune
Definition: ERF_ShocTypes.H:24
bool debug_summary
Definition: ERF_ShocTypes.H:40

Referenced by ShocDriver::ShocDriver().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ shoc_clamp()

template<typename T >
AMREX_GPU_HOST_DEVICE AMREX_FORCE_INLINE T shoc_clamp ( value,
lo,
hi 
)
251 {
252  return amrex::max(lo, amrex::min(value, hi));
253 }

Referenced by ShocImplicit::advance_implicit_state(), ShocTKE::diagnose_tke_and_diffusivities(), ShocImplicit::finalize_from_pdf(), and shoc::reconstruct_pdf_state().

Here is the caller graph for this function:

◆ shoc_valid_comp()

AMREX_GPU_HOST_DEVICE AMREX_FORCE_INLINE bool shoc_valid_comp ( int  comp,
int  ncomp 
)
243 {
244  return comp >= 0 && comp < ncomp;
245 }

Referenced by shoc_layout_requires_number_closure().

Here is the caller graph for this function:

◆ validate_shoc_runtime_options()

void validate_shoc_runtime_options ( const ShocRuntimeOptions opts)
inline
211 {
212  AMREX_ALWAYS_ASSERT_WITH_MESSAGE(opts.lambda_low > 0.0, "erf.shoc.lambda_low must be positive");
214  "erf.shoc.lambda_high must be >= lambda_low");
215  AMREX_ALWAYS_ASSERT_WITH_MESSAGE(opts.length_fac > 0.0, "erf.shoc.length_fac must be positive");
216  AMREX_ALWAYS_ASSERT_WITH_MESSAGE(opts.coeff_kh >= 0.0, "erf.shoc.coeff_kh must be non-negative");
217  AMREX_ALWAYS_ASSERT_WITH_MESSAGE(opts.coeff_km >= 0.0, "erf.shoc.coeff_km must be non-negative");
219  "erf.shoc.top_taper_depth must be non-negative");
221  opts.top_taper_min_factor <= 1.0,
222  "erf.shoc.top_taper_min_factor must be in [0, 1]");
224  "erf.shoc.debug_bad_column_max_reports must be positive");
226  "erf.shoc.debug_bad_column_theta_tend_threshold must be positive");
228  "erf.shoc.debug_bad_column_q_tend_threshold must be positive");
230  "erf.shoc.debug_bad_column_brunt_threshold must be positive");
232  "erf.shoc.debug_bad_column_min_dz must be positive");
234  "erf.shoc.debug_bad_column_scalar_moment_threshold must be positive");
235  std::string error_message;
237  error_message.c_str());
238 }
AMREX_ALWAYS_ASSERT_WITH_MESSAGE(m_cloud_chamber_config.active, "Cloud Chamber: initializer reached without a parsed configuration")
bool validate_shoc_runtime_options_message(const ShocRuntimeOptions &opts, std::string &error_message)
Definition: ERF_ShocTypes.H:60

Referenced by ShocDriver::ShocDriver().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ validate_shoc_runtime_options_message()

bool validate_shoc_runtime_options_message ( const ShocRuntimeOptions opts,
std::string &  error_message 
)
inline
62 {
65  error_message =
66  "erf.shoc.transport_mode = host_diffusion requires erf.shoc.momentum_transport = host_diffusion";
67  return false;
68  }
69  return true;
70 }
bool shoc_uses_host_diffusion(ShocTransportMode mode)
Definition: ERF_ShocTransportStruct.H:51
bool shoc_uses_momentum_host_diffusion(ShocMomentumTransport mode)
Definition: ERF_ShocTransportStruct.H:63

Referenced by validate_shoc_runtime_options().

Here is the call graph for this function:
Here is the caller graph for this function: