colour-science / colour / 27479033393

98%

develop: 99%

Build Type

push

github

Committed by KelSolaar

Commit Message

Implement support for *Python Array API Standard*.

*Colour* now dispatches array operations to the caller's backend (*NumPy*,
*JAX*, *PyTorch*) through the array-namespace machinery in
`colour.utilities.array`. Beyond the mechanical *NumPy* to namespace
conversion, this commit bundles the behaviour and public API changes
documented below so that they remain discoverable under `git blame` and
`git bisect`.

## Features

- Support for the *Python Array API Standard* was implemented: array
  operations dispatch to the input backend (*NumPy*, *JAX*, *PyTorch*)
  through the new `colour.utilities.array_namespace` and `xp_*` utilities,
  toggled with `colour.utilities.is_array_api_enabled` and
  `colour.utilities.set_array_api_enabled`.
- `colour.utilities.is_array_api_compat_installed` and
  `colour.utilities.is_array_api_extra_installed` were added.
- `colour.colorimetry.interpolate_signal`,
  `colour.colorimetry.extrapolate_signal` and
  `colour.colorimetry.trim_signal` were added, sharing the spectral
  distribution and multi-spectral distributions resampling implementation.
- `colour.colorimetry.msds_blackbody`,
  `colour.colorimetry.msds_rayleigh_jeans`,
  `colour.colorimetry.CIE_illuminant_D_series`,
  `colour.colorimetry.msds_CIE_illuminant_D_series` and
  `colour.colorimetry.msds_to_XYZ_tristimulus_weighting_factors_ASTME308`
  were added.
- `colour.appearance.eccentricity_factor_Hellwig2022` and
  `colour.appearance.hue_angle_dependency_Hellwig2022` were added.
- `colour.appearance.XYZ_to_Nayatani95` now computes the hue quadrature
  `H` correlate, previously left unset.

## Performance

- The multi-spectral distributions paths of `colour.colour_fidelity_index`,
  `colour.colour_quality_scale` and `colour.colour_rendering_index` were
  vectorised.
- The `colour.temperature` correlated colour temperature solvers were
  vectorised, replacing the *SciPy* `minimize` calls with closed-form
  Gauss-Newton iterations.

## Fixes

- `colour.colour_renderi... (continued)

Coverage Stats

15980 of 16362 new or added lines in 374 files covered. (97.67%)

24 existing lines in 9 files now uncovered.

48543 of 49343 relevant lines covered (98.38%)

0.98 hits per line