v1.4.2

OversightML Imagery Toolkit v1.4.2

This release fixes errors with using digital elevation models (DEMs) with the sensor models provided by this package. It is recommended that all applications update to this latest version since the errors fixed can impact the accuracy of geolocation (image_to_world) results.

---

What's Changed

• fix: bug in HAE RRDot surface projection by @edparris in #64
• fix: generic dem tile names for SW hemisphere by @edparris in #63
• docs: correct syntax mistakes in features and external type references by @edparris in #65

---

Full Changelog: v1.4.1...v1.4.2

v1.4.1

OversightML Imagery Toolkit v1.4.1

This release fixes errors in the dynamic range adjustment (DRA) calculations for imagery with >8 bits per pixel and handles incompatibilities with GDAL 3.9. This version is now compatible with GDAL versions 3.7 through 3.9 which also let us support all currently maintained versions of Python (3.9 through 3.13).

---

What's Changed

• feat: add support for GDAL 3.9 and Python 3.12 and 3.13 by @edparris in #60
• fix: DRA range calculation for imagery with more than 8 BPP by @edparris in #61

---

Full Changelog: v1.4.0...v1.4.1

v1.4.0

OversightML Imagery Toolkit v1.4.0

This release contains new capabilities that give the GDALTileFactory the ability to create orthophoto tiles on the fly from overhead imagery. These functions can be combined with the WebMercatorQuad tile matrix set to provide support for integrating imagery into a variety of map visualization applications. The processing makes use of SensorModels constructed from the georeferencing metadata to compute the mapping between the raw imagery pixels and the requested map tile. The map tiles are intended for human consumption so dynamic range adjustments other pixel preprocessing are applied to convert the raw imagery pixels into a RGB format for easy display. Preliminary performance tests have not shown issues so long as the imagery has an existing set of pre-generated overviews and auxiliary files with pixel statistics.

Limitations:

• Only PNGs: This implementation only provides support for PNG formatted output images. Future releases will support other formats as a request parameter.
• Simple Elevation: This code does not currently use an external digital elevation model to provide elevation information for points chosen inside a tile.

New Dependency:

• OpenCV has been added to provide the core image warping required to produce orthophotos.

---

Pull Requests Merged

• feat: add preliminary map tile creation by @edparris in #44
• fix: resolve unit test warnings by @edparris in #45
• fix: error creating SICD 1.3.0 sensor models by @edparris in #48
• fix: incorrect SICD/SIDD metadata added by tile factory by @edparris in #50
• docs: fixing typos by @jtblack-aws in #52
• feat: adding an alpha mask to ortho map tiles for pixels in the tile but outside the image by @jtblack-aws in #53
• fix: normalize tiles with respect to entire image and use range_adjustment setting by @jtblack-aws in #54
• fix: remove border between map tiles by @RanbirAulakh in #56
• feat: add ability to create map tiles from SICD images by @edparris in #58

---

Full Changelog: v1.3.2...v1.4.0

v1.4.0rc4

OversightML Imagery Toolkit v1.4.0rc4

This release is focused on updates to map tile generation. Changes include an alpha mask to map tiles to address cases where the tile bounds are outside the image bounds. Previously this was filled with black pixels that obstructed other map layers. The map tile endpoint now respects the range_adjustment setting of a viewpoint and applies the normalization with respect to the entire image instead of the local tile being requested.

Pull Requests Merged:

• docs: fixing typos by @jtblack-aws in #52
• feat: adding an alpha mask to ortho map tiles for pixels in the tile but outside the image by @jtblack-aws in #53
• fix: normalize tiles with respect to entire image and use range_adjustment setting by @jtblack-aws in #54
• chore: update library version to v1.4.0rc4 by @jtblack-aws in #55

---

Full Changelog: v1.4.0rc3...v1.4.0rc4

v1.4.0rc3

OversightML Imagery Toolkit v1.4.0rc3

This release fixes a programming error that caused the GDALTileFactory to write incorrect XML metadata with SICD tiles. The error may have had other unnoticed impacts on the metadata associated with any NITF tiles generated. It is the same change released in v1.3.2 added to this preview baseline for consumption by early adopters.

---

Pull Requests Merged:

• fix: incorrect SICD/SIDD metadata added by tile factory (#50)

---

Full Changelog: v1.4.0rc2...v1.4.0rc3

v1.3.2

OversightML Imagery Toolkit v1.3.2

This release fixes a programming error that caused the GDALTileFactory to write incorrect XML metadata with SICD tiles. The error may have had other unnoticed impacts on the metadata associated with any NITF tiles generated.

---

Pull Requests Merged:

• fix: incorrect SICD/SIDD metadata added by tile factory (#50)

---

Full Changelog: v1.3.1...v1.3.2

v1.4.0rc2

OversightML Imagery Toolkit v1.4.0rc2.`

This release fixes errors in the construction of sensor models from SICD 1.3.0 imagery. The sensor models themselves are unchanged but there was a problem in the logic that automatically parses/compares the values of key XML elements.

---

What's Changed

• build: update pypi publish to run on release by @edparris in #47
• fix: error creating SICD 1.3.0 sensor models by @edparris in #48
• chore: update library version to v1.4.0rc2 by @edparris in #49

Full Changelog: v1.4.0rc1...v1.4.0rc2

v1.3.1

OversightML Imagery Toolkit v1.3.`

This release fixes errors in the construction of sensor models from SICD 1.3.0 imagery. The sensor models themselves are unchanged but there was a problem in the logic that automatically parses/compares the values of key XML elements.

---

Pull Requests Merged:

• fix: error creating SICD 1.3.0 sensor models (#48)

---

Full Changelog: v1.3.0...v1.3.1

v1.4.0rc1

OversightML Imagery Toolkit v1.4.0rc1

This release contains a preview of the new map tiling capabilities to be introduced in v1.4.0. The changes include giving the GDALTileFactory the ability to create orthophoto tiles using a grid of locations computed using the SensorModel created from the image metadata. These functions can be combined with the WebMercatorQuad tile matrix set to provide support for integrating imagery into a variety of map visualization applications. Preliminary performance tests have not shown issues so long as the imagery has an existing set of pre-generated overviews and auxiliary files with pixel statistics.

Limitations:

• Only PNGs: This implementation only provides support for PNG formatted output images.
• Local DRA: The dynamic range adjustments are calculated on a per-tile basis instead of using global image statistics.
• Simple Elevation: This code does not currently use an external digital elevation model to provide elevation information for points chosen inside a tile.

New Dependency:

• OpenCV has been added to provide the core image warping required to produce orthophotos.

---

Pull Requests Merged

• feat: add preliminary map tile creation by @edparris in #44
• fix: resolve unit test warnings by @edparris in #45

---

Full Changelog: v1.3.0...v1.4.0rc1

v1.3.0

OversightML Imagery Toolkit v1.3.0

This release contains a small set of utilities to compute geographic locations for GeoJSON features that have 'imageGeometry' or 'imageBBox' properties set. It is also a maintenance release that updates dependencies for Python 3.11 environments.

---

Pull Requests Merged

• Release/v1.3.0: Geolocation Feature Utilities by @edparris in #36

---

Full Changelog: v1.2.0...v1.3.0