Tony: a tool for melody transcription

h1. PYIN Parameters

Tony uses a Vamp plugin called "pYIN":/projects/pyin for pitch and note analysis.

The plugin can be used in other Vamp plugin hosts as well - see the "pYIN project page":/projects/pyin to download the plugin separately from Tony.

pYIN has a number of processing parameters which can be adjusted, and Tony contains a number of options (on the Analysis menu) which adjust some of them. However, the names, identifiers, and default values of the pYIN parameters do not match those used in Tony. In some cases this is because the parameters found in pYIN are continuous ranges, while the settings in Tony are all on-off toggles.

Here is a table showing the correspondence between Tony menu options and pYIN parameters, as of Tony v2.1 and pYIN v1.1.

|*Tony menu option*|*pYIN parameter name*|*pYIN parameter id*|*pYIN parameter type*|*Default in Tony*|*Default in pYIN*|*Notes*|

|Unbiased Timing (slow)|Use non-standard precise YIN timing (slow)|@precisetime@|Toggle|Off|Off||

|Penalise Soft Pitches|Suppress low amplitude pitch estimates|@lowampsuppression@|Range 0.0-1.0|0.2|0.1|Set to 0.0 when option switched off; see comment below|

|High Onset Sensitivity|Onset sensitivity|@onsetsensitivity@|Range 0.0-1.0|0.7|0.7|Set to 0.0 when option switched off|

|Drop Short Notes|Duration pruning threshold|@prunethresh@|Range 0.0-0.2|0.1|0.1|Set to 0.0 when option switched off|

There are also some parameters in pYIN that cannot be controlled within Tony:

Screenshots:

|*Options in the Analysis menu of Tony that control pYIN parameters* !Screenshot_2019-11-18_13-03-34.png! |*Options available when using pYIN directly in Sonic Visualiser* !Screenshot_2019-11-18_13-04-25.png!|