Runtime selection of the 2D surface solver backend (Phase 4). More...

#include <memory>
#include <string>

Include dependency graph for SurfaceSolverFactory.hpp:

Namespaces
namespace	openswmm

namespace	openswmm::twoD

Functions
std::unique_ptr< ISurfaceSolver >	openswmm::twoD::makeSurfaceSolver (const SolverOptions2D &opts, std::string *chosen=nullptr, int n_cells=0, bool plugin_capable=true)
	Construct the 2D surface solver per the runtime backend policy.

Detailed Description

Runtime selection of the 2D surface solver backend (Phase 4).

Resolves which ISurfaceSolver to construct based on the OPENSWMM_2D_BACKEND policy, discovering and dlopen()ing a GPU plugin when one is present and usable, and falling back to the serial CPU ExplicitInertialSolver otherwise. This is the runtime half of the portable-GPU strategy — the core stays Kokkos/GPU-free; the device backend lives entirely in a separately built plugin loaded here at runtime.

Selection policy. The mode comes from the OPENSWMM_2D_BACKEND environment variable when set (case-insensitive), else from the model's [2D_OPTIONS] BACKEND (SolverOptions2D::backend): "auto" (default) : try device plugins (cuda, hip, sycl) in order above the device mesh-size floor, then the OpenMP plugin above its own (higher) floor; if none loads with a usable device, use the CPU solver. "cpu" : always the serial CPU solver (no discovery). "omp"|"cuda"|"hip"|"sycl" : load exactly that plugin, bypassing the size floors; if it is absent or has no usable device, warn and fall back to CPU (never hard-fail on GPU absence).

Plugin search path: OPENSWMM_GPU_PLUGIN_PATH (os-separated list), then the directory of the engine shared library, then its gpu subdirectory.

Author: Caleb Buahin caleb.nosp@m..bua.nosp@m.hin@g.nosp@m.mail.nosp@m..com

License\n Apache-2.0

Namespaces

Functions

Detailed Description