KALMUS
v1.3.14 release of KALMUS
Kalmus é um pacote Python para a análise computacional de cores nos filmes. Ele fornece ferramentas quantitativas para estudar e comparar o uso da cor do filme. Este pacote serve a dois propósitos: (1) várias maneiras de medir, calcular e comparar as cores de um filme e (2) várias maneiras de visualizar a cor de um filme. Nomeamos o software Kalmus em homenagem a Natalie Kalmus (1882 - 1965), diretora da Technicolor que supervisionou as paletas de cores de quase 300 longas -metragens de Hollywood.
Kalmus utiliza o código de barras do filme como uma visualização da cor do filme. Possui um oleoduto modularizado para a geração de códigos de barras usando diferentes medidas de cor e região de interesse em cada quadro de filme. Kalmus fornece uma API de baixo nível, linha de comando de alto nível e interface gráfica do usuário para público de todos os fundos para aproveitar sua funcionalidade.
Exemplos de visualização de código de barras:
Figura 1. Missão: Impossível (1996) Code de barras de cor usando a cor média de toda a estrutura para cada quadro 
Figura 2. Missão: Impossível (1996) Code de barras de cor usando a cor média do primeiro plano de cada quadro
A referência da API da Kalmus está agora disponível em https://kalmus-color-toolkit.github.io/kalmus/kalmus.html.
O pacote Kalmus requer um python com a versão 3.7 ou 3.8.
O pacote é lançado no Pypi (Página inicial do Project). Depois de instalar o Python == 3.7, 3.8, você pode instalar o Kalmus usando PIP (recomendado)
$ pip install kalmus
Como alternativa, você pode instalar o Kalmus localmente clonando primeiro este repositório do GitHub. Em seguida, vá para o diretório superior da pasta do Projeto Kalmus clonado e instale usando o comando pip
$ pip install .
Nos dois métodos, as dependências do pacote serão instaladas automaticamente. Você pode verificar se o Kalmus foi instalado em seu ambiente usando o comando pip
$ pip show kalmus
Como alternativa, na versão 1.3.7 e acima, você pode verificar a versão do Kalmus instalado usando seu 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 mencionou na edição 4, Kalmus não pode construir nativamente os processadores da Apple M1 por causa das dependências de Kalmus no Numpy. Você pode instalar o Kalmus sob uma emulação de Rosetta com o Python 3.7.
Kalmus possui uma API de baixo nível, linha de comando de alto nível e interface gráfica do usuário para público de todos os fundos para aproveitar sua funcionalidade.
Para começar em Kalmus, incentivamos você a verificar os tutoriais de notebook Jupyter na pasta Notebooks. Fornecemos os tutoriais de notebooks interativos para os usuários começarem em Kalmus usando sua API, GUI e CLI. Observe que a interface da linha de comando (CLI) está disponível apenas em Kalmus v1.3.7 ou em diante.
Incentivamos contribuições, incluindo correções de bugs e novos recursos, de nossos usuários da comunidade. Ao contribuir para o pacote Kalmus, entre em contato com os mantenedores do projeto pelo email [email protected] ou com um problema. Se as correções de bugs ou novos recursos alterarem os comportamentos atuais do pacote, especifique as alterações e os motivos da discussão com os mantenedores do projeto.
Incentivamos discussões inclusivas e amigáveis. Siga nosso código de conduta ao se comunicar.
Fornecemos um conjunto de testes automatizado que cobre a funcionalidade principal de Kalmus. Antes de executar o pacote de teste automatizado localmente, verifique se você instalou as versões mais recentes do Pytest, Pytest-Cov e Kalmus, e você clonou o repositório do projeto no Master Branch.
Para executar a suíte de teste:
$ python -m pytest tests --cov=kalmus --cov-config=.coveragerc --cov-report term-missingConsulte o Guia do Suíte de Testes para obter mais detalhes.
Se você achar que nosso software é útil em seu trabalho, cite nosso artigo que descreva o uso de Kalmus na análise das cores do filme. Doi: https://doi.org/10.21105/joss.03156
Chen et al., (2021). Kalmus: Ferramentas para análise de cores dos filmes. Journal of Open Source Software, 6 (61), 3156, https://doi.org/10.21105/joss.03156
Aqui está a citação Bibtex de nosso trabalho:
@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}
}
Os autores desejam agradecer à Mellon Foundation, à Dalal Family Foundation e ao Bucknell University Humanities Center pelo apoio deste projeto. O projeto é divulgado sob a licença do MIT de código aberto.
O log de atualização completo (da v1.3.0 a v1.3.14) já está disponível em https://kalmus-color-toolkit.github.io/kalmus/update_log.html
