spatial_access: Compute travel times and spatial access metrics at scale

Compute travel times and spatial access measures at scale (millions of origin-destination pairs in minutes). Travel times for three modes: walking, biking, driving. Spatial access measures: provider-to-people ratio, avg. time to nearest provider, count/attribute sum of nearby providers, weighted access scores and floating catchment areas.

Latest Release
Build Status
Documentation
Tested Operating Systems	Ubuntu, macOS

Components of spatial_access :

spatial_access has two submodules:

p2p: Generate many to many matrices with travel times for sets of coordinates. Use walk ,bike or drive network types (import transit from other sources), or get the distance in meters.
Models: Contains a suite of models for calculating spatial accessibility to amenities.

To use this service as a ReST API, see: https://github.com/GeoDaCenter/spatial_access_api

If you are a Windows user, instructions for installing Ubuntu on a virtual machine are at the bottom of the Readme.

Installation

A modern compiler like gcc or clang.
Dependencies
- MacOS:
  
  brew install spatialindex
- Ubuntu:
  
  sudo apt-get install libspatialindex-dev
  
  sudo apt-get install python-tk
Package

pip3 install spatial_access

Usage

See the iPython notebooks in docs/ for example usage, or https://readthedocs.org/projects/spatial-acccess/ for technical documentation.

Instructions for building locally (only for developers):

If updating Cython or C++ code (anything in spatial_access/src/) you must install cython
To regenerate .pyx files, run: bash cythonize_extension.sh (TravisCI will do this automatically on deployment)
To install locally, run: sudo python3 setup.py install
Unit tests require the pytest package. From package root directory, run python3 -m pytest tests/ to run all unit tests.

PyPi Maintenance

The package lives at: https://pypi.org/project/spatial-access/

When a branch is pulled into Master and builds/passes all unit tests, Travis CI will automatically deploy the build to PyPi.

To update PyPi access credentials, see .travis.yml and follow the instructions at https://docs.travis-ci.com/user/deployment/pypi/ to generate a new encrypted password.

Overwriting default configuration values

p2p provides default configuration values for edge weights and node impedence (see spatial_access/configs.py). You can overwrite these as follows:

from spatial_access.p2p import TransitMatrix
from spatial_access.Configs import Configs
custom_config = Configs()
# set fields of custom_cofig
tm = TransitMatrix(..., configs=custom_config)
# continue with computation

Installing Ubuntu 18 LTS with dependencies from scratch (recommended for Windows users)

Follow the instructions at this link: https://linus.nci.nih.gov/bdge/installUbuntu.html to set up a virtual machine
sudo apt-get update
sudo add-apt-repository universe
sudo apt-get -y install python3-pip
Continue with Installation Instructions (above)

Questions/Feedback?

lnoel@uchicago.edu or spatial@uchicago.edu

Acknowledgments

Developed by Logan Noel at the University of Chicago's Center for Spatial Data Science (CSDS) with support from the Public Health National Center for Innovations (PHNCI), the University of Chicago, and CSDS.

Metadata

Release files for spatial-access 0.1.10

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for spatial-access 0.1.10
File	Size	Uploaded
spatial_access-0.1.10.tar.gz	115.6 kB	Apr 27, 2019	Details

Built distribution (wheel)

Table of built distributions (wheels) for spatial-access 0.1.10
File	Interpreter	ABI	Platform	Reset
spatial_access-0.1.10-py3.6-linux-x86_64.egg 311.3 kB Apr 30, 2019	Legacy Egg format	-	-	Details

Total release size: 426.9 kB

Release files / spatial_access-0.1.10.tar.gz

Download URL	spatial_access-0.1.10.tar.gz
Size	115.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`9dae815f702775adbd3a6690017f0c72e374018c6515b99450ac29fac138b7de`
BLAKE2b-256 checksum How to use checksums	`156e5f8267430cdd812c8f075702e8ff4d21d666c60cf1ec3204429c6b401fa8`
Upload date	Apr 27, 2019
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.6.7`

Release files / spatial_access-0.1.10-py3.6-linux-x86_64.egg

Download URL	spatial_access-0.1.10-py3.6-linux-x86_64.egg
Size	311.3 kB
Tags	Egg
SHA-256 checksum How to use checksums	`146690a1b0999ef3a164e2a1ae80f3b8f668cf43b63ab15d0b1ad0e5fb250204`
BLAKE2b-256 checksum How to use checksums	`f5506350b9ec03eb502d6e4f77b40cfdc0adf1e3a914c90e1d8b9b362523a8e1`
Upload date	Apr 30, 2019
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.6.7`