Aresys Formats Input/Output (aresys_io)

Aresys I/O (aresys_io) is the official Aresys Python library for reading, writing, and manipulating Aresys Earth Observation (EO) and Synthetic Aperture Radar (SAR) product formats.

Designed to be modular, independent, and extensible, aresys_io provides unified data access and metadata management across the entire SAR processing and simulation pipeline. It is built to integrate with PERSEO (docs), the Aresys modular framework for Earth Observation and SAR data handling.

Supported Formats & Core Features

aresys_io provides complete support for the core internal Aresys formats:

• Product Folder (PF): The official Aresys SAR product format for organizing and storing data and auxiliary information. Supports Level 0 (RAW), Level 1 (SLC / GRD), and Interferometric products across multi-swath and multi-polarization channels with dedicated XML annotations, binary/TIFF raster data, manifests, and preview overlays.
• Point Target Binary: Dedicated format for discrete radar reflectors (such as corner reflectors, active radar calibrators, or synthetic point scatterers) used in SAR simulation, calibration, and IRF analysis. Stores 3D Cartesian coordinates ($X, Y, Z$) and full polarimetric radar cross sections ($HH, HV, VH, VV$) with support for memory-mapped zero-copy access and high-level NominalPointTarget representations.
• SAR System: Serialization and handling of SAR system and simulation parameters, including trajectory state vectors, timeline tables, swath parameter tables, and satellite definitions.
• Metadata & Raster Engine: Robust XML serialization/deserialization for Aresys metadata schemas, orbit and attitude modeling, polynomial conversions, and flexible 2D raster I/O.

Installation

This package is available on PyPI and can be installed with pip:

pip install aresys-io

Documentation

• Aresys I/O documentation: https://opensource.aresys.it/aresys_io
• PERSEO documentation: https://opensource.aresys.it/perseo

Related Repositories

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. Include a clear description, steps to reproduce, and environment details.
• Submit changes: fork the repository, create a feature branch, and open a pull request. Ensure your code passes all linting (ruff), typing (pyrefly), and test suites (pytest).
• Questions: use GitHub Discussions for general questions and discussions.

License

This project is licensed under the MIT License.

Copyright © 2026-present Aresys S.r.l. info@aresys.it