RoutingInterfaceFormat.hpp File Reference

SWMM5 routing interface text format — parser / materialiser. More...

#include "FormatTypes.hpp"
#include <string>
#include <vector>

Include dependency graph for RoutingInterfaceFormat.hpp:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Namespaces
namespace	openswmm
namespace	openswmm::gpkg
namespace	openswmm::gpkg::formats

Functions
FormatResult	openswmm::gpkg::formats::parseRoutingInterfaceText (const std::string &path, RoutingInterfaceMetadata &meta, std::vector< RoutingInterfaceRow > &rows)
	Parse a SWMM5 routing-interface text file into metadata + rows.
FormatResult	openswmm::gpkg::formats::writeRoutingInterfaceText (const std::string &path, const RoutingInterfaceMetadata &meta, const std::vector< RoutingInterfaceRow > &rows)
	Write metadata + rows out to a SWMM5 routing-interface text file.

Detailed Description

SWMM5 routing interface text format — parser / materialiser.

Slice IO-6b. Reads and writes the EPA-SWMM routing interface text file format produced and consumed by the legacy iface.c::openFileForOutput / readIfaceFileHeader. Layout:

SWMM5 Interface File
<title>
<step>  - reporting time step in sec
<N+1>   - number of constituents as listed below:
FLOW   <flow-units>
<pollut1>  <units>
...
<M>     - number of nodes as listed below:
<node1>
<node2>
...
Node             Year Mon Day Hr  Min Sec FLOW      <pollut1> ...
<node>  <yyyy> <mm> <dd> <hh> <mm> <ss>  <flow>  <pollut1_value> ...
...

    NOTE: the EPA-SWMM interface file is text, not binary
    (clarification vs. the plan §3.6 v1 table, which originally
    said "binary" — the legacy implementation in `iface.c` writes
    via `fprintf` exclusively).

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\n MIT License