ENVISAT Product Reader Python API

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/>.