Example Notebooks

These are the canonical, runnable examples for ras-commander. Each row links to the rendered documentation page and to the source .ipynb on GitHub. Runtime is the summed cell-execution wall time captured the last time the notebook was executed (N/A means the notebook was committed without execution outputs).

See Example Projects for the CRS-valid source catalog and MapLibre review contract for ras2cng-exported model bundles.

New here? Start with the 100s.

Run 100 → 101 → 110 for the core initialize → inspect → execute loop, then branch into the series that matches your work: 200s geometry & calibration, 300s unsteady & DSS, 400s HDF results, 900s data integration & forecasting.

140 notebooks indexed - 124 with runtime data, 16 without.

100s - Initialization & Execution

Notebook	Source	Runtime
100 - Using RasExamples	.ipynb	35 s
101 - Project Initialization	.ipynb	5 s
102 - Multiple Project Operations	.ipynb	2.2 min
103 - Plan and Geometry Operations	.ipynb	1.8 min
104 - Plan Parameter Operations	.ipynb	1.3 min
110 - Single Plan Execution	.ipynb	8.3 min
111 - Executing Plan Sets	.ipynb	3.0 min
112 - Sequential Plan Execution	.ipynb	3.3 min
113 - Parallel Execution	.ipynb	3.3 h
114 - Parameter Permutation Sweeps with RasPermutation	.ipynb	2.3 min
115 - Real-Time Execution Monitoring with Callbacks	.ipynb	1.4 min
116 - HDF Output Options Read Benchmark	.ipynb	25.6 min
117 - Monte Carlo Uncertainty Analysis (Hardened API)	.ipynb	10.4 min
120 - Win32COM Automation	.ipynb	13 s
121 - HECRASController Profiles	.ipynb	2.2 min
122 - RASMapper Spatial Review	.ipynb	1.1 min
123 - RASMapper Geometry Layer Updates	.ipynb	9.8 min
124 - RASMapper Bank Lines	.ipynb	44 s
125 - RASMapper Stored Maps: Arrival Time, Duration, and Percent Time Inundated	.ipynb	N/A
150 - Using results_df for Plan Results Summary	.ipynb	1.1 min

200s - Geometry & Calibration

Notebook	Source	Runtime
201 - 1D Geometry File Parsing	.ipynb	18 s
202 - 2D Geometry File Parsing	.ipynb	3.7 min
203 - HTAB Parameter Optimization for Model Stability	.ipynb	33 s
204 - Culvert GIS Reconstruction and Hydraulic-Validity Checks (1D)	.ipynb	14 s
205 - Extract Cross Section XYZ Coordinates from Plain Text Geometry	.ipynb	4 s
206 - Structures and Metadata from Geometry Files	.ipynb	4 s
207 - Reference Lines and Points for 2D Calibration	.ipynb	3 s
208 - Bridge Method Comparison	.ipynb	1.7 min
209 - Culvert Authoring	.ipynb	8 s
210 - Cross-Section Interpolation Settings	.ipynb	18 s
211 - Final Manning's N and Infiltration Analysis	.ipynb	3 s
212 - Native NLCD Land-Cover Authoring and Controlled Manning Verification	.ipynb	7.6 min
213 - Native Land-Cover Classification Polygon CRUD	.ipynb	6.7 min
214 - SA/2D Connection Authoring	.ipynb	10 s
215 - SA/2D Bridge Connection Authoring	.ipynb	21 s
216 - 1D Bridge Authoring	.ipynb	4 s
217 - 1D Cross-Section Levee Authoring	.ipynb	2.4 min
218 - Native Infiltration Base and Region Override Authoring	.ipynb	16.8 min
219 - 1D Bridge Cross-Section Plotting with Deck/Pier Overlay	.ipynb	5 s
220 - Kalamazoo River Calibration Workflow	.ipynb	8 s
221 - 1D Manning's N Calibration Workflow	.ipynb	36.6 min
222 - Steady Flow Calibration	.ipynb	39 s
223 - Steady Floodway Encroachment	.ipynb	17 s
224 - Steady Flow Authoring	.ipynb	12 s
225 - Fixing Blocked Obstruction Overlaps with RasFixit	.ipynb	7 s
226 - 2D Connection Culvert Invert Validation (Terrain Cell Minimum)	.ipynb	32 s
227 - Authoring a 2D Connection Culvert (Connection Culv=)	.ipynb	22 s
228 - Manning's n from NLCD Validation	.ipynb	2.3 min
229 - Model Extent Polygons (1D, 2D, and Overall Footprints)	.ipynb	7 s
230 - 2D Mesh Cell-Size Sensitivity for Sediment Transport	.ipynb	6.9 min
231 - Headless Mesh Generation: Pipe Networks and Refinement Regions	.ipynb	8 s
232 - 2D Mesh Cell-Size Sensitivity for Sediment Transport - Second Case: Weise Flume	.ipynb	16.7 min
233 - Manning's n Region Polygon Authoring	.ipynb	3 s
234 - Headless RASMapper Geometry Completion (Edge Lines, Interpolation Surface, Flow Paths)	.ipynb	29 s
235 - Clip a Texas FEMA eBFE model to one NWM reach	.ipynb	N/A
236 - Build a Texas FEMA eBFE Breakout from Adjacent Main-Stem Models	.ipynb	42 s

300s - Unsteady Flow & DSS

Notebook	Source	Runtime
300 - Unsteady Flow Operations	.ipynb	26 s
301 - Flow Hydrograph Optimization	.ipynb	1.0 min
310 - DSS Boundary Extraction	.ipynb	5 s
311 - 2D Floodway Encroachment	.ipynb	1.2 min
312 - Boundary DataFrame Enhancement: QMult, QMin, and DSS Path Parsing	.ipynb	49 s
313 - HMS-to-RAS Boundary Condition Matching	.ipynb	5 s
314 - Breakline-Derived Reference Lines And USGS Gauge Points	.ipynb	3.3 min
315 - 2D Computation Options	.ipynb	2.4 min
316 - Terrain Modifications: High-Ground and Polygon Writer Validation	.ipynb	2.9 min
317 - Restart File Output and Warm-Start Settings	.ipynb	24 s
318 - Validating DSS File Paths and Data Availability	.ipynb	4 s
319 - Post-fire debris-flow 2D modeling, built from scratch (non-Newtonian)	.ipynb	6.3 min
320 - 1D Boundary Condition Visualization	.ipynb	5 s

400s - HDF Results Extraction

Notebook	Source	Runtime
400 - 1D HDF Data Extraction	.ipynb	1.6 min
401 - Steady Flow Analysis	.ipynb	5.8 min
410 - 2D HDF Data Extraction	.ipynb	5.4 min
411 - Pipes and Pumps	.ipynb	3.3 min
412 - 2D Face Data Extraction	.ipynb	3.3 min
413 - Profile Line Flow Extraction	.ipynb	3 s
414 - Controlled Depth-Varying Manning's n for HEC-RAS 2D Linux Solves	.ipynb	5.4 min
415 - 2D Spatial Result Queries with HdfResultsQuery	.ipynb	5.5 min
416 - 2D Velocity Profile Line Extraction	.ipynb	5 s
417 - Inspecting Results and Generating Hydraulic Product Packages	.ipynb	N/A
420 - Dam Breach Results	.ipynb	2.9 min
430 - 1D Channel Capacity Analysis	.ipynb	1.3 min

500s - Remote Execution

Notebook	Source	Runtime
500 - Remote Parallel Execution with PsExec	.ipynb	8.7 min
510 - Linux HEC-RAS Execution	.ipynb	N/A
511 - Headless Linux/Wine/Ras2Cng Setup and Qualification	.ipynb	N/A
512 - Docker Precompute and Native Linux Compute	.ipynb	N/A
560 - Modified Puls Routing Extraction from HEC-RAS 2D Models	.ipynb	3.5 min

600s - Floodplain Mapping

Notebook	Source	Runtime
600 - Floodplain Mapping via GUI Automation	.ipynb	19.5 min
601 - Headless Stored Map Generation Using RasMapper	.ipynb	6.1 min
610 - Generate Fluvial Pluvial Delineations using Max WSE Arrival Time	.ipynb	1.0 h
611 - Validating RAS Mapper Layers and Terrain Files	.ipynb	9 s
612 - Benefit-area mapping for storm-system alternatives	.ipynb	1.3 min

700s - Sensitivity & Precipitation

Notebook	Source	Runtime
700 - Core Sensitivity Testing with results_df	.ipynb	17.0 min
701 - Version Benchmarking and Core Scaling (HEC-RAS 5.0.5, 6.0, 6.3.1, 6.6, 7.0)	.ipynb	2 s
710 - Manning's n Bulk Sensitivity Analysis	.ipynb	2.0 min
711 - One-at-a-Time (OAT) Manning's n Sensitivity Analysis	.ipynb	12.1 min
720 - Precipitation Hyetograph Generation - Complete Method Comparison	.ipynb	16 s
721 - Precipitation Hyetograph Comparison	.ipynb	44.1 min
722 - Gridded Precipitation for Rain-on-Grid 2D Modeling	.ipynb	N/A
723 - StormGenerator Alternating Block Method - Independent Textbook Validation	.ipynb	5 s
725 - Atlas 14 Spatial Variance Analysis	.ipynb	1.3 min
726 - Gridded ABM Hyetograph Generation	.ipynb	2.4 min
727 - Atlas 14 Gridded Design Storm Rain-on-Grid in HEC-RAS	.ipynb	16.5 min
728 - Extending Gridded DSS Forcing Through the Simulation Window	.ipynb	N/A
730 - Raster Processing Performance Profiling	.ipynb	N/A

800s - Quality Assurance

Notebook	Source	Runtime
800 - Quality Assurance with RasCheck	.ipynb	17 s
801 - Advanced Structure Validation with RasCheck	.ipynb	4 s

900s - AORC & Gridded Precipitation

Notebook	Source	Runtime
900 - AORC Precipitation for HEC-RAS Rain-on-Grid Models	.ipynb	3.1 h
901 - AORC Precipitation Catalog for HEC-RAS Rain-on-Grid Models	.ipynb	1.5 min

910s - Gauge Data & Validation

Notebook	Source	Runtime
910 - Example 910: USGS Gauge Catalog Generation	.ipynb	7.3 min
911 - USGS Gauge Data Integration for HEC-RAS	.ipynb	32 s
912 - USGS Real-Time Gauge Monitoring	.ipynb	2.8 min
913 - Boundary Condition Generation from Live USGS Gauge Data	.ipynb	3 s
914 - Historical Event Validation with AORC Precipitation and USGS Gauges	.ipynb	35 s
921 - USGS Study Package From Primitives	.ipynb	13 s
922 - Model Validation with USGS Gauge Data	.ipynb	1.8 min

915s - Operational Forecast Sequence

Notebook	Source	Runtime
915 - Real-Time Flood Forecast Workflow	.ipynb	2.5 min
918 - HMS-RAS Coupled Forecast Execution	.ipynb	11 s
919 - Operational Forecast Cycling	.ipynb	5 s

916s - Forecast Inputs

Notebook	Source	Runtime
916 - HRRR Forecast to HEC-RAS: End-to-End Rain-on-Grid Execution	.ipynb	16.0 min
917 - MRMS QPE Rain-on-Grid Workflow	.ipynb	1.1 h
923 - STOFS-3D Coastal Boundary Integration	.ipynb	1.3 min
924 - MRMS NetCDF Rain-on-Grid Validation	.ipynb	N/A
926 - WPC QPF Precipitation Forecast to DSS	.ipynb	22 s

920s - Terrain & Surfaces

Notebook	Source	Runtime
920 - RAS Terrain Creation	.ipynb	12 s
925 - Cross-Section Interpolation Surface	.ipynb	6 s
930 - Terrain Modification Analysis	.ipynb	15 s
931 - Native RAS Mapper Terrain Export	.ipynb	3 s

950s - eBFE Delivery

Notebook	Source	Runtime
950 - Using eBFE Models: Spring Creek 2D Analysis	.ipynb	4 s
951 - Using eBFE Models: North Galveston Bay HMS + RAS Integration	.ipynb	3 s
952 - Using eBFE Models: Upper Guadalupe Cascaded Watersheds	.ipynb	12 s
953 - Using eBFE Models: Rio Hondo 1D Steady Collection	.ipynb	9 s
954 - Using eBFE Models: Lake Maurepas Validation	.ipynb	3 s
955 - Using eBFE Models: Tickfaw Results-Ready Validation	.ipynb	3 s
956 - NextGen Hydrofabric Conflation Visual QA — Texas eBFE Shiloh Branch	.ipynb	5 s
957 - Using eBFE Models: Spring River Validation	.ipynb	N/A
958 - Model Sources: Unified Discovery, Download & Visualization	.ipynb	N/A
959 - eBFE 2D Breakout Geometry Preparation	.ipynb	N/A

960s - Cloud-Native Export

Notebook	Source	Runtime
960 - Cloud-Native Geometry Export with ras2cng	.ipynb	N/A
961 - Cloud-Native Results Export with ras2cng	.ipynb	N/A
962 - Cloud Optimized GeoTIFF Results Export with ras2cng	.ipynb	N/A