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

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 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 Download und Installation, über Codeerweiterung, bis hin zur Anwendung in der Musikanalyse. Darüber hinaus finden Sie eine detaillierte Beschreibung des 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!

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.

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                                           <Explanation>

1         PROG: Analysis of one sheet music file              <Analysis of a single piece of music>
2         CONV: Conversion of multiple music files            <Conversion of multiple music files within one folder>
3         TOKE: Tokenisation of multiple music files          <Tokenisation of multiple music files within one folder>
4         CONF: Update Software Paths and Preferences         <Update or redefine paths to essential software and user preferences>

Which menu item should be executed? (<No. of menu item>):

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ß!

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 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 (imat.inquiries@gmail.com).

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 GitHub zu fördern. Um die Zugänglichkeit weiter zu erhöhen, wurde I-MaT auf 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 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.

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.

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/