Wiki » History » Version 53

Matthias Mauch, 2014-07-16 12:51 PM

1 23 Matthias Mauch
{{toc}}
2 1 Matthias Mauch
3 24 Matthias Mauch
h1. Tony Introduction
4 24 Matthias Mauch
5 19 Matthias Mauch
Tony is a program for computer-aided melody annotation. It has a graphical interface based on the  "SV libraries":/projects/sv and uses the "pYIN":/projects/pyin Vamp plugin to extract pitch track and notes from monophonic audio.
6 19 Matthias Mauch
7 43 Matthias Mauch
h2. Installation
8 19 Matthias Mauch
9 47 Chris Cannam
We provide ready-to-use software builds for Windows and Mac OSX on the "Downloads page":/projects/tony/files. On Windows you can simply download and run the installer (.msi), and on OSX you download the disk image (.dmg), open it and drag "Tony" into your Applications folder.
10 1 Matthias Mauch
11 47 Chris Cannam
For Linux users with ample compilation experience we also provide the source code, available on the "Downloads page":/projects/tony/files. See [[Compiling Tony|here]] for notes on how to compile from source.
12 24 Matthias Mauch
13 43 Matthias Mauch
h2. User Interface
14 1 Matthias Mauch
15 1 Matthias Mauch
An annotated screenshot of the Tony user interface.
16 1 Matthias Mauch
17 50 Matthias Mauch
!/attachments/download/1115/Tony_User_Interface.png!
18 1 Matthias Mauch
19 48 Matthias Mauch
h2. Reference
20 48 Matthias Mauch
21 53 Matthias Mauch
h3. Navigation
22 1 Matthias Mauch
23 51 Matthias Mauch
* *click and drag* in the Main Pane to move the visible area
24 51 Matthias Mauch
* *click in the Selection Strip* to move the playhead to the time you clicked on
25 51 Matthias Mauch
* *press left and right arrows* to move the playhead forward and backward, respectively
26 51 Matthias Mauch
* *press Ctrl-left/Cntrl-right* to move the playhead by one note (Ctrl is Command on Mac)
27 49 Matthias Mauch
28 52 Matthias Mauch
h3. Selection
29 49 Matthias Mauch
30 52 Matthias Mauch
Only time intervals can be selected. 
31 1 Matthias Mauch
32 52 Matthias Mauch
h4. Selecting an arbitrary time interval
33 1 Matthias Mauch
34 52 Matthias Mauch
* *click into Selection Strip and drag* selects the time interval you drag across.
35 52 Matthias Mauch
* *Shift-click and drag in the Main Pane*, while used for pitch track correction, will also select the time interval you drag across.
36 52 Matthias Mauch
37 52 Matthias Mauch
h4. Selecting an interval coinciding with notes
38 52 Matthias Mauch
39 1 Matthias Mauch
* *double-click in Selection Strip* selects the time interval covered by the current note.
40 53 Matthias Mauch
* *Shift-Ctrl-left and Shift-Ctrl-right* move the playhead by one note and select the time interval. (Ctrl is Command on Mac.)
41 53 Matthias Mauch
42 53 Matthias Mauch
h4. Select all
43 53 Matthias Mauch
44 53 Matthias Mauch
* *Ctrl-A* (Ctrl is Command on Mac.)
45 53 Matthias Mauch
* *Edit Menu -> Select All*
46 48 Matthias Mauch
47 43 Matthias Mauch
h2. Quick Starter Guide
48 43 Matthias Mauch
49 43 Matthias Mauch
Some guided tours to help you find your way around _Tony_.
50 43 Matthias Mauch
51 41 Matthias Mauch
h3. Guided Tour 1: First Steps
52 24 Matthias Mauch
53 24 Matthias Mauch
This mini-tutorial walks you through the complete process of using Tony to load an audio file, annotate the notes in it and export the notes to a .csv (comma-separated values) file.
54 24 Matthias Mauch
55 24 Matthias Mauch
# Start the _Tony_ program by double-clicking (or whatever you routinely do to open programs).
56 1 Matthias Mauch
# Open an audio file of your choice. Mind that _Tony_ only deals with single melodies *without* accompaniment, so choose a little bit of accompanied solo singing or the like.
57 1 Matthias Mauch
# Upon opening of the file, _Tony_ will automatically analyse the file using "pYin":/projects/pyin pitch and note extraction, and pitches and notes should appear. _If no pitch track and notes occur, please see Analysis Settings and Visualisation, below._
58 27 Matthias Mauch
# Get comfortable moving around and playback... a few suggestions:
59 27 Matthias Mauch
#* play audio by clicking on the play button in the top toolbar, or simply by pressing the space bar on your keyboard
60 27 Matthias Mauch
#* use the Navigate tool to move around in the audio file: simply left-click and drag in the main pane
61 27 Matthias Mauch
#* try navigating with the keyboard, too. The left and right cursor keys will move the play head
62 27 Matthias Mauch
# Get comfortable with different visualisations and sonifications:
63 28 Matthias Mauch
#* try switching (toggling) different visualisations on and off in the bottom toolbar: waveform, pitch track (the black line), note track (the blue boxes), spectrogram (the gray-scale background)
64 1 Matthias Mauch
#* try switching on the pitch track sonification (sound representation) by toggling the loudspeaker symbol next to the pitch track symbol in the bottom toolbar -- you should be able to hear a funny sine-like tone at the same pitch as the original audio when sonification is on.
65 1 Matthias Mauch
#* turn off pitch track sonification, and turn on note track sonification -- what's the difference?
66 28 Matthias Mauch
#* you can switch the original audio on and off too (next to the waveform)
67 28 Matthias Mauch
#* what effect does the pan wheel (the one with the green circle) have on sonification? -- you can choose where in the stereo image to sonify the sounds: left, right, or anywhere in between.
68 32 Matthias Mauch
69 41 Matthias Mauch
h3. Guided Tour 2: Splitting, Merging and Deleting Notes
70 32 Matthias Mauch
71 37 Matthias Mauch
When you load an audio file, Tony will provide you with a first note track. It's rare that the note track is perfect; here I talk you through but you can easily correct it and save it.
72 32 Matthias Mauch
73 32 Matthias Mauch
# Make sure you can see the note track in blue. If not, turn note visualisation on.
74 39 Matthias Mauch
# Splitting a note using the Edit Tool. Choose a note and split it:
75 32 Matthias Mauch
#* select the Edit Tool from the top toolbar (alternatively you can type "2" on your keyboard)
76 32 Matthias Mauch
#* move the mouse over a note; in the middle bottom of the note the mouse pointer will turn into an upward arrow -- if it does that, left-click, and you'll have split a note!
77 34 Matthias Mauch
#* note that the two resulting notes will have different frequencies (Tony automatically calculates the pitch from the underlying pitch track)
78 39 Matthias Mauch
# Splitting a note at the play head without using the Edit Tool. Choose another note and split that too, but now in a different way:
79 39 Matthias Mauch
#* put the play head where you want it by using the left/right arrows or a single left-click in the selection pane (just under the main pane)
80 1 Matthias Mauch
#* then go to the Edit menu and click "Split Note". There's a keyboard shortcut for this as well: simply type "/" (a slash)
81 39 Matthias Mauch
# Merging two or more notes into one. Choose two notes, and merge them into one:
82 1 Matthias Mauch
## Select the region with the notes you want to delete by clicking and dragging in the selection pane (just under the main pane)
83 1 Matthias Mauch
## On your keyboard, press the backslash key, or, in the Edit menu, choose Merge Notes
84 1 Matthias Mauch
# Deleting a note. To delete a note using the Edit Tool, move the mouse to the bottom of the note (as if you wanted to split it), press the Shift key and click. That is: deleting is like splitting with the Shift key pressed.
85 1 Matthias Mauch
# Deleting multiple notes. To delete multiple notes, do the following:
86 1 Matthias Mauch
## Select the region with the notes you want to delete by clicking and dragging in the selection pane (just under the main pane)
87 1 Matthias Mauch
## On your keyboard, press the Backspace key, or, in the Edit menu, choose Delete Notes.
88 39 Matthias Mauch
89 41 Matthias Mauch
h3. Guided Tour 3: Creating, Shortening and Extending Notes
90 45 Matthias Mauch
91 39 Matthias Mauch
# Extending or shortening a note. Choose a note at the end of a phrase and try to make it longer or shorter.
92 39 Matthias Mauch
#* when in Edit Tool mode, you can grab a note end (onset or offset) and drag to shorten or to extend the note
93 39 Matthias Mauch
# Create a Note. There are two ways of making a note
94 39 Matthias Mauch
## in Edit Mode, double click into the main pane at a time position where there's no other note -- a note will be created
95 1 Matthias Mauch
## in Edit or Navigate Mode, select a time region in the selection pane, then, on your keyboard, press "=". Alternatively, you can go to the Edit Menu and choose "Form Note From Selection"
96 42 Matthias Mauch
# The same goes for the pitch track... try it!
97 1 Matthias Mauch
98 41 Matthias Mauch
h3. Guided Tour 4: Exporting and Saving
99 1 Matthias Mauch
100 41 Matthias Mauch
There are multiple ways to save your annotations. You can try all!
101 41 Matthias Mauch
102 41 Matthias Mauch
# First, you can save the whole _Tony_ "session", that is, a  document which saves the extracted pitches, notes and your changes (but not the audio!), so that if you want to resume work later, you can simply open that session file in _Tony_. Sessions files end in ".ton". You can save by using the File menu, then choosing "Save Session As...", and you will have to choose a name for the file you want to save. 
103 46 Matthias Mauch
#* If you want to save a ".ton" file where your audio file is, then it's even easier: simply choose Save Session To Audio Path, and _Tony_ will save a session at the same place and name as the audio file, but with the file extension ".ton".
104 1 Matthias Mauch
# Saving only the note track. Try saving the note track, by choosing the File menu, then Export Note Data... . This will save the note data as a text file with commas between the values, a so-called comma-separated values file with the extension ".csv".
105 46 Matthias Mauch
#* save a file test.csv and open it in a text editor or in a spread sheet. You will see that the first column provides note onsets (in seconds), the second column the note frequencies (Hz), the third column the note durations (seconds), and the fourth column... is currently just a weird value. Sorry.
106 46 Matthias Mauch
# Saving only the pitch track. Works pretty much in the same way as saving the note track.
107 46 Matthias Mauch
#* The result is different, however: you have only three columns in your .csv file: timestamp (in seconds) and frequency (Hz)
108 24 Matthias Mauch
109 44 Matthias Mauch
h2. Menus
110 38 Matthias Mauch
111 44 Matthias Mauch
h3. File Menu
112 1 Matthias Mauch
113 44 Matthias Mauch
h3. Edit Menu
114 44 Matthias Mauch
115 44 Matthias Mauch
h3. View Menu
116 44 Matthias Mauch
117 30 Matthias Mauch
h3. Analysis Menu
118 30 Matthias Mauch
119 30 Matthias Mauch
The "Analysis" menu allows you to re-analyse the audio for pitches and notes and to choose some analysis settings.
120 30 Matthias Mauch
121 30 Matthias Mauch
* *Analyse Now!* will run "pYin":/projects/pyin to extract pitches and notes and replaces all currently annotated pitches and notes. While you can undo this, you might still want to consider carefully whether to use this option if you have put a lot of work into annotating notes or pitches.
122 30 Matthias Mauch
* *Auto-Analyse New Audio*. _Tony_ will, by default, analyse any new audio that you load. If you do not want this behaviour, you can de-select it here.
123 1 Matthias Mauch
* *Unbiased Timing (slow)*. By default the "pYin":/projects/pyin analysis is based on ordinary YIN, which has a funky asymmetric window and introduces a small timing bias of up to 5ms. If you need zero time bias, then tick this item. This will be much slower, since this option cannot use the Fast Fourier Transform.
124 1 Matthias Mauch
* *Penalise Soft Pitches*: this option is on by default and reduces the impact of very low-amplitude content, effectively suppressing some spurious pitches. If you don't want this, untick.
125 1 Matthias Mauch
126 44 Matthias Mauch
h2. Toolbars
127 44 Matthias Mauch
128 44 Matthias Mauch
not covered (yet?)
129 19 Matthias Mauch
130 19 Matthias Mauch
h2. Nerdy matters
131 18 Matthias Mauch
132 18 Matthias Mauch
[[Development Wiki]]