Appendix B. Menu reference

Every item of the SWMM workspace's menu bar, one line each, in menu order. Items are greyed when they do not apply (no model open, nothing selected, no run yet).

File

Item Does
New SWMM Model A blank model (asks about unsaved changes). Ctrl+N
Open… Open a model; a .ssproj, .ssn, .stm, LandXML or DXF network converts to one (§13.1). Ctrl+O
Merge Model… Add another .inp's objects; taken names are renamed, one undo step (§13.6)
Storm Replay… A past storm on the real ground: USGS terrain and the rain NOAA measured, run as rain on a 2D grid (§20.12)
Recent Models The last eight models opened
Save Save to the model's path. Ctrl+S
Save As… Save to a new path. Ctrl+Shift+S
Revert to Saved Read the model's file again, dropping the edits since it was saved (asks first)
Close Close the model: the map is empty until New or Open (asks about unsaved changes). Ctrl+W
Import → AquaSWMM Project (.ssproj / .ssn)… A new SWMM model from a storm-sewer project (§13.1)
Export → AquaSWMM Project (.ssproj)… The model as a storm-sewer project (§13.2)
Export → Network CSV (nodes, links)… Two CSV tables (§13.3)
Export → GeoJSON (map units, no CRS)… One FeatureCollection (§13.4)
Export → Map Image (PNG)… The map as drawn — basemap, 2D overlay, results colours, labels, scale bar — as a PNG at screen resolution; available in viewer mode
Design Reports → … The storm-sewer design's PDF/print and HTML reports, custom reports and DXF/LandXML exports, analysing first if needed (§12.6)
GIS & Terrain → … GIS layers, DEMs, soils, land cover, landscapes, watershed delineation, QGIS and the model CRS (chapter 19); the items below are in it
GIS & Terrain → DXF Underlay… A DXF drawn under the map
Download Soils (SSURGO)… NRCS SSURGO map units with hydrologic soil groups for the view or the model, in the model CRS, saved beside it as <model>_ssurgo.geojson (§19.13)
Download Land Cover (NLCD 2021)… NLCD 2021 land cover at 30 m for the view or the model, in the model CRS, saved beside it as <model>_nlcd2021.tif (§19.14)
Download Landscape (NOAA)… NOAA land and sea-floor elevations and, on the coast, the nautical chart, drawn under the map; a picture only, not a design surface (§19.16)
Landscape 3D View The downloaded landscape as a 3D scene (§19.16)
Exit Close AquaSWMM (asks about unsaved changes). Ctrl+Q

Edit

Item Does
Undo label Undo the named step. Ctrl+Z
Redo label Redo it. Ctrl+Y
Cut / Copy / Paste The selection, with references remapped on paste
Delete The selection, after the Delete takes more with it check
Select All Every object
Find Object… Type a name, or part of one: nodes, links, subcatchments and rain gages that match are listed, names that start with it first; Enter or a click selects one and zooms the map to it. Ctrl+F
Select by Attribute… Select every object whose value in a section passes a test — CONDUITS Roughness > 0.015, XSECTIONS Shape = CIRCULAR (which selects the conduits). Numbers compare as numbers, text without case; contains matches part of a value. Add to the current selection keeps what is selected. The Properties sheet and the Attribute Table then work on the selection

View

Item Does
Zoom In / Zoom Out / Zoom Extents / Zoom Window / Zoom to Selection Navigation; Zoom Window and Pan are tools
Pan The Pan tool
Backdrop → Load Image… A PNG/JPEG placed from its world file into [BACKDROP] (§3.9)
Backdrop → Georeference… Extent or scale-and-offset; Fit to model; Write world file
Backdrop → Show Toggle it
Backdrop → Remove Delete [BACKDROP]
Map Dimensions… [MAP] DIMENSIONS and Units; Set from model / from backdrop
Object Labels / Flow Arrows / Grid Map toggles
Adverse Slopes Conduits whose outlet invert is above their inlet invert, in amber (on by default); the validator lists them
Snap to Objects / Snap to Areas / Snap to Grid Snapping toggles; Snap to Areas snaps subcatchment corners to neighbours and makes edges follow their boundary; Grid spacing appears under Snap to Grid
Project Browser / Map Layers The left panel's tabs
Attribute Table… The selected object's section as a grid (chapter 6)
Properties Show or hide the property sheet
Profile from Selection Two selected nodes, or a selected run of links, become the profile path
Pick Profile Path… Click a start and an end node on the map
Map / Chart / Profile / Results The centre view

Project

Item Does
Title/Notes… [TITLE]
Options… [OPTIONS] in five tabs and [FILES]; opens the unit-switch wizard on a FLOW_UNITS change (§8.2)
Rain Gages… [RAINGAGES]
Curves… [CURVES] as drafts; STORAGE curves can be entered by elevation, or shifted after an invert change (§8.4)
Time Series → Edit… [TIMESERIES] as drafts
Time Series → Import… Delimited or GHCN-Daily text into series and gages (§8.5)
Time Series → Export to File… A series as SWMM's external file, optionally replacing it with a FILE reference
Patterns… [PATTERNS]
Design Storm… NRCS/NOAA/alternating-block/Chicago/uniform hyetograph into a series and a gage; NOAA Atlas 14 PFDS table fetched for the model's location or pasted (§8.9)
Observed Rainfall (MRMS)… The rain NOAA measured, hour by hour, from gauge-corrected radar, as a series and a gage (§8.9)
ARM Options… Initial abstraction ratio, hydrograph time step, IDF tables for Alternative Runoff Methods (§24.6)
Import PCSWMM ARM… PCSWMM's ARM subcatchments from its project database (model.db) beside the model, as AquaSWMM ARM subcatchments (§24.9)
Compute Conduit Lengths… Geometric lengths against stored lengths; write the ticked ones (§3.10)
Compute Subcatchment Widths… Width from Area ÷ flow length, K × flow length or K × √Area, flow length from the map; write the ticked ones (§8.10)
Compute Curve Numbers… Area-weighted TR-55 curve numbers (and optionally % impervious) from downloaded NLCD 2021 land cover and SSURGO soil groups; write the ticked ones, or switch the model to CURVE_NUMBER first (§8.10)
Assign Rain Gages… Each subcatchment to the gage nearest its area centroid (Thiessen); write the ticked ones (§8.10)
Dry Weather Flow Generator… [DWF] FLOW rows from population × per-capita rate in FLOW_UNITS, with optional hourly/daily patterns; replaces existing FLOW rows on those junctions (§8.10)
Controls… [CONTROLS] as text
Pollutants… / Land Uses… Their sections
Validate Model Refresh the findings and show the list

Run

Item Does
Engine list Choose the engine; each shows version and architecture
Find Engines Rescan the install locations and PATH
Live Results Toggle: open the Live Results window and follow the growing .out during a run (§23.2)
Check Model… The QA pass: findings grouped by severity, clickable (§9.2)
Autosave every N min Snapshot interval for a dirty model; 0 = off
Run Run the model. F5
Stop Kill the running engine; the partial results are kept (§23.1)

Results

Item Does
Map (Peaks) Colour the map by run maxima
Chart The single-series chart view
Report Summary… Placeholder; the summary tables are in the Tables view
ARM Hydrographs… Every ARM subcatchment's hydrograph, table, plot and CSV, from the model as it is (§24.7)
Run Status… The last run's window: engine and hash, continuity with thresholds, every diagnostic list, warnings and errors explained (§9.4)
Model Report… HTML or PDF report of the model and its run (§2.10); the Reviewer summary option adds pond and outfall tables, pre- vs post-development peaks, and pond and outfall hydrographs
Compare Runs… Peak differences between two recorded runs (§2.9)
Compare Engines… Run the model on two engines and compare

Tools

Item Does
Measure Distance and Area Click points on the map: the path's length and, from three points, the area it encloses (ft² and acres, or m² and hectares), beside the path and in the status bar. Clicks snap like any other, so a click on a node measures from its centre. Double-click or right-click ends a path and the next click starts another; Esc or M ends the tool. A map in degrees is measured in metres, approximately. M
ALR Checks The ALR post-processor on the last run (§9.6)
Python Terminal… A Python kernel with model, out, rpt bound (chapter 18)
Tc Calculator… Kirpich, TR-55 sheet flow, FAA, and a TR-55 worksheet
Storm Sewer Design → Design Panel… The design panel (chapter 12)
Storm Sewer Design → Analyze Map and analyse, as the toolbar's Analyze. F6
Storm Sewer Design → Auto-size… Analyse and preview the sizing batch
Storm Sewer Design → Design Review Analyse and show the findings
Storm Sewer Design → Design Report (HTML)… / (PDF)… The design report for the mapped network

Help

Shared with the storm-sewer workspace.

Item Does
Interactive Tutorial The storm-sewer workspace's guided first run
Getting Started / Quick Start Tutorial / Design Workflow / Computational Methods / File Import & Export / Hydraflow Migration Guide Open the Help window on that topic (F1 opens it too)
Keyboard Shortcuts… Appendix A
Troubleshooting The storm-sewer workspace's troubleshooting topic
SWMM Error Codes… The engine's error and warning index with search (Appendix C)
Ask the AI assistant… Opens the support page, https://aquaswmm.com/support.html: an assistant that answers from this manual at any hour, and a person by email
Licence… The Licence window: the plan, seats, licensee and days left of the key in force; paste a key and Activate; Start free trial; Buy. See 1.2
Support AquaSWMM / Support & Custom Work… / About AquaSWMM… Links and the About box

The Help window's Contents list has two entries for this workspace at its end: SWMM Model Editor, the offline getting-started topic that mirrors chapter 1, and Manual (online), which opens this manual in the browser and shows its address.

Toolbar

Select · Pan · Zoom + · Zoom − · Zoom Win · Gage · Subcatch · Junction · Outfall · Divider · Storage · Conduit · Pump · Orifice · Weir · Outlet · Label · Run · Extents · ● Unsaved.

The SWMM / Storm Sewer workspace switch sits at the right end of the menu bar, not the toolbar: the row cannot hold it alongside the seventeen tools.

Context menu (right-click on the map)

Zoom Extents · Zoom To · Edit Properties… · Attribute Table… · Profile from Here… · Reverse Link · Convert Node Type → Junction / Outfall / Divider / Storage · Convert Link Type → Conduit / Pump / Orifice / Weir / Outlet · Results File → Include / Leave Out · Delete.

Dialog buttons that recur

OK · Cancel · Apply · Revert · Close · Add row · + (add) · − (delete) · Save model… / Discard changes / Keep editing (unsaved model) · Delete all of it / Keep them (delete impact) · Show in findings list / Dismiss (run refused) · Run anyway / Run without the hotstart (warnings before running) · Restore autosave / Discard it, keep the file (recovery) · Convert ticked / Copy report / Revert (unit wizard) · Add to Model (design storm) · Import / Load file… / Save As… (time series) · Apply to n ticked (lengths) · Rebuild / Save HTML… / Save PDF… / Open after saving (model report) · Run both / Export CSV… / Swap A and B (compare) · Copy summary / Error codes… (run status) · Run / Restart Kernel / Clear Output (Python) · Add label (label tool).