计算机视觉人工智能深度学习图像处理【免费下载链接】kornia Geometric Computer Vision Library for Spatial AI项目地址https://gitcode.com/gh_mirrors/ko/kornia点击查看免费下载本文以 docs/source/color.xyz.rst 为骨架结合 Kornia 源码与测试系统讲解 CIE 1931 XYZ 颜色空间在 Kornia 中的实现RGB↔XYZ 的数学原理、D65 白点下的 3×3 转换矩阵、函数式与模块式两套 API、底层设备感知的线性变换优化以及它与 Lab/Luv 颜色空间的上下游关系。一、导读CIE XYZ 是国际照明委员会CIE于 1931 年提出的颜色空间它用三个虚拟原色X、Y、Z描述人眼对颜色的感知是所有基于设备无关device-independent颜色转换的基石。在 Kornia 中RGB 与 XYZ 的互转由 kornia/color/xyz.py 提供包括rgb_to_xyz/xyz_to_rgb两个函数和RgbToXyz/XyzToRgb两个nn.Module封装。读完本文你将掌握XYZ 与 RGB 转换的矩阵原理、两套 API 的完整用法、输入约束形状、dtype、数值范围与异常行为、Kornia 底层线性变换的 CPU/GPU 双路径实现以及 XYZ 作为中间空间在 Lab、Luv 转换中的枢纽地位。二、CIE XYZ 颜色空间与转换矩阵原理2.1 什么是 CIE XYZCIE XYZ 基于 CIE 1931 标准观察者Standard Observer的色匹配函数建立用数学上构造的 X、Y、Z 三个分量覆盖整个人眼可见色域其中 Y 分量对应亮度luminance。由于 XYZ 与具体显示设备无关它经常被用作中间表示从设备相关的 sRGB 出发先转到 XYZ再转到 Lab、Luv 等感知均匀空间或与色温、白点如 D65等光照信息结合做色彩管理。2.2 RGB→XYZ 与 XYZ→RGB 的矩阵在 Kornia 的实现中RGB 与 XYZ 的转换采用线性 3×3 矩阵假设 sRGB 输入已经过 gamma 解码即线性 RGB并在D65 白点D65 White Point对应色温约 6504K是 sRGB 的标准白点下定义。正向矩阵定义在 kornia/color/xyz.py#L48-L58kernel torch.tensor( [ [0.412453, 0.357580, 0.180423], [0.212671, 0.715160, 0.072169], [0.019334, 0.119193, 0.950227], ], ... )即X 0.412453·R 0.357580·G 0.180423·B Y 0.212671·R 0.715160·G 0.072169·B Z 0.019334·R 0.119193·G 0.950227·B反向矩阵XYZ→RGB定义在同文件 kornia/color/xyz.py#L83-L91精度更高的小数位用于保证往返round-trip误差足够小kernel torch.tensor( [ [3.2404813432005266, -1.5371515162713185, -0.4985363261688878], [-0.9692549499965682, 1.8759900014898907, 0.0415559265582928], [0.0556466391351772, -0.2040413383665112, 1.0573110696453443], ], ... )注意正向矩阵每一行的和分别为 0.950456、1.0、1.088830对应 D65 白点的 X、Y、Z 归一化值这与 kornia/color/lab.py#L66 中使用的[0.95047, 1.0, 1.08883]白点参考完全一致。该矩阵与 OpenCV 的cv2.cvtColor(..., cv2.COLOR_RGB2XYZ)标准一致源码 docstring 也直接引用了 OpenCV 颜色转换文档作为参考见 RgbToXyz 的 Reference 字段。2.3 输入前提线性 RGB 与范围假设RgbToXyz模块的 docstring 明确指出图像数据假定在 (0, 1) 范围内见 kornia/color/xyz.py#L100因此输入应是线性 RGB若要处理 sRGB 编码图像需要先用rgb_to_linear_rgb做 gamma 解码Kornia 在 kornia/color/rgb.py 中提供该函数数值建议在 [0, 1] 区间超出范围时转换结果不会自动裁剪函数内部不执行 clamp。三、函数式 APIrgb_to_xyz 与 xyz_to_rgb3.1 函数签名与返回值import torch import kornia input torch.rand(2, 3, 4, 5) # (B, C3, H, W) output kornia.color.rgb_to_xyz(input) # 2x3x4x5输入形状(*, 3, H, W)其中*表示任意数量的前置维度例如 batch 维度3对应 RGB/XYZ 三个通道H、W为高宽输出形状与输入完全一致(*, 3, H, W)返回XYZ 版本图像张量。xyz_to_rgb的用法完全对称rgb kornia.color.xyz_to_rgb(output) # 恢复为 RGB3.2 输入校验类型与形状检查两个函数在计算前都会执行 Kornia 的运行时检查见 kornia/color/xyz.py#L45-L46KORNIA_CHECK_IS_TENSOR(image) KORNIA_CHECK_SHAPE(image, [*, 3, H, W])非torch.Tensor输入会抛出TypeCheckError通道数不为 3或维度不足的输入会抛出ShapeError。测试 tests/color/test_xyz.py#L49-L61 明确验证了这两类异常with pytest.raises(TypeCheckError): assert kornia.color.rgb_to_xyz([0.0]) # 列表输入 → 类型错误 with pytest.raises(ShapeError): img torch.ones(1, 1, devicedevice, dtypedtype) assert kornia.color.rgb_to_xyz(img) # 通道数不为 3 → 形状错误3.3 dtype 处理整数输入与 float64 精度源码在构造 kernel 时做了 dtype 适配kornia/color/xyz.py#L49dtype image.dtype if image.is_floating_point() else torch.float32浮点输入float16/float32/float64kernel 与输入保持同 dtype因此float64 输入可以完整保留矩阵精度整数输入如 int32/int64自动提升为 float32 参与运算。对应测试 tests/color/test_xyz.py#L121-L135 验证了整数输入输出为 float32且数值与 float64 矩阵完全一致。四、模块式 APIRgbToXyz 与 XyzToRgbnn.Module4.1 使用方式模块式 API 适用于需要嵌入nn.Sequential、nn.Module或参与自动微分/模型导出的场景import torch from kornia.color import RgbToXyz, XyzToRgb input torch.rand(2, 3, 4, 5) xyz RgbToXyz() output xyz(input) # 2x3x4x5 rgb XyzToRgb() recovered rgb(output) # 2x3x4x5两个模块的forward只是对函数式 API 的薄封装见 kornia/color/xyz.py#L122-L133 与 kornia/color/xyz.py#L159-L170本身不包含可训练参数因此不会引入额外状态。4.2 ONNX 导出支持两个模块都声明了 ONNX 默认输入/输出形状kornia/color/xyz.py#L119-L120ONNX_DEFAULT_INPUTSHAPE: ClassVar[list[int]] [-1, 3, -1, -1] ONNX_DEFAULT_OUTPUTSHAPE: ClassVar[list[int]] [-1, 3, -1, -1]这说明 RGB↔XYZ 转换可以被导出为 ONNX 模型NCHW 布局N 与 H、W 维度动态适合部署到推理后端。Kornia 的 ONNX 导出支持体系见 kornia/onnx 目录。4.3 与函数式 API 的一致性保证测试 tests/color/test_xyz.py#L157-L162 专门断言了模块与函数的输出一致ops kornia.color.RgbToXyz().to(device, dtype) fcn kornia.color.rgb_to_xyz self.assert_close(ops(img), fcn(img))五、底层实现设备感知的线性变换_apply_linear_transformationrgb_to_xyz与xyz_to_rgb都通过 kornia/color/utils.py#L24-L70 中的_apply_linear_transformation完成 3×3 通道线性变换。该函数是 Kornia 颜色模块的公共基础设施同样被 Lab、Luv 等模块复用其核心是按设备分支选择最优算子if image_compute.device.type cpu or image_compute.numel() 0: out torch.einsum(oi, ...ihw - ...ohw, kernel_compute, image_compute) ... else: # GPU / CUDA input_flat image_compute.reshape(-1, 3, H, W) weight kernel_compute.view(3, 3, 1, 1) out_flat F.conv2d(input_flat, weight, biasbias_compute) ...CPU 路径使用torch.einsum代码注释kornia/color/utils.py#L49-L53说明其经验基准测试中在 CPU 上更快且对任意空形状empty tensor都有良好支持张量始终保留在计算图中GPU/加速器路径将 (3,3) kernel 视为 1×1 卷积权重调用F.conv2d在 CUDA 上可显著加速输入先reshape为 (B*, 3, H, W) 再展平回原形状整数输入在函数入口处先安全转 floatimage_compute image.float()见 kornia/color/utils.py#L39-L42kernel 与 bias 的 dtype/device 都会对齐到输入张量kornia/color/utils.py#L45-L46从而在 float64 输入下传播高精度。六、测试与质量保证测试/color/test_xyz.py 对 RGB↔XYZ 转换做了全面的测试覆盖可作为如何验证颜色转换正确性的参考范式测试维度说明对应测试Smoke 测试确认输出为 Tensortest_smoke形状保持任意前置维度(1,3,4,4)、(2,3,2,4)、(3,3,4,1)、(3,2,1)下输出形状不变test_cardinality数值正确性与 OpenCVcv2.cvtColor(data, cv2.COLOR_RGB2XYZ)生成的参考输出对比test_unit异常行为类型错误、通道数错误均抛异常test_exception往返一致性xyz_to_rgb(rgb_to_xyz(x)) ≈ xtest_forth_and_back梯度检查gradcheck验证可微性test_gradcheckJIT 兼容torch.jit.script结果一致test_jit模块/函数一致性RgbToXyz与rgb_to_xyz输出一致test_module整数输入int32/int64 输入提升为 float32 且数值精确test_integer_input_4053float64 精度kernel 精度在 float64 下无损传播test_float64_kernel_precision_4053值得特别说明的是test_forth_and_backtests/color/test_xyz.py#L137-L143由于正向与反向矩阵互为近似逆矩阵RGB→XYZ→RGB 的往返误差很小测试使用assert_close做宽松比较。这说明在实际使用中如果做先转后转的往返会有极小数值误差不宜做逐位相等断言。七、在颜色空间体系中的枢纽地位Lab 与 Luv 的前置步骤XYZ 在 Kornia 的颜色转换体系里承担枢纽角色。以 Lab 转换为例kornia/color/lab.py#L60-L67 的rgb_to_lab流程为lin_rgb rgb_to_linear_rgb(image) # 1. sRGB gamma 解码 → 线性 RGB xyz_im rgb_to_xyz(lin_rgb) # 2. 线性 RGB → XYZ xyz_ref_white torch.tensor([0.95047, 1.0, 1.08883], ...) # D65 白点 xyz_normalized torch.div(xyz_im, xyz_ref_white) # 3. 白点归一化 # ... 非线性变换与 L/a/b 分量计算同样kornia/color/luv.py#L63 的rgb_to_luv也先调用rgb_to_xyz且两个模块的逆向函数lab_to_rgb、luv_to_rgb都通过xyz_to_rgb回到 RGB见 kornia/color/lab.py#L134、kornia/color/luv.py#L132。可以推断所有需要感知均匀或设备无关的颜色流程都以 XYZ 为中间空间因此掌握rgb_to_xyz/xyz_to_rgb是理解 Kornia 整个颜色转换体系Lab、Luv 等的前提。八、实战小结与常见坑导入方式kornia.color.rgb_to_xyz等全部 4 个 API 均已导出到包顶层见 kornia/color/init.py#L57 与__all__直接import kornia即可使用无需单独导入子模块。输入必须为张量且通道数为 3否则分别抛出TypeCheckError/ShapeError。范围假设文档明确假定输入在 (0, 1) 且为线性 RGB处理 sRGB 编码图像时先做 gamma 解码否则 XYZ 结果会产生偏差。往返误差rgb_to_xyz与xyz_to_rgb互逆但非逐位精确需要恢复图像时应接受小误差不要用断言。性能函数内部已根据设备自动选择 einsumCPU或 conv2dGPU无需手动优化大批量 GPU 场景下 conv2d 路径更快。九、进一步阅读官方 API 文档页docs/source/color.xyz.rst核心实现kornia/color/xyz.py、底层变换工具 kornia/color/utils.py测试与数值参考tests/color/test_xyz.py上下游颜色空间Lab 实现 kornia/color/lab.py、Luv 实现 kornia/color/luv.py、sRGB 线性化解码 kornia/color/rgb.py颜色子包总览kornia/color/init.py包含 RGB/XYZ/Lab/Luv/HSV/YUV/YCbCr 等全套转换 API赞分享计算机视觉人工智能深度学习图像处理【免费下载链接】kornia Geometric Computer Vision Library for Spatial AI项目地址https://gitcode.com/gh_mirrors/ko/kornia点击查看免费下载相关推荐PDF换设备就变乱码PDF补丁丁字体嵌入操作路径PDF换设备就变乱码PDF补丁丁字体嵌入操作路径 手机里打开一份教材PDF正文变成一排小方框复制一句话出来是乱码。原因是文档只记录了字体名称没有把字体文计算机视觉深度学习人工智能图像处理Kornia 颜色空间转换指南使用 CIE Lab 与 rgb_to_lab / lab_to_rgb 处理图像Kornia 颜色空间转换指南使用 CIE Lab 与 rgb_to_lab / lab_to_rgb 处理图像 本指南聚焦于 Kornia 的 CIE La计算机视觉人工智能深度学习图像处理Kornia 颜色空间转换指南RGB 与 HSV 双向转换的 API 详解与实现原理Kornia 颜色空间转换指南RGB 与 HSV 双向转换的 API 详解与实现原理 导读 本文围绕 Kornia 官方文档 color.hsv.rst ht计算机视觉深度学习人工智能图像处理上一篇VSCode 下用 Bloc 扩展高效开发命令、代码操作、Snippets 与语言服务器完全指南下一篇niri 设计原则深度解析可滚动平铺 Wayland 合成器的架构取舍与实践指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Kornia 颜色空间系列：CIE XYZ 与 RGB 互转（rgb_to_xyz / xyz_to_rgb）原理与实践指南
计算机视觉人工智能深度学习图像处理【免费下载链接】kornia Geometric Computer Vision Library for Spatial AI项目地址https://gitcode.com/gh_mirrors/ko/kornia点击查看免费下载本文以 docs/source/color.xyz.rst 为骨架结合 Kornia 源码与测试系统讲解 CIE 1931 XYZ 颜色空间在 Kornia 中的实现RGB↔XYZ 的数学原理、D65 白点下的 3×3 转换矩阵、函数式与模块式两套 API、底层设备感知的线性变换优化以及它与 Lab/Luv 颜色空间的上下游关系。一、导读CIE XYZ 是国际照明委员会CIE于 1931 年提出的颜色空间它用三个虚拟原色X、Y、Z描述人眼对颜色的感知是所有基于设备无关device-independent颜色转换的基石。在 Kornia 中RGB 与 XYZ 的互转由 kornia/color/xyz.py 提供包括rgb_to_xyz/xyz_to_rgb两个函数和RgbToXyz/XyzToRgb两个nn.Module封装。读完本文你将掌握XYZ 与 RGB 转换的矩阵原理、两套 API 的完整用法、输入约束形状、dtype、数值范围与异常行为、Kornia 底层线性变换的 CPU/GPU 双路径实现以及 XYZ 作为中间空间在 Lab、Luv 转换中的枢纽地位。二、CIE XYZ 颜色空间与转换矩阵原理2.1 什么是 CIE XYZCIE XYZ 基于 CIE 1931 标准观察者Standard Observer的色匹配函数建立用数学上构造的 X、Y、Z 三个分量覆盖整个人眼可见色域其中 Y 分量对应亮度luminance。由于 XYZ 与具体显示设备无关它经常被用作中间表示从设备相关的 sRGB 出发先转到 XYZ再转到 Lab、Luv 等感知均匀空间或与色温、白点如 D65等光照信息结合做色彩管理。2.2 RGB→XYZ 与 XYZ→RGB 的矩阵在 Kornia 的实现中RGB 与 XYZ 的转换采用线性 3×3 矩阵假设 sRGB 输入已经过 gamma 解码即线性 RGB并在D65 白点D65 White Point对应色温约 6504K是 sRGB 的标准白点下定义。正向矩阵定义在 kornia/color/xyz.py#L48-L58kernel torch.tensor( [ [0.412453, 0.357580, 0.180423], [0.212671, 0.715160, 0.072169], [0.019334, 0.119193, 0.950227], ], ... )即X 0.412453·R 0.357580·G 0.180423·B Y 0.212671·R 0.715160·G 0.072169·B Z 0.019334·R 0.119193·G 0.950227·B反向矩阵XYZ→RGB定义在同文件 kornia/color/xyz.py#L83-L91精度更高的小数位用于保证往返round-trip误差足够小kernel torch.tensor( [ [3.2404813432005266, -1.5371515162713185, -0.4985363261688878], [-0.9692549499965682, 1.8759900014898907, 0.0415559265582928], [0.0556466391351772, -0.2040413383665112, 1.0573110696453443], ], ... )注意正向矩阵每一行的和分别为 0.950456、1.0、1.088830对应 D65 白点的 X、Y、Z 归一化值这与 kornia/color/lab.py#L66 中使用的[0.95047, 1.0, 1.08883]白点参考完全一致。该矩阵与 OpenCV 的cv2.cvtColor(..., cv2.COLOR_RGB2XYZ)标准一致源码 docstring 也直接引用了 OpenCV 颜色转换文档作为参考见 RgbToXyz 的 Reference 字段。2.3 输入前提线性 RGB 与范围假设RgbToXyz模块的 docstring 明确指出图像数据假定在 (0, 1) 范围内见 kornia/color/xyz.py#L100因此输入应是线性 RGB若要处理 sRGB 编码图像需要先用rgb_to_linear_rgb做 gamma 解码Kornia 在 kornia/color/rgb.py 中提供该函数数值建议在 [0, 1] 区间超出范围时转换结果不会自动裁剪函数内部不执行 clamp。三、函数式 APIrgb_to_xyz 与 xyz_to_rgb3.1 函数签名与返回值import torch import kornia input torch.rand(2, 3, 4, 5) # (B, C3, H, W) output kornia.color.rgb_to_xyz(input) # 2x3x4x5输入形状(*, 3, H, W)其中*表示任意数量的前置维度例如 batch 维度3对应 RGB/XYZ 三个通道H、W为高宽输出形状与输入完全一致(*, 3, H, W)返回XYZ 版本图像张量。xyz_to_rgb的用法完全对称rgb kornia.color.xyz_to_rgb(output) # 恢复为 RGB3.2 输入校验类型与形状检查两个函数在计算前都会执行 Kornia 的运行时检查见 kornia/color/xyz.py#L45-L46KORNIA_CHECK_IS_TENSOR(image) KORNIA_CHECK_SHAPE(image, [*, 3, H, W])非torch.Tensor输入会抛出TypeCheckError通道数不为 3或维度不足的输入会抛出ShapeError。测试 tests/color/test_xyz.py#L49-L61 明确验证了这两类异常with pytest.raises(TypeCheckError): assert kornia.color.rgb_to_xyz([0.0]) # 列表输入 → 类型错误 with pytest.raises(ShapeError): img torch.ones(1, 1, devicedevice, dtypedtype) assert kornia.color.rgb_to_xyz(img) # 通道数不为 3 → 形状错误3.3 dtype 处理整数输入与 float64 精度源码在构造 kernel 时做了 dtype 适配kornia/color/xyz.py#L49dtype image.dtype if image.is_floating_point() else torch.float32浮点输入float16/float32/float64kernel 与输入保持同 dtype因此float64 输入可以完整保留矩阵精度整数输入如 int32/int64自动提升为 float32 参与运算。对应测试 tests/color/test_xyz.py#L121-L135 验证了整数输入输出为 float32且数值与 float64 矩阵完全一致。四、模块式 APIRgbToXyz 与 XyzToRgbnn.Module4.1 使用方式模块式 API 适用于需要嵌入nn.Sequential、nn.Module或参与自动微分/模型导出的场景import torch from kornia.color import RgbToXyz, XyzToRgb input torch.rand(2, 3, 4, 5) xyz RgbToXyz() output xyz(input) # 2x3x4x5 rgb XyzToRgb() recovered rgb(output) # 2x3x4x5两个模块的forward只是对函数式 API 的薄封装见 kornia/color/xyz.py#L122-L133 与 kornia/color/xyz.py#L159-L170本身不包含可训练参数因此不会引入额外状态。4.2 ONNX 导出支持两个模块都声明了 ONNX 默认输入/输出形状kornia/color/xyz.py#L119-L120ONNX_DEFAULT_INPUTSHAPE: ClassVar[list[int]] [-1, 3, -1, -1] ONNX_DEFAULT_OUTPUTSHAPE: ClassVar[list[int]] [-1, 3, -1, -1]这说明 RGB↔XYZ 转换可以被导出为 ONNX 模型NCHW 布局N 与 H、W 维度动态适合部署到推理后端。Kornia 的 ONNX 导出支持体系见 kornia/onnx 目录。4.3 与函数式 API 的一致性保证测试 tests/color/test_xyz.py#L157-L162 专门断言了模块与函数的输出一致ops kornia.color.RgbToXyz().to(device, dtype) fcn kornia.color.rgb_to_xyz self.assert_close(ops(img), fcn(img))五、底层实现设备感知的线性变换_apply_linear_transformationrgb_to_xyz与xyz_to_rgb都通过 kornia/color/utils.py#L24-L70 中的_apply_linear_transformation完成 3×3 通道线性变换。该函数是 Kornia 颜色模块的公共基础设施同样被 Lab、Luv 等模块复用其核心是按设备分支选择最优算子if image_compute.device.type cpu or image_compute.numel() 0: out torch.einsum(oi, ...ihw - ...ohw, kernel_compute, image_compute) ... else: # GPU / CUDA input_flat image_compute.reshape(-1, 3, H, W) weight kernel_compute.view(3, 3, 1, 1) out_flat F.conv2d(input_flat, weight, biasbias_compute) ...CPU 路径使用torch.einsum代码注释kornia/color/utils.py#L49-L53说明其经验基准测试中在 CPU 上更快且对任意空形状empty tensor都有良好支持张量始终保留在计算图中GPU/加速器路径将 (3,3) kernel 视为 1×1 卷积权重调用F.conv2d在 CUDA 上可显著加速输入先reshape为 (B*, 3, H, W) 再展平回原形状整数输入在函数入口处先安全转 floatimage_compute image.float()见 kornia/color/utils.py#L39-L42kernel 与 bias 的 dtype/device 都会对齐到输入张量kornia/color/utils.py#L45-L46从而在 float64 输入下传播高精度。六、测试与质量保证测试/color/test_xyz.py 对 RGB↔XYZ 转换做了全面的测试覆盖可作为如何验证颜色转换正确性的参考范式测试维度说明对应测试Smoke 测试确认输出为 Tensortest_smoke形状保持任意前置维度(1,3,4,4)、(2,3,2,4)、(3,3,4,1)、(3,2,1)下输出形状不变test_cardinality数值正确性与 OpenCVcv2.cvtColor(data, cv2.COLOR_RGB2XYZ)生成的参考输出对比test_unit异常行为类型错误、通道数错误均抛异常test_exception往返一致性xyz_to_rgb(rgb_to_xyz(x)) ≈ xtest_forth_and_back梯度检查gradcheck验证可微性test_gradcheckJIT 兼容torch.jit.script结果一致test_jit模块/函数一致性RgbToXyz与rgb_to_xyz输出一致test_module整数输入int32/int64 输入提升为 float32 且数值精确test_integer_input_4053float64 精度kernel 精度在 float64 下无损传播test_float64_kernel_precision_4053值得特别说明的是test_forth_and_backtests/color/test_xyz.py#L137-L143由于正向与反向矩阵互为近似逆矩阵RGB→XYZ→RGB 的往返误差很小测试使用assert_close做宽松比较。这说明在实际使用中如果做先转后转的往返会有极小数值误差不宜做逐位相等断言。七、在颜色空间体系中的枢纽地位Lab 与 Luv 的前置步骤XYZ 在 Kornia 的颜色转换体系里承担枢纽角色。以 Lab 转换为例kornia/color/lab.py#L60-L67 的rgb_to_lab流程为lin_rgb rgb_to_linear_rgb(image) # 1. sRGB gamma 解码 → 线性 RGB xyz_im rgb_to_xyz(lin_rgb) # 2. 线性 RGB → XYZ xyz_ref_white torch.tensor([0.95047, 1.0, 1.08883], ...) # D65 白点 xyz_normalized torch.div(xyz_im, xyz_ref_white) # 3. 白点归一化 # ... 非线性变换与 L/a/b 分量计算同样kornia/color/luv.py#L63 的rgb_to_luv也先调用rgb_to_xyz且两个模块的逆向函数lab_to_rgb、luv_to_rgb都通过xyz_to_rgb回到 RGB见 kornia/color/lab.py#L134、kornia/color/luv.py#L132。可以推断所有需要感知均匀或设备无关的颜色流程都以 XYZ 为中间空间因此掌握rgb_to_xyz/xyz_to_rgb是理解 Kornia 整个颜色转换体系Lab、Luv 等的前提。八、实战小结与常见坑导入方式kornia.color.rgb_to_xyz等全部 4 个 API 均已导出到包顶层见 kornia/color/init.py#L57 与__all__直接import kornia即可使用无需单独导入子模块。输入必须为张量且通道数为 3否则分别抛出TypeCheckError/ShapeError。范围假设文档明确假定输入在 (0, 1) 且为线性 RGB处理 sRGB 编码图像时先做 gamma 解码否则 XYZ 结果会产生偏差。往返误差rgb_to_xyz与xyz_to_rgb互逆但非逐位精确需要恢复图像时应接受小误差不要用断言。性能函数内部已根据设备自动选择 einsumCPU或 conv2dGPU无需手动优化大批量 GPU 场景下 conv2d 路径更快。九、进一步阅读官方 API 文档页docs/source/color.xyz.rst核心实现kornia/color/xyz.py、底层变换工具 kornia/color/utils.py测试与数值参考tests/color/test_xyz.py上下游颜色空间Lab 实现 kornia/color/lab.py、Luv 实现 kornia/color/luv.py、sRGB 线性化解码 kornia/color/rgb.py颜色子包总览kornia/color/init.py包含 RGB/XYZ/Lab/Luv/HSV/YUV/YCbCr 等全套转换 API赞分享计算机视觉人工智能深度学习图像处理【免费下载链接】kornia Geometric Computer Vision Library for Spatial AI项目地址https://gitcode.com/gh_mirrors/ko/kornia点击查看免费下载相关推荐PDF换设备就变乱码PDF补丁丁字体嵌入操作路径PDF换设备就变乱码PDF补丁丁字体嵌入操作路径 手机里打开一份教材PDF正文变成一排小方框复制一句话出来是乱码。原因是文档只记录了字体名称没有把字体文计算机视觉深度学习人工智能图像处理Kornia 颜色空间转换指南使用 CIE Lab 与 rgb_to_lab / lab_to_rgb 处理图像Kornia 颜色空间转换指南使用 CIE Lab 与 rgb_to_lab / lab_to_rgb 处理图像 本指南聚焦于 Kornia 的 CIE La计算机视觉人工智能深度学习图像处理Kornia 颜色空间转换指南RGB 与 HSV 双向转换的 API 详解与实现原理Kornia 颜色空间转换指南RGB 与 HSV 双向转换的 API 详解与实现原理 导读 本文围绕 Kornia 官方文档 color.hsv.rst ht计算机视觉深度学习人工智能图像处理上一篇VSCode 下用 Bloc 扩展高效开发命令、代码操作、Snippets 与语言服务器完全指南下一篇niri 设计原则深度解析可滚动平铺 Wayland 合成器的架构取舍与实践指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考