command line tool "apollon hmm"
Das apollon Subkommando "hmm" soll Hidden Markov Modelle auf Grundlage von bereits extrahierten Merkmalen trainieren. Der Aufauf lautet:
apollon hmm TRACK_FILE FEATURE_PATH [-m --MSTATES]
Der Parameter TRACK_FILE
nimmt als Argument den Pfad zu einer Datei mit extrahierten sound features. Die Stuktur der track files ist gesondert aufgeführt.
Apollon HMMs können nur bezüglich eines einzelnen Merkmals trainiert werden. Deshalb wird beim Kommandoaufruf das gewünschte Merkmal an den Parameter FEATURE_PATH
übergeben. Die Struktur des Feature_PATH
richtet sich nach dem Inhalt der angegebenen track Datei: es werden die Kindknoten bis hin zum gewünschten Merkmal relativ zum features
-Knotens, getrennt durch .
, angegeben. Als Beispiel sei folgendes JSON gegeben:
``
{ ...,
"features": {
"onsets": {
"peak": { ... },
"times": { ... }
}
"spectrum": { ... }
Die --MSTATES
kontrolliert die Anzahl der anzunehmenden HMM Zustände und erwarted einen Ganzzahl. Da in COMSAR bis auf Weiteres die Anzahl der Zustände für jedes zu analysierende Musikstück gleich sein muss, erhält MSTATES
ein default aurgument und muss nicht explizit angegeben werden.