Metadata-Version: 2.1
Name: geonetworkx
Version: 0.5
Summary: Python tools for geographic graphs
Home-page: UNKNOWN
Author: Hugo Chareyre - Artelys
Author-email: hugo.chareyre@artelys.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
Requires-Dist: pyproj (<2.4)
Requires-Dist: geopy (>=1.12.0)
Requires-Dist: geopandas (>=0.5)
Requires-Dist: networkx (>=2.3)
Requires-Dist: numpy (>=1.12.0)
Requires-Dist: pandas (>=0.25.0)
Requires-Dist: shapely (>=1.2.18)
Requires-Dist: scipy (>=0.19.0rc2)
Requires-Dist: nose (>=1.3.7)

# GeoNetworkX

Python tools for geographic graphs

[![CircleCI](https://circleci.com/gh/Artelys/geonetworkx.svg?style=svg)](https://circleci.com/gh/Artelys/geonetworkx)
[![Documentation Status](https://readthedocs.org/projects/geonetworkx/badge/?version=latest)](https://geonetworkx.readthedocs.io/en/latest/?badge=latest)
[![PyPI Package latest release](https://img.shields.io/pypi/v/geonetworkx.svg)](https://pypi.python.org/pypi/geonetworkx)

## Introduction

GeoNetworkX is a project to add support for geographic graphs to NetworkX (in the same way that GeoPandas support
geographic data to Pandas). It currently implements four data structures that extends the networkx graph classes (Graph,
MultiGraph, DiGraph, MultiDiGraph).


## Install

**Requirements**

* Fiona==1.8.6
* geopy==1.2.0
* geopandas==0.4.0
* networkx==2.3
* numpy>=1.15.4
* pyproj==1.9.6
* rtree==0.8.3
* scipy>=1.0.1
* shapely>=1.2.18

Optional packages:

* srtm (for elevation data)
* pyvoronoi (for voronoi utils)
* osmnx (for OSM data)

**Installation**

```shell
    pip install geonetworkx
```

### Trouble when installing GeoNetworkX on Windows

If you are using `conda` on Windows, the binaries downloaded automatically
are broken, and `rtree` is
[unable to work properly](https://gis.stackexchange.com/questions/179706/installing-rtree-on-windows-64-bits).

A workaround is to download manually the binary from [this webpage](https://www.lfd.uci.edu/~gohlke/pythonlibs/#rtree).
Please download the binary corresponding to your system and your
Python version (3.6 or 3.7). You have notably to download:

- Binary for `Rtree`
- Binary for `Fiona`
- Binary for `PyProj 1.9.6` (mandatory version!)


## Documentation

Online documentation is available here: <https://geonetworkx.readthedocs.io>

## Tests

Tests can be launched with `unittest` with the following command:
```
python -m unittest discover -v geonetworkx
```
Or with `nose` like this:
```
nosetests geonetworkx -v --with-doctest
```



