Kalmus是用於膠片中顏色計算分析的Python軟件包。它提供了研究和比較膜顏色的使用的定量工具。該軟件包具有兩個目的:(1)各種方法來測量,計算和比較電影的顏色以及(2)可視化電影顏色的各種方法。我們已將軟件Kalmus命名為Natalie Kalmus(1882-1965),這是一位技術彩色導演,負責監督近300張好萊塢故事片的調色板。
Kalmus利用電影條形碼作為電影顏色的可視化。它具有一個模塊化管道,用於使用不同的顏色和感興趣區域中的不同尺寸的條形碼生成每個膠片框架。 Kalmus提供了來自所有背景的受眾群體的低級API,高級命令行和圖形用戶界面,以利用其功能。
條形碼可視化的示例:

圖1。任務:不可能(1996)使用每個框架的整個框架的平均顏色的顏色條形碼
圖2。任務:不可能(1996)使用每個框架前景的平均顏色的顏色條形碼
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
正如第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或繼續使用。
我們鼓勵社區用戶的貢獻,包括錯誤修復和新功能。在為Kalmus套餐做出貢獻時,請通過電子郵件[email protected]與項目維護者聯繫或打開問題。如果您的錯誤修復或新功能會更改包裝的當前行為,請指定與項目維護人員討論的更改和原因。
我們鼓勵包容性和友好的討論。溝通時,請遵循我們的行為準則。
我們提供一個涵蓋Kalmus核心功能的自動測試套件。在本地運行自動測試套件之前,請確保您已經安裝了PYTEST,PYTEST-COV和KALMUS的最新版本,並且您已將項目存儲庫克隆在Master Branch上。
運行測試套件:
$ 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}
}
作者要感謝梅隆基金會,達拉爾家庭基金會和巴克內爾大學人文科學中心對該項目的支持。該項目根據開源MIT許可發布。
現在可以在https://kalmus-color-toolkit.github.io/kalmus/kalmus/update_log.html上獲得完整的更新日誌(從v1.3.0到v1.3.14)