KALMUS
v1.3.14 release of KALMUS
Kalmus est un package Python pour l'analyse informatique des couleurs dans les films. Il fournit des outils quantitatifs pour étudier et comparer l'utilisation de la couleur du film. Ce package sert à deux objectifs: (1) diverses façons de mesurer, de calculer et de comparer les couleurs d'un film et (2) diverses façons de visualiser la couleur d'un film. Nous avons nommé le logiciel Kalmus en hommage à Natalie Kalmus (1882 - 1965), un réalisateur Technicolor qui a supervisé les palettes de couleurs de près de 300 longs métrages hollywoodiens.
Kalmus utilise le code-barres du film comme visualisation de la couleur du film. Il a un pipeline modularisé pour la génération de codes à barres en utilisant différentes mesures de couleur et la région d'intérêt dans chaque cadre de film. Kalmus fournit une API de bas niveau, une ligne de commande de haut niveau et une interface utilisateur graphique pour que l'audience de tous horizons profite de sa fonctionnalité.
Exemples de visualisation des code-barres:
Figure 1. Mission: Impossible (1996) Couleur Barcode en utilisant la couleur moyenne de la trame entière pour chaque cadre 
Figure 2. Mission: Impossible (1996) Couleur Barcode en utilisant la couleur moyenne du premier plan de chaque cadre
La référence de l'API Kalmus est maintenant disponible sur https://kalmus-color-toolkit.github.io/kalmus/kalmus.html.
Le package Kalmus nécessite un Python avec la version 3.7 ou 3.8.
Le package est publié sur PYPI (page d'accueil du projet). Après avoir installé le Python == 3,7, 3,8, vous pouvez installer le Kalmus en utilisant PIP (recommandé)
$ pip install kalmus
Alternativement, vous pouvez installer le Kalmus localement en clonant d'abord ce repo github. Ensuite, déplacez-vous vers le répertoire supérieur du dossier Cloned Kalmus Project et installez à l'aide de la commande PIP
$ pip install .
Dans les deux méthodes, les dépendances du package seront automatiquement installées. Vous pouvez vérifier si le Kalmus a été installé dans votre environnement à l'aide de la commande PIP
$ pip show kalmus
Alternativement, dans la version 1.3.7 et plus, vous pouvez vérifier la version de Kalmus installé à l'aide de son attribut .__version__ .
>>> import kalmus
>>> print(kalmus.__version__) # Warning: The __version__ attribute is not available in the kalmus v.1.3.6 and backward
>>> 1.3.7
Comme @Elektrobohemian l'a mentionné dans le numéro 4, Kalmus ne peut pas construire nativement sur les processeurs Apple M1 en raison des dépendances de Kalmus sur Numpy. Vous pourrez peut-être installer Kalmus sous une émulation de rosetta avec Python 3.7.
Kalmus possède une API de bas niveau, une ligne de commande de haut niveau et une interface utilisateur graphique pour que l'audience de tous horizons profite de sa fonctionnalité.
Pour commencer Kalmus, nous vous encourageons à consulter les tutoriels de cahier Jupyter dans le dossier des cahiers. Nous fournissons les didacticiels interactifs pour les utilisateurs pour démarrer sur Kalmus en utilisant son API, GUI et CLI. Notez que l'interface de ligne de commande (CLI) n'est disponible que dans Kalmus v1.3.7 ou en avant.
Nous encourageons les contributions, y compris les corrections de bogues et les nouvelles fonctionnalités, de la part des utilisateurs de notre communauté. Lorsque vous contribuez au package Kalmus, veuillez contacter les maintenants du projet par e-mail [email protected] ou ouvrir un problème. Si vos corrections de bogues ou de nouvelles fonctionnalités modifient les comportements actuels du package, veuillez spécifier les modifications et les raisons de la discussion avec les agents de projet.
Nous encourageons une discussion inclusive et amicale. Veuillez suivre notre code de conduite lors de la communication.
Nous fournissons une suite de tests automatisée qui couvre les fonctionnalités de base de Kalmus. Avant d'exécuter la suite de tests automatisé localement, assurez-vous d'avoir installé les dernières versions de PyTest, PyTest-CoV et Kalmus, et vous avez cloné le référentiel de projet sur Master Branch.
Pour exécuter la suite de tests:
$ python -m pytest tests --cov=kalmus --cov-config=.coveragerc --cov-report term-missingVoir le Guide de la suite de tests pour plus de détails.
Si vous trouvez que notre logiciel est utile dans votre travail, veuillez citer notre article qui décrit l'utilisation de Kalmus dans l'analyse des couleurs du film. Doi: https://doi.org/10.21105/joss.03156
Chen et al., (2021). Kalmus: Outils pour l'analyse des couleurs des films. Journal of Open Source Software, 6 (61), 3156, https://doi.org/10.21105/joss.03156
Voici la citation bibtex de notre travail:
@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}
}
Les auteurs souhaitent remercier la Fondation Mellon, la Dalal Family Foundation et le Bucknell University Humanities Center pour leur soutien sur ce projet. Le projet est publié sous la licence MIT open source.
Le journal de mise à jour complet (de la v1.3.0 à v1.3.14) est maintenant disponible sur https://kalmus-color-toolkit.github.io/kalmus/update_log.html
