色彩 - 色卡检测

.. start-badges

|actions| |coveralls| |codacy| |version|

.. |actions| image:: https://img.shields.io/github/actions/workflow/status/colour-science/colour-checker-detection/.github/workflows/continuous-integration-quality-unit-tests.yml?branch=develop&style=flat-square :target: https://github.com/colour-science/colour-checker-detection/actions :alt: Develop Build Status .. |coveralls| image:: http://img.shields.io/coveralls/colour-science/colour-checker-detection/develop.svg?style=flat-square :target: https://coveralls.io/r/colour-science/colour-checker-detection :alt: Coverage Status .. |codacy| image:: https://img.shields.io/codacy/grade/c543bc30229347cdaea00aadd3f79499/develop.svg?style=flat-square :target: https://app.codacy.com/gh/colour-science/colour-checker-detection :alt: Code Grade .. |version| image:: https://img.shields.io/pypi/v/colour-checker-detection.svg?style=flat-square :target: https://pypi.org/project/colour-checker-detection :alt: Package Version

.. end-badges

这是一个实现各种色卡检测算法及相关工具的Python包。

它是开源的，在BSD-3-Clause条款下免费提供。

.. image:: https://raw.githubusercontent.com/colour-science/colour-checker-detection/master/docs/_static/ColourCheckerDetection_001.png

.. contents:: 目录 :backlinks: none :depth: 2

.. sectnum::

特性

实现了以下色卡检测算法：

• 分割

• 通过Ultralytics YOLOv8进行机器学习推理

  • 模型发布在HuggingFace上，使用专门构建的数据集进行训练。
  • 该模型仅针对ColorChecker Classic 24图像进行训练，不适用于ColorChecker Nano或ColorChecker SG图像。
  • 推理由一个在GNU Affero通用公共许可证v3.0条款下许可的脚本执行，因为它使用了与BSD-3-Clause不兼容的Ultralytics YOLOv8 API。

示例 ^^^^^^^^

examples目录中提供了各种使用示例。

用户指南

安装 ^^^^^^^^^^^^

由于资源依赖的大小，运行各种示例和单元测试所需的资源依赖不包含在Pypi包中。克隆存储库时，它们作为Git子模块单独提供。

主要依赖

**Colour - Checker Detection**运行需要以下依赖项：

- python >= 3.9, < 4
- colour-science >= 4.3
- imageio >= 2, < 3
- numpy >= 1.22, < 2
- opencv-python >= 4, < 5
- scipy >= 1.8, < 2

次要依赖

• ultralytics >= 8, < 9

Pypi

满足依赖项后，可以通过在shell中输入以下命令从Python包索引安装**Colour - Checker Detection**：

    pip install --user colour-checker-detection

整体开发依赖项的安装方法如下：

    pip install --user 'colour-checker-detection[development]'

贡献
^^^^^^^^^^^^

如果您想为Colour - Checker Detection做出贡献，请参阅Colour的贡献指南。

参考文献
^^^^^^^^^^^^

参考文献以BibTeX格式在存储库中提供。

API参考
-------------

Colour - Checker Detection的主要技术参考是API参考。

行为准则
---------------

行为准则改编自贡献者公约1.4，可在行为准则页面上查看。

联系方式与社交媒体
----------------

可通过以下方式联系Colour开发者：

- 电子邮件
- Facebook
- Github讨论
- Gitter
- Twitter

关于
-----

| **Colour - Checker Detection** 由Colour开发者开发
| 版权所有 2018 Colour开发者 – colour-developers@colour-science.org
| 本软件根据BSD-3-Clause条款发布：https://opensource.org/licenses/BSD-3-Clause
| https://github.com/colour-science/colour-checker-detection