World Water LevelsWater, in perspective

Methodology

How does World Water Levels work out its numbers?

The readings are the agencies' own. What this site adds is a comparison with the same dates in past years, records for each gauge and the time of each reading. This page says how each is worked out.

On this page

Where the readings come from

Every reading comes from an official agency, and each page names its sources. Our own jobs read what the agencies publish, and the site does not change a reading. The sources page lists each source, its licence and when it was last read.

The normal range for a date

The normal range for a date is the 10th to 90th percentile of the daily values for the same dates in past years. The 10th percentile is the value that a tenth of past values fall below, and the 90th is the value that a tenth rise above, so the range holds the middle four fifths of past values.

For each date we take the 15 days centred on it, 7 days on either side, in every past year that counts, and pool their daily values. A year counts for a date only if at least 12 of those 15 days have a complete daily value. The current year never counts.

A date gets a normal range only when at least 10 years count. With fewer years the page shows no normal range. Pages for France, Czechia, Canada and North Rhine-Westphalia also say how far the record goes back, and say so when it is too short. A source that publishes one value a week is treated the same way, with the weekly values in the window; a year counts there when the window holds at least two.

The percentiles use the Weibull plotting position, a standard method. Each place page that shows a normal range states the dates, the number of years and the first and last year behind it.

A reading is below the normal range when it is lower than the 10th percentile, and above it when it is higher than the 90th. Between the two, or equal to either, it is within the range. Pages also say how far into the tail a reading lies: in the lowest or highest 10 percent, in the lowest or highest 5 percent, or lower or higher than any value of those dates in the years used.

The lists of places furthest from normal rank only places with at least 10 years of data and a current reading. A place ranks first by where its newest reading sits for the date, then by how far it lies beyond the 10th or 90th percentile, measured in widths of the normal range.

Records

A record on this site is the lowest or highest reading, or the lowest or highest daily value, in our series for that gauge. Our series starts on the first day we hold comparable data for the gauge, which can be later than the day the gauge began. So a record here means "in our series since" a date, and the page gives the date.

An equal value never replaces a record: the earlier day stands. A record set on a provisional day is marked provisional.

Where an agency publishes its own record for a gauge, we show it apart and label it as the agency's. If our series holds a lower or higher value than the agency's record, the page says so.

For a reservoir, records and the normal range count from a day we have reviewed, such as the day it first filled or first neared its full level, and the page gives that day.

Times and updates

The time on a place page is the time of the newest reading, as the source reports it. It is shown in the place's own time zone with the zone's name, such as CEST, and a machine-readable UTC time sits behind it. It is not the time we fetched the data.

A source that gives one value a day, or one a week, is dated by that day. When a source stops giving readings, the page says when the last one came, with its value, and does not present it as current.

Sources update at different rates. The sources page shows when each was last read successfully. Agencies correct values after they publish them. Each build takes the newest values, so a corrected value replaces the earlier one on every page that shows it.

Provisional and unchecked data

Most readings are provisional or unchecked raw data. PEGELONLINE, for example, says that the data it gives for download are unchecked raw data, and other agencies mark their values as provisional. For North Rhine-Westphalia, the state office LANUK publishes its newest readings as unchecked raw data in files it rebuilds once a day; its normal ranges and records come from the checked daily series it releases months later, and from its raw daily means for the days it has no checked value for yet.

A complete day with a provisional value counts in normal ranges and records like any other value. An incomplete day counts in records but not in normal ranges. A day a source has not yet published, made from readings until the agency's own daily value arrives, counts in neither. Where a record rests on a provisional day, the page says so.

Units, gauge zero and datum

A page gives each value with its unit, and with the datum or gauge zero where the source names one. A reading is shown on the datum or gauge zero its source uses, and we do not move it to another, so a gauge is only ever compared with itself.

When an agency changes a gauge's zero, readings before and after may not be on the same scale. We start a gauge's series again after a change only when we have checked that the change moved the readings. A change we have not checked does not cut the series.

How the text is written

Every sentence on a place, history, list or hub page is written by a template from the data, by code. The home page and the pages of explanation, this one included, are fixed written text.

Navigation, safety and flood advice

World Water Levels is not an official warning service. It issues no flood warnings and no navigation notices.

Every data page carries a line that says the readings are provisional or unchecked data from the agencies it names, and that they are not navigation, safety or flood advice.

On pages for some countries the line adds a link to an official service: the notices of ELWIS for the federal waterways of Germany, the flood portal of North Rhine-Westphalia for that state's gauges, the flood watch of Vigicrues for France, the flood forecasting service of CHMI for Czechia, the flood warnings of the Environment Agency for England, the water situation and warnings on Vesi.fi for Finland and the warnings of the Meteo LT service for Lithuania.

We say nothing about whether a waterway, lake or river can be used, entered or crossed. For shipping, use the official notices of the waterway authority. For flood warnings, use the official service of your country.

Changes

  • : First published.
  • : Finland added to the countries whose pages link an official service.
  • : North Rhine-Westphalia added to the pages that link an official service.
  • : Lithuania added to the pages that link an official service.