md`Let's expand to the foundation of Western Music, keys and scales. There are two classes, aptly named ${docs('Core#Key', 'Key')} and ${docs('Core#Scale', 'Scale')}.
The difference between them is that a Scale defines a relationship between notes via ${docs('Types.Interval', 'intervals')} and a Key, makes use of it and expands the relationship to other scales.
Enough abstract talk, here are two examples: * new Scale('A', Scale.Minor) => ${new Playa.Scale('A', Playa.Scale.Minor).string.join(' ')} * new Key('C2', Key.Dorian) => ${new Playa.Scale('C2', Playa.Key.Dorian).string.join(' ')} * new Scale('F', Scale.Ionian, [4, 1]) => ${new Playa.Scale('F', Playa.Scale.Ionian, [4, 1]).string.join(' ')} *side note*: [4, 1] [* octave, number of octaves *]: this is another way to define octaves They look pretty similar, but what you can do with them differs. If you're interested in trying out different scales, perhaps generating some isolated note sequences Scale is a good choice. On the other hand, if you want to try a combination of scales, Key will be a better fit. Slight detour, everytime you see some note representation may it be midi, frequency or string, it's been done via some common accessors to the base harmonic classes Chord, Scale or Key, which inherit from ${docs('Core.HarmonyBase', 'HarmonyBase')}. Here are them: * key.string: ${key.string.join(' ')} * chord.notes: ${chord.notes} * scale.midi: ${scale.midi.join(' ')} * chord.freq: ${chord.freq.map(f => f.toFixed(0)+'hz').join(' ')} `