Courses

Please see the main article on Keygroups before reading this article.

Courses are a subdivision of Keygroups which allow the user to define an offset between groups of keys within a Keygroup. This allows Keygroups to exhibit behaviour similar to that of a stringed instrument, such as a guitar - i.e. each string is a certain distance apart in pitch from the previous string.

Before attempting the Belcanto commands below, please make sure you have the desired Keygroup within your conversation using

Error	1	listen

where X is the number of your desired Keygroup.

Courses are created at the point of the key choosing process by using a variation on the normal Belcanto phrase for key choosing.

You need to decide on the number of courses and the keys that you wish to include within the courses before you start the choosing process.

To choose the keys for Course 1, use

Error	as	1	choose

EigenD will now enter 'choose mode' - you may have already encountered this in the main Keygroup article.

You will see a number of LEDs light up - the LEDs adjacent to keys already contained within the Course will light green, and the LEDs adjacent to keys not currently within the Course but available for selection will light red.

Press a key to choose it for your Course. The LEDs will now change - newly selected keys will now be accompanied by a green LED, whereas keys that were previously within the Course will now light amber. The LEDs adjacent to keys that are available for selection but neither not currently selected nor previously part of the Course will remain red.

As explained in the main Keygroup article, the keys will be numbered according to the order in which you choose the keys.

Once you have selected all the desired keys for your Course, press the last key twice. All the LEDs will go out, confirming that you have now exited 'choose mode'.

You now need to repeat the process for each Course, replacing '1' in the Belcanto phrase above with the number of the desired Course.
The key numbering pattern is the same regardless of whether the Keygroup has Courses defined or not, i.e. if you define a Course with keys 1 to 8, the numbering of the next Course will start from 9 onwards.

Course Offsets

The offset between Courses can be defined in both semitones and scale increments.

The Belcanto phrase below sets the starting note of the specified Course as a note with a distance of four semitones higher than the starting note of the previous course:

course	X	offset	to	4	semitone	set

The Belcanto phrase below sets the starting note of the specified Course as a note with a distance of four scale steps lower than the starting note of the previous course:

course	X	offset	to	-	4	interval	set

There is an upper and lower limit of 500 semitones and 9500 scale steps.