eo-products 1.0.0__tar.gz

eo_products-1.0.0/.gitignore

@@ -0,0 +1,196 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm-project.org/#use-with-ide
+.pdm.toml
+.pdm-python
+.pdm-build/
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Distribution / packaging
+build/
+_build/
+dist/
+*.egg-info/
+.ipynb_checkpoints/
+.nox
+
+# Pyenv
+.python-version
+
+# VS Code project settings
+.vscode
+
+# PyCharm project settings
+.idea
+
+# Spyder project settings
+.spyproject
+
+# Environments
+venv*
+
+# Docker
+docker-compose.yml
+Dockerfile
+.devcontainer
+
+# Other
+*.bak
+.coverage
+htmlcov
+*.svg

eo_products-1.0.0/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (C) Aresys S.r.l. <info@aresys.it>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

eo_products-1.0.0/PKG-INFO

@@ -0,0 +1,131 @@
+Metadata-Version: 2.4
+Name: eo_products
+Version: 1.0.0
+Summary: Collection of SAR Earth Observation L1 Product Formats readers.
+Project-URL: Homepage, https://github.com/aresys-srl/eo_products
+Project-URL: Repository, https://github.com/aresys-srl/eo_products
+Project-URL: Documentation, https://aresys-srl.github.io/eo_products
+Author-email: "Aresys S.R.L." <info@aresys.it>
+License: MIT License
+        
+        Copyright (C) Aresys S.r.l. <info@aresys.it>
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE.txt
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: h5py
+Requires-Dist: imagecodecs
+Requires-Dist: lxml
+Requires-Dist: numpy>2
+Requires-Dist: perseo-core>=1.0.0
+Requires-Dist: sarpy
+Requires-Dist: tifffile
+Requires-Dist: zarr
+Provides-Extra: dev
+Requires-Dist: nox; extra == 'dev'
+Requires-Dist: pylint; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: mkdocstrings-python; extra == 'docs'
+Requires-Dist: zensical; extra == 'docs'
+Provides-Extra: test
+Requires-Dist: coverage; extra == 'test'
+Requires-Dist: unittest-xml-reporting; extra == 'test'
+Description-Content-Type: text/markdown
+
+# EO Products
+
+![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue)](https://python.org)
+[![PyPI version](https://img.shields.io/pypi/v/eo-products)](https://pypi.org/project/eo-products/)
+
+**EO Products** is a Python package designed to simplify access to **Level-1 Synthetic Aperture Radar** (SAR) Earth Observation products and SAR auxiliary data.
+It provides a unified collection of readers tailored to a variety of SAR product formats, enabling users to efficiently
+extract and work with both metadata and raster data.
+
+The readers included in this package are built to handle the most commonly used metadata fields and ensure full access to
+the associated raster data, making them suitable for a wide range of scientific and operational applications.
+
+EO Products is intended for developers, researchers, and practitioners who need a practical and consistent interface for
+ingesting SAR data into analysis workflows, without requiring deep familiarity with the complexities of individual
+product formats.
+
+> While the implementation aims to cover the majority of relevant product information, it does not guarantee complete
+> representation of every metadata element available in the original product specifications.
+
+## Supported Formats
+
+EO Products currently supports the following SAR products:
+
+| Format | Modes |
+|--------|-------|
+| **Sentinel-1 SAFE** | SLC and GRD [topsar, stripmap, wave, notch] |
+| **NovaSAR-1** | SLC, GRD, SCD and SRD |
+| **ICEYE** | SLC and GRD [topsar, stripmap, spotlight] |
+| **SAOCOM** | SLC and GRD [topsar, stripmap] |
+| **EOS-04** | SLC and GRD |
+| **COSMO SkyMed** | SLC and GRD |
+| **RADARSAT-2** | SLC and GRD [scansar, stripmap] |
+| **TerraSAR-X** | SLC and GRD [scansar (GRD only), stripmap] |
+| **STRIX (Synspective)** | SLC [stripmap, spotlight] |
+
+## Installation
+
+This project requires Python **3.11 or higher**.
+
+This package can be installed using ``pip``:
+
+```bash
+pip install eo-products
+```
+
+## Documentation
+
+Full documentation is available at [https://aresys-srl.github.io/eo_products](https://aresys-srl.github.io/eo_products).
+
+## Contributing
+
+Contributions are welcome! If you encounter a bug, have a feature request, or want to contribute code:
+
+- **Report bugs & request features**: open an issue on [GitHub](https://github.com/aresys-srl/eo_products/issues). Include a clear description, steps to reproduce, and your environment details.
+- **Submit changes**: fork the repository, create a feature branch, and open a pull request. Ensure your code passes the existing linting and test suite.
+- **Questions**: use GitHub Discussions for general questions and discussions.
+
+## License
+
+This project is licensed under the MIT License.
+
+Copyright &copy; 2026-present Aresys S.r.L. <info@aresys.it>

eo_products-1.0.0/README.md

@@ -0,0 +1,63 @@
+# EO Products
+
+![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue)](https://python.org)
+[![PyPI version](https://img.shields.io/pypi/v/eo-products)](https://pypi.org/project/eo-products/)
+
+**EO Products** is a Python package designed to simplify access to **Level-1 Synthetic Aperture Radar** (SAR) Earth Observation products and SAR auxiliary data.
+It provides a unified collection of readers tailored to a variety of SAR product formats, enabling users to efficiently
+extract and work with both metadata and raster data.
+
+The readers included in this package are built to handle the most commonly used metadata fields and ensure full access to
+the associated raster data, making them suitable for a wide range of scientific and operational applications.
+
+EO Products is intended for developers, researchers, and practitioners who need a practical and consistent interface for
+ingesting SAR data into analysis workflows, without requiring deep familiarity with the complexities of individual
+product formats.
+
+> While the implementation aims to cover the majority of relevant product information, it does not guarantee complete
+> representation of every metadata element available in the original product specifications.
+
+## Supported Formats
+
+EO Products currently supports the following SAR products:
+
+| Format | Modes |
+|--------|-------|
+| **Sentinel-1 SAFE** | SLC and GRD [topsar, stripmap, wave, notch] |
+| **NovaSAR-1** | SLC, GRD, SCD and SRD |
+| **ICEYE** | SLC and GRD [topsar, stripmap, spotlight] |
+| **SAOCOM** | SLC and GRD [topsar, stripmap] |
+| **EOS-04** | SLC and GRD |
+| **COSMO SkyMed** | SLC and GRD |
+| **RADARSAT-2** | SLC and GRD [scansar, stripmap] |
+| **TerraSAR-X** | SLC and GRD [scansar (GRD only), stripmap] |
+| **STRIX (Synspective)** | SLC [stripmap, spotlight] |
+
+## Installation
+
+This project requires Python **3.11 or higher**.
+
+This package can be installed using ``pip``:
+
+```bash
+pip install eo-products
+```
+
+## Documentation
+
+Full documentation is available at [https://aresys-srl.github.io/eo_products](https://aresys-srl.github.io/eo_products).
+
+## Contributing
+
+Contributions are welcome! If you encounter a bug, have a feature request, or want to contribute code:
+
+- **Report bugs & request features**: open an issue on [GitHub](https://github.com/aresys-srl/eo_products/issues). Include a clear description, steps to reproduce, and your environment details.
+- **Submit changes**: fork the repository, create a feature branch, and open a pull request. Ensure your code passes the existing linting and test suite.
+- **Questions**: use GitHub Discussions for general questions and discussions.
+
+## License
+
+This project is licensed under the MIT License.
+
+Copyright &copy; 2026-present Aresys S.r.L. <info@aresys.it>

eo_products-1.0.0/docs/about/build.template.md

@@ -0,0 +1,13 @@
+---
+icon: lucide/badge-info
+---
+
+# Build
+
+Documentation build info and versioning information.
+
+Version: ==__TAG__==
+
+Commit: ==__SHA__==
+
+Build date: ==__DATE__==

eo_products-1.0.0/docs/index.md

@@ -0,0 +1,44 @@
+---
+icon: lucide/sparkles
+title: Overview
+tags:
+    - SAR
+    - SCT
+---
+
+# SAR L1 Products Readers
+
+``EO Products`` is a Python package designed to simplify access to **Level-1 Synthetic Aperture Radar** (SAR) Earth Observation products.
+It provides a unified collection of readers tailored to a variety of SAR product formats, enabling users to efficiently
+extract and work with both metadata and raster data.
+
+The readers included in this package are built to handle the most commonly used metadata fields and ensure full access to
+the associated raster data, making them suitable for a wide range of scientific and operational applications.
+
+!!! warning "Reader Completeness"
+
+    While the implementation aims to cover the majority of relevant product information, it does not guarantee complete
+    representation of every metadata element available in the original product specifications.
+
+EO Products is intended for developers, researchers, and practitioners who need a practical and consistent interface for
+ingesting SAR data into analysis workflows, without requiring deep familiarity with the complexities of individual
+product formats.
+
+These readers are designed to be flexible and adaptable, allowing users to customize their workflows based on their specific
+requirements and the characteristics of the data they are working with.
+Most of [SCT Product Formats Plugins](http://intranet.aresys.it/sardashboard/develop/sct-plugins/docs/docs/latest/) are
+based on the readers included in this package.
+
+## Supported Formats
+
+EO Products currently supports the following SAR products:
+
+- **Sentinel-1 SAFE**: SLC and GRD products [topsar, stripmap, wave, notch]
+- **NovaSAR-1**: SLC, GRD, SCD and SRD products
+- **ICEYE**: SLC and GRD products [topsar, stripmap, spotlight]
+- **SAOCOM**: SLC and GRD products [topsar, stripmap]
+- **EOS-04**: SLC, GRD products
+- **COSMO SkyMed**: SLC, GRD products
+- **RADARSAT-2**: SLC, GRD products [scansar, stripmap]
+- **TerraSAR-X**: SLC and GRD products [scansar (GRD only), stripmap]
+- **STRIX (Synspective)**: SLC products [stripmap, spotlight]

eo_products-1.0.0/docs/install.md

@@ -0,0 +1,26 @@
+---
+icon: lucide/arrow-big-down-dash
+title: "Install"
+tags:
+    - python
+    - pip
+    - install
+---
+
+# Installation
+
+!!! note "Requirements"
+
+    This project requires a Python version **equal or higher than 3.11**.
+
+This package can easily be installed using ``pip``:
+
+```bash title="install with pip"
+pip install eo-products
+```
+
+!!! tip "Virtual Environments"
+
+    We recommend using a dedicated virtual environment to install these packages.  
+    This will ensure that the software is installed in a separate environment and avoids conflicts with other packages
+    or dependencies.

eo_products-1.0.0/docs/readers/API/cosmo.md

@@ -0,0 +1,16 @@
+---
+icon: fontawesome/brands/python
+title: "COSMO SkyMed"
+tags:
+    - cosmo-skymed
+    - API
+    - python
+---
+
+## Reader Interface
+
+::: eo_products.cosmo.reader
+
+## Utilities
+
+::: eo_products.cosmo.utilities

eo_products-1.0.0/docs/readers/API/eos-04.md

@@ -0,0 +1,16 @@
+---
+icon: fontawesome/brands/python
+title: "EOS-04"
+tags:
+    - eos-04
+    - API
+    - python
+---
+
+## Reader Interface
+
+::: eo_products.eos04.reader
+
+## Utilities
+
+::: eo_products.eos04.utilities

eo_products-1.0.0/docs/readers/API/iceye.md

@@ -0,0 +1,16 @@
+---
+icon: fontawesome/brands/python
+title: "ICEYE"
+tags:
+    - iceye
+    - API
+    - python
+---
+
+## Reader Interface
+
+::: eo_products.iceye.reader
+
+## Utilities
+
+::: eo_products.iceye.utilities

eo_products-1.0.0/docs/readers/API/novasar-1.md

@@ -0,0 +1,16 @@
+---
+icon: fontawesome/brands/python
+title: "NovaSAR-1"
+tags:
+    - novasar-1
+    - API
+    - python
+---
+
+## Reader Interface
+
+::: eo_products.novasar1.reader
+
+## Utilities
+
+::: eo_products.novasar1.utilities

eo_products-1.0.0/docs/readers/API/radarsat-2.md

@@ -0,0 +1,16 @@
+---
+icon: fontawesome/brands/python
+title: "RadarSAT-2"
+tags:
+    - radarsat-2
+    - API
+    - python
+---
+
+## Reader Interface
+
+::: eo_products.radarsat2.reader
+
+## Utilities
+
+::: eo_products.radarsat2.utilities

eo_products-1.0.0/docs/readers/API/saocom.md

@@ -0,0 +1,16 @@
+---
+icon: fontawesome/brands/python
+title: "SAOCOM"
+tags:
+    - saocom
+    - API
+    - python
+---
+
+## Reader Interface
+
+::: eo_products.saocom.reader
+
+## Utilities
+
+::: eo_products.saocom.utilities

eo_products-1.0.0/docs/readers/API/sentinel-1.md

@@ -0,0 +1,16 @@
+---
+icon: fontawesome/brands/python
+title: "Sentinel-1"
+tags:
+    - sentinel-1
+    - API
+    - python
+---
+
+## Reader Interface
+
+::: eo_products.sentinel1.reader
+
+## Utilities
+
+::: eo_products.sentinel1.utilities

eo_products-1.0.0/docs/readers/API/strix.md

@@ -0,0 +1,16 @@
+---
+icon: fontawesome/brands/python
+title: "STRIX"
+tags:
+    - strix
+    - API
+    - python
+---
+
+## Reader Interface
+
+::: eo_products.strix.reader
+
+## Utilities
+
+::: eo_products.strix.utilities

eo_products-1.0.0/docs/readers/API/terrasar-x.md

@@ -0,0 +1,16 @@
+---
+icon: fontawesome/brands/python
+title: "TerraSAR-X"
+tags:
+    - terrasar-x
+    - API
+    - python
+---
+
+## Reader Interface
+
+::: eo_products.terrasarx.reader
+
+## Utilities
+
+::: eo_products.terrasarx.utilities

eo_products-1.0.0/docs/readers/changelog.md

@@ -0,0 +1,13 @@
+---
+icon: lucide/history
+title: "Changelog"
+tags:
+    - changelog
+    - release notes
+---
+
+# Changelog
+
+## v1.0.0
+
+First official release.