Skip to main content

A5 - Global Pentagonal Geospatial Index

Project description

A5 - Global, equal-area, millimeter-accurate geospatial index

Website: A5Geo.org

thumbnails

Introduction

A5 is a geospatial index that partitions the world into pentagonal cells. The cells are available at 31 different resolution levels, with the largest cell covering the whole world, and the smallest less than 30mm². Within each resolution level the cells have equal area, as per the OGC definition.

A5 cells provide simple way to represent spatial data as a collection of cells, which together represent regions on the globe. These can be anything, from city districts to parcels of land. Once data is in a cell-based format, it becomes much simpler to perform analysis such as calculating the correlation between different variables - for example elevation and crop yield.

Cells can also be used to group (aggregate) point data, to understand how it spatially distributed. For example, the density of holiday rentals across a city.

To understand how it works, take a look at the Examples.

A5 is implemented in TypeScript and is available as a library, with API documentation here. It is open source and licensed under the Apache 2.0 License.

Benefits over alternative systems

Like other DGGSs, A5 can be used for indexing, spatial joins, and other spatial operations. The appropriate choice of DGGS will depend on the use case, the key strengths of A5 over other similar indexing systems are:

  • Equal area cells group spatial features without introducing bias.
  • Very high resolution of 30mm² at final resolution level, encoded as a 64-bit integer.
  • Single cell topology type, with minimal shape distortion across the globe.

Geometric Construction

DGGSs are generally based on a planar cell tiling which is applied to the sides of a platonic solid, before being projected onto a sphere.

A5 is unique in that it uses a pentagonal tiling of a dodecahedron. The pentagon chosen for the tiling is equilateral, but not regular - unlike other common DGGSs which use regular polygons, for example HTM uses triangles, S2 uses squares, and H3 uses hexagons.

The benefit of choosing a dodecahedron is that it is the platonic solid with the lowest vertex curvature, and by this measure it is the most spherical of all the platonic solids. This is key for minimizing cell distortion as the process of projecting a platonic solid onto a sphere involves warping the cell geometry to force the vertex curvature to approach zero. Thus, the lower the original vertex curvature, the less distortion will be introduced by the projection.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pya5-0.7.3.tar.gz (221.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pya5-0.7.3-py3-none-any.whl (70.5 kB view details)

Uploaded Python 3

File details

Details for the file pya5-0.7.3.tar.gz.

File metadata

  • Download URL: pya5-0.7.3.tar.gz
  • Upload date:
  • Size: 221.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.7.4

File hashes

Hashes for pya5-0.7.3.tar.gz
Algorithm Hash digest
SHA256 c59f48396c7bc017a953299e86f6f7dcdbaab0a3dc792e41bea9f422cd1007e6
MD5 46fa456707cae643f23b2aacc295717a
BLAKE2b-256 dd60cf1713789518c98dde336058b972c268a7ad5984f01a393b40140d7ac074

See more details on using hashes here.

File details

Details for the file pya5-0.7.3-py3-none-any.whl.

File metadata

  • Download URL: pya5-0.7.3-py3-none-any.whl
  • Upload date:
  • Size: 70.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.7.4

File hashes

Hashes for pya5-0.7.3-py3-none-any.whl
Algorithm Hash digest
SHA256 d2570f6799d48237ba2a60b6401aa3d06f04a7aea65b029031fe10e2f6d40d2c
MD5 85a7d602e917df9020b86a497a4bfc82
BLAKE2b-256 036ef1ea7de16afebec3537703da059cf6b659c060d657bb84d805ed5cbd046c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page