KALMUS下载KALMUS源代码下载

KALMUS

Ai源码

v1.3.14 release of KALMUS

下载

卡尔姆斯

Kalmus是用于胶片中颜色计算分析的Python软件包。它提供了研究和比较膜颜色的使用的定量工具。该软件包具有两个目的：（1）各种方法来测量，计算和比较电影的颜色以及（2）可视化电影颜色的各种方法。我们已将软件Kalmus命名为Natalie Kalmus（1882-1965），这是一位技术彩色导演，负责监督近300张好莱坞故事片的调色板。

Kalmus利用电影条形码作为电影颜色的可视化。它具有一个模块化管道，用于使用不同的颜色和感兴趣区域中的不同尺寸的条形码生成每个胶片框架。 Kalmus提供了来自所有背景的受众群体的低级API，高级命令行和图形用户界面，以利用其功能。

什么是电影条形码：Kalmus：用于电影色彩分析的工具。开源软件杂志，6（61），3156。https：//doi.org/10.21105/joss.03156
如何安装Kalmus：Kalmus安装指南和Kalmus PYPI主页。
我如何使用Kalmus：Kalmus API，GUI和CLI的笔记本教程
我如何为Kalmus做出贡献：Kalmus贡献指南
我如何运行Kalmus的自动测试套件：Auomated Test Suite

条形码可视化的示例：

图1。任务：不可能（1996）使用每个框架的整个框架的平均颜色的颜色条形码

图2。任务：不可能（1996）使用每个框架前景的平均颜色的颜色条形码

API文档

Kalmus API参考现在可在https://kalmus-color-toolkit.github.io/kalmus/kalmus/kalmus.html上找到。

安装指南

Kalmus软件包需要具有3.7或3.8版的Python。

该包在PYPI（Project HomePage）上发布。安装Python == 3.7、3.8后，您可以使用PIP安装Kalmus（建议）

 $ pip install kalmus

另外，您可以首先克隆此github存储库来本地安装Kalmus。然后，移至克隆的Kalmus项目文件夹的顶部目录，然后使用PIP命令安装

 $ pip install .

在这两种方法中，软件包的依赖项将自动安装。您可以使用PIP命令验证是否已在环境中安装了Kalmus

 $ pip show kalmus

另外，在版本1.3.7及更高版本中，您可以使用其.__version__属性检查安装的Kalmus版本。

 >>> import kalmus
>>> print(kalmus.__version__) # Warning: The __version__ attribute is not available in the kalmus v.1.3.6 and backward
>>> 1.3.7

适用于Apple M1芯片（ARM64架构）的用户

正如第4期中提到的@Elektrobohemian所述，由于Kalmus对Numpy的依赖性，Kalmus无法在Apple M1处理器上本地建立。您也许可以使用Python 3.7的Rosetta仿真下安装Kalmus。

开始

Kalmus具有来自所有背景的受众群体的低级API，高级命令行和图形用户界面，以利用其功能。

为了开始使用Kalmus，我们建议您在笔记本文件夹中查看Jupyter笔记本教程。我们提供交互式笔记本教程，供用户使用其API，GUI和CLI开始使用Kalmus。请注意，命令行接口（CLI）仅在Kalmus v1.3.7或继续使用。

图形用户界面的笔记本教程
图形用户界面的降价教程
申请编程接口的笔记本教程
命令行界面的降价教程
高级API使用的笔记本教程

贡献

我们鼓励社区用户的贡献，包括错误修复和新功能。在为Kalmus套餐做出贡献时，请通过电子邮件[email protected]与项目维护者联系或打开问题。如果您的错误修复或新功能会更改包装的当前行为，请指定与项目维护人员讨论的更改和原因。

我们鼓励包容性和友好的讨论。沟通时，请遵循我们的行为准则。

测试套件

我们提供一个涵盖Kalmus核心功能的自动测试套件。在本地运行自动测试套件之前，请确保您已经安装了PYTEST，PYTEST-COV和KALMUS的最新版本，并且您已将项目存储库克隆在Master Branch上。

运行测试套件：

转到克隆Kalmus项目的顶级目录
使用命令$ python -m pytest tests --cov=kalmus --cov-config=.coveragerc --cov-report term-missing

有关更多详细信息，请参见《测试套件指南》。

引用

如果您发现我们的软件在您的工作中很有用，请引用我们的论文，其中描述了Kalmus在胶片颜色分析中的用法。 doi：https：//doi.org/10.21105/joss.03156

Chen等人（2021）。 Kalmus：胶片颜色分析的工具。开源软件杂志，6（61），3156，https：//doi.org/10.21105/joss.03156

这是我们工作的Bibtex引用：

 @article{Chen2021,
    doi = {10.21105/joss.03156},
    url = {https://doi.org/10.21105/joss.03156},
    year = {2021},
    volume = {6},
    number = {61},
    pages = {3156},
    author = {Yida Chen and Eric Faden and Nathan C. Ryan},
    title = {KALMUS: tools for color analysis of films},
    journal = {Journal of Open Source Software}
}