trane 0.28.0

An automated system for learning complex skills
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117

//! Contains constants used by the transcription courses.

use std::sync::LazyLock;

use indoc::indoc;
use ustr::Ustr;

/// The description of the singing lesson.
pub const SINGING_DESCRIPTION: &str = indoc! {"
    Repeatedly listen to the passage until you can audiate and sing its main elements. You should
    also experiment with singing different melodies over the passage and see what works.

    Refer to the lesson instructions for more details.
"};

/// The description of the advanced singing lesson.
pub const ADVANCED_SINGING_DESCRIPTION: &str = indoc! {"
    Repeatedly listen to the passage until you can audiate and sing it clearly in detail. Same as
    the singing lesson, but the passage should be audiated in more detail and precision, and
    transposed up or down a random number of semitones.

    Refer to the lesson instructions for more details.
"};

/// The description of the transcription lesson.
pub const TRANSCRIPTION_DESCRIPTION: &str = indoc! {"
    Using the stated instrument, play over the passage, using it as a basis for improvising. Playing
    back the exact passage is not required at this stage. Rather, this lesson is about learning to
    navigate the context implied by it.

    Refer to the lesson instructions for more details.
"};

/// The description of the advanced transcription lesson.
pub const ADVANCED_TRANSCRIPTION_DESCRIPTION: &str = indoc! {"
    Using the stated instrument, play over passage back, and use it as a basis for improvising.
    Same as the transcription exercise, but the passage should be played back in more detail and
    precision, and transposed up or down a random number of semitones.

    Refer to the lesson instructions for more details.
"};

/// The metadata key indicating this is a transcription course. Its value should be set to "true".
pub const COURSE_METADATA: &str = "transcription_course";

/// The metadata key indicating the type of the transcription lesson. Its value should be set to
/// "true".
pub const LESSON_METADATA: &str = "transcription_lesson";

/// The metadata key indicating the artists included in the transcription course.
pub const ARTIST_METADATA: &str = "transcription_artist";

/// The metadata key indicating the album included in the transcription course.
pub const ALBUM_METADATA: &str = "transcription_album";

/// The metadata key indicating the instrument of the transcription lesson.
pub const INSTRUMENT_METADATA: &str = "instrument";

/// The file where the course instructions are stored.
pub static COURSE_INSTRUCTIONS: LazyLock<Ustr> =
    LazyLock::new(|| Ustr::from(include_str!("course_instructions.md")));

/// The instructions for the singing course.
pub static SINGING_INSTRUCTIONS: LazyLock<Ustr> = LazyLock::new(|| {
    Ustr::from(indoc! {"
        First listen to the musical passage until you can audiate it clearly in your head. Then sing
        over the passage. At this stage it's not required to be accurate as possible. Rather, learn
        to sing the main elements of the passage and experiment with different melodies over it.
        The goal is to learn to navigate the context implied by the passage.

        There's no need to play on your instrument or write anything down, but you are free to do so
        if you wish.
    "})
});

/// The instructions for the transcription course.
pub static TRANSCRIPTION_INSTRUCTIONS: LazyLock<Ustr> = LazyLock::new(|| {
    Ustr::from(indoc! {"
        With the basic context implied by the passage now internalized in your ear, try to play over
        it using your instrument. The goal at this point is not to accurately reproduce the passage,
        but rather about learning to navigate that context and use it as a basis for improvisation.
        You can focus on different elements or sections each time you practice.

        There's no need to write anything down, but you are free to do so if you wish.
    "})
});

/// The instructions for the advanced singing course.
pub static ADVANCED_SINGING_INSTRUCTIONS: LazyLock<Ustr> = LazyLock::new(|| {
    Ustr::from(indoc! {"
        Listen to the musical passage until you can audiate it and sing over it like you did in the
        singing lesson. In that lesson, the passage was used as a basis for improvisation. In this
        lesson, the passage should be sung with more detail and precision, and transposed up or down
        a random number of semitones. You should also use solfege syllables or numbers to sing the
        passage.

        There's no need to play on your instrument or write anything down, but you are free to do so
        if you wish.
    "})
});

/// The instructions for the advanced transcription course.
pub static ADVANCED_TRANSCRIPTION_INSTRUCTIONS: LazyLock<Ustr> = LazyLock::new(|| {
    Ustr::from(indoc! {"
        At this stage, you can sing and play over the context implied by the passage, and sing it
        with more detail and precision in a variety of keys. It's at this point that you can engage
        in what is traditionally called transcription.

        Play over the passage using your instrument, and try to reproduce it in more detail than
        in the basic transcription lesson. You should also transpose the passage up or down a random
        number of semitones. You should still use the passage as a basis for improvisation, but the
        focus is much narrower than in the basic transcription lesson, and the actual music played
        in the passage take precedence over the context implied by it.

        There's no need to write anything down, but you are free to do so if you wish.
    "})
});