samskillman / descarteslabs-python

Descartes Labs Python Client Library

Descarteslabs

Services

This package includes service wrappers for Descartes Labs application services that do require additional dependencies (included in requirements.txt) and are thus not implicitly included in the root package (see above). Service wrappers include, primarily, Metadata (image metadata) and Places (named shapes and statistics). These services are authenticated and in order to setup authentication there is a convenience script to help you log in.

$ python setup.py install
$ pip install -r requirements.txt
$ descarteslabs auth login

For non-interactive environments, one needs to set the CLIENT_ID and CLIENT_SECRET environment variables. These can be retrieved from the ~/.descarteslabs/token_info.json created from the login process or generated fresh through through IAM.

$ export CLIENT_ID=...
$ export CLIENT_SECRET=...

Documentation

The latest build of the documentation can be found on readthedocs

Changelog

Unreleased

0.4.3 - 2017-07-18

Added

• Support for derived bands endpoints.
• Direct access to const_id to product translation.

Fixes

• descarteslabs scripts on windows OS.

0.4.2 - 2017-07-05

Fixes

• Fix auth login

0.4.1 - 2017-07-05

Added

• Add metadata.bands and metadata.products search/get capabilities.
• Add bands/products descriptions
• Additional Placetypes

Fixes

• Better error messages with timeouts
• Update to latest version of requests

0.4.0 - 2017-06-22

Changes

• Major refactor of metadata.search
  • Introduction of "Products" through dl.metadata.products()
  • metadata entries id now concatenate the product id and the old metadata keys. The original metadata keys are available through entry['key'].
  • Additional sorting available.

Added

• Search & Raster using DLTile Feature GeoJSON or key. Uses output bounds, resolution, and srs to ease searching and rasterizing imagery over tiles.

Fixes

• Better Error messaging

0.3.3 - 2017-06-20

Added

• DLTile notebook
• save and outfile_basename in raster()

Fixes

• Fix metadata.features

0.3.2 - 2017-05-27

Fixes

• Strict "requests" versions needed due to upstream instability.

0.3.1 - 2017-05-17

Fixes

• Fix python 3 command line compatibility

0.3.0 - 2017-05-15

Changed

• API Change descarteslabs, raster, metadata have all been merged into 'descarteslabs'. 'descarteslabs login' is now 'descarteslabs auth login', 'raster'' is now 'descarteslabs raster', etc.

Added

• A Changelog
• Testing around command-line scripts

Fixes

• Searching with cloud_fraction = 0
• dltile API documentation

0.2.2 - 2017-05-04

Fixes

• Fix login bug
• Installation of "requests[security]" for python < 2.7.9

0.2.1 - 2017-04-18

Added

• Doctests

Fixes

• Python 3 login bug

0.2.0 - 2017-04-11

Added

• Search by Fractions

0.1.0 - 2017-03-24

Added

• Initial release of client library

FAQ

If you are on older versions of Python 2.7, you may encounter warnings about SSL such as:

InsecurePlatformWarning: A true SSLContext object is not available. This prevents urllib3 from configuring SSL appropriately and may cause certain SSL connections to fail. For more information, see https://urllib3.readthedocs.org/en/latest
/security.html#insecureplatformwarning.

Please follow the instructions from stackoverflow and install the "requests[security]" package with, e.g. pip install "requests[security]".