planetlabs / feature_finder

Find scenes that overlap OSM features by feature category (e.g. airports)

feature_finder

Feature Finder is a Python library for finding Planet Labs scenes that overlap OpenStreeMap feature categories. While support is limited to airports at this time, support will be added for additional feature categories over time.

OSM features are obtained by using the OSM overpass API and Planet Labs scenes are obtained using Planet Lab's Scenes REST API.

The Planet Labs scenes api key should be stored as text in the file '.key,' stored in the root directory. This file is ignored by git.

Dependencies

This library uses Python 2.7 and depends on the following Python libraries:

• geojson
• requests
• nose (testing)
• mock (testing)

Development Setup

Vagrant

To support a repeatable and standard development environment, this library includes a Vagrant virtual machine. This virtual machine installs all of the repository depencencies on startup.

To use this virtual machine, first ensure a virtualization provider, such as VirtualBox is installed. Next, follow these steps:

# Run this in the repository root directory, where 'Vagrantfile' resides
vagrant up
vagrant ssh

# The VM shares the repository directory with the host computer
# Within the VM, the repository files are in /vagrant
cd /vagrant

Tests

To run the tests:

nosetests