# Lighthouse Global Coastline Dataset: 10 m Land/Water Tiles and Coastal-Point Ball Trees for Distance-to-Shoreline Queries (Ai2)

## Facts

- Provider: Allen Institute for AI (Ai2)
- License: ODbL-1.0 (https://github.com/allenai/lighthouse)
- Stored at: Google Cloud Storage, gs://ai2-coastlines/v1/data (us)
- Access: public, readable without an account
- Category: Earth Observation & Geospatial
- Source: https://arxiv.org/abs/2506.18842
- Page: https://scigantic.com/archive/49a4c0d4-6304-5333-a04d-56fa24d2656b
- Keywords: Earth Observation & Geospatial, Google Cloud Storage

## About

Lighthouse is Ai2's global dataset and service for computing the distance from any point on Earth to the nearest shoreline, including inland water such as rivers, lakes and bays. The land/water classification is built at 10 m resolution from a hybrid of ESA WorldCover v2 (2024) land cover and OpenStreetMap land-water polygons. The data are cut into 1 by 1 degree tiles named by their upper-left corner (for example N00E006). v1/data/resampled_h5s/ holds one HDF5 raster per tile (Ai2_WorldCover_10m_2024_v1_ _Map.h5) with the resampled land cover classes, and v1/data/ball_trees/ holds one scikit-learn ball tree per tile (.joblib) built over the extracted coastal points, which the Lighthouse algorithm combines with a precomputed spherical Voronoi tessellation of the planet's coastlines to answer nearest-coast queries in milliseconds. The full set is about 500 GB. Read the .h5 tiles with h5py and the ball trees with joblib, or mount the folder into the ghcr.io/allenai/lighthouse Docker image, which returns distance to coast in meters, the land cover class and the nearest coastal point for a latitude and longitude. Useful for coastal proximity features, maritime vessel analytics and shoreline studies. License: dataset under the Open Database License (ODbL) v1.0, code under Apache 2.0. Cite the Lighthouse paper (arXiv:2506.18842), Ai2.

## Load the data

```python
import gcsfs
fs = gcsfs.GCSFileSystem(token='anon')
fs.ls('ai2-coastlines/v1/data/', detail=False)[:10]
```

Lists the files with anonymous access. Runs on any machine, with no cloud account.

## Data structure

Example file: `v1/data/ball_trees/Ai2_WorldCover_10m_2024_v1_N00E006_Map_coastal_points_ball_tree.joblib`

## Open it

- In a hosted notebook with the data mounted: https://scigantic.com/archive/49a4c0d4-6304-5333-a04d-56fa24d2656b
- Full record as JSON (schema card included): https://api.scigantic.com/api/archives/49a4c0d4-6304-5333-a04d-56fa24d2656b
- Over MCP: `get_schema_card` with id `49a4c0d4-6304-5333-a04d-56fa24d2656b` at https://api.scigantic.com/mcp

## Related topics

- [Earth Observation & Geospatial datasets](https://scigantic.com/topics/earth-observation-and-geospatial)
