NodesHandler.cpp File Reference

Section handlers for [JUNCTIONS], [OUTFALLS], [DIVIDERS], [STORAGE], [COORDINATES]. More...

#include "NodesHandler.hpp"
#include "../Tokenizer.hpp"
#include "../SectionParser.hpp"
#include "../../core/ErrorCodes.hpp"
#include "../../core/SimulationContext.hpp"
#include "../../data/NodeData.hpp"
#include "../../data/StorageGeometry.hpp"
#include "../InputParseUtils.hpp"
#include <algorithm>
#include <cmath>
#include <cstdlib>
#include <charconv>
#include <string>
#include <string_view>

Include dependency graph for NodesHandler.cpp:

Namespaces
namespace	openswmm
namespace	openswmm::input

Functions
void	openswmm::input::handle_junctions (SimulationContext &ctx, const std::vector< std::string > &lines)
	Parse ordinary junction definitions and retained object comments.
void	openswmm::input::handle_virtual_junctions (SimulationContext &ctx, const std::vector< std::string > &lines)
	Parse virtual-junction authoring flags and optional drawing rim depth.
void	openswmm::input::handle_outfalls (SimulationContext &ctx, const std::vector< std::string > &lines)
	Parse outfall boundary type, stage/reference and optional gate/route target.
void	openswmm::input::handle_dividers (SimulationContext &ctx, const std::vector< std::string > &lines)
	Parse divider methods, deferred references and type-specific hydraulic fields.
void	openswmm::input::handle_storage (SimulationContext &ctx, const std::vector< std::string > &lines)
	Parse storage geometry, raw shape parameters and optional exfiltration.
void	openswmm::input::handle_coordinates (SimulationContext &ctx, const std::vector< std::string > &lines)
	Assign node map coordinates and mark explicit coordinate presence.

Detailed Description

Section handlers for [JUNCTIONS], [OUTFALLS], [DIVIDERS], [STORAGE], [COORDINATES].

[JUNCTIONS] format (legacy SWMM 5.x)

;; Name      Elev   MaxDepth  InitDepth  SurDepth  Aponded
J1           0.0    5.0       0.0        0.0       0.0

[VIRTUAL_JUNCTIONS] format (refactored engine only)

;; Name      Elev   [MaxDepth]
VJ1          9.0
VJ2          9.0    4.5

MaxDepth is optional and RENDERING ONLY — it is the rim/ground depth a viewer draws the surface at. The solver always uses the derived pipe crown.

[OUTFALLS] format

;; Name      Elev   Type      Stage/Tseries  Gated  RouteTo
Out1         0.0    FREE
Out2         0.0    FIXED     1.5
Out3         0.0    TIMESERIES TSERIES1

[STORAGE] format

;; Name      Elev   MaxDepth  InitDepth  Shape   Curve/A1  A2  A0  SurDepth  Fevap  Seep
Pond1        0.0    10.0      0.0        TABULAR POND_CURVE
Pond2        0.0    5.0       0.0        FUNCTIONAL 100  0  50

See also

Legacy reference: src/solver/input.c — readNode(), readOutfall(), readStorage()

Author

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

Copyright

Copyright (c) 2026 Caleb Buahin. All rights reserved.

License

Apache-2.0