Page tree
Skip to end of metadata
Go to start of metadata

Interactive Visualisation Portal 

Welcome to the Interactive Visualisation Portal (IVP) of the FANFAR project. This portal is an interactive operational platform for accessing flood forecasts and flood risk alerts in West Africa. The platform provides information on stream flows from the Niger HYPE model and the Worldwide HYPE model. To access the Interactive Visualisation Portal, go to the FANFAR home page ( 


The web page is in English by default. However you may also choose French or Portuguese as your navigation language.

Place your cursor over the Forecast visualisation panel to reveal the Interactive Visualisation Platform drop down menu, then click on it to display the interactive visualisation map page.

Video Tutorials

Overview of the Interactive Visualisation Portal

The general layout of the Interactive Visualisation Portal is as follows:

A:  An overlay cluster on the upper right corner displays the current map scale (1), the coordinates XY for a given point on the map (3),and display controls for zooming in or out of the map (2).

B:  The main menu on the upper left corner (4).

C:  The Forecast display panel (5) showing the estimated forecast for the next 10 days from the issue date which is 06/02/2020 in the figure below.

Note, the portal uses a set of terms, which are further explained here.

The menu

If not already displayed, click on the menu button (4) above, in the upper left corner to activate the menu panel containing drop down options for "Location", "Forecast settings" and "Map View".


The seach bar (3) of the Location menu (1) lets you search for a specific gauge, station, city, populated place or catchment through its SUBID. You could also click on the interactive map to select coordinates or alternatively input the desired coordinate manually in the Lat and Lon boxes (4). As an example the Niamey station (SUBID 213123) is chosen here. Note that the map may take a while to load depending on your internet connection.


Map view

The Map view options (1) shown below lets you view the Forecast layers which display the disaster risk levels (2). Disaster risk is predefined by the level of exposure to the hazard (flood), vulnerability or susceptibility of the exposed asset to damage as well as the severity or extent of the hazard obtained by the crossing of thresholds defined by the return period of the steamflow forecast for 10 days from t0, the forecast date (3). You can display the associated Catchment (SUBID) with a tickbox.

The Context layers (4) are displayed below the Forecast layers: These consist of Country borders,  Rivers, Catchment boundaries, Water occurrence, Population density, and map background, which is white by default.

Forecast settings

The Forecast Settings include option selections for  Model, Variables and Flood hazard threshold respectively.  

Currently available Model options are Worldwide HYPE V.1.3.5  and Niger HYPE v2.23 but other versions or even other models may appear later.

Under Variables, Streamflow is currently available on the portal and other variables might be added in the future. 

The Flood hazard threshold is currently estimated in relation to Return periods based on simulations. Other thresholds may be available soon.  


To find out more about the Models, Variables and the Flood hazard threshold, click on the information icon opposite the parameter in question, as shown in the following figure: 


For example, clicking on the information icon for World-Wide Hype v1.3.5 gives characteristics of the hydrological model  as shown below:

bild 7_2.png

Context Layers 

Further down the Map View menu , you can navigate between the different Context layers to display Country borders, rivers, Catchments, Water occurrences for the period 1984-2018, population density and the map background (white by default).


Have fun ticking one layer at a time to familiarize yourself with how each works!

Forecast layers

In the Map View menu , you can select to view any or all of the possible Severity levels and display the associated Catchments  at risk. An alert is triggered when the streamflow exceeds a statistically critical threshold corresponding to the severity of the risk of flooding. The critical thresholds are based on return periods of a flood compared to the historical hydrological balance of a catchment area for a given watercourse.

At the moment, we have three Severity levels:

  1. level 1 alert (yellow) indicates flooding exceeding a 2-year return period for the catchment area concerned;
  2. Level 2 alert (orange) indicates a 5-year return period event and 
  3. Level 3 alert (pink) indicates a 30-year return period event.

To view the map, check the " catchment (SUBID) " option to display the extent of the flood risk zones with colors corresponding to their alert level. The areas marked with  green  (0) are areas under normal or risk-free conditions during the next 10 days from the day (t0) of issuance of the forecast while the areas at risk are displayed in yellow, orange and red respectively for disaster risk levels (1), (2) and (3).

bild 9.png

Toggle the Severity levels  to display the locations at risk for a given alert level during the next 10 days from the forecast issue date.

bild 10.png

bild 10_2.png

The issue date is the production date of the forecast. It is 06/02/2020 in the figure just above 

Graph display

Take the case of SUBID 213123 (1) from the Niamey station, which displays a severity level 1 alert (or another city of your choice with an alert displayed). 

Click on the ball marked 1 at Niamey (2) and  the simulated streamflow is displayed on the bottom left corner on the map (3). 

The Y axis represents the streamflow in cubic meters per second (m3/s) for the corresponding time step on the X axis. 

Light blue (4) shows the simulated historical values obtained by forcing the model with HYDROGFD meteorological data and the deterministic forecasts of the European Weather Forecast Center (ECMWF) up to the day before the forecast (t <0 → t0, t = days). 

Purple (5) represents the simulations for a forecast period of 10 days based on the initial state and the weather forecast data on the future meteorological dynamics (t1 → 1 <t> 10) (6). Green indicates normal conditions.

Bild 14.png

Click on "  download data for SUBID 213123  (7) to access the forecast data issued on day t0 (8).



Have fun typing in any site of your interest in the search field of the Location menu, for example Abuja, as you explore the various features of the Interactive Visualisation Portal!

  • No labels