KALMUS
v1.3.14 release of KALMUS
Kalmus هي حزمة Python للتحليل الحسابي للألوان في الأفلام. ويوفر أدوات كمية لدراسة ومقارنة استخدام لون الفيلم. تخدم هذه الحزمة غرضين: (1) طرق مختلفة لقياس وحساب ومقارنة ألوان الفيلم و (2) طرق مختلفة لتصور لون الفيلم. لقد قمنا بتسمية برنامج Kalmus في تكريم Natalie Kalmus (1882 - 1965) ، وهو مخرج Technicolor أشرف على لوحات ألوان ما يقرب من 300 فيلم روائي هوليوود.
يستخدم Kalmus باركود الفيلم كتصور لون الفيلم. يحتوي على خط أنابيب معياري لتوليد الرموز الباركية باستخدام مقاييس مختلفة من الألوان ومنطقة الاهتمام في كل إطار فيلم. يوفر Kalmus واجهة برمجة تطبيقات منخفضة المستوى ، وخط أوامر عالي المستوى ، وواجهة مستخدم الرسوم للجمهور من جميع الخلفيات للاستفادة من وظائفه.
أمثلة على تصور الباركود:
الشكل 1. المهمة: مستحيل (1996) باركود اللون باستخدام متوسط لون الإطار بالكامل لكل إطار 
الشكل 2. المهمة: مستحيل (1996) باركود اللون باستخدام متوسط لون المقدمة من كل إطار
تتوفر الآن مرجع Kalmus API على https://kalmus-lo-toolkit.github.io/kalmus/kalmus.html.
تتطلب حزمة Kalmus python مع الإصدار 3.7 أو 3.8.
يتم إصدار الحزمة على PYPI (Project Homepage). بعد تثبيت Python == 3.7 ، 3.8 ، يمكنك تثبيت Kalmus باستخدام PIP (موصى به)
$ pip install kalmus
بدلاً من ذلك ، يمكنك تثبيت Kalmus محليًا عن طريق استنساخ هذا Github Repo. بعد ذلك ، انتقل إلى أعلى الدليل لمجلد مشروع Kalmus المستنسخ وتثبيته باستخدام أمر PIP
$ pip install .
في كلتا الطريقتين ، سيتم تثبيت تبعيات الحزمة تلقائيًا. يمكنك التحقق مما إذا كان Kalmus قد تم تثبيته في بيئتك باستخدام أمر PIP
$ pip show kalmus
بدلاً من ذلك ، في الإصدار 1.3.7 وما فوق ، يمكنك التحقق من إصدار Kalmus المثبت باستخدام سمة .__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
كما ذكر elektrobohemian في العدد رقم 4 ، لا يمكن أن تبني Kalmus أصلاً على معالجات Apple M1 بسبب تبعيات Kalmus على Numpy. قد تكون قادرًا على تثبيت Kalmus تحت مضاهاة Rosetta مع Python 3.7.
يحتوي Kalmus على واجهة برمجة تطبيقات منخفضة المستوى ، وخط أوامر عالي المستوى ، وواجهة مستخدم الرسوم للجمهور من جميع الخلفيات للاستفادة من وظائفه.
للبدء في Kalmus ، نشجعك على التحقق من البرامج التعليمية لمكتب Notebook Jupyter في مجلد Notebooks. نحن نقدم البرامج التعليمية للملاحظات التفاعلية للمستخدمين للبدء في Kalmus باستخدام API و GUI و CLI. لاحظ أن واجهة سطر الأوامر (CLI) متوفرة فقط في Kalmus v1.3.7 أو إلى الأمام.
نحن نشجع المساهمات ، بما في ذلك إصلاحات الأخطاء والميزات الجديدة ، من مستخدمي مجتمعنا. عند المساهمة في حزمة Kalmus ، يرجى الاتصال بمشروع المشروع عبر البريد الإلكتروني [email protected] أو فتح مشكلة. إذا قامت إصلاحات الأخطاء أو الميزات الجديدة بتغيير السلوكيات الحالية للحزمة ، فيرجى تحديد التغييرات والأسباب في المناقشة مع محفوظات المشروع.
نحن نشجع مناقشة شاملة وودية. يرجى اتباع مدونة قواعد سلوكنا عند التواصل.
نحن نقدم جناح اختبار تلقائي يغطي الوظيفة الأساسية لكالموس. قبل تشغيل جناح الاختبار الآلي محليًا ، تأكد من تثبيت أحدث إصدارات Pytest و Pytest-Cov و Kalmus ، وقد قمت باستنساخ مستودع المشروع على الفرع الرئيسي.
لتشغيل مجموعة الاختبار:
$ python -m pytest tests --cov=kalmus --cov-config=.coveragerc --cov-report term-missingانظر دليل مجموعة الاختبار لمزيد من التفاصيل.
إذا وجدت أن برنامجنا مفيد في عملك ، فيرجى الاستشهاد بالورقة التي تصف استخدام Kalmus في تحليل ألوان الأفلام. doi: https://doi.org/10.21105/joss.03156
تشن وآخرون ، (2021). كالموس: أدوات لتحليل الألوان للأفلام. Journal of Open Source Software ، 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 على دعمهم في هذا المشروع. يتم إصدار المشروع تحت رخصة معهد ماساتشوستس للتكنولوجيا مفتوح المصدر.
سجل التحديث الكامل (من v1.3.0 إلى v1.3.14) متاح الآن على https://kalmus-lo-toolkit.github.io/kalmus/update_log.html
