Skip to content

Why this guide exists

Delft-FEWS is a powerful system for managing time series and running operational forecasts — flood, drought, streamflow, and more. Its configuration is correspondingly deep: hundreds of XML file types, dozens of display widgets, and model adapters for everything from HBV to LISFLOOD.

The official Configuration Guide documents all of it. It is accurate and complete. But it is a reference manual, and it says so — it assumes you already understand “Delft-FEWS and its structure.” If you’re new, that’s the exact thing you don’t have yet.

This guide is built around three ideas:

  1. Concepts before configuration. You’ll get a mental model of how data moves through FEWS before being asked to edit XML. Almost every configuration decision follows naturally once that model is in place. See Core Concepts.

  2. Organized by task, not by schema. The official docs are organized around the config files themselves. But you don’t wake up wanting to edit IdMapFiles; you wake up wanting to import a time series and see it on a chart — which happens to touch five different files. The task guides are organized around what you’re trying to do.

  3. Examples you can copy. Every concept and task is grounded in a small, complete, copy-pasteable XML example, with the common mistakes called out.

  • Newcomers configuring their first FEWS region.
  • Experienced users who want a faster path to a specific answer.
  • Anyone who has bounced between the wiki and the .xsd schemas one too many times and wanted them in the same place.

This is not official Deltares documentation, and it doesn’t replace the official guide or the XML schemas — it points you to both when you need the exhaustive detail. It also doesn’t cover installing or operating FEWS; the scope here is configuration only.