Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Beide Seiten der vorigen Revision Vorhergehende Überarbeitung Nächste Überarbeitung | Vorhergehende Überarbeitung | ||
interaktive_musikanalyse [2021/10/26 14:25] martin [Bedienung] |
interaktive_musikanalyse [2023/08/22 10:42] (aktuell) martin [Bildung und Training] |
||
---|---|---|---|
Zeile 1: | Zeile 1: | ||
===== Interaktives Musikanalyse-Tool (I-MaT) ===== | ===== Interaktives Musikanalyse-Tool (I-MaT) ===== | ||
- | Das modulare Programm // | + | Das modulare Programm // |
- | Durch einfache Dialoge und die Auswahl aus den angezeigten Optionen können schnell Ergebnisse erzielt werden. Die Ergebnisse (Visualisierungen, | + | Durch einfache Dialoge und die Auswahl aus den angezeigten Optionen können schnell Ergebnisse erzielt werden. Die Ergebnisse (Visualisierungen, |
- | Programm-Code: Sebastian Oliver Eck | + | Programmcode: Sebastian Oliver Eck |
- | ==== Download | + | ==== Dokumentation |
- | Voraussetzung | + | 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, |
+ | Abschnitte innerhalb der Dokumentation bieten detaillierte Informationen darüber, wie man das Interaktive Musik Analyse Tool verwendet, von [[https:// | ||
- | === Download des Programms === | + | 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! |
- | Laden Sie bitte das Python-Skript herunter (// | + | ==== I-MaT: Installation, |
- | Speichern Sie dieses - wenn möglich - auf Ihrem Desktop (Windows)/ | + | |
- | * [[https:// | + | |
+ | ===Installation=== | ||
- | === Start des Programms === | + | //Zuerst// öffnen Sie bitte das Command Prompt/ |
+ | **Windows** | ||
- | == 1. Öffnen des Anaconda Powershell | + | Es gibt mehrere Möglichkeiten, |
+ | Drücken Sie die '' | ||
+ | Geben Sie im Ausführen-Dialogfeld '' | ||
+ | **macOS** | ||
- | Öffnen Sie den //Anaconda Powershell Prompt/ | + | Es gibt mehrere Möglichkeiten, |
- | Start > Anaconda 3 (64-bit) > Anaconda Powershell Prompt (anaconda3) bzw. Anaconda Prompt (anaconda3) | + | Öffnen Sie '' |
+ | Navigieren Sie zum '' | ||
+ | Suchen Sie '' | ||
+ | Alternativ: | ||
- | Unter Mac finden | + | Drücken |
+ | geben Sie '' | ||
- | == Alternative: | + | // |
- | Alternativ können | + | < |
+ | pip install imat | ||
+ | </ | ||
+ | Hinweis: Die Installation ist nur einmal notwendig. Nach erfolgreicher Installation von I-MaT starten | ||
- | Start > Anaconda 3 (64-bit) > Anaconda Powershell Prompt (hfm_1.x.x) bzw. Anaconda Prompt (hfm_1.x.x) | + | MuseScore Installation: |
- | In diesem Fall können Sie Punkt //2. Aktivieren der projektspezifischen Python-Umgebung// überspringen und direkt mit //3. Start des Programms// fortfahren. | + | **Achtung: |
+ | Die installation von MuseScore ist kostenfrei und wird daher **dringend empfohlen**. MuseScore kann direkt auf [[https:// | ||
- | == 2. Aktivieren der projektspezifischen Python-Umgebung | + | ===I-MaT starten=== |
+ | Um das Tool zu starten, geben Sie einfach den folgenden Befehl in Ihr Command Prompt/ | ||
+ | < | ||
+ | imat | ||
+ | </ | ||
- | Beim Öffnen des //Anaconda Powershell Prompt/ | + | Nach dem Start von I-MaT wird das folgende |
- | (base) C:\Users\Username> | + | < |
+ | I-MaT - Interactive Music Analysis Tool, v3.2.1, | ||
- | Dahinter geben Sie //' | + | Department of Musicology Weimar-Jena, |
- | (base) C: | + | MIT License, Copyright |
- | Hinweis: Statt //' | + | ---------------------------------------------------------------------- |
- | Der Inhalt der der Zeile voranstehenden Klammer sollte sich nun wie folgt verändert haben: | + | LOCATION: Start Menu |
- | | + | Please make a selection from the options below by entering the entry index number: |
- | Falls Sie jetzt eine Fehlermeldung sehen, springen Sie zum untenstehenden Menüpunkt "// | + | 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? (<No. of menu item>): | ||
+ | </ | ||
- | == 3. Start des Programms == | + | Abbildung 1: Das Interaktive Musik Analyse Tool (I-MaT) - Startmenü (Version |
+ | 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, | ||
+ | ==== Hinweise und Support ==== | ||
- | Geben Sie jetzt dahinter | + | **Warnung: |
- | //' | + | |
- | | + | I-MaT wird Sie durch diesen gesamten Prozess führen. |
- | Hinweis: Achten Sie auf die Eingabe der doppelten Anführungszeichen! | + | < |
+ | 4 CONF: Update Software Paths and Preferences | ||
+ | </ | ||
- | Beispiel: bei einer auf dem Desktop (Windows) gespeicherten Programmdatei: | + | 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:// | ||
- | Das Programm startet nach wenigen Sekunden! | + | 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, | ||
- | === Fehlerbehebung === | + | 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:// | ||
+ | Während I-MaT praktisch alle Funktionalitäten der integrierten Python-Pakete für Music Information Retrieval (MIR)/ | ||
- | Sollten Sie bei Eingabe des Befehls: | + | 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 ==== |
- | eine Fehlermeldung erhalten, ist entweder die Projektspezifische Python-Umgebung '// | + | 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, |
- | Folgende Liste zeigt die auf Ihrem Rechner installierten projektspezifischen Python-Umgebungen. | + | Darüber hinaus öffnet das modulare Design von I-MaT Möglichkeiten für die Durchführung von didaktischen Projekten rund um musikwissenschaftliche Programmierung, |
- | # conda environments: | + | Indem sie I-MaT nutzen, können SchülerInnen wertvolle analytische Fähigkeiten entwickeln, die nicht nur in der Musikwissenschaft, |
- | # | + | |
- | | + | |
- | hfm_1.0.0 C: | + | |
- | Sollte hier der Eintrag die aktuelle Version von //' | + | Das Interaktive Musik Analyse Tool, I-MaT, sollte als Beitrag zur Computational Musicology oder Digitalen Musikwissenschaft innerhalb |
+ | ==== Weitere Informationen (Externe Links) ==== | ||
+ | [[https:// | ||
+ | “Possibilities for Data-Driven Humanities”, | ||
+ | Vortrag von Sebastian Oliver Eck: // | ||
- | ==== Bedienung ==== | + | Online-Dokumentation (readthedocs.io): |
+ | GitHub Repository: https:// | ||
- | Das Programm ist selbsterklärend: Vor dem blinkenden Cursor steht jeweils, was Sie als nächstes tun müssen. Bei mehreren Auswahloptionen werden diese in einer Liste dargestellt, | + | PyPi Repository: https://pypi.org/project/imat/ |
- | + | ||
- | Bei der ersten Benutzung müssen Sie zudem bestimmte // | + | |
- | + | ||
- | Vgl. hierzu: [[interaktive_musikanalyse# | + | |
- | + | ||
- | Anschließend wählen Sie bitte: | + | |
- | 1 PROG: Analyse eines einzelnen Werkes | + | |
- | + | ||
- | Nachdem Sie eine Notendatei geladen haben, kommen Sie in das sog. Hauptmenu, das in seiner Grobgliederung dem Aufbau der //Jupyter-Notebooks Basics// entspricht: | + | |
- | + | ||
- | | + | |
- | | + | |
- | | + | |
- | | + | |
- | | + | |
- | | + | |
- | | + | |
- | + | ||
- | Alle weiteren Schritte sind selbsterklärend. Viel Spaß! | + | |
- | + | ||
- | + | ||
- | ====Settings==== | + | |
- | + | ||
- | Bei der ersten Benutzung müssen Sie die //music21//-Settings einstellen, damit Sie Notendateien aus dem Internet herunterladen können und sich für die Notenanzeige Ihr Noteneditor (// | + | |
- | 2 SETT: Einstellungen | + | |
- | + | ||
- | Bei der Option | + | |
- | 3 ENVT: Einstellungen neu konfigurieren | + | |
- | werden Sie zunächst aufgefordert, | + |