/PyGeoShape

3D extension built off of shapely to make working with geospatial/trajectory data easier in python.

Primary LanguagePythonBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

downloads license pypi

PyGeoShape v0.0.4

3D extension to shapely and pyproj to make working with geospatial/trajectory data easier in python. If you found PyGeoShape helpful, please consider adding a star to this repository. Thanks!

Getting Started

Installation

pip

The easiest way to install PyGeoShape is by using pip:

pip install pygeoshape

source

To install the package from source, first clone the repository to a location of your choosing:

git clone https://github.com/marcbrittain/PyGeoShape.git

Then navigate to the directory:

cd PyGeoShape

Then install using pip (note: requires python 3.6+):

pip install -e .

Examples

The core focus of this repository is to make working with 3D geospatial/geographical data easier in python. Therefore, the core element of this repository is the GeoLineString (to start).

  1. GeoLineStrings

Roadmap

This project is very early on and is something that I am working on in my free time. Getting some of the initial functionality of GeoLineStrings like intersections and coordinate transformations was a first step, but there is a long way to go. Here I list some of the next major items that need to be addressed.

  • GeoLineStrings

    1. Heterogeneous intersection types (LineString, Point, etc.)
    2. Add function for distance calculation
    3. Add function for GeoLineString splits
    4. Optimize intersection function for efficiency

  • GeoPoint

    1. Port GeoLineString functionality to GeoPoint

  • Add additional Geo Types

    1. GeoMultiLineString
    2. GeoMultiPoint

Contributing

Contributions are always welcome. Please follow standard PEP-8 code format for contributions.