colour-science / colour

98%

develop: 99%

LAST BUILD ON BRANCH feature/array-api-support

branch: SELECT

CHANGE BRANCH

x

• No branch selected
• develop
• docs/pre-commit
• feature/CLF
• feature/CLF_execution
• feature/PMC
• feature/ampas_io
• feature/apple_log_profile
• feature/array-api-support
• feature/barten_pupil_diameter
• feature/benchmarks
• feature/callback
• feature/callback_alternative
• feature/canon_log_v1.2
• feature/checks
• feature/cie2024_integration
• feature/cie2024_varnish
• feature/cie_sky
• feature/cie_xyy
• feature/cif_recommendation
• feature/colorchecker_sg
• feature/continuous_interpolation
• feature/continuous_ssi
• feature/copyless
• feature/correction
• feature/coverage
• feature/delegate
• feature/delta_e_din99_methods_staging
• feature/delta_e_return_additional_data_staging
• feature/devcontainer
• feature/diagrams_models
• feature/dimensionality_reduction
• feature/docstrings
• feature/domain-range-scale-annotations
• feature/fichet2021
• feature/flattened_hellwig2022
• feature/flattened_hellwig2022_linear_extension
• feature/flog2c
• feature/fujifilm_flog2
• feature/gamma_class
• feature/gamma_partials
• feature/gaussian-upsampling
• feature/graph
• feature/hyab_staging
• feature/hych
• feature/hych_staging
• feature/idt
• feature/in-place
• feature/isort
• feature/iterable_signal
• feature/jenv
• feature/line_locus
• feature/literals
• feature/lut_support_improvements
• feature/lut_write
• feature/metadata
• feature/metamerism-spectral-staging
• feature/mired
• feature/munsell-onnx
• feature/numpy-2
• feature/numpy-printoptions
• feature/numpy_1_24_0
• feature/openimageio
• feature/openimageio-ci
• feature/optional-scipy
• feature/osa-ucs
• feature/osa_ucs
• feature/plasa_ansi_e154
• feature/polar_conversions
• feature/prek
• feature/pydot
• feature/pyproject_upgrade
• feature/pyright
• feature/pytest
• feature/python-3.12
• feature/python-3.13
• feature/python-3.14
• feature/qhull-regression
• feature/rayleigh
• feature/rayleigh_jeans_blackbody
• feature/reshape_sd_copy
• feature/rgb_xyz
• feature/robertson1968
• feature/ruff
• feature/scalar-type-aliases-staging
• feature/sd_gaussian
• feature/sd_reference_illum
• feature/sdiv
• feature/shape_from_array
• feature/small_labels
• feature/spow_bt1886
• feature/ssi
• feature/sucs-scam-staging
• feature/thin_film
• feature/tjdcs/v0.4.4
• feature/unit_tests
• feature/unittests
• feature/uv
• feature/v0.4.2
• feature/v0.4.3
• feature/v0.4.4
• feature/v0.4.5
• feature/v0.4.6
• feature/v0.4.7
• feature/v0.4.8
• feature/vaab_colour
• feature/vectorised-upsampling
• feature/vk20
• feature/web_colours
• feature/wgpu
• feature/wilkie2021
• feature/xdist-shenanigans
• feature/xiaomi_log_profile
• feature/xxhash
• feature/yrg
• feature/yuv
• feature_cct_improvements
• hych_staging
• maintenence/ctlrender
• maintenence/poetry_packages
• master
• performance/cfi2017
• performance/interpolation
• poetry_packages
• pre-commit-ci-update-config
• sd_to_xyz_integration_shape
• v0.4.2
• v0.4.3
• v0.4.4
• v0.4.5
• v0.4.6
• v0.4.7

Build # 27479300199

Build Type

Pull #1406

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)

Pull Request Pull Request #1406: PR: Implement support for *Python Array API Standard*.

Coverage Stats

48543 of 49343 relevant lines covered (98.38%)

0.98 hits per line