colour.plotting.plot_sky_colour_Wilkie2021#

colour.plotting.plot_sky_colour_Wilkie2021(dataset: SkyDataset_Wilkie2021, sun_elevation: float = np.radians(30), sun_azimuth: float = 0.0, visibility: float = 50.0, albedo: float = 0.3, include_sun: bool = True, samples: int = 181, epsilon_zenith: float = 1e-3, imshow_kwargs: dict | None = None, **kwargs: Any) → Tuple[Figure, Axes][source]#

Plot a true colour rendering of the sky using the Prague Sky Model.

Computes spectral sky radiance at visible wavelengths, optionally adds direct sun contribution, converts to CIE XYZ tristimulus values via the CIE 1931 2 Degree Standard Observer colour matching functions, and displays the result as an sRGB image.

Parameters:

dataset (SkyDataset_Wilkie2021) – Loaded SkyDataset_Wilkie2021 dataset.
sun_elevation (float) – Sun elevation at ground level in radians.
sun_azimuth (float) – Sun azimuth at ground level in radians.
visibility (float) – Meteorological range at ground level in kilometers.
albedo (float) – Ground albedo [0, 1].
include_sun (bool) – Whether to include direct sun radiance contribution.
samples (int) – Zenith resolution; the azimuth grid uses samples * 2.
epsilon_zenith (float) – Small positive offset on the zenith axis to avoid the singularity at the zenith pole.
imshow_kwargs (dict | None) – Keyword arguments for matplotlib.axes.Axes.imshow().
kwargs (Any) – {colour.plotting.artist(), colour.plotting.render()}, See the documentation of the previously listed definitions.

Returns:

Current figure and axes.

Return type:

tuple

References

[WVBashfordRogers+21]

Examples

>>> import os
>>> from colour.phenomena.sky.wilkie2021 import (
...     PATH_PRAGUE_SKY_MODEL_DATASET_GROUND,
... )
>>> if os.path.isfile(
...     PATH_PRAGUE_SKY_MODEL_DATASET_GROUND
... ):
...     ds = SkyDataset_Wilkie2021(PATH_PRAGUE_SKY_MODEL_DATASET_GROUND)
...     plot_sky_colour_Wilkie2021(ds)

colour.plotting.plot_sky_colour_Wilkie2021#

This Page