CatchmentHandler.cpp File Reference

Section handlers for [SUBCATCHMENTS], [SUBAREAS], and [RAINGAGES]. More...

#include "CatchmentHandler.hpp"
#include "../Tokenizer.hpp"
#include "../SectionParser.hpp"
#include "../MultiColumnSeriesFile.hpp"
#include "../../core/ErrorCodes.hpp"
#include "../../core/SimulationContext.hpp"
#include "../../data/SubcatchData.hpp"
#include "../../data/GageData.hpp"
#include "../InputParseUtils.hpp"
#include <algorithm>
#include <charconv>
#include <string>

Include dependency graph for CatchmentHandler.cpp:

Namespaces
namespace	openswmm
namespace	openswmm::input

Functions
void	openswmm::input::handle_subcatchments (SimulationContext &ctx, const std::vector< std::string > &lines)
	Parse subcatchment geometry and authored outlet/gage/snow references.
void	openswmm::input::handle_subareas (SimulationContext &ctx, const std::vector< std::string > &lines)
	Assign surface roughness/depression storage and inter-subarea routing.
void	openswmm::input::handle_infiltration (SimulationContext &ctx, const std::vector< std::string > &lines)
	Assign and check authored subcatchment infiltration parameters.
void	openswmm::input::handle_raingages (SimulationContext &ctx, const std::vector< std::string > &lines)
	Parse rain-gage recording format, source references and file filters.

Detailed Description

Section handlers for [SUBCATCHMENTS], [SUBAREAS], and [RAINGAGES].

[SUBCATCHMENTS] format

;; Name   Gage   Outlet   Area   %Imperv  Width  %Slope  CurbLen  SnowPack
S1        RG1    J1       10.0   50.0     100.0  0.5     0.0

[SUBAREAS] format

;; Subcatch  N-Imperv  N-Perv  S-Imperv  S-Perv  PctZero  RouteTo  PctRouted
S1           0.013     0.1     0.05      0.1     25       OUTLET

[RAINGAGES] format

;; Name   Format    Interval  SCF   Source                 [ScaleFactor]
RG1       VOLUME    0:15      1.0   TIMESERIES RAIN1        2.0
RG2       VOLUME    0:15      1.0   FILE "rain.csv:EAST"    1.5

The trailing ScaleFactor token is optional; it multiplies the gage's rainfall intensity after unit conversion (Build 5.3.0+, parity with legacy gage.c). When two gages share the same TIMESERIES (co-gages), the secondary's rainfall is rescaled by the ratio scale_factor[secondary] / scale_factor[primary].

See also

Legacy reference: src/solver/input.c — readSubcatch(), readGage()

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