Metadata-Version: 2.4
Name: osml-imagery-toolkit
Version: 2.0.0a1
Summary: Toolkit to work with imagery collected by satellites and UAVs
Project-URL: Source, https://github.com/awslabs/osml-imagery-toolkit
Project-URL: Tracker, https://github.com/awslabs/osml-imagery-toolkit/issues
Author-email: Amazon Web Services <aws-osml-admin@amazon.com>
License-Expression: Apache-2.0
License-File: LICENSE
License-File: NOTICE
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Requires-Dist: cachetools>=5.3.2
Requires-Dist: defusedxml>=0.7.1
Requires-Dist: geojson>=3.1.0
Requires-Dist: numpy>=1.23.0
Requires-Dist: opencv-python-headless>=4.9.0
Requires-Dist: osml-imagery-io>=0.1.0
Requires-Dist: pyproj>=3.6.1
Requires-Dist: pyshp>=3.0.0
Requires-Dist: scipy>=1.13.0
Requires-Dist: shapely>=2.0.2
Requires-Dist: xsdata>=24.1
Description-Content-Type: text/markdown

The OversightML Imagery Toolkit is a Python package for image processing and photogrammetry
on satellite and UAV imagery. It provides sensor models, orthorectification, tiling, dynamic
range adjustment, and map tile generation — built on
[osml-imagery-io](https://github.com/awslabs/osml-imagery-io) for fast, dependency-light
access to NITF, GeoTIFF, JPEG 2000, and DTED formats.

This library contains six packages under the `aws.osml` namespace:

* **photogrammetry**: sensor models converting between image (x, y) and geodetic (lon, lat, elev) coordinates
* **elevation**: loading and composing digital elevation models (DTED, GeoTIFF) with multi-source priority, spatial conditions, and geoid offset correction
* **metadata**: sensor model builders reading metadata through osml-imagery-io
* **image_processing**: tiling, map tile generation, orthorectification, dynamic range adjustment, and processing chains
* **formats**: xsdata-generated Python models for SICD and SIDD XML schemas
* **features**: geospatial feature indexing and property accessors for imagery-derived detections

## Installation

```shell
pip install osml-imagery-toolkit
```

No system libraries, no Conda — just pip. Requires Python 3.10+.

## Documentation

* **API Reference**: [awslabs.github.io/osml-imagery-toolkit](https://awslabs.github.io/osml-imagery-toolkit/)
* **Examples**: Scripts and notebooks in the [`examples/`](https://github.com/awslabs/osml-imagery-toolkit/tree/main/examples) directory

## Contributing

We welcome contributions and suggestions. Please see
[CONTRIBUTING.md](https://github.com/awslabs/osml-imagery-toolkit/blob/main/CONTRIBUTING.md)
for details.
