v1.0 · Web Application · Desktop installers available for macOS and Windows

FIMsim is a web-based tool designed to eliminate the technical barrier of setting up 2D flood simulations. It serves two distinct purposes: (1) automated preparation of individual hydraulic model input data — including terrain, land cover, river networks, and streamflow time series — and (2) end-to-end configuration and cloud execution of complete flood mapping simulations for four supported flood mapping models (LISFLOOD-FP, TRITON, ARC-Curve2Flood, and OWP HAND-FIM). Users define a study area, and FIMsim handles all data downloading, processing, and file formatting automatically. For users who prefer a local setup, standalone desktop installers for macOS and Windows are also available — no Python installation or technical configuration required.

FIMsim addresses two separate but related challenges in flood modeling:

1. Preparing individual model inputs independently: Hydrologists often need specific geospatial datasets — a DEM for one project, LULC for another, streamflow records for analysis — without running a full simulation. FIMsim provides four standalone tools that each produce one type of input file in different formats, ready to use in any model or workflow.

2. Running a complete flood simulation end to end: When the goal is a full flood inundation map, FIMsim can take over the entire pipeline. After the user defines a study area, it downloads every required input, writes all model-specific configuration files, and submits the simulation to run on cloud infrastructure — no local software installation or GIS expertise required.

FIMsim connects to the following public data services. An internet connection is required during data downloads.

• Multi-AOI batch processing — define multiple study areas in a single shapefile or GeoPackage; all downloads and outputs are handled per AOI automatically
• Editable Manning's n table — the LULC step generates a land-cover lookup table with Min / Avg / Max roughness values that the user can edit before export
• Upstream / downstream detection — the flowline step automatically identifies the upstream and downstream endpoints of the main river and marks them on the map
• Map preview — at each step, the app plots the results for visual inspection before saving

FIMsim is deployed as a web application — no installation required. Open it in any browser and start a project immediately.

🔗 Live app: (link coming soon)

For users who prefer a local installation, standalone installers are available on the Releases page — no Python or conda setup required.

git clone https://github.com/pnikrou/FIMsim.git
cd FIMsim
conda env create -f environment.yml
conda activate FIMsim
python main.py

Don't have a study area of your own? The test_case/ folder ships two ready-to-use AOI shapefiles with complete step-by-step walkthroughs — you provide the AOI polygon and the event start/end dates; FIMsim downloads everything else automatically.

Each walkthrough includes a screenshot of every step and states the expected result (detected river, USGS gage, generated files) so you can verify your installation is working correctly.