REMORA
Regional Modeling of Oceans Refined Adaptively
Loading...
Searching...
No Matches
REMORA.H
Go to the documentation of this file.
1#ifndef REMORA_H_
2#define REMORA_H_
3
4#include <string>
5#include <limits>
6#include <array>
7#include <memory>
8
9#ifdef _OPENMP
10#include <omp.h>
11#endif
12
13#include <AMReX_AmrCore.H>
14#include <AMReX_BCRec.H>
15#include <AMReX_InterpFaceRegister.H>
16
17#include <AMReX_ParallelDescriptor.H>
18#include <AMReX_ParmParse.H>
19#include <AMReX_MultiFabUtil.H>
20#include <AMReX_FillPatchUtil.H>
21#include <AMReX_VisMF.H>
22#include <AMReX_PhysBCFunct.H>
23#include <AMReX_YAFluxRegister.H>
24#include <AMReX_ErrorList.H>
25
26#ifdef AMREX_MEM_PROFILING
27#include <AMReX_MemProfiler.H>
28#endif
29
30#include <REMORA_Math.H>
31#include <REMORA_PhysBCFunct.H>
32#include <REMORA_FillPatcher.H>
33
34#include <REMORA_IndexDefines.H>
36#include <REMORA_DataStruct.H>
37#include <REMORA_Derive.H>
38#include "REMORA_prob_common.H"
39
40#ifdef REMORA_USE_PARTICLES
41#include "REMORA_ParticleData.H"
42#endif
43
44#ifdef REMORA_USE_NETCDF
45#include "REMORA_NCInterface.H"
46#include "REMORA_NCTimeSeries.H"
49#endif
50
51#ifdef REMORA_USE_MOAB
52#include "REMORA_MOAB.H"
53#endif
54
55#include <iostream>
56
57#ifdef AMREX_LAZY
58#include <AMReX_Lazy.H>
59#endif
60
61#ifndef AMREX_USE_MPI
62using amrex::MPI_COMM_WORLD;
63using amrex::MPI_Comm;
64#endif
65
77
78// Forward declarations to resolve circular dependency
79class ProblemBase;
80#ifdef REMORA_USE_NETCDF
81class NCTimeSeries;
84#endif
85
86/*!
87 * \brief Class that stores all relevant simulation state data with methods for time stepping
88 */
89class REMORA
90 : public amrex::AmrCore
91{
92public:
93
94 REMORA ();
95 REMORA (const amrex::RealBox& rb, int max_level_in, const amrex::Vector<int>& n_cell_in, int coord, const amrex::Vector<amrex::IntVect>& ref_ratio, const amrex::Array<int,AMREX_SPACEDIM>& is_per, std::string prefix);
96 virtual ~REMORA ();
97
98 /** \brief Advance solution to final time */
99 void Evolve ();
100
101 /** \brief Tag cells for refinement */
102 virtual void ErrorEst (int lev, amrex::TagBoxArray& tags, amrex::Real time, int ngrow) override;
103
104 /** \brief Initialize multilevel data */
105 void InitData ();
106 amrex::Real EvolveOneStep (amrex::Real time, amrex::Real dt_request);
107
108 /** \brief Init (NOT restart or regrid) */
109 void init_only (int lev, amrex::Real time);
110
111 /** \briefRestart */
112 void restart ();
113
114 /** \brief Called after every level 0 timestep */
115 void post_timestep (int nstep, amrex::Real time, amrex::Real dt_lev);
116
117 /**
118 * \brief Extracts SST from the 3D conservative state for the atmospheric driver.
119 *
120 * Reads Temp_comp at the top water-column cell (k_sfc), converts from
121 * Celsius to Kelvin, and copies the result into state[SSTIndex].
122 *
123 * @param[in,out] state OCN2ATM slab buffer sized by the driver (one MultiFab
124 * per ocean-to-atmosphere export layer). state[SSTIndex]
125 * (index 0) is overwritten with sea-surface temperature
126 * (SST) sampled from the Temp_comp tracer at the uppermost
127 * sigma level (k = Nz) and converted from degrees Celsius
128 * to Kelvin for the atmospheric driver. An empty vector or
129 * null state[0] is treated as a no-op.
130 * @param[in ] time Current ocean model time (unused; retained for driver
131 * interface conformance).
132 */
133 void PackSurfaceState (amrex::Vector<amrex::MultiFab*>& state, amrex::Real time);
134
135 /**
136 * \brief Receives atmospheric states from the driver and applies unit conversions.
137 *
138 * Fills REMORA's internal forcing MultiFabs from states and records which
139 * lanes were successfully updated in driver_atmos_state_from_driver.
140 * Unit conversions applied: Pair Pa to mb; Tair K to Celsius.
141 *
142 * @param[in] states ATM2OCN forcing slab buffer from the driver (Warner et al.
143 * 2010, Block B state-passing contract), indexed by AtmosState.
144 * Expected units per lane:
145 * Uwind/Vwind: 10-m winds [m/s];
146 * Pair: mean sea-level pressure [Pa, converted to mb];
147 * Qair: near-surface specific humidity [kg/kg];
148 * Tair: 2-m air temperature [K, converted to degC];
149 * Cloud: cloud fraction [0-1];
150 * Rain: precipitation rate [kg/m^2/s];
151 * SWrad/LWrad: downwelling shortwave/longwave radiation [W/m^2].
152 * Missing lanes (null pointer or index out of range) are skipped;
153 * driver_atmos_state_from_driver tracks populated lanes for the
154 * bulk-flux parameterization fallback logic.
155 * @param[in] time Current ocean model time (unused; retained for driver
156 * interface conformance).
157 */
158 void ApplyAtmosphericStates (const amrex::Vector<amrex::MultiFab*>& states, amrex::Real time);
159
160 // Diagnostics
161
162 /** \brief Integrate conserved quantities for diagnostics */
163 void sum_integrated_quantities (amrex::Real time);
164
165 /** \brief Perform the volume-weighted sum */
166 amrex::Real
167 volWgtSumMF (int lev,
168 const amrex::MultiFab& mf, int comp, bool local, bool finemask);
169
170 /** \brief Decide if it is time to take an action */
171 bool is_it_time_for_action (int nstep, amrex::Real time, amrex::Real dt,
172 int action_interval, amrex::Real action_per);
173
174 /** \brief Make a new level using provided BoxArray and DistributionMapping and
175 * fill with interpolated coarse level data.
176 * Overrides the pure virtual function in AmrCore
177 */
178 virtual void MakeNewLevelFromCoarse (int lev, amrex::Real time, const amrex::BoxArray& ba,
179 const amrex::DistributionMapping& dm) override;
180
181 /** \brief Remake an existing level using provided BoxArray and DistributionMapping and
182 * fill with existing fine and coarse data.
183 * Overrides the pure virtual function in AmrCore
184 */
185 virtual void RemakeLevel (int lev, amrex::Real time, const amrex::BoxArray& ba,
186 const amrex::DistributionMapping& dm) override;
187
188 /** \brief Delete level data
189 * Overrides the pure virtual function in AmrCore
190 */
191 virtual void ClearLevel (int lev) override;
192
193 /** \brief Make a new level from scratch using provided BoxArray and DistributionMapping.
194 * Only used during initialization.
195 * Overrides the pure virtual function in AmrCore
196 */
197 virtual void MakeNewLevelFromScratch (int lev, amrex::Real time, const amrex::BoxArray& ba,
198 const amrex::DistributionMapping& dm) override;
199
200 /** \brief Set pm and pn arrays and x/y coords on level lev */
201 void set_grid_scale (int lev);
202
203 /** \brief Set x/y coords on level lev based on pm and pn */
204 void set_grid_coords_from_grid_scale (int lev);
205
206 /** \brief Set pm/pn by averaging down from higher-resolution grid */
207 void set_grid_vars_averaged_down (int lev);
208
209 /** \brief Set zeta components to be equal to time-averaged Zt_avg1 */
210 void set_zeta_to_Ztavg (int lev);
211
212 /** \brief Calculate u-, v-, and psi-point masks based on rho-point masks after analytic initialization */
213 void calculate_nodal_masks (int lev);
214
215 /** \brief Copy maskr to all z levels */
216 void fill_3d_masks (int lev);
217
218 /** \brief Set psi-point mask to be consistent with rho-point mask */
219 void update_mskp (int lev);
220
221 /** \brief compute dt from CFL considerations */
222 amrex::Real estTimeStep (int lev) const;
223
224 /** \brief Interface for advancing the data at one level by one "slow" timestep */
225 void remora_advance(int level,
226 amrex::MultiFab& cons_old, amrex::MultiFab& cons_new,
227 amrex::MultiFab& xvel_old, amrex::MultiFab& yvel_old, amrex::MultiFab& zvel_old,
228 amrex::MultiFab& xvel_new, amrex::MultiFab& yvel_new, amrex::MultiFab& zvel_new,
229 amrex::MultiFab& source,
230 const amrex::Geometry fine_geom,
231 const amrex::Real dt, const amrex::Real time);
232
233 /** \brief Make mask to zero out covered cells (for mesh refinement) */
234 amrex::MultiFab& build_fine_mask(int lev);
235
236 /** \brief main driver for writing AMReX plotfiles */
237 void WritePlotFile (int istep);
238
239 /** \brief write out particular data to an AMReX plotfile */
240 void WriteMultiLevelPlotfileWithBathymetry (const std::string &plotfilename,
241 int nlevels,
242 const amrex::Vector<const amrex::MultiFab*> &mf,
243 const amrex::Vector<const amrex::MultiFab*> &mf_nd,
244 const amrex::Vector<const amrex::MultiFab*> &mf_u,
245 const amrex::Vector<const amrex::MultiFab*> &mf_v,
246 const amrex::Vector<const amrex::MultiFab*> &mf_w,
247 const amrex::Vector<const amrex::MultiFab*> &mf_2d_rho,
248 const amrex::Vector<const amrex::MultiFab*> &mf_2d_u,
249 const amrex::Vector<const amrex::MultiFab*> &mf_2d_v,
250 const amrex::Vector<std::string> &varnames_3d,
251 const amrex::Vector<std::string> &varnames_2d_rho,
252 const amrex::Vector<std::string> &varnames_2d_u,
253 const amrex::Vector<std::string> &varnames_2d_v,
254 const amrex::Vector<amrex::Geometry>& my_geom,
255 amrex::Real time,
256 const amrex::Vector<int> &level_steps,
257 const amrex::Vector<amrex::IntVect>& rr,
258 const std::string &versionName = "HyperCLaw-V1.1",
259 const std::string &levelPrefix = "Level_",
260 const std::string &mfPrefix = "Cell",
261 const amrex::Vector<std::string>& extra_dirs = amrex::Vector<std::string>()) const;
262
263
264
265 /** \brief write out header data for an AMReX plotfile */
266 void WriteGenericPlotfileHeaderWithBathymetry (std::ostream &HeaderFile,
267 int nlevels,
268 const amrex::Vector<amrex::BoxArray> &bArray,
269 const amrex::Vector<std::string> &varnames_3d,
270 const amrex::Vector<std::string> &varnames_2d_rho,
271 const amrex::Vector<std::string> &varnames_2d_u,
272 const amrex::Vector<std::string> &varnames_2d_v,
273 const amrex::Vector<amrex::Geometry>& my_geom,
274 amrex::Real time,
275 const amrex::Vector<int> &level_steps,
276 const amrex::Vector<amrex::IntVect>& rr,
277 const std::string &versionName,
278 const std::string &levelPrefix,
279 const std::string &mfPrefix) const;
280
281 /** \brief default prefix for input file parameters */
282 std::string pp_prefix {"remora"};
283
284 /** \brief multilevel data container for last step's scalar data: temperature, salinity, passive tracer */
285 amrex::Vector<amrex::MultiFab*> cons_old;
286 /** \brief multilevel data container for last step's x velocities (u in ROMS) */
287 amrex::Vector<amrex::MultiFab*> xvel_old;
288 /** \brief multilevel data container for last step's y velocities (v in ROMS) */
289 amrex::Vector<amrex::MultiFab*> yvel_old;
290 /** \brief multilevel data container for last step's z velocities (largely unused; W stored separately) */
291 amrex::Vector<amrex::MultiFab*> zvel_old;
292
293 /** \brief multilevel data container for current step's scalar data: temperature, salinity, passive tracer */
294 amrex::Vector<amrex::MultiFab*> cons_new;
295 /** \brief multilevel data container for current step's x velocities (u in ROMS) */
296 amrex::Vector<amrex::MultiFab*> xvel_new;
297 /** \brief multilevel data container for current step's y velocities (v in ROMS) */
298 amrex::Vector<amrex::MultiFab*> yvel_new;
299 /** \brief multilevel data container for current step's z velocities (largely unused; W stored separately) */
300 amrex::Vector<amrex::MultiFab*> zvel_new;
301
302 /** \brief multilevel data container for high res initial data: temperature, salinity, passive tracer */
303 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_cons_full_domain;
304 /** \brief multilevel data container for high res initial x velocities (u in ROMS) */
305 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_xvel_full_domain;
306 /** \brief multilevel data container for high res initial y velocities (v in ROMS) */
307 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_yvel_full_domain;
308 /** \brief multilevel data container for current step's z velocities (largely unused; W stored separately) */
309
310 // Program state data is represented by vectors of pointers to AMReX Multifabs.
311 // There is one pointer per level
312
313 /** \brief Bathymetry data (2D, positive valued, h in ROMS) **/
314 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_h;
315
316 /** \brief Bathymetry data on the whole domain at each potential level **/
317 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_h_full_domain;
318
319 /** \brief Width of cells in the vertical (z-) direction (3D, Hz in ROMS) */
320 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_Hz;
321 /** \brief u-volume flux (3D) */
322 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_Huon;
323 /** \brief v-volume flux (3D) */
324 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_Hvom;
325 /** \brief u velocity RHS (3D, includes horizontal and vertical advection) */
326 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_ru;
327 /** \brief v velocity RHS (3D, includes horizontal and vertical advection) */
328 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_rv;
329 /** \brief u velocity RHS (2D, includes horizontal and vertical advection) */
330 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_ru2d;
331 /** \brief v velocity RHS (2D, includes horizontal and vertical advection) */
332 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_rv2d;
333 /** \brief u velocity RHS, integrated, including advection and bottom/surface stresses (2D) */
334 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_rufrc;
335 /** \brief v velocity RHS, integrated, including advection and bottom/surface stresses (2D) */
336 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_rvfrc;
337 /** \brief Vertical viscosity coefficient (3D) */
338 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_Akv;
339 /** \brief Vertical diffusion coefficient (3D) */
340 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_Akt;
341 /** \brief Harmonic viscosity defined on the psi points (corners of horizontal grid cells) */
342 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_visc2_p;
343 /** \brief Harmonic viscosity defined on the rho points (centers) */
344 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_visc2_r;
345 /** \brief Harmonic diffusivity for temperature / salinity */
346 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_diff2;
347
348 /** \brief z coordinates at rho points (cell centers) */
349 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_z_r;
350
351 /** \brief z coordinates at w points (faces between z-cells) */
352 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_z_w;
353 /** \brief Scaled vertical coordinate (range [0,1]) that transforms to z, defined at rho points (cell centers) */
354 amrex::Gpu::DeviceVector<amrex::Real> s_r;
355 /** \brief Scaled vertical coordinate (range [0,1]) that transforms to z, defined at w-points (cell faces) */
356 amrex::Gpu::DeviceVector<amrex::Real> s_w;
357
358 //amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_s_r;
359 //amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_s_w;
360 //amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_Cs_r;
361 //amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_Cs_w;
362
363 /** \brief Stretching coefficients at rho points */
364 amrex::Gpu::DeviceVector<amrex::Real> Cs_r;
365 /** \brief Stretching coefficients at w points */
366 amrex::Gpu::DeviceVector<amrex::Real> Cs_w;
367
368 /** \brief z coordinates at psi points (cell nodes) **/
369 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_z_phys_nd;
370
371 /** \brief Average of the free surface, zeta (2D) */
372 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_Zt_avg1;
373
374 /** \brief Surface stress in the u direction */
375 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_sustr;
376 /** \brief Surface stress in the v direction */
377 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_svstr;
378
379 /** \brief Wind in the u direction, defined at rho-points */
380 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_uwind;
381 /** \brief Wind in the v direction, defined at rho-points */
382 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_vwind;
383 /** \brief Air temperature [°C], defined at rho-points */
384 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_Tair;
385 /** \brief Specific humidity [kg/kg], defined at rho-points */
386 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_qair;
387 /** \brief Air pressure [mb], defined at rho-points */
388 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_Pair;
389
390 /** \brief Shortwave radiation flux [W/m²], defined at rho-points */
391 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_srflx;
392 /** \brief longwave radiation */
393 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_lrflx;
394 /** \brief Downward longwave radiation */
395 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_longwave_down;
396 /** \brief latent heat flux */
397 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_lhflx;
398 /** \brief sensible heat flux */
399 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_shflx;
400
401 /** \brief Surface tracer flux; working arrays */
402 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_stflx;
403 /** \brief Surface tracer flux; input arrays */
404 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_stflux;
405 /** \brief Bottom tracer flux; working arrays */
406 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_btflx;
407 /** \brief Bottom tracer flux; input arrays */
408 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_btflux;
409
410 /** \brief precipitation rate [kg/m^2/s] */
411 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_rain;
412 /** \brief evaporation rate [kg/m^2/s] */
413 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_evap;
414 /** \brief cloud cover fraction [0-1], defined at rho-points */
415 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_cloud;
416 /** \brief evaporation minus precipitation [kg/m^2/s], defined at rho-points */
417 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_EminusP;
418
419 /** \brief provenance flags for driver-supplied atmospheric forcing lanes */
420 std::array<bool, AtmosState::NumTypes> driver_atmos_state_from_driver {};
421
422 /** \brief Linear drag coefficient [m/s], defined at rho points */
423 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_rdrag;
424 /** \brief Quadratic drag coefficient [unitless], defined at rho points */
425 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_rdrag2;
426 /** \brief Bottom roughness length [m], defined at rho points */
427 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_ZoBot;
428
429 /** \brief Bottom stress in the u direction */
430 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_bustr;
431 /** \brief Bottom stress in the v direction */
432 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_bvstr;
433
434 /** \brief time average of barotropic x velocity flux (2D) */
435 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_DU_avg1;
436 /** \brief correct time average of barotropic x velocity flux for coupling (2D) */
437 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_DU_avg2;
438 /** \brief time average of barotropic y velocity flux */
439 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_DV_avg1;
440 /** \brief correct time average of barotropic y velocity flux for coupling (2D) */
441 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_DV_avg2;
442 /** \brief barotropic x velocity for the RHS (2D) */
443 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_rubar;
444 /** \brief barotropic y velocity for the RHS (2D) */
445 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_rvbar;
446 /** \brief free surface height for the RHS (2D) */
447 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_rzeta;
448 /** \brief barotropic x velocity (2D) */
449 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_ubar;
450 /** \brief barotropic y velocity (2D) */
451 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_vbar;
452 /** \brief free surface height (2D) */
453 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_zeta;
454
455 /** \brief high resolution initial free surface height (2D) */
456 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_zeta_full_domain;
457
458 /** \brief land/sea mask at cell centers (2D) */
459 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_mskr;
460 /** \brief land/sea mask at x-faces (2D) */
461 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_msku;
462 /** \brief land/sea mask at y-faces (2D) */
463 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_mskv;
464 /** \brief land/sea mask at cell corners (2D) */
465 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_mskp;
466 /** \brief land/sea mask at cell centers, copied to all z levels (3D) */
467 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_mskr3d;
468
469 /** \brief horizontal scaling factor: 1 / dx (2D) */
470 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_pm;
471 /** \brief horizontal scaling factor: 1 / dy (2D) */
472 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_pn;
473 /** \brief horizontal scaling factor: 1 / dx (2D) on whole domain */
474 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_pm_full_domain;
475 /** \brief horizontal scaling factor: 1 / dy (2D) on whole domain */
476 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_pn_full_domain;
477
478
479 /** \brief coriolis factor (2D) */
480 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_fcor;
481
482 /** \brief x_grid on rho points (2D) */
483 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_xr;
484 /** \brief y_grid on rho points (2D) */
485 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_yr;
486
487 /** \brief x_grid on u-points (2D) */
488 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_xu;
489 /** \brief y_grid on u-points (2D) */
490 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_yu;
491
492 /** \brief x_grid on v-points (2D) */
493 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_xv;
494 /** \brief y_grid on v-points (2D) */
495 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_yv;
496
497 /** \brief x_grid on psi-points (2D) */
498 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_xp;
499 /** \brief y_grid on psi-points (2D) */
500 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_yp;
501
502 /** \brief additional scratch space for calculations on temp, salt, etc */
503 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_sstore;
504
505 /** \brief density perturbation */
506 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_rhoS;
507 /** \brief vertically-averaged density */
508 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_rhoA;
509 /** \brief Brunt-Vaisala frequency (3D) */
510 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_bvf;
511 /** \brief Thermal expansion coefficient (3D) */
512 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_alpha;
513 /** \brief Saline contraction coefficient (3D) */
514 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_beta;
515
516 /** \brief Weights for calculating avg1 in 2D advance */
517 amrex::Vector<amrex::Real> vec_weight1;
518 /** \brief Weights for calculating avg2 in 2D advance */
519 amrex::Vector<amrex::Real> vec_weight2;
520
521 // GLS
522 /** \brief Turbulent kinetic energy */
523 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_tke;
524 /** \brief Turbulent generic length scale */
525 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_gls;
526 /** \brief Vertical mixing turbulent length scale */
527 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_Lscale;
528 /** \brief Turbulent kinetic energy vertical diffusion coefficient */
529 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_Akk;
530 /** \brief Turbulent length scale vertical diffusion coefficient */
531 amrex::Vector<std::unique_ptr<amrex::MultiFab>> vec_Akp;
532
533 /** \brief Climatology nudging coefficients */
534 amrex::Vector<amrex::Vector<std::unique_ptr<amrex::MultiFab>>> vec_nudg_coeff;
535
536 /** \brief advance a single level for a single time step */
537 void Advance (int lev, amrex::Real time, amrex::Real dt_lev, int iteration, int ncycle);
538
539 /** \brief Set everything up for a step on a level */
540 void setup_step(int lev, amrex::Real time, amrex::Real dt_lev);
541
542 /** \brief 3D advance on a single level */
543 void advance_3d_ml (int lev, amrex::Real dt_lev);
544
545 /** \brief 2D advance, one predictor/corrector step */
546 void advance_2d_onestep (int lev, amrex::Real dt_lev, amrex::Real dtfast_lev, int my_iif, int nfast_counter);
547
548 /** \brief Perform a 2D predictor (predictor_2d_step=True) or corrector (predictor_2d_step=False) step */
549 void advance_2d (int lev,
550 amrex::MultiFab const* mf_rhoS,
551 amrex::MultiFab const* mf_rhoA,
552 amrex::MultiFab * mf_ru2d,
553 amrex::MultiFab * mf_rv2d,
554 amrex::MultiFab * mf_rufrc,
555 amrex::MultiFab * mf_rvfrc,
556 amrex::MultiFab * mf_Zt_avg1,
557 std::unique_ptr<amrex::MultiFab>& mf_DU_avg1,
558 std::unique_ptr<amrex::MultiFab>& mf_DU_avg2,
559 std::unique_ptr<amrex::MultiFab>& mf_DV_avg1,
560 std::unique_ptr<amrex::MultiFab>& mf_DV_avg2,
561 std::unique_ptr<amrex::MultiFab>& mf_rubar,
562 std::unique_ptr<amrex::MultiFab>& mf_rvbar,
563 std::unique_ptr<amrex::MultiFab>& mf_rzeta,
564 std::unique_ptr<amrex::MultiFab>& mf_ubar,
565 std::unique_ptr<amrex::MultiFab>& mf_vbar,
566 amrex::MultiFab * mf_zeta,
567 amrex::MultiFab const* mf_h,
568 amrex::MultiFab const* mf_pm,
569 amrex::MultiFab const* mf_pn,
570 amrex::MultiFab const* mf_fcor,
571 amrex::MultiFab const* mf_visc2_p,
572 amrex::MultiFab const* mf_visc2_r,
573 amrex::MultiFab const* mf_mskr,
574 amrex::MultiFab const* mf_msku,
575 amrex::MultiFab const* mf_mskv,
576 amrex::MultiFab const* mf_mskp,
577 amrex::Real dtfast_lev,
578 bool predictor_2d_step,
579 bool first_2d_step, int my_iif,
580 int & next_indx1);
581
582 /** \brief Advance the 3D variables */
583 void advance_3d (int lev,
584 amrex::MultiFab& mf_cons,
585 amrex::MultiFab& mf_u , amrex::MultiFab& mf_v,
586 amrex::MultiFab* mf_sstore,
587 amrex::MultiFab* mf_ru , amrex::MultiFab* mf_rv,
588 std::unique_ptr<amrex::MultiFab>& mf_DU_avg1,
589 std::unique_ptr<amrex::MultiFab>& mf_DU_avg2,
590 std::unique_ptr<amrex::MultiFab>& mf_DV_avg1,
591 std::unique_ptr<amrex::MultiFab>& mf_DV_avg2,
592 std::unique_ptr<amrex::MultiFab>& mf_ubar,
593 std::unique_ptr<amrex::MultiFab>& mf_vbar,
594 std::unique_ptr<amrex::MultiFab>& mf_Akv,
595 std::unique_ptr<amrex::MultiFab>& mf_Akt,
596 std::unique_ptr<amrex::MultiFab>& mf_Hz,
597 std::unique_ptr<amrex::MultiFab>& mf_Huon,
598 std::unique_ptr<amrex::MultiFab>& mf_Hvom,
599 std::unique_ptr<amrex::MultiFab>& mf_z_w,
600 amrex::MultiFab const* mf_h,
601 amrex::MultiFab const* mf_pm,
602 amrex::MultiFab const* mf_pn,
603 amrex::MultiFab const* mf_mskr,
604 amrex::MultiFab const* mf_msku,
605 amrex::MultiFab const* mf_mskv,
606 const int N,
607 const amrex::Real dt_lev);
608
609 /** \brief Calculate bulk temperature, salinity, wind fluxes */
610 void bulk_fluxes (int lev,
611 amrex::MultiFab* mf_cons,
612 amrex::MultiFab* mf_uwind,
613 amrex::MultiFab* mf_vwind,
614 amrex::MultiFab* mf_Tair,
615 amrex::MultiFab* mf_qair,
616 amrex::MultiFab* mf_Pair,
617 amrex::MultiFab* mf_srflx,
618 amrex::MultiFab* mf_longwave_down,
619 amrex::MultiFab* mf_evap,
620 amrex::MultiFab* mf_sustr,
621 amrex::MultiFab* mf_svstr,
622 amrex::MultiFab* mf_stflux,
623 amrex::MultiFab* mf_lrflx,
624 amrex::MultiFab* mf_lhflx,
625 amrex::MultiFab* mf_shflx,
626 const int N);
627
628 /** \brief Wrapper function for prestep */
629 void prestep (int lev,
630 amrex::MultiFab& mf_uold, amrex::MultiFab& mf_vold,
631 amrex::MultiFab& mf_u, amrex::MultiFab& mf_v,
632 amrex::MultiFab* mf_ru,
633 amrex::MultiFab* mf_rv,
634 amrex::MultiFab& S_old,
635 amrex::MultiFab& S_new,
636 amrex::MultiFab& mf_W, amrex::MultiFab& mf_DC,
637 /* MF mf_FC? */
638 const amrex::MultiFab* mf_z_r,
639 const amrex::MultiFab* mf_z_w,
640 const amrex::MultiFab* mf_h,
641 const amrex::MultiFab* mf_pm,
642 const amrex::MultiFab* mf_pn,
643 const amrex::MultiFab* mf_sustr,
644 const amrex::MultiFab* mf_svstr,
645 const amrex::MultiFab* mf_bustr,
646 const amrex::MultiFab* mf_bvstr,
647 const amrex::MultiFab* mf_msku,
648 const amrex::MultiFab* mf_mskv,
649 const int iic, const int nfirst,
650 const int nnew, int nstp, int nrhs,
651 int N, const amrex::Real dt_lev);
652
653 /** \brief Prestep advection calculations for the tracers */
654 void prestep_t_advection (int lev, const amrex::Box& tbx,
655 const amrex::Box& gbx,
656 const amrex::Array4<amrex::Real >& tempold,
657 const amrex::Array4<amrex::Real >& tempcache,
658 const amrex::Array4<amrex::Real >& Hz,
659 const amrex::Array4<amrex::Real >& Huon,
660 const amrex::Array4<amrex::Real >& Hvom,
661 const amrex::Array4<amrex::Real >& W,
662 const amrex::Array4<amrex::Real >& DC,
663 const amrex::Array4<amrex::Real >& FC,
664 const amrex::Array4<amrex::Real >& sstore,
665 const amrex::Array4<amrex::Real const>& z_w,
666 const amrex::Array4<amrex::Real const>& h,
667 const amrex::Array4<amrex::Real const>& pm,
668 const amrex::Array4<amrex::Real const>& pn,
669 const amrex::Array4<amrex::Real const>& msku,
670 const amrex::Array4<amrex::Real const>& mskv,
671 const amrex::Array4<int const>& river_pos,
672 const amrex::Array4<amrex::Real const>& river_source,
673 int iic, int ntfirst, int nrhs, int N,
674 const amrex::Real dt_lev);
675
676 /** \brief RHS terms for tracer */
677 void rhs_t_3d (int lev,
678 const amrex::Box& bx,
679 const amrex::Array4<amrex::Real >& t,
680 const amrex::Array4<amrex::Real const>& tempstore,
681 const amrex::Array4<amrex::Real const>& Huon,
682 const amrex::Array4<amrex::Real const>& Hvom,
683 const amrex::Array4<amrex::Real const>& Hz,
684 const amrex::Array4<amrex::Real const>& pn,
685 const amrex::Array4<amrex::Real const>& pm,
686 const amrex::Array4<amrex::Real const>& W,
687 const amrex::Array4<amrex::Real >& FC,
688 const amrex::Array4<amrex::Real const>& mskr,
689 const amrex::Array4<amrex::Real const>& msku,
690 const amrex::Array4<amrex::Real const>& mskv,
691 const amrex::Array4<int const>& river_pos,
692 const amrex::Array4<amrex::Real const>& river_source,
693 int nrhs, int nnew, int N, const amrex::Real dt_lev);
694
695 /** \brief RHS terms for 3D momentum */
696 void rhs_uv_3d (int lev,
697 const amrex::Box& xbx,
698 const amrex::Box& ybx,
699 const amrex::Array4<amrex::Real const>& uold,
700 const amrex::Array4<amrex::Real const>& vold,
701 const amrex::Array4<amrex::Real >& ru,
702 const amrex::Array4<amrex::Real >& rv,
703 const amrex::Array4<amrex::Real >& rufrc,
704 const amrex::Array4<amrex::Real >& rvfrc,
705 const amrex::Array4<amrex::Real const>& sustr,
706 const amrex::Array4<amrex::Real const>& svstr,
707 const amrex::Array4<amrex::Real const>& bustr,
708 const amrex::Array4<amrex::Real const>& bvstr,
709 const amrex::Array4<amrex::Real const>& Huon,
710 const amrex::Array4<amrex::Real const>& Hvom,
711 const amrex::Array4<amrex::Real const>& pm,
712 const amrex::Array4<amrex::Real const>& pn,
713 const amrex::Array4<amrex::Real const>& W,
714 const amrex::Array4<amrex::Real >& FC,
715 int nrhs, int N);
716
717 /** \brief RHS terms for 2D momentum */
718 void rhs_uv_2d (int lev,
719 const amrex::Box& xbx,
720 const amrex::Box& ybx,
721 const amrex::Array4<amrex::Real const>& uold,
722 const amrex::Array4<amrex::Real const>& vold,
723 const amrex::Array4<amrex::Real >& ru,
724 const amrex::Array4<amrex::Real >& rv,
725 const amrex::Array4<amrex::Real const>& Duon,
726 const amrex::Array4<amrex::Real const>& Dvom,
727 const int nrhs);
728
729 /** \brief Wrapper around equation of state calculation */
730 void rho_eos (const amrex::Box& bx,
731 const amrex::Array4<amrex::Real const>& state,
732 const amrex::Array4<amrex::Real >& rho,
733 const amrex::Array4<amrex::Real >& rhoA,
734 const amrex::Array4<amrex::Real >& rhoS,
735 const amrex::Array4<amrex::Real >& bvf,
736 const amrex::Array4<amrex::Real >& alpha,
737 const amrex::Array4<amrex::Real >& beta,
738 const amrex::Array4<amrex::Real const>& Hz,
739 const amrex::Array4<amrex::Real const>& z_w,
740 const amrex::Array4<amrex::Real const>& z_r,
741 const amrex::Array4<amrex::Real const>& h,
742 const amrex::Array4<amrex::Real const>& mskr,
743 const int N);
744
745 /** \brief Calculate density and related quantities from linear equation of state */
746 void lin_eos (const amrex::Box& bx,
747 const amrex::Array4<amrex::Real const>& state,
748 const amrex::Array4<amrex::Real >& rho,
749 const amrex::Array4<amrex::Real >& rhoA,
750 const amrex::Array4<amrex::Real >& rhoS,
751 const amrex::Array4<amrex::Real >& bvf,
752 const amrex::Array4<amrex::Real const>& Hz,
753 const amrex::Array4<amrex::Real const>& z_w,
754 const amrex::Array4<amrex::Real const>& z_r,
755 const amrex::Array4<amrex::Real const>& h,
756 const amrex::Array4<amrex::Real const>& mskr,
757 const int N);
758
759 /** \brief Calculate density and related quantities from nonlinear equation of state */
760 void nonlin_eos (const amrex::Box& bx,
761 const amrex::Array4<amrex::Real const>& state,
762 const amrex::Array4<amrex::Real >& rho,
763 const amrex::Array4<amrex::Real >& rhoA,
764 const amrex::Array4<amrex::Real >& rhoS,
765 const amrex::Array4<amrex::Real >& bvf,
766 const amrex::Array4<amrex::Real >& alpha,
767 const amrex::Array4<amrex::Real >& beta,
768 const amrex::Array4<amrex::Real const>& Hz,
769 const amrex::Array4<amrex::Real const>& z_w,
770 const amrex::Array4<amrex::Real const>& z_r,
771 const amrex::Array4<amrex::Real const>& h,
772 const amrex::Array4<amrex::Real const>& mskr,
773 const int N);
774
775 /** \brief Calculate pressure gradient */
776 void prsgrd (const amrex::Box& bx,
777 const amrex::Box& gbx,
778 const amrex::Box& utbx,
779 const amrex::Box& vtbx,
780 const amrex::Array4<amrex::Real >& ru,
781 const amrex::Array4<amrex::Real >& rv,
782 const amrex::Array4<amrex::Real const>& pn,
783 const amrex::Array4<amrex::Real const>& pm,
784 const amrex::Array4<amrex::Real const>& rho,
785 const amrex::Array4<amrex::Real >& FC,
786 const amrex::Array4<amrex::Real const>& Hz,
787 const amrex::Array4<amrex::Real const>& z_r,
788 const amrex::Array4<amrex::Real const>& z_w,
789 const amrex::Array4<amrex::Real const>& msku,
790 const amrex::Array4<amrex::Real const>& mskv,
791 const int nrhs, const int N);
792
793 /** \brief Update velocities or tracers with diffusion/viscosity
794 * as the last part of the prestep */
795 void prestep_diffusion (const amrex::Box& bx,
796 const amrex::Box& gbx,
797 const int ioff, const int joff,
798 const amrex::Array4<amrex::Real >& vel,
799 const amrex::Array4<amrex::Real const>& vel_old,
800 const amrex::Array4<amrex::Real >& rvel,
801 const amrex::Array4<amrex::Real const>& Hz,
802 const amrex::Array4<amrex::Real const>& Akv,
803 const amrex::Array4<amrex::Real >& FC,
804 const amrex::Array4<amrex::Real const>& sstr,
805 const amrex::Array4<amrex::Real const>& bstr,
806 const amrex::Array4<amrex::Real const>& z_r,
807 const amrex::Array4<amrex::Real const>& pm,
808 const amrex::Array4<amrex::Real const>& pn,
809 const int iic, const int ntfirst, const int nnew, int nstp, int nrhs, int N,
810 const amrex::Real lambda, const amrex::Real dt_lev);
811
812 /** \brief Calculate effects of vertical viscosity or diffusivity */
813 void vert_visc_3d (const amrex::Box& bx,
814 const int ioff, const int joff,
815 const amrex::Array4<amrex::Real >& phi,
816 const amrex::Array4<amrex::Real const>& Hz,
817 const amrex::Array4<amrex::Real >& Hzk,
818 const amrex::Array4<amrex::Real >& AK,
819 const amrex::Array4<amrex::Real const>& Akv,
820 const amrex::Array4<amrex::Real >& BC,
821 const amrex::Array4<amrex::Real >& DC,
822 const amrex::Array4<amrex::Real >& FC,
823 const amrex::Array4<amrex::Real >& CF,
824 const int nnew, const int N,
825 const amrex::Real dt_lev);
826
827 /** \brief Correct mass flux */
828 void update_massflux_3d (int lev, const amrex::Box& bx,
829 const int ioff, const int joff,
830 const amrex::Array4<amrex::Real >& phi,
831 const amrex::Array4<amrex::Real >& phibar,
832 const amrex::Array4<amrex::Real >& Hphi,
833 const amrex::Array4<amrex::Real const>& Hz,
834 const amrex::Array4<amrex::Real const>& pm_or_pn,
835 const amrex::Array4<amrex::Real const>& Dphi1,
836 const amrex::Array4<amrex::Real const>& Dphi2,
837 const amrex::Array4<amrex::Real >& DC,
838 const amrex::Array4<amrex::Real >& FC,
839 const amrex::Array4<amrex::Real const>& msk,
840 const int nnew);
841
842 /** \brief Adjust 3D momentum variables based on vertical mean momentum */
843 void vert_mean_3d (const amrex::Box& bx,
844 const int ioff, const int joff,
845 const amrex::Array4<amrex::Real >& phi,
846 const amrex::Array4<amrex::Real const>& Hz,
847 const amrex::Array4<amrex::Real const>& Dphi_avg1,
848 const amrex::Array4<amrex::Real >& DC,
849 const amrex::Array4<amrex::Real >& CF,
850 const amrex::Array4<amrex::Real const>& pm_or_pn,
851 const amrex::Array4<amrex::Real const>& msk,
852 const int nnew, const int N);
853
854 /** \brief Harmonic viscosity */
855 void uv3dmix (const amrex::Box& xbx,
856 const amrex::Box& ybx,
857 const amrex::Array4<amrex::Real >& u,
858 const amrex::Array4<amrex::Real >& v,
859 const amrex::Array4<amrex::Real const>& uold,
860 const amrex::Array4<amrex::Real const>& vold,
861 const amrex::Array4<amrex::Real >& rufrc,
862 const amrex::Array4<amrex::Real >& rvfrc,
863 const amrex::Array4<amrex::Real const>& visc2_p,
864 const amrex::Array4<amrex::Real const>& visc2_r,
865 const amrex::Array4<amrex::Real const>& Hz,
866 const amrex::Array4<amrex::Real const>& pm,
867 const amrex::Array4<amrex::Real const>& pn,
868 const amrex::Array4<amrex::Real const>& mskp,
869 int nrhs, int nnew,
870 const amrex::Real dt_lev);
871
872 /** \brief Wrapper for harmonic diffusivity for tracers */
873 void t3dmix2 (const amrex::Box& bx,
874 const amrex::Array4<amrex::Real >& state,
875 const amrex::Array4<amrex::Real >& state_rhs,
876 const amrex::Array4<amrex::Real const>& diff2,
877 const amrex::Array4<amrex::Real const>& Hz,
878 const amrex::Array4<amrex::Real const>& z_r,
879 const amrex::Array4<amrex::Real const>& pm,
880 const amrex::Array4<amrex::Real const>& pn,
881 const amrex::Array4<amrex::Real const>& msku,
882 const amrex::Array4<amrex::Real const>& mskv,
883 const amrex::Real dt_lev,
884 const int ncomp, const int N);
885
886 /** \brief Harmonic diffusivity for tracers along S-coordinate level surfaces */
887 void t3dmix2_s(const amrex::Box& bx,
888 const amrex::Array4<amrex::Real >& state,
889 const amrex::Array4<amrex::Real >& state_rhs,
890 const amrex::Array4<amrex::Real const>& diff2,
891 const amrex::Array4<amrex::Real const>& Hz,
892 const amrex::Array4<amrex::Real const>& pm,
893 const amrex::Array4<amrex::Real const>& pn,
894 const amrex::Array4<amrex::Real const>& msku,
895 const amrex::Array4<amrex::Real const>& mskv,
896 const amrex::Real dt_lev, const int ncomp);
897
898 /** \brief Harmonic diffusivity for tracers along geopotential surfaces */
899 void t3dmix2_geo (const amrex::Box& bx,
900 const amrex::Array4<amrex::Real >& state,
901 const amrex::Array4<amrex::Real >& state_rhs,
902 const amrex::Array4<amrex::Real const>& diff2,
903 const amrex::Array4<amrex::Real const>& Hz,
904 const amrex::Array4<amrex::Real const>& z_r,
905 const amrex::Array4<amrex::Real const>& pm,
906 const amrex::Array4<amrex::Real const>& pn,
907 const amrex::Array4<amrex::Real const>& msku,
908 const amrex::Array4<amrex::Real const>& mskv,
909 const amrex::Real dt_lev,
910 const int ncomp, const int N);
911
912 /** \brief Calculate Coriolis terms */
913 void coriolis (const amrex::Box& xbx,
914 const amrex::Box& ybx,
915 const amrex::Array4<amrex::Real const>& uold,
916 const amrex::Array4<amrex::Real const>& vold,
917 const amrex::Array4<amrex::Real >& ru,
918 const amrex::Array4<amrex::Real >& rv,
919 const amrex::Array4<amrex::Real const>& Hz,
920 const amrex::Array4<amrex::Real const>& fomn,
921 int nrhs, int nr);
922
923 /** \brief Apply climatology nudging */
924 void apply_clim_nudg (const amrex::Box& bx,
925 int ioff, int joff,
926 const amrex::Array4<amrex::Real >& var,
927 const amrex::Array4<amrex::Real const>& var_old,
928 const amrex::Array4<amrex::Real const>& var_clim,
929 const amrex::Array4<amrex::Real const>& clim_coeff,
930 const amrex::Array4<amrex::Real const>& Hz,
931 const amrex::Array4<amrex::Real const>& pm,
932 const amrex::Array4<amrex::Real const>& pn,
933 const amrex::Real dt_lev = amrex::Real(0.0));
934
935 /** \brief Set 2D momentum arrays from 3D momentum */
936 void set_2darrays (int lev);
937
938 /** \brief Set Zt_avg1 to zeta */
939 void set_zeta_average (int lev);
940
941 /** \brief Initialize zeta from file or analytic */
942 void set_zeta (int lev);
943
944 /** \brief Copy over zeta data that has been averaged down from high res */
945 void set_zeta_averaged_down (int lev);
946
947 /** \brief Initialize bathymetry from file or analytic */
948 void set_bathymetry (int lev);
949
950 /** \brief Copy over bathymetry data that has been averaged down from high resolution
951 * input netcdf file */
952 void set_bathymetry_averaged_down (int lev);
953
954 /** \brief Initialize Coriolis factor from file or analytic */
955 void set_coriolis (int lev);
956
957 /** \brief Initialize land-sea masks from file or analytic */
958 void set_masks (int lev);
959
960 /** \brief Calculate vertical stretched coordinates */
961 void stretch_transform (int lev);
962
963 /** \brief Initialize vertical mixing coefficients from file or analytic */
964 void init_set_vmix (int lev);
965 /** \brief Set vertical mixing coefficients from analytic */
966 void set_analytic_vmix (int lev);
967 /** \brief Initialize GLS variables */
968 void init_gls_vmix (int lev, SolverChoice solver_choice);
969 /** \brief Prestep for GLS calculation */
970 void gls_prestep (int lev, amrex::MultiFab* mf_gls, amrex::MultiFab* mf_tke,
971 amrex::MultiFab& mf_W,
972 amrex::MultiFab* mf_msku, amrex::MultiFab* mf_mskv,
973 const int nstp, const int nnew, const int iic, const int ntfirst,
974 const int N, const amrex::Real dt_lev);
975 /** \brief Corrector step for GLS calculation */
976 void gls_corrector (int lev, amrex::MultiFab* mf_gls, amrex::MultiFab* mf_tke,
977 amrex::MultiFab& mf_W, amrex::MultiFab* mf_Akv, amrex::MultiFab* mf_Akt,
978 amrex::MultiFab* mf_Akk, amrex::MultiFab* mf_Akp,
979 amrex::MultiFab* mf_mskr,
980 amrex::MultiFab* mf_msku, amrex::MultiFab* mf_mskv,
981 const int nstp, const int nnew,
982 const int N, const amrex::Real dt_lev);
983
984 /** \brief Scale RHS momentum variables by 1/cell area, needed before FillPatch to different levels*/
985 void scale_rhs_vars ();
986 /** \brief Scale RHS momentum variables by cell area, needed after FillPatch to different levels*/
987 void scale_rhs_vars_inv ();
988
989 /** \brief Initialize or calculate surface momentum flux from file or analytic */
990 void set_smflux (int lev);
991
992 /** \brief Initialize or calculate wind speed from file or analytic */
993 void set_wind (int lev);
994
995 /** \brief Initialize horizontal mixing coefficients */
996 void set_hmixcoef (int lev);
997
998 /** \brief Initialize flat bathymetry to value from problo */
999 void init_flat_bathymetry (int lev);
1000
1001 /** \brief Initialize or calculate bottom drag */
1002 void set_drag (int lev);
1003
1004 /** \brief Set weights for averaging 3D variables to 2D */
1005 void set_weights (int lev);
1006
1007 /** \brief Fill the physical boundary conditions for cell-centered velocity (diagnostic only) */
1008 void FillBdyCCVels (int lev, amrex::MultiFab& mf_cc_vel);
1009
1010 /** \brief Fill a new MultiFab by copying in phi from valid region and filling ghost cells */
1011 void FillPatch (int lev, amrex::Real time,
1012 amrex::MultiFab& mf_to_be_filled,
1013 amrex::Vector<amrex::MultiFab*> const& mfs,
1014 const int bccomp,
1015 const int bdy_var_type = BdyVars::null,
1016 const int icomp=0,
1017 const bool fill_all=true,
1018 const bool fill_set=true,
1019 const int n_not_fill=0,
1020 const int icomp_calc=0,
1021 const amrex::Real dt = amrex::Real(0.0),
1022 const amrex::MultiFab& mf_calc = amrex::MultiFab());
1023
1024 /** \brief Fill a new MultiFab by copying in phi from valid region and filling ghost cells without applying boundary conditions */
1025 void FillPatchNoBC (int lev, amrex::Real time,
1026 amrex::MultiFab& mf_to_be_filled,
1027 amrex::Vector<amrex::MultiFab*> const& mfs,
1028 const int bdy_var_type = BdyVars::null,
1029 const int icomp=0,
1030 const bool fill_all=true,
1031 const bool fill_set=true);
1032 /** \brief Fill boundary data from netcdf file */
1033 void fill_from_bdyfiles (int lev,
1034 amrex::MultiFab& mf_to_fill,
1035 const amrex::MultiFab& mf_mask,
1036 const amrex::Real time,
1037 const int bccomp,
1038 const int bdy_var_type,
1039 const int icomp_to_fill,
1040 const int icomp_calc = 0,
1041 const amrex::MultiFab& mf_calc = amrex::MultiFab(),
1042 const amrex::Real = amrex::Real(0.0));
1043
1044 /** \brief fill an entire multifab by interpolating from the coarser level
1045 * using the piecewise constant interpolater */
1046 void FillCoarsePatchPC (int lev, amrex::Real time, amrex::MultiFab* mf_fine,
1047 amrex::MultiFab* mf_crse,
1048 const int bccomp,
1049 const int bdy_var_type = BdyVars::null,
1050 const int icomp = 0,
1051 const bool fill_all = true,
1052 const int n_not_fill=0,
1053 const int icomp_calc=0,
1054 const amrex::Real dt = amrex::Real(0.0),
1055 const amrex::MultiFab& mf_calc = amrex::MultiFab());
1056
1057 /** \brief fill an entire multifab by interpolating from the coarser level */
1058 void FillCoarsePatch (int lev, amrex::Real time, amrex::MultiFab* mf_fine,
1059 amrex::MultiFab* mf_crse,
1060 const int bccomp,
1061 const int bdy_var_type = BdyVars::null,
1062 const int icomp = 0,
1063 const bool fill_all = true,
1064 const int n_not_fill=0,
1065 const int icomp_calc=0,
1066 const amrex::Real dt = amrex::Real(0.0),
1067 const amrex::MultiFab& mf_calc = amrex::MultiFab());
1068
1069 /** \brief fill an entire multifab by interpolating from the coarser level,
1070 * explicitly specifying interpolator to use */
1071 void FillCoarsePatchMap (int lev, amrex::Real time, amrex::MultiFab* mf_fine,
1072 amrex::MultiFab* mf_crse,
1073 const int bccomp,
1074 const int bdy_var_type = BdyVars::null,
1075 const int icomp = 0,
1076 const bool fill_all = true,
1077 const int n_not_fill=0,
1078 const int icomp_calc=0,
1079 const amrex::Real dt = amrex::Real(0.0),
1080 const amrex::MultiFab& mf_calc = amrex::MultiFab(),
1081 amrex::Interpolater* mapper = nullptr);
1082
1083 /** \brief initialize and calculate stretch coefficients */
1084 void init_stretch_coeffs ();
1085 /** \brief calculate vertical stretch coefficients */
1086 void calc_stretch_coeffs ();
1087
1088 /** \brief Calculate Coriolis parameters from beta plane parametrization */
1089 void init_beta_plane_coriolis (int lev);
1090
1091 /** \brief Full domain bathymetry data initialization from analytic */
1093
1094 /** \brief Problem initialization from averaged-down high resolution data */
1095 void set_init_data_averaged_down (int lev);
1096 /** \brief Problem initialization from NetCDF file */
1097 void init_data_from_netcdf (int lev);
1098 /** \brief High resolution roblem initialization from NetCDF file */
1100 /** \brief Boundary data initialization from NetCDF file */
1101 void init_bdry_from_netcdf (int lev);
1102 /** \brief Mask data initialization from NetCDF file */
1103 void init_masks_from_netcdf (int lev);
1104 /** \brief Bathymetry data initialization from NetCDF file */
1105 void init_bathymetry_from_netcdf (int lev);
1106 /** \brief Full domain high-res bathymetry data initialization from NetCDF file */
1108 /** \brief Grid variable initialization from NetCDF file */
1109 void init_grid_vars_from_netcdf (int lev);
1110 /** \brief Full domain high-res grid variable initialization from NetCDF file */
1112 /** \brief Sea-surface height data initialization from NetCDF file */
1113 void init_zeta_from_netcdf (int lev);
1114 /** \brief Full-domain high res sea-surface height data initialization from NetCDF file */
1116 /** \brief Coriolis parameter data initialization from NetCDF file */
1117 void init_coriolis_from_netcdf (int lev);
1118 /** \brief Climatology nudging coefficient initialization from NetCDF file */
1119 void init_clim_nudg_coeff_from_netcdf (int lev);
1120 /** \brief Wrapper to initialize climatology nudging coefficient */
1121 void init_clim_nudg_coeff (int lev);
1122 void init_riv_pos_from_netcdf (int lev);
1123
1124 /** \brief Allocate multifabs for storing full-domain bathymetry and grid vars data */
1126 /** \brief Allocate multifabs for storing full-domain high resolution initial data */
1128
1129 /** \brief Convert data in a multifab from inverse days to inverse seconds */
1130 void convert_inv_days_to_inv_s (amrex::MultiFab*);
1131
1132 /** \brief Mask data arrays before writing output */
1133 void mask_arrays_for_write (int lev, amrex::Real fill_value, amrex::Real fill_where);
1134
1135 /** \brief Average down from level lev+1 to lev in mf, including grow cells */
1136 void average_down_with_grow_cells(int lev, amrex::Vector<std::unique_ptr<amrex::MultiFab>>& mf);
1137
1138 int xvel_bc () const noexcept { return BCVars::xvel_bc(ncons); }
1139 int yvel_bc () const noexcept { return BCVars::yvel_bc(ncons); }
1140 int zvel_bc () const noexcept { return BCVars::zvel_bc(ncons); }
1141 int ubar_bc () const noexcept { return BCVars::ubar_bc(ncons); }
1142 int vbar_bc () const noexcept { return BCVars::vbar_bc(ncons); }
1143 int zeta_bc () const noexcept { return BCVars::zeta_bc(ncons); }
1144 int tke_bc () const noexcept { return BCVars::tke_bc(ncons); }
1146 int foextrap_bc () const noexcept { return BCVars::foextrap_bc(ncons); }
1147 int u2d_simple_bc () const noexcept { return BCVars::u2d_simple_bc(ncons); }
1148 int v2d_simple_bc () const noexcept { return BCVars::v2d_simple_bc(ncons); }
1149 int num_bc_vars () const noexcept { return BCVars::NumTypes(ncons); }
1150
1151
1152#ifdef REMORA_USE_NETCDF
1154#endif
1155
1156private:
1157
1158 ///////////////////////////
1159 // private member functions
1160 ///////////////////////////
1161
1162 /** \brief read in some parameters from inputs file */
1163 void ReadParameters();
1164
1165 /** \brief Build runtime scalar names after nscalar is known */
1166 void init_scalar_metadata();
1167
1168 /** \brief set covered coarse cells to be the average of overlying fine cells */
1169 void AverageDown ();
1170
1171 /** \brief Read in boundary parameters from input file and set up data structures */
1172 void init_bcs();
1173
1174 /** \brief Initialize initial problem data from analytic functions */
1175 void init_analytic(int lev);
1176 /** \brief Initialize high resolution initial problem data from analytic functions */
1178
1179 /** \brief Initialize high resolution initial sea surface height from analytic functions */
1181
1182 /** \brief Allocate MultiFabs for state and evolution variables */
1183 void init_stuff (int lev, const amrex::BoxArray& ba, const amrex::DistributionMapping& dm);
1184
1185 /** \brief Allocate MultiFabs for masks */
1186 void init_masks (int lev, const amrex::BoxArray& ba, const amrex::DistributionMapping& dm);
1187
1188 /** \brief Resize variable containers to accommodate data on levels 0 to max_lev */
1189 void resize_stuff (int lev);
1190
1191 /** \brief more flexible version of AverageDown() that lets you average down across multiple levels */
1192 void AverageDownTo (int crse_lev);
1193
1194 /** \brief Construct FillPatchers */
1195 void Construct_REMORAFillPatchers (int lev);
1196
1197 /** \brief Define FillPatchers */
1198 void Define_REMORAFillPatchers (int lev);
1199
1200 /** \brief utility to copy in data from old and/or new state into another multifab */
1201 TimeInterpolatedData GetDataAtTime (int lev, amrex::Real time);
1202
1203 /** \brief advance a level by dt, includes a recursive call for finer levels */
1204 void timeStep (int lev, amrex::Real time, int iteration);
1205
1206 /** \brief advance all levels by dt, loops over finer levels */
1207 void timeStepML (amrex::Real time, int iteration);
1208
1209 /** \brief a wrapper for estTimeStep() */
1210 void ComputeDt ();
1211
1212 /** \brief get plotfile name */
1213 std::string PlotFileName (int lev) const;
1214
1215 /* set which variables and derived quantities go into plotfiles */
1216 void set2DPlotVariables (const std::string& pp_plot_var_names_2d);
1217 void set3DPlotVariables (const std::string& pp_plot_var_names_3d);
1218
1219 /* append variables to plot */
1220 void append2DPlotVariables (const std::string& pp_plot_var_names_2d);
1221 void append3DPlotVariables (const std::string& pp_plot_var_names_3d);
1222
1223#ifdef REMORA_USE_NETCDF
1224 /** \brief Write plotfile using NetCDF (wrapper) */
1225 void WriteNCPlotFile (int istep, amrex::MultiFab const* plotMF);
1226
1227 /** \brief Write a particular NetCDF plotfile */
1228 void WriteNCPlotFile_which (int lev, int which_subdomain,
1229 amrex::MultiFab const* plotMF,
1230 bool write_header, ncutils::NCFile& ncf,
1231 bool is_history);
1232
1233 /** \brief Write MultiFab in NetCDF format */
1234 void WriteNCMultiFab (const amrex::FabArray<amrex::FArrayBox> &fab,
1235 const std::string& name,
1236 bool set_ghost = false) const;
1237
1238 /** \brief Read MultiFab in NetCDF format */
1239 void ReadNCMultiFab (amrex::FabArray<amrex::FArrayBox> &fab,
1240 const std::string &name,
1241 int coordinatorProc = amrex::ParallelDescriptor::IOProcessorNumber(),
1242 int allow_empty_mf = 0);
1243
1244 /** \brief Start time in the time series of boundary data */
1245 amrex::Real start_bdy_time;
1246 /** \brief Interval between boundary data times */
1248
1249 /** \brief Whether to output NetCDF files as a single history file with several time steps */
1251
1252 /** \brief Data container for u-component surface momentum flux read from file */
1253 std::unique_ptr<NCTimeSeries> sustr_data_from_file;
1254 /** \brief Data container for v-component surface momentum flux read from file */
1255 std::unique_ptr<NCTimeSeries> svstr_data_from_file;
1256 /** \brief Data container for u-direction wind read from file */
1257 std::unique_ptr<NCTimeSeries> Uwind_data_from_file;
1258 /** \brief Data container for v-direction wind read from file */
1259 std::unique_ptr<NCTimeSeries> Vwind_data_from_file;
1260 /** \brief Data container for air temperature read from file */
1261 std::unique_ptr<NCTimeSeries> Tair_data_from_file;
1262 /** \brief Data container for specific humidity read from file */
1263 std::unique_ptr<NCTimeSeries> qair_data_from_file;
1264 /** \brief Data container for air pressure read from file */
1265 std::unique_ptr<NCTimeSeries> Pair_data_from_file;
1266 /** \brief Data container for shortwave radiation flux read from file */
1267 std::unique_ptr<NCTimeSeries> srflx_data_from_file;
1268 /** \brief Data container for downward longwave radiation flux read from file */
1269 std::unique_ptr<NCTimeSeries> longwave_down_data_from_file;
1270 /** \brief Data container for precipitation rate read from file */
1271 std::unique_ptr<NCTimeSeries> rain_data_from_file;
1272 /** \brief Data container for cloud cover fraction read from file */
1273 std::unique_ptr<NCTimeSeries> cloud_data_from_file;
1274 /** \brief Data container for evaporation minus precipitation read from file */
1275 std::unique_ptr<NCTimeSeries> EminusP_data_from_file;
1276
1277 /** \brief Data container for ubar climatology data read from file */
1278 std::unique_ptr<NCTimeSeries> ubar_clim_data_from_file;
1279 /** \brief Data container for vbar climatology data read from file */
1280 std::unique_ptr<NCTimeSeries> vbar_clim_data_from_file;
1281 /** \brief Data container for u-velocity climatology data read from file */
1282 std::unique_ptr<NCTimeSeries> u_clim_data_from_file;
1283 /** \brief Data container for v-velocity climatology data read from file */
1284 std::unique_ptr<NCTimeSeries> v_clim_data_from_file;
1285 /** \brief Data container for temperature climatology data read from file */
1286 std::unique_ptr<NCTimeSeries> temp_clim_data_from_file;
1287 /** \brief Data container for salinity climatology data read from file */
1288 std::unique_ptr<NCTimeSeries> salt_clim_data_from_file;
1289
1290 /** \brief Vector of data containers for scalar data in rivers */
1291 amrex::Vector<std::unique_ptr<NCTimeSeriesRiver>> river_source_cons;
1292 /** \brief Data container for momentum transport in rivers */
1293 std::unique_ptr<NCTimeSeriesRiver> river_source_transport;
1294 /** \brief Data container for vertically integrated momentum transport in rivers */
1295 std::unique_ptr<NCTimeSeriesRiver> river_source_transportbar;
1296
1297 /** \brief Vector over BdyVars of boundary series data containers */
1298 amrex::Vector<amrex::Vector<std::unique_ptr<NCTimeSeriesBoundary>>> boundary_series;
1299
1300#endif // REMORA_USE_NETCDF
1301 /** \brief iMultiFab for river positions; contents are indices of rivers */
1302 amrex::Vector<std::unique_ptr<amrex::iMultiFab>> vec_river_position;
1303 /** \brief Vector over rivers of river direction: 0: u-face; 1: v-face; 2: w-face */
1304 amrex::Gpu::DeviceVector<int> river_direction;
1305
1306
1307#ifdef REMORA_USE_MOAB
1308 /** \brief Initialize connection to MOAB */
1309 void InitMOABMesh();
1310#endif
1311 /** \brief Nudging width at coarse-fine interface */
1312 int cf_width{0};
1313 /** \brief Width for fixing values at coarse-fine interface */
1315 // Fillpatcher classes for coarse-fine boundaries
1316 /** \brief Vector over levels of FillPatchers for scalars */
1317 amrex::Vector<REMORAFillPatcher> FPr_c;
1318 /** \brief Vector over levels of FillPatchers for u (3D) */
1319 amrex::Vector<REMORAFillPatcher> FPr_u;
1320 /** \brief Vector over levels of FillPatchers for v (3D) */
1321 amrex::Vector<REMORAFillPatcher> FPr_v;
1322 /** \brief Vector over levels of FillPatchers for w */
1323 amrex::Vector<REMORAFillPatcher> FPr_w;
1324
1325 // Fillpatcher classes for 2d velocity variables
1326 /** \brief Vector over levels of FillPatchers for ubar (2D) */
1327 amrex::Vector<REMORAFillPatcher> FPr_ubar;
1328 /** \brief Vector over levels of FillPatchers for vbar (2D) */
1329 amrex::Vector<REMORAFillPatcher> FPr_vbar;
1330
1331 /** \brief write checkpoint file to disk */
1332 void WriteCheckpointFile ();
1333
1334 /** \brief read checkpoint file from disk */
1335 void ReadCheckpointFile ();
1336
1337 /** \brief Read the file passed to remora.restart and use it as an initial condition for the current simulation */
1339
1340 /** \brief Initialize the new-time data at a level from the initial_data MultiFab */
1341 void InitializeLevelFromData (int lev, const amrex::MultiFab& initial_data);
1342
1343 /** \brief utility to skip to next line in Header */
1344 static void GotoNextLine (std::istream& is);
1345
1346 ////////////////
1347 // private data members
1348
1349 /** \brief Pointer to container of analytical functions for problem definition */
1350 std::unique_ptr<ProblemBase> prob = nullptr;
1351
1352 /** \brief how many boxes specified at each level by tagging criteria */
1353 amrex::Vector<int> num_boxes_at_level;
1354 /** \brief how many netcdf input files specified at each level */
1355 amrex::Vector<int> num_files_at_level;
1356 /** \brief the boxes specified at each level by tagging criteria */
1357 amrex::Vector<amrex::Vector<amrex::Box>> boxes_at_level;
1358
1359 /** \brief which step? */
1360 amrex::Vector<int> istep;
1361 /** \brief How many substeps on each level? */
1362 amrex::Vector<int> nsubsteps;
1363 /** \brief new time at each level */
1364 amrex::Vector<amrex::Real> t_new;
1365 /** \brief old time at each level */
1366 amrex::Vector<amrex::Real> t_old;
1367 /** \brief time step at each level */
1368 amrex::Vector<amrex::Real> dt;
1369
1370 /** \brief whether to set boundary conditions by variable rather than just by side */
1372
1373 /** \brief Vector (over level) of functors to apply physical boundary conditions */
1374 amrex::Vector<std::unique_ptr<REMORAPhysBCFunct>> physbcs;
1375
1376 /** \brief array of flux registers for refluxing in multilevel */
1377 amrex::Vector<std::unique_ptr<amrex::YAFluxRegister>> advflux_reg;
1378
1379 ////////////////
1380 // boundary data members
1381
1382 // A BCRec is essentially a 2*DIM integer array storing the boundary
1383 // condition type at each lo/hi walls in each direction. We have one BCRec
1384 // for each component of the cell-centered variables and each velocity component.
1385 /** \brief vector (over BCVars) of BCRecs */
1386 amrex::Vector <amrex::BCRec> domain_bcs_type;
1387 /** \brief GPU vector (over BCVars) of BCRecs */
1388 amrex::Gpu::DeviceVector<amrex::BCRec> domain_bcs_type_d;
1389
1390 /** \brief Array of strings describing domain boundary conditions */
1391 amrex::Array<std::string,2*AMREX_SPACEDIM> domain_bc_type;
1392
1393 /** \brief Array holding the Dirichlet values at walls which need them */
1394 amrex::Vector<amrex::GpuArray<amrex::Real, AMREX_SPACEDIM*2>> m_bc_extdir_vals;
1395
1396 /** \brief Array holding the "physical" boundary condition types (e.g. "inflow") */
1397 amrex::Vector<amrex::GpuArray<REMORA_BC, AMREX_SPACEDIM*2>> phys_bc_type;
1398
1399 /** \brief These are flags that indicate whether we need to read in boundary data from file */
1400 amrex::GpuArray<amrex::GpuArray<bool, AMREX_SPACEDIM*2>,BdyVars::NumTypes+1> phys_bc_need_data;
1401
1402 /** \brief Container to connect boundary data being read in boundary condition containers.
1403 *
1404 * Needed for phys_bc_need_data to work correctly
1405 */
1406 amrex::Vector<int> bdy_index;
1407
1408 /** \brief Step when we last output a plotfile */
1410 /** \brief Simulation time when we last output a plotfile */
1412
1413 /** \brief Step when we last output a checkpoint file */
1415 /** \brief Simulation time when we last output a checkpoint file */
1417 /** \brief Whether to output a plotfile on restart from checkpoint */
1419
1420 ////////////////
1421 // runtime parameters
1422
1423 /** \brief maximum number of steps */
1424 int max_step = std::numeric_limits<int>::max();
1425 /** \brief Time to stop */
1426 amrex::Real stop_time = std::numeric_limits<amrex::Real>::max();
1427
1428 /** \brief Time of the start of the simulation, in seconds */
1429 amrex::Real start_time = 0.0;
1430
1431 /** \brief If set, restart from this checkpoint file */
1432 std::string restart_chkfile = "";
1433
1434 /** \brief Number of passive scalars carried in the state */
1435 int nscalar = 1;
1436 /** \brief Number of conserved scalars in the state (temperature + salt + passive scalars) */
1438
1439 // Time step controls
1440 /** \brief CFL condition */
1441 static amrex::Real cfl;
1442 /** \brief Fraction maximum change in subsequent time steps */
1443 static amrex::Real change_max;
1444 /** \brief User specified fixed baroclinic time step */
1445 static amrex::Real fixed_dt;
1446 /** \brief User specified fixed barotropic time step */
1447 static amrex::Real fixed_fast_dt;
1448 /** \brief User specified, number of barotropic steps per baroclinic step */
1450 /** \brief Number of fast steps to take */
1452
1453 /** \brief Whether to substep fine levels in time */
1454 int do_substep = 0;
1455
1456 /** \brief how often each level regrids the higher levels of refinement (after a level advances that many time steps) */
1457 int regrid_int = 2;
1458
1459 // I/O controls
1460 /** \brief Plotfile prefix */
1461 std::string plot_file_name {"plt_"};
1462 /** \brief Plotfile output interval in iterations */
1463 int plot_int = -1;
1464 /** \brief Plotfile output interval in seconds */
1465 amrex::Real plot_int_time = amrex::Real(-1.0);
1466 /** \brief Checkpoint file prefix */
1467 std::string check_file {"chk"};
1468 /** \brief Checkpoint output interval in iterations */
1469 int check_int = -1;
1470 /** \brief Checkpoint output interval in seconds */
1471 amrex::Real check_int_time = amrex::Real(-1.0);
1472
1473 /** \brief Whether to chunk netcdf history file */
1475 /** \brief Number of time steps per netcdf history file.
1476 *
1477 -1 is the default and means code will automatically compute
1478 number of steps per file based on grid size to keep files < 2 GB */
1480 /** \brief Counter for which time index we are writing to in the netcdf history file */
1482
1483 /** \brief Names of 3D variables to output to AMReX plotfile */
1484 amrex::Vector<std::string> plot_var_names_3d;
1485 /** \brief Names of 2D variables to output to AMReX plotfile */
1486 amrex::Vector<std::string> plot_var_names_2d;
1487 /** \brief Names of scalars for plotfile output */
1488 amrex::Vector<std::string> cons_names {"temp", "salt", "tracer"};
1489 // Note that the order of variable names here must match the order in PlotFile.cpp
1490 /** \brief Names of derived fields for plotfiles */
1491 const amrex::Vector<std::string> derived_names {"vorticity"};
1492
1493 /** \brief Container for algorithmic choices */
1495
1496 /** \brief whether plotfile variables should be expanded to a uniform refinement ratio */
1498
1499 /** \brief fill value for masked arrays in amrex plotfiles */
1500 amrex::Real plotfile_fill_value = amrex::Real(0.0);
1501 /** \brief fill value for masked arrays in netcdf output */
1502 amrex::Real netcdf_fill_value = amrex::Real(1.0e37);
1503
1504
1505#ifdef REMORA_USE_PARTICLES
1506 /** \brief Particle container with all particle species */
1507 ParticleData particleData;
1508
1509 // variables and functions for tracers particles
1510 /** \brief tracer particles that advect with flow */
1511 bool m_use_tracer_particles;
1512 /** \brief tracer particles that fall with gravity */
1513 bool m_use_hydro_particles;
1514
1515 /** \brief Read tracer and hydro particles parameters */
1516 void readTracersParams();
1517
1518 /** \brief Initialize tracer and hydro particles */
1519 void initializeTracers ( amrex::ParGDBBase*,
1520 const amrex::Vector<std::unique_ptr<amrex::MultiFab>>& );
1521
1522 /** \brief Evolve tracers and hydro particles */
1523 void evolveTracers( int lev,
1524 amrex::Real dt,
1525 amrex::Vector<amrex::MultiFab const*>& flow_vel,
1526 const amrex::Vector<std::unique_ptr<amrex::MultiFab>>& );
1527
1528#endif
1529 /** \brief Verbosity level of output */
1530 static int verbose;
1531
1532 /** \brief Diagnostic sum output interval in number of steps */
1533 static int sum_interval;
1534 /** \brief Diagnostic sum output interval in time */
1535 static amrex::Real sum_per;
1536
1537 /** \brief Minimum number of digits in plotfile name or chunked history file */
1539
1540 /** \brief Whether to write the staggered velocities (not averaged to cell centers) */
1542
1543 /** \brief Native or NetCDF plotfile output */
1545
1546 /** \brief NetCDF initialization file */
1547 static amrex::Vector<amrex::Vector<std::string>> nc_init_file;
1548 /** \brief NetCDF grid file */
1549 static amrex::Vector<amrex::Vector<std::string>> nc_grid_file;
1550 /** \brief NetCDF boundary data */
1551 static amrex::Vector<std::string> nc_bdry_file;
1552
1553 /** \brief Which level the high resolution bathymetry is at */
1555 /** \brief Grid file for high resolution bathymetry */
1557 /** \brief Box for the full domain at nc_hires_grid_level */
1559
1560 /** \brief Which level the high resolution initialization data is at */
1562 /** \brief Init file for high resolution */
1564 /** \brief Box for the full domain at nc_hires_init_level */
1566
1567 /** \brief Cumulative refinement ratio between level 0 and level i */
1568 amrex::Vector<amrex::IntVect> cum_ref_ratios;
1569
1570 /** \brief NetCDF forcing file(s) */
1571 amrex::Vector<std::string> nc_frc_file;
1572 /** \brief NetCDF river file(s) */
1573 amrex::Vector<std::string> nc_riv_file;
1574
1575 /** \brief NetCDF climatology history file(s) */
1576 amrex::Vector<std::string> nc_clim_his_file;
1577 /** \brief NetCDF climatology coefficient file */
1579
1580 /** \brief Default name of time field for boundary data */
1581 std::string bdry_time_varname = "ocean_time";
1582 /** \brief Name of time fields for boundary data */
1583 amrex::Vector<std::string> bdry_time_name_byvar;
1584
1585 /** \brief Name of time field for ubar climatology data */
1586 std::string clim_ubar_time_varname = "ocean_time";
1587 /** \brief Name of time field for vbar climatology data */
1588 std::string clim_vbar_time_varname = "ocean_time";
1589 /** \brief Name of time field for u climatology data */
1590 std::string clim_u_time_varname = "ocean_time";
1591 /** \brief Name of time field for v climatology data */
1592 std::string clim_v_time_varname = "ocean_time";
1593 /** \brief Name of time field for salinity climatology data */
1594 std::string clim_salt_time_varname = "ocean_time";
1595 /** \brief Name of time field for temperature climatology data */
1596 std::string clim_temp_time_varname = "ocean_time";
1597 /** \brief Name of time field for river time */
1598 std::string riv_time_varname = "river_time";
1599 /** \brief Name of time field for forcing data */
1600 std::string frc_time_varname = "";
1601
1602 /** \brief Set refinement criteria */
1604
1605 /** \brief Holds info for dynamically generated tagging criteria */
1606 static amrex::Vector<amrex::AMRErrorTag> ref_tags;
1607
1608 /** \brief Mask that zeroes out values on a coarse level underlying grids on the next finest level */
1609 amrex::MultiFab fine_mask;
1610
1611 /** \brief Helper function to determine number of ghost cells */
1612 AMREX_FORCE_INLINE
1613 int
1614 ComputeGhostCells(const int& spatial_order) {
1615 int nGhostCells = 0;
1616 switch (spatial_order) {
1617 case 2:
1618 nGhostCells = 2; // We need this many to compute the eddy viscosity in the ghost cells
1619 break;
1620 case 3:
1621 nGhostCells = 2;
1622 break;
1623 case 4:
1624 nGhostCells = 2;
1625 break;
1626 case 5:
1627 nGhostCells = 3;
1628 break;
1629 case 6:
1630 nGhostCells = 3;
1631 break;
1632 default:
1633 amrex::Error("Must specify spatial order to be 2,3,4,5 or 6");
1634 }
1635
1636 return nGhostCells;
1637 }
1638
1639 /** \brief Helper function for IO stream */
1640 AMREX_FORCE_INLINE
1641 std::ostream&
1642 DataLog (int i)
1643 {
1644 return *datalog[i];
1645 }
1646
1647 AMREX_FORCE_INLINE
1648 int
1649 NumDataLogs () noexcept
1650 {
1651 return datalog.size();
1652 }
1653
1654 /** \brief Variable for CPU timing */
1655 static amrex::Real startCPUTime;
1656 /** \brief Accumulator variable for CPU time used thusfar */
1657 static amrex::Real previousCPUTimeUsed;
1658
1659 /** \brief Get CPU time used */
1660 amrex::Real
1662 {
1663 int numCores = amrex::ParallelDescriptor::NProcs();
1664#ifdef _OPENMP
1665 numCores = numCores * omp_get_max_threads();
1666#endif
1667
1668 amrex::Real T =
1669 numCores * (amrex::Real(amrex::ParallelDescriptor::second()) - startCPUTime) +
1671
1672 return T;
1673 }
1674
1675 void setRecordDataInfo (int i, const std::string& filename)
1676 {
1677 if (amrex::ParallelDescriptor::IOProcessor())
1678 {
1679 datalog[i] = std::make_unique<std::fstream>();
1680 datalog[i]->open(filename.c_str(),std::ios::out|std::ios::app);
1681 if (!datalog[i]->good()) {
1682 amrex::FileOpenFailed(filename);
1683 }
1684 }
1685 amrex::ParallelDescriptor::Barrier("REMORA::setRecordDataInfo");
1686 }
1687
1688 amrex::Vector<std::unique_ptr<std::fstream> > datalog;
1689 amrex::Vector<std::string> datalogname;
1690
1691 /** \brief The filename of the ith datalog file. */
1692 const std::string DataLogName (int i) const noexcept { return datalogname[i]; }
1693
1694public:
1695 /** \brief Write job info to stdout */
1696 void writeJobInfo (const std::string& dir) const;
1697 /** \brief Write build info to os */
1698 static void writeBuildInfo (std::ostream& os);
1699
1700 static void print_banner(MPI_Comm /*comm*/, std::ostream& /*out*/);
1701 static void print_usage(MPI_Comm /*comm*/, std::ostream& /*out*/);
1702 static void print_error(MPI_Comm /*comm*/, const std::string& msg);
1703 static void print_summary(std::ostream&);
1704 static void print_tpls(std::ostream& /*out*/);
1705
1706 /** \brief Accessor method for t_old to expose to outside classes */
1707 amrex::Real get_t_old(int lev) const;
1708
1709 /** \brief Evaluate stability function psi for wind speed */
1710 AMREX_GPU_HOST_DEVICE AMREX_FORCE_INLINE
1711 static amrex::Real bulk_psiu(amrex::Real ZoL) {
1712 // Compute stability function, psi
1713 using namespace amrex;
1714
1715 Real psiu;
1716 if (ZoL < 0.0_rt) {
1717 // Unstable conditions.
1718 Real x = std::pow(1.0_rt-15.0_rt*ZoL,0.25_rt);
1719 Real psik = 2.0_rt*std::log(0.5_rt*(1.0_rt+x))+
1720 std::log(0.5_rt*(1.0_rt+x*x))-
1721 2.0_rt*std::atan(x)+0.5_rt*PI;
1722 // For very unstable conditions, use free-convection (Fairall).
1723 Real sqrt3 = std::sqrt(3.0_rt);
1724 Real y = std::pow(1.0_rt-10.15_rt*ZoL,1.0_rt/3.0_rt);
1725 Real psic = 1.5_rt*std::log(1.0_rt/3.0_rt*(1.0_rt+y+y*y))-
1726 sqrt3*std::atan((1.0_rt+2.0_rt*y)/sqrt3)+PI/sqrt3;
1727 // Match Kansas and free-convection forms with weighting Fw.
1728 Real Zol2 = ZoL*ZoL;
1729 Real Fw = Zol2/(1.0_rt+Zol2);
1730
1731 psiu = (1.0_rt-Fw)*psik+Fw*psic;
1732 } else {
1733 // Stable conditions
1734 Real cff=std::min(50.0_rt,0.35_rt*ZoL);
1735 psiu = -((1.0_rt+ZoL)+0.6667_rt*(ZoL-14.28_rt)/
1736 std::exp(cff)+8.525_rt);
1737 }
1738 return psiu;
1739 }
1740
1741 /** \brief Evaluate stability function psi for moisture and heat */
1742 AMREX_GPU_HOST_DEVICE AMREX_FORCE_INLINE
1743 static amrex::Real bulk_psit(amrex::Real ZoL) {
1744 // Compute stability function, psi
1745 using namespace amrex;
1746
1747 Real psit;
1748 if (ZoL < 0.0_rt) {
1749 // Unstable conditions.
1750 Real x = std::pow(1.0_rt-15.0_rt*ZoL,0.5_rt);
1751 Real psik = 2.0_rt*std::log(0.5_rt*(1.0_rt+x));
1752 // For very unstable conditions, use free-convection (Fairall).
1753 Real sqrt3=std::sqrt(3.0_rt);
1754 Real y=std::pow(1.0_rt-34.15_rt*ZoL,1.0_rt/3.0_rt);
1755 Real psic=1.5_rt*std::log(1.0_rt/3.0_rt*(1.0_rt+y+y*y))-
1756 sqrt3*std::atan((1.0_rt+2.0_rt*y)/sqrt3)+PI/sqrt3;
1757
1758 // Match Kansas and free-convection forms with weighting Fw.
1759 Real ZoL2=ZoL*ZoL;
1760 Real Fw=ZoL2/(1.0_rt+ZoL2);
1761 psit = (1.0_rt-Fw)*psik+Fw*psic;
1762 } else {
1763 // Stable conditions.
1764 Real cff=std::min(50.0_rt,0.35_rt*ZoL);
1765 psit=-(std::pow(1.0_rt+2.0_rt*ZoL,1.5_rt)+
1766 0.6667_rt*(ZoL-14.28_rt)/std::exp(cff)+8.525_rt);
1767 }
1768 return psit;
1769 }
1770};
1771
1772#endif
constexpr amrex::Real PI
PlotfileType
plotfile format
#define Tracer_comp
A class to hold and interpolate time series data read from a NetCDF file.
A class to hold and interpolate time series data read from a NetCDF file.
Class that stores all relevant simulation state data with methods for time stepping.
Definition REMORA.H:91
static PlotfileType plotfile_type
Native or NetCDF plotfile output.
Definition REMORA.H:1544
std::string nc_grid_file_hires
Grid file for high resolution bathymetry.
Definition REMORA.H:1556
void FillCoarsePatchPC(int lev, amrex::Real time, amrex::MultiFab *mf_fine, amrex::MultiFab *mf_crse, const int bccomp, const int bdy_var_type=BdyVars::null, const int icomp=0, const bool fill_all=true, const int n_not_fill=0, const int icomp_calc=0, const amrex::Real dt=amrex::Real(0.0), const amrex::MultiFab &mf_calc=amrex::MultiFab())
fill an entire multifab by interpolating from the coarser level using the piecewise constant interpol...
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_EminusP
evaporation minus precipitation [kg/m^2/s], defined at rho-points
Definition REMORA.H:417
amrex::Vector< std::string > nc_riv_file
NetCDF river file(s)
Definition REMORA.H:1573
void set_grid_vars_averaged_down(int lev)
Set pm/pn by averaging down from higher-resolution grid.
Definition REMORA.cpp:681
std::string riv_time_varname
Name of time field for river time.
Definition REMORA.H:1598
void PackSurfaceState(amrex::Vector< amrex::MultiFab * > &state, amrex::Real time)
Extracts SST from the 3D conservative state for the atmospheric driver.
int foextrap_periodic_bc() const noexcept
Definition REMORA.H:1145
static void GotoNextLine(std::istream &is)
utility to skip to next line in Header
int nfast
Number of fast steps to take.
Definition REMORA.H:1451
amrex::Vector< std::string > nc_clim_his_file
NetCDF climatology history file(s)
Definition REMORA.H:1576
int ncons
Number of conserved scalars in the state (temperature + salt + passive scalars)
Definition REMORA.H:1437
void WriteNCMultiFab(const amrex::FabArray< amrex::FArrayBox > &fab, const std::string &name, bool set_ghost=false) const
Write MultiFab in NetCDF format.
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_zeta_full_domain
high resolution initial free surface height (2D)
Definition REMORA.H:456
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_rv2d
v velocity RHS (2D, includes horizontal and vertical advection)
Definition REMORA.H:332
std::string nc_init_file_hires
Init file for high resolution.
Definition REMORA.H:1563
void prsgrd(const amrex::Box &bx, const amrex::Box &gbx, const amrex::Box &utbx, const amrex::Box &vtbx, const amrex::Array4< amrex::Real > &ru, const amrex::Array4< amrex::Real > &rv, const amrex::Array4< amrex::Real const > &pn, const amrex::Array4< amrex::Real const > &pm, const amrex::Array4< amrex::Real const > &rho, const amrex::Array4< amrex::Real > &FC, const amrex::Array4< amrex::Real const > &Hz, const amrex::Array4< amrex::Real const > &z_r, const amrex::Array4< amrex::Real const > &z_w, const amrex::Array4< amrex::Real const > &msku, const amrex::Array4< amrex::Real const > &mskv, const int nrhs, const int N)
Calculate pressure gradient.
static amrex::Real fixed_dt
User specified fixed baroclinic time step.
Definition REMORA.H:1445
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_evap
evaporation rate [kg/m^2/s]
Definition REMORA.H:413
amrex::Real last_plot_file_time
Simulation time when we last output a plotfile.
Definition REMORA.H:1411
void update_massflux_3d(int lev, const amrex::Box &bx, const int ioff, const int joff, const amrex::Array4< amrex::Real > &phi, const amrex::Array4< amrex::Real > &phibar, const amrex::Array4< amrex::Real > &Hphi, const amrex::Array4< amrex::Real const > &Hz, const amrex::Array4< amrex::Real const > &pm_or_pn, const amrex::Array4< amrex::Real const > &Dphi1, const amrex::Array4< amrex::Real const > &Dphi2, const amrex::Array4< amrex::Real > &DC, const amrex::Array4< amrex::Real > &FC, const amrex::Array4< amrex::Real const > &msk, const int nnew)
Correct mass flux.
void scale_rhs_vars()
Scale RHS momentum variables by 1/cell area, needed before FillPatch to different levels.
int zvel_bc() const noexcept
Definition REMORA.H:1140
void init_full_domain_zeta_from_analytic()
Initialize high resolution initial sea surface height from analytic functions.
void init_bathymetry_from_netcdf(int lev)
Bathymetry data initialization from NetCDF file.
void init_bcs()
Read in boundary parameters from input file and set up data structures.
int xvel_bc() const noexcept
Definition REMORA.H:1138
amrex::Vector< amrex::BCRec > domain_bcs_type
vector (over BCVars) of BCRecs
Definition REMORA.H:1386
bool set_bcs_by_var
whether to set boundary conditions by variable rather than just by side
Definition REMORA.H:1371
void set_zeta_averaged_down(int lev)
Copy over zeta data that has been averaged down from high res.
Definition REMORA.cpp:699
void calculate_nodal_masks(int lev)
Calculate u-, v-, and psi-point masks based on rho-point masks after analytic initialization.
std::unique_ptr< NCTimeSeries > qair_data_from_file
Data container for specific humidity read from file.
Definition REMORA.H:1263
static amrex::Real previousCPUTimeUsed
Accumulator variable for CPU time used thusfar.
Definition REMORA.H:1657
amrex::Vector< std::string > cons_names
Names of scalars for plotfile output.
Definition REMORA.H:1488
amrex::Vector< std::unique_ptr< amrex::YAFluxRegister > > advflux_reg
array of flux registers for refluxing in multilevel
Definition REMORA.H:1377
std::unique_ptr< NCTimeSeries > sustr_data_from_file
Data container for u-component surface momentum flux read from file.
Definition REMORA.H:1253
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_fcor
coriolis factor (2D)
Definition REMORA.H:480
void allocate_init_full_domain()
Allocate multifabs for storing full-domain high resolution initial data.
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_btflux
Bottom tracer flux; input arrays.
Definition REMORA.H:408
void init_gls_vmix(int lev, SolverChoice solver_choice)
Initialize GLS variables.
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_rubar
barotropic x velocity for the RHS (2D)
Definition REMORA.H:443
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_xvel_full_domain
multilevel data container for high res initial x velocities (u in ROMS)
Definition REMORA.H:305
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_h
multilevel data container for current step's z velocities (largely unused; W stored separately)
Definition REMORA.H:314
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_pm
horizontal scaling factor: 1 / dx (2D)
Definition REMORA.H:470
amrex::MultiFab fine_mask
Mask that zeroes out values on a coarse level underlying grids on the next finest level.
Definition REMORA.H:1609
void set2DPlotVariables(const std::string &pp_plot_var_names_2d)
amrex::Vector< REMORAFillPatcher > FPr_v
Vector over levels of FillPatchers for v (3D)
Definition REMORA.H:1321
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_ZoBot
Bottom roughness length [m], defined at rho points.
Definition REMORA.H:427
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_DU_avg2
correct time average of barotropic x velocity flux for coupling (2D)
Definition REMORA.H:437
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_lrflx
longwave radiation
Definition REMORA.H:393
void init_zeta_full_domain_from_netcdf()
Full-domain high res sea-surface height data initialization from NetCDF file.
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_yv
y_grid on v-points (2D)
Definition REMORA.H:495
static void print_error(MPI_Comm, const std::string &msg)
amrex::Vector< amrex::MultiFab * > cons_new
multilevel data container for current step's scalar data: temperature, salinity, passive tracer
Definition REMORA.H:294
static bool write_history_file
Whether to output NetCDF files as a single history file with several time steps.
Definition REMORA.H:1250
virtual void MakeNewLevelFromCoarse(int lev, amrex::Real time, const amrex::BoxArray &ba, const amrex::DistributionMapping &dm) override
Make a new level using provided BoxArray and DistributionMapping and fill with interpolated coarse le...
void FillCoarsePatch(int lev, amrex::Real time, amrex::MultiFab *mf_fine, amrex::MultiFab *mf_crse, const int bccomp, const int bdy_var_type=BdyVars::null, const int icomp=0, const bool fill_all=true, const int n_not_fill=0, const int icomp_calc=0, const amrex::Real dt=amrex::Real(0.0), const amrex::MultiFab &mf_calc=amrex::MultiFab())
fill an entire multifab by interpolating from the coarser level
int tke_bc() const noexcept
Definition REMORA.H:1144
void stretch_transform(int lev)
Calculate vertical stretched coordinates.
std::unique_ptr< NCTimeSeries > rain_data_from_file
Data container for precipitation rate read from file.
Definition REMORA.H:1271
amrex::Gpu::DeviceVector< amrex::Real > s_w
Scaled vertical coordinate (range [0,1]) that transforms to z, defined at w-points (cell faces)
Definition REMORA.H:356
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_vwind
Wind in the v direction, defined at rho-points.
Definition REMORA.H:382
std::unique_ptr< ProblemBase > prob
Pointer to container of analytical functions for problem definition.
Definition REMORA.H:1350
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_mskr
land/sea mask at cell centers (2D)
Definition REMORA.H:459
void Construct_REMORAFillPatchers(int lev)
Construct FillPatchers.
Definition REMORA.cpp:463
void advance_3d(int lev, amrex::MultiFab &mf_cons, amrex::MultiFab &mf_u, amrex::MultiFab &mf_v, amrex::MultiFab *mf_sstore, amrex::MultiFab *mf_ru, amrex::MultiFab *mf_rv, std::unique_ptr< amrex::MultiFab > &mf_DU_avg1, std::unique_ptr< amrex::MultiFab > &mf_DU_avg2, std::unique_ptr< amrex::MultiFab > &mf_DV_avg1, std::unique_ptr< amrex::MultiFab > &mf_DV_avg2, std::unique_ptr< amrex::MultiFab > &mf_ubar, std::unique_ptr< amrex::MultiFab > &mf_vbar, std::unique_ptr< amrex::MultiFab > &mf_Akv, std::unique_ptr< amrex::MultiFab > &mf_Akt, std::unique_ptr< amrex::MultiFab > &mf_Hz, std::unique_ptr< amrex::MultiFab > &mf_Huon, std::unique_ptr< amrex::MultiFab > &mf_Hvom, std::unique_ptr< amrex::MultiFab > &mf_z_w, amrex::MultiFab const *mf_h, amrex::MultiFab const *mf_pm, amrex::MultiFab const *mf_pn, amrex::MultiFab const *mf_mskr, amrex::MultiFab const *mf_msku, amrex::MultiFab const *mf_mskv, const int N, const amrex::Real dt_lev)
Advance the 3D variables.
void init_grid_vars_from_netcdf(int lev)
Grid variable initialization from NetCDF file.
static int sum_interval
Diagnostic sum output interval in number of steps.
Definition REMORA.H:1533
int history_count
Counter for which time index we are writing to in the netcdf history file.
Definition REMORA.H:1481
amrex::Real stop_time
Time to stop.
Definition REMORA.H:1426
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_rain
precipitation rate [kg/m^2/s]
Definition REMORA.H:411
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_tke
Turbulent kinetic energy.
Definition REMORA.H:523
void rho_eos(const amrex::Box &bx, const amrex::Array4< amrex::Real const > &state, const amrex::Array4< amrex::Real > &rho, const amrex::Array4< amrex::Real > &rhoA, const amrex::Array4< amrex::Real > &rhoS, const amrex::Array4< amrex::Real > &bvf, const amrex::Array4< amrex::Real > &alpha, const amrex::Array4< amrex::Real > &beta, const amrex::Array4< amrex::Real const > &Hz, const amrex::Array4< amrex::Real const > &z_w, const amrex::Array4< amrex::Real const > &z_r, const amrex::Array4< amrex::Real const > &h, const amrex::Array4< amrex::Real const > &mskr, const int N)
Wrapper around equation of state calculation.
static void print_summary(std::ostream &)
int do_substep
Whether to substep fine levels in time.
Definition REMORA.H:1454
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_stflx
Surface tracer flux; working arrays.
Definition REMORA.H:402
void Evolve()
Advance solution to final time.
Definition REMORA.cpp:244
void t3dmix2(const amrex::Box &bx, const amrex::Array4< amrex::Real > &state, const amrex::Array4< amrex::Real > &state_rhs, const amrex::Array4< amrex::Real const > &diff2, const amrex::Array4< amrex::Real const > &Hz, const amrex::Array4< amrex::Real const > &z_r, const amrex::Array4< amrex::Real const > &pm, const amrex::Array4< amrex::Real const > &pn, const amrex::Array4< amrex::Real const > &msku, const amrex::Array4< amrex::Real const > &mskv, const amrex::Real dt_lev, const int ncomp, const int N)
Wrapper for harmonic diffusivity for tracers.
std::string bdry_time_varname
Default name of time field for boundary data.
Definition REMORA.H:1581
amrex::Real plotfile_fill_value
fill value for masked arrays in amrex plotfiles
Definition REMORA.H:1500
void ReadCheckpointFile()
read checkpoint file from disk
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_gls
Turbulent generic length scale.
Definition REMORA.H:525
bool chunk_history_file
Whether to chunk netcdf history file.
Definition REMORA.H:1474
void writeJobInfo(const std::string &dir) const
Write job info to stdout.
int num_bc_vars() const noexcept
Definition REMORA.H:1149
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_sustr
Surface stress in the u direction.
Definition REMORA.H:375
amrex::Real get_t_old(int lev) const
Accessor method for t_old to expose to outside classes.
Definition REMORA.cpp:1865
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_yp
y_grid on psi-points (2D)
Definition REMORA.H:500
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_xr
x_grid on rho points (2D)
Definition REMORA.H:483
int yvel_bc() const noexcept
Definition REMORA.H:1139
std::unique_ptr< NCTimeSeries > longwave_down_data_from_file
Data container for downward longwave radiation flux read from file.
Definition REMORA.H:1269
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_ru2d
u velocity RHS (2D, includes horizontal and vertical advection)
Definition REMORA.H:330
virtual void ClearLevel(int lev) override
Delete level data Overrides the pure virtual function in AmrCore.
amrex::Vector< std::string > datalogname
Definition REMORA.H:1689
amrex::Vector< amrex::MultiFab * > zvel_new
multilevel data container for current step's z velocities (largely unused; W stored separately)
Definition REMORA.H:300
AMREX_FORCE_INLINE int ComputeGhostCells(const int &spatial_order)
Helper function to determine number of ghost cells.
Definition REMORA.H:1614
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_sstore
additional scratch space for calculations on temp, salt, etc
Definition REMORA.H:503
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_xv
x_grid on v-points (2D)
Definition REMORA.H:493
void init_only(int lev, amrex::Real time)
Init (NOT restart or regrid)
Definition REMORA.cpp:1236
void init_set_vmix(int lev)
Initialize vertical mixing coefficients from file or analytic.
Definition REMORA.cpp:756
amrex::Real EvolveOneStep(amrex::Real time, amrex::Real dt_request)
std::unique_ptr< NCTimeSeries > v_clim_data_from_file
Data container for v-velocity climatology data read from file.
Definition REMORA.H:1284
std::string clim_u_time_varname
Name of time field for u climatology data.
Definition REMORA.H:1590
void rhs_uv_3d(int lev, const amrex::Box &xbx, const amrex::Box &ybx, const amrex::Array4< amrex::Real const > &uold, const amrex::Array4< amrex::Real const > &vold, const amrex::Array4< amrex::Real > &ru, const amrex::Array4< amrex::Real > &rv, const amrex::Array4< amrex::Real > &rufrc, const amrex::Array4< amrex::Real > &rvfrc, const amrex::Array4< amrex::Real const > &sustr, const amrex::Array4< amrex::Real const > &svstr, const amrex::Array4< amrex::Real const > &bustr, const amrex::Array4< amrex::Real const > &bvstr, const amrex::Array4< amrex::Real const > &Huon, const amrex::Array4< amrex::Real const > &Hvom, const amrex::Array4< amrex::Real const > &pm, const amrex::Array4< amrex::Real const > &pn, const amrex::Array4< amrex::Real const > &W, const amrex::Array4< amrex::Real > &FC, int nrhs, int N)
RHS terms for 3D momentum.
void set_grid_scale(int lev)
Set pm and pn arrays and x/y coords on level lev.
void set_coriolis(int lev)
Initialize Coriolis factor from file or analytic.
Definition REMORA.cpp:727
int foextrap_bc() const noexcept
Definition REMORA.H:1146
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_Lscale
Vertical mixing turbulent length scale.
Definition REMORA.H:527
amrex::Vector< REMORAFillPatcher > FPr_u
Vector over levels of FillPatchers for u (3D)
Definition REMORA.H:1319
std::string clim_temp_time_varname
Name of time field for temperature climatology data.
Definition REMORA.H:1596
amrex::Vector< amrex::Vector< amrex::Box > > boxes_at_level
the boxes specified at each level by tagging criteria
Definition REMORA.H:1357
void prestep_diffusion(const amrex::Box &bx, const amrex::Box &gbx, const int ioff, const int joff, const amrex::Array4< amrex::Real > &vel, const amrex::Array4< amrex::Real const > &vel_old, const amrex::Array4< amrex::Real > &rvel, const amrex::Array4< amrex::Real const > &Hz, const amrex::Array4< amrex::Real const > &Akv, const amrex::Array4< amrex::Real > &FC, const amrex::Array4< amrex::Real const > &sstr, const amrex::Array4< amrex::Real const > &bstr, const amrex::Array4< amrex::Real const > &z_r, const amrex::Array4< amrex::Real const > &pm, const amrex::Array4< amrex::Real const > &pn, const int iic, const int ntfirst, const int nnew, int nstp, int nrhs, int N, const amrex::Real lambda, const amrex::Real dt_lev)
Update velocities or tracers with diffusion/viscosity as the last part of the prestep.
void vert_mean_3d(const amrex::Box &bx, const int ioff, const int joff, const amrex::Array4< amrex::Real > &phi, const amrex::Array4< amrex::Real const > &Hz, const amrex::Array4< amrex::Real const > &Dphi_avg1, const amrex::Array4< amrex::Real > &DC, const amrex::Array4< amrex::Real > &CF, const amrex::Array4< amrex::Real const > &pm_or_pn, const amrex::Array4< amrex::Real const > &msk, const int nnew, const int N)
Adjust 3D momentum variables based on vertical mean momentum.
static amrex::Vector< amrex::AMRErrorTag > ref_tags
Holds info for dynamically generated tagging criteria.
Definition REMORA.H:1606
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_Hz
Width of cells in the vertical (z-) direction (3D, Hz in ROMS)
Definition REMORA.H:320
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_Akt
Vertical diffusion coefficient (3D)
Definition REMORA.H:340
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_msku
land/sea mask at x-faces (2D)
Definition REMORA.H:461
std::unique_ptr< NCTimeSeriesRiver > river_source_transportbar
Data container for vertically integrated momentum transport in rivers.
Definition REMORA.H:1295
std::array< bool, AtmosState::NumTypes > driver_atmos_state_from_driver
provenance flags for driver-supplied atmospheric forcing lanes
Definition REMORA.H:420
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_rvfrc
v velocity RHS, integrated, including advection and bottom/surface stresses (2D)
Definition REMORA.H:336
int v2d_simple_bc() const noexcept
Definition REMORA.H:1148
std::string clim_ubar_time_varname
Name of time field for ubar climatology data.
Definition REMORA.H:1586
std::unique_ptr< NCTimeSeries > u_clim_data_from_file
Data container for u-velocity climatology data read from file.
Definition REMORA.H:1282
std::string check_file
Checkpoint file prefix.
Definition REMORA.H:1467
void FillPatchNoBC(int lev, amrex::Real time, amrex::MultiFab &mf_to_be_filled, amrex::Vector< amrex::MultiFab * > const &mfs, const int bdy_var_type=BdyVars::null, const int icomp=0, const bool fill_all=true, const bool fill_set=true)
Fill a new MultiFab by copying in phi from valid region and filling ghost cells without applying boun...
static amrex::Real startCPUTime
Variable for CPU timing.
Definition REMORA.H:1655
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_pm_full_domain
horizontal scaling factor: 1 / dx (2D) on whole domain
Definition REMORA.H:474
amrex::Vector< amrex::MultiFab * > xvel_old
multilevel data container for last step's x velocities (u in ROMS)
Definition REMORA.H:287
amrex::Real start_time
Time of the start of the simulation, in seconds.
Definition REMORA.H:1429
void init_data_from_netcdf(int lev)
Problem initialization from NetCDF file.
void init_masks_from_netcdf(int lev)
Mask data initialization from NetCDF file.
amrex::Vector< amrex::MultiFab * > yvel_new
multilevel data container for current step's y velocities (v in ROMS)
Definition REMORA.H:298
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_uwind
Wind in the u direction, defined at rho-points.
Definition REMORA.H:380
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_rufrc
u velocity RHS, integrated, including advection and bottom/surface stresses (2D)
Definition REMORA.H:334
static amrex::Real fixed_fast_dt
User specified fixed barotropic time step.
Definition REMORA.H:1447
int regrid_int
how often each level regrids the higher levels of refinement (after a level advances that many time s...
Definition REMORA.H:1457
amrex::Real check_int_time
Checkpoint output interval in seconds.
Definition REMORA.H:1471
amrex::Box nc_hires_init_box
Box for the full domain at nc_hires_init_level.
Definition REMORA.H:1565
amrex::Real bdy_time_interval
Interval between boundary data times.
Definition REMORA.H:1247
void gls_prestep(int lev, amrex::MultiFab *mf_gls, amrex::MultiFab *mf_tke, amrex::MultiFab &mf_W, amrex::MultiFab *mf_msku, amrex::MultiFab *mf_mskv, const int nstp, const int nnew, const int iic, const int ntfirst, const int N, const amrex::Real dt_lev)
Prestep for GLS calculation.
void init_scalar_metadata()
Build runtime scalar names after nscalar is known.
Definition REMORA.cpp:231
amrex::Real start_bdy_time
Start time in the time series of boundary data.
Definition REMORA.H:1245
int zeta_bc() const noexcept
Definition REMORA.H:1143
amrex::Vector< amrex::GpuArray< REMORA_BC, AMREX_SPACEDIM *2 > > phys_bc_type
Array holding the "physical" boundary condition types (e.g. "inflow")
Definition REMORA.H:1397
amrex::Vector< amrex::Real > vec_weight2
Weights for calculating avg2 in 2D advance.
Definition REMORA.H:519
amrex::Vector< int > bdy_index
Container to connect boundary data being read in boundary condition containers.
Definition REMORA.H:1406
amrex::Gpu::DeviceVector< amrex::Real > s_r
Scaled vertical coordinate (range [0,1]) that transforms to z, defined at rho points (cell centers)
Definition REMORA.H:354
void Define_REMORAFillPatchers(int lev)
Define FillPatchers.
Definition REMORA.cpp:512
amrex::Vector< amrex::IntVect > cum_ref_ratios
Cumulative refinement ratio between level 0 and level i.
Definition REMORA.H:1568
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_shflx
sensible heat flux
Definition REMORA.H:399
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_visc2_p
Harmonic viscosity defined on the psi points (corners of horizontal grid cells)
Definition REMORA.H:342
void set_drag(int lev)
Initialize or calculate bottom drag.
amrex::MultiFab & build_fine_mask(int lev)
Make mask to zero out covered cells (for mesh refinement)
amrex::Real plot_int_time
Plotfile output interval in seconds.
Definition REMORA.H:1465
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_rvbar
barotropic y velocity for the RHS (2D)
Definition REMORA.H:445
amrex::Vector< int > num_files_at_level
how many netcdf input files specified at each level
Definition REMORA.H:1355
void advance_2d_onestep(int lev, amrex::Real dt_lev, amrex::Real dtfast_lev, int my_iif, int nfast_counter)
2D advance, one predictor/corrector step
amrex::Vector< REMORAFillPatcher > FPr_vbar
Vector over levels of FillPatchers for vbar (2D)
Definition REMORA.H:1329
void AverageDownTo(int crse_lev)
more flexible version of AverageDown() that lets you average down across multiple levels
Definition REMORA.cpp:1803
int steps_per_history_file
Number of time steps per netcdf history file.
Definition REMORA.H:1479
void post_timestep(int nstep, amrex::Real time, amrex::Real dt_lev)
Called after every level 0 timestep.
Definition REMORA.cpp:326
int max_step
maximum number of steps
Definition REMORA.H:1424
amrex::Vector< amrex::MultiFab * > zvel_old
multilevel data container for last step's z velocities (largely unused; W stored separately)
Definition REMORA.H:291
std::unique_ptr< NCTimeSeries > svstr_data_from_file
Data container for v-component surface momentum flux read from file.
Definition REMORA.H:1255
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_z_r
z coordinates at rho points (cell centers)
Definition REMORA.H:349
amrex::Vector< std::string > nc_frc_file
NetCDF forcing file(s)
Definition REMORA.H:1571
amrex::Vector< int > num_boxes_at_level
how many boxes specified at each level by tagging criteria
Definition REMORA.H:1353
amrex::Vector< amrex::MultiFab * > xvel_new
multilevel data container for current step's x velocities (u in ROMS)
Definition REMORA.H:296
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_lhflx
latent heat flux
Definition REMORA.H:397
void refinement_criteria_setup()
Set refinement criteria.
int u2d_simple_bc() const noexcept
Definition REMORA.H:1147
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_mskp
land/sea mask at cell corners (2D)
Definition REMORA.H:465
void remora_advance(int level, amrex::MultiFab &cons_old, amrex::MultiFab &cons_new, amrex::MultiFab &xvel_old, amrex::MultiFab &yvel_old, amrex::MultiFab &zvel_old, amrex::MultiFab &xvel_new, amrex::MultiFab &yvel_new, amrex::MultiFab &zvel_new, amrex::MultiFab &source, const amrex::Geometry fine_geom, const amrex::Real dt, const amrex::Real time)
Interface for advancing the data at one level by one "slow" timestep.
int last_check_file_step
Step when we last output a checkpoint file.
Definition REMORA.H:1414
void prestep(int lev, amrex::MultiFab &mf_uold, amrex::MultiFab &mf_vold, amrex::MultiFab &mf_u, amrex::MultiFab &mf_v, amrex::MultiFab *mf_ru, amrex::MultiFab *mf_rv, amrex::MultiFab &S_old, amrex::MultiFab &S_new, amrex::MultiFab &mf_W, amrex::MultiFab &mf_DC, const amrex::MultiFab *mf_z_r, const amrex::MultiFab *mf_z_w, const amrex::MultiFab *mf_h, const amrex::MultiFab *mf_pm, const amrex::MultiFab *mf_pn, const amrex::MultiFab *mf_sustr, const amrex::MultiFab *mf_svstr, const amrex::MultiFab *mf_bustr, const amrex::MultiFab *mf_bvstr, const amrex::MultiFab *mf_msku, const amrex::MultiFab *mf_mskv, const int iic, const int nfirst, const int nnew, int nstp, int nrhs, int N, const amrex::Real dt_lev)
Wrapper function for prestep.
void init_beta_plane_coriolis(int lev)
Calculate Coriolis parameters from beta plane parametrization.
std::string clim_vbar_time_varname
Name of time field for vbar climatology data.
Definition REMORA.H:1588
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_bvf
Brunt-Vaisala frequency (3D)
Definition REMORA.H:510
virtual void RemakeLevel(int lev, amrex::Real time, const amrex::BoxArray &ba, const amrex::DistributionMapping &dm) override
Remake an existing level using provided BoxArray and DistributionMapping and fill with existing fine ...
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_mskv
land/sea mask at y-faces (2D)
Definition REMORA.H:463
void init_masks(int lev, const amrex::BoxArray &ba, const amrex::DistributionMapping &dm)
Allocate MultiFabs for masks.
amrex::Vector< int > nsubsteps
How many substeps on each level?
Definition REMORA.H:1362
amrex::Vector< std::unique_ptr< REMORAPhysBCFunct > > physbcs
Vector (over level) of functors to apply physical boundary conditions.
Definition REMORA.H:1374
void ComputeDt()
a wrapper for estTimeStep()
void fill_3d_masks(int lev)
Copy maskr to all z levels.
static void writeBuildInfo(std::ostream &os)
Write build info to os.
std::unique_ptr< NCTimeSeries > EminusP_data_from_file
Data container for evaporation minus precipitation read from file.
Definition REMORA.H:1275
virtual void ErrorEst(int lev, amrex::TagBoxArray &tags, amrex::Real time, int ngrow) override
Tag cells for refinement.
int plot_int
Plotfile output interval in iterations.
Definition REMORA.H:1463
void FillPatch(int lev, amrex::Real time, amrex::MultiFab &mf_to_be_filled, amrex::Vector< amrex::MultiFab * > const &mfs, const int bccomp, const int bdy_var_type=BdyVars::null, const int icomp=0, const bool fill_all=true, const bool fill_set=true, const int n_not_fill=0, const int icomp_calc=0, const amrex::Real dt=amrex::Real(0.0), const amrex::MultiFab &mf_calc=amrex::MultiFab())
Fill a new MultiFab by copying in phi from valid region and filling ghost cells.
std::unique_ptr< NCTimeSeries > cloud_data_from_file
Data container for cloud cover fraction read from file.
Definition REMORA.H:1273
amrex::Real getCPUTime() const
Get CPU time used.
Definition REMORA.H:1661
void InitData()
Initialize multilevel data.
Definition REMORA.cpp:358
void set3DPlotVariables(const std::string &pp_plot_var_names_3d)
amrex::Vector< int > istep
which step?
Definition REMORA.H:1360
void apply_clim_nudg(const amrex::Box &bx, int ioff, int joff, const amrex::Array4< amrex::Real > &var, const amrex::Array4< amrex::Real const > &var_old, const amrex::Array4< amrex::Real const > &var_clim, const amrex::Array4< amrex::Real const > &clim_coeff, const amrex::Array4< amrex::Real const > &Hz, const amrex::Array4< amrex::Real const > &pm, const amrex::Array4< amrex::Real const > &pn, const amrex::Real dt_lev=amrex::Real(0.0))
Apply climatology nudging.
void uv3dmix(const amrex::Box &xbx, const amrex::Box &ybx, const amrex::Array4< amrex::Real > &u, const amrex::Array4< amrex::Real > &v, const amrex::Array4< amrex::Real const > &uold, const amrex::Array4< amrex::Real const > &vold, const amrex::Array4< amrex::Real > &rufrc, const amrex::Array4< amrex::Real > &rvfrc, const amrex::Array4< amrex::Real const > &visc2_p, const amrex::Array4< amrex::Real const > &visc2_r, const amrex::Array4< amrex::Real const > &Hz, const amrex::Array4< amrex::Real const > &pm, const amrex::Array4< amrex::Real const > &pn, const amrex::Array4< amrex::Real const > &mskp, int nrhs, int nnew, const amrex::Real dt_lev)
Harmonic viscosity.
void WriteCheckpointFile()
write checkpoint file to disk
std::string nc_clim_coeff_file
NetCDF climatology coefficient file.
Definition REMORA.H:1578
void lin_eos(const amrex::Box &bx, const amrex::Array4< amrex::Real const > &state, const amrex::Array4< amrex::Real > &rho, const amrex::Array4< amrex::Real > &rhoA, const amrex::Array4< amrex::Real > &rhoS, const amrex::Array4< amrex::Real > &bvf, const amrex::Array4< amrex::Real const > &Hz, const amrex::Array4< amrex::Real const > &z_w, const amrex::Array4< amrex::Real const > &z_r, const amrex::Array4< amrex::Real const > &h, const amrex::Array4< amrex::Real const > &mskr, const int N)
Calculate density and related quantities from linear equation of state.
void setRecordDataInfo(int i, const std::string &filename)
Definition REMORA.H:1675
void advance_3d_ml(int lev, amrex::Real dt_lev)
3D advance on a single level
const std::string DataLogName(int i) const noexcept
The filename of the ith datalog file.
Definition REMORA.H:1692
void WriteMultiLevelPlotfileWithBathymetry(const std::string &plotfilename, int nlevels, const amrex::Vector< const amrex::MultiFab * > &mf, const amrex::Vector< const amrex::MultiFab * > &mf_nd, const amrex::Vector< const amrex::MultiFab * > &mf_u, const amrex::Vector< const amrex::MultiFab * > &mf_v, const amrex::Vector< const amrex::MultiFab * > &mf_w, const amrex::Vector< const amrex::MultiFab * > &mf_2d_rho, const amrex::Vector< const amrex::MultiFab * > &mf_2d_u, const amrex::Vector< const amrex::MultiFab * > &mf_2d_v, const amrex::Vector< std::string > &varnames_3d, const amrex::Vector< std::string > &varnames_2d_rho, const amrex::Vector< std::string > &varnames_2d_u, const amrex::Vector< std::string > &varnames_2d_v, const amrex::Vector< amrex::Geometry > &my_geom, amrex::Real time, const amrex::Vector< int > &level_steps, const amrex::Vector< amrex::IntVect > &rr, const std::string &versionName="HyperCLaw-V1.1", const std::string &levelPrefix="Level_", const std::string &mfPrefix="Cell", const amrex::Vector< std::string > &extra_dirs=amrex::Vector< std::string >()) const
write out particular data to an AMReX plotfile
void set_analytic_vmix(int lev)
Set vertical mixing coefficients from analytic.
Definition REMORA.cpp:773
void mask_arrays_for_write(int lev, amrex::Real fill_value, amrex::Real fill_where)
Mask data arrays before writing output.
void init_flat_bathymetry(int lev)
Initialize flat bathymetry to value from problo.
Definition REMORA.cpp:1100
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_rhoS
density perturbation
Definition REMORA.H:506
std::unique_ptr< NCTimeSeries > temp_clim_data_from_file
Data container for temperature climatology data read from file.
Definition REMORA.H:1286
amrex::Vector< std::string > bdry_time_name_byvar
Name of time fields for boundary data.
Definition REMORA.H:1583
void rhs_uv_2d(int lev, const amrex::Box &xbx, const amrex::Box &ybx, const amrex::Array4< amrex::Real const > &uold, const amrex::Array4< amrex::Real const > &vold, const amrex::Array4< amrex::Real > &ru, const amrex::Array4< amrex::Real > &rv, const amrex::Array4< amrex::Real const > &Duon, const amrex::Array4< amrex::Real const > &Dvom, const int nrhs)
RHS terms for 2D momentum.
static int file_min_digits
Minimum number of digits in plotfile name or chunked history file.
Definition REMORA.H:1538
void init_riv_pos_from_netcdf(int lev)
static amrex::Vector< std::string > nc_bdry_file
NetCDF boundary data.
Definition REMORA.H:51
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_visc2_r
Harmonic viscosity defined on the rho points (centers)
Definition REMORA.H:344
void update_mskp(int lev)
Set psi-point mask to be consistent with rho-point mask.
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_yvel_full_domain
multilevel data container for high res initial y velocities (v in ROMS)
Definition REMORA.H:307
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_svstr
Surface stress in the v direction.
Definition REMORA.H:377
std::unique_ptr< NCTimeSeries > srflx_data_from_file
Data container for shortwave radiation flux read from file.
Definition REMORA.H:1267
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_Huon
u-volume flux (3D)
Definition REMORA.H:322
REMORA()
Definition REMORA.cpp:62
void FillBdyCCVels(int lev, amrex::MultiFab &mf_cc_vel)
Fill the physical boundary conditions for cell-centered velocity (diagnostic only)
void set_zeta(int lev)
Initialize zeta from file or analytic.
Definition REMORA.cpp:572
static amrex::Real change_max
Fraction maximum change in subsequent time steps.
Definition REMORA.H:1443
void calc_stretch_coeffs()
calculate vertical stretch coefficients
void init_zeta_from_netcdf(int lev)
Sea-surface height data initialization from NetCDF file.
void set_zeta_average(int lev)
Set Zt_avg1 to zeta.
void init_coriolis_from_netcdf(int lev)
Coriolis parameter data initialization from NetCDF file.
static void print_usage(MPI_Comm, std::ostream &)
void fill_from_bdyfiles(int lev, amrex::MultiFab &mf_to_fill, const amrex::MultiFab &mf_mask, const amrex::Real time, const int bccomp, const int bdy_var_type, const int icomp_to_fill, const int icomp_calc=0, const amrex::MultiFab &mf_calc=amrex::MultiFab(), const amrex::Real=amrex::Real(0.0))
Fill boundary data from netcdf file.
std::string pp_prefix
default prefix for input file parameters
Definition REMORA.H:282
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_h_full_domain
Bathymetry data on the whole domain at each potential level.
Definition REMORA.H:317
void set_bathymetry(int lev)
Initialize bathymetry from file or analytic.
Definition REMORA.cpp:611
amrex::Vector< amrex::MultiFab * > yvel_old
multilevel data container for last step's y velocities (v in ROMS)
Definition REMORA.H:289
std::unique_ptr< NCTimeSeries > ubar_clim_data_from_file
Data container for ubar climatology data read from file.
Definition REMORA.H:1278
void init_stuff(int lev, const amrex::BoxArray &ba, const amrex::DistributionMapping &dm)
Allocate MultiFabs for state and evolution variables.
void init_full_domain_from_analytic()
Initialize high resolution initial problem data from analytic functions.
TimeInterpolatedData GetDataAtTime(int lev, amrex::Real time)
utility to copy in data from old and/or new state into another multifab
void Advance(int lev, amrex::Real time, amrex::Real dt_lev, int iteration, int ncycle)
advance a single level for a single time step
void init_data_full_domain_from_netcdf()
High resolution roblem initialization from NetCDF file.
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_rhoA
vertically-averaged density
Definition REMORA.H:508
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_DV_avg1
time average of barotropic y velocity flux
Definition REMORA.H:439
amrex::Vector< REMORAFillPatcher > FPr_c
Vector over levels of FillPatchers for scalars.
Definition REMORA.H:1317
int hires_init_level
Which level the high resolution initialization data is at.
Definition REMORA.H:1561
void WriteNCPlotFile(int istep, amrex::MultiFab const *plotMF)
Write plotfile using NetCDF (wrapper)
std::unique_ptr< NCTimeSeries > Tair_data_from_file
Data container for air temperature read from file.
Definition REMORA.H:1261
void rhs_t_3d(int lev, const amrex::Box &bx, const amrex::Array4< amrex::Real > &t, const amrex::Array4< amrex::Real const > &tempstore, const amrex::Array4< amrex::Real const > &Huon, const amrex::Array4< amrex::Real const > &Hvom, const amrex::Array4< amrex::Real const > &Hz, const amrex::Array4< amrex::Real const > &pn, const amrex::Array4< amrex::Real const > &pm, const amrex::Array4< amrex::Real const > &W, const amrex::Array4< amrex::Real > &FC, const amrex::Array4< amrex::Real const > &mskr, const amrex::Array4< amrex::Real const > &msku, const amrex::Array4< amrex::Real const > &mskv, const amrex::Array4< int const > &river_pos, const amrex::Array4< amrex::Real const > &river_source, int nrhs, int nnew, int N, const amrex::Real dt_lev)
RHS terms for tracer.
AMREX_GPU_HOST_DEVICE static AMREX_FORCE_INLINE amrex::Real bulk_psiu(amrex::Real ZoL)
Evaluate stability function psi for wind speed.
Definition REMORA.H:1711
static void print_banner(MPI_Comm, std::ostream &)
int nscalar
Number of passive scalars carried in the state.
Definition REMORA.H:1435
std::string clim_v_time_varname
Name of time field for v climatology data.
Definition REMORA.H:1592
void scale_rhs_vars_inv()
Scale RHS momentum variables by cell area, needed after FillPatch to different levels.
amrex::Vector< REMORAFillPatcher > FPr_w
Vector over levels of FillPatchers for w.
Definition REMORA.H:1323
void average_down_with_grow_cells(int lev, amrex::Vector< std::unique_ptr< amrex::MultiFab > > &mf)
Average down from level lev+1 to lev in mf, including grow cells.
Definition REMORA.cpp:1831
std::string clim_salt_time_varname
Name of time field for salinity climatology data.
Definition REMORA.H:1594
amrex::Gpu::DeviceVector< amrex::Real > Cs_r
Stretching coefficients at rho points.
Definition REMORA.H:364
std::unique_ptr< NCTimeSeries > Uwind_data_from_file
Data container for u-direction wind read from file.
Definition REMORA.H:1257
std::unique_ptr< NCTimeSeries > Pair_data_from_file
Data container for air pressure read from file.
Definition REMORA.H:1265
amrex::Vector< amrex::Real > t_new
new time at each level
Definition REMORA.H:1364
void init_stretch_coeffs()
initialize and calculate stretch coefficients
void init_bdry_from_netcdf(int lev)
Boundary data initialization from NetCDF file.
static SolverChoice solverChoice
Container for algorithmic choices.
Definition REMORA.H:1494
void ApplyAtmosphericStates(const amrex::Vector< amrex::MultiFab * > &states, amrex::Real time)
Receives atmospheric states from the driver and applies unit conversions.
void set_grid_coords_from_grid_scale(int lev)
Set x/y coords on level lev based on pm and pn.
void resize_stuff(int lev)
Resize variable containers to accommodate data on levels 0 to max_lev.
amrex::Vector< std::unique_ptr< amrex::iMultiFab > > vec_river_position
iMultiFab for river positions; contents are indices of rivers
Definition REMORA.H:1302
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_Akk
Turbulent kinetic energy vertical diffusion coefficient.
Definition REMORA.H:529
void set_masks(int lev)
Initialize land-sea masks from file or analytic.
Definition REMORA.cpp:789
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_rdrag2
Quadratic drag coefficient [unitless], defined at rho points.
Definition REMORA.H:425
amrex::Vector< amrex::Vector< std::unique_ptr< NCTimeSeriesBoundary > > > boundary_series
Vector over BdyVars of boundary series data containers.
Definition REMORA.H:1298
int cf_set_width
Width for fixing values at coarse-fine interface.
Definition REMORA.H:1314
void ReadParameters()
read in some parameters from inputs file
Definition REMORA.cpp:1526
static void print_tpls(std::ostream &)
void WriteGenericPlotfileHeaderWithBathymetry(std::ostream &HeaderFile, int nlevels, const amrex::Vector< amrex::BoxArray > &bArray, const amrex::Vector< std::string > &varnames_3d, const amrex::Vector< std::string > &varnames_2d_rho, const amrex::Vector< std::string > &varnames_2d_u, const amrex::Vector< std::string > &varnames_2d_v, const amrex::Vector< amrex::Geometry > &my_geom, amrex::Real time, const amrex::Vector< int > &level_steps, const amrex::Vector< amrex::IntVect > &rr, const std::string &versionName, const std::string &levelPrefix, const std::string &mfPrefix) const
write out header data for an AMReX plotfile
void vert_visc_3d(const amrex::Box &bx, const int ioff, const int joff, const amrex::Array4< amrex::Real > &phi, const amrex::Array4< amrex::Real const > &Hz, const amrex::Array4< amrex::Real > &Hzk, const amrex::Array4< amrex::Real > &AK, const amrex::Array4< amrex::Real const > &Akv, const amrex::Array4< amrex::Real > &BC, const amrex::Array4< amrex::Real > &DC, const amrex::Array4< amrex::Real > &FC, const amrex::Array4< amrex::Real > &CF, const int nnew, const int N, const amrex::Real dt_lev)
Calculate effects of vertical viscosity or diffusivity.
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_ru
u velocity RHS (3D, includes horizontal and vertical advection)
Definition REMORA.H:326
void sum_integrated_quantities(amrex::Real time)
Integrate conserved quantities for diagnostics.
static int total_nc_plot_file_step
Definition REMORA.H:1153
amrex::Vector< amrex::Real > vec_weight1
Weights for calculating avg1 in 2D advance.
Definition REMORA.H:517
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_xp
x_grid on psi-points (2D)
Definition REMORA.H:498
static int plot_staggered_vels
Whether to write the staggered velocities (not averaged to cell centers)
Definition REMORA.H:1541
static amrex::Vector< amrex::Vector< std::string > > nc_grid_file
NetCDF grid file.
Definition REMORA.H:53
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_longwave_down
Downward longwave radiation.
Definition REMORA.H:395
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_zeta
free surface height (2D)
Definition REMORA.H:453
int ubar_bc() const noexcept
Definition REMORA.H:1141
amrex::Gpu::DeviceVector< int > river_direction
Vector over rivers of river direction: 0: u-face; 1: v-face; 2: w-face.
Definition REMORA.H:1304
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_vbar
barotropic y velocity (2D)
Definition REMORA.H:451
void ReadNCMultiFab(amrex::FabArray< amrex::FArrayBox > &fab, const std::string &name, int coordinatorProc=amrex::ParallelDescriptor::IOProcessorNumber(), int allow_empty_mf=0)
Read MultiFab in NetCDF format.
amrex::Box nc_hires_grid_box
Box for the full domain at nc_hires_grid_level.
Definition REMORA.H:1558
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_DU_avg1
time average of barotropic x velocity flux (2D)
Definition REMORA.H:435
amrex::Gpu::DeviceVector< amrex::Real > Cs_w
Stretching coefficients at w points.
Definition REMORA.H:366
void set_zeta_to_Ztavg(int lev)
Set zeta components to be equal to time-averaged Zt_avg1.
bool expand_plotvars_to_unif_rr
whether plotfile variables should be expanded to a uniform refinement ratio
Definition REMORA.H:1497
void advance_2d(int lev, amrex::MultiFab const *mf_rhoS, amrex::MultiFab const *mf_rhoA, amrex::MultiFab *mf_ru2d, amrex::MultiFab *mf_rv2d, amrex::MultiFab *mf_rufrc, amrex::MultiFab *mf_rvfrc, amrex::MultiFab *mf_Zt_avg1, std::unique_ptr< amrex::MultiFab > &mf_DU_avg1, std::unique_ptr< amrex::MultiFab > &mf_DU_avg2, std::unique_ptr< amrex::MultiFab > &mf_DV_avg1, std::unique_ptr< amrex::MultiFab > &mf_DV_avg2, std::unique_ptr< amrex::MultiFab > &mf_rubar, std::unique_ptr< amrex::MultiFab > &mf_rvbar, std::unique_ptr< amrex::MultiFab > &mf_rzeta, std::unique_ptr< amrex::MultiFab > &mf_ubar, std::unique_ptr< amrex::MultiFab > &mf_vbar, amrex::MultiFab *mf_zeta, amrex::MultiFab const *mf_h, amrex::MultiFab const *mf_pm, amrex::MultiFab const *mf_pn, amrex::MultiFab const *mf_fcor, amrex::MultiFab const *mf_visc2_p, amrex::MultiFab const *mf_visc2_r, amrex::MultiFab const *mf_mskr, amrex::MultiFab const *mf_msku, amrex::MultiFab const *mf_mskv, amrex::MultiFab const *mf_mskp, amrex::Real dtfast_lev, bool predictor_2d_step, bool first_2d_step, int my_iif, int &next_indx1)
Perform a 2D predictor (predictor_2d_step=True) or corrector (predictor_2d_step=False) step.
int plot_file_on_restart
Whether to output a plotfile on restart from checkpoint.
Definition REMORA.H:1418
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_alpha
Thermal expansion coefficient (3D)
Definition REMORA.H:512
void set_2darrays(int lev)
Set 2D momentum arrays from 3D momentum.
void FillCoarsePatchMap(int lev, amrex::Real time, amrex::MultiFab *mf_fine, amrex::MultiFab *mf_crse, const int bccomp, const int bdy_var_type=BdyVars::null, const int icomp=0, const bool fill_all=true, const int n_not_fill=0, const int icomp_calc=0, const amrex::Real dt=amrex::Real(0.0), const amrex::MultiFab &mf_calc=amrex::MultiFab(), amrex::Interpolater *mapper=nullptr)
fill an entire multifab by interpolating from the coarser level, explicitly specifying interpolator t...
void init_analytic(int lev)
Initialize initial problem data from analytic functions.
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_ubar
barotropic x velocity (2D)
Definition REMORA.H:449
void InitializeLevelFromData(int lev, const amrex::MultiFab &initial_data)
Initialize the new-time data at a level from the initial_data MultiFab.
amrex::Vector< amrex::MultiFab * > cons_old
multilevel data container for last step's scalar data: temperature, salinity, passive tracer
Definition REMORA.H:285
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_bustr
Bottom stress in the u direction.
Definition REMORA.H:430
AMREX_FORCE_INLINE int NumDataLogs() noexcept
Definition REMORA.H:1649
amrex::Real volWgtSumMF(int lev, const amrex::MultiFab &mf, int comp, bool local, bool finemask)
Perform the volume-weighted sum.
std::string frc_time_varname
Name of time field for forcing data.
Definition REMORA.H:1600
void set_wind(int lev)
Initialize or calculate wind speed from file or analytic.
Definition REMORA.cpp:1129
void init_clim_nudg_coeff_from_netcdf(int lev)
Climatology nudging coefficient initialization from NetCDF file.
amrex::Vector< REMORAFillPatcher > FPr_ubar
Vector over levels of FillPatchers for ubar (2D)
Definition REMORA.H:1327
bool is_it_time_for_action(int nstep, amrex::Real time, amrex::Real dt, int action_interval, amrex::Real action_per)
Decide if it is time to take an action.
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_cons_full_domain
multilevel data container for high res initial data: temperature, salinity, passive tracer
Definition REMORA.H:303
int vbar_bc() const noexcept
Definition REMORA.H:1142
std::unique_ptr< NCTimeSeries > Vwind_data_from_file
Data container for v-direction wind read from file.
Definition REMORA.H:1259
std::string PlotFileName(int lev) const
get plotfile name
void init_bathymetry_full_domain_from_netcdf()
Full domain high-res bathymetry data initialization from NetCDF file.
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_DV_avg2
correct time average of barotropic y velocity flux for coupling (2D)
Definition REMORA.H:441
void set_hmixcoef(int lev)
Initialize horizontal mixing coefficients.
Definition REMORA.cpp:815
amrex::Array< std::string, 2 *AMREX_SPACEDIM > domain_bc_type
Array of strings describing domain boundary conditions.
Definition REMORA.H:1391
amrex::Vector< std::unique_ptr< NCTimeSeriesRiver > > river_source_cons
Vector of data containers for scalar data in rivers.
Definition REMORA.H:1291
amrex::Real estTimeStep(int lev) const
compute dt from CFL considerations
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_yu
y_grid on u-points (2D)
Definition REMORA.H:490
void WriteNCPlotFile_which(int lev, int which_subdomain, amrex::MultiFab const *plotMF, bool write_header, ncutils::NCFile &ncf, bool is_history)
Write a particular NetCDF plotfile.
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_bvstr
Bottom stress in the v direction.
Definition REMORA.H:432
void timeStep(int lev, amrex::Real time, int iteration)
advance a level by dt, includes a recursive call for finer levels
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_rzeta
free surface height for the RHS (2D)
Definition REMORA.H:447
std::unique_ptr< NCTimeSeriesRiver > river_source_transport
Data container for momentum transport in rivers.
Definition REMORA.H:1293
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_z_phys_nd
z coordinates at psi points (cell nodes)
Definition REMORA.H:369
void init_grid_vars_full_domain_from_netcdf()
Full domain high-res grid variable initialization from NetCDF file.
void AverageDown()
set covered coarse cells to be the average of overlying fine cells
Definition REMORA.cpp:1790
static int fixed_ndtfast_ratio
User specified, number of barotropic steps per baroclinic step.
Definition REMORA.H:1449
amrex::Real netcdf_fill_value
fill value for masked arrays in netcdf output
Definition REMORA.H:1502
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_xu
x_grid on u-points (2D)
Definition REMORA.H:488
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_pn_full_domain
horizontal scaling factor: 1 / dy (2D) on whole domain
Definition REMORA.H:476
void timeStepML(amrex::Real time, int iteration)
advance all levels by dt, loops over finer levels
amrex::GpuArray< amrex::GpuArray< bool, AMREX_SPACEDIM *2 >, BdyVars::NumTypes+1 > phys_bc_need_data
These are flags that indicate whether we need to read in boundary data from file.
Definition REMORA.H:1400
amrex::Vector< amrex::Vector< std::unique_ptr< amrex::MultiFab > > > vec_nudg_coeff
Climatology nudging coefficients.
Definition REMORA.H:534
void set_weights(int lev)
Set weights for averaging 3D variables to 2D.
void prestep_t_advection(int lev, const amrex::Box &tbx, const amrex::Box &gbx, const amrex::Array4< amrex::Real > &tempold, const amrex::Array4< amrex::Real > &tempcache, const amrex::Array4< amrex::Real > &Hz, const amrex::Array4< amrex::Real > &Huon, const amrex::Array4< amrex::Real > &Hvom, const amrex::Array4< amrex::Real > &W, const amrex::Array4< amrex::Real > &DC, const amrex::Array4< amrex::Real > &FC, const amrex::Array4< amrex::Real > &sstore, const amrex::Array4< amrex::Real const > &z_w, const amrex::Array4< amrex::Real const > &h, const amrex::Array4< amrex::Real const > &pm, const amrex::Array4< amrex::Real const > &pn, const amrex::Array4< amrex::Real const > &msku, const amrex::Array4< amrex::Real const > &mskv, const amrex::Array4< int const > &river_pos, const amrex::Array4< amrex::Real const > &river_source, int iic, int ntfirst, int nrhs, int N, const amrex::Real dt_lev)
Prestep advection calculations for the tracers.
AMREX_FORCE_INLINE std::ostream & DataLog(int i)
Helper function for IO stream.
Definition REMORA.H:1642
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_pn
horizontal scaling factor: 1 / dy (2D)
Definition REMORA.H:472
amrex::Vector< std::unique_ptr< std::fstream > > datalog
Definition REMORA.H:1688
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_Akv
Vertical viscosity coefficient (3D)
Definition REMORA.H:338
static amrex::Real cfl
CFL condition.
Definition REMORA.H:1441
void append3DPlotVariables(const std::string &pp_plot_var_names_3d)
void allocate_bathymetry_grid_vars_full_domain()
Allocate multifabs for storing full-domain bathymetry and grid vars data.
virtual void MakeNewLevelFromScratch(int lev, amrex::Real time, const amrex::BoxArray &ba, const amrex::DistributionMapping &dm) override
Make a new level from scratch using provided BoxArray and DistributionMapping. Only used during initi...
amrex::Vector< std::string > plot_var_names_3d
Names of 3D variables to output to AMReX plotfile.
Definition REMORA.H:1484
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_stflux
Surface tracer flux; input arrays.
Definition REMORA.H:404
void set_init_data_averaged_down(int lev)
Problem initialization from averaged-down high resolution data.
Definition REMORA.cpp:710
static int verbose
Verbosity level of output.
Definition REMORA.H:1530
void setup_step(int lev, amrex::Real time, amrex::Real dt_lev)
Set everything up for a step on a level.
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_rdrag
Linear drag coefficient [m/s], defined at rho points.
Definition REMORA.H:423
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_cloud
cloud cover fraction [0-1], defined at rho-points
Definition REMORA.H:415
void nonlin_eos(const amrex::Box &bx, const amrex::Array4< amrex::Real const > &state, const amrex::Array4< amrex::Real > &rho, const amrex::Array4< amrex::Real > &rhoA, const amrex::Array4< amrex::Real > &rhoS, const amrex::Array4< amrex::Real > &bvf, const amrex::Array4< amrex::Real > &alpha, const amrex::Array4< amrex::Real > &beta, const amrex::Array4< amrex::Real const > &Hz, const amrex::Array4< amrex::Real const > &z_w, const amrex::Array4< amrex::Real const > &z_r, const amrex::Array4< amrex::Real const > &h, const amrex::Array4< amrex::Real const > &mskr, const int N)
Calculate density and related quantities from nonlinear equation of state.
void t3dmix2_geo(const amrex::Box &bx, const amrex::Array4< amrex::Real > &state, const amrex::Array4< amrex::Real > &state_rhs, const amrex::Array4< amrex::Real const > &diff2, const amrex::Array4< amrex::Real const > &Hz, const amrex::Array4< amrex::Real const > &z_r, const amrex::Array4< amrex::Real const > &pm, const amrex::Array4< amrex::Real const > &pn, const amrex::Array4< amrex::Real const > &msku, const amrex::Array4< amrex::Real const > &mskv, const amrex::Real dt_lev, const int ncomp, const int N)
Harmonic diffusivity for tracers along geopotential surfaces.
std::string plot_file_name
Plotfile prefix.
Definition REMORA.H:1461
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_Zt_avg1
Average of the free surface, zeta (2D)
Definition REMORA.H:372
std::unique_ptr< NCTimeSeries > salt_clim_data_from_file
Data container for salinity climatology data read from file.
Definition REMORA.H:1288
int check_int
Checkpoint output interval in iterations.
Definition REMORA.H:1469
void set_smflux(int lev)
Initialize or calculate surface momentum flux from file or analytic.
Definition REMORA.cpp:1110
void WritePlotFile(int istep)
main driver for writing AMReX plotfiles
std::string restart_chkfile
If set, restart from this checkpoint file.
Definition REMORA.H:1432
void init_clim_nudg_coeff(int lev)
Wrapper to initialize climatology nudging coefficient.
void init_bathymetry_full_domain_from_analytic()
Full domain bathymetry data initialization from analytic.
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_rv
v velocity RHS (3D, includes horizontal and vertical advection)
Definition REMORA.H:328
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_btflx
Bottom tracer flux; working arrays.
Definition REMORA.H:406
int cf_width
Nudging width at coarse-fine interface.
Definition REMORA.H:1312
AMREX_GPU_HOST_DEVICE static AMREX_FORCE_INLINE amrex::Real bulk_psit(amrex::Real ZoL)
Evaluate stability function psi for moisture and heat.
Definition REMORA.H:1743
static amrex::Vector< amrex::Vector< std::string > > nc_init_file
NetCDF initialization file.
Definition REMORA.H:52
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_beta
Saline contraction coefficient (3D)
Definition REMORA.H:514
int last_plot_file_step
Step when we last output a plotfile.
Definition REMORA.H:1409
amrex::Vector< std::string > plot_var_names_2d
Names of 2D variables to output to AMReX plotfile.
Definition REMORA.H:1486
void bulk_fluxes(int lev, amrex::MultiFab *mf_cons, amrex::MultiFab *mf_uwind, amrex::MultiFab *mf_vwind, amrex::MultiFab *mf_Tair, amrex::MultiFab *mf_qair, amrex::MultiFab *mf_Pair, amrex::MultiFab *mf_srflx, amrex::MultiFab *mf_longwave_down, amrex::MultiFab *mf_evap, amrex::MultiFab *mf_sustr, amrex::MultiFab *mf_svstr, amrex::MultiFab *mf_stflux, amrex::MultiFab *mf_lrflx, amrex::MultiFab *mf_lhflx, amrex::MultiFab *mf_shflx, const int N)
Calculate bulk temperature, salinity, wind fluxes.
void t3dmix2_s(const amrex::Box &bx, const amrex::Array4< amrex::Real > &state, const amrex::Array4< amrex::Real > &state_rhs, const amrex::Array4< amrex::Real const > &diff2, const amrex::Array4< amrex::Real const > &Hz, const amrex::Array4< amrex::Real const > &pm, const amrex::Array4< amrex::Real const > &pn, const amrex::Array4< amrex::Real const > &msku, const amrex::Array4< amrex::Real const > &mskv, const amrex::Real dt_lev, const int ncomp)
Harmonic diffusivity for tracers along S-coordinate level surfaces.
const amrex::Vector< std::string > derived_names
Names of derived fields for plotfiles.
Definition REMORA.H:1491
amrex::Vector< amrex::Real > t_old
old time at each level
Definition REMORA.H:1366
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_mskr3d
land/sea mask at cell centers, copied to all z levels (3D)
Definition REMORA.H:467
amrex::Vector< amrex::GpuArray< amrex::Real, AMREX_SPACEDIM *2 > > m_bc_extdir_vals
Array holding the Dirichlet values at walls which need them.
Definition REMORA.H:1394
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_srflx
Shortwave radiation flux [W/m²], defined at rho-points.
Definition REMORA.H:391
amrex::Real last_check_file_time
Simulation time when we last output a checkpoint file.
Definition REMORA.H:1416
void append2DPlotVariables(const std::string &pp_plot_var_names_2d)
void set_bathymetry_averaged_down(int lev)
Copy over bathymetry data that has been averaged down from high resolution input netcdf file.
Definition REMORA.cpp:664
amrex::Vector< amrex::Real > dt
time step at each level
Definition REMORA.H:1368
static amrex::Real sum_per
Diagnostic sum output interval in time.
Definition REMORA.H:1535
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_Pair
Air pressure [mb], defined at rho-points.
Definition REMORA.H:388
void InitializeFromFile()
Read the file passed to remora.restart and use it as an initial condition for the current simulation.
void coriolis(const amrex::Box &xbx, const amrex::Box &ybx, const amrex::Array4< amrex::Real const > &uold, const amrex::Array4< amrex::Real const > &vold, const amrex::Array4< amrex::Real > &ru, const amrex::Array4< amrex::Real > &rv, const amrex::Array4< amrex::Real const > &Hz, const amrex::Array4< amrex::Real const > &fomn, int nrhs, int nr)
Calculate Coriolis terms.
amrex::Gpu::DeviceVector< amrex::BCRec > domain_bcs_type_d
GPU vector (over BCVars) of BCRecs.
Definition REMORA.H:1388
virtual ~REMORA()
Definition REMORA.cpp:226
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_qair
Specific humidity [kg/kg], defined at rho-points.
Definition REMORA.H:386
int hires_grid_level
Which level the high resolution bathymetry is at.
Definition REMORA.H:1554
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_z_w
z coordinates at w points (faces between z-cells)
Definition REMORA.H:352
void restart()
Definition REMORA.cpp:559
std::unique_ptr< NCTimeSeries > vbar_clim_data_from_file
Data container for vbar climatology data read from file.
Definition REMORA.H:1280
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_Tair
Air temperature [°C], defined at rho-points.
Definition REMORA.H:384
void convert_inv_days_to_inv_s(amrex::MultiFab *)
Convert data in a multifab from inverse days to inverse seconds.
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_yr
y_grid on rho points (2D)
Definition REMORA.H:485
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_Hvom
v-volume flux (3D)
Definition REMORA.H:324
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_Akp
Turbulent length scale vertical diffusion coefficient.
Definition REMORA.H:531
void gls_corrector(int lev, amrex::MultiFab *mf_gls, amrex::MultiFab *mf_tke, amrex::MultiFab &mf_W, amrex::MultiFab *mf_Akv, amrex::MultiFab *mf_Akt, amrex::MultiFab *mf_Akk, amrex::MultiFab *mf_Akp, amrex::MultiFab *mf_mskr, amrex::MultiFab *mf_msku, amrex::MultiFab *mf_mskv, const int nstp, const int nnew, const int N, const amrex::Real dt_lev)
Corrector step for GLS calculation.
amrex::Vector< std::unique_ptr< amrex::MultiFab > > vec_diff2
Harmonic diffusivity for temperature / salinity.
Definition REMORA.H:346
int NumTypes(int ncons) noexcept
int xvel_bc(int ncons) noexcept
int zvel_bc(int ncons) noexcept
int yvel_bc(int ncons) noexcept
int vbar_bc(int ncons) noexcept
int foextrap_bc(int ncons) noexcept
int v2d_simple_bc(int ncons) noexcept
int u2d_simple_bc(int ncons) noexcept
int zeta_bc(int ncons) noexcept
int ubar_bc(int ncons) noexcept
int tke_bc(int ncons) noexcept
int foextrap_periodic_bc(int ncons) noexcept
@ CellConservativeQuartic
Definition REMORA.H:74
@ CellBilinear
Definition REMORA.H:71
@ PCInterp
Definition REMORA.H:68
@ NodeBilinear
Definition REMORA.H:69
@ CellConservativeLinear
Definition REMORA.H:70
@ CellQuadratic
Definition REMORA.H:72
@ CellConservativeProtected
Definition REMORA.H:73