sample-datasets.md

February 11, 2025 ยท View on GitHub

Sample Benchmark Datasets

idid_trainds_sizeUrban RegionCountryContinentUrban TypeDensityRoof TypeDownload
1364399KakumaKenyaAfricaRefugee CampSparseMetalDownload
2370168DenverUSAAmerica NorthPeri-UrbanGridShinglesDownload
3372420MontevideoUruguayAmerica SouthUrbanGridCementDownload
4373399Montevideo DenseUruguayAmerica SouthUrbanDenseCementDownload
5391231KutupalongBangladeshAsiaRefugee CampDenseMixedDownload
6394504Gornja RijekaCroatiaEuropeRuralSparseShinglesDownload
7397756MelbourneAustraliaOceaniaUrbanGridCementDownload
8398152PembaTanzaniaAfricaRuralSparseMetalDownload
9399294ChristchurchNew ZealandOceaniaPeri-UrbanSparseShinglesDownload
10456147PergaminoArgentinaAmerica SouthPeri-UrbanGridMixedDownload
11459105SilvaniaBrazilAmerica SouthRuralSparseShinglesDownload
12462147Desa KulabaIndonesiaAsiaRuralSparseMetalDownload
13463168RoseauDominicaAmerica CentralPeri-UrbanSparseMixedDownload
14485147Pallabi DhakaBangladeshAsiaUrbanDenseMixedDownload
15488168DhakaBangladeshAsiaUrbanDenseMixedDownload
16489147GgabaUgandaAfricaPeri-UrbanDenseMixedDownload
17529546InagiJapanAsiaPeri-UrbanSparseMixedDownload
18508226TchiniambiDRCAfricaPeri-UrbanDenseMetalDownload
19539672Staraya RussaRussiaEuropeRuralSparseMixedDownload
20530189BanyuwangiIndonesiaAsiaUrbanDenseShinglesDownload
21526672DzalekaMalawiAfricaRefugee CampDenseMetalDownload
22523252BogotaColombiaAmerica SouthUrbanGridMixedDownload
23524315SoudureNigerAfricaRuralDenseMixedDownload
24525420QuincyUSAAmerica NorthPeri-UrbanGridShinglesDownload
25528756NgaoundereCameroonAfricaPeri-UrbanGridMetalDownload

Source and Credit : Anna Zanchetta , More details

How to Get the Data

You can use the following Python script to generate download links for all available training datasets:

# List of training IDs from the table
training_ids = [
    364, 370, 372, 373, 391, 394, 397, 398, 399, 456, 
    459, 462, 463, 485, 488, 489, 529, 508, 539, 530, 
    526, 523, 524, 525, 528
]

base_url = "https://fair-dev.hotosm.org/api/v1/workspace/download/training_{}/preprocessed/preprocessed.tar.xz/"

download_links = [base_url.format(train_id) for train_id in training_ids]

for link in download_links:
    print(link)

Training details can be found from API call like this : https://fair-dev.hotosm.org/api/v1/training/364/

Dataset Structure & Download Guide

Overview

This dataset consists of 256x256 pixel image tiles that follow the Mercator tiling scheme. Each tile is associated with:

  • Imagery ("chips/")
  • Vector labels ("labels/")
  • Binary masks ("binarymasks/") (optional)

The filenames follow this naming convention:

OAM-{mercantile_tile_x}-{mercantile_tile_y}-{zoom_level}.ext

Where:

  • OAM: Prefix indicating OpenAerialMap (or similar sources).
  • mercantile_tile_x / mercantile_tile_y: Tile coordinates in the Mercator grid.
  • zoom_level: The zoom level of the tile.
  • ext: .tif (imagery), .geojson (labels), .mask.tif (binary masks).

Folder Structure

1. Chips (chips/)

  • Contains satellite/aerial imagery tiles.
  • Each .tif file corresponds to a specific Mercator grid tile.
  • Example: OAM-1251460-1026614-21.tif.

2. Labels (labels/)

  • Contains vector annotations (GeoJSON).
  • Each file is clipped to the exact boundary of the corresponding image tile.
  • Example: OAM-1251450-1026604-21.geojson matches OAM-1251450-1026604-21.tif.

3. Binary Masks (binarymasks/)

  • Rasterized (burned) version of the labels.
  • Binary format (0/1) indicating building footprints.
  • Not required if users prefer to generate masks from chips/ and labels/.
  • Example: OAM-1251456-1026606-21.mask.tif.

Distribution of datasets

image

More info

Check this presentation for Anna's research result and explanation here