geojson-rewind - GitLite

KO | EN

gitlite — search

#ios #github #python #cli #java #c #animation #computer-vision #large-language-models #php

geojson-rewind

(★ 20)

:earth_africa: A Python library for enforcing polygon ring winding order in GeoJSON

File Explorer

ZIP Download

- - publish.yml
  - test.yml
- dependabot.yml
- __init__.py
- __version__.py
- rewind.py
- - both_reversed.input.geojson
  - both_reversed.output.geojson
  - empty.input.geojson
  - empty.output.geojson
  - featurecollection.input.geojson
  - featurecollection.output.geojson
  - geomcollection.input.geojson
  - geomcollection.output.geojson
  - inner_reversed.input.geojson
  - inner_reversed.output.geojson
  - multipolygon.input.geojson
  - multipolygon.output.geojson
  - near_zero.input.geojson
  - near_zero.output.geojson
  - passthrough.input.geojson
  - passthrough.output.geojson
  - point_crs84.input.geojson
  - point_no_crs.input.geojson
  - point_other_crs.input.geojson
- tests.py
.flake8
.gitignore
.isort.cfg
CHANGELOG.md
LICENSE
Makefile
poetry.lock
pyproject.toml
README.md
release.sh
run_tests.py

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

Command Glossary

Commands referenced in this DOCs, explained below.

🔍

`pip install`

View Details ▼

Install Python packages.

pip install {{package1 package2 ...}}

Install one or more packages:

pip install {{package1 package2 ...}} {{[-U|--upgrade]}}

Upgrade all specified packages to the latest version, installing any that are not already present:

pip install {{package}}=={{version}}

Install a specific version of a package:

# Project Badges

Run tests Visit
codecov Visit
PyPI Version
License
Python Compatibility
Code style: black

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

A Python library for enforcing polygon ring winding order in GeoJSON

The [GeoJSON](https://tools.ietf.org/html/rfc7946) spec mandates the [right hand rule](https://tools.ietf.org/html/rfc7946#section-3.1.6):

> A linear ring MUST follow the right-hand rule with respect to the area it bounds, i.e., exterior rings are counterclockwise, and holes are clockwise.

This helps you generate compliant Polygon and MultiPolygon geometries.

Note: Co-ordinates in the input data are assumed to be WGS84 with (lon, lat) ordering, [as per RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.1.1). Input with co-ordinates using any other CRS may lead to unexpected results.

## Installation

```
pip install geojson-rewind
```

## Usage

### As a Library

Enforce RFC 7946 ring winding order (input/output is a GeoJSON string):

```py
>>> from geojson_rewind import rewind

>>> input = """{
...      "geometry": {   "coordinates": [   [   [100, 0],
...                                             [100, 1],
...                                             [101, 1],
...                                             [101, 0],
...                                             [100, 0]]],
...                      "type": "Polygon"},
...      "properties": {"foo": "bar"},
...      "type": "Feature"}"""

>>> output = rewind(input)

>>> output
'{"geometry": {"coordinates": [[[100, 0], [101, 0], [101, 1], [100, 1], [100, 0]]], "type": "Polygon"}, "properties": {"foo": "bar"}, "type": "Feature"}'

>>> type(output)
<class 'str'>
```

Enforce RFC 7946 ring winding order (input/output is a python dict):

```py
>>> from geojson_rewind import rewind

>>> input = {
...     'geometry': {   'coordinates': [   [   [100, 0],
...                                            [100, 1],
...                                            [101, 1],
...                                            [101, 0],
...                                            [100, 0]]],
...                     'type': 'Polygon'},
...     'properties': {'foo': 'bar'},
...     'type': 'Feature'}

>>> output = rewind(input)

>>> output
{'geometry': {'coordinates': [[[100, 0], [101, 0], [101, 1], [100, 1], [100, 0]]], 'type': 'Polygon'}, 'properties': {'foo': 'bar'}, 'type': 'Feature'}

>>> type(output)
<class 'dict'>
```

## On the Console

```sh
# Enforce ring winding order on a GeoJSON file
$ rewind in.geojson > out.geojson

# fetch GeoJSON from the web and enforce ring winding order
$ curl "https://myserver.com/in.geojson" | rewind
```

## Versioning

geojson-rewind follows [semantic versioning](https://semver.org/). For this project, the "API" also includes:

- CLI flags and options
- CLI exit codes

In line with common practice in the python community, geojson-rewind will drop compatibility with unsupported python versions without incrementing the major version.

## Acknowledgements

`geojson-rewind` is a python port of Mapbox's javascript [geojson-rewind](https://github.com/mapbox/geojson-rewind) package. Credit to [Tom MacWright](https://github.com/tmcw) and [contributors](https://github.com/mapbox/geojson-rewind/graphs/contributors).