KALMUS
v1.3.14 release of KALMUS
Kalmusは、フィルムの色の計算分析のためのPythonパッケージです。フィルムカラーの使用を研究および比較するための定量的ツールを提供します。このパッケージは、2つの目的を果たします。（1）フィルムの色を測定、計算、比較するさまざまな方法と、（2）フィルムの色を視覚化するさまざまな方法。私たちは、300人近くのハリウッド長編映画のカラーパレットを監督したテクニカラーディレクターであるNatalie Kalmus（1882-1965）に敬意を表して、ソフトウェアKalmusをオマージュで命名しました。
Kalmusは、映画の色の視覚化として映画バーコードを利用しています。各フィルムフレームの色と関心のあるさまざまな測定値を使用して、バーコードの生成のためのモジュール化されたパイプラインがあります。 Kalmusは、あらゆるバックグラウンドからのオーディエンスのために、低レベルのAPI、高レベルのコマンドライン、およびグラフィックユーザーインターフェイスを提供し、その機能を活用します。
バーコードの視覚化の例：
図1。ミッション：インポッシブル（1996）各フレームの全フレームの平均色を使用した色バーコード
図2。ミッション：インポッシブル（1996）各フレームの前景の平均色を使用した色バーコード
Kalmus APIリファレンスは、https：//kalmus-color-toolkit.github.io/kalmus/kalmus.htmlで入手できるようになりました。
Kalmusパッケージには、バージョン3.7または3.8のPythonが必要です。
パッケージはPypi（Project Homepage）でリリースされます。 Python == 3.7、3.8をインストールした後、PIPを使用してKalmusをインストールできます（推奨）
$ pip install kalmus
または、このGitHubリポジトリを最初にクローニングして、Kalmusをローカルにインストールすることもできます。次に、Cloned Kalmus Projectフォルダーのトップディレクトリに移動し、PIPコマンドを使用してインストールします
$ pip install .
どちらの方法でも、パッケージの依存関係が自動的にインストールされます。 KalmusがPIPコマンドを使用して環境にインストールされているかどうかを確認できます
$ 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
@Elektrobohemianは第4号で述べたように、KalmusがKalmusのNumpyに依存しているため、Apple M1プロセッサにネイティブに構築することはできません。 Python 3.7でRosettaエミュレーションの下にKalmusをインストールできる場合があります。
Kalmusには、あらゆるバックグラウンドのオーディエンス向けの低レベルAPI、高レベルのコマンドライン、およびその機能を活用するためのグラフィックユーザーインターフェイスがあります。
Kalmusを開始するには、NotebooksフォルダのJupyterノートブックのチュートリアルを確認することをお勧めします。ユーザーがAPI、GUI、およびCLIを使用してKalmusを開始するためのインタラクティブなノートブックチュートリアルを提供しています。コマンドラインインターフェイス（CLI）は、Kalmus v1.3.7または以降でのみ利用可能であることに注意してください。
コミュニティユーザーからのバグ修正や新機能などの貢献をお勧めします。 Kalmusパッケージに貢献する場合は、[email protected]に電子メールでお問い合わせください。バグの修正または新機能がパッケージの現在の動作を変更する場合は、プロジェクトメンテナーとの議論の変更と理由を指定してください。
包括的で友好的な議論をお勧めします。通信するときは、行動規範に従ってください。
Kalmusのコア機能をカバーする自動テストスイートを提供します。自動化されたテストスイートをローカルで実行する前に、Pytest、Pytest-Cov、およびKalmusの最新バージョンをインストールしていることを確認してください。マスターブランチのプロジェクトリポジトリをクローニングしました。
テストスイートを実行するには：
$ python -m pytest tests --cov=kalmus --cov-config=.coveragerc --cov-report term-missing詳細については、テストスイートガイドを参照してください。
私たちのソフトウェアがあなたの仕事に役立つとわかった場合は、映画の色の分析におけるカルムスの使用について説明する論文を引用してください。 doi：https：//doi.org/10.21105/joss.03156
Chen et al。、（2021）。 Kalmus：フィルムの色分析のためのツール。 Journal of Open Source Software、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}
}
著者は、このプロジェクトへの支援について、Mellon Foundation、Dalal Family Foundation、およびBucknell University Humanity Centerに感謝したいと考えています。このプロジェクトは、オープンソースMITライセンスの下でリリースされます。
完全な更新ログ（v1.3.0からv1.3.14から）は、https：//kalmus-color-toolkit.github.io/kalmus/update_log.htmlで入手できるようになりました。
