Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- sonic_annotator [2021/06/08 15:31] – martin
+++ sonic_annotator [2025/12/04 21:08] (aktuell) – Externe Bearbeitung 127.0.0.1
@@ Zeile 1: / Zeile 1: @@
-====== Tutorial: Korpusstudien mit dem Sonic Annotator ======
+===== Tutorial: Korpusstudien mit dem Sonic Annotator =====
-Mit dem [[https://www.vamp-plugins.org/sonic-annotator/|Sonic Annotator]] können bequem auf einen Schlag mehrere (hunderte!) von Audio-Dateien mit Vamp Plugins ausgewertet. Das Programm läuft ohne Installation. Die Bedienung verläuft über ein Befehlsfenster (Power Shell), in dem Befehle eingetippt werden müssen.
+Mit dem [[https://www.vamp-plugins.org/sonic-annotator/|Sonic Annotator]] können bequem auf einen Schlag mehrere (Hunderte!) von Audio-Dateien mit Vamp Plugins ausgewertet. Das Programm läuft ohne Installation. Die Bedienung erfolgt über ein Befehlsfenster (Power Shell), in dem Befehle eingetippt werden müssen.
 ==== Bedienung des Programms ====
@@ Zeile 7: / Zeile 7: @@
 . Sonic-Annotator herunterladen (https://code.soundsoftware.ac.uk/projects/sonic-annotator/files) und entpacken, z.B. nach C:\Programme\sonic-annotator-1.6-win32
-. Power-Shell öffnen und ins entsprechende Verzeichnis wechseln (mit dem //cd//-Befehl; //c//hange //d//irectory):
+. //Power-Shell// (Windows: beim Rechtsklick ins Startmenu wird der //Power Shell// in Programm-Menu sichtbar) oder Terminal-Fenster (Mac) öffnen und ins entsprechende Verzeichnis wechseln (mit dem //cd//-Befehl; //c//hange //d//irectory):
    cd C:\Programme\sonic-annotator-1.6-win32
+   (Tippen Sie den Befehl einfach hinter das '... >' )
-Die lokal verfügbaren Vamp-Plugins werden mit dem folgenden Befehl angezeigt:
+{{:vamp_plugins.png?400|}}
+Die auf Ihrem Rechner im //Vamp Plugin//-Ordner verfügbaren Vamp-Plugins werden mit dem folgenden Befehl angezeigt:
    .\sonic-annotator --list
-   (.\ ist notwendig, wenn der Zugriff auf sonic-annotator verweigert wird)
+   (.\ ist notwendig, wenn die Zugriffsrechte auf sonic-annotator verweigert werden)
-   Tippen Sie den Befehl einfach hinter das '>'
-   C:\Programme\sonic-annotator-1.6-win32> .\sonic-annotator --list
-Eine Beschreibung der Vamp plugins wird angezeigt über:
+Eine Beschreibung der einzelnen Vamp Plugins wird durch den folgenden Befehl angezeigt, z.B. des Queen Mary Tempotrackers:
    .\sonic-annotator -s  vamp:qm-vamp-plugins:qm-tempotracker:tempo
+Hier sind auch die Standardeinstellungen des jeweiligen Vamp Plugins aufgeführt. Veränderungen dieser Standardeinstellungen können leider nur bei Verwendung des RDF/Turtle-Formats vorgenommen werden. Informationen hierzu finden Sie [[https://code.soundsoftware.ac.uk/projects/sonic-annotator/wiki|hier]].
+Zwei Hinweise zum Umgang mit Power Shell / Kommando-Fenstern:
+  * Die Cursor-Taste //Cursor up// wiederholt den bzw. die letzten Befehl(e)!
+  * Nutzen Sie die Möglichkeiten von //cut & paste//, um Befehle oder Teile davon zu kopieren (aus diesem wiki, Pfadnamen usw.).
-. Einfache Abfrage eines Plugins zu einer Audiodatei audio.mp3:
+. Mit dem folgenden Befehl funktioniert die Abfrage des Tempotracker-Plugins zu einer Audiodatei 'Audio01.mp3':
-   .\sonic-annotator -d vamp:qm-vamp-plugins:qm-tempotracker:tempo audio.mp3 -w csv
+   .\sonic-annotator -d vamp:qm-vamp-plugins:qm-tempotracker:tempo Audio01.mp3 -w csv
-Die Ergebnisse werden automatisch in eine .csv-Datei geschrieben (-w csv), die nach dem Vamp-Plugin benannt ist. Mit der Option  - -csv-separator ";" werden die Ergebnisse durch ein Semikolon getrennt, sodass sie in Tabellenkalkulations-Software (wie //Excel//) in Zellen dargestellt werden.
+Die Ergebnisse werden automatisch in eine .csv-Datei geschrieben ('-w csv'), die nach dem Audio-File und dem Vamp-Plugin benannt wird. \\
+Mit der Option  - -csv-separator ";" werden die Ergebnisse durch ein Semikolon getrennt, sodass sie in Tabellenkalkulations-Software (wie //Excel//) in Zellen dargestellt werden.
-   .\sonic-annotator -d vamp:qm-vamp-plugins:qm-tempotracker:tempo audio.mp3 -w csv --csv-separator ";"
+   .\sonic-annotator -d vamp:qm-vamp-plugins:qm-tempotracker:tempo Audio01.mp3 -w csv --csv-separator ";"
-   Cursor-Taste //Cursor up//: wiederholt den bzw. die letzten Befehl(e)!
+. Mehrfache (rekursive) Abfragen: Legen Sie alle Audio-Dateien, die Sie auswerten wollen, in einen Ordner, z.B. //c:/sound//. Dann geben Sie den folgenden Befehl ein:
-. Mehrfache (rekursive) Abfrage: Einen Ordner bennenen, z.B. //c:/Sound// und die zu untersuchenden Dateien in den Ordner legen. Dann den folgenden Befehl eingeben:
    .\sonic-annotator -d vamp:qm-vamp-plugins:qm-tempotracker:tempo -r c:/sound -w csv
+   (Wichtig ist das '-r' hinter dem Vamp Plugin-Name, für 'recursive'.)
-Um alle Ergebnisse in eine Datei zu schreiben: - -csv-one-file "results.csv" ergänzen.
+Um alle Ergebnisse in eine einzige Datei mit dem Dateinamen 'results.csv' zu schreiben, nutzen Sie folgenden Befehlszusatz: - -csv-one-file "results.csv" ergänzen.
-Hier ein Beispiel für einen Gesamtbefehl zur Ermittlung der Tempi einer Reihe von Audio-Dateien, die im Ordner //d:/sound// liegen.
+Hier ein Beispiel für einen Gesamtbefehl zur Ermittlung der Tempi einer Reihe von Audio-Dateien, die im Ordner //c:/sound// liegen.
-   .\sonic-annotator -d vamp:qm-vamp-plugins:qm-tempotracker:tempo -r c:/Sound -w csv --csv-one-file "results.csv" --csv-separator ";"
+   .\sonic-annotator -d vamp:qm-vamp-plugins:qm-tempotracker:tempo -r c:/sound -w csv --csv-one-file "results.csv" --csv-separator ";"
 ==== Aufgaben ====
 Laden Sie die Stücke einer CD oder einer Playlist in einen Ordner und vergleichen Sie
-  * das Tempo der einzelnen Stücke
+  * das (lokale) Tempo der einzelnen Stücke
   * die Harmonik der einzelnen Stücke
   * die Stimmung (Abweichung von 440 Hz) der Stücke