Colour Models#

CIE Models#

CIE xyY Colourspace#

colour

xy_to_xyY(xy[, Y])

Convert from CIE xy chromaticity coordinates to CIE xyY colourspace by extending the array's last dimension with the specified \(Y\) luminance.

xy_to_XYZ(xy)

Convert from CIE xy chromaticity coordinates to CIE XYZ tristimulus values.

xyY_to_xy(xyY)

Convert from CIE xyY colourspace to CIE xy chromaticity coordinates.

xyY_to_XYZ(xyY)

Convert from CIE xyY colourspace to CIE XYZ tristimulus values.

XYZ_to_xy(XYZ)

Convert from CIE XYZ tristimulus values to CIE xy chromaticity coordinates.

XYZ_to_xyY(XYZ)

Convert from CIE XYZ tristimulus values to CIE xyY colourspace.

CIE L*a*b* Colourspace#

colour

Lab_to_XYZ(Lab[, illuminant])

Convert from CIE L*a*b* colourspace to CIE XYZ tristimulus values.

XYZ_to_Lab(XYZ[, illuminant])

Convert from CIE XYZ tristimulus values to CIE L*a*b* colourspace.

CIE L*u*v* Colourspace#

colour

CIE1976UCS_to_XYZ(uvL[, illuminant])

Convert from \(uv^pL^*\) colourspace to CIE XYZ tristimulus values.

Luv_to_uv(Luv[, illuminant])

Convert from CIE L*u*v* colourspace to \(uv^p\) chromaticity coordinates.

Luv_to_XYZ(Luv[, illuminant])

Convert from CIE L*u*v* colourspace to CIE XYZ tristimulus values.

Luv_uv_to_xy(uv)

Convert from CIE L*u*v* colourspace \(u'v'\) chromaticity coordinates to CIE xy chromaticity coordinates.

uv_to_Luv(uv[, illuminant, L])

Convert from \(uv^p\) chromaticity coordinates to CIE L*u*v* colourspace by extending the array's last dimension with the specified \(L^*\) Lightness.

xy_to_Luv_uv(xy)

Convert from CIE xy chromaticity coordinates to CIE L*u*v* colourspace \(u'v'\) chromaticity coordinates.

XYZ_to_CIE1976UCS(XYZ[, illuminant])

Convert from CIE XYZ tristimulus values to \(uv^pL^*\) colourspace.

XYZ_to_Luv(XYZ[, illuminant])

Convert from CIE XYZ tristimulus values to CIE L*u*v* colourspace.

CIE 1960 UCS Colourspace#

colour

CIE1960UCS_to_XYZ(uvV)

Convert from CIE 1960 UCS \(uvV\) colourspace to CIE XYZ tristimulus values.

UCS_to_uv(UVW)

Convert from CIE 1960 UCS colourspace to uv chromaticity coordinates.

UCS_to_XYZ(UVW)

Convert from CIE 1960 UCS \(UVW\) colourspace to CIE XYZ tristimulus values.

UCS_uv_to_xy(uv)

Convert from CIE 1960 UCS \(UVW\) colourspace uv chromaticity coordinates to CIE xy chromaticity coordinates.

uv_to_UCS(uv[, V])

Convert from uv chromaticity coordinates to CIE 1960 UCS colourspace.

xy_to_UCS_uv(xy)

Convert from CIE xy chromaticity coordinates to CIE 1960 UCS \(UVW\) colourspace uv chromaticity coordinates.

XYZ_to_CIE1960UCS(XYZ)

Convert from CIE XYZ tristimulus values to CIE 1960 UCS \(uvV\) colourspace.

XYZ_to_UCS(XYZ)

Convert from CIE XYZ tristimulus values to CIE 1960 UCS \(UVW\) colourspace.

CIE 1964 U*V*W* Colourspace#

colour

UVW_to_XYZ(UVW[, illuminant])

Convert from CIE 1964 U*V*W* colourspace to CIE XYZ tristimulus values.

XYZ_to_UVW(XYZ[, illuminant])

Convert from CIE XYZ tristimulus values to CIE 1964 U*V*W* colourspace.

Colourspace Models#

colour

COLOURSPACE_MODELS

Colourspace models supporting a direct conversion to CIE XYZ tristimulus values.

CAM02-LCD, CAM02-SCD, and CAM02-UCS Colourspaces - Luo, Cui and Li (2006)#

colour

CAM02LCD_to_JMh_CIECAM02(Jpapbp)

Convert from Luo et al. (2006) CAM02-LCD colourspace \(J'a'b'\) array to CIECAM02 \(JMh\) correlates array.

CAM02LCD_to_XYZ(Jpapbp, **kwargs)

Convert from Luo et al. (2006) CAM02-LCD colourspace \(J'a'b'\) array to CIE XYZ tristimulus values.

CAM02SCD_to_JMh_CIECAM02(Jpapbp)

Convert from Luo et al. (2006) CAM02-SCD colourspace \(J'a'b'\) array to CIECAM02 \(JMh\) correlates array.

CAM02SCD_to_XYZ(Jpapbp, **kwargs)

Convert from Luo et al. (2006) CAM02-SCD colourspace \(J'a'b'\) array to CIE XYZ tristimulus values.

CAM02UCS_to_JMh_CIECAM02(Jpapbp)

Convert from Luo et al. (2006) CAM02-UCS colourspace \(J'a'b'\) array to CIECAM02 \(JMh\) correlates array.

CAM02UCS_to_XYZ(Jpapbp, **kwargs)

Convert from Luo et al. (2006) CAM02-UCS colourspace \(J'a'b'\) array to CIE XYZ tristimulus values.

JMh_CIECAM02_to_CAM02LCD(JMh)

Convert from CIECAM02 \(JMh\) correlates array to Luo et al. (2006) CAM02-LCD colourspace \(J'a'b'\) array.

JMh_CIECAM02_to_CAM02SCD(JMh)

Convert from CIECAM02 \(JMh\) correlates array to Luo et al. (2006) CAM02-SCD colourspace \(J'a'b'\) array.

JMh_CIECAM02_to_CAM02UCS(JMh)

Convert from CIECAM02 \(JMh\) correlates array to Luo et al. (2006) CAM02-UCS colourspace \(J'a'b'\) array.

XYZ_to_CAM02LCD(XYZ, **kwargs)

Convert from CIE XYZ tristimulus values to Luo et al. (2006) CAM02-LCD colourspace \(J'a'b'\) array.

XYZ_to_CAM02SCD(XYZ, **kwargs)

Convert from CIE XYZ tristimulus values to Luo et al. (2006) CAM02-SCD colourspace \(J'a'b'\) array.

XYZ_to_CAM02UCS(XYZ, **kwargs)

Convert from CIE XYZ tristimulus values to Luo et al. (2006) CAM02-UCS colourspace \(J'a'b'\) array.

CAM16-LCD, CAM16-SCD, and CAM16-UCS Colourspaces - Li et al. (2017)#

colour

CAM16LCD_to_JMh_CAM16(Jpapbp, *[, coefficients])

Convert from Li et al. (2017) CAM16-LCD colourspace \(J'a'b'\) array to CAM16 \(JMh\) correlates array.

CAM16LCD_to_XYZ(Jpapbp, *[, coefficients])

Convert from Li et al. (2017) CAM16-LCD colourspace \(J'a'b'\) array to CIE XYZ tristimulus values.

CAM16SCD_to_JMh_CAM16(Jpapbp, *[, coefficients])

Convert from Li et al. (2017) CAM16-SCD colourspace \(J'a'b'\) array to CAM16 \(JMh\) correlates array.

CAM16SCD_to_XYZ(Jpapbp, *[, coefficients])

Convert from Li et al. (2017) CAM16-SCD colourspace \(J'a'b'\) array to CIE XYZ tristimulus values.

CAM16UCS_to_JMh_CAM16(Jpapbp, *[, coefficients])

Convert from Li et al. (2017) CAM16-UCS colourspace \(J'a'b'\) array to CAM16 \(JMh\) correlates array.

CAM16UCS_to_XYZ(Jpapbp, *[, coefficients])

Convert from Li et al. (2017) CAM16-UCS colourspace \(J'a'b'\) array to CIE XYZ tristimulus values.

JMh_CAM16_to_CAM16LCD(JMh, *[, coefficients])

Convert from CAM16 \(JMh\) correlates array to Luo et al. (2006) CAM16-LCD colourspace \(J'a'b'\) array.

JMh_CAM16_to_CAM16SCD(JMh, *[, coefficients])

Convert from CAM16 \(JMh\) correlates array to Luo et al. (2006) CAM16-SCD colourspace \(J'a'b'\) array.

JMh_CAM16_to_CAM16UCS(JMh, *[, coefficients])

Convert from CAM16 \(JMh\) correlates array to Luo et al. (2006) CAM16-UCS colourspace \(J'a'b'\) array.

XYZ_to_CAM16LCD(XYZ, *[, coefficients])

Convert from CIE XYZ tristimulus values to Li et al. (2017) CAM16-LCD colourspace \(J'a'b'\) array.

XYZ_to_CAM16SCD(XYZ, *[, coefficients])

Convert from CIE XYZ tristimulus values to Li et al. (2017) CAM16-SCD colourspace \(J'a'b'\) array.

XYZ_to_CAM16UCS(XYZ, *[, coefficients])

Convert from CIE XYZ tristimulus values to Li et al. (2017) CAM16-UCS colourspace \(J'a'b'\) array.

DIN99 Colourspace and DIN99b, DIN99c, DIN99d Refined Formulas#

colour

DIN99_to_Lab(Lab_99[, k_E, k_CH, method])

Convert from DIN99 colourspace or one of the DIN99b, DIN99c, DIN99d refined formulas according to Cui et al. (2002) to CIE L*a*b* colourspace.

DIN99_to_XYZ(Lab_99[, illuminant, k_E, ...])

Convert from DIN99 colourspace or one of the DIN99b, DIN99c, DIN99d refined formulas according to Cui et al. (2002) to CIE XYZ tristimulus values.

Lab_to_DIN99(Lab[, k_E, k_CH, method])

Convert from CIE L*a*b* colourspace to DIN99 colourspace or one of the DIN99b, DIN99c, DIN99d refined formulas according to Cui et al. (2002).

XYZ_to_DIN99(XYZ[, illuminant, k_E, k_CH, ...])

Convert from CIE XYZ tristimulus values to DIN99 colourspace or one of the DIN99b, DIN99c, DIN99d refined formulas according to Cui et al. (2002).

Hunter L,a,b Colour Scale#

colour

Hunter_Lab_to_XYZ(Lab[, XYZ_n, K_ab])

Convert from Hunter L,a,b colour scale to CIE XYZ tristimulus values.

XYZ_to_Hunter_Lab(XYZ[, XYZ_n, K_ab])

Convert from CIE XYZ tristimulus values to Hunter L,a,b colour scale.

XYZ_to_K_ab_HunterLab1966(XYZ)

Convert from whitepoint CIE XYZ tristimulus values to Hunter L,a,b \(K_{a}\) and \(K_{b}\) chromaticity coefficients.

Hunter Rd,a,b Colour Scale#

colour

Hunter_Rdab_to_XYZ(R_d_ab[, XYZ_n, K_ab])

Convert from Hunter Rd,a,b colour scale to CIE XYZ tristimulus values.

XYZ_to_Hunter_Rdab(XYZ[, XYZ_n, K_ab])

Convert from CIE XYZ tristimulus values to Hunter Rd,a,b colour scale.

\(IC_AC_B\) Colourspace#

colour

ICaCb_to_XYZ(ICaCb)

Convert from \(IC_AC_B\) colourspace to CIE XYZ tristimulus values.

XYZ_to_ICaCb(XYZ)

Convert from CIE XYZ tristimulus values to \(IC_AC_B\) colourspace.

\(I_GP_GT_G\) Colourspace#

colour

IgPgTg_to_XYZ(IgPgTg)

Convert from \(I_GP_GT_G\) colourspace to CIE XYZ tristimulus values.

XYZ_to_IgPgTg(XYZ)

Convert from CIE XYZ tristimulus values to \(I_GP_GT_G\) colourspace.

IPT Colourspace#

colour

IPT_to_XYZ(IPT)

Convert from IPT colourspace to CIE XYZ tristimulus values.

XYZ_to_IPT(XYZ)

Convert from CIE XYZ tristimulus values to IPT colourspace.

Ancillary Objects

colour.models

IPT_hue_angle(IPT)

Compute the hue angle in degrees from the IPT colourspace array.

hdr-CIELAB Colourspace#

colour

HDR_CIELAB_METHODS

Supported hdr-CIELAB colourspace computation methods.

hdr_CIELab_to_XYZ(Lab_hdr[, illuminant, ...])

Convert from hdr-CIELAB colourspace to CIE XYZ tristimulus values.

XYZ_to_hdr_CIELab(XYZ[, illuminant, Y_s, ...])

Convert from CIE XYZ tristimulus values to hdr-CIELAB colourspace.

hdr-IPT Colourspace#

colour

HDR_IPT_METHODS

Supported hdr-IPT colourspace computation methods.

hdr_IPT_to_XYZ(IPT_hdr[, Y_s, Y_abs, method])

Convert from hdr-IPT colourspace to CIE XYZ tristimulus values.

XYZ_to_hdr_IPT(XYZ[, Y_s, Y_abs, method])

Convert from CIE XYZ tristimulus values to hdr-IPT colourspace.

\(Jzazbz\) Colourspace#

colour

Jzazbz_to_XYZ(Jzazbz[, constants])

Convert from \(J_za_zb_z\) colourspace to CIE XYZ tristimulus values.

XYZ_to_Jzazbz(XYZ_D65[, constants])

Convert from CIE XYZ tristimulus values to \(J_za_zb_z\)

Ancillary Objects

colour.models

IZAZBZ_METHODS

Supported \(I_za_zb_z\) computation methods.

Izazbz_to_XYZ(Izazbz[, constants, method])

Convert from \(I_za_zb_z\) colourspace to CIE XYZ tristimulus values.

XYZ_to_Izazbz(XYZ_D65[, constants, method])

Convert from CIE XYZ tristimulus values to \(I_za_zb_z\) colourspace.

Oklab Colourspace#

colour

Oklab_to_XYZ(Lab)

Convert from Oklab colourspace to CIE XYZ tristimulus values.

XYZ_to_Oklab(XYZ)

Convert from CIE XYZ tristimulus values to Oklab colourspace.

OSA UCS Colourspace#

colour

OSA_UCS_to_XYZ(Ljg[, optimisation_kwargs])

Convert from OSA UCS colourspace to CIE XYZ tristimulus values under the CIE 1964 10 Degree Standard Observer.

XYZ_to_OSA_UCS(XYZ)

Convert from CIE XYZ tristimulus values under the CIE 1964 10 Degree Standard Observer to OSA UCS colourspace.

ProLab Colourspace#

colour

ProLab_to_XYZ(ProLab[, illuminant])

Convert from ProLab colourspace to CIE XYZ tristimulus values.

XYZ_to_ProLab(XYZ[, illuminant])

Convert from CIE XYZ tristimulus values to ProLab colourspace.

Ragoo and Farup (2021) Optimised IPT Colourspace#

colour

IPT_Ragoo2021_to_XYZ(IPT)

Convert from Ragoo and Farup (2021) Optimised IPT colourspace to CIE XYZ tristimulus values.

XYZ_to_IPT_Ragoo2021(XYZ)

Convert from CIE XYZ tristimulus values to Ragoo and Farup (2021) Optimised IPT colourspace.

sUCS Colourspace#

colour

sUCS_to_XYZ(Iab)

Convert from sUCS colourspace to CIE XYZ tristimulus values.

XYZ_to_sUCS(XYZ)

Convert from CIE XYZ tristimulus values to sUCS colourspace.

Ancillary Objects

colour.models

sUCS_chroma(Iab)

Compute the chroma component from the sUCS colourspace.

sUCS_hue_angle(Iab)

Compute the hue angle in degrees from the sUCS colourspace.

sUCS_Iab_to_sUCS_ICh(Iab)

Convert from sUCS \(Iab\) rectangular coordinates to sUCS \(ICh\) cylindrical coordinates.

sUCS_ICh_to_sUCS_Iab(ICh)

Convert from sUCS \(ICh\) cylindrical coordinates to sUCS \(Iab\) rectangular coordinates.

Yrg Colourspace - Kirk (2019)#

colour

XYZ_to_Yrg(XYZ)

Convert from CIE XYZ tristimulus values to Kirk (2019) Yrg colourspace.

Yrg_to_XYZ(Yrg)

Convert from Kirk (2019) Yrg colourspace to CIE XYZ tristimulus values.

colour.models

LMS_to_Yrg(LMS)

Convert from LMS cone fundamentals colourspace to Kirk (2019) Yrg colourspace.

Yrg_to_LMS(Yrg)

Convert from Kirk (2019) Yrg colourspace to LMS cone fundamentals colourspace.

Polar Transformations#

colour

COLOURSPACE_MODELS_POLAR_CONVERSIONS

Built-in immutable sequence.

hdr_CIELab_to_hdr_CIELCHab(Jab)

Convert from hdr_CIELab colourspace to hdr_CIELCHab colourspace.

hdr_CIELCHab_to_hdr_CIELab(JCh)

Convert from hdr_CIELCHab colourspace to hdr_CIELab colourspace.

hdr_ICH_to_hdr_IPT(JCh)

Convert from hdr_ICH colourspace to hdr_IPT colourspace.

hdr_IPT_to_hdr_ICH(Jab)

Convert from hdr_IPT colourspace to hdr_ICH colourspace.

Hunter_Lab_to_Hunter_LCHab(Jab)

Convert from Hunter_Lab colourspace to Hunter_LCHab colourspace.

Hunter_LCHab_to_Hunter_Lab(JCh)

Convert from Hunter_LCHab colourspace to Hunter_Lab colourspace.

Hunter_Rdab_to_Hunter_RdCHab(Jab)

Convert from Hunter_Rdab colourspace to Hunter_RdCHab colourspace.

Hunter_RdCHab_to_Hunter_Rdab(JCh)

Convert from Hunter_RdCHab colourspace to Hunter_Rdab colourspace.

ICaCb_to_ICHab(Jab)

Convert from ICaCb colourspace to ICHab colourspace.

ICH_Ragoo2021_to_IPT_Ragoo2021(JCh)

Convert from ICH_Ragoo2021 colourspace to IPT_Ragoo2021 colourspace.

ICH_to_IPT(JCh)

Convert from ICH colourspace to IPT colourspace.

ICHab_to_ICaCb(JCh)

Convert from ICHab colourspace to ICaCb colourspace.

ICHtp_to_ICtCp(JCh)

Convert from ICHtp colourspace to ICtCp colourspace.

ICtCp_to_ICHtp(Jab)

Convert from ICtCp colourspace to ICHtp colourspace.

IgCHpt_to_IgPgTg(JCh)

Convert from IgCHpt colourspace to IgPgTg colourspace.

IgPgTg_to_IgCHpt(Jab)

Convert from IgPgTg colourspace to IgCHpt colourspace.

IPT_Ragoo2021_to_ICH_Ragoo2021(Jab)

Convert from IPT_Ragoo2021 colourspace to ICH_Ragoo2021 colourspace.

IPT_to_ICH(Jab)

Convert from IPT colourspace to ICH colourspace.

Izazbz_to_IzCHab(Jab)

Convert from Izazbz colourspace to IzCHab colourspace.

IzCHab_to_Izazbz(JCh)

Convert from IzCHab colourspace to Izazbz colourspace.

Jzazbz_to_JzCHab(Jab)

Convert from Jzazbz colourspace to JzCHab colourspace.

JzCHab_to_Jzazbz(JCh)

Convert from JzCHab colourspace to Jzazbz colourspace.

Lab_to_LCHab(Jab)

Convert from Lab colourspace to LCHab colourspace.

LCHab_to_Lab(JCh)

Convert from LCHab colourspace to Lab colourspace.

LCHuv_to_Luv(JCh)

Convert from LCHuv colourspace to Luv colourspace.

Luv_to_LCHuv(Jab)

Convert from Luv colourspace to LCHuv colourspace.

Oklab_to_Oklch(Jab)

Convert from Oklab colourspace to Oklch colourspace.

Oklch_to_Oklab(JCh)

Convert from Oklch colourspace to Oklab colourspace.

ProLab_to_ProLCHab(Jab)

Convert from ProLab colourspace to ProLCHab colourspace.

ProLCHab_to_ProLab(JCh)

Convert from ProLCHab colourspace to ProLab colourspace.

Helper Functions#

colour.models

Iab_to_XYZ(Iab, LMS_p_to_LMS_callable, ...)

Convert from IPT-like \(Iab\) colour representation to CIE XYZ tristimulus values.

Jab_to_JCh(Jab)

Convert from Jab colour representation to JCh colour representation.

JCh_to_Jab(JCh)

Convert from JCh colour representation to Jab colour representation.

XYZ_to_Iab(XYZ, LMS_to_LMS_p_callable, ...)

Convert from CIE XYZ tristimulus values to IPT-like \(Iab\) colour representation.

RGB Colourspace and Transformations#

colour

matrix_RGB_to_RGB(input_colourspace, ...[, ...])

Compute the matrix \(M\) converting from the specified input RGB colourspace to the specified output RGB colourspace using the specified chromatic adaptation method.

RGB_to_RGB(RGB, input_colourspace, ...[, ...])

Convert RGB colourspace array from the specified input RGB colourspace to specified output RGB colourspace using the specified chromatic adaptation method.

RGB_to_XYZ(RGB, colourspace[, illuminant, ...])

Convert specified RGB colourspace array to CIE XYZ tristimulus values.

XYZ_to_RGB(XYZ, colourspace[, illuminant, ...])

Convert from CIE XYZ tristimulus values to RGB colourspace array.

Ancillary Objects

colour

sRGB_to_XYZ(RGB[, illuminant, ...])

Convert from sRGB colourspace to CIE XYZ tristimulus values.

XYZ_to_sRGB(XYZ[, illuminant, ...])

Convert from CIE XYZ tristimulus values to sRGB colourspace.

RGB Colourspace Derivation#

colour

chromatically_adapted_primaries(primaries, ...)

Chromatically adapt specified primaries \(xy\) chromaticity coordinates from test whitepoint_t to reference whitepoint_r.

normalised_primary_matrix(primaries, whitepoint)

Compute the Normalised Primary Matrix (NPM) converting a RGB colourspace array to CIE XYZ tristimulus values using the specified primaries and whitepoint \(xy\) chromaticity coordinates.

primaries_whitepoint(npm)

Compute the primaries and whitepoint \(xy\) chromaticity coordinates using the specified Normalised Primary Matrix (NPM).

RGB_luminance(RGB, primaries, whitepoint)

Calculate the luminance \(Y\) of the specified RGB components using the specified primaries and whitepoint chromaticity coordinates.

RGB_luminance_equation(primaries, whitepoint)

Return the luminance equation from the specified primaries and whitepoint.

RGB Colourspaces#

colour

RGB_Colourspace(name, primaries, whitepoint)

Implement support for RGB colourspace datasets from modules including colour.models.datasets.aces_rgb.

RGB_COLOURSPACES

Aggregated RGB colourspaces.

colour.models

RGB_COLOURSPACE_ACES2065_1

ACES2065-1 colourspace, base encoding, used for exchange of full fidelity images and archiving.

RGB_COLOURSPACE_ACESCC

ACEScc colourspace, a working space for color correctors, target for ASC-CDL values created on-set.

RGB_COLOURSPACE_ACESCG

ACEScg colourspace, a working space for paint/compositor applications that don't support ACES2065-1 or ACEScc.

RGB_COLOURSPACE_ACESPROXY

ACESproxy colourspace, a lightweight encoding for transmission over HD-SDI (or other production transmission schemes), onset look management.

RGB_COLOURSPACE_ADOBE_RGB1998

Adobe RGB (1998) colourspace.

RGB_COLOURSPACE_ADOBE_WIDE_GAMUT_RGB

Adobe Wide Gamut RGB colourspace.

RGB_COLOURSPACE_APPLE_RGB

Apple RGB colourspace.

RGB_COLOURSPACE_ARRI_WIDE_GAMUT_3

ARRI Wide Gamut 3 colourspace.

RGB_COLOURSPACE_ARRI_WIDE_GAMUT_4

ARRI Wide Gamut 4 colourspace.

RGB_COLOURSPACE_BEST_RGB

Best RGB colourspace.

RGB_COLOURSPACE_BETA_RGB

Beta RGB colourspace.

RGB_COLOURSPACE_BLACKMAGIC_WIDE_GAMUT

Blackmagic Wide Gamut colourspace.

RGB_COLOURSPACE_BT2020

RecommendationITU-R BT.2020 colourspace.

RGB_COLOURSPACE_BT470_525

Recommendation ITU-R BT.470 - 525 colourspace.

RGB_COLOURSPACE_BT470_625

Recommendation ITU-R BT.470 - 625 colourspace.

RGB_COLOURSPACE_BT709

Recommendation ITU-R BT.709 colourspace.

RGB_COLOURSPACE_CIE_RGB

CIE RGB colourspace.

RGB_COLOURSPACE_CINEMA_GAMUT

Canon Cinema Gamut colourspace.

RGB_COLOURSPACE_COLOR_MATCH_RGB

ColorMatch RGB colourspace.

RGB_COLOURSPACE_DAVINCI_WIDE_GAMUT

DaVinci Wide Gamut colourspace.

RGB_COLOURSPACE_DCDM_XYZ

DCDM XYZ colourspace.

RGB_COLOURSPACE_DCI_P3

DCI-P3 colourspace.

RGB_COLOURSPACE_DCI_P3_P

DCI-P3+ colourspace.

RGB_COLOURSPACE_DISPLAY_P3

Display P3 colourspace.

RGB_COLOURSPACE_DJI_D_GAMUT

DJI_D-Gamut colourspace.

RGB_COLOURSPACE_DON_RGB_4

Don RGB 4 colourspace.

RGB_COLOURSPACE_DRAGON_COLOR

DRAGONcolor colourspace.

RGB_COLOURSPACE_DRAGON_COLOR_2

DRAGONcolor2 colourspace.

RGB_COLOURSPACE_EBU_3213_E

*EBU Tech.

RGB_COLOURSPACE_ECI_RGB_V2

ECI RGB v2 colourspace.

RGB_COLOURSPACE_EKTA_SPACE_PS_5

Ekta Space PS 5 colourspace.

RGB_COLOURSPACE_ERIMM_RGB

ERIMM RGB colourspace.

RGB_COLOURSPACE_F_GAMUT

Fujifilm F-Gamut colourspace.

RGB_COLOURSPACE_F_GAMUT_C

Fujifilm F-Gamut C colourspace.

RGB_COLOURSPACE_FILMLIGHT_E_GAMUT

FilmLight E-Gamut colourspace.

RGB_COLOURSPACE_G18_REC709_SCENE

Gamma 1.8 Encoded Rec.709 colourspace.

RGB_COLOURSPACE_G22_ADOBERGB_SCENE

Gamma 2.2 Encoded AdobeRGB colourspace.

RGB_COLOURSPACE_G22_AP1_SCENE

Gamma 2.2 Encoded AP1 colourspace.

RGB_COLOURSPACE_G22_REC709_SCENE

Gamma 2.2 Encoded Rec.709 colourspace.

RGB_COLOURSPACE_H273_22_UNSPECIFIED

Recommendation ITU-T H.273 row 22 colourspace as specified in Table 2 - Interpretation of colour primaries (ColourPrimaries) value.

RGB_COLOURSPACE_H273_GENERIC_FILM

Recommendation ITU-T H.273 Generic Film (colour filters using Illuminant C) colourspace.

RGB_COLOURSPACE_LIN_ADOBERGB_SCENE

Linear AdobeRGB colourspace.

RGB_COLOURSPACE_LIN_CIEXYZD65_SCENE

CIE XYZ-D65 - Scene-referred colourspace.

RGB_COLOURSPACE_LIN_P3D65_SCENE

Linear P3-D65 colourspace.

RGB_COLOURSPACE_LIN_REC2020_SCENE

Linear Rec.2020 colourspace.

RGB_COLOURSPACE_LIN_REC709_SCENE

Linear Rec.709 (sRGB) colourspace.

RGB_COLOURSPACE_MAX_RGB

Max RGB colourspace.

RGB_COLOURSPACE_N_GAMUT

Nikon N-Gamut colourspace.

RGB_COLOURSPACE_NTSC1953

NTSC (1953) colourspace.

RGB_COLOURSPACE_NTSC1987

NTSC (1987) colourspace.

RGB_COLOURSPACE_P3_D65

P3-D65 colourspace.

RGB_COLOURSPACE_PAL_SECAM

Pal/Secam colourspace.

RGB_COLOURSPACE_PLASA_ANSI_E154

PLASA ANSI E1.54 colourspace.

RGB_COLOURSPACE_PROPHOTO_RGB

ProPhoto RGB colourspace, an alias colourspace for ROMM RGB.

RGB_COLOURSPACE_PROTUNE_NATIVE

Protune Native colourspace.

RGB_COLOURSPACE_RED_COLOR

REDcolor colourspace.

RGB_COLOURSPACE_RED_COLOR_2

REDcolor2 colourspace.

RGB_COLOURSPACE_RED_COLOR_3

REDcolor3 colourspace.

RGB_COLOURSPACE_RED_COLOR_4

REDcolor4 colourspace.

RGB_COLOURSPACE_RED_WIDE_GAMUT_RGB

REDWideGamutRGB colourspace.

RGB_COLOURSPACE_RIMM_RGB

RIMM RGB colourspace.

RGB_COLOURSPACE_ROMM_RGB

ROMM RGB colourspace.

RGB_COLOURSPACE_RUSSELL_RGB

Russell RGB colourspace.

RGB_COLOURSPACE_S_GAMUT

S-Gamut colourspace.

RGB_COLOURSPACE_S_GAMUT3

S-Gamut3 colourspace.

RGB_COLOURSPACE_S_GAMUT3_CINE

S-Gamut3.Cine colourspace.

RGB_COLOURSPACE_SHARP_RGB

Sharp RGB colourspace.

RGB_COLOURSPACE_SMPTE_240M

SMPTE 240M colourspace.

RGB_COLOURSPACE_SMPTE_C

SMPTE C colourspace.

RGB_COLOURSPACE_sRGB

sRGB colourspace.

RGB_COLOURSPACE_SRGB_AP1_SCENE

sRGB Encoded AP1 colourspace.

RGB_COLOURSPACE_SRGB_P3D65_SCENE

sRGB Encoded P3-D65 colourspace.

RGB_COLOURSPACE_SRGB_REC709_SCENE

sRGB Encoded Rec.709 (sRGB) colourspace.

RGB_COLOURSPACE_V_GAMUT

Panasonic V-Gamut colourspace.

RGB_COLOURSPACE_VENICE_S_GAMUT3

Venice S-Gamut3 colourspace.

RGB_COLOURSPACE_VENICE_S_GAMUT3_CINE

Venice S-Gamut3.Cine colourspace.

RGB_COLOURSPACE_XTREME_RGB

Xtreme RGB colourspace.

RGB_COLOURSPACES_TEXTURE_ASSETS_AND_CG_RENDERING_CIF

RGB colourspace encodings for texture assets and computer graphics (CG) rendering.

Colour Component Transfer Functions#

colour

cctf_decoding(value[, function])

Apply the specified decoding colour component transfer function (Decoding CCTF).

CCTF_DECODINGS

Supported decoding colour component transfer functions (decoding CCTFs), a collection comprising functions from colour.LOG_DECODINGS, colour.OETF_INVERSES, colour.EOTFS, colour.models.cctf_decoding_ProPhotoRGB(), colour.models.cctf_decoding_RIMMRGB(), colour.models.cctf_decoding_ROMMRGB(), and three gamma decoding functions (2.2, 2.4, 2.6).

cctf_encoding(value[, function])

Apply the specified encoding colour component transfer function (Encoding CCTF).

CCTF_ENCODINGS

Supported encoding colour component transfer functions (encoding CCTFs), a collection comprising functions from colour.LOG_ENCODINGS, colour.OETFS, colour.EOTF_INVERSES, colour.models.cctf_encoding_ProPhotoRGB(), colour.models.cctf_encoding_RIMMRGB(), colour.models.cctf_encoding_ROMMRGB(), and three gamma encoding functions (1/2.2, 1/2.4, 1/2.6).

gamma_function(a[, exponent, ...])

Apply a gamma encoding or decoding transformation to the specified array.

linear_function(-> DTypeFloat  -> NDArrayFloat)

Perform pass-through linear encoding/decoding transformation.

colour.models

cctf_decoding_RIMMRGB(X_p[, bit_depth, ...])

Apply the RIMM RGB decoding colour component transfer function (Decoding CCTF).

cctf_decoding_ROMMRGB(X_p[, bit_depth, in_int])

Apply the ROMM RGB decoding colour component transfer function (Decoding CCTF).

cctf_encoding_RIMMRGB(X[, bit_depth, ...])

Apply the RIMM RGB encoding colour component transfer function (Encoding CCTF).

cctf_encoding_ROMMRGB(X[, bit_depth, out_int])

Apply the ROMM RGB encoding colour component transfer function (Encoding CCTF).

Aliases

colour.models

cctf_decoding_ProPhotoRGB(X_p[, bit_depth, ...])

Apply the ProPhoto RGB decoding colour component transfer function (Decoding CCTF).

cctf_encoding_ProPhotoRGB(X[, bit_depth, ...])

Apply the ProPhoto RGB encoding colour component transfer function (Encoding CCTF).

Ancillary Objects

colour.models

exponent_function_basic(x[, exponent, style])

Apply a basic exponent transfer function to the specified array.

exponent_function_monitor_curve(x[, ...])

Apply the Monitor Curve exponent transfer function to the specified array.

logarithmic_function_basic(x[, style, base])

Apply a logarithmic or anti-logarithmic transformation to the specified array.

logarithmic_function_camera(x[, style, ...])

Apply a camera logarithmic function to the specified array.

logarithmic_function_quasilog(x[, style, ...])

Apply the Quasilog logarithmic function for encoding and decoding.

Opto-Electronic Transfer Functions#

colour

oetf(value[, function])

Apply the specified opto-electronic transfer function (OETF).

oetf_inverse(value[, function])

Apply the specified inverse opto-electronic transfer function (OETF).

OETF_INVERSES

Supported inverse opto-electrical transfer functions (OETFs / OECFs).

OETFS

Supported opto-electrical transfer functions (OETFs / OECFs).

colour.models

oetf_ARIBSTDB67(E[, r, constants])

Apply the ARIB STD-B67 (Hybrid Log-Gamma) opto-electronic transfer function (OETF).

oetf_BlackmagicFilmGeneration5(x[, constants])

Apply the Blackmagic Film Generation 5 opto-electronic transfer function (OETF).

oetf_BT2020(E[, is_12_bits_system, constants])

Apply the Recommendation ITU-R BT.2020 opto-electronic transfer function (OETF).

oetf_BT2100_HLG(E[, constants])

Apply the Recommendation ITU-R BT.2100 Reference HLG opto-electrical transfer function (OETF).

oetf_BT2100_PQ(E)

Apply the Recommendation ITU-R BT.2100 Reference PQ opto-electronic transfer function (OETF).

oetf_BT601(L)

Apply the Recommendation ITU-R BT.601-7 opto-electronic transfer function (OETF).

oetf_BT709(L)

Apply the Recommendation ITU-R BT.709-6 opto-electronic transfer function (OETF).

oetf_DaVinciIntermediate(L[, constants])

Apply the DaVinci Intermediate opto-electronic transfer function (OETF).

oetf_H273_IEC61966_2(L_c)

Apply the Recommendation ITU-T H.273 opto-electronic transfer function (OETF) for IEC 61966-2 family of transfer functions (2-1 sRGB, 2-1 sYCC, 2-4 xvYCC).

oetf_H273_Log(L_c)

Apply the Recommendation ITU-T H.273 opto-electronic transfer function (OETF) for logarithmic encoding with 100:1 dynamic range.

oetf_H273_LogSqrt(L_c)

Apply the Recommendation ITU-T H.273 opto-electronic transfer function (OETF) for logarithmic encoding (100*Sqrt(10):1 range).

oetf_inverse_ARIBSTDB67(E_p[, r, constants])

Apply the ARIB STD-B67 (Hybrid Log-Gamma) inverse opto-electronic transfer function (OETF).

oetf_inverse_BlackmagicFilmGeneration5(y[, ...])

Apply the Blackmagic Film Generation 5 inverse opto-electronic transfer function (OETF).

oetf_inverse_BT2020(E_p[, ...])

Apply the Recommendation ITU-R BT.2020 inverse opto-electronic transfer function (OETF).

oetf_inverse_BT2100_HLG(E_p[, constants])

Apply the Recommendation ITU-R BT.2100 Reference HLG inverse opto-electrical transfer function (OETF).

oetf_inverse_BT2100_PQ(E_p)

Apply the Recommendation ITU-R BT.2100 Reference PQ inverse opto-electrical transfer function (OETF).

oetf_inverse_BT601(E)

Apply the Recommendation ITU-R BT.601-7 inverse opto-electronic transfer function (OETF).

oetf_inverse_BT709(V)

Apply the Recommendation ITU-R BT.709-6 inverse opto-electronic transfer function (OETF).

oetf_inverse_DaVinciIntermediate(V[, constants])

Apply the DaVinci Intermediate inverse opto-electronic transfer function (OETF).

oetf_inverse_H273_IEC61966_2(V)

Apply the Recommendation ITU-T H.273 inverse opto-electronic transfer function (OETF) for the IEC 61966-2 family of transfer functions (2-1 sRGB, 2-1 sYCC, 2-4 xvYCC).

oetf_inverse_H273_Log(V)

Apply the Recommendation ITU-T H.273 inverse opto-electronic transfer function (OETF) for logarithmic encoding with 100:1 dynamic range.

oetf_inverse_H273_LogSqrt(V)

Apply the Recommendation ITU-T H.273 inverse opto-electronic transfer function (OETF) for logarithmic encoding (100*Sqrt(10):1 range).

oetf_SMPTE240M(L_c)

Apply the SMPTE 240M opto-electronic transfer function (OETF).

Electro-Optical Transfer Functions#

colour

eotf(value[, function])

Apply the specified electro-optical transfer function (EOTF).

eotf_inverse(value[, function])

Apply the specified inverse electro-optical transfer function (EOTF).

EOTF_INVERSES

Supported inverse electro-optical transfer functions (EOTFs / EOCFs).

EOTFS

Supported electro-optical transfer functions (EOTFs / EOCFs).

colour.models

BT2100_HLG_EOTF_INVERSE_METHODS

Define the supported ITU-R BT.2100 Reference HLG inverse electro-optical transfer function (EOTF) methods.

BT2100_HLG_EOTF_METHODS

Define supported ITU-R BT.2100 Reference HLG electro-optical transfer function (EOTF) methods.

eotf_BT1886(V[, L_B, L_W])

Apply the Recommendation ITU-R BT.1886 electro-optical transfer function (EOTF) for flat panel displays.

eotf_BT2100_HLG(E_p[, L_B, L_W, gamma, ...])

Apply the Recommendation ITU-R BT.2100 Reference HLG electro-optical transfer function (EOTF).

eotf_BT2100_PQ(E_p)

Apply the Recommendation ITU-R BT.2100 Reference PQ electro-optical transfer function (EOTF).

eotf_DCDM(XYZ_p[, in_int])

Apply the DCDM electro-optical transfer function (EOTF).

eotf_DICOMGSDF(J[, in_int, constants])

Apply the DICOM - Grayscale Standard Display Function electro-optical transfer function (EOTF).

eotf_H273_ST428_1(V)

Apply the SMPTE ST 428-1 (2019) electro-optical transfer function (EOTF) as specified in ITU-T H.273.

eotf_inverse_BT1886(L[, L_B, L_W])

Apply the Recommendation ITU-R BT.1886 inverse electro-optical transfer function (EOTF) for flat panel displays.

eotf_inverse_BT2100_HLG(F_D[, L_B, L_W, ...])

Apply the Recommendation ITU-R BT.2100 Reference HLG inverse electro-optical transfer function (EOTF).

eotf_inverse_BT2100_PQ(F_D)

Apply the Recommendation ITU-R BT.2100 Reference PQ inverse electro-optical transfer function (EOTF).

eotf_inverse_DCDM(XYZ[, out_int])

Apply the DCDM inverse electro-optical transfer function (EOTF).

eotf_inverse_DICOMGSDF(L[, out_int, constants])

Apply the DICOM - Grayscale Standard Display Function inverse electro-optical transfer function (EOTF).

eotf_inverse_H273_ST428_1(L_o)

Apply the SMPTE ST 428-1 (2019) inverse electro-optical transfer function (EOTF) as specified in ITU-T H.273.

eotf_inverse_sRGB(L)

Apply the IEC 61966-2-1:1999 sRGB inverse electro-optical transfer function (EOTF).

eotf_inverse_ST2084(C[, L_p, constants])

Apply the SMPTE ST 2084:2014 perceptual quantizer (PQ) inverse electro-optical transfer function (EOTF).

eotf_SMPTE240M(V_r)

Apply the SMPTE 240M electro-optical transfer function (EOTF).

eotf_sRGB(V)

Apply the IEC 61966-2-1:1999 sRGB electro-optical transfer function (EOTF).

eotf_ST2084(N[, L_p, constants])

Apply the SMPTE ST 2084:2014 perceptual quantizer (PQ) electro-optical transfer function (EOTF).

Opto-Optical Transfer Functions#

colour

ootf(value[, function])

Apply the specified opto-optical transfer function (OOTF).

ootf_inverse(value[, function])

Apply the specified inverse opto-optical transfer function (OOTF).

OOTF_INVERSES

Supported inverse opto-optical transfer functions (OOTFs / OOCFs).

OOTFS

Supported opto-optical transfer functions (OOTFs / OOCFs).

colour.models

BT2100_HLG_OOTF_INVERSE_METHODS

Support methods for the ITU-R BT.2100 Reference HLG inverse opto-optical transfer function (OOTF).

BT2100_HLG_OOTF_METHODS

Map Recommendation ITU-R BT.2100 Reference HLG opto-optical transfer function (OOTF) methods.

ootf_BT2100_HLG(E[, L_B, L_W, gamma, method])

Apply the Recommendation ITU-R BT.2100 Reference HLG opto-optical transfer function (OOTF).

ootf_BT2100_PQ(E)

Apply the Recommendation ITU-R BT.2100 Reference PQ opto-optical transfer function (OOTF).

ootf_inverse_BT2100_HLG(F_D[, L_B, L_W, ...])

Apply the Recommendation ITU-R BT.2100 Reference HLG inverse opto-optical transfer function (OOTF).

ootf_inverse_BT2100_PQ(F_D)

Apply the Recommendation ITU-R BT.2100 Reference PQ inverse opto-optical transfer function (OOTF).

Log Encoding and Decoding#

colour

log_decoding(value[, function])

Apply the specified log decoding inverse opto-electronic transfer function (OETF).

LOG_DECODINGS

Supported log decoding functions.

log_encoding(value[, function])

Apply the specified log encoding opto-electronic transfer function (OETF).

LOG_ENCODINGS

Supported log encoding functions.

colour.models

LOG3G10_DECODING_METHODS

Supported Log3G10 log decoding curve / electro-optical transfer (EOTF) function methods.

LOG3G10_ENCODING_METHODS

Supported Log3G10 log encoding curve / opto-electronic transfer (OETF) function methods.

log_decoding_ACEScc(ACEScc)

Apply the ACEScc log decoding inverse opto-electronic transfer function (OETF).

log_decoding_ACEScct(ACEScct[, constants])

Apply the ACEScct log decoding inverse opto-electronic transfer function (OETF).

log_decoding_ACESproxy(ACESproxy[, ...])

Apply the ACESproxy log decoding inverse opto-electronic transfer function (OETF).

log_decoding_AppleLogProfile(P[, constants])

Apply the Apple Log Profile log decoding inverse opto-electronic transfer function (OETF).

log_decoding_ARRILogC3(t[, firmware, method, EI])

Apply the ARRI LogC3 log decoding inverse opto-electronic transfer function (OETF).

log_decoding_CanonLog(clog[, bit_depth, ...])

Apply the Canon Log log decoding inverse opto-electronic transfer function (OETF).

log_decoding_CanonLog2(clog2[, bit_depth, ...])

Apply the Canon Log 2 log decoding inverse opto-electronic transfer function (OETF).

log_decoding_CanonLog3(clog3[, bit_depth, ...])

Apply the Canon Log 3 log decoding inverse opto-electronic transfer function (OETF).

log_decoding_Cineon(y[, black_offset])

Apply the Cineon log decoding inverse opto-electronic transfer function (OETF).

log_decoding_ERIMMRGB(X_p[, bit_depth, ...])

Apply the ERIMM RGB log decoding inverse opto-electronic transfer function (OETF).

log_decoding_FLog(out_r[, bit_depth, ...])

Apply the Fujifilm F-Log log decoding inverse opto-electronic transfer

log_decoding_FLog2(out_r[, bit_depth, ...])

Apply the Fujifilm F-Log2 log decoding inverse opto-electronic transfer function (OETF).

log_decoding_LLog(LLog[, bit_depth, ...])

Apply the Leica L-Log log decoding inverse opto-electronic transfer function (OETF).

log_decoding_Log2(log_norm[, middle_grey, ...])

Apply the common Log2 log decoding inverse opto-electronic transfer function (OETF).

log_decoding_Log3G10(y[, method])

Apply the Log3G10 log decoding inverse opto-electronic transfer function (OETF).

log_decoding_Log3G12(y)

Apply the Log3G12 log decoding inverse opto-electronic transfer function (OETF).

log_decoding_MiLog(P[, constants])

Apply the Xiaomi Mi-Log Profile log decoding inverse opto-electronic transfer function (OETF).

log_decoding_NLog(x[, bit_depth, ...])

Apply the Nikon N-Log log decoding inverse opto-electronic transfer function (OETF).

log_decoding_OPPOOLog(P[, constants])

Apply the OPPO O-Log Profile log decoding inverse opto-electronic transfer function (OETF).

log_decoding_Panalog(y[, black_offset])

Apply the Panalog log decoding inverse opto-electronic transfer function (OETF).

log_decoding_PivotedLog(y[, log_reference, ...])

Apply the Josh Pines style Pivoted Log log decoding inverse opto-electronic transfer function (OETF).

log_decoding_Protune(y)

Apply the Protune log decoding inverse opto-electronic transfer function (OETF).

log_decoding_REDLog(y[, black_offset])

Apply the REDLog log decoding inverse opto-electronic transfer function (OETF).

log_decoding_REDLogFilm(y[, black_offset])

Apply the REDLogFilm log decoding inverse opto-electronic transfer function (OETF).

log_decoding_SLog(y[, bit_depth, ...])

Apply the Sony S-Log log decoding inverse opto-electronic transfer function (OETF).

log_decoding_SLog2(y[, bit_depth, ...])

Apply the Sony S-Log2 log decoding inverse opto-electronic transfer function (OETF).

log_decoding_SLog3(y[, bit_depth, ...])

Apply the Sony S-Log3 log decoding inverse opto-electronic transfer function (OETF).

log_decoding_ViperLog(y)

Apply the Viper Log log decoding inverse opto-electronic transfer function (OETF).

log_decoding_VLog(V_out[, bit_depth, ...])

Apply the Panasonic V-Log log decoding inverse opto-electronic transfer

log_encoding_ACEScc(lin_AP1)

Apply the ACEScc log encoding opto-electronic transfer function (OETF).

log_encoding_ACEScct(lin_AP1[, constants])

Apply the ACEScct log encoding opto-electronic transfer function (OETF).

log_encoding_ACESproxy(lin_AP1[, bit_depth, ...])

Apply the ACESproxy log encoding opto-electronic transfer function (OETF).

log_encoding_AppleLogProfile(R[, constants])

Apply the Apple Log Profile log encoding opto-electronic transfer function (OETF).

log_encoding_ARRILogC3(x[, firmware, method, EI])

Apply the ARRI LogC3 log encoding opto-electronic transfer function (OETF).

log_encoding_CanonLog(x[, bit_depth, ...])

Apply the Canon Log log encoding opto-electronic transfer function (OETF).

log_encoding_CanonLog2(x[, bit_depth, ...])

Apply the Canon Log 2 log encoding opto-electronic transfer function (OETF).

log_encoding_CanonLog3(x[, bit_depth, ...])

Apply the Canon Log 3 log encoding opto-electronic transfer function (OETF).

log_encoding_Cineon(x[, black_offset])

Apply the Cineon log encoding opto-electronic transfer function (OETF).

log_encoding_ERIMMRGB(X[, bit_depth, ...])

Apply the ERIMM RGB log encoding opto-electronic transfer function (OETF).

log_encoding_FLog(in_r[, bit_depth, ...])

Apply the Fujifilm F-Log log encoding opto-electronic transfer function (OETF).

log_encoding_FLog2(in_r[, bit_depth, ...])

Apply the Fujifilm F-Log2 log encoding opto-electronic transfer function (OETF).

log_encoding_LLog(LSR[, bit_depth, ...])

Apply the Leica L-Log log encoding opto-electronic transfer function (OETF).

log_encoding_Log2(lin[, middle_grey, ...])

Apply the common Log2 log encoding opto-electronic transfer function (OETF).

log_encoding_Log3G10(x[, method])

Apply the Log3G10 log encoding opto-electronic transfer function (OETF).

log_encoding_Log3G12(x)

Apply the Log3G12 log encoding opto-electronic transfer function (OETF).

log_encoding_MiLog(R[, constants])

Apply the Xiaomi Mi-Log Profile log encoding opto-electronic transfer function (OETF).

log_encoding_NLog(y[, bit_depth, ...])

Apply the Nikon N-Log log encoding opto-electronic transfer function (OETF).

log_encoding_OPPOOLog(R[, constants])

Apply the OPPO O-Log Profile log encoding opto-electronic transfer function (OETF).

log_encoding_Panalog(x[, black_offset])

Apply the Panalog log encoding opto-electronic transfer function (OETF).

log_encoding_PivotedLog(x[, log_reference, ...])

Apply the Josh Pines style Pivoted Log log encoding opto-electronic transfer function (OETF).

log_encoding_Protune(x)

Apply the Protune log encoding opto-electronic transfer function (OETF).

log_encoding_REDLog(x[, black_offset])

Apply the REDLog log encoding opto-electronic transfer function (OETF).

log_encoding_REDLogFilm(x[, black_offset])

Apply the REDLogFilm log encoding opto-electronic transfer function (OETF).

log_encoding_SLog(x[, bit_depth, ...])

Apply the Sony S-Log log encoding opto-electronic transfer function (OETF).

log_encoding_SLog2(x[, bit_depth, ...])

Apply the Sony S-Log2 log encoding opto-electronic transfer function (OETF).

log_encoding_SLog3(x[, bit_depth, ...])

Apply the Sony S-Log3 log encoding opto-electronic transfer function (OETF).

log_encoding_ViperLog(x)

Apply the Viper Log log encoding opto-electronic transfer function (OETF).

log_encoding_VLog(L_in[, bit_depth, ...])

Apply the Panasonic V-Log log encoding opto-electronic transfer function (OETF).

Colour Encodings#

Y’CbCr Colour Encoding#

colour

matrix_YCbCr([K, S, bits, is_legal, is_int])

Compute the Y'CbCr to R'G'B' matrix for the specified weights, bit-depth, range legality and representation.

offset_YCbCr([bits, is_legal, is_int])

Compute the R'G'B' to Y'CbCr offsets for the specified bit-depth, range legality and representation.

RGB_to_YCbCr(RGB[, K, S, in_bits, in_legal, ...])

Convert an array of R'G'B' values to the corresponding Y'CbCr colour encoding values array.

RGB_to_YcCbcCrc(RGB[, out_bits, out_legal, ...])

Convert an array of RGB linear values to the corresponding Yc'Cbc'Crc' colour encoding values array.

SCALES_YCBCR

Represent a delimiter and case-insensitive dict-like object supporting both slug keys (SEO-friendly, human-readable versions with delimiters) and canonical keys (slugified keys without delimiters).

WEIGHTS_YCBCR

Represent a delimiter and case-insensitive dict-like object supporting both slug keys (SEO-friendly, human-readable versions with delimiters) and canonical keys (slugified keys without delimiters).

YCbCr_to_RGB(YCbCr[, K, S, in_bits, ...])

Convert an array of Y'CbCr colour encoding values to the corresponding R'G'B' values array.

YcCbcCrc_to_RGB(YcCbcCrc[, in_bits, ...])

Convert an array of Yc'Cbc'Crc' colour encoding values to the corresponding RGB array of linear values.

Ancillary Objects

colour

CV_range([bit_depth, is_legal, is_int])

Return the code value \(CV\) range for the specified bit-depth, range legality and representation.

full_to_legal(CV[, bit_depth, in_int, out_int])

Convert the specified code value \(CV\) or float equivalent of a code value at a specified bit-depth from full range (full swing) to legal range (studio swing).

legal_to_full(CV[, bit_depth, in_int, out_int])

Convert the specified code value \(CV\) or float equivalent of a code value at a specified bit-depth from legal range (studio swing) to full range (full swing).

YCoCg Colour Encoding#

colour

RGB_to_YCoCg(RGB)

Convert an array of R'G'B' values to the corresponding YCoCg colour encoding values array.

YCoCg_to_RGB(YCoCg)

Convert an array of YCoCg colour encoding values to the corresponding R'G'B' values array.

\(IC_TC_P\) Colour Encoding#

colour

ICtCp_to_RGB(ICtCp[, method, L_p])

Convert from \(IC_TC_P\) colour encoding to ITU-R BT.2020 colourspace.

ICtCp_to_XYZ(ICtCp[, illuminant, ...])

Convert from \(IC_TC_P\) colour encoding to CIE XYZ tristimulus values.

RGB_to_ICtCp(RGB[, method, L_p])

Convert from ITU-R BT.2020 colourspace to \(IC_TC_P\) colour encoding.

XYZ_to_ICtCp(XYZ[, illuminant, ...])

Convert from CIE XYZ tristimulus values to \(IC_TC_P\) colour encoding.

RGB Representations#

Prismatic Colourspace#

colour

Prismatic_to_RGB(Lrgb)

Convert from Prismatic \(L\rho\gamma\beta\) colourspace array to RGB colourspace.

RGB_to_Prismatic(RGB)

Convert from RGB colourspace to Prismatic \(L\rho\gamma\beta\) colourspace array.

HSV Colourspace#

colour

HSV_to_RGB(HSV)

Convert from HSV colourspace to RGB colourspace.

RGB_to_HSV(RGB)

Convert from RGB colourspace to HSV colourspace.

HSL Colourspace#

colour

HSL_to_RGB(HSL)

Convert from HSL colourspace to RGB colourspace.

RGB_to_HSL(RGB)

Convert from RGB colourspace to HSL colourspace.

HCL Colourspace#

colour

HCL_to_RGB(HCL[, gamma, Y_0])

Convert from HCL colourspace to RGB colourspace according to Sarifuddin and Missaoui (2005) method.

RGB_to_HCL(RGB[, gamma, Y_0])

Convert from RGB colourspace to HCL colourspace according to Sarifuddin and Missaoui (2005) method.

CMY Colourspace#

colour

CMY_to_CMYK(CMY)

Convert from CMY colourspace to CMYK colourspace.

CMY_to_RGB(CMY)

Convert from CMY colourspace to RGB colourspace.

CMYK_to_CMY(CMYK)

Convert from CMYK colourspace to CMY colourspace.

RGB_to_CMY(RGB)

Convert from RGB colourspace to CMY colourspace.

IHLS - Hanbury (2003)#

colour

IHLS_to_RGB(HYS)

Convert from IHLS (Improved HLS) colourspace to RGB colourspace.

RGB_to_IHLS(RGB)

Convert from RGB colourspace to IHLS (Improved HLS) colourspace.

Recommendation ITU-T H.273 Code points for Video Signal Type Identification#

colour

COLOUR_PRIMARIES_ITUTH273

ColourPrimaries indicates the chromaticity coordinates of the source colour primaries as specified in Table 3 of [InternationalOfStandardization21] and [InternationalTUnion21] in terms of the CIE 1931 definition of x and y, which shall be interpreted as specified by ISO/ CIE 11664-1.

MATRIX_COEFFICIENTS_ITUTH273

MatrixCoefficients describes the matrix coefficients used in deriving luma and chroma signals from the green, blue and red or X, Y and Z primaries, as specified in Table 4 and equations 11 to 77 of [InternationalOfStandardization21] and [InternationalTUnion21].

TRANSFER_CHARACTERISTICS_ITUTH273

TransferCharacteristics, as specified in Table 3 of [InternationalOfStandardization21] and [InternationalTUnion21], either indicates the reference opto-electronic transfer characteristic function of the source picture as a function of a source input linear optical intensity input Lc with a nominal real-valued range of 0 to 1 or indicates the inverse of the reference electro-optical transfer characteristic function as a function of an output linear optical intensity Lo with a nominal real-valued range of 0 to 1.

Ancillary Objects

colour.models

describe_video_signal_colour_primaries(...)

Describe the specified video signal colour primaries code point.

describe_video_signal_matrix_coefficients(...)

Describe the specified video signal matrix coefficients code point.

describe_video_signal_transfer_characteristics(...)

Describe the specified video signal transfer characteristics code point.

Pointer’s Gamut#

colour

CCS_ILLUMINANT_POINTER_GAMUT

ndarray(shape, dtype=float, buffer=None, offset=0,

CCS_POINTER_GAMUT_BOUNDARY

ndarray(shape, dtype=float, buffer=None, offset=0,

DATA_POINTER_GAMUT_VOLUME

ndarray(shape, dtype=float, buffer=None, offset=0,