Colour-hdri

This release is a compatibility release with [Colour 0.4.4](https://github.com/colour-science/colour/releases/tag/v0.4.4).

The following scientific packages minimum versions are required:

- [colour-science](https://pypi.org/project/colour-science) >= 0.4.4

This release is a compatibility release with [Colour 0.4.3](https://github.com/colour-science/colour/releases/tag/v0.4.3).

The following scientific packages minimum versions are required:

- [numpy](https://pypi.org/project/numpy) >= 1.22
- [scipy](https://pypi.org/project/scipy) >= 1.8
- [colour-science](https://pypi.org/project/colour-science) >= 0.4.3

This release is mainly a compatibility release with [Colour 0.4.2](https://github.com/colour-science/colour/releases/tag/v0.4.2) providing support for Python 3.11.

The minimum Python version is 3.9 and the following scientific packages minimum versions are required:

- [numpy](https://pypi.org/project/numpy) >= 1.20
- [scipy](https://pypi.org/project/scipy) >= 1.7
- [colour-science](https://pypi.org/project/colour-science) >= 0.4.2

Features

- Implement support for lens vignette correction with the `colour_hdri.characterise_vignette` and `colour_hdri.correct_vignette` definitions. (d2c1268e8f9924007fbee70bbecbc18bd14dea2d, KelSolaar)

Changes

`colour_hdri`

Object | Name | Author
--------------------------------------------|------------------------------|-----------
`colour_hdri.XYZ_to_camera_space_matrix` | `matrix_XYZ_to_camera_space` | KelSolaar
`colour_hdri.camera_space_to_XYZ_matrix` | `matrix_camera_space_to_XYZ` | ...
`colour_hdri.image_stack_to_radiance_image` | `image_stack_to_HDRI` | ...

[Colour - HDRI - 0.2.0 - Alpha Milestone](https://github.com/colour-science/colour-hdri/issues?q=milestone%3Av0.2.0)

This release is a compatibility release with [Colour 0.4.1](https://github.com/colour-science/colour/releases/tag/v0.4.1).

**Support** for [Python 2.7](https://www.python.org/downloads/release/python-270/) has been dropped!

Changes

- The `colour_hdri.camera_response_functions_Debevec1997` definition has been updated to support an extrapolating function. It can be used to defined the behaviour over regions masked by the weighting function. (KelSolaar, KevinJW)

This release is a compatibility release with [Colour 0.3.16](https://github.com/colour-science/colour/releases/tag/v0.3.16).

This is the **last feature release to support** [Python 2.7](https://www.python.org/downloads/release/python-270/)!

Features

`colour_hdri.exposure`

- Implement support for modeling Digital Still Camera (DSC) exposure with the `colour_hdri.focal_plane_exposure`, `colour_hdri.arithmetic_mean_focal_plane_exposure`, `colour_hdri.saturation_based_speed_focal_plane_exposure`, `colour_hdri.exposure_value_100` and `colour_hdri.photometric_exposure_scale_factor_Lagarde2014` definitions. The models implemented by theses definitions are appropriate to simulate a physical camera in an offline or realtime renderer. (KelSolaar)
- Add `colour_hdri.luminance_to_exposure_value` and `colour_hdri.illuminance_to_exposure_value` definitions. (KelSolaar)

Changes

`colour_hdri.exposure`

- `colour_hdri.average_luminance`~: (KelSolaar)
- Signature: `average_luminance(N, t, S, k=12.5)`
- `colour_hdri.average_illuminance`~: (KelSolaar)
- Signature: `average_illuminance(N, t, S, c=250)`

`colour_hdri.utilities`

- ~`colour_hdri.exposure_value`~: (KelSolaar)
- Remove

The following definitions have been moved from the `colour_hdri.utilities` sub-package to the `colour_hdri.exposure` sub-package:

- `colour_hdri.average_luminance`
- `colour_hdri.average_illuminance`
- `colour_hdri.luminance_to_exposure_value`
- `colour_hdri.illuminance_to_exposure_value`
- `colour_hdri.adjust_exposure`