===== Interaktives Musikanalyse-Tool (I-MaT) ===== Das modulare Programm //Interaktives Musikanalyse-Tool (I-MaT)// ermöglicht Visualisierungen von und statistische Abfragen zu Notendateien. Grundidee ist die Auswahl aus aufgelisteten Menu-Optionen durch Eingaben der zugehörigen Indexnummern (//1, 2, 3// usw.). Die dem Programm zugrunde liegenden //music21-/////MidiTok-//Befehle sind für den Benutzer nicht sichtbar. Durch einfache Dialoge und die Auswahl aus den angezeigten Optionen können schnell Ergebnisse erzielt werden. Die Ergebnisse (Visualisierungen, Diagramme, Noten, csv-Dateien) können in I-Mat, aber auch in externen Programmen (//MuseScore//, //PSPP/SPSS//) angezeigt werden, in denen sie dann weiterverarbeitet werden können. Programmcode: Sebastian Oliver Eck ==== Dokumentation und User Guides ==== I-MaT ist ein innovatives Tool, dessen Ziel es ist, umfassende computergestützte statistische Analysen musikalischer Werke durch eine benutzerfreundliche Oberfläche zu erleichtern. I-MaT bietet eine umfassende Reihe von Funktionen, die es ermöglichen, Musikstücke umfassend statistisch zu analysieren. Die Dokumentation (verfügbar auf [[https://i-mat.readthedocs.io/en/latest/|readthedocs.io]]) dient als Leitfaden und soll Einblicke in die Funktionen von I-MaT und sein modulares Konzept geben und sowohl ErstnutzerInnen als auch erfahrenen ForscherInnen dabei helfen, das Tool effektiv zu nutzen. Abschnitte innerhalb der Dokumentation bieten detaillierte Informationen darüber, wie man das Interaktive Musik Analyse Tool verwendet, von [[https://i-mat.readthedocs.io/en/latest/getting_started.html|Download und Installation]], über [[https://i-mat.readthedocs.io/en/latest/contribute.html|Codeerweiterung]], bis hin zur Anwendung in der Musikanalyse. Darüber hinaus finden Sie eine detaillierte Beschreibung des [[https://i-mat.readthedocs.io/en/latest/module_files/src.html|Quellcodes]] von I-MaT, die die verschiedenen Pakete und Module erläutert, aus denen das Tool besteht. Diese Dokumentation versorgt Sie mit dem notwendigen Wissen, um in I-MaT zu navigieren, seine Funktionen zu erkunden und Ihre eigenen Analysen mit dem Tool durchzuführen! ==== I-MaT: Installation, Start und Nutzung ==== ===Installation=== //Zuerst// öffnen Sie bitte das Command Prompt/Terminal in Windows/Mac, indem Sie die folgenden Schritte ausführen: **Windows** Es gibt mehrere Möglichkeiten, das Command Prompt in Windows zu öffnen, hier ist eine davon: Drücken Sie die ''Windows-Taste + R'', um das Ausführen-Dialogfeld zu öffnen. Geben Sie im Ausführen-Dialogfeld ''cmd'' ein und drücken Sie dann die ''Eingabetaste''. Dies öffnet das Command Prompt-Fenster. **macOS** Es gibt mehrere Möglichkeiten, das Terminal in macOS zu öffnen, hier sind zwei davon: Öffnen Sie ''Finder''. Navigieren Sie zum ''Anwendungen''-Ordner und gehen Sie dann zu ''Dienstprogramme''. Suchen Sie ''Terminal'' und doppelklicken Sie darauf, um es zu öffnen. Alternativ: Drücken Sie ''Command + Leertaste'', um ''Spotlight'' zu öffnen, geben Sie ''Terminal'' ein und drücken Sie die Eingabetaste. //Zweitens//, installieren Sie bitte das Interaktive Musik Analyse Tool (I-MaT). Tun Sie dies, indem Sie die folgende Zeile in das Command Prompt/Terminal-Fenster eingeben: pip install imat Hinweis: Die Installation ist nur einmal notwendig. Nach erfolgreicher Installation von I-MaT starten Sie das Tool, indem Sie die folgenden Schritte befolgen. MuseScore Installation: **Achtung:** NutzerInnen, die sämtliche Funktionen von I-MaT nutzen wollen, müssen zwingend ein Notationsprogramm, wie etwa das kostenfreie Programm MuseScore installieren. Die installation von MuseScore ist kostenfrei und wird daher **dringend empfohlen**. MuseScore kann direkt auf [[https://musescore.org/en]] heruntergeladen werden. ===I-MaT starten=== Um das Tool zu starten, geben Sie einfach den folgenden Befehl in Ihr Command Prompt/Terminal-Fenster ein: imat Nach dem Start von I-MaT wird das folgende Menü in Ihrer Konsole angezeigt: I-MaT - Interactive Music Analysis Tool, v3.2.1, (2023). Project: "Computer-Assisted Music Analysis" Department of Musicology Weimar-Jena, University of Music Franz Liszt Weimar, Germany MIT License, Copyright (c) 2023 S.O. Eck. ---------------------------------------------------------------------- LOCATION: Start Menu Please make a selection from the options below by entering the entry index number: No. Menu item 1 PROG: Analysis of one sheet music file 2 CONV: Conversion of multiple music files 3 TOKE: Tokenisation of multiple music files 4 CONF: Update Software Paths and Preferences Which menu item should be executed? (): Abbildung 1: Das Interaktive Musik Analyse Tool (I-MaT) - Startmenü (Version 3.2.1) Die Verwendung des Programms ist relativ einfach - die textbasierte Befehlszeilenschnittstelle (CLI) des Programms ermöglicht es Ihnen, aus einer Liste von Menüeinträgen auszuwählen, indem Sie die entsprechende Eintragsindexnummer eingeben (s. Abbildung 1). Alle weiteren Schritte sind selbsterklärend. Viel Spaß! ==== Hinweise und Support ==== **Warnung:** Beim ersten Start von I-MaT müssen Sie in den meisten Fällen die //music21// Einstellungen konfigurieren, um Musikdateien aus dem Internet herunterladen und Musikdateien in einem Musikeditor (z.B., //MuseScore//) anzeigen zu können. I-MaT wird Sie durch diesen gesamten Prozess führen. 4 CONF: Update Software Paths and Preferences Die Einstellungen können später angepasst werden, indem Sie den oben gezeigten Menüeintrag im Startmenü von I-MaT auswählen. Falls Ihnen das alles zu schnell ging, keine Sorge! Sie finden eine ausführliche Benutzeranleitung zur Installation und zum Start von I-MaT im Abschnitt [[https://i-mat.readthedocs.io/en/latest/getting_started.html|Getting Started with I-MaT]] der Online-Dokumentation. Wenn Sie Schwierigkeiten bei der Verwendung des Programms haben oder Fragen oder Anregungen zur weiteren Verbesserung der Funktionen von I-MaT haben, wenden Sie sich bitte an den Autor, Sebastian Oliver Eck (). ==== I-MaT: Funktionen und Zugänglichkeit ==== Um der oft steilen Lernkurve bei Python-basierten Musikanalysetools wie Music21 oder CAMAT entgegenzuwirken, wurde das Interaktive Musik Analyse Tool (I-MaT) speziell mit Blick auf Benutzerfreundlichkeit konzipiert. I-MaT nutzt einen neuen und innovativen Ansatz, um auf verschiedene Python-Bibliotheken wie music21 oder MidiTok für textuelle Musikanalyse zuzugreifen, mit ihnen zu arbeiten und sie innerhalb einer einheitlichen, benutzerfreundlichen textbasierten Befehlszeilenschnittstelle (CLI) zu implementieren. Mit I-MaT können BenutzerInnen schnell Ergebnisse erzielen, indem sie durch einfache dynamische Menüstrukturen navigieren und Methoden und Werkzeuge aus vordefinierten Optionen auswählen (siehe Abbildung 1). Das Tool verwendet eine zugängliche und leicht erweiterbare textbasierte CLI, wobei die zugrunde liegenden Befehle von Music21 und MidiTok für NutzerInnen unsichtbar bleiben. Trotz einer notwendigen minimalen Vertrautheit mit der Befehlszeilenumgebung bietet die Präferenz für eine CLI gegenüber einer GUI einen Kompromiss zwischen Benutzerfreundlichkeit und einfacher Code-Erweiterbarkeit. Dieser Kompromiss war notwendig, um die Einstiegshürde so niedrig wie möglich zu halten und eine breite Nutzung und Nutzerbeteiligung an der laufenden Entwicklung des Tools über [[https://github.com/sebastian-eck/I-MaT|GitHub]] zu fördern. Um die Zugänglichkeit weiter zu erhöhen, wurde I-MaT auf [[https://pypi.org/project/imat/|Pypi.org]] zugänglich gemacht, was eine einfache Installation über integrierte Paketverwaltungssysteme wie den häufig verwendeten Python Pip Installer ermöglicht. Der Quellcode von I-MaT wird durch eine umfangreiche [[https://i-mat.readthedocs.io/en/latest/|Online-Dokumentation]] ergänzt, die sowohl BenutzerInnen als auch an der Erweiterung des Tools interessieren ProgrammierInnen Hilfestellungen bietet. Während I-MaT praktisch alle Funktionalitäten der integrierten Python-Pakete für Music Information Retrieval (MIR)/Tokenisierung, wie z.B. music21/MidiTok, umfasst, sind die Funktionen von I-MaT derzeit auf einen repräsentativen, aber gut getesteten Satz von statistischen Analyse-, Export-, Visualisierungs-, Konvertierungs- und Musik-Tokenisierungswerkzeugen beschränkt. Mit all diesen Vorteilen ist I-MaT ein sehr flexibles und leistungsstarkes Werkzeug, das den Bedürfnissen einer vielfältigen Benutzergruppe gerecht werden könnte, von AnfängerInnen in der computergestützten Musikanalyse bis hin zu fortgeschrittenen NutzerInnen. ==== Bildung und Training ==== Zusätzlich zu seinen analytischen Fähigkeiten dient I-MaT als effektives didaktisches Werkzeug, das darauf abzielt, die Kluft zwischen Musikwissenschaft und dem Feld der computergestützten Musikanalyse und Music Information Retrieval (MIR) zu schließen. Die vielfältigen Funktionen von I-MaT könnten wertvolle Unterstützung für Musik- und Musikwissenschaftskurse auf Gymnasial- und Universitätsebene bieten. Seine benutzerfreundliche Oberfläche und einfache Installation machen I-MaT zu einem idealen Werkzeug für SchülerInnen und Studierende, um schnell Ergebnisse zu erzielen und verschiedene analytische Ansätze mit Hilfe von computergestützten Methoden kennenzulernen. Darüber hinaus öffnet das modulare Design von I-MaT Möglichkeiten für die Durchführung von didaktischen Projekten rund um musikwissenschaftliche Programmierung, mit dem zusätzlichen Vorteil, dass deren Ergebnisse und neu geschaffenen Funktionen nahtlos über kollaborative Plattformen wie GitHub in I-MaT integriert werden können. Indem sie I-MaT nutzen, können SchülerInnen wertvolle analytische Fähigkeiten entwickeln, die nicht nur in der Musikwissenschaft, sondern auch in anderen Bereichen der Geisteswissenschaften, in denen Methoden der Datenanalyse immer wichtiger werden, zunehmend Voraussetzung sind. Das Interaktive Musik Analyse Tool, I-MaT, sollte als Beitrag zur Computational Musicology oder Digitalen Musikwissenschaft innerhalb der Digital Humanities gesehen werden. ==== Weitere Informationen (Externe Links) ==== [[https://jadh2023.nijl.ac.jp/home|JADH2023]]: 12. Jahreskonferenz der Japanese Association for Digital Humanities (JADH), \\ “Possibilities for Data-Driven Humanities”, National Institute of Japanese Literature (online), 20.9. - 22.9. 2023: \\ Vortrag von Sebastian Oliver Eck: //Interactive Music Analysis Tool (I-MaT)// Online-Dokumentation (readthedocs.io): https://i-mat.readthedocs.io/en/latest/ GitHub Repository: https://github.com/sebastian-eck/I-MaT PyPi Repository: https://pypi.org/project/imat/