KALMUS
v1.3.14 release of KALMUS
Kalmus es un paquete de Python para el análisis computacional de colores en las películas. Proporciona herramientas cuantitativas para estudiar y comparar el uso del color de la película. Este paquete tiene dos propósitos: (1) varias formas de medir, calcular y comparar los colores de una película y (2) varias formas de visualizar el color de una película. Hemos nombrado el software Kalmus en homenaje a Natalie Kalmus (1882 - 1965), un director de Technicolor que supervisó las paletas de colores de casi 300 películas de Hollywood.
Kalmus utiliza el código de barras de la película como una visualización del color de la película. Tiene una tubería modularizada para la generación de códigos de barras que utilizan diferentes medidas de color y región de interés en cada marco de película. Kalmus proporciona una API de bajo nivel, una línea de comandos de alto nivel e interfaz gráfica de usuario para la audiencia de todos los orígenes para aprovechar su funcionalidad.
Ejemplos de visualización de códigos de barras:
Figura 1. Misión: Imposible (1996) Código de barras de color usando el color promedio de todo el marco para cada cuadro 
Figura 2. Misión: Imposible (1996) Código de barras de color usando el color promedio de primer plano de cada cuadro
La referencia de la API de Kalmus ahora está disponible en https://kalmus-color-toolkit.github.io/kalmus/kalmus.html.
El paquete Kalmus requiere una pitón con la versión 3.7 o 3.8.
El paquete se lanza en PYPI (Página de inicio del Proyecto). Después de instalar Python == 3.7, 3.8, puede instalar el kalmus usando PIP (recomendado)
$ pip install kalmus
Alternativamente, puede instalar el Kalmus localmente clonando primero este repositorio de GitHub. Luego, muévase al directorio superior de la carpeta del proyecto Kalmus clonada e instale usando el comando pip
$ pip install .
En ambos métodos, las dependencias del paquete se instalarán automáticamente. Puede verificar si el kalmus se ha instalado en su entorno utilizando el comando pip
$ pip show kalmus
Alternativamente, en la versión 1.3.7 y superior, puede verificar la versión de Kalmus instalado utilizando su atributo .__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
Como @elektrobohemian mencionó en el número 4, Kalmus no puede construir de forma nativa en los procesadores Apple M1 debido a las dependencias de Kalmus de Numpy. Es posible que pueda instalar Kalmus bajo una emulación de Rosetta con Python 3.7.
Kalmus tiene una API de bajo nivel, una línea de comandos de alto nivel e interfaz gráfica de usuario para la audiencia de todos los orígenes para aprovechar su funcionalidad.
Para comenzar con Kalmus, le recomendamos que revise los tutoriales de Jupyter Notebook en la carpeta de cuadernos. Proporcionamos los tutoriales de cuaderno interactivo para que los usuarios comiencen con Kalmus usando su API, GUI y CLI. Observe que la interfaz de línea de comandos (CLI) solo está disponible en Kalmus v1.3.7 o en adelante.
Alentamos las contribuciones, incluidas las correcciones de errores y las nuevas características, de los usuarios de nuestra comunidad. Al contribuir al paquete Kalmus, comuníquese con los mantenedores del proyecto por correo electrónico [email protected] o abriendo un problema. Si su error corrige a sus nuevas funciones cambia los comportamientos actuales del paquete, especifique los cambios y razones en la discusión con los mantenedores de proyectos.
Alentamos la discusión inclusiva y amistosa. Siga nuestro código de conducta cuando se comunique.
Proporcionamos un conjunto de pruebas automatizado que cubre la funcionalidad central de Kalmus. Antes de ejecutar la suite de prueba automatizada localmente, asegúrese de haber instalado las últimas versiones de Pytest, Pytest-Cov y Kalmus, y ha clonado el repositorio del proyecto en Master Branch.
Para ejecutar la suite de prueba:
$ python -m pytest tests --cov=kalmus --cov-config=.coveragerc --cov-report term-missingConsulte la Guía de la suite de prueba para obtener más detalles.
Si encuentra que nuestro software es útil en su trabajo, cite nuestro artículo que describe el uso de Kalmus en el análisis de los colores de la película. Doi: https://doi.org/10.21105/Joss.03156
Chen et al., (2021). Kalmus: Herramientas para el análisis de color de películas. Journal of Open Source Software, 6 (61), 3156, https://doi.org/10.21105/Joss.03156
Aquí está la cita de Bibtex de nuestro trabajo:
@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}
}
Los autores desean agradecer a la Fundación Mellon, la Fundación Familia Dalal y al Centro de Humanidades de la Universidad de Bucknell por su apoyo en este proyecto. El proyecto se publica bajo la licencia MIT de código abierto.
El registro de actualización completo (de v1.3.0 a v1.3.14) ya está disponible en https://kalmus-color-toolkit.github.io/kalmus/update_log.html
