swmmx Documentation

Setting Parameters

Setter paths follow m.set.<main_category>.<sub_category>(value, ids=None). They edit writable model inputs in memory and mark results stale when a model already has output loaded.

m.set.conduit.roughness(0.013)
m.set.conduit.roughness([0.013, 0.014], ids=["P001", "P005"])
m.set.node.tag("inspection-needed", ids=["J1", "J2"])

Behavior

InputBehavior
ScalarBroadcast across selected IDs.
List/arrayLength must match selected objects.
pandas Series/DataFrameAccepted for supported structured fields such as point or sequence data.
Read-only fieldDerived and result variables raise ReadOnlyParameterError.
Invalid referenceReference setters validate target IDs where the schema defines a relationship.

Detailed Setter Reference

The full setter notebook is divided into focused pages by model domain.

Common setter patterns

Value inputs, broadcasting, read-only fields, references, and stale results.

Open section

Model options

General, process, date/time, and dynamic-wave option setters.

Open section

Climate and hydrology

Climate, rainfall, subcatchment, infiltration, and LID-related setters.

Open section

Nodes

Composite node setters and detailed junction, outfall, divider, and storage-unit fields.

Open section

Links

Composite link setters plus conduit, pump, orifice, weir, outlet, and cross-section fields.

Open section

Hydraulic geometry and water quality

Inlets, streets, transects, pollutants, land use, buildup, washoff, and treatment.

Open section

Time, map data, summaries, and results

Curves, time series, inflows, controls, coordinates, and read-only summary/result surfaces.

Open section