KALMUS
v1.3.14 release of KALMUS
Kalmus는 필름의 색상 분석을위한 Python 패키지입니다. 필름 색상의 사용을 연구하고 비교할 수있는 정량적 도구를 제공합니다. 이 패키지는 (1) 영화의 색상을 측정, 계산 및 비교하는 다양한 방법과 (2) 영화의 색상을 시각화하는 다양한 방법입니다. 우리는 거의 300 개의 할리우드 장편 영화의 컬러 팔레트를 감독 한 테크니 컬러 디렉터 인 Natalie Kalmus (1882-1965)에게 경의를 표하는 소프트웨어 Kalmus를 지명했습니다.
Kalmus는 영화 바코드를 영화 색상의 시각화로 사용합니다. 각 필름 프레임에서 다른 색상 및 관심 영역을 사용하여 바코드 생성을위한 모듈화 된 파이프 라인이 있습니다. Kalmus는 모든 배경의 잠재 고객이 기능을 활용할 수 있도록 저수준 API, 고급 명령 줄 및 그래픽 사용자 인터페이스를 제공합니다.
바코드 시각화의 예 :
그림 1. Mission : Impossible (1996) 각 프레임에 대한 전체 프레임의 평균 색상을 사용한 컬러 바코드 
그림 2. Mission : Impossible (1996) 각 프레임의 전경 평균 색상을 사용한 컬러 바코드
Kalmus API 참조는 이제 https://kalmus-color-toolkit.github.io/kalmus/kalmus.html에서 사용할 수 있습니다.
Kalmus 패키지에는 3.7 또는 3.8 버전의 파이썬이 필요합니다.
패키지는 PYPI (Project HomePage)에서 출시됩니다. Python == 3.7, 3.8을 설치 한 후 PIP (권장)를 사용하여 Kalmus를 설치할 수 있습니다.
$ pip install kalmus
또는 먼저이 Github Repo를 복제하여 Kalmus를 로컬로 설치할 수 있습니다. 그런 다음 복제 된 Kalmus 프로젝트 폴더의 상단 디렉토리로 이동하여 PIP 명령을 사용하여 설치하십시오.
$ pip install .
두 방법 모두 패키지의 종속성이 자동으로 설치됩니다. PIP 명령을 사용하여 Kalmus가 환경에 설치되었는지 확인할 수 있습니다.
$ 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 ISSE #4에서 언급 한 것처럼 Kalmus는 Numpy에 대한 Kalmus의 의존성 때문에 Apple M1 프로세서를 기본적으로 구축 할 수 없습니다. Python 3.7과 함께 Rosetta Emulation에서 Kalmus를 설치할 수 있습니다.
Kalmus는 모든 배경의 잠재 고객이 기능을 활용할 수있는 저수준 API, 고급 명령 줄 및 그래픽 사용자 인터페이스를 가지고 있습니다.
Kalmus를 시작하려면 노트북 폴더에서 Jupyter 노트북 자습서를 확인하는 것이 좋습니다. 우리는 사용자가 API, GUI 및 CLI를 사용하여 Kalmus를 시작할 수있는 대화식 노트북 자습서를 제공합니다. 명령 줄 인터페이스 (CLI)는 Kalmus v1.3.7에서만 사용할 수 있습니다.
커뮤니티 사용자의 버그 수정 및 새로운 기능을 포함한 기여를 권장합니다. Kalmus 패키지에 기여할 때는 이메일 [email protected]로 프로젝트 관리자에게 문의하거나 문제를여십시오. 버그 수정 또는 새로운 기능이 패키지의 현재 동작을 변경하면 프로젝트 관리자와의 논의에서 변경 사항과 이유를 지정하십시오.
우리는 포용적이고 친근한 토론을 장려합니다. 의사 소통 할 때 당사의 행동 강령을 따르십시오.
우리는 Kalmus의 핵심 기능을 다루는 자동 테스트 스위트를 제공합니다. 자동화 된 테스트 스위트를 로컬로 실행하기 전에 Pytest, Pytest-Cov 및 Kalmus의 최신 버전을 설치하고 Master Branch에서 프로젝트 저장소를 복제했는지 확인하십시오.
테스트 스위트를 실행하려면 :
$ python -m pytest tests --cov=kalmus --cov-config=.coveragerc --cov-report term-missing자세한 내용은 테스트 스위트 안내서를 참조하십시오.
우리의 소프트웨어가 귀하의 작업에 유용하다는 것을 알게되면 필름 색상 분석에서 Kalmus의 사용법을 설명하는 논문을 인용하십시오. doi : https://doi.org/10.21105/joss.03156
Chen et al., (2021). Kalmus : 필름 색상 분석 도구. 오픈 소스 소프트웨어 저널, 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 Humanities Center에게 감사의 말씀을 전합니다. 이 프로젝트는 오픈 소스 MIT 라이센스에 따라 릴리스됩니다.
전체 업데이트 로그 (v1.3.0에서 v1.3.14)는 이제 https://kalmus-color-toolkit.github.io/kalmus/update_log.html에서 사용할 수 있습니다.
