Colour Models ============= CIE Models ---------- CIE xyY Colourspace ~~~~~~~~~~~~~~~~~~~ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ xy_to_xyY xy_to_XYZ xyY_to_xy xyY_to_XYZ XYZ_to_xy XYZ_to_xyY CIE L*a*b* Colourspace ~~~~~~~~~~~~~~~~~~~~~~ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ Lab_to_XYZ XYZ_to_Lab CIE L*u*v* Colourspace ~~~~~~~~~~~~~~~~~~~~~~ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ CIE1976UCS_to_XYZ Luv_to_uv Luv_to_XYZ Luv_uv_to_xy uv_to_Luv xy_to_Luv_uv XYZ_to_CIE1976UCS XYZ_to_Luv CIE 1960 UCS Colourspace ~~~~~~~~~~~~~~~~~~~~~~~~ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ CIE1960UCS_to_XYZ UCS_to_uv UCS_to_XYZ UCS_uv_to_xy uv_to_UCS xy_to_UCS_uv XYZ_to_CIE1960UCS XYZ_to_UCS CIE 1964 U*V*W* Colourspace ~~~~~~~~~~~~~~~~~~~~~~~~~~~ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ UVW_to_XYZ XYZ_to_UVW Colourspace Models ------------------ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ COLOURSPACE_MODELS CAM02-LCD, CAM02-SCD, and CAM02-UCS Colourspaces - Luo, Cui and Li (2006) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ CAM02LCD_to_JMh_CIECAM02 CAM02LCD_to_XYZ CAM02SCD_to_JMh_CIECAM02 CAM02SCD_to_XYZ CAM02UCS_to_JMh_CIECAM02 CAM02UCS_to_XYZ JMh_CIECAM02_to_CAM02LCD JMh_CIECAM02_to_CAM02SCD JMh_CIECAM02_to_CAM02UCS XYZ_to_CAM02LCD XYZ_to_CAM02SCD XYZ_to_CAM02UCS CAM16-LCD, CAM16-SCD, and CAM16-UCS Colourspaces - Li et al. (2017) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ CAM16LCD_to_JMh_CAM16 CAM16LCD_to_XYZ CAM16SCD_to_JMh_CAM16 CAM16SCD_to_XYZ CAM16UCS_to_JMh_CAM16 CAM16UCS_to_XYZ JMh_CAM16_to_CAM16LCD JMh_CAM16_to_CAM16SCD JMh_CAM16_to_CAM16UCS XYZ_to_CAM16LCD XYZ_to_CAM16SCD XYZ_to_CAM16UCS DIN99 Colourspace and DIN99b, DIN99c, DIN99d Refined Formulas ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ DIN99_to_Lab DIN99_to_XYZ Lab_to_DIN99 XYZ_to_DIN99 Hunter L,a,b Colour Scale ~~~~~~~~~~~~~~~~~~~~~~~~~ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ Hunter_Lab_to_XYZ XYZ_to_Hunter_Lab XYZ_to_K_ab_HunterLab1966 Hunter Rd,a,b Colour Scale ~~~~~~~~~~~~~~~~~~~~~~~~~~ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ Hunter_Rdab_to_XYZ XYZ_to_Hunter_Rdab :math:`IC_AC_B` Colourspace ~~~~~~~~~~~~~~~~~~~~~~~~~~~ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ ICaCb_to_XYZ XYZ_to_ICaCb :math:`I_GP_GT_G` Colourspace ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ IgPgTg_to_XYZ XYZ_to_IgPgTg IPT Colourspace ~~~~~~~~~~~~~~~ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ IPT_to_XYZ XYZ_to_IPT **Ancillary Objects** ``colour.models`` .. currentmodule:: colour.models .. autosummary:: :toctree: generated/ IPT_hue_angle hdr-CIELAB Colourspace ~~~~~~~~~~~~~~~~~~~~~~ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ HDR_CIELAB_METHODS hdr_CIELab_to_XYZ XYZ_to_hdr_CIELab hdr-IPT Colourspace ~~~~~~~~~~~~~~~~~~~ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ HDR_IPT_METHODS hdr_IPT_to_XYZ XYZ_to_hdr_IPT :math:`Jzazbz` Colourspace ~~~~~~~~~~~~~~~~~~~~~~~~~~ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ Jzazbz_to_XYZ XYZ_to_Jzazbz **Ancillary Objects** ``colour.models`` .. currentmodule:: colour.models .. autosummary:: :toctree: generated/ IZAZBZ_METHODS Izazbz_to_XYZ XYZ_to_Izazbz Oklab Colourspace ~~~~~~~~~~~~~~~~~ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ Oklab_to_XYZ XYZ_to_Oklab OSA UCS Colourspace ~~~~~~~~~~~~~~~~~~~ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ OSA_UCS_to_XYZ XYZ_to_OSA_UCS ProLab Colourspace ~~~~~~~~~~~~~~~~~~ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ ProLab_to_XYZ XYZ_to_ProLab Ragoo and Farup (2021) Optimised IPT Colourspace ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ IPT_Ragoo2021_to_XYZ XYZ_to_IPT_Ragoo2021 sUCS Colourspace ~~~~~~~~~~~~~~~~ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ sUCS_to_XYZ XYZ_to_sUCS **Ancillary Objects** ``colour.models`` .. currentmodule:: colour.models .. autosummary:: :toctree: generated/ sUCS_chroma sUCS_hue_angle sUCS_Iab_to_sUCS_ICh sUCS_ICh_to_sUCS_Iab Yrg Colourspace - Kirk (2019) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ XYZ_to_Yrg Yrg_to_XYZ ``colour.models`` .. currentmodule:: colour.models .. autosummary:: :toctree: generated/ LMS_to_Yrg Yrg_to_LMS Polar Transformations --------------------- ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ COLOURSPACE_MODELS_POLAR_CONVERSIONS hdr_CIELab_to_hdr_CIELCHab hdr_CIELCHab_to_hdr_CIELab hdr_ICH_to_hdr_IPT hdr_IPT_to_hdr_ICH Hunter_Lab_to_Hunter_LCHab Hunter_LCHab_to_Hunter_Lab Hunter_Rdab_to_Hunter_RdCHab Hunter_RdCHab_to_Hunter_Rdab ICaCb_to_ICHab ICH_Ragoo2021_to_IPT_Ragoo2021 ICH_to_IPT ICHab_to_ICaCb ICHtp_to_ICtCp ICtCp_to_ICHtp IgCHpt_to_IgPgTg IgPgTg_to_IgCHpt IPT_Ragoo2021_to_ICH_Ragoo2021 IPT_to_ICH Izazbz_to_IzCHab IzCHab_to_Izazbz Jzazbz_to_JzCHab JzCHab_to_Jzazbz Lab_to_LCHab LCHab_to_Lab LCHuv_to_Luv Luv_to_LCHuv Oklab_to_Oklch Oklch_to_Oklab ProLab_to_ProLCHab ProLCHab_to_ProLab Helper Functions ---------------- ``colour.models`` .. currentmodule:: colour.models .. autosummary:: :toctree: generated/ Iab_to_XYZ Jab_to_JCh JCh_to_Jab XYZ_to_Iab RGB Colourspace and Transformations ----------------------------------- ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ matrix_RGB_to_RGB RGB_to_RGB RGB_to_XYZ XYZ_to_RGB **Ancillary Objects** ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ sRGB_to_XYZ XYZ_to_sRGB RGB Colourspace Derivation ~~~~~~~~~~~~~~~~~~~~~~~~~~ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ chromatically_adapted_primaries normalised_primary_matrix primaries_whitepoint RGB_luminance RGB_luminance_equation RGB Colourspaces ~~~~~~~~~~~~~~~~ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ :template: class.rst RGB_Colourspace .. autosummary:: :toctree: generated/ RGB_COLOURSPACES ``colour.models`` .. currentmodule:: colour.models .. autosummary:: :toctree: generated/ RGB_COLOURSPACE_ACES2065_1 RGB_COLOURSPACE_ACESCC RGB_COLOURSPACE_ACESCG RGB_COLOURSPACE_ACESPROXY RGB_COLOURSPACE_ADOBE_RGB1998 RGB_COLOURSPACE_ADOBE_WIDE_GAMUT_RGB RGB_COLOURSPACE_APPLE_RGB RGB_COLOURSPACE_ARRI_WIDE_GAMUT_3 RGB_COLOURSPACE_ARRI_WIDE_GAMUT_4 RGB_COLOURSPACE_BEST_RGB RGB_COLOURSPACE_BETA_RGB RGB_COLOURSPACE_BLACKMAGIC_WIDE_GAMUT RGB_COLOURSPACE_BT2020 RGB_COLOURSPACE_BT470_525 RGB_COLOURSPACE_BT470_625 RGB_COLOURSPACE_BT709 RGB_COLOURSPACE_CIE_RGB RGB_COLOURSPACE_CINEMA_GAMUT RGB_COLOURSPACE_COLOR_MATCH_RGB RGB_COLOURSPACE_DAVINCI_WIDE_GAMUT RGB_COLOURSPACE_DCDM_XYZ RGB_COLOURSPACE_DCI_P3 RGB_COLOURSPACE_DCI_P3_P RGB_COLOURSPACE_DISPLAY_P3 RGB_COLOURSPACE_DJI_D_GAMUT RGB_COLOURSPACE_DON_RGB_4 RGB_COLOURSPACE_DRAGON_COLOR RGB_COLOURSPACE_DRAGON_COLOR_2 RGB_COLOURSPACE_EBU_3213_E RGB_COLOURSPACE_ECI_RGB_V2 RGB_COLOURSPACE_EKTA_SPACE_PS_5 RGB_COLOURSPACE_ERIMM_RGB RGB_COLOURSPACE_F_GAMUT RGB_COLOURSPACE_F_GAMUT_C RGB_COLOURSPACE_FILMLIGHT_E_GAMUT RGB_COLOURSPACE_G18_REC709_SCENE RGB_COLOURSPACE_G22_ADOBERGB_SCENE RGB_COLOURSPACE_G22_AP1_SCENE RGB_COLOURSPACE_G22_REC709_SCENE RGB_COLOURSPACE_H273_22_UNSPECIFIED RGB_COLOURSPACE_H273_GENERIC_FILM RGB_COLOURSPACE_LIN_ADOBERGB_SCENE RGB_COLOURSPACE_LIN_CIEXYZD65_SCENE RGB_COLOURSPACE_LIN_P3D65_SCENE RGB_COLOURSPACE_LIN_REC2020_SCENE RGB_COLOURSPACE_LIN_REC709_SCENE RGB_COLOURSPACE_MAX_RGB RGB_COLOURSPACE_N_GAMUT RGB_COLOURSPACE_NTSC1953 RGB_COLOURSPACE_NTSC1987 RGB_COLOURSPACE_P3_D65 RGB_COLOURSPACE_PAL_SECAM RGB_COLOURSPACE_PLASA_ANSI_E154 RGB_COLOURSPACE_PROPHOTO_RGB RGB_COLOURSPACE_PROTUNE_NATIVE RGB_COLOURSPACE_RED_COLOR RGB_COLOURSPACE_RED_COLOR_2 RGB_COLOURSPACE_RED_COLOR_3 RGB_COLOURSPACE_RED_COLOR_4 RGB_COLOURSPACE_RED_WIDE_GAMUT_RGB RGB_COLOURSPACE_RIMM_RGB RGB_COLOURSPACE_ROMM_RGB RGB_COLOURSPACE_RUSSELL_RGB RGB_COLOURSPACE_S_GAMUT RGB_COLOURSPACE_S_GAMUT3 RGB_COLOURSPACE_S_GAMUT3_CINE RGB_COLOURSPACE_SHARP_RGB RGB_COLOURSPACE_SMPTE_240M RGB_COLOURSPACE_SMPTE_C RGB_COLOURSPACE_sRGB RGB_COLOURSPACE_SRGB_AP1_SCENE RGB_COLOURSPACE_SRGB_P3D65_SCENE RGB_COLOURSPACE_SRGB_REC709_SCENE RGB_COLOURSPACE_V_GAMUT RGB_COLOURSPACE_VENICE_S_GAMUT3 RGB_COLOURSPACE_VENICE_S_GAMUT3_CINE RGB_COLOURSPACE_XTREME_RGB RGB_COLOURSPACES_TEXTURE_ASSETS_AND_CG_RENDERING_CIF Colour Component Transfer Functions ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ cctf_decoding CCTF_DECODINGS cctf_encoding CCTF_ENCODINGS gamma_function linear_function ``colour.models`` .. currentmodule:: colour.models .. autosummary:: :toctree: generated/ cctf_decoding_RIMMRGB cctf_decoding_ROMMRGB cctf_encoding_RIMMRGB cctf_encoding_ROMMRGB **Aliases** ``colour.models`` .. currentmodule:: colour.models .. autosummary:: :toctree: generated/ cctf_decoding_ProPhotoRGB cctf_encoding_ProPhotoRGB **Ancillary Objects** ``colour.models`` .. currentmodule:: colour.models .. autosummary:: :toctree: generated/ exponent_function_basic exponent_function_monitor_curve logarithmic_function_basic logarithmic_function_camera logarithmic_function_quasilog Opto-Electronic Transfer Functions ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ oetf oetf_inverse OETF_INVERSES OETFS ``colour.models`` .. currentmodule:: colour.models .. autosummary:: :toctree: generated/ oetf_ARIBSTDB67 oetf_BlackmagicFilmGeneration5 oetf_BT2020 oetf_BT2100_HLG oetf_BT2100_PQ oetf_BT601 oetf_BT709 oetf_DaVinciIntermediate oetf_H273_IEC61966_2 oetf_H273_Log oetf_H273_LogSqrt oetf_inverse_ARIBSTDB67 oetf_inverse_BlackmagicFilmGeneration5 oetf_inverse_BT2020 oetf_inverse_BT2100_HLG oetf_inverse_BT2100_PQ oetf_inverse_BT601 oetf_inverse_BT709 oetf_inverse_DaVinciIntermediate oetf_inverse_H273_IEC61966_2 oetf_inverse_H273_Log oetf_inverse_H273_LogSqrt oetf_SMPTE240M Electro-Optical Transfer Functions ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ eotf eotf_inverse EOTF_INVERSES EOTFS ``colour.models`` .. currentmodule:: colour.models .. autosummary:: :toctree: generated/ BT2100_HLG_EOTF_INVERSE_METHODS BT2100_HLG_EOTF_METHODS eotf_BT1886 eotf_BT2100_HLG eotf_BT2100_PQ eotf_DCDM eotf_DICOMGSDF eotf_H273_ST428_1 eotf_inverse_BT1886 eotf_inverse_BT2100_HLG eotf_inverse_BT2100_PQ eotf_inverse_DCDM eotf_inverse_DICOMGSDF eotf_inverse_H273_ST428_1 eotf_inverse_sRGB eotf_inverse_ST2084 eotf_SMPTE240M eotf_sRGB eotf_ST2084 Opto-Optical Transfer Functions ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ ootf ootf_inverse OOTF_INVERSES OOTFS ``colour.models`` .. currentmodule:: colour.models .. autosummary:: :toctree: generated/ BT2100_HLG_OOTF_INVERSE_METHODS BT2100_HLG_OOTF_METHODS ootf_BT2100_HLG ootf_BT2100_PQ ootf_inverse_BT2100_HLG ootf_inverse_BT2100_PQ Log Encoding and Decoding ~~~~~~~~~~~~~~~~~~~~~~~~~ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ log_decoding LOG_DECODINGS log_encoding LOG_ENCODINGS ``colour.models`` .. currentmodule:: colour.models .. autosummary:: :toctree: generated/ LOG3G10_DECODING_METHODS LOG3G10_ENCODING_METHODS log_decoding_ACEScc log_decoding_ACEScct log_decoding_ACESproxy log_decoding_AppleLogProfile log_decoding_ARRILogC3 log_decoding_CanonLog log_decoding_CanonLog2 log_decoding_CanonLog3 log_decoding_Cineon log_decoding_ERIMMRGB log_decoding_FLog log_decoding_FLog2 log_decoding_LLog log_decoding_Log2 log_decoding_Log3G10 log_decoding_Log3G12 log_decoding_MiLog log_decoding_NLog log_decoding_Panalog log_decoding_PivotedLog log_decoding_Protune log_decoding_REDLog log_decoding_REDLogFilm log_decoding_SLog log_decoding_SLog2 log_decoding_SLog3 log_decoding_ViperLog log_decoding_VLog log_encoding_ACEScc log_encoding_ACEScct log_encoding_ACESproxy log_encoding_AppleLogProfile log_encoding_ARRILogC3 log_encoding_CanonLog log_encoding_CanonLog2 log_encoding_CanonLog3 log_encoding_Cineon log_encoding_ERIMMRGB log_encoding_FLog log_encoding_FLog2 log_encoding_LLog log_encoding_Log2 log_encoding_Log3G10 log_encoding_Log3G12 log_encoding_MiLog log_encoding_NLog log_encoding_Panalog log_encoding_PivotedLog log_encoding_Protune log_encoding_REDLog log_encoding_REDLogFilm log_encoding_SLog log_encoding_SLog2 log_encoding_SLog3 log_encoding_ViperLog log_encoding_VLog Colour Encodings ~~~~~~~~~~~~~~~~ Y'CbCr Colour Encoding ^^^^^^^^^^^^^^^^^^^^^^ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ matrix_YCbCr offset_YCbCr RGB_to_YCbCr RGB_to_YcCbcCrc WEIGHTS_YCBCR YCbCr_to_RGB YcCbcCrc_to_RGB **Ancillary Objects** ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ CV_range full_to_legal legal_to_full YCoCg Colour Encoding ^^^^^^^^^^^^^^^^^^^^^ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ RGB_to_YCoCg YCoCg_to_RGB :math:`IC_TC_P` Colour Encoding ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ ICtCp_to_RGB ICtCp_to_XYZ RGB_to_ICtCp XYZ_to_ICtCp RGB Representations ~~~~~~~~~~~~~~~~~~~ Prismatic Colourspace ^^^^^^^^^^^^^^^^^^^^^ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ Prismatic_to_RGB RGB_to_Prismatic HSV Colourspace ^^^^^^^^^^^^^^^ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ HSV_to_RGB RGB_to_HSV HSL Colourspace ^^^^^^^^^^^^^^^ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ HSL_to_RGB RGB_to_HSL HCL Colourspace ^^^^^^^^^^^^^^^ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ HCL_to_RGB RGB_to_HCL CMY Colourspace ^^^^^^^^^^^^^^^ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ CMY_to_CMYK CMY_to_RGB CMYK_to_CMY RGB_to_CMY IHLS - Hanbury (2003) ^^^^^^^^^^^^^^^^^^^^^ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ IHLS_to_RGB RGB_to_IHLS Recommendation ITU-T H.273 Code points for Video Signal Type Identification ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ``colour`` .. currentmodule:: colour .. autosummary:: :toctree: generated/ COLOUR_PRIMARIES_ITUTH273 MATRIX_COEFFICIENTS_ITUTH273 TRANSFER_CHARACTERISTICS_ITUTH273 **Ancillary Objects** ``colour.models`` .. currentmodule:: colour.models .. autosummary:: :toctree: generated/ describe_video_signal_colour_primaries describe_video_signal_matrix_coefficients describe_video_signal_transfer_characteristics Pointer's Gamut --------------- ``colour`` .. currentmodule:: colour.models .. autosummary:: :toctree: generated/ CCS_ILLUMINANT_POINTER_GAMUT CCS_POINTER_GAMUT_BOUNDARY DATA_POINTER_GAMUT_VOLUME