Metadata-Version: 2.0
Name: datacube
Version: 1.3.2
Summary: An analysis environment for satellite and other earth observation data
Home-page: https://github.com/opendatacube/datacube-core
Author: AGDC Collaboration
Author-email: UNKNOWN
License: Apache License 2.0
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: English
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX
Classifier: Operating System :: POSIX :: BSD
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Requires-Dist: affine
Requires-Dist: cachetools
Requires-Dist: click (>=5.0)
Requires-Dist: dask[array]
Requires-Dist: gdal (>=1.9)
Requires-Dist: jsonschema
Requires-Dist: netcdf4
Requires-Dist: numpy
Requires-Dist: pathlib
Requires-Dist: psycopg2
Requires-Dist: pypeg2
Requires-Dist: python-dateutil
Requires-Dist: pyyaml
Requires-Dist: rasterio (>=0.34)
Requires-Dist: singledispatch
Requires-Dist: sqlalchemy
Requires-Dist: xarray
Provides-Extra: all
Requires-Dist: Sphinx; extra == 'all'
Requires-Dist: bottleneck; extra == 'all'
Requires-Dist: ciso8601; extra == 'all'
Requires-Dist: compliance-checker; extra == 'all'
Requires-Dist: dask[distributed]; extra == 'all'
Requires-Dist: distributed; extra == 'all'
Requires-Dist: fiona; extra == 'all'
Requires-Dist: hypothesis; extra == 'all'
Requires-Dist: matplotlib; extra == 'all'
Requires-Dist: mock; extra == 'all'
Requires-Dist: numexpr; extra == 'all'
Requires-Dist: pep8; extra == 'all'
Requires-Dist: pylint (==1.6.4); extra == 'all'
Requires-Dist: pyparsing; extra == 'all'
Requires-Dist: pytest; extra == 'all'
Requires-Dist: pytest-cov; extra == 'all'
Requires-Dist: scipy; extra == 'all'
Requires-Dist: setuptools; extra == 'all'
Provides-Extra: analytics
Requires-Dist: numexpr; extra == 'analytics'
Requires-Dist: pyparsing; extra == 'analytics'
Requires-Dist: scipy; extra == 'analytics'
Provides-Extra: distributed
Requires-Dist: dask[distributed]; extra == 'distributed'
Requires-Dist: distributed; extra == 'distributed'
Provides-Extra: doc
Requires-Dist: Sphinx; extra == 'doc'
Requires-Dist: setuptools; extra == 'doc'
Provides-Extra: interactive
Requires-Dist: fiona; extra == 'interactive'
Requires-Dist: matplotlib; extra == 'interactive'
Provides-Extra: performance
Requires-Dist: bottleneck; extra == 'performance'
Requires-Dist: ciso8601; extra == 'performance'
Provides-Extra: test
Requires-Dist: compliance-checker; extra == 'test'
Requires-Dist: hypothesis; extra == 'test'
Requires-Dist: mock; extra == 'test'
Requires-Dist: pep8; extra == 'test'
Requires-Dist: pylint (==1.6.4); extra == 'test'
Requires-Dist: pytest; extra == 'test'
Requires-Dist: pytest-cov; extra == 'test'

Open Data Cube Core
==================================

|Build Status| |Coverage Status| |Documentation Status|

Overview
========

Open Data Cube Core provides an integrated gridded data
analysis environment for decades of analysis ready earth observation
satellite and related data from multiple satellite and other acquisition
systems.

Documentation
=============

See the `user guide <http://datacube-core.readthedocs.io/en/latest/>`__ for
installation & usage of the datacube, and for documentation of the API.

`Join our Slack <https://opendatacube.signup.team/>`__ if you need help
setting up or using Data Cube Core.

Requirements
============

System
~~~~~~

-  PostgreSQL 9.5+
-  Python 2.7+ or Python 3.5+

Developer setup
===============

1. Clone:

   -  ``git clone https://github.com/opendatacube/datacube-core.git``

2. Install the native libraries for `GDAL <http://www.gdal.org/>`__ &
   NetCDF4.

   -  This depends on your OS.
   -  Eg. ``yum install gdal``

3. Install Python dependencies:

   ``python setup.py develop``

   Note that the versions must match between GDAL's Python bindings and
   the native GDAL library. If you receive a gdal error when installing
   dependencies, you may need to install a specific version first:

   eg. ``pip install gdal==2.0.1``

4. Run unit tests + PyLint

   ``./check-code.sh``

   (this script approximates what is run by Travis. You can
   alternatively run ``py.test`` yourself)

5. **(or)** Run all tests, including integration tests.

``./check-code.sh integration_tests``

-  Assumes a password-less Postgres database running on localhost called
   ``agdcintegration``

   -  Otherwise copy ``integration_tests/agdcintegration.conf`` to
      ``~/.datacube_integration.conf`` and edit to customise.

.. |Build Status| image:: https://travis-ci.org/opendatacube/datacube-core.svg?branch=develop
   :target: https://travis-ci.org/opendatacube/datacube-core
.. |Coverage Status| image:: https://coveralls.io/repos/opendatacube/datacube-core/badge.svg?branch=develop&service=github
   :target: https://coveralls.io/github/opendatacube/datacube-core?branch=develop
.. |Documentation Status| image:: https://readthedocs.org/projects/datacube-core/badge/?version=latest
   :target: http://datacube-core.readthedocs.org/en/latest/


