ERF
Energy Research and Forecasting: An Atmospheric Modeling Code
ERF_SrcHeaders.H
Go to the documentation of this file.
1 #ifndef ERF_INTEGRATION_H_
2 #define ERF_INTEGRATION_H_
3 
4 #include <AMReX_MultiFab.H>
5 #include <AMReX_EBMultiFabUtil.H>
6 
7 #include "ERF_DataStruct.H"
9 #include "ERF_TurbPertStruct.H"
10 #include "ERF_EB.H"
11 #include "ERF_ReadBndryPlanes.H"
12 
13 /**
14  * Function for computing the buoyancy term to be used in the evolution
15  * equation for the z-component of momentum in the slow integrator. There
16  * are three options for how buoyancy is computed (two are the same in the absence of moisture).
17  */
18 void make_buoyancy (int level,
19  const amrex::Vector<amrex::MultiFab>& S_data,
20  const amrex::MultiFab & S_prim,
21  const amrex::MultiFab & qt,
22  amrex::MultiFab& buoyancy,
23  const amrex::Geometry geom,
24  const SolverChoice& solverChoice,
25  const amrex::MultiFab& base_state,
26  const int n_qstate,
27  const eb_& ebfact,
28  const int anelastic);
29 
30 void make_gradp_pert (int level,
31  const SolverChoice& solverChoice,
32  const amrex::Geometry& geom,
33  amrex::Vector<amrex::MultiFab>& S_data,
34  const amrex::MultiFab& p0,
35  const amrex::MultiFab& z_phys_nd,
36  const amrex::MultiFab& z_phys_cc,
37  amrex::Vector<std::unique_ptr<amrex::MultiFab>>& mapfac,
38  const eb_& ebfact,
39  amrex::Vector<amrex::MultiFab>& gradp);
40 
41 void compute_gradp (const amrex::MultiFab& p,
42  const amrex::Geometry& geom,
43  const amrex::MultiFab& z_phys_nd,
44  const amrex::MultiFab& z_phys_cc,
45  amrex::Vector<std::unique_ptr<amrex::MultiFab>>& mapfac,
46  const eb_& ebfact,
47  amrex::Vector<amrex::MultiFab>& gradp,
48  const SolverChoice& solverChoice);
49 
50 void compute_gradp_xy (const amrex::MultiFab& p,
51  const amrex::Geometry& geom,
52  const amrex::MultiFab& z_phys_cc,
53  amrex::Vector<std::unique_ptr<amrex::MultiFab>>& mapfac,
54  const eb_& ebfact,
55  amrex::Vector<amrex::MultiFab>& gradp,
56  const SolverChoice& solverChoice);
57 
58 void compute_gradp_z (const amrex::MultiFab& p,
59  const amrex::Geometry& geom,
60  const amrex::MultiFab& z_phys_nd,
61  const eb_& ebfact,
62  amrex::Vector<amrex::MultiFab>& gradp,
63  const SolverChoice& solverChoice);
64 
65 void compute_gradp_interpz (const amrex::MultiFab& p,
66  const amrex::Geometry& geom,
67  const amrex::MultiFab& z_phys_nd,
68  const amrex::MultiFab& z_phys_cc,
69  amrex::Vector<std::unique_ptr<amrex::MultiFab>>& mapfac,
70  amrex::Vector<amrex::MultiFab>& gradp,
71  const SolverChoice& solverChoice);
72 
73 void make_sources (int level, int nrk,
74  amrex::Real dt, amrex::Real time,
75  const amrex::Vector<amrex::MultiFab>& S_data,
76  const amrex::MultiFab& S_prim,
77  amrex::MultiFab& cc_source,
78  const amrex::MultiFab& base_state,
79  const amrex::MultiFab* z_phys_cc,
80  const amrex::MultiFab& xvel,
81  const amrex::MultiFab& yvel,
82  const amrex::MultiFab* qheating_rates,
83  amrex::MultiFab* terrain_blank,
84  const amrex::Geometry geom,
85  const SolverChoice& solverChoice,
86  amrex::Vector<std::unique_ptr<amrex::MultiFab>>& mapfac,
87  const amrex::MultiFab* rhotheta_src,
88  const amrex::MultiFab* rhoqt_src,
89  const amrex::Real* dptr_wbar_sub,
90  const amrex::Vector<amrex::Real*> d_rayleigh_ptrs_at_lev,
91  const amrex::Real* sinesq_at_lev_d,
92  const amrex::MultiFab* surface_state_at_lev,
93  InputSoundingData& input_sounding_data,
94  TurbulentPerturbation& turbPert,
95  bool is_slow_step);
96 
98  amrex::Real dt,
99  const amrex::Vector<amrex::MultiFab>& S_data,
100  const amrex::MultiFab* z_phys_nd,
101  const amrex::MultiFab* z_phys_cc,
102  amrex::Vector<amrex::Real>& stretched_dz_h,
103  const amrex::MultiFab& xvel,
104  const amrex::MultiFab& yvel,
105  const amrex::MultiFab& zvel,
106  amrex::MultiFab& xmom_source,
107  amrex::MultiFab& ymom_source,
108  amrex::MultiFab& zmom_source,
109  const amrex::MultiFab& base_state,
110  amrex::MultiFab* forest_drag,
111  amrex::MultiFab* terrain_blank,
112  amrex::MultiFab* cosPhi_mf,
113  amrex::MultiFab* sinPhi_mf,
114  const amrex::Geometry geom,
115  const SolverChoice& solverChoice,
116  amrex::Vector<std::unique_ptr<amrex::MultiFab>>& mapfac,
117  const amrex::Real* dptr_rhotheta_src,
118  const amrex::Real* dptr_rhoqt_src,
119  const amrex::Real* dptr_wbar_sub,
120  const amrex::Vector<amrex::Real*> d_rayleigh_ptrs_at_lev,
121  const amrex::Real* sinesq_at_lev_d,
122  const amrex::Real* sinesq_stag_at_lev_d,
123  const amrex::Vector<amrex::Real*> d_sponge_ptrs_at_lev,
124  const amrex::Vector<amrex::MultiFab>* forecast_state_at_lev,
125  const amrex::MultiFab* surface_state_at_lev,
126  InputSoundingData& input_sounding_data,
127  const eb_& ebfact,
128  bool is_slow_step);
129 
130 void add_thin_body_sources (amrex::MultiFab& xmom_source,
131  amrex::MultiFab& ymom_source,
132  amrex::MultiFab& zmom_source,
133  std::unique_ptr<amrex::iMultiFab>& xflux_imask_lev,
134  std::unique_ptr<amrex::iMultiFab>& yflux_imask_lev,
135  std::unique_ptr<amrex::iMultiFab>& zflux_imask_lev,
136  std::unique_ptr<amrex::MultiFab>& thin_xforce_lev,
137  std::unique_ptr<amrex::MultiFab>& thin_yforce_lev,
138  std::unique_ptr<amrex::MultiFab>& thin_zforce_lev);
139 
140 #if defined(ERF_USE_NETCDF)
141 void
142 moist_set_rhs (const amrex::Geometry& geom,
143  const amrex::Box& tbx,
144  const amrex::Array4<amrex::Real const>& new_cons,
145  const amrex::Array4<amrex::Real >& cell_rhs,
146  const amrex::Real& time,
147  const amrex::Real& dt,
148  const amrex::Real& start_bdy_time,
149  const amrex::Real& final_bdy_time,
150  const amrex::Real& bdy_time_interval,
151  const amrex::Real& nudge_factor,
152  int width,
153  const amrex::Box& domain,
154  amrex::Vector<amrex::Vector<amrex::FArrayBox>>& bdy_data_xlo,
155  amrex::Vector<amrex::Vector<amrex::FArrayBox>>& bdy_data_xhi,
156  amrex::Vector<amrex::Vector<amrex::FArrayBox>>& bdy_data_ylo,
157  amrex::Vector<amrex::Vector<amrex::FArrayBox>>& bdy_data_yhi,
158  std::unique_ptr<ReadBndryPlanes>& m_r2d);
159 #endif
160 
161 void ApplySpongeZoneBCsForCC (const SpongeChoice& spongeChoice,
162  const amrex::Geometry geom,
163  const amrex::Box& bx,
164  const amrex::Array4<amrex::Real>& cell_rhs,
165  const amrex::Array4<const amrex::Real>& cell_data,
166  const amrex::Array4<const amrex::Real>& r0,
167  const amrex::Array4<const amrex::Real>& th0,
168  const amrex::Array4<const amrex::Real>& qv0,
169  const amrex::Array4<const amrex::Real>& z_phys_cc,
170  int n_qstate);
171 
172 void ApplySpongeZoneBCsForMom (const SpongeChoice& spongeChoice,
173  const amrex::Geometry geom,
174  const amrex::Box& tbx,
175  const amrex::Box& tby,
176  const amrex::Box& tbz,
177  const amrex::Array4<amrex::Real>& rho_u_rhs,
178  const amrex::Array4<amrex::Real>& rho_v_rhs,
179  const amrex::Array4<amrex::Real>& rho_w_rhs,
180  const amrex::Array4<const amrex::Real>& rho_u,
181  const amrex::Array4<const amrex::Real>& rho_v,
182  const amrex::Array4<const amrex::Real>& rho_w,
183  const amrex::Array4<const amrex::Real>& r0,
184  const amrex::Array4<const amrex::Real>& z_phys_nd,
185  const amrex::Array4<const amrex::Real>& z_phys_cc);
186 
188  const amrex::Geometry geom,
189  const amrex::Box& tbx,
190  const amrex::Box& tby,
191  const amrex::Array4<const amrex::Real>& cell_data,
192  const amrex::Array4<const amrex::Real>& z_phys_cc,
193  const amrex::Array4<amrex::Real>& rho_u_rhs,
194  const amrex::Array4<amrex::Real>& rho_v_rhs,
195  const amrex::Array4<const amrex::Real>& rho_u,
196  const amrex::Array4<const amrex::Real>& rho_v,
197  const amrex::Vector<amrex::Real*> d_sponge_ptrs_at_lev);
198 
199 void ApplyBndryForcing_Forecast (const SolverChoice& solverChoice,
200  const amrex::Geometry geom,
201  const amrex::Box& tbx,
202  const amrex::Box& tby,
203  const amrex::Box& tbz,
204  const amrex::Array4<const amrex::Real>& z_phys_nd,
205  const amrex::Array4<amrex::Real>& rho_u_rhs,
206  const amrex::Array4<amrex::Real>& rho_v_rhs,
207  const amrex::Array4<amrex::Real>& rho_w_rhs,
208  const amrex::Array4<const amrex::Real>& rho_u,
209  const amrex::Array4<const amrex::Real>& rho_v,
210  const amrex::Array4<const amrex::Real>& rho_w,
211  const amrex::Array4<const amrex::Real>& rho_u_initial_state,
212  const amrex::Array4<const amrex::Real>& rho_v_initial_state,
213  const amrex::Array4<const amrex::Real>& rho_w_initial_state,
214  const amrex::Array4<const amrex::Real>& cons_initial_state);
215 
216 void
217 ApplySurfaceTreatment_BulkCoeff_Mom (const amrex::Box& tbx,
218  const amrex::Box& tby,
219  const amrex::Array4<amrex::Real>& rho_u_rhs,
220  const amrex::Array4<amrex::Real>& rho_v_rhs,
221  const amrex::Array4<const amrex::Real>& rho_u,
222  const amrex::Array4<const amrex::Real>& rho_v,
223  const amrex::Array4<const amrex::Real>& cons_state,
224  const amrex::Array4<const amrex::Real>& z_phys_nd,
225  const amrex::Array4<const amrex::Real>& surface_state_arr);
226 
227 void
229  const amrex::Array4<amrex::Real>& cell_rhs,
230  const amrex::Array4<const amrex::Real>& cons_state,
231  const amrex::Array4<const amrex::Real>& z_phys_cc,
232  const amrex::Array4<const amrex::Real>& surface_state_arr);
233 
234 #endif
amrex::Real Real
Definition: ERF_ShocInterface.H:19
void make_gradp_pert(int level, const SolverChoice &solverChoice, const amrex::Geometry &geom, amrex::Vector< amrex::MultiFab > &S_data, const amrex::MultiFab &p0, const amrex::MultiFab &z_phys_nd, const amrex::MultiFab &z_phys_cc, amrex::Vector< std::unique_ptr< amrex::MultiFab >> &mapfac, const eb_ &ebfact, amrex::Vector< amrex::MultiFab > &gradp)
void ApplySurfaceTreatment_BulkCoeff_Mom(const amrex::Box &tbx, const amrex::Box &tby, const amrex::Array4< amrex::Real > &rho_u_rhs, const amrex::Array4< amrex::Real > &rho_v_rhs, const amrex::Array4< const amrex::Real > &rho_u, const amrex::Array4< const amrex::Real > &rho_v, const amrex::Array4< const amrex::Real > &cons_state, const amrex::Array4< const amrex::Real > &z_phys_nd, const amrex::Array4< const amrex::Real > &surface_state_arr)
void make_sources(int level, int nrk, amrex::Real dt, amrex::Real time, const amrex::Vector< amrex::MultiFab > &S_data, const amrex::MultiFab &S_prim, amrex::MultiFab &cc_source, const amrex::MultiFab &base_state, const amrex::MultiFab *z_phys_cc, const amrex::MultiFab &xvel, const amrex::MultiFab &yvel, const amrex::MultiFab *qheating_rates, amrex::MultiFab *terrain_blank, const amrex::Geometry geom, const SolverChoice &solverChoice, amrex::Vector< std::unique_ptr< amrex::MultiFab >> &mapfac, const amrex::MultiFab *rhotheta_src, const amrex::MultiFab *rhoqt_src, const amrex::Real *dptr_wbar_sub, const amrex::Vector< amrex::Real * > d_rayleigh_ptrs_at_lev, const amrex::Real *sinesq_at_lev_d, const amrex::MultiFab *surface_state_at_lev, InputSoundingData &input_sounding_data, TurbulentPerturbation &turbPert, bool is_slow_step)
void compute_gradp(const amrex::MultiFab &p, const amrex::Geometry &geom, const amrex::MultiFab &z_phys_nd, const amrex::MultiFab &z_phys_cc, amrex::Vector< std::unique_ptr< amrex::MultiFab >> &mapfac, const eb_ &ebfact, amrex::Vector< amrex::MultiFab > &gradp, const SolverChoice &solverChoice)
void ApplyBndryForcing_Forecast(const SolverChoice &solverChoice, const amrex::Geometry geom, const amrex::Box &tbx, const amrex::Box &tby, const amrex::Box &tbz, const amrex::Array4< const amrex::Real > &z_phys_nd, const amrex::Array4< amrex::Real > &rho_u_rhs, const amrex::Array4< amrex::Real > &rho_v_rhs, const amrex::Array4< amrex::Real > &rho_w_rhs, const amrex::Array4< const amrex::Real > &rho_u, const amrex::Array4< const amrex::Real > &rho_v, const amrex::Array4< const amrex::Real > &rho_w, const amrex::Array4< const amrex::Real > &rho_u_initial_state, const amrex::Array4< const amrex::Real > &rho_v_initial_state, const amrex::Array4< const amrex::Real > &rho_w_initial_state, const amrex::Array4< const amrex::Real > &cons_initial_state)
void compute_gradp_z(const amrex::MultiFab &p, const amrex::Geometry &geom, const amrex::MultiFab &z_phys_nd, const eb_ &ebfact, amrex::Vector< amrex::MultiFab > &gradp, const SolverChoice &solverChoice)
void add_thin_body_sources(amrex::MultiFab &xmom_source, amrex::MultiFab &ymom_source, amrex::MultiFab &zmom_source, std::unique_ptr< amrex::iMultiFab > &xflux_imask_lev, std::unique_ptr< amrex::iMultiFab > &yflux_imask_lev, std::unique_ptr< amrex::iMultiFab > &zflux_imask_lev, std::unique_ptr< amrex::MultiFab > &thin_xforce_lev, std::unique_ptr< amrex::MultiFab > &thin_yforce_lev, std::unique_ptr< amrex::MultiFab > &thin_zforce_lev)
void make_buoyancy(int level, const amrex::Vector< amrex::MultiFab > &S_data, const amrex::MultiFab &S_prim, const amrex::MultiFab &qt, amrex::MultiFab &buoyancy, const amrex::Geometry geom, const SolverChoice &solverChoice, const amrex::MultiFab &base_state, const int n_qstate, const eb_ &ebfact, const int anelastic)
void make_mom_sources(amrex::Real time, amrex::Real dt, const amrex::Vector< amrex::MultiFab > &S_data, const amrex::MultiFab *z_phys_nd, const amrex::MultiFab *z_phys_cc, amrex::Vector< amrex::Real > &stretched_dz_h, const amrex::MultiFab &xvel, const amrex::MultiFab &yvel, const amrex::MultiFab &zvel, amrex::MultiFab &xmom_source, amrex::MultiFab &ymom_source, amrex::MultiFab &zmom_source, const amrex::MultiFab &base_state, amrex::MultiFab *forest_drag, amrex::MultiFab *terrain_blank, amrex::MultiFab *cosPhi_mf, amrex::MultiFab *sinPhi_mf, const amrex::Geometry geom, const SolverChoice &solverChoice, amrex::Vector< std::unique_ptr< amrex::MultiFab >> &mapfac, const amrex::Real *dptr_rhotheta_src, const amrex::Real *dptr_rhoqt_src, const amrex::Real *dptr_wbar_sub, const amrex::Vector< amrex::Real * > d_rayleigh_ptrs_at_lev, const amrex::Real *sinesq_at_lev_d, const amrex::Real *sinesq_stag_at_lev_d, const amrex::Vector< amrex::Real * > d_sponge_ptrs_at_lev, const amrex::Vector< amrex::MultiFab > *forecast_state_at_lev, const amrex::MultiFab *surface_state_at_lev, InputSoundingData &input_sounding_data, const eb_ &ebfact, bool is_slow_step)
void compute_gradp_interpz(const amrex::MultiFab &p, const amrex::Geometry &geom, const amrex::MultiFab &z_phys_nd, const amrex::MultiFab &z_phys_cc, amrex::Vector< std::unique_ptr< amrex::MultiFab >> &mapfac, amrex::Vector< amrex::MultiFab > &gradp, const SolverChoice &solverChoice)
void ApplySpongeZoneBCsForCC(const SpongeChoice &spongeChoice, const amrex::Geometry geom, const amrex::Box &bx, const amrex::Array4< amrex::Real > &cell_rhs, const amrex::Array4< const amrex::Real > &cell_data, const amrex::Array4< const amrex::Real > &r0, const amrex::Array4< const amrex::Real > &th0, const amrex::Array4< const amrex::Real > &qv0, const amrex::Array4< const amrex::Real > &z_phys_cc, int n_qstate)
void compute_gradp_xy(const amrex::MultiFab &p, const amrex::Geometry &geom, const amrex::MultiFab &z_phys_cc, amrex::Vector< std::unique_ptr< amrex::MultiFab >> &mapfac, const eb_ &ebfact, amrex::Vector< amrex::MultiFab > &gradp, const SolverChoice &solverChoice)
void ApplySpongeZoneBCsForMom_ReadFromFile(const SpongeChoice &spongeChoice, const amrex::Geometry geom, const amrex::Box &tbx, const amrex::Box &tby, const amrex::Array4< const amrex::Real > &cell_data, const amrex::Array4< const amrex::Real > &z_phys_cc, const amrex::Array4< amrex::Real > &rho_u_rhs, const amrex::Array4< amrex::Real > &rho_v_rhs, const amrex::Array4< const amrex::Real > &rho_u, const amrex::Array4< const amrex::Real > &rho_v, const amrex::Vector< amrex::Real * > d_sponge_ptrs_at_lev)
void ApplySurfaceTreatment_BulkCoeff_CC(const amrex::Box &bx, const amrex::Array4< amrex::Real > &cell_rhs, const amrex::Array4< const amrex::Real > &cons_state, const amrex::Array4< const amrex::Real > &z_phys_cc, const amrex::Array4< const amrex::Real > &surface_state_arr)
void ApplySpongeZoneBCsForMom(const SpongeChoice &spongeChoice, const amrex::Geometry geom, const amrex::Box &tbx, const amrex::Box &tby, const amrex::Box &tbz, const amrex::Array4< amrex::Real > &rho_u_rhs, const amrex::Array4< amrex::Real > &rho_v_rhs, const amrex::Array4< amrex::Real > &rho_w_rhs, const amrex::Array4< const amrex::Real > &rho_u, const amrex::Array4< const amrex::Real > &rho_v, const amrex::Array4< const amrex::Real > &rho_w, const amrex::Array4< const amrex::Real > &r0, const amrex::Array4< const amrex::Real > &z_phys_nd, const amrex::Array4< const amrex::Real > &z_phys_cc)
Definition: ERF_EB.H:13
@ qt
Definition: ERF_Kessler.H:28
@ xvel
Definition: ERF_IndexDefines.H:175
@ zvel
Definition: ERF_IndexDefines.H:177
@ yvel
Definition: ERF_IndexDefines.H:176
@ p
Definition: ERF_WSM6.H:176
real(c_double), parameter p0
Definition: ERF_module_model_constants.F90:40
real(kind=kind_phys), parameter, private r0
Definition: ERF_module_mp_wsm6.F90:21
Definition: ERF_InputSoundingData.H:22
Definition: ERF_DataStruct.H:141
Definition: ERF_SpongeStruct.H:19
Definition: ERF_TurbPertStruct.H:22