Spatial frame containing CRS and georeferenced coordinates. More...

#include <SpatialFrame.hpp>

Collaboration diagram for openswmm::SpatialFrame:

Public Member Functions
void	register_coupling_point (ICouplingPoint *point)
	Register a 2D coupling point.

bool	has_2d_coupling () const noexcept
	Returns true if any 2D coupling points are registered.

void	shrink_to_fit ()
	Release excess vector capacity accumulated during parsing.

Public Attributes
std::string	crs
	CRS specification string.

bool	is_geographic = false
	True if the CRS represents geographic coordinates (lon/lat).

double	map_x1 = 0.0
	Map extent minimum X (left).

double	map_y1 = 0.0
	Map extent minimum Y (bottom).

double	map_x2 = 0.0
	Map extent maximum X (right).

double	map_y2 = 0.0
	Map extent maximum Y (top).

std::string	map_units
	Map units string from [MAP] UNITS keyword.

std::vector< double >	node_x
	Node X coordinates (easting or longitude).

std::vector< double >	node_y
	Node Y coordinates (northing or latitude).

std::vector< double >	link_x
	Link centroid X coordinates.

std::vector< double >	link_y
	Link centroid Y coordinates.

std::vector< double >	subcatch_x
	Subcatchment centroid X.

std::vector< double >	subcatch_y
	Subcatchment centroid Y.

std::vector< std::vector< double > >	link_vertices_x
	Per-link X vertices. link_vertices_x[link_idx] is a vector of X coords.

std::vector< std::vector< double > >	link_vertices_y
	Per-link Y vertices. link_vertices_y[link_idx] is a vector of Y coords.

std::vector< std::vector< double > >	subcatch_polygon_x
	Per-subcatchment polygon X vertices.

std::vector< std::vector< double > >	subcatch_polygon_y
	Per-subcatchment polygon Y vertices.

std::vector< double >	gage_x
	Gage X coordinates.

std::vector< double >	gage_y
	Gage Y coordinates.

std::vector< ICouplingPoint * >	coupling_points
	Registered 2D coupling points.

Detailed Description

Spatial frame containing CRS and georeferenced coordinates.

Coordinates are stored in the CRS specified by the crs field. If crs is empty, coordinates are in model units (as in legacy SWMM).

Arrays are indexed identically to the corresponding SoA data stores (NodeData, LinkData, SubcatchData). Index i in node_x corresponds to node i in NodeData.

Member Function Documentation

◆ has_2d_coupling()

bool openswmm::SpatialFrame::has_2d_coupling ( ) const

inlinenoexcept

Returns true if any 2D coupling points are registered.

◆ register_coupling_point()

void openswmm::SpatialFrame::register_coupling_point ( ICouplingPoint * point )

inline

Register a 2D coupling point.

Parameters

point Non-owning pointer to a coupling point.

◆ shrink_to_fit()

void openswmm::SpatialFrame::shrink_to_fit ( )

inline

Release excess vector capacity accumulated during parsing.

Here is the caller graph for this function:

Member Data Documentation

◆ coupling_points

std::vector<ICouplingPoint*> openswmm::SpatialFrame::coupling_points

Registered 2D coupling points.

2D components register ICouplingPoint objects here to establish exchange at specific 1D objects. The 1D engine calls exchange_to_2d() and receive_from_2d() at each timestep if any coupling points are registered.

Not owned — the 2D component manages the lifetime of these objects.

◆ crs

std::string openswmm::SpatialFrame::crs

CRS specification string.

EPSG code (e.g., "EPSG:4326") or PROJ string (e.g., "+proj=utm +zone=33 +datum=WGS84"). Empty string means no CRS is specified (legacy behavior).

Set from the CRS key in [OPTIONS]:

[OPTIONS]

CRS EPSG:4326

◆ gage_x

std::vector<double> openswmm::SpatialFrame::gage_x

Gage X coordinates.

◆ gage_y

std::vector<double> openswmm::SpatialFrame::gage_y

Gage Y coordinates.

◆ is_geographic

bool openswmm::SpatialFrame::is_geographic = false

True if the CRS represents geographic coordinates (lon/lat).

Used for distance calculations and 2D coupling.

◆ link_vertices_x

std::vector<std::vector<double> > openswmm::SpatialFrame::link_vertices_x

Per-link X vertices. link_vertices_x[link_idx] is a vector of X coords.

◆ link_vertices_y

std::vector<std::vector<double> > openswmm::SpatialFrame::link_vertices_y

Per-link Y vertices. link_vertices_y[link_idx] is a vector of Y coords.

◆ link_x

std::vector<double> openswmm::SpatialFrame::link_x

Link centroid X coordinates.

◆ link_y

std::vector<double> openswmm::SpatialFrame::link_y

Link centroid Y coordinates.

◆ map_units

std::string openswmm::SpatialFrame::map_units

Map units string from [MAP] UNITS keyword.

Typically NONE, FEET, METERS, or DEGREES.

◆ map_x1

double openswmm::SpatialFrame::map_x1 = 0.0

Map extent minimum X (left).

◆ map_x2

double openswmm::SpatialFrame::map_x2 = 0.0

Map extent maximum X (right).

◆ map_y1

double openswmm::SpatialFrame::map_y1 = 0.0

Map extent minimum Y (bottom).

◆ map_y2

double openswmm::SpatialFrame::map_y2 = 0.0

Map extent maximum Y (top).

◆ node_x

std::vector<double> openswmm::SpatialFrame::node_x

Node X coordinates (easting or longitude).

◆ node_y

std::vector<double> openswmm::SpatialFrame::node_y

Node Y coordinates (northing or latitude).

◆ subcatch_polygon_x

std::vector<std::vector<double> > openswmm::SpatialFrame::subcatch_polygon_x

Per-subcatchment polygon X vertices.

◆ subcatch_polygon_y

std::vector<std::vector<double> > openswmm::SpatialFrame::subcatch_polygon_y

Per-subcatchment polygon Y vertices.

◆ subcatch_x

std::vector<double> openswmm::SpatialFrame::subcatch_x

Subcatchment centroid X.

◆ subcatch_y

std::vector<double> openswmm::SpatialFrame::subcatch_y

Subcatchment centroid Y.

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

/home/runner/work/openswmm.engine/openswmm.engine/src/engine/core/SpatialFrame.hpp

Public Member Functions

Public Attributes