The courtesy program can be used to identify and manipulate courtesy/cautionary accidentals in a musical score. Courtesy accidentals are optional accidentals that help clarify the chromatic alteration of a note. The courtesy accidental does not alter the pitch of the note since it matches the expected chromatic inflection of the note. The following musical example demonstrates a courtesy accidental in the second measure where the sharp is not required, since the F is already sharpened by the key signature, and the natural sign on the F in the previous measure is cancelled by the barline. In this case the courtesy accidental is used to alert the performer that the natural sign in the previous measure is not longer in effect. If there were no sharp on the F in the second measure, a performer may also wonder if the natural sign was omitted by mistake.

The courtesy program can identify and highlight notes with courtesy accidentals, remove these accidentals, or place the courtesy accidentals within parentheses.

OPTIONS

ⓘ	`-m`	Mark courtesy accidentals with the `@courtesy` named parameter.
ⓘ	`-p`	Place courtesy accidentals in parentheses.
ⓘ	`-P`	Remove parenthese around courtesy accidentals.
ⓘ	`-r`	Remove courtesy accidentals from notes.
ⓘ	`-R`	Redisplay courtesy accidentals (requires previous use of -k option)
ⓘ	`-k`	Keep courtesy accidental analyses on notes (used in particular with -r option to recover accidentals later).
ⓘ	`-e`	Convert cautionary accidentals to editorial accidentals.
ⓘ	`-a`	Include pitch-analysis parameters in output data.
ⓘ	`--lj`	Add LJ commands to end of output data for systems which have been altered.

DESCRIPTION

courtesy

input data

courtesy

courtesy input-data > output-data

G♮ at the start of the second measure. This is used to warn of the cancellation of G♯ in the previous measure caused by the barline.
C♮ in the middle of the second measure is used to clarify that the sharp on the previous C3 in the measure does not apply to C4 since they are in different octaves.
C♯ at the end the second measure is used to clarify that the natural on the previous C4 in the measure does not apply to this C3 since they are in different octaves (the chromatic alteration of this note comes from the first C♯ in the measure).
The F♯ in the third measure is given for clarity that the natural on F4 in the top staff in third and fourth measures does not apply to this note in the bottom staff.

1. Marking courtesy accidentals

-m

courtesy -m input-data > output-data

1 0 0 0.75 200

1 0 2 8

1 0 2

1 1.5 0 1

1 7.459 0 1 1

1 13.357 8 20 0 1

1 13.384 10 12 0 0.5 -1 1

1 19.17 11 10 0 1 -1.5

1 24.9 1 20 0 1 -1.5

1 30.506 10 10 0 0.5 -1 1

1 36.344 4 20 0 1 -1.5 0 0 -14

1 36.345 11 10 0 1 -1.5

1 44.567 4 20 0 1 -1.5

1 44.568 7 6.5 50.37 11

1 44.568 8 10 0 0.5 -1

1 50.372 7 12 0 0.5 -0.5

1 56.185 2

1 59.635 5 20 0 0.5 -1.5

1 59.635 6.5 7 65.44 21

1 59.635 10 13 0 1 -1.5

@courtesy:	true

1 65.44 6 22 0 0.5 -1

1 70.323 6.5 6.5 82.77 -0.75 -2 -0.5 0 0 0 0.65

1 71.22 7 20 0 1

1 71.22 12.5 12 77 11

1 71.22 14 10 0 0.5 -1.5

1 77 13 13 0 0.5 -1

@courtesy:	true

1 82.648 7 20 0 1

1 82.648 12 11 0 1 -1.5

1 93.86 6 22 0 1 -0.5

@courtesy:	true

1 93.86 11 10 0 1 -1.5

1 105.279 2

1 108.729 7 20 0 1

1 108.729 11 10 0 1 -1.5

1 120.176 4 20 0 1 -1.5

1 120.176 10 10 0 1 -1.5

1 132.082 7 20 0 1 0 0 0 -14

1 132.082 9 12 0 1 -1

@courtesy:	true

1 140.305 5 20 0 1 -1

1 140.305 9 10 0 1 -1

1 151.774 2

1 154.317 8 20 0 1

1 154.317 10 10 0 1 -1.5

1 165.637 7 20 0 1

1 165.637 14 10 0 1 -2.5

1 176.957 10 9.5 182.56 21

1 176.957 10 20 0 0.5

1 176.957 14 10 0 1 -2

1 182.563 9 20 0 0.5 -0.5

1 188.169 8 20 0 1

1 188.169 15 10 0 1 -1.5

1 200 2

2 0 2 0.75 200

2 1.5

2 7.459 0 1

2 13.357 3 20 0 1 -1.5

2 13.384 8 10 0 1 -0.5

2 24.9 2 20 0 1 -1.5

2 24.901 7 10 0 1

2 36.344 1 20 0 1 -1.5

2 36.345 6 10 0 1 0 0 0 14

2 44.567 6 20 0 1 -0.5

2 44.568 8 10 0 1 -0.5

2 59.635 2 20 0 0.5 -1.5

2 59.635 3.5 4 65.44 21

2 59.635 7 10 0 1

2 65.44 3 20 0 0.5 -1

2 71.22 4 23 0 1 -1.5

2 71.221 6 10 0 1

2 82.648 3 20 0 0.5 -1

2 82.648 4 3.5 88.25 21

2 82.648 5 10 0 1

2 88.254 2 20 0 0.5 -1.5

2 92.93 1 1 110.46 -1.3964 -2 0 0 0 0 0.65

2 93.86 3 20 0 1 -1.5

2 93.861 5 4.5 99.47 11

2 93.861 6 10 0 0.5 -1

2 99.466 5 10 0 0.5 -0.5

2 108.729 3 20 0 0.5 -1 1 10

2 108.729 4 13 0 1

2 114.57 2 20 0 1 -1.5

2 120.176 3 10 0 1

2 126.476 1 22 0 0.5 -1 1

2 132.082 2 20 0 1 -1.5 0 0 14

2 132.083 2 10 0 1

2 140.305 2 20 0 0.5 -1

2 140.305 3 2.5 146.09 21

2 140.307 2 10 0 1

2 146.085 1 23 0 0.5 -1.5

2 154.317 0 20 0 0.5 -2

2 154.317 2 0.5 171.24 21

2 154.317 5 10 0 1

2 159.923 -1 20 0 0.5 -2.51

2 165.637 -2 20 0 0.5 -2.99

2 165.637 6 10 0 1

2 171.243 -3 20 0 0.5 -3.5

2 176.957 -2 20 0 1 -2

2 176.957 7 10 0 1.5 0 10

2 188.169 5 20 0 1 -1

2 193.775 8 10 0 0.5 0 1

2. Removing courtesy accidentals

-r

-k

courtesy -kr input-data > output-data

3. Replacing courtesy accidentals

-R

-r

-k

-r

-k

-R

4. Adding parentheses

-p

courtesy -p input-data > output-data

5. LJ adjustments

--lj

-p

courtesy -p --lj input-data > output-data

6. Editorial accidentals

-e

7. Programming notes

1
2
3
4
5
6
7
8  #include "scorelib.h"
 int main(void) {
    ScorePage infile;
    infile.read("filename");
    infile.analyzePitch();
    cout << infile;
    return 0;
 }

Pitch analyses are stored in the @auto@base40 named parameter, as can be seen in the processed output data on the right below. Courtesy accidentals will have the value "true" for the named parameter @auto@courtesy.

Given this input:

8 1 0.000 0 0.75 50
3 1 1.500
17 1 7.471 0 1.00
1 1 11.596 4 10.00 0 1
1 1 21.196 4 12.00 0 1
1 1 30.795 4 12.00 0 1
1 1 40.395 4 12.00 0 1
14 1 50.000 1

The above program produces this output:

8 1 0.000 0 0.75 50
3 1 1.500
17 1 7.471 0 1.00
1 1 11.596 4 10.00 0 1
@auto@base40pitch: 180 (f#)
1 1 21.196 4 12.00 0 1
@auto@courtesy: true
@auto@base40pitch: 180 (f#)
1 1 30.795 4 12.00 0 1
@auto@courtesy: true
@auto@base40pitch: 180 (f#)
1 1 40.395 4 12.00 0 1
@auto@courtesy: true
@auto@base40pitch: 180 (f#)
14 1 50.000 1

Program: courtesy

OPTIONS

DESCRIPTION

1. Marking courtesy accidentals

2. Removing courtesy accidentals

3. Replacing courtesy accidentals

4. Adding parentheses

5. LJ adjustments

6. Editorial accidentals

7. Programming notes