KALMUS ดาวน์โหลด - ดาวน์โหลดซอร์สโค้ด KALMUS

KALMUS

โค้ดแหล่งที่มา AI

v1.3.14 release of KALMUS

ดาวน์โหลด

Kalmus

Kalmus เป็นแพ็คเกจ Python สำหรับการวิเคราะห์การคำนวณสีในภาพยนตร์ มันมีเครื่องมือเชิงปริมาณในการศึกษาและเปรียบเทียบการใช้สีฟิล์ม แพ็คเกจนี้มีวัตถุประสงค์สองประการ: (1) วิธีการวัดคำนวณและเปรียบเทียบสีของฟิล์มและ (2) วิธีต่าง ๆ ในการมองเห็นสีของภาพยนตร์ เราได้ตั้งชื่อซอฟต์แวร์ Kalmus เพื่อแสดงความเคารพต่อ Natalie Kalmus (1882 - 1965) ผู้กำกับ Technicolor ที่ดูแลจานสีของภาพยนตร์ฮอลลีวูดเกือบ 300 เรื่อง

Kalmus ใช้บาร์โค้ดภาพยนตร์เป็นภาพสีของภาพยนตร์ มันมีไปป์ไลน์แบบแยกส่วนสำหรับการสร้างบาร์โค้ดโดยใช้มาตรการที่แตกต่างกันของสีและพื้นที่ที่น่าสนใจในแต่ละเฟรมฟิล์ม Kalmus จัดเตรียม API ระดับต่ำบรรทัดคำสั่งระดับสูงและส่วนต่อประสานผู้ใช้กราฟิกสำหรับผู้ชมจากพื้นหลังทั้งหมดเพื่อใช้ประโยชน์จากการทำงานของมัน

บาร์โค้ดภาพยนตร์คืออะไร: Kalmus: เครื่องมือสำหรับการวิเคราะห์สีของภาพยนตร์ วารสารซอฟต์แวร์โอเพ่นซอร์ส , 6 (61), 3156. https://doi.org/10.21105/joss.03156
ฉันจะติดตั้ง Kalmus: Kalmus Guide และ Kalmus PYPI หน้าแรกได้อย่างไร
ฉันจะใช้ Kalmus: Notebook Tutorials สำหรับ API, API, GUI และ CLI ของ Kalmus ได้อย่างไร
ฉันจะมีส่วนร่วมในแนวทางการบริจาค Kalmus: Kalmus ได้อย่างไร
ฉันจะเรียกใช้ชุดทดสอบอัตโนมัติของ Kalmus ได้อย่างไร: Auomated Test Suite

ตัวอย่างของการสร้างภาพบาร์โค้ด:

รูปที่ 1. ภารกิจ: เป็นไปไม่ได้ (1996) บาร์โค้ดสีโดยใช้สีเฉลี่ยของทั้งเฟรมสำหรับแต่ละเฟรม

รูปที่ 2. ภารกิจ: เป็นไปไม่ได้ (1996) บาร์โค้ดสีโดยใช้สีเฉลี่ยของเบื้องหน้าของแต่ละเฟรม

เอกสาร API

การอ้างอิง Kalmus API มีอยู่ใน https://kalmus-color-toolkit.github.io/kalmus/kalmus.html

คู่มือการติดตั้ง

แพ็คเกจ Kalmus ต้องการ Python ที่มีเวอร์ชัน 3.7 หรือ 3.8

แพ็คเกจนี้เปิดตัวใน PYPI (หน้าแรกของโครงการ) หลังจากที่คุณติดตั้ง Python == 3.7, 3.8 คุณสามารถติดตั้ง kalmus โดยใช้ PIP (แนะนำ)

 $ pip install kalmus

หรือคุณสามารถติดตั้ง kalmus ในพื้นที่โดยการโคลนนิ่งครั้งแรก github repo นี้ จากนั้นย้ายไปที่ไดเรกทอรีด้านบนของโฟลเดอร์ Kalmus Project ที่โคลนและติดตั้งโดยใช้คำสั่ง 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

สำหรับผู้ใช้ที่มีชิป Apple M1 (สถาปัตยกรรม ARM64)

ดังที่ @elektrobohemian กล่าวถึงในปัญหา #4 Kalmus ไม่สามารถสร้างขึ้นได้อย่างเป็นธรรมชาติในโปรเซสเซอร์ Apple M1 เนื่องจากการพึ่งพาของ Kalmus ใน Numpy คุณอาจติดตั้ง Kalmus ภายใต้การจำลอง Rosetta ด้วย Python 3.7

เริ่มต้นใช้งาน

Kalmus มี API ระดับต่ำบรรทัดคำสั่งระดับสูงและส่วนต่อประสานผู้ใช้กราฟิกสำหรับผู้ชมจากพื้นหลังทั้งหมดเพื่อใช้ประโยชน์จากการทำงานของมัน

ในการเริ่มต้น Kalmus เราขอแนะนำให้คุณตรวจสอบบทช่วยสอน Jupyter Notebook ในโฟลเดอร์โน้ตบุ๊ก เราจัดทำแบบฝึกหัดสมุดบันทึกแบบโต้ตอบสำหรับผู้ใช้เพื่อเริ่มต้น Kalmus โดยใช้ API, GUI และ CLI ขอให้สังเกตว่าอินเทอร์เฟซบรรทัดคำสั่ง (CLI) มีเฉพาะใน Kalmus v1.3.7 หรือเป็นต้นไป

การสอนโน้ตบุ๊กสำหรับส่วนต่อประสานผู้ใช้กราฟิก
การสอน Markdown สำหรับส่วนต่อประสานผู้ใช้กราฟิก
การสอนโน้ตบุ๊กสำหรับอินเทอร์เฟซการเขียนโปรแกรมแอปพลิเคชัน
การสอน Markdown สำหรับอินเทอร์เฟซบรรทัดคำสั่ง
การสอนสมุดบันทึกสำหรับการใช้ API ขั้นสูง

ผลงาน

เราสนับสนุนการมีส่วนร่วมรวมถึงการแก้ไขข้อผิดพลาดและคุณสมบัติใหม่จากผู้ใช้ชุมชนของเรา เมื่อมีส่วนร่วมในแพ็คเกจ Kalmus โปรดติดต่อผู้ดูแลโครงการทางอีเมล [email protected] หรือเปิดปัญหา หากการแก้ไขข้อผิดพลาดของคุณหรือคุณสมบัติใหม่เปลี่ยนพฤติกรรมปัจจุบันของแพ็คเกจโปรดระบุการเปลี่ยนแปลงและเหตุผลในการสนทนากับผู้ดูแลโครงการ

เราสนับสนุนให้มีการสนทนาที่ครอบคลุมและเป็นมิตร โปรดปฏิบัติตามจรรยาบรรณของเราเมื่อสื่อสาร

ชุดทดสอบ

เราให้บริการชุดทดสอบอัตโนมัติที่ครอบคลุมฟังก์ชั่นหลักของ Kalmus ก่อนที่จะเรียกใช้ชุดทดสอบอัตโนมัติในเครื่องตรวจสอบให้แน่ใจว่าคุณได้ติดตั้ง PyTest, Pytest-Cov และ Kalmus เวอร์ชันล่าสุดและคุณได้โคลนพื้นที่เก็บข้อมูลโครงการในสาขาหลัก

เพื่อเรียกใช้ชุดทดสอบ:

ไปที่ไดเรกทอรีชั้นนำของโครงการ Kalmus โคลน
ใช้คำสั่ง $ python -m pytest tests --cov=kalmus --cov-config=.coveragerc --cov-report term-missing

ดูคู่มือการทดสอบสำหรับรายละเอียดเพิ่มเติม

การอ้างอิง

หากคุณพบว่าซอฟต์แวร์ของเรามีประโยชน์ในการทำงานของคุณโปรดอ้างอิงบทความของเราที่อธิบายการใช้ Kalmus ในการวิเคราะห์สีภาพยนตร์ ดอย: 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 มูลนิธิครอบครัว Dalal และศูนย์มนุษยศาสตร์มหาวิทยาลัย Bucknell ที่ให้การสนับสนุนโครงการนี้ โครงการได้รับการเผยแพร่ภายใต้ใบอนุญาต MIT โอเพนซอร์ซ