Das modulare Programm Interaktives Musikanalyse-Tool (I-MaT) ermöglicht Visualisierungen von und statistische Abfragen zu Notendateien. Grundidee ist die Auswahl zwischen verschiedenen aufgelisteten Optionen durch Eingaben von ja-nein bzw. Optionsnummern (1, 2, 3 usw.). Die dem Programm zugrunde liegenden music21-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) werden in externen Programmen (MuseScore, matplotlib) angezeigt, in denen sie dann weiterverarbeitet bzw. weiter exportiert werden können.

Programm-Code: Sebastian Oliver Eck

Voraussetzung ist die Installation der Software Anaconda bzw. Miniconda inkl. der aktuellen Version des HfM-Environments hfm_x.x.x.yml (derzeit: hfm_1.1.2.yml; vgl. Installationsanweisungen) sowie MuseScore.

Laden Sie bitte das Python-Skript herunter (Rechtsklick, Ziel speichern unter). Speichern Sie dieses - wenn möglich - auf Ihrem Desktop (Windows)/Schreibtisch (Mac):

• Download-Link

Öffnen Sie den Anaconda Powershell Prompt/Anaconda Prompt. Diesen finden Sie in Windows in Ihrem Startmenü unter:

 Start > Anaconda 3 (64-bit) > Anaconda Powershell Prompt (anaconda3) bzw. Anaconda Prompt (anaconda3)

Unter Mac finden Sie den Anaconda Powershell Prompt/Anaconda Prompt im 'Finder'.

Alternativ können Sie eventuell unter Windows eine der beiden folgenden Optionen auswählen:

 Start > Anaconda 3 (64-bit) > Anaconda Powershell Prompt (hfm_1.x.x) bzw. Anaconda Prompt (hfm_1.x.x)

In diesem Fall können Sie Punkt 2. Aktivieren der projektspezifischen Python-Umgebung überspringen und direkt mit 3. Start des Programms fortfahren.

Beim Öffnen des Anaconda Powershell Prompt/Anaconda Prompt sehen Sie folgende Zeile:

 (base) C:\Users\Username>

Dahinter geben Sie 'conda activate hfm_1.x.x' ein. Danach drücken Sie Eingabe:

 (base) C:\Users\Username>conda activate hfm_1.x.x

Hinweis: Statt '1.x.x' geben Sie bitte die jeweilige Versionsnummer (s. oben) ein!

Der Inhalt der der Zeile voranstehenden Klammer sollte sich nun wie folgt verändert haben:

 (hfm_1.x.x) C:\Users\Username>

Falls Sie jetzt eine Fehlermeldung sehen, springen Sie zum untenstehenden Menüpunkt „Fehlerbehebung“.

Geben Sie jetzt dahinter 'python ' ein und ziehen Sie die das Icon der Programm-Datei 'I-MaT - Interaktives Musikanalyse-Tool.py' in das Fenster des Prompt. Der Dateipfad wird nun automatisch in das Fenster kopiert. Drücken Sie Eingabe:

 (hfm_1.x.x) C:\Users\Username>python "[Pfad/]I-MaT - Interaktives Musikanalyse-Tool.py"

Hinweis: Achten Sie auf die Eingabe der doppelten Anführungszeichen!

Beispiel: bei einer auf dem Desktop (Windows) gespeicherten Programmdatei:

 (hfm_1.x.x) C:\Users\Username>python "C:\Users\Username\Desktop\I-MaT - Interaktives Musikanalyse-Tool.py"

Das Programm startet nach wenigen Sekunden!

Sollten Sie bei Eingabe des Befehls:

 (base) C:\Users\Username>conda activate hfm_1.x.x

eine Fehlermeldung erhalten, ist entweder die Projektspezifische Python-Umgebung 'hfm_1.x.x' nicht ordnungsgemäß installiert, oder Sie haben die falsche Versionsnummer angegeben. Um zu überprüfen, welche projektspezifischen Python-Umgebungen installiert sind, geben Sie folgenden Befehl in den Anaconda Powershell Prompt/Anaconda Prompt ein und drücken Sie Eingabe:

 (base) C:\Users\Username>conda info --envs

Folgende Liste zeigt die auf Ihrem Rechner installierten projektspezifischen Python-Umgebungen.

 # conda environments:
 #
 base                  *  C:\Users\Username\anaconda3
 hfm_1.0.0                C:\Users\Username\anaconda3\envs\hfm_1.0.0

Sollte hier der Eintrag die aktuelle Version von 'hfm_1.x.x' fehlen, installieren Sie die projektspezifische Python-Umgebungen, indem Sie der Installationsanweisung unter Windows, Mac oder Linux im Menüpunkt 2. Projektspezifische Python-Umgebung folgen.

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, aus der Sie durch Eingabe einer Ziffer eine Option auswählen können.

Bei der ersten Benutzung müssen Sie zudem bestimmte music21-Settings einstellen, falls Sie dies nicht bereits für die Jupyter-Notebooks erledigt haben. Sie werden beim Start des Programms durch die Konfiguration Ihrer music21-Settings-Datei geleitet.

Vgl. hierzu: Settings

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:

 1    FILE: Menüauswahl                            <Grundlegende Funktionen>
 2    TOOL: Menüauswahl (statistische Analysen)    <Auswahl verschiedener statistischer Analyse-Tools>
 3    TOOL: Menüauswahl (Darstellung)              <Auswahl verschiedener Darstellungs-Tools>
 4    TOOL: Menüauswahl (Mustersuche)              <Auswahl verschiedener Tools zur Mustersuche>
 5    SETT: Einstellungen                          <Einstellungen in der music21 environment-Datei>
 6    HELP: Programmerläuterungen                  <Hinweise zur Bedienung des Programms>
 7    EXIT: Programm beenden                       <Beendet das Python-Skript>

Alle weiteren Schritte sind selbsterklärend. Viel Spaß!

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 (MuseScore) öffnet - falls Sie dies nicht bereits für die Jupyter-Notebooks erledigt haben oder Sie beim erstmaligen Starten des Programms nicht ohnehin durch die Konfiguration geleitet werden. Wählen Sie dazu:

 2 SETT: Einstellungen

Bei der Option

 3 ENVT: Einstellungen neu konfigurieren

werden Sie zunächst aufgefordert, die bestehenden Settings zu löschen. Stimmen Sie dem zu. Anschließend erhalten Sie die Möglichkeit, die Settings neu zu konfigurieren. Dabei müssen Sie den lokalen Pfad zu Ihrem Noteneditor sowie zu Ihrem Ordner für die Grafiken, Notendateien und Tabellen bereithalten.