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

Useful documentation

Warm-up exercise: Accessing the FANFAR Community and FANFAR App on Hydrology-TEP

  1. FANFAR Community page on Hydrology-TEP
    1. Direct link: https://hydrology-tep.eu/#!communities/details/westafrica-hm
    2. Browsing
      1. Go to the Hydrology-TEP website: https://hydrology-tep.eu/
      2. Sign in (at the top right hand corner).
      3. Click “View Communities” . Navigate or search for “FANFAR”. Click Enter

      2. FANFAR App on Hydrology-TEP:

    1. Direct link: https://hydrology-tep.eu/geobrowser/?id=fanfar
    2. Browsing:
      1. Go to the Hydrology-TEP website: https://hydrology-tep.eu/
      2. Sign in (at the top right hand corner).
      3. Click “View Communities” . Navigate or search for “FANFAR”. Click Enter
      4. Look for the FANFAR app under Community Applications. Click “Open App”



Exercise 1. Access automatically produces forecasts & download results

1. Navigate to the FANFAR App (see above)

2. In the top right corner (red circle below), click “Automatic Production” -> “Hydrological Forecasts”. Then choose the forecast production chain that you would like to analyse.

3. The results of the automatic forecast production are presented in the bottom left box (“Current search results”, green circle below). Each item represents the forecast made on one specific issue date (as defined here). Both the most current and all past issue dates are available here. What issue date does the last automatically produced forecast have for for each model configuration?


4. Click one item to view the forecast output for a specific issue date. A pop-up window appears with details about the scheduled job (below).


5. In the pop-up window one can review the scheduling details (e.g. time the run was queued, submitted for processing, and completed). How long time did it take between the time that the forecast was queued until it was completed? One can click further to e.g. Download or View results.

6. In the pop-up window, click ‘Download’ to navigate to a new page where each output file can be downloaded to your local disk (see below). See the documentation of the service for a description of all the output files. In this view all output files are displayed.


7. Alternatively, in the pop-up window for the automatic forecasts, click “View results” to load the resulting output of the processing service in the “Current Search results” at the bottom left box. See the documentation of the service for a description of all the output files. These files can now be downloaded or used in further processing on the platform. Note this visual interface does not always show all output files. To download results from the "Current Search results" do this:

a) Click on the file you would like to download in the "Current search results" box at the bottom left. In most cases there is a pop-up window appearing (e.g. for *forecast_timeCOUT.txt, first below). If not, you may have to click the ‘Toggle pop-up button’ (e.g. for subbasin_shp.zip).

b) Click the Download button (red circle below) & save to your local disk.


8. While viewing the results of a specific forecast issue date, a new green button appears on the top (“Related results”). To go back to the list of issue dates, click on the “Related results” X button.




Exercise 2. Run the FANFAR Forecast service interactively

1. Go to the FANFAR Forecast App on Hydrology-TEP and click on “Processing Services” on the right hand side of the screen (see below).


2. Click on the icon for the “FANFAR Forecast” processing service (red below)


3. Use the default settings (to understand what they mean see the definition of each input parameters). Change the forecast issue date and add the SUBID for a station, e.g. Niamey

a) Forecast issue date: 2019-01-15

b) Output sub-basins (SUBID): 213123 (valid for World Wide HYPE 1.3.6).

4. Click the blue button at the bottom ‘Calculate Cost’ and then again on the same button ‘Run Job’ (see below).


5. Wait for the processing to run (first figure below). Note this can take some time. You can monitor the status of your jobs by clicking the ‘back arrow’ (red circle below), and then the ‘Jobs’ tab (second figure below). In case it is not finished quickly, you can log out of the portal and check again at another time (it will run in the background).


6. Explore the resulting files in the “Current Search results” (green circle above). Note, there can be several tabs with files. To understand the output files, see documentation of the service. Do download the files, see above on Exercise 1. Your run should produce identical results to the shared job ‘FANFAR Forecast Demo #1’ (which can be found by searching for the job name in the "Job" tab's search field and then clicking the button "Show results").

7. Try to change some of the input parameters and submit a new job

    1. Try changing the issue date to 2019-09-11
    2. Try adding outputs of the Garbe Kourou and Niamey stations. For World-Wide HYPE 1.3.6 Garbe Kourou has SUBID 208596 and Niamey has SUBID 213123. Tip: click on the plus sign to add another station. Other stations can be found by using the Location search at https://fanfar.eu/ivp/
    3. What was the peak streamflow discharge for each station for this issue date?
    4. A simulation using these settings (a & b) should produce identical results as the shared job ‘FANFAR Forecast Demo #2’ (which can be found by searching for the job name in the "Job" tab's search field and then clicking the button "Show results").



  • No labels