KALMUS
v1.3.14 release of KALMUS
Kalmus ist ein Python -Paket für die Computeranalyse von Farben in Filmen. Es bietet quantitative Werkzeuge, um die Verwendung von Filmfarbe zu studieren und zu vergleichen. Dieses Paket dient zwei Zwecken: (1) verschiedene Möglichkeiten, die Farben eines Films zu messen, zu berechnen und zu vergleichen, und (2) verschiedene Möglichkeiten zur Visualisierung der Farbe eines Films. Wir haben den Software Kalmus als Hommage an Natalie Kalmus (1882 - 1965), einen Technicolor -Regisseur, der die Farbpaletten von fast 300 Hollywood -Spielfilmen beaufsichtigte, benannt.
Kalmus verwendet den Film Barcode als Visualisierung der Farbe des Films. Es verfügt über eine modularisierte Pipeline für die Erzeugung von Barcodes unter Verwendung unterschiedlicher Farbmaße und Region, die an jedem Filmrahmen interessiert sind. Kalmus bietet eine API auf niedriger Ebene, eine Befehlszeile auf hoher Ebene und eine grafische Benutzeroberfläche für die Zielgruppe aus allen Bereichen, um seine Funktionalität zu nutzen.
Beispiele für die Barcode -Visualisierung:
Abbildung 1. Mission: Impossible (1996) Farb Barcode unter Verwendung der durchschnittlichen Farbe des gesamten Rahmens für jeden Frame 
Abbildung 2. Mission: Impossible (1996) Farb Barcode unter Verwendung der durchschnittlichen Farbe des Vordergrunds jedes Rahmens
Die Kalmus-API-Referenz ist ab sofort unter https://kalmus-color-toolkit.github.io/kalmus/kalmus.html verfügbar.
Für das Kalmus -Paket ist ein Python mit Version 3.7 oder 3.8 erforderlich.
Das Paket wird auf PYPI (Project Homepage) veröffentlicht. Nachdem Sie den Python == 3.7, 3.8 installiert haben, können Sie den Kalmus mit PIP (empfohlen) installieren (empfohlen).
$ pip install kalmus
Alternativ können Sie den Kalmus lokal installieren, indem Sie dieses Github -Repo zuerst klonen. Gehen Sie dann in das oberste Verzeichnis des klonierten Kalmus -Projektordners und installieren Sie sie mit dem PIP -Befehl
$ pip install .
In beiden Methoden werden die Abhängigkeiten des Pakets automatisch installiert. Sie können überprüfen, ob der Kalmus in Ihrer Umgebung mit dem PIP -Befehl installiert wurde
$ pip show kalmus
Alternativ können Sie in Version 1.3.7 und höher die Version des installierten Kalmus unter Verwendung des .__version__ -Attributs überprüfen.
>>> import kalmus
>>> print(kalmus.__version__) # Warning: The __version__ attribute is not available in the kalmus v.1.3.6 and backward
>>> 1.3.7
Wie @ELEKTROBOHEMIAN in Ausgabe 4 erwähnt, kann Kalmus aufgrund der Abhängigkeiten von Kalmus von Numph nicht nativ auf Apple M1 -Prozessoren aufbauen. Möglicherweise können Sie Kalmus unter einer Rosetta -Emulation mit Python 3.7 installieren.
Kalmus verfügt über eine API auf niedriger Ebene, eine Befehlszeile auf hoher Ebene und eine grafische Benutzeroberfläche, damit die Zielgruppe aus allen Bereichen seine Funktionalität nutzt.
Um mit Kalmus zu beginnen, empfehlen wir Ihnen, die Jupyter -Notebook -Tutorials im Ordner Notebooks zu überprüfen. Wir bieten die interaktiven Notebook -Tutorials für Benutzer mithilfe seiner API, GUI und CLI. Beachten Sie, dass die Befehlszeilenschnittstelle (CLI) nur in Kalmus v1.3.7 oder weiter verfügbar ist.
Wir fördern von unseren Community -Nutzern Beiträge, einschließlich Fehlerbehebungen und neuer Funktionen, von unseren Community -Nutzern. Wenn Sie zum Kalmus -Paket beitragen, wenden Sie sich bitte an die Projektburgen per E -Mail an [email protected] oder eröffnen Sie ein Problem. Wenn Ihre Fehlerbehebungen oder neue Funktionen das aktuelle Verhalten des Pakets ändern, geben Sie bitte die Änderungen und Gründe in der Diskussion mit Projektbeteiligten an.
Wir ermutigen integrative und freundliche Diskussionen. Bitte folgen Sie unserem Verhaltenskodex, wenn Sie kommunizieren.
Wir bieten eine automatisierte Testsuite, die die Kernfunktionalität von Kalmus abdeckt. Stellen Sie vor der lokalen Ausführung der automatisierten Testsuite sicher, dass Sie die neuesten Versionen von PyTest, PyTest-Cov und Kalmus installiert haben, und Sie haben das Projektrepository in Master Branch geklont.
Um die Testsuite auszuführen:
$ python -m pytest tests --cov=kalmus --cov-config=.coveragerc --cov-report term-missingWeitere Informationen finden Sie im Test Suite Guide.
Wenn Sie feststellen, dass unsere Software in Ihrer Arbeit nützlich ist, zitieren Sie bitte unser Papier, das die Verwendung von Kalmus bei der Analyse von Filmfarben beschreibt. Doi: https://doi.org/10.21105/joss.03156
Chen et al., (2021). Kalmus: Werkzeuge zur Farbanalyse von Filmen. Journal of Open Source Software, 6 (61), 3156, https://doi.org/10.21105/joss.03156
Hier ist das Bibtex -Zitat unserer Arbeit:
@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}
}
Die Autoren möchten sich der Mellon Foundation, der Dalal Family Foundation und dem Bucknell University Humanities Center für ihre Unterstützung für dieses Projekt bedanken. Das Projekt wird unter der Open-Source-MIT-Lizenz veröffentlicht.
Das vollständige Update-Protokoll (von v1.3.0 bis v1.3.14) ist ab sofort unter https://kalmus-
