Skip to content

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 uses recorded notebook wall time when available, otherwise summed cell timings. N/A means no usable timing metadata; it does not mean outputs are absent. Saved outputs and runtime alone do not establish that the central workflow or hydraulic checks passed. Read each notebook's results and limitations.

Choose an operation through the capability map, or use the summaries below to compare examples by task. Selected workflows include expandable input/output contracts.

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.

147 notebooks indexed - 136 with runtime data, 11 without.

Selected Workflow Contracts

These optional contracts are curated in examples/notebooks.yml and published unchanged in the catalog JSON. An omitted field means it has not been curated. Runtime requirements describe what the workflow needs; recorded runtime measures a saved execution. Evidence scope describes the example's limits, not a support badge.

101 - Project Initialization

Open notebook

Contract Scope
Inputs HEC-RAS project text and associated files
Operations Initialize independent project objects; Inspect file relationships and DataFrames
Outputs Project/plan/geometry/boundary inventories
Runtime requirements Python; HEC-RAS installation optional for file inspection
Evidence scope Inventory and path resolution do not establish that a plan can compute.
110 - Single Plan Execution

Open notebook

Contract Scope
Inputs Initialized HEC-RAS project and selected plan
Operations Execute one plan through RasCmdr; Inspect return values and computation messages
Outputs ComputeResult; Native result and diagnostic files
Runtime requirements Installed HEC-RAS release compatible with the project; notebook config selects 7.0; Writable working-copy destination
Evidence scope Execution and completion evidence are separate from hydraulic acceptance; inspect the final result and diagnostics.
117 - Monte Carlo Preparation and Ensemble Workflow

Open notebook

Contract Scope
Evidence scope Saved outputs demonstrate model inspection and sampling only; no hydraulic ensemble or uncertainty estimate was computed.
207 - Reference Lines and Points for 2D Calibration

Open notebook

Contract Scope
Inputs Working geometry text; Named line and point coordinates in model CRS
Operations Write reference locations; Read geometry text back; Compute copied plan and inspect native HDF results
Outputs Updated geometry text; Reference location inventories; Native point geometry and recorded time series
Runtime requirements Installed HEC-RAS 6.6; RasCmdr computes a separate one-day destination
Evidence scope Fresh HEC-RAS 6.6 computation with native point geometry and recorded point/line series; not hydraulic acceptance.
212 - Native NLCD Land Cover Authoring and Controlled Manning Validation

Open notebook

Contract Scope
Inputs Copied 2D projects; NLCD classes and geometry land-cover associations
Operations Author native land-cover sidecars; Modify selected Manning classes; Recompute and compare final values
Outputs Authored sidecars and geometry overrides; Cell/face roughness, WSE, and breach comparisons
Runtime requirements Windows native RASMapper dependencies and HEC-RAS; notebook config selects 7.0; NLCD data and writable project copies
Evidence scope The notebook retains controlled authoring and response comparisons for its selected models/classes; they do not qualify every land-cover or runtime combination.
220 - Manning's n Calibration with RasCalibrate

Open notebook

Contract Scope
Inputs Real 2D model; Declared observation or synthetic-target dataset; Parameter bounds
Operations Evaluate objectives; Search Manning parameters; Compare event diagnostics
Outputs Objective values and parameter candidates; Modeled/target comparisons
Runtime requirements Scientific Python stack; Installed HEC-RAS required when RUN_HECRAS is enabled; configured default 6.6
Evidence scope The execution switch and target provenance determine what a run establishes. Synthetic targets demonstrate estimation mechanics, not observational validation.
224 - Steady Flow Authoring

Open notebook

Contract Scope
Inputs Real steady-flow project; Profile discharges and typed downstream boundaries
Operations Create and update steady-flow files; Read back authored records; Compute and inspect messages
Outputs Steady-flow files and linked plan inputs; Readback and execution diagnostics
Runtime requirements Python for text authoring; Installed HEC-RAS for the notebook computation stage
Evidence scope Text roundtrip and native computation are distinct checks; this example does not qualify floodway encroachment authoring.
235 - Clip a Texas FEMA eBFE Model to One NWM Reach

Open notebook

Contract Scope
Inputs Real 1D source project; NOAA NWM edge and selected hydraulic/export domains
Operations Select a reach slice; Assemble an independent breakout; Compare retained geometry and results
Outputs Standalone HEC-RAS project; Selection provenance and comparison evidence
Runtime requirements Source eBFE model and NWM network data; Windows/native geometry dependencies and HEC-RAS; notebook config selects 7.0
Evidence scope Checks apply to the selected Shiloh Branch edge and retained sections; domain and boundary adequacy require review for a new extraction.
314 - Breakline-Derived Reference Lines And USGS Gauge Points

Open notebook

Contract Scope
Inputs Working 2D project and channel-aligned breaklines; USGS gauge locations
Operations Generate and author reference locations; Preprocess and compute a plan; Plot recorded line hydrographs and nearest-cell gauge WSE
Outputs Authored reference geometry; Computed plan results; Line hydrograph and gauge sample figures
Runtime requirements Configured HEC-RAS execution runtime; Gauge discovery network access
Evidence scope Retained outputs show the demonstrated run. Gauge WSE plots use nearest-cell sampling, not solver-recorded reference-point hydrographs; generated lines still require engineering review.
400 - 1D HDF Data Extraction

Open notebook

Contract Scope
Inputs 1D unsteady plan-result HDF; Geometry HDF or geometry embedded in results
Operations Read cross-section and structure results; Inspect runtime and volume accounting
Outputs xarray cross-section Dataset; Spatial geometry and tabular diagnostics
Runtime requirements Python HDF/geospatial dependencies; Retained compatible result HDF; no solver required for read-only extraction
Evidence scope Dataset presence and extraction establish readable stored results, not freshness or hydraulic acceptance.
401 - Steady Flow Analysis

Open notebook

Contract Scope
Inputs 1D steady plan-result HDF
Operations List and select steady profiles; Extract and compare WSE
Outputs Profile-indexed water-surface arrays; Steady metadata and plots
Runtime requirements Python HDF dependencies for reading; Installed HEC-RAS for the notebook initial example computation
Evidence scope Steady profiles are separate from unsteady time series; the example comparisons do not establish model calibration.
410 - 2D HDF Data Extraction

Open notebook

Contract Scope
Inputs 2D geometry and unsteady result HDFs
Operations Query mesh cells/faces and result variables; Inspect time series and maximum values
Outputs GeoDataFrames; DataArray/Dataset results indexed by mesh-local cell or face IDs
Runtime requirements Python HDF, xarray, and geospatial dependencies; Requested output variables must exist in retained HDFs
Evidence scope Stored maxima, instantaneous time series, geometry, and derived quantities have different meanings; missing optional output is not zero.
413 - Profile Line Flow Extraction

Open notebook

Contract Scope
Inputs Completed plan HDF and matching geometry; Named profile-line layer or geometry reference line
Operations Extract named-line flow time series; Find sampled peak and inspect face-flow comparison
Outputs Flow series with selection provenance; Peak-flow summary and comparison plot
Runtime requirements Current canonical API requires pythonnet and compatible RasMapperLib; External Chippewa fixture described in notebook
Evidence scope Saved outputs retain a historical six-face reconstruction, not current native qualification. The native fixture uses seven faces with substantially different flow. Native-associated hydrograph provenance remains unqualified; absolute hydrograph values and summed absolute face flows are different quantities.
416 - 2D Velocity Profile Line Extraction

Open notebook

Contract Scope
Inputs Completed 2D plan HDF and matching geometry; RAS terrain HDF and line coordinates
Operations Select a saved result time; Query a native station-wise velocity profile
Outputs Station/profile table; Velocity, depth and terrain figure
Runtime requirements pythonnet and compatible installed RasMapperLib; Matching RAS terrain and geometry
Evidence scope Retained example output illustrates a single-time station profile, not line-integrated discharge or solver-recorded reference output; this editorial update does not requalify native execution.
417 - Inspecting Results and Generating Hydraulic Product Packages

Open notebook

Contract Scope
Inputs Existing completed unsteady HEC-RAS result HDF
Operations Inspect result identity and completeness; Export and independently check derivative products
Outputs Checksum-pinned COG, Arrow/Parquet, GeoJSON, JSON, and PNG package
Runtime requirements Python export/geospatial dependencies; Retained result HDF with required geometry, CRS, units, and outputs; no solver run
Evidence scope Mechanical inspection and derivative verification do not modify the producer HDF or establish hydraulic acceptance.
612 - Benefit-area mapping for storm-system alternatives

Open notebook

Contract Scope
Inputs Storm-system baseline and alternative projects; Comparable stored Depth rasters
Operations Author pipe/pump alternatives; Compute and compare benefits and adverse depth changes
Outputs BenefitArea rasters and polygons; Hydraulic comparisons and adverse-depth screens
Runtime requirements Installed HEC-RAS and native stored-map tooling; Geospatial raster dependencies and writable model copies
Evidence scope Benefit categories use declared depth thresholds and aligned pre/post rasters; no qualifying benefit does not imply no physical change.
720 - Precipitation Hyetograph Generation - Complete Method Comparison

Open notebook

Contract Scope
Inputs NOAA Atlas 14 depth-duration information; Declared storm duration and temporal distribution
Operations Compare precipitation temporal methods
Outputs Hyetographs and comparison plots
Runtime requirements Python precipitation dependencies; Network or cached precipitation source data; optional StormGenerator sections depend on availability
Evidence scope Method comparison demonstrates temporal construction; it does not select a locally appropriate design storm or prove delivery to a hydraulic solver.
721 - Precipitation Hyetograph Comparison

Open notebook

Contract Scope
Evidence scope All 30 patterns are authored and read back. Two hourly HEC-RAS 7.0 Davis runs verify native precipitation across 2,705 rainfall-receiving cells and 217 times; other versions, SI units, fixed-start boundaries, sub-hourly intervals and hydraulic acceptance remain unqualified.
800 - Quality Assurance with RasCheck

Open notebook

Contract Scope
Inputs Computed steady-flow example projects
Operations Run RasCheck diagnostics; Review messages and thresholds
Outputs CheckResults messages; Tabular/HTML review outputs
Runtime requirements Python HDF dependencies; Installed HEC-RAS for example computation when needed
Evidence scope Diagnostics support review and may have incomplete dataset coverage. Floodway authoring/checking remains experimental; empty messages are not a compliance finding.
912 - USGS Real-Time Gauge Monitoring

Open notebook

Contract Scope
Evidence scope Current saved setup/map output uses real HDF geometry and successful USGS station metadata. Later monitoring outputs retain their historical configuration and were not rerun.
917 - MRMS QPE Boundary-Hyetograph Hydraulic Comparison

Open notebook

Contract Scope
Inputs Archived hourly MRMS MultiSensor QPE Pass2 GRIB2; Davis and New Orleans Metro RasExamples projects
Operations Audit source units, absolute times and spatial support; Author and read back uniform precipitation boundaries; Compare baseline/event native cumulative rainfall and hydraulic diagnostics
Outputs Source and serialized rainfall tables; Native computation receipts and cumulative rainfall comparisons; Diagnostic maps, pump plots and animations
Runtime requirements Windows with HEC-RAS 7.0 for native computation; HEC-Vortex and RasDss Java dependencies; archived MRMS downloads or cache; ffmpeg for animations
Evidence scope Four hourly US-customary HEC-RAS 7.0 baseline/event runs verify complete cumulative rainfall histories at 505 times across 2,705 Davis cells and 361 times across 19,711 New Orleans cells. Saved outputs inspect retained runs and regenerate diagnostic figures; the gallery runtime covers inspection/rendering only. Native run durations are recorded separately. Uniform boundaries follow simulation start; spatial rain-on-grid, other configurations and hydraulic acceptance remain unqualified. Follow-ups: issues 398, 438, 440 and 441.
922 - Model Comparison with USGS Gauge Data

Open notebook

Contract Scope
Inputs Delivered Kalamazoo HDF reference-point water levels; USGS gauge observations for the matched period
Operations Align units and time references; Calculate observation comparisons with provenance
Outputs Matched series and comparison metrics; Recorded initialization/calibration limitations
Runtime requirements Python HDF and USGS dependencies; Retained model artifacts and gauge data or network access; no new solver run in the repaired comparison
Evidence scope Retained evidence covers 276 matched observations. Initialization failed and a distinct calibrated run was unavailable; no before/after calibration improvement is claimed.
950 - Using eBFE Models: Spring Creek 2D Analysis

Open notebook

Contract Scope
Inputs FEMA eBFE/BLE archive and delivered model files
Operations Organize project files; Inspect boundaries, geometry, and delivered results
Outputs Organized project inventory; Data availability and model-review outputs
Runtime requirements Archive download/cache and Python HDF/geospatial dependencies; Installed HEC-RAS only for the optional geometry-preprocessor stage
Evidence scope Delivered-result inspection is distinct from newly executed model verification; RUN_GEOMETRY_PREPROCESSOR defaults to False.
959 - Austin Bayou SH 35 2D Breakout and NextGen Validation

Open notebook

Contract Scope
Inputs Public Austin Bayou SH35 completed child fixture; Optional organized Austin–Oyster parent model and retained results; NextGen v2.2 flowpaths
Operations Inspect native boundary-face ownership; Conflate and screen the reach-derived domain; Author external boundaries in isolated copies; Build parent-derived flow plateaus and review diagnostics
Outputs Boundary and domain evidence; Flow-ladder plans and retained hydraulic diagnostics; Focused parent/child gauge-location comparison
Runtime requirements Installed compatible HEC-RAS for native preprocessing and new solves; Organized parent required for optional parent-derived checks; not downloaded automatically
Evidence scope Retained child and focused hydraulic diagnostics demonstrate the stated example. Compact constant-flow domain omits tributary inflow and does not substitute for watershed-preserving rainfall modeling or complete engineering validation.
962 - Cloud Optimized GeoTIFF Results Export with ras2cng

Open notebook

Contract Scope
Inputs Computed 2D result HDF and geometry
Operations Prepare example results; Export cloud-native raster results with ras2cng
Outputs COG result rasters and export metadata
Runtime requirements ras2cng and raster dependencies; Installed HEC-RAS for the example compute stage; configured version 6.6
Evidence scope Exported products reflect the selected producer results and options; product generation alone does not establish hydraulic quality.

100s - Initialization & Execution

Notebook Source Runtime
100 - Using RasExamples
extract official HEC-RAS example projects
.ipynb 35 s
101 - Project Initialization
initialize projects and inspect project DataFrames
.ipynb 5 s
102 - Multiple Project Operations
Manage separate project objects, clone and configure plans, execute the projects concurrently, and compare their execution records with explicit ras_object context.
.ipynb 2.2 min
103 - Plan and Geometry Operations
Clone, associate, configure, and delete plan, geometry, and unsteady files; inspect project metadata and compute the modified plan in a working project.
.ipynb 1.8 min
104 - Plan Parameter Operations
Read and update run flags, computation/output intervals, file descriptions, and simulation dates, then inspect the saved plan configuration.
.ipynb 1.3 min
110 - Single Plan Execution
run plans through RAS Commander
.ipynb 8.3 min
111 - Executing Plan Sets
Select explicit or metadata-filtered plan sets and execute them sequentially in a test copy, including plans that lack retained HDF results.
.ipynb 3.0 min
112 - Sequential Plan Execution
Run dependent plans sequentially with compute_test_mode, inspect the copied project, and summarize per-plan execution outcomes.
.ipynb 3.3 min
113 - Parallel Execution
run plans through RAS Commander
.ipynb 3.3 h
114 - Parameter Permutation Sweeps with RasPermutation
Generate Cartesian products of parameter ranges, automatically partition into batch folders (respecting the 99-plan HEC-RAS limit), execute in parallel, and collect results into audit-friendly CSV logs.
.ipynb 2.3 min
115 - Real-Time Execution Monitoring with Callbacks
This notebook demonstrates how to use execution callbacks for real-time monitoring of HEC-RAS plan execution.
.ipynb 1.4 min
116 - HDF Output Options Read Benchmark
Use the BaldEagleCrkMulti2D example project and plan 06 to compare HDF write settings by measuring ras-commander HDF read performance after the plans have been computed.
.ipynb 13.8 min
117 - Monte Carlo Preparation and Ensemble Workflow
Inspect a real model and generate parameter samples; retain an unexecuted ensemble recipe with explicit convergence and failure-handling requirements.
.ipynb 10.4 min
120 - Win32COM Automation
Demonstrate Windows HEC-RAS GUI automation helpers for dialogs, RAS Mapper, and stored-map workflows that require an interactive desktop.
.ipynb 13 s
121 - HECRASController Profiles
Use the Windows HECRASController through RasControl to execute configured legacy plans and extract steady profiles or unsteady time series.
.ipynb 2.2 min
122 - RASMapper Spatial Review
Inspect RAS Mapper layer inventories, control map views and visibility, and capture screenshots and spatial review packages.
.ipynb 1.1 min
123 - RASMapper Geometry Layer Updates
Apply selected native RAS Mapper geometry-layer commands across real example projects and inspect updated cross sections, structures, and storage curves.
.ipynb 9.8 min
124 - RASMapper Bank Lines
Generate RAS Mapper bank lines from cross-section bank stations through a supervised Windows GUI workflow.
.ipynb 44 s
125 - RASMapper Stored Maps: Arrival Time, Duration, and Percent Time Inundated
RasProcess.store_maps() generates rendered result rasters through the HEC-RAS mapping engine (RasMapperLib via the bundled RasStoreMapHelper.exe). This notebook covers the whole-simulation map types added alongside the profile-based WSE, depth, and velocity products.
.ipynb N/A
150 - Using results_df for Plan Results Summary
This notebook demonstrates the results_df DataFrame, which provides lightweight HDF-based results summaries for all plans. This enables quick access to execution status, volumetric errors, compute messages, and runtime data without ope...
.ipynb 1.1 min

200s - Geometry & Calibration

Notebook Source Runtime
201 - 1D Geometry File Parsing
geometry and HTAB workflows
.ipynb 18 s
202 - 2D Geometry File Parsing
This notebook demonstrates parsing and manipulating 2D geometry elements from HEC-RAS plain text geometry files, including: - Storage Area operations (BaldEagleCrkMulti2D) - SA/2D Connection operations and dam crest profiles (BaldEagleCr...
.ipynb 3.7 min
203 - HTAB Parameter Optimization for Model Stability
geometry and HTAB workflows
.ipynb 33 s
204 - Culvert GIS Reconstruction and Hydraulic-Validity Checks (1D)
Reconstruct 1D culvert barrel locations from geometry, screen invert placement, and compare a pipe-to-box retrofit using computed steady profiles.
.ipynb 14 s
205 - Extract Cross Section XYZ Coordinates from Plain Text Geometry
geometry and HTAB workflows
.ipynb 4 s
206 - Structures and Metadata from Geometry Files
This notebook demonstrates parsing bridge, culvert, inline weir, and geometry metadata from HEC-RAS plain text geometry files, including: - GeomMetadata: Efficient geometry element counts (HDF-first with text fallback) - GeomBridge: Brid...
.ipynb 4 s
207 - Reference Lines and Points for 2D Calibration
Author native reference lines and points, compute a one-day copied plan, and read recorded HDF output.
.ipynb 1.5 min
208 - Bridge Method Comparison
Compare bridge hydraulic method selections with a real HEC-RAS bridge example and show the effect on computed WSE.
.ipynb 1.7 min
209 - Culvert Authoring
Write taxonomy-checked culvert records and adjacent ineffective-flow areas, inspect spatial placement, and compute an edited plan for result review.
.ipynb 8 s
210 - Cross-Section Interpolation Settings
Interpolate cross sections and update bank stations, station/elevation arrays, and expansion/contraction coefficients in an example geometry.
.ipynb 18 s
211 - Final Manning's N and Infiltration Analysis
This notebook demonstrates how to extract final Manning's N and preprocessed infiltration values from a reproducible example project. It also includes a regression check for multi-ring infiltration override polygons.
.ipynb 3 s
212 - Native NLCD Land Cover Authoring and Controlled Manning Validation
Author matching NLCD land-cover layers through native RASMapper APIs, change exactly two Manning classes, recompute and solve both projects, and validate final cell, face, WSE, and breach responses with explicit active-cell and regenerated-key accounting.
.ipynb 7.6 min
213 - Native Land Classification Polygon Authoring
Add, update, list, and delete existing-class land-cover polygons through native RASMapper, reject unsupported multipart and interior-ring inputs before mutation, and verify final Manning, WSE, association, backup, and breach behavior.
.ipynb 6.7 min
214 - SA/2D Connection Authoring
Create, inspect, delete, and re-create SA/2D area connections in a real HEC-RAS geometry file. This notebook demonstrates an engineering-oriented workflow for the Dam connection in BaldEagleDamBrk.g13:
.ipynb 10 s
215 - SA/2D Bridge Connection Authoring
Read, modify, and round-trip bridge connection sub-records (routing type 32, Conn BR: blocks) in a HEC-RAS geometry file. This notebook demonstrates the bridge-specific API on BaldEagleDamBrk.g03, which contains 7 bridge connections...
.ipynb 21 s
216 - 1D Bridge Authoring
Author bridge decks, piers, abutments, coefficients, approach sections, and HTAB settings; read back the geometry and inspect computed messages/results.
.ipynb 4 s
217 - 1D Cross-Section Levee Authoring
Read, modify, insert, and remove cross-section levee station-elevation data in a real HEC-RAS geometry file, then run the unsteady simulation on the modified geometry and verify results extraction from the HDF output.
.ipynb 2.4 min
218 - Native Infiltration Base and Region Override Authoring
Create native infiltration override regions, edit geometry-wide Base Overrides and one named regional parameter table through RASMapper, then verify spatial attribution in final geometry and plan infiltration arrays and hydraulic results.
.ipynb 16.8 min
219 - 1D Bridge Cross-Section Plotting with Deck/Pier Overlay
HEC-RAS 1D bridges use four cross-sections:
.ipynb 5 s
220 - Manning's n Calibration with RasCalibrate
RasCalibrate provides parameter estimation workflows for HEC-RAS models, composing RasPermutation, HDF extraction helpers, and statistical metrics into a streamlined calibration API.
.ipynb 8 s
221 - 1D Manning's N Calibration Workflow
Demonstrates automated Manning's n calibration for a 1D HEC-RAS unsteady model using the RasCalibrate module with grid_search() and optimize().
.ipynb 18.0 min
222 - Steady Flow Calibration
Demonstrate steady-flow Manning roughness estimation against a synthetic observed WSE profile; inspect objective values without treating the target as field validation.
.ipynb 44 s
224 - Steady Flow Authoring
Create, read, and update steady-flow files with profile discharges and typed boundary conditions, then inspect HEC-RAS execution messages.
.ipynb 12 s
225 - Fixing Blocked Obstruction Overlaps with RasFixit
This notebook demonstrates using the RasFixit module to automatically detect and repair overlapping blocked obstructions in HEC-RAS geometry files.
.ipynb 7 s
226 - 2D Connection Culvert Invert Validation (Terrain Cell Minimum)
Compare proposed and authored SA/2D culvert inverts with terrain-derived mesh-cell minima and visualize placement along the connection.
.ipynb 32 s
227 - Authoring a 2D Connection Culvert (Connection Culv=)
Author a culvert in a previously weir-only SA/2D connection, read back Connection Culv records, and review placement and native acceptance.
.ipynb 22 s
228 - Manning's n from NLCD Validation
Validate ManningsFromLandCover on the real BaldEagleCrkMulti2D RasExamples project. The workflow compares the existing 1D geometry Manning's n blocks against automated NLCD-derived horizontal variation, checks the project RAS Mapper...
.ipynb 2.3 min
229 - Model Extent Polygons (1D, 2D, and Overall Footprints)
extract 2D flow-area perimeters, generate 1D river edge lines and reach footprints, combine them into the true model extent, and compare 1D-only, 2D-only, and legacy bounding-box geometries for Bald Eagle Creek and Muncie
.ipynb 7 s
230 - 2D Mesh Cell-Size Sensitivity for Sediment Transport
Model: Chippewa River 2D (Chippewa_2D, HEC's 2D Sediment Transport example suite, plan "100ft Sediment")
.ipynb 3.5 min
231 - Headless Mesh Generation: Pipe Networks and Refinement Regions
Headlessly regenerate a pipe-connected Davis mesh, then author and visually verify a 40-foot refinement region on the Chippewa 2D fixture.
.ipynb 8 s
232 - 2D Mesh Cell-Size Sensitivity for Sediment Transport - Second Case: Weise Flume
Model: Weise 2D (Weise_2D, HEC's 2D Sediment Transport example suite, plan "Weise")
.ipynb 16.7 min
233 - Manning's n Region Polygon Authoring and Solver Validation
Author a regional Manning's n polygon on the real Muncie fixture, explicitly associate terrain and land cover, validate the temporary and final plan HDF cell values, and visually confirm solver propagation.
.ipynb 49 s
234 - Headless RASMapper Geometry Completion (Edge Lines, Interpolation Surface, Flow Paths)
Generate the RASMapper-derived geometry layers in-process via pythonnet - river edge lines, the cross-section interpolation surface, and flow path lines - read each one back, surface per-cross-section validation diagnostics, and audit stored 1D reach lengths against freshly recomputed flow lengths on a throwaway copy of the project.
.ipynb 29 s
235 - Clip a Texas FEMA eBFE Model to One NWM Reach
Classify real NOAA NWM v3 reaches against the Shiloh Branch eBFE footprint, retain 10% upstream and 25% downstream hydraulic buffers around feature 5790868, rasterize a stricter one-cross-section-overlap export domain, and compare the independent breakout to the source model.
.ipynb N/A
236 - Build a Texas FEMA eBFE Breakout from Adjacent Main-Stem Models
Catalog and join two adjacent Walnut Creek FEMA eBFE main-stem projects for NOAA NWM feature 5790954, write an independent restationed HEC-RAS project, retain source-block provenance, and visually verify the centerline seam, computational/export domains, two-pass flow-path finalization, inherited geometry diagnostics, and retained-section hydraulic response against both original plans.
.ipynb 42 s
237 - Hydraulic subdomains: split a rain-on-grid parent at normal-depth locations
In the delivered HEC-RAS 6.4.1, delineate TauDEM stream links on the FEMA eBFE Salt Draw terrain, find normal-depth split lines that hold in both the 1% and 0.2% AEP parent runs across the whole HUC, nest them into tiered hydraulic subdomains, then cut, author, validate and run a headwater and a larger main-stem subdomain as exact-cell breakouts and compare them with the parent; compare walled closed edges with closed-edge Normal Depth outflow, map the 0.1 ft agreement envelope, and compare runtime with the parent at 2 cores.
.ipynb 54.6 min

300s - Unsteady Flow & DSS

Notebook Source Runtime
300 - Unsteady Flow Operations
Inspect and edit unsteady boundary tables, clone flow and plan files, scale hydrographs, and compare computed cross-section water levels.
.ipynb 26 s
301 - Flow Hydrograph Optimization
Configure native flow-hydrograph optimization, inspect trial results, and compare the optimized hydrograph and WSE; retain a separate multiplier-search fallback.
.ipynb 1.0 min
310 - DSS Boundary Extraction
from ras_commander import *
.ipynb 5 s
312 - Boundary DataFrame Enhancement: QMult, QMin, and DSS Path Parsing
DSS boundary workflows
.ipynb 49 s
313 - HMS-to-RAS Boundary Condition Matching
This notebook demonstrates correlation-based matching between HEC-HMS DSS hydrograph outputs and HEC-RAS boundary condition locations using the BaldEagleCrkMulti2D example project.
.ipynb 5 s
314 - Breakline-Derived Reference Lines And USGS Gauge Points
Generate transverse reference lines and gauge points, compute a working plan, and batch plot recorded line hydrographs alongside nearest-cell gauge samples.
.ipynb 3.6 min
315 - 2D Computation Options
Clone 2D plans with typed computation options, run scenario plans, and compare HDF settings, stability messages, and maximum WSE.
.ipynb 1.7 min
316 - Terrain Modifications: High-Ground and Polygon Writer Validation
This notebook validates ras-commander terrain modification writers with a real HEC-RAS example project. It creates copied terrain sidecar modifications for high-ground lines, boundary-sampled polygon multipoint grading, and shape_z pol...
.ipynb 2.9 min
317 - Restart File Output and Warm-Start Settings
This notebook validates the restart-file API split used by warm-start workflows:
.ipynb 24 s
318 - Validating DSS File Paths and Data Availability
DSS boundary workflows
.ipynb 4 s
319 - Post-fire debris-flow 2D modeling, built from scratch (non-Newtonian)
This example builds a complete 2D HEC-RAS debris-flow model from nothing — no starting project — and runs a clear-water baseline plus Bingham non-Newtonian mud/debris-flow variants, then derives hazard-intensity and arrival-time...
.ipynb 6.3 min
320 - 1D Boundary Condition Visualization
This notebook demonstrates how to extract and visualize 1D boundary conditions from a HEC-RAS project. The workflow:
.ipynb 5 s
321 - Terrain Modification Layer Writers: Write, Read Back, Verify in RAS Mapper
write channel, high-ground, constant-polygon and ellipse terrain-modification layers into a copied Bald Eagle Creek terrain, read them back with read_layers, write them into a second terrain with add_modification_layer, and compare RAS Mapper's native exports (HEC-RAS 6.6 and 7.0.1) pixel by pixel; no hydraulic plans are run
.ipynb 20 s
322 - Native DSS Records, Backends, and Copy-Out Recovery
Drive RasDss on the native FAST-DSS engine with public HEC data, covering regular and irregular DSS6/DSS7 round trips and merges, the sync= flush policies, a java/native/shadow comparison, multi-curve paired data, location metadata and RasDss.repair copy-out recovery on a healthy file.
.ipynb 21 s

400s - HDF Results Extraction

Notebook Source Runtime
400 - 1D HDF Data Extraction
Read 1D unsteady HDF geometry and results, including cross-section time series, storage curves, structures, runtime, and volume accounting.
.ipynb 1.6 min
401 - Steady Flow Analysis
Read steady HDF profile names, WSE arrays, messages, and metadata; select profiles by name or index and compare their longitudinal elevations.
.ipynb 5.8 min
410 - 2D HDF Data Extraction
HDF mesh and results extraction
.ipynb 19 s
411 - Pipes and Pumps
Extract pipe-network and pump geometry/time series from HDF results and inspect pipe flow and velocity along profile lines.
.ipynb 3.3 min
412 - 2D Face Data Extraction
HDF mesh and results extraction
.ipynb 3.1 min
413 - Profile Line Flow Extraction
Extract named-line flow series and peaks; distinguish native-associated hydrographs of unqualified provenance from face-flow aggregation.
.ipynb 3 s
414 - Controlled Depth-Varying Manning's n for HEC-RAS 2D Linux Solves
Experimental, non-production comparison of baseline, table-extension control, and depth-varying-Manning scenarios in the single tested HEC-RAS 7.0 April 2026 Windows-preprocess/Linux-solve temporary-HDF workflow; all other versions and workflows are untested.
.ipynb 5.4 min
415 - 2D Spatial Result Queries with HdfResultsQuery
Query water surface elevation, depth, and velocity at arbitrary (x,y) coordinates, extract profiles along transects, compute flood extent with engineering filters, and generate domain-wide statistics -- all using scipy KDTree spatial ind...
.ipynb 6.0 min
416 - 2D Velocity Profile Line Extraction
Sample native RASMapper velocity, depth and terrain along a polyline at one saved time; distinguish station profiles from recorded reference hydrographs.
.ipynb 15 s
417 - Inspecting Results and Generating Hydraulic Product Packages
Read and mechanically inspect an existing completed HEC-RAS result HDF, then generate and independently verify a checksum-pinned COG, Arrow/Parquet, GeoJSON, JSON, and PNG derivative package without modifying the producer HDF or generating model output.
.ipynb 5 s
420 - Dam Breach Results
Read breach geometry and hydrographs, clone width and formation-time scenarios, execute the plans, and compare peak flow and breach evolution.
.ipynb 2.9 min
430 - 1D Channel Capacity Analysis
This notebook demonstrates the HdfChannelCapacity class for analyzing 1D channel capacity using WSE results and bank station elevations. Channel capacity is determined by comparing water surface elevations from multiple AEP storm profi...
.ipynb 1.3 min

500s - Remote Execution

Notebook Source Runtime
500 - Remote Execution with ras-commander
This notebook demonstrates how to execute HEC-RAS plans using: 1. Local parallel execution - RasCmdr.compute_parallel() on your local machine 2. Remote execution - compute_parallel_remote() on remote machines via PsExec/Docker
.ipynb 8.7 min
510 - Linux Execution of HEC-RAS with ras-commander
This notebook demonstrates how to execute HEC-RAS simulations on Linux servers using RasCmdr.compute_plan_linux(). This enables scalable, headless execution on cloud VMs, Proxmox containers, Docker, or any Linux host with the HEC-RAS L...
.ipynb N/A
511 - Headless Linux/Wine/Ras2Cng Setup and Qualification
Set up an isolated Linux task that uses official HEC-RAS Linux executables where supported and the same Windows HEC-RAS version under Wine only for RasProcess/RASMapper gaps and ras2cng stored-map export. This is a qualification workflow...
.ipynb N/A
512 - Docker Precompute and Native Linux Compute
Run the same two Python calls on Windows or Linux: first prepare a HEC-RAS plan with the Wine container, then execute the matching native Linux unsteady container. Both containers use ras-commander APIs...
.ipynb N/A
560 - Modified Puls Routing Extraction from HEC-RAS 2D Models
> ⚠️ BETA: RasModPuls and this notebook are currently beta and have not yet been > validated in production. The workflow, API, and outputs may change in future releases. > We welcome feedback from third-party users looking to v...
.ipynb 3.5 min

600s - Floodplain Mapping

Notebook Source Runtime
600 - Floodplain Mapping via GUI Automation
This notebook demonstrates floodplain mapping using HEC-RAS GUI automation to generate: - Maximum Water Surface Elevation (WSE) rasters - Maximum Depth rasters
.ipynb 19.5 min
601 - Headless Stored Map Generation Using RasMapper
This notebook demonstrates headless stored map generation using RasMapper through RasProcess.store_maps() to create maximum WSE rasters, maximum depth rasters, and inundation boundary polygons.
.ipynb 6.1 min
602 - Compare Rust 2D horizontal mapping with RAS Mapper
Compare Rust and native horizontal 2D maps on two eBFE models, Bald Eagle dam/levees and bridges, and Davis pipes, with identical depth filtering, configuration restoration and timing returns.
.ipynb 17.4 min
610 - Generate Fluvial Pluvial Delineations using Max WSE Arrival Time
Use differences in time of maximum 2D WSE to derive draft fluvial/pluvial transition lines and polygons for interpretation and map review.
.ipynb 16.8 min
611 - Validating RAS Mapper Layers and Terrain Files
Discover registered RAS Mapper layers and screen their format, CRS, raster metadata, spatial extent, and terrain/land-cover associations.
.ipynb 9 s
612 - Benefit-area mapping for storm-system alternatives
This example builds and computes HEC-RAS 7.0 conduit, second-pump, and combined alternatives, compares hydraulic performance, and maps categorical benefits, adverse depth increases, and building-footprint exposure.
.ipynb 1.3 min

700s - Sensitivity & Precipitation

Notebook Source Runtime
700 - Core Sensitivity Testing with results_df
This notebook demonstrates processor core sensitivity analysis for HEC-RAS 2D unsteady flow models. Understanding how computational performance scales with available CPU cores is essential for:
.ipynb 17.0 min
701 - Version Benchmarking and Core Scaling (HEC-RAS 5.0.5, 6.0, 6.3.1, 6.6, 7.0)
Benchmark one 2D plan across selected HEC-RAS versions and core counts; compare execution time, speedup, continuity diagnostics, and completion evidence.
.ipynb 2 s
710 - Manning's n Bulk Sensitivity Analysis
This notebook demonstrates bulk Manning's n sensitivity analysis for HEC-RAS 2D models with spatially variable roughness. The workflow:
.ipynb 2.7 min
711 - One-at-a-Time (OAT) Manning's n Sensitivity Analysis
This notebook performs a one-at-a-time Manning's n sensitivity analysis on the Muncie 2D example project using GeomLandCover edits, local parallel execution, preprocessed cell roughness propagation QA, and POI max-WSE sensitivity plots.
.ipynb 26.9 min
720 - Precipitation Hyetograph Generation - Complete Method Comparison
precipitation methods
.ipynb 16 s
721 - Precipitation Hyetograph Comparison
Generate and read back 30 precipitation patterns; verify intended, written and native accumulated rainfall in two bounded HEC-RAS 7.0 Davis runs.
.ipynb 13.2 min
722 - Gridded Precipitation with Atlas 14: Current Workflow
Migration guide to the implemented Atlas 14 workflow in notebook 727, with capability lookup and links to GeoTIFF, MRMS, and HRRR examples. Retires obsolete placeholder APIs and raw meteorology edits.
.ipynb 1.1 min
723 - StormGenerator Alternating Block Method - Independent Textbook Validation
Compare StormGenerator alternating-block hyetographs with an independent reference calculation and optional HMS storm classes; check depth conservation and temporal placement.
.ipynb 5 s
725 - Atlas 14 Spatial Variance Analysis
precipitation methods
.ipynb 1.3 min
726 - Gridded ABM Hyetograph Generation
Generate spatial ABM design-storm interval depths in CF NetCDF and identify the separate HEC-RAS conversion and qualification steps.
.ipynb 2.4 min
727 - Atlas 14 Gridded Design Storm Rain-on-Grid in HEC-RAS
Convert spatial NOAA Atlas 14 depths to projected ABM rain-on-grid forcing, execute controlled no-rain, spatial, and equivalent-uniform Bald Eagle HEC-RAS scenarios, and quantify the modeled hydraulic response.
.ipynb 16.5 min
728 - Extending Gridded DSS Forcing Through the Simulation Window
preserve and extend a model-covering gridded DSS family with three explicit dry intervals, then verify temporary/final HDF forcing, a HEC-RAS 7.0 compute, the dry-tail plateau, active-cell agreement, runtime diagnostics, and hydraulic results on Bald Eagle Creek
.ipynb 11.6 min
729 - Direct GeoTIFF Gridded Rain-on-Grid
Author projected precipitation GeoTIFFs, validate temporary plan-HDF rainfall, compute Bald Eagle, and inspect final rainfall and hydraulics
.ipynb 39 s
730 - Raster Processing Performance Profiling
Measure stored-map and VRT-to-GeoTIFF configurations, graph CPU, memory, throughput, and IOPS tradeoffs, and write an HTML decision report from a copied HEC-RAS project.
.ipynb N/A
731 - Atlas 14 Shared Temporal Pattern for an Existing Model
Apply a shared NOAA temporal curve to an existing model footprint, validate native rainfall NetCDF, export Float32 intervals to SHG DSS on a stated envelope with explicit bilinear conversion, gate missing cells, full-source spatial agreement and mesh coverage, and optionally configure a staged model copy without computing.
.ipynb 1.2 min
732 - Native Gridded Import and Grid Tools on Real Precipitation
Import real AORC (local Zarr and NetCDF), IMERG HDF5, Stage IV GRIB1/GRIB2 and MRMS GRIB2 precipitation to DSS grids with RasDssGrid, then apply every grid tool and the eight zonal statistics to an MRMS storm over the NewOrleansMetro 2D area, without Java, HEC-Vortex or GDAL.
.ipynb 39 s

800s - Quality Assurance

Notebook Source Runtime
800 - Quality Assurance with RasCheck
This notebook demonstrates how to use the RasCheck module for validating HEC-RAS steady flow models using multiple example projects to show different validation scenarios.
.ipynb 17 s
801 - Advanced Structure Validation with RasCheck
This notebook demonstrates the advanced structure validation features added to RasCheck in December 2025:
.ipynb 5 s

900s - AORC & Gridded Precipitation

Notebook Source Runtime
900 - AORC Precipitation for HEC-RAS Rain-on-Grid Models
This notebook demonstrates a complete workflow for using NOAA's Analysis of Record for Calibration (AORC) gridded precipitation data with HEC-RAS 2D rain-on-grid models, including data-driven simulation buffer selection based on observed...
.ipynb 4.8 min
901 - AORC Precipitation Catalog for HEC-RAS Rain-on-Grid Models
This notebook demonstrates a complete workflow for using NOAA's Analysis of Record for Calibration (AORC) gridded precipitation data with HEC-RAS 2D rain-on-grid models.
.ipynb 3.1 min

900s - Data Integration & Forecasting

Notebook Source Runtime
932 - Louisiana LWI EnDMC: Public Catalog, Cloud Raster Reads, and Selective Download
Read the public Louisiana Watershed Initiative EnDMC catalog without an account, filter models by region and software, classify a resource's S3 files, window-read an online depth raster through /vsicurl/, and download HEC-RAS project text files with a receipt and checksum verification.
.ipynb 10 s

910s - Gauge Data & Validation

Notebook Source Runtime
910 - USGS Gauge Catalog Generation
gauge, validation, forecast, and coastal boundary workflows
.ipynb 7.3 min
911 - USGS Gauge Data Integration for HEC-RAS
This notebook demonstrates how to integrate USGS gauge data with HEC-RAS models using the ras_commander.usgs submodule.
.ipynb 32 s
912 - USGS Real-Time Gauge Monitoring
Inspect a real model domain with live USGS station metadata and illustrate monitoring APIs; distinguish the refreshed map from historical monitoring outputs.
.ipynb 2.8 min
913 - Boundary Condition Generation from Live USGS Gauge Data
This example demonstrates how to generate HEC-RAS boundary conditions from real-time USGS gauge data. We'll use the Bald Eagle Creek model and create a flow hydrograph boundary condition from live gauge readings with drainage area scaling.
.ipynb 3 s
914 - Historical AORC Event Diagnostic Comparison with USGS Stage
execute an archived 48-hour AORC rain-on-grid event under HEC-RAS 7.0, verify source precipitation through durable, temporary, and final HDFs, inspect runtime and hydraulic results, and compare timezone-correct USGS stage as a diagnostic rather than calibration validation
.ipynb 35 s
921 - USGS Study Package From Primitives
This notebook demonstrates the composable primitives in ras_commander.usgs for USGS gauge study assembly.
.ipynb 13 s
922 - Model Comparison with USGS Gauge Data
Compare delivered Kalamazoo HDF water levels with 276 matched USGS gauge observations; retain provenance, metrics, initialization error and calibration-comparison limits.
.ipynb 9 s

915s - Operational Forecast Sequence

Notebook Source Runtime
915 - Operational Forecast Orchestration and Readiness
build a deterministic timezone-explicit forecast-cycle manifest, inspect current public API signatures, and visually audit the executed HRRR, STOFS-3D, MRMS, and WPC component artifacts without claiming a duplicate model compute or independent format/version qualification
.ipynb 2 s
918 - HMS-RAS Coupled Forecast Execution
illustrate the HMS-to-RAS handoff pattern with a synthetic outlet hydrograph and printed templates for HMS execution, inline or DSS boundary writes, plan-date alignment, and optional HEC-RAS execution; no coupled models are run
.ipynb 11 s
919 - Operational Forecast Cycling
compare four deterministic synthetic QPF cycles with routed flow and rating-curve stage estimates, plot crest convergence and flood-threshold exceedance, and dry-run RAS-ready cycle metadata with optional execution hooks
.ipynb 5 s

916s - Forecast Inputs

Notebook Source Runtime
916 - HRRR Forecast to HEC-RAS: Executed Rain-on-Grid Qualification
reproduce an archived 8 August 2024 15Z HRRR event as 18 hourly native DSS grids, verify source-to-DSS-to-temporary-and-final-HDF forcing, compare no-rain and forecast hydraulics under HEC-RAS 7.0, and map localized convergence exceptions for manual review
.ipynb 8.6 min
917 - MRMS QPE Boundary-Hyetograph Hydraulic Comparison
Align archived MRMS interval ends with the model clock, write uniform precipitation boundaries, and inspect complete native cumulative rainfall histories and baseline/event hydraulic diagnostics for Davis and New Orleans.
.ipynb 48.5 min
923 - STOFS-3D Coastal Water Levels: Units and Datum
Extract an archived NOAA station time series with explicit datum metadata, compare feet and meters, and distinguish source inspection from experimental stage authoring.
.ipynb 3 s
924 - MRMS NetCDF Rain-on-Grid Validation
MRMS QPE workflows, including direct NetCDF rain-on-grid validation
.ipynb 59 s
926 - WPC QPF DSS-to-HEC-RAS Rain-on-Grid Qualification
import a complete WPC forecast cycle with RasDssGrid to 28 six-hour DSS grids, validate every frame against a full-source GDAL warp with missing-cell and mesh-coverage gates, then check temporary and final HDF forcing, no-rain/event HEC-RAS 7.0 simulations, hydraulic response and mapped convergence exceptions; the earlier qpkit route is kept as a disclosed comparison that fails spatial qualification
.ipynb 5.4 min

920s - Terrain & Surfaces

Notebook Source Runtime
920 - Creating a RAS Terrain with ras-commander
terrain and geometry surface workflows
.ipynb 12 s
925 - Cross-Section Interpolation Surface
Build cross-section TIN interpolation surfaces from real geometry, write spatial review layers and optional rasters, and compare channel-only and full-extent surfaces.
.ipynb 6 s
930 - Terrain Modification Analysis
write a channel terrain modification with a uniform design-grade invert along Bald Eagle Creek, then use the optional GDAL bridge to compare existing and proposed terrain profiles and polygon elevation-volume curves and report the cut volume; no baseline or modified hydraulic plans are run
.ipynb 16 s
931 - Native RAS Mapper Terrain Export
export a registered, stitched RAS Mapper terrain to one bounded and semantically validated GeoTIFF, then inspect its typed result, source inventory, receipt, grid alignment, and visual evidence
.ipynb 3 s

950s - eBFE Delivery

Notebook Source Runtime
950 - Using eBFE Models: Spring Creek 2D Analysis
FEMA eBFE/BLE organization and validation
.ipynb 4 s
951 - Using eBFE Models: North Galveston Bay HMS + RAS Integration
Organize a compound North Galveston Bay HMS/RAS delivery and inspect its model paths; file discovery does not establish executable coupling.
.ipynb 3 s
952 - Using eBFE Models: Upper Guadalupe Cascaded Watersheds
This notebook demonstrates working with cascaded watershed models from FEMA eBFE/BLE database.
.ipynb 12 s
953 - Using eBFE Models: Rio Hondo 1D Steady Collection
This notebook demonstrates the Rio Hondo (13060008) eBFE/BLE 1D steady model collection. The delivery is different from the large 2D eBFE examples: it contains hundreds of small 1D steady HEC-RAS projects, and results HDF files are gen...
.ipynb 9 s
954 - Using eBFE Models: Lake Maurepas Validation
This notebook validates the organized Lake Maurepas eBFE delivery format. It is intentionally scoped to the delivery-readiness gate: organize the source archive, confirm ras-commander can initialize the local HEC-RAS project, review the...
.ipynb 3 s
955 - Using eBFE Models: Tickfaw Results-Ready Validation
This notebook validates the organized Tickfaw eBFE delivery as a full 2D example with source-provided result HDFs. It confirms local organization, reviews the saved ras-commander geometry-preprocessor evidence, and checks that plan resul...
.ipynb 3 s
956 - NextGen Hydrofabric Conflation Visual QA — Texas eBFE Shiloh Branch
Visually audits generic HEC-RAS-to-network conflation with the NextGen v2.2 adapter on the Texas Lower Colorado-Cummins SHILOH BRANCH model, including native flowpath and catchment IDs, candidate ranks, score components, explicit resolution states, HUC intersections, and cross-section measures.
.ipynb 5 s
957 - Using eBFE Models: Spring River Validation
This notebook validates the organized Spring River eBFE delivery as a results-ready HEC-RAS 6.1 example. It uses the shared delivery workspace, reviews the saved audit evidence, optionally executes a fresh geometry-preprocessor validatio...
.ipynb N/A
958 - Model Sources: Unified Discovery, Download & Visualization
Discover and download representative models from several public catalogs, initialize each project, and optionally capture native RAS Mapper review images.
.ipynb N/A
959 - Austin Bayou SH 35 2D Breakout and NextGen Validation
Inspect the Austin Bayou completed child, conflate a NextGen reach, author external boundaries, and review a parent-derived flow ladder and focused parent/child comparison.
.ipynb 3.2 min

960s - Cloud-Native Export

Notebook Source Runtime
960 - Cloud-Native Geometry Export with ras2cng
cloud-native export with ras2cng
.ipynb N/A
961 - Cloud-Native Results Export with ras2cng
Export HEC-RAS simulation results to cloud-native GeoParquet, build interactive flood depth maps, and generate PMTiles for web deployment using ras2cng.
.ipynb N/A
962 - Cloud Optimized GeoTIFF Results Export with ras2cng
cloud-native export with ras2cng
.ipynb N/A
963 - Froude and shear-stress maps at selected timesteps
Configure and compute a copied Muncie plan, export maximum and selected-timestep Froude and bed-shear-stress GeoTIFFs, verify their HDF sources and georeferencing, and visually review the real hydraulic outputs.
.ipynb 1.7 min