urschrei / hexcover

Hexcover: tile an area with regular flat-topped hexagons

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Hexcover

A utility package which calculates a regular hexagonal tiling for an area, given a centroid as a Shapely Point, and a side length.

Installation

Hexcover is available on PyPI:
pip install hexcover

Usage

from shapely.geometry import Point
from hexcover.util import hexagon_coverage

# centroid
c = Point(0.0, 0.0)
coverage = hexagon_coverage(c, 10)

# coverage is a namedtuple of seven polygons. The first entry is the central polygon.
# Subsequent entries begin directly above the central polygon, and proceed clockwise.

The returned namedtuple has seven fields:

  • centre
  • top
  • topright
  • bottomright
  • bottom
  • bottomleft
  • topleft

Examples

There's an example notebook, and a sample output GeoJSON file showing the result of covering the Crystal Palace Transmitting Station with 100-metre hexagons.

Input Coordinates

A projected coordinate system must be used. Don't give input in e.g. WGS84

Requirements

Shapely >= 1.6.3

License

The Blue Oak Model License 1.0

DOI

DOI

About

Hexcover: tile an area with regular flat-topped hexagons

License:Other


Languages

Language:Python 100.0%