SourceRank

Documentation

=================================
ENVISAT Product Reader Python API
=================================
:HomePage: http://avalentino.github.io/pyepr
:Author: Antonio Valentino
:Contact: antonio.valentino@tiscali.it
:Copyright: 2011-2015, Antonio Valentino <antonio.valentino@tiscali.it>
:Version: 0.9.3
Introduction
============
PyEPR_ provides Python_ bindings for the ENVISAT Product Reader C API
(`EPR API`_) for reading satellite data from ENVISAT_ ESA_ (European
Space Agency) mission.
PyEPR_, as well as the `EPR API`_ for C, supports ENVISAT_ MERIS, AATSR
Level 1B and Level 2 and also ASAR data products. It provides access to
the data either on a geophysical (decoded, ready-to-use pixel samples)
or on a raw data layer. The raw data access makes it possible to read
any data field contained in a product file.
.. _PyEPR: https://github.com/avalentino/pyepr
.. _Python: https://www.python.org
.. _`EPR API`: https://github.com/bcdev/epr-api
.. _ENVISAT: https://envisat.esa.int
.. _ESA: https://earth.esa.int
Requirements
============
In order to use PyEPR it is needed that the following software are
correctly installed and configured:
* Python2_ >= 2.6 or Python3_ >= 3.1
* numpy_ >= 1.5.0
* `EPR API`_ >= 2.2 (optional, since PyEPR 0.7 the source tar-ball comes
with a copy of the PER C API sources)
* a reasonably updated C compiler (build only)
* Cython_ >= 0.15 (build only)
* unittest2_ (only required for Python < 2.7)
.. _Python2: Python_
.. _Python3: Python_
.. _numpy: http://www.numpy.org
.. _gcc: http://gcc.gnu.org
.. _Cython: http://cython.org
.. _unittest2: https://pypi.python.org/pypi/unittest2
Download
========
Official source tarballs can be downloaded form PyPi_:
https://pypi.python.org/pypi/pyepr
The source code of the development versions is available on the GitHub_
project page
https://github.com/avalentino/pyepr
To clone the git_ repository the following command can be used::
$ git clone https://github.com/avalentino/pyepr.git
.. _PyPi: https://pypi.python.org/pypi
.. _GitHub: https://github.com
.. _git: http://git-scm.com
Installation
============
The easier way to install PyEPR_ is using tools like pip_ or easy_install_::
$ pip install pyepr
or::
$ pip install -U --prefix=<TARGET DIRECTORY>
PyEPR_ can be installed from the source tar.ball using the following
command::
$ python setup.py install
To install PyEPR_ in a non-standard path::
$ python setup.py install --prefix=<TARGET_PATH>
.. _pip: https://pypi.python.org/pypi/pip
.. _easy_install: https://pypi.python.org/pypi/setuptools#using-setuptools-and-easyinstall
License
=======
Copyright (C) 2011-2015 Antonio Valentino <antonio.valentino@tiscali.it>
PyEPR is free software: you can redistribute it and/or modify
it under the terms of the `GNU General Public License`_ as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
PyEPR is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with PyEPR. If not, see <http://www.gnu.org/licenses/>.
.. _`GNU General Public License`: http://www.gnu.org/licenses/gpl-3.0.html