An open-source python library for SAR data processing
Despite the growing usage of SAR data, the processing workflow remains complex and still relies on specialized heavy desktop tools creating huge barriers for students and non-experts. There is a growing need for a modular, open-source and user-friendly workflow that can take Level-1 SAR products and guide users through essential steps ideally ending in products that are usable and compatible with geospatial pipelines.
The project uses the esa-snappy library, a wrapper around the SNAP Java engine, which is the same core engine used by the SNAP Desktop application. Pysarflow package provides functionality similar to what is available in SNAP Desktop, but offers a Python-based interface to access and use them.
pysarflow/
├── __init__.py
├── grd.py
├── slc.py
├── utils.py
To use this package, the esa-snappy library (the Python wrapper for ESA SNAP) is required before installation of the pysarflow package.
The follwoing are the steps to install exsa-snappy :
1. Create and activate a conda environment
conda create -n snap_env python=3.9
conda activate snap_env 2. Install Package
pip install pysarflow 3. Install ESA SNAP Desktop
Download and install ESA SNAP from the SNAP website.
During installation, enable the option to configure Python for SNAP and specify your Python executable path:
- Use the Python from your conda environment, e.g. C:\Users\YourUsername.conda\envs\snap_env\python.exe
- If that does not work, try the base environment Python: for example (C:\ProgramData\Anaconda3\python.exe)
4. Run the snappy-conf script to configure SNAP
If you use the base environemnt python or you already have SNAP installed then,
Open a command prompt, navigate to SNAP’s bin folder, and run:
cd "C:\Program Files\esa-snap\bin"
snappy-conf "C:\Users\YourUsername\.conda\envs\snap_env\python.exe"You should see: Configuration finished successfully!
4. Verify esa-snappy works
Activate your environment and open Python:
conda activate snap_env
pythonin the Python environment, try importing:
import esa_snappy
from esa_snappy import ProductIO If no errors occur, your setup is complete!
For detailed documentation and examples, see the documentation website.
Check out the 'examples' directory for more examples:
Contributions are welcome! Follow dev setup guide & Please feel free to submit a Pull Request.
- This library is built as a part of python software development course at Paris Lodron University Salzburg
- Built on top of powerful open-source libraries like numpy, rasterio
This project is licensed under the MIT License – see the LICENSE file for details.