Download - data description
These datasets contain raw data collected within the Cooling down the City project. Data is published monthly, with one archive per calendar month.
Measurements contain indoor temperature and humidity data. Sensors in the dataset are bound to different rooms in a home and have different periods of activity. Each sensor has metadata about the room/situation attached. The aim was to get most sensors active in the summer.
Measurements where not done at a constant frequency, depending on the connectivity sensors did send up to once every 20 seconds.
Data is available under the CC BY-NC-SA 4.0 Creative Commons license.
Monthly archives are at coolingdownthecity.nl/downloads/. Each archive is named after the month it covers, for example 2026-06.tar.gz, and contains the measurements for that month.
data
Each archive contains a csv file per sensor using the following format for the filename:[home_id]_[instance_id].csv . An example of the contents of 4_1.csv :
utc,temperature,humidity
1781721000,24.5,61.6
1781721600,24.2,63.9
1781722200,23.9,65.4
1781722800,23.7,66
The columns:
- utc: the Epoch / Unix timestamp in seconds
- temperature: temperature in degrees Celcius
- humidity: relative humidity in percentage
meta data
Metadata is served through the project API rather than bundled in the archives. Two endpoints are available:
- api.coolingdownthecity.nl/devices — the list of sensors and their names (the room a sensor is placed in).
- api.coolingdownthecity.nl/all_tags — the full vocabulary of metadata properties and their possible values.
The full metadata per sensor — the combined properties of the house and the room the sensor is located in — can be retrieved from api.coolingdownthecity.nl/find_devices. Every sensor has an id of the form [home_id]_[sensor_type]_[instance_id], which maps to the csv file [home_id]_[instance_id].csv in the archive (e.g. sensor 4_thermopro_1 corresponds to 4_1.csv). An example of the metadata for one sensor:
{
"id": "4_thermopro_1",
"name": "woonkamer",
"home_id": 4,
"instance_id": 1,
"sensor_type": "thermopro",
"postal_code": "3534BH",
"knmi_station": "260",
"verdieping": ["4"],
"hoekwoning": ["nee"],
"schaduw": ["geen"],
"ventilatie_huis": ["ja"],
"orientatie": ["NO"],
"zonwering_intern": ["donkere_gordijnen"],
"zonwering_extern": ["zonnescherm"],
"ventilatie_gedrag": ["ja"],
"apparaat": ["geen"],
"gebouw": ["TRACK"],
"ruimte": ["woonkamer"]
}meta data properties
Properties are in Dutch and are limited to the following values:
- gebouw (building)
- SOLO (SOLO)
- TRACK (TRACK)
- hoekwoning (corner house)
- ja (yes)
- nee (no)
- verdieping (floor)
- 0 (ground floor)
- 1 (1st floor)
- 2 (2nd floor)
- 3 (3rd floor)
- 4 (4th floor)
- schaduw (amount of shade)
- geen (none)
- weinig (little)
- veel (a lot)
- ventilatie_huis (ventilation options in the home)
- ja (yes)
- nee (no)
- raam-orientatie (orientation of the windows in the room)
- N (N - North)
- NO (NE - Northeast)
- O (E - East)
- ZO (SE - Southeast)
- Z (S - South)
- ZW (SW - Southwest)
- W (W - West)
- NW (NW - Northwest)
- geen (none)
- ruimte (type of room)
- woonkamer (living room)
- slaapkamer (bedroom)
- anders (other)
- zonwering_intern (indoor sun protection)
- geen (none)
- lichte_gordijnen (light curtains)
- donkere_gordijnen (dark curtains)
- lamellen (blinds)
- anders (other)
- zonwering_extern (outdoor sun protection)
- geen (none)
- zonnescherm (awning)
- folie (window film)
- anders (other)
- ventilatie_gedrag (room is ventilated)
- ja (yes)
- nee (no)
- apparaat (cooling device)
- geen (none)
- airco (air conditioning)
- anders (other)