ENVISAT Product Reader Python API

HomePage

https://pyepr.readthedocs.io

Author

Antonio Valentino

Contact

antonio.valentino@tiscali.it

Copyright

2011-2023, Antonio Valentino <antonio.valentino@tiscali.it>

Version

1.1.5

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.

Links

• HTML documentation (stable, latest)
• PyEPR project page on github
• source browser
• commit history
• issue tracker
• CI status page
• PyEPR project page on PyPi
• EPR-API project page
• EPR-API documentation

Dependencies

In order to use PyEPR it is needed that the following software are correctly installed and configured:

• Python3 >= 3.5 (including PyPy3)
• numpy >= 1.7.0
• EPR API >= 2.2 (optional, since PyEPR 0.7 the source tar-ball comes with a copy of the EPR C API sources)
• a reasonably updated C compiler (build only)
• Cython >= 0.29 (build only)
• pytest (optional and only needed for testing)

Download

Official source tar-balls can be downloaded form PyPi:

https://pypi.org/project/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

To get also the EPR C API source code, the following commands are necessary:

$ cd pyepr
$ git submodule init
Submodule 'extern/epr-api' (https://github.com/avalentino/epr-api.git) registered for path 'extern/epr-api'
$ git submodule update
Cloning into '/Users/antonio valentino/projects/av/pyepr/extern/epr-api'...
Submodule path 'extern/epr-api': checked out '93c1f1efce26c64d508fe882d5c72a898a068f29'

Installation

The easier way to install PyEPR is using tools like pip:

$ python3 -m pip install pyepr

or:

$ python3 -m pip install -U --prefix=<TARGET DIRECTORY>

PyEPR can be installed from the source tar-ball using the following command:

$ python3 setup.py install

To install PyEPR in a non-standard path:

$ python3 setup.py install --prefix=<TARGET_PATH>

License

Copyright (C) 2011-2023 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/>.