ProblemBase Class Reference

#include <ERF_ProbCommon.H>

Collaboration diagram for ProblemBase:

Public Member Functions
virtual	~ProblemBase ()=default
virtual void	erf_init_dens_hse_dry (amrex::MultiFab &, std::unique_ptr< amrex::MultiFab > &, std::unique_ptr< amrex::MultiFab > &, amrex::Geometry const &, const amrex::Vector< amrex::Real > &, bool, bool)
virtual void	erf_init_const_dens_hse (amrex::MultiFab &)
virtual void	erf_init_const_dens_and_th_hse (amrex::MultiFab &, amrex::MultiFab &, amrex::MultiFab &, amrex::MultiFab &, amrex::MultiFab &, amrex::Real)
virtual void	erf_init_const_dens_and_linear_th_hse (amrex::MultiFab &, amrex::MultiFab &, amrex::MultiFab &, amrex::MultiFab &, amrex::MultiFab &, amrex::Real, std::unique_ptr< amrex::MultiFab > &)
virtual void	erf_init_dens_hse_moist (amrex::MultiFab &, std::unique_ptr< amrex::MultiFab > &, amrex::Geometry const &)
virtual void	init_custom_pert (const amrex::Box &, amrex::Array4< amrex::Real const > const &, amrex::Array4< amrex::Real > const &, amrex::Array4< amrex::Real > const &, amrex::Array4< amrex::Real > const &, amrex::Array4< amrex::Real const > const &, amrex::Array4< amrex::Real const > const &, amrex::GeometryData const &, amrex::Array4< amrex::Real const > const &, const SolverChoice &, const int)
virtual void	init_custom_pert_vels (const amrex::Box &, const amrex::Box &, const amrex::Box &, amrex::Array4< amrex::Real > const &, amrex::Array4< amrex::Real > const &, amrex::Array4< amrex::Real > const &, amrex::Array4< amrex::Real const > const &, amrex::GeometryData const &, amrex::Array4< amrex::Real const > const &, amrex::Array4< amrex::Real const > const &, const SolverChoice &, const int)
virtual void	update_rhotheta_sources (const double &, amrex::MultiFab *src, const amrex::Geometry &, std::unique_ptr< amrex::MultiFab > &, const amrex::Vector< amrex::Real > &)
virtual void	update_rhoqt_sources (const double &, amrex::MultiFab *qsrc, const amrex::Geometry &, std::unique_ptr< amrex::MultiFab > &, const amrex::Vector< amrex::Real > &)
virtual void	update_w_subsidence (const double &, amrex::Vector< amrex::Real > &wbar, amrex::Gpu::DeviceVector< amrex::Real > &d_wbar, const amrex::MultiFab &, const amrex::Geometry &geom, std::unique_ptr< amrex::MultiFab > &, const amrex::Vector< amrex::Real > &)
virtual void	update_geostrophic_profile (const double &, amrex::Vector< amrex::Real > &u_geos, amrex::Gpu::DeviceVector< amrex::Real > &d_u_geos, amrex::Vector< amrex::Real > &v_geos, amrex::Gpu::DeviceVector< amrex::Real > &d_v_geos, const amrex::Geometry &geom, std::unique_ptr< amrex::MultiFab > &, const amrex::Vector< amrex::Real > &)
void	init_buildings_surface (const amrex::Geometry &geom, amrex::FArrayBox &buildings_fab, const double &time)
void	init_terrain_surface (const amrex::Geometry &geom, amrex::FArrayBox &terrain_fab, const double &time)
virtual bool	terrain_is_specified ()
void	read_custom_terrain (const std::string &fname, const bool is_usgs, const amrex::Geometry &geom, amrex::FArrayBox &terrain_fab, const double &)
virtual void	init_custom_terrain (const amrex::Geometry &geom, amrex::FArrayBox &terrain_fab, const double &time)
virtual void	erf_init_rayleigh (amrex::Vector< amrex::Vector< amrex::Real > > &, amrex::Geometry const &, std::unique_ptr< amrex::MultiFab > &, amrex::Real)

Protected Member Functions
void	init_base_parms (amrex::Real rho_0, amrex::Real T_0)
std::string	name ()

Protected Attributes
ProbParmDefaults	base_parms

Detailed Description

Class to hold problem-specific routines

Constructor & Destructor Documentation

~ProblemBase()

virtual ProblemBase::~ProblemBase ( )

virtualdefault

Virtual destructor to avoid data leakage with derived class

Member Function Documentation

erf_init_const_dens_and_linear_th_hse()

virtual void ProblemBase::erf_init_const_dens_and_linear_th_hse ( amrex::MultiFab &  , amrex::MultiFab &  , amrex::MultiFab &  , amrex::MultiFab &  , amrex::MultiFab &  , amrex::Real  , std::unique_ptr< amrex::MultiFab > &    )

inlinevirtual

    {
        amrex::Error("Should never call this version of erf_init_const_dens_and_linear_th_hse for "+name()+" problem");
    }

Here is the call graph for this function:

erf_init_const_dens_and_th_hse()

virtual void ProblemBase::erf_init_const_dens_and_th_hse ( amrex::MultiFab &  , amrex::MultiFab &  , amrex::MultiFab &  , amrex::MultiFab &  , amrex::MultiFab &  , amrex::Real    )

inlinevirtual

    {
        amrex::Error("Should never call this version of erf_init_const_dens_and_th_hse for "+name()+" problem");
    }

Here is the call graph for this function:

erf_init_const_dens_hse()

virtual void ProblemBase::erf_init_const_dens_hse ( amrex::MultiFab &  )

inlinevirtual

    {
        amrex::Error("Should never call this version of erf_init_const_dens_hse for "+name()+" problem");
    }

Here is the call graph for this function:

erf_init_dens_hse_dry()

virtual void ProblemBase::erf_init_dens_hse_dry ( amrex::MultiFab &  , std::unique_ptr< amrex::MultiFab > &  , std::unique_ptr< amrex::MultiFab > &  , amrex::Geometry const &  , const amrex::Vector< amrex::Real > &  , bool  , bool    )

inlinevirtual

Function to initialize the hydrostatic reference density

Parameters

[out]	rho_hse	hydrostatic reference density
[in]	z_phys_nd	height coordinate at nodes
[in]	z_phys_cc	height coordinate at cell centers
[in]	geom	container for geometric information

    {
        amrex::Print() << "Hydrostatically balanced density was NOT set"
            << " -- an appropriate init_type should probably have been specified"
            << " (e.g., input_sounding, WRFInput, or Metgrid)"
            << std::endl;
        amrex::Error("Should never call this version of erf_init_dens_hse_dry for "+name()+" problem");
    }

Here is the call graph for this function:

erf_init_dens_hse_moist()

virtual void ProblemBase::erf_init_dens_hse_moist ( amrex::MultiFab &  , std::unique_ptr< amrex::MultiFab > &  , amrex::Geometry const &    )

inlinevirtual

    {
 
    }

erf_init_rayleigh()

virtual void ProblemBase::erf_init_rayleigh ( amrex::Vector< amrex::Vector< amrex::Real > > &  , amrex::Geometry const &  , std::unique_ptr< amrex::MultiFab > &  , amrex::Real    )

inlinevirtual

Function to define the quantities needed to impose Rayleigh damping

Parameters

[out]	rayleigh_ptrs	= {strength of Rayleigh damping, reference values for xvel/yvel/zvel/theta used to define Rayleigh damping}
[in]	geom	container for geometric information
[in]	z_phys_cc	height coordinate at cell centers

    {
        // Default which does no harm
    }

init_base_parms()

void ProblemBase::init_base_parms ( amrex::Real  rho_0, amrex::Real  T_0  )

inlineprotected

Function to update default base parameters, currently only used for init_type == InitType::Uniform

                                                          {
        base_parms.rho_0 = rho_0;
        base_parms.T_0 = T_0;
    }

init_buildings_surface()

void ProblemBase::init_buildings_surface ( const amrex::Geometry &  geom, amrex::FArrayBox &  buildings_fab, const double &  time  )

inline

Function to perform custom initialization of buildings

Parameters

[in]	geom	container for geometric information
[out]	z_phys_nd	height coordinate at nodes
[in]	time	current time

    {
        // Check if a valid text file exists for the buildings
        std::string fname;
        amrex::ParmParse pp("erf");
        auto valid_fname = pp.queryAdd("buildings_file_name",fname);
 
        if (valid_fname) {
            read_custom_terrain(fname,false,geom,buildings_fab,time);
        } else {
            init_my_custom_terrain(geom, buildings_fab, time);
        }
    }

Here is the call graph for this function:

init_custom_pert()

virtual void ProblemBase::init_custom_pert ( const amrex::Box &  , amrex::Array4< amrex::Real const > const &  , amrex::Array4< amrex::Real > const &  , amrex::Array4< amrex::Real > const &  , amrex::Array4< amrex::Real > const &  , amrex::Array4< amrex::Real const > const &  , amrex::Array4< amrex::Real const > const &  , amrex::GeometryData const &  , amrex::Array4< amrex::Real const > const &  , const SolverChoice &  , const int    )

inlinevirtual

Function to perform custom initialization of a test problem

Parameters

[in]	bx	cell-centered box on which to initialize scalars
[out]	state	cell-centered variables to be filled in this routine
[out]	r_hse	hydrostatic reference density
[out]	p_hse	hydrostatic reference pressure
[in]	z_nd	height coordinate at nodes
[in]	z_cc	height coordinate at cell centers
[in]	mf_m	map factor on cell centers
[in]	mf_u	map factor on x-faces
[in]	mf_v	map factor on y-faces
[in]	sc	SolverChoice structure that carries parameters
[in]	lev	AMR level

    {
        amrex::Print() << "No perturbation to background fields supplied for "
            << name() << " problem" << std::endl;
    }

Here is the call graph for this function:

init_custom_pert_vels()

virtual void ProblemBase::init_custom_pert_vels ( const amrex::Box &  , const amrex::Box &  , const amrex::Box &  , amrex::Array4< amrex::Real > const &  , amrex::Array4< amrex::Real > const &  , amrex::Array4< amrex::Real > const &  , amrex::Array4< amrex::Real const > const &  , amrex::GeometryData const &  , amrex::Array4< amrex::Real const > const &  , amrex::Array4< amrex::Real const > const &  , const SolverChoice &  , const int    )

inlinevirtual

Function to perform custom initialization of the velocities

Parameters

[in]	xbx	box on which to initialize x_vel_pert
[in]	ybx	box on which to initialize y_vel_pert
[in]	zbx	box on which to initialize z_vel_pert
[out]	x_vel_pert	x-component of velocity perturbation to be filled in this routine
[out]	y_vel_pert	y-component of velocity perturbation to be filled in this routine
[out]	z_vel_pert	z-component of velocity perturbation to be filled in this routine
[in]	z_nd	height coordinate at nodes
[in]	mf_m	map factor on cell centers
[in]	mf_u	map factor on x-faces
[in]	mf_v	map factor on y-faces
[in]	sc	SolverChoice structure that carries parameters
[in]	lev	AMR level

    {
        amrex::Print() << "No perturbation velocities supplied for " << name() << " problem" << std::endl;
    }

Here is the call graph for this function:

init_custom_terrain()

virtual void ProblemBase::init_custom_terrain ( const amrex::Geometry &  geom, amrex::FArrayBox &  terrain_fab, const double &  time  )

inlinevirtual

Function to perform custom initialization of terrain

Note: Terrain functionality can also be used to provide grid stretching.

Parameters

[in]	geom	container for geometric information
[out]	terrain_mf	height coordinate at nodes
[in]	time	current time

    {
        std::string custom_terrain_type = "None";
        amrex::ParmParse pp_prob("prob"); pp_prob.queryAdd("custom_terrain_type",custom_terrain_type);
 
        if (custom_terrain_type != "None")
        {
            amrex::Print() << "Calling custom terrain initialization" << std::endl;
            init_my_custom_terrain(geom,terrain_fab,time);
 
        } else {
            amrex::Print() << "Initializing flat terrain" << std::endl;
            terrain_fab.template setVal<amrex::RunOn::Device>(0);
 
            if (SolverChoice::mesh_type == MeshType::VariableDz) {
                SolverChoice::set_mesh_type(MeshType::StretchedDz);
                amrex::Print() << "Resetting mesh type to StretchedDz" << std::endl;
            }
        }
    }

Here is the call graph for this function:

init_terrain_surface()

void ProblemBase::init_terrain_surface ( const amrex::Geometry &  geom, amrex::FArrayBox &  terrain_fab, const double &  time  )

inline

Function to perform custom initialization of terrain

Parameters

[in]	geom	container for geometric information
[out]	z_phys_nd	height coordinate at nodes
[in]	time	current time

    {
        amrex::ParmParse pp("erf");
 
        // NetCDF terrain file takes priority
        std::string fname_nc;
        auto valid_fname_nc = pp.query("terrain_file_name_nc", fname_nc);
 
        std::string fname, fname_usgs;
        auto valid_fname      = pp.query("terrain_file_name",      fname);
        auto valid_fname_USGS = pp.query("terrain_file_name_USGS", fname_usgs);
 
        if (valid_fname_nc) {
#ifdef ERF_USE_NETCDF
            read_terrain_netcdf(fname_nc, geom, terrain_fab, time);
#else
            amrex::Abort("ERF must be compiled with NetCDF support to use terrain_file_name_nc");
#endif
        } else if (valid_fname) {
            read_custom_terrain(fname, false, geom, terrain_fab, time);
 
        } else if (valid_fname_USGS) {
            read_custom_terrain(fname_usgs, true, geom, terrain_fab, time);
 
        } else {
            init_my_custom_terrain (geom, terrain_fab, time);
        }
    }

Referenced by fill_terrain_surface_slab().

Here is the call graph for this function:

Here is the caller graph for this function:

name()

std::string ProblemBase::name ( )

inlineprotected

                      {
        std::string prob_name;
        amrex::ParmParse pp("erf");
        pp.get("prob_name",prob_name); return prob_name;
    }

Referenced by erf_init_const_dens_and_linear_th_hse(), erf_init_const_dens_and_th_hse(), erf_init_const_dens_hse(), erf_init_dens_hse_dry(), init_custom_pert(), init_custom_pert_vels(), update_geostrophic_profile(), update_rhoqt_sources(), update_rhotheta_sources(), and update_w_subsidence().

Here is the call graph for this function:

Here is the caller graph for this function:

read_custom_terrain()

void ProblemBase::read_custom_terrain ( const std::string &  fname, const bool  is_usgs, const amrex::Geometry &  geom, amrex::FArrayBox &  terrain_fab, const double &    )

inline

    {
        amrex::Vector<amrex::Real> m_xterrain,m_yterrain,m_zterrain;
 
        int nx = 0; int ny = 0;
 
        if (amrex::ParallelDescriptor::IOProcessor()) {
            // Read terrain file
            amrex::Print()<<"Reading terrain file: "<< fname<< std::endl;
            std::ifstream file(fname);
 
            if (!file.is_open()) {
                amrex::Abort("Error: Could not open the file " + fname+ "\n");
            }
 
            // Check if file is empty
            if (file.peek() == std::ifstream::traits_type::eof()) {
                amrex::Abort("Error: The file  " + fname+ " is empty.\n");
            }
 
            amrex::Real value1,value2,value3;
 
            if (is_usgs) {
                amrex::Real lat_min, lon_min;
 
                file >> lon_min >> lat_min;
                 if(std::fabs(lon_min) > amrex::Real(180.0)) {
                    amrex::Error("The value of longitude for entry in the first line in " + fname
                                 + " should not exceed amrex::Real(180.) It is " + std::to_string(lon_min));
                }
                 if(std::fabs(lat_min) > amrex::Real(90.0)) {
                    amrex::Error("The value of latitude for entry in the first line in " + fname
                                 + " should not exceed amrex::Real(90.) It is " + std::to_string(lat_min));
                }
 
                file >> nx >> ny;
 
                int counter = 0;
                while (file >> value1 >> value2 >> value3) {
                    m_xterrain.push_back(value1);
                    if(counter%nx==0) {
                        m_yterrain.push_back(value2);
                    }
                    m_zterrain.push_back(value3);
                    counter += 1;
                }
                AMREX_ASSERT(m_xterrain.size() == static_cast<long int>(nx*ny));
                AMREX_ASSERT(m_yterrain.size() == static_cast<long int>(ny));
                AMREX_ASSERT(m_zterrain.size() == static_cast<long int>(nx*ny));
 
            } else {
                int cnt = 1;
                nx = erf_get_single_value<int>(file,cnt); cnt++;
                ny = erf_get_single_value<int>(file,cnt); cnt++;
                amrex::Print()<<"Expecting " << nx << " values of x,    " <<
                                                ny << " values of y, and " <<
                                             nx*ny << " values of z" << std::endl;
                AMREX_ALWAYS_ASSERT(nx > 0);
                AMREX_ALWAYS_ASSERT(ny > 0);
                m_xterrain.resize(nx);
                m_yterrain.resize(ny);
                m_zterrain.resize(nx * ny);
                for (int n = 0; n < nx; n++) {
                    m_xterrain[n] = erf_get_single_value<amrex::Real>(file,cnt);
                    cnt++;
                }
                for (int n = 0; n < ny; n++) {
                    m_yterrain[n] = erf_get_single_value<amrex::Real>(file,cnt);
                    cnt++;
                }
                for (int n = 0; n < nx * ny; n++) {
                    m_zterrain[n] = erf_get_single_value<amrex::Real>(file,cnt);
                    cnt++;
                }
            }
 
            // Close the file after reading
            file.close();
        }
 
        amrex::ParallelDescriptor::Bcast(&nx,1,amrex::ParallelDescriptor::IOProcessorNumber());
        amrex::ParallelDescriptor::Bcast(&ny,1,amrex::ParallelDescriptor::IOProcessorNumber());
 
        AMREX_ALWAYS_ASSERT(nx > 0 && ny > 0);
        if (is_usgs) {
            // The usgs branch below always uses a full 2x2 stencil
            AMREX_ALWAYS_ASSERT_WITH_MESSAGE(nx > 1 && ny > 1,
                "USGS terrain file must have at least two points in each direction");
        }
 
        int nz = nx * ny;
        int nx_vals = is_usgs ? (nx * ny) : nx;
 
        m_xterrain.resize(nx_vals);
        m_yterrain.resize(ny);
        m_zterrain.resize(nz);
 
        amrex::ParallelDescriptor::Bcast(m_xterrain.data(),nx_vals,amrex::ParallelDescriptor::IOProcessorNumber());
        amrex::ParallelDescriptor::Bcast(m_yterrain.data(),ny,amrex::ParallelDescriptor::IOProcessorNumber());
        amrex::ParallelDescriptor::Bcast(m_zterrain.data(),nz,amrex::ParallelDescriptor::IOProcessorNumber());
 
        // Copy data to the GPU
        amrex::Gpu::DeviceVector<amrex::Real> d_xterrain(nx_vals),d_yterrain(ny),d_zterrain(nz);
        amrex::Gpu::copy(amrex::Gpu::hostToDevice, m_xterrain.begin(), m_xterrain.end(), d_xterrain.begin());
        amrex::Gpu::copy(amrex::Gpu::hostToDevice, m_yterrain.begin(), m_yterrain.end(), d_yterrain.begin());
        amrex::Gpu::copy(amrex::Gpu::hostToDevice, m_zterrain.begin(), m_zterrain.end(), d_zterrain.begin());
 
        amrex::Real* d_xt = d_xterrain.data();
        amrex::Real* d_yt = d_yterrain.data();
        amrex::Real* d_zt = d_zterrain.data();
 
        auto dx = geom.CellSizeArray();
        auto ProbLoArr = geom.ProbLoArray();
 
        int ilo = geom.Domain().smallEnd(0);
        int jlo = geom.Domain().smallEnd(1);
        int klo = geom.Domain().smallEnd(2);
        int ihi = geom.Domain().bigEnd(0) + 1;
        int jhi = geom.Domain().bigEnd(1) + 1;
 
        amrex::Box zbx = terrain_fab.box();
        amrex::Array4<amrex::Real> const& z_arr = terrain_fab.array();
 
        amrex::ParallelFor(zbx, [=] AMREX_GPU_DEVICE (int i, int j, int /*k*/)
        {
            // Clip indices for ghost cells
            int ii = amrex::min(amrex::max(i,ilo),ihi);
            int jj = amrex::min(amrex::max(j,jlo),jhi);
 
            // Location of nodes
            amrex::Real x = ProbLoArr[0] + ii * dx[0] + amrex::Real(1e-3);
            amrex::Real y = ProbLoArr[1] + jj * dx[1] + amrex::Real(1e-3);
 
            int ind11, ind12, ind21, ind22;
            amrex::Real x1, x2, y1, y2;
 
            int iindex_terrain=-1;
            int jindex_terrain=-1;
            // *******************************************************************
            // NOTE: usgs-format is contiguous in x
            // *******************************************************************
            if (is_usgs) {
 
                // NOTE: the searches below must distinguish "the node is below the first
                //       table value" (bracket index -1) from "no table value exceeds the
                //       node" (search never triggered), so we can not use the initial
                //       value of -1 as the not-found flag
                bool jfound = false;
                for (int it = 0; it < ny && !jfound; it++) {
                    if (d_yt[it] > y) {
                        jindex_terrain = it-1; jfound = true;
                    }
                }
                if (!jfound) {
                    jindex_terrain = ny-1;
                }
                // Keep the 2x2 stencil inside the table
                jindex_terrain = amrex::min(amrex::max(jindex_terrain,0), ny-2);
 
                int gstart = (jindex_terrain  )*nx;
                int gend   = (jindex_terrain+1)*nx-1;
                bool ifound = false;
                for (int it = gstart; it <= gend && !ifound; it++) {
                    if (d_xt[it] > x) {
                        iindex_terrain = it-gstart-1; ifound = true;
                    }
                }
                if (!ifound) {
                    iindex_terrain = nx-1;
                }
                // Keep the 2x2 stencil inside the table
                iindex_terrain = amrex::min(amrex::max(iindex_terrain,0), nx-2);
 
                // Define the four values to interpolate between
                ind11 = jindex_terrain*nx + iindex_terrain; // (x1,y1)
                ind12 = ind11+nx;                           // (x1,y2)
                ind21 = ind11+1;                            // (x2,y1)
                ind22 = ind12+1;                            // (x2,y2)
 
                x1 = d_xt[ind11];
                x2 = d_xt[ind21];
                y1 = d_yt[jindex_terrain];
                y2 = d_yt[jindex_terrain+1];
 
                amrex::Real denom = (x2-x1)*(y2-y1);
 
                if (denom == amrex::Real(0.0)) {
                    // Degenerate cell (repeated x or y in the table) -- use the corner value
                    z_arr(i,j,klo) = d_zt[ind11];
                } else {
                    amrex::Real  w_11 = (x2-x)*(y2-y)/denom; // (x1,y1)
                    amrex::Real  w_12 = (x2-x)*(y-y1)/denom; // (x1,y2)
                    amrex::Real  w_21 = (x-x1)*(y2-y)/denom; // (x2,y1)
                    amrex::Real  w_22 = (x-x1)*(y-y1)/denom; // (x2,y2)
 
                    // Do bilinear interpolation
                    z_arr(i,j,klo) = w_11*d_zt[ind11] + w_12*d_zt[ind12] + w_21*d_zt[ind21] + w_22*d_zt[ind22];
                }
 
            } else {
 
                bool jfound = false;
                for (int it = 0; it < ny && !jfound; it++) {
                    if (d_yt[it] > y) {
                        jindex_terrain = it-1; jfound = true;
                    }
                }
                if (!jfound) {
                    // No table value exceeds y -- fall back to the last row
                    jindex_terrain = ny-1;
                }
                jindex_terrain = amrex::max(jindex_terrain,0);
 
                bool ifound = false;
                for (int it = 0; it < nx && !ifound; it++) {
                    if (d_xt[it] > x) {
                        iindex_terrain = it-1; ifound = true;
                    }
                }
                if (!ifound) {
                    // No table value exceeds x -- fall back to the last column
                    iindex_terrain = nx-1;
                }
                iindex_terrain = amrex::max(iindex_terrain,0);
 
                // NOTE: these must be clamped since the fallbacks above can leave
                //       iindex_terrain = nx-1 (jindex_terrain = ny-1)
                int ip1 = amrex::min(iindex_terrain+1,nx-1);
                int jp1 = amrex::min(jindex_terrain+1,ny-1);
 
                // Define the four values to interpolate between
                x1 = d_xt[iindex_terrain];
                x2 = d_xt[ip1];
                y1 = d_yt[jindex_terrain];
                y2 = d_yt[jp1];
 
#if 1
                // *******************************************************************
                // NOTE: this format is contiguous in y to match the AMR-Wind read
                // *******************************************************************
                ind11 = iindex_terrain * ny + jindex_terrain;  // (x1,y1)
                ind21 = ip1            * ny + jindex_terrain;  // (x2,y1)
 
                ind12 = iindex_terrain * ny + jp1;             // (x1,y2)
                ind22 = ip1            * ny + jp1;             // (x2,y2)
#else
                // *******************************************************************
                // NOTE: this format is contiguous in x as an alternative
                // *******************************************************************
 
                ind11 = jindex_terrain * nx + iindex_terrain;  // (x1,y1)
                ind12 = jp1            * nx + iindex_terrain;  // (x1,y2)
 
                ind21 = jindex_terrain * nx + ip1;             // (x2,y1)
                ind22 = jp1            * nx + ip1;             // (x2,y2)
#endif
 
                // Only interpolate in a direction if we have a non-degenerate interval there
                bool interp_x = (ip1 != iindex_terrain) && (x2 != x1);
                bool interp_y = (jp1 != jindex_terrain) && (y2 != y1);
 
                if (!interp_x && !interp_y)
                {
                    z_arr(i,j,klo) = d_zt[ind11];
                }
                else if (interp_x && !interp_y)
                {
                    amrex::Real  w_11 = (x2-x); // (x1,y1)
                    amrex::Real  w_21 = (x-x1); // (x2,y1)
                    amrex::Real denom = (x2-x1);
                    z_arr(i,j,klo) = (w_11*d_zt[ind11] + w_21*d_zt[ind21])/denom;
                }
                else if (!interp_x && interp_y)
                {
                    amrex::Real  w_11 = (y2-y); // (x1,y1)
                    amrex::Real  w_12 = (y-y1); // (x1,y2)
                    amrex::Real denom = (y2-y1);
                    z_arr(i,j,klo) = (w_11*d_zt[ind11] + w_12*d_zt[ind12])/denom;
                }
                else
                {
                    amrex::Real  w_11 = (x2-x)*(y2-y); // (x1,y1)
                    amrex::Real  w_21 = (x-x1)*(y2-y); // (x2,y1)
                    amrex::Real  w_12 = (x2-x)*(y-y1); // (x1,y2)
                    amrex::Real  w_22 = (x-x1)*(y-y1); // (x2,y2)
                    amrex::Real denom = (x2-x1)*(y2-y1);
                    z_arr(i,j,klo) = (w_11*d_zt[ind11] + w_12*d_zt[ind12] + w_21*d_zt[ind21] + w_22*d_zt[ind22]) / denom;
                }
            } // usgs?
        });
    }

Referenced by init_buildings_surface(), and init_terrain_surface().

Here is the call graph for this function:

Here is the caller graph for this function:

terrain_is_specified()

virtual bool ProblemBase::terrain_is_specified ( )

inlinevirtual

Function to report whether the user has actually specified a terrain surface, i.e. whether init_terrain_surface will do anything other than return flat terrain.

This mirrors the source precedence in init_terrain_surface, and is deliberately kept next to it so that the two cannot drift apart. A problem that overrides the terrain unconditionally, rather than keying off prob.custom_terrain_type, should override this to return true.

    {
        amrex::ParmParse pp("erf");
        std::string fname;
        if (pp.query("terrain_file_name_nc",   fname) ||
            pp.query("terrain_file_name",      fname) ||
            pp.query("terrain_file_name_USGS", fname)) {
            return true;
        }
 
        std::string custom_terrain_type = "None";
        amrex::ParmParse pp_prob("prob");
        pp_prob.query("custom_terrain_type", custom_terrain_type);
        return (custom_terrain_type != "None");
    }

Here is the call graph for this function:

update_geostrophic_profile()

virtual void ProblemBase::update_geostrophic_profile ( const double &  , amrex::Vector< amrex::Real > &  u_geos, amrex::Gpu::DeviceVector< amrex::Real > &  d_u_geos, amrex::Vector< amrex::Real > &  v_geos, amrex::Gpu::DeviceVector< amrex::Real > &  d_v_geos, const amrex::Geometry &  geom, std::unique_ptr< amrex::MultiFab > &  , const amrex::Vector< amrex::Real > &    )

inlinevirtual

Function to update user-specified geostrophic wind profile.

Parameters

[in]	time	current time
[out]	u_geos	geostrophic wind profile
[out]	v_geos	geostrophic wind profile
[in]	geom	container for geometric information
[in]	z_phys_cc	height coordinate at cell centers
[in]	zlevels_stag	nominal heights of the z faces of this level

    {
        if (u_geos.empty()) return;
 
        amrex::Warning("Geostrophic wind profile not defined for "+name()+" problem");
 
        const int khi              = geom.Domain().bigEnd()[2];
        // const amrex::Real* prob_lo = geom.ProbLo();
        // const auto dx              = geom.CellSize();
        for (int k = 0; k <= khi; k++)
        {
            // const amrex::Real z_cc = prob_lo[2] + (k+myhalf)* dx[2];
            // set RHS term of RhoTheta equation based on time, z_cc here
            u_geos[k] = zero;
            v_geos[k] = zero;
        }
 
        // Copy from host version to device version
        amrex::Gpu::copy(amrex::Gpu::hostToDevice, u_geos.begin(), u_geos.end(), d_u_geos.begin());
        amrex::Gpu::copy(amrex::Gpu::hostToDevice, v_geos.begin(), v_geos.end(), d_v_geos.begin());
    }

Here is the call graph for this function:

update_rhoqt_sources()

virtual void ProblemBase::update_rhoqt_sources ( const double &  , amrex::MultiFab *  qsrc, const amrex::Geometry &  , std::unique_ptr< amrex::MultiFab > &  , const amrex::Vector< amrex::Real > &    )

inlinevirtual

Function to update user-specified moisture source terms that can vary with time and height.

Parameters

[in]	time	current time
[out]	rhoqt_source	moisture forcing profile
[in]	geom	container for geometric information
[in]	z_phys_cc	height coordinate at cell centers
[in]	zlevels_stag	nominal heights of the z faces of this level

    {
        if (qsrc->empty()) return;
 
        amrex::Warning("Moisture forcing not defined for "+name()+" problem");
        for ( amrex::MFIter mfi(*qsrc, amrex::TilingIfNotGPU()); mfi.isValid(); ++mfi )
        {
            const auto &box = mfi.tilebox();
            const amrex::Array4<amrex::Real>& qsrc_arr = qsrc->array(mfi);
            // src is a spatial function if erf.spatial_moisture_forcing = true
            // otherwise, qsrc_arr is defined only in over Z (box x and y dimensions are 1)
            ParallelFor(box, [=] AMREX_GPU_DEVICE (int i, int j, int k) noexcept {
                // const amrex::Real z_cc = prob_lo[2] + (k+myhalf)* dx[2];
                // set RHS term of RhoQ1 equation based on time, z_cc here
                qsrc_arr(i, j, k) = zero;
            });
        }
    }

Here is the call graph for this function:

update_rhotheta_sources()

virtual void ProblemBase::update_rhotheta_sources ( const double &  , amrex::MultiFab *  src, const amrex::Geometry &  , std::unique_ptr< amrex::MultiFab > &  , const amrex::Vector< amrex::Real > &    )

inlinevirtual

Function to update user-specified temperature source terms that can vary with time and height.

Parameters

[in]	time	current time
[out]	rhotheta_source	forcing profile
[in]	geom	container for geometric information
[in]	z_phys_cc	height coordinate at cell centers
[in]	zlevels_stag	nominal heights of the z faces of this level

    {
        if (src->empty()) return;
 
        amrex::Warning("Temperature forcing not defined for "+name()+" problem");
        for ( amrex::MFIter mfi(*src, amrex::TilingIfNotGPU()); mfi.isValid(); ++mfi )
        {
            const auto &box = mfi.tilebox();
            const amrex::Array4<amrex::Real>& src_arr = src->array(mfi);
            // src is a spatial function if erf.spatial_rhotheta_forcing = true
            // otherwise, qsrc_arr is defined only in over Z (box x and y dimensions are 1)
            ParallelFor(box, [=] AMREX_GPU_DEVICE (int i, int j, int k) noexcept {
                // const amrex::Real z_cc = prob_lo[2] + (k+myhalf)* dx[2];
                // set RHS term of RhoTheta equation based on time, z_cc here
                src_arr(i, j, k) = zero;
            });
        }
    }

Here is the call graph for this function:

update_w_subsidence()

virtual void ProblemBase::update_w_subsidence ( const double &  , amrex::Vector< amrex::Real > &  wbar, amrex::Gpu::DeviceVector< amrex::Real > &  d_wbar, const amrex::MultiFab &  , const amrex::Geometry &  geom, std::unique_ptr< amrex::MultiFab > &  , const amrex::Vector< amrex::Real > &    )

inlinevirtual

Function to update the vertical velocity profile, used to add subsidence source terms for x-mom, y-mom, rho*theta, rho*Q1, and rho*Q2.

TODO: Currently, this is only called by InitData, so there is no time dependence.

Parameters

[in]	time	current time
[out]	wbar	w vel forcing profile
[in]	geom	container for geometric information
[in]	z_phys_cc	height coordinate at cell centers
[in]	zlevels_stag	nominal heights of the z faces of this level

    {
        if (wbar.empty()) return;
 
        amrex::Warning("Moisture forcing not defined for "+name()+" problem");
 
        const int khi              = geom.Domain().bigEnd()[2];
        // const amrex::Real* prob_lo = geom.ProbLo();
        // const auto dx              = geom.CellSize();
        for (int k = 0; k <= khi; k++)
        {
            // const amrex::Real z_cc = prob_lo[2] + (k+myhalf)* dx[2];
            // set vertical velocity profile based on time, z_cc here
            wbar[k] = zero;
        }
 
        // Copy from host version to device version
        amrex::Gpu::copy(amrex::Gpu::hostToDevice, wbar.begin(), wbar.end(), d_wbar.begin());
    }

Here is the call graph for this function:

Member Data Documentation

base_parms

ProbParmDefaults ProblemBase::base_parms

protected

Referenced by init_base_parms().

---

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

• Source/ERF_ProbCommon.H