kuva-metadata 1.1.9

Definitions of Kuva Space product metadata

Kuva Metadata

Images taken from a satellite are complicated beasts with lot of metadata associated to them. This repository contains the metadata definitions for the Hyperfield products. This metadata along with the acquired GeoTIFF images form the Kuva Space products in its various processing levels.

With the metadata and images, we may process products to the next processing levels, or do more precise processing than just with a GeoTIFF.

Installation

pip install kuva-metadata

This package is also included when installing the kuva-reader.

Requirements

Python 3.10 to 3.13, preferably within a virtual environment

Processing levels

Currently there are metadata definitions for the following processing levels of Kuva products:

• L0: Radiometrically corrected frames as TOA radiance
• L1AB: Band-aligned product formed from multiple L0 products
• L1C: Georeferences and orthorectified L1 product
• L2A: Atmospherically corrected product as BOA reflectance

Architecture

All the metadata are defined as Pydantic models, this has several advantages:

• A very rich set of validations that are applied before data object construction
• The ability to easily (de)serialize (from)to JSON

Contributing

Please follow the guidelines in CONTRIBUTING.md.

Also, please follow our Code of Conduct while discussing in the issues and pull requests.

Contact information

For questions or support, please open an issue. If you have been given a support contact, feel free to send them an email explaining your issue.

License

The kuva-reader project software is under the MIT license.

Status of unit tests