Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- sonic_annotator [2021/06/08 06:44]
martin
+++ sonic_annotator [2021/09/08 10:52] (aktuell)
martin
@@ 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. Die Ergebnisse dieser Korpusstudie werden in eine Datei (csv oder rdf) geschrieben. Allerdings ist die Bedienung nur über ein Befehlsfenster (Power Shell) möglich.
+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.
-. Sonic-Annotator herunterladen (https://code.soundsoftware.ac.uk/projects/sonic-annotator/files) und entpacken, z.B. nach D:\software\sonic-annotator-1.6-win32
+==== Bedienung des Programms ====
-. Power-Shell öffnen und ins entsprechende Verzeichnis wechseln (mit dem //cd//-Befehl; //c//hange //d//irectory):
+. Sonic-Annotator herunterladen (https://code.soundsoftware.ac.uk/projects/sonic-annotator/files) und entpacken, z.B. nach C:\Programme\sonic-annotator-1.6-win32
-   cd D:\software\sonic-annotator-1.6-win32
-Die lokal verfügbaren Vamp-Plugins werden mit dem folgenden Befehl angezeigt:
-   D:\software\sonic-annotator-1.6-win32> .\sonic-annotator --list
-   (.\ ist notwendig, wenn der Zugriff auf sonic-annotator verweigert wird)
-Eine Beschreibung der Vamp plugins wird angezeigt über:
+. //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 '... >' )
+{{: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 die Zugriffsrechte auf sonic-annotator verweigert werden)
+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 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 Audio01.mp3 -w csv --csv-separator ";"
+. 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:
-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 in Zellen dargestellt.
+   .\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'.)
-   .\sonic-annotator -d vamp:qm-vamp-plugins:qm-tempotracker:tempo audio.mp3 -w csv --csv-separator ";"
+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.
-. Mehrfache (rekursive) Abfrage: Einen Ordner bennenen, z.B. //d:/Sound// und die zu untersuchenden Dateien in den Ordner legen. Dann den folgenden Befehl eingeben:
+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 d:/sound -w csv
-Um alle Ergebnisse in eine Datei zu schreiben: --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.
+   .\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 D:/Software/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 (lokale) Tempo der einzelnen Stücke
+  * die Harmonik der einzelnen Stücke
+  * die Stimmung (Abweichung von 440 Hz) der Stücke