KALMUS
v1.3.14 release of KALMUS
Kalmus adalah paket Python untuk analisis komputasi warna dalam film. Ini menyediakan alat kuantitatif untuk mempelajari dan membandingkan penggunaan warna film. Paket ini melayani dua tujuan: (1) berbagai cara untuk mengukur, menghitung dan membandingkan warna film dan (2) berbagai cara untuk memvisualisasikan warna film. Kami telah menamai perangkat lunak Kalmus sebagai penghormatan kepada Natalie Kalmus (1882 - 1965), seorang sutradara Technicolor yang mengawasi palet warna dari hampir 300 film fitur Hollywood.
Kalmus menggunakan barcode film sebagai visualisasi warna film. Ini memiliki pipa modularisasi untuk generasi barcode menggunakan berbagai ukuran warna dan wilayah yang diminati pada setiap bingkai film. Kalmus menyediakan API tingkat rendah, baris perintah tingkat tinggi, dan antarmuka pengguna grafis untuk audiens dari semua latar belakang untuk memanfaatkan fungsinya.
Contoh visualisasi barcode:
Gambar 1. Misi: mustahil (1996) Barcode warna menggunakan warna rata -rata seluruh bingkai untuk setiap bingkai 
Gambar 2. Mission: Impossible (1996) Barcode warna menggunakan warna rata -rata latar depan setiap bingkai
Referensi API Kalmus sekarang tersedia di https://kalmus-color-toolkit.github.io/kalmus/kalmus.html.
Paket Kalmus membutuhkan python dengan versi 3.7 atau 3.8.
Paket ini dirilis di PYPI (Project Homepage). Setelah Anda memasang python == 3.7, 3.8, Anda dapat memasang kalmus menggunakan pip (disarankan)
$ pip install kalmus
Atau, Anda dapat menginstal Kalmus secara lokal dengan terlebih dahulu mengkloning repo GitHub ini. Kemudian, pindah ke direktori teratas folder proyek Kalmus yang dikloning dan instal menggunakan perintah PIP
$ pip install .
Dalam kedua metode, dependensi paket akan diinstal secara otomatis. Anda dapat memverifikasi apakah kalmus telah dipasang di lingkungan Anda menggunakan perintah PIP
$ pip show kalmus
Atau, dalam versi 1.3.7 dan di atas, Anda dapat memeriksa versi Kalmus yang diinstal menggunakan atribut .__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
Seperti @elektrobohemian yang disebutkan dalam edisi #4, Kalmus tidak dapat membangun secara asli pada prosesor Apple M1 karena ketergantungan Kalmus di Numpy. Anda mungkin dapat memasang kalmus di bawah emulasi rosetta dengan Python 3.7.
Kalmus memiliki API tingkat rendah, baris perintah tingkat tinggi, dan antarmuka pengguna grafis untuk audiens dari semua latar belakang untuk memanfaatkan fungsinya.
Untuk memulai di Kalmus, kami mendorong Anda untuk memeriksa tutorial Jupyter Notebook di folder Notebooks. Kami menyediakan tutorial notebook interaktif bagi pengguna untuk memulai Kalmus menggunakan API, GUI, dan CLI. Perhatikan bahwa antarmuka baris perintah (CLI) hanya tersedia di Kalmus v1.3.7 atau selanjutnya.
Kami mendorong kontribusi, termasuk perbaikan bug dan fitur baru, dari pengguna komunitas kami. Saat berkontribusi pada paket Kalmus, silakan hubungi pengelola proyek melalui email [email protected] atau membuka masalah. Jika perbaikan bug Anda atau fitur baru mengubah perilaku paket saat ini, harap tentukan perubahan dan alasan dalam diskusi dengan pengelola proyek.
Kami mendorong diskusi yang inklusif dan ramah. Silakan ikuti kode perilaku kami saat berkomunikasi.
Kami menyediakan rangkaian tes otomatis yang mencakup fungsionalitas inti kalmus. Sebelum menjalankan suite tes otomatis secara lokal, pastikan Anda telah menginstal versi terbaru Pytest, Pytest-Cov, dan Kalmus, dan Anda telah mengkloning repositori proyek di Master Branch.
Untuk menjalankan test suite:
$ python -m pytest tests --cov=kalmus --cov-config=.coveragerc --cov-report term-missingLihat Panduan Test Suite untuk detail lebih lanjut.
Jika Anda menemukan perangkat lunak kami berguna dalam pekerjaan Anda, silakan kutip makalah kami yang menjelaskan penggunaan Kalmus dalam analisis warna film. Doi: https://doi.org/10.21105/joss.03156
Chen et al., (2021). Kalmus: Alat untuk analisis warna film. Jurnal Perangkat Lunak Open Source, 6 (61), 3156, https://doi.org/10.21105/joss.03156
Inilah kutipan Bibtex dari pekerjaan kami:
@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}
}
Para penulis ingin mengucapkan terima kasih kepada Mellon Foundation, Dalal Family Foundation, dan Bucknell University Humanities Center atas dukungan mereka pada proyek ini. Proyek ini dirilis di bawah lisensi MIT open-source.
Log Pembaruan Lengkap (dari V1.3.0 ke V1.3.14) sekarang tersedia di https://kalmus-color-toolkit.github.io/kalmus/update_log.html
