satb2gs manpage

COMMAND

satb2gs -- Convert SATB staves into a grand-staff arrangement.

[input | ] satb2gs [input] > [output]

The satb2gs program converts Humdrum scores with the first four (monophonic) **kern spines in the file into grand-staff (two-staff keyboard) style layout. There must be at least four **kern spines in the Humdrum score, with the order of the parts in the file presumed to be bass, tenor, alto, then soprano. The spines do not have to be contiguous in the file, and other spines (such as **text spines) can interleave any of the SATB parts. Any **kern spines after the first four will not be processed. If the parts are not contiguous, the tenor part will be moved next to the bass part and the alto will be moved next to the soprano part.

The original clefs of the SATB parts will automatically be commented out in local comments, and the treble and bass clefs of a grand staff will be placed at the start of the soprano/alto and tenor/bass staves. Also, fermatas in the tenor and alto parts will automatically be hidden if they occur at the same time as fermatas in the bass and soprano parts, respectively, as long as the tenor/bass or alto/soprano note durations are the same.

As an example consider the following Humdrum file containing four monophonic SATB parts:

humcat h://371chorales/chor001.krn | less !!!COM: Bach, Johann Sebastian !!!CDT: 1685/02/21/-1750/07/28/ !!!OTL@@DE: Aus meines Herzens Grunde !!!OTL@EN: From the Depths of My Heart !!!SCT: BWV 269 !!!PC#: 1 !!!AGN: chorale **kern **kern **kern **kern *ICvox *ICvox *ICvox *ICvox *Ibass *Itenor *Ialto *Isoprn *I"Bass *I"Tenor *I"Alto *I"Soprano *>[A,A,B] *>[A,A,B] *>[A,A,B] *>[A,A,B] *>norep[A,B] *>norep[A,B] *>norep[A,B] *>norep[A,B] *>A *>A *>A *>A *clefF4 *clefGv2 *clefG2 *clefG2 *k[f#] *k[f#] *k[f#] *k[f#] *G: *G: *G: *G: *M3/4 *M3/4 *M3/4 *M3/4 *MM100 *MM100 *MM100 *MM100 4GG 4B 4d 4g =1 =1 =1 =1 4G 4B 4d 2g 4E 8cL 4e . . 8BJ . . 4F# 4A 4d 4dd =2 =2 =2 =2 4G 4G 2d 4.b 4D 4F# . . . . . 8a 4E 4G 4B 4g =3 =3 =3 =3 4C 8cL 8eL 4.g . 8BJ 8d . 8BBL 4c 8e . 8AAJ . 8f#J 8a 4GG 4d 4g 4b =4 =4 =4 =4 2D; 2d; 2f#; 2a; 4GG 4d 4g 4b =5 =5 =5 =5 4FF# 4A 4d 2dd 4GG 4B 4e . 4AA 4c 4f# 4cc =6 =6 =6 =6 4BB 4d 2g 4b 4C 4e . 2a 4D 8dL 4f# . . 8cJ . . =7 =7 =7 =7 2GG; 2B; 2d; 2g; =:|! =:|! =:|! =:|! *>B *>B *>B *>B 4GG 4d [4g 4b =8 =8 =8 =8 4GG 4d 8gL] 4b . . 8f#J . 4AA 4c 8eL 4cc . . 8f#J . 4BB 8BL [4g 4dd . 8AJ . . =9 =9 =9 =9 4.BB 8BL 8gL] 4.dd . 8cJ 8aJ . . 4d 8gL . 8AA . 8f#J 8cc 4GG 4d 4g 4b =10 =10 =10 =10 2D; 2d; 2f#; 2a; [4E 4B 4e 4g =11 =11 =11 =11 4E] 4G 4e 2b 4D 4B 8f#L . . . 8gJ . 4C 4e 4a 4cc =12 =12 =12 =12 4.BB 2d 4a 2dd . . 4.g . 8C . . . 4D 4d . 4cc . . 8f# . =13 =13 =13 =13 8GGL 2.d 2g 2.b 8AAJ . . . 4BB . . . 4GG . 4f . =14 =14 =14 =14 2C; 2c; 2e; 2g; 4GG 4d 4g 4b =15 =15 =15 =15 4FF# 8dL 4.a 2dd . 8cJ . . 4GG 4B . . . . 8g . 4AA 4c 4f# 4cc =16 =16 =16 =16 4BB 2d 2g 2b 4GG . . . 4D 8dL [4f# 4a . 8cJ . . =17 =17 =17 =17 8EL 4B 8f#L] 4.g 8D . 8eJ . 8C 4c 8eL . 8BB . 8f#J 8a 8AA 4d 4g 4b 8GGJ . . . =18 =18 =18 =18 2D; 2d; 2f#; 2a; [4G 4d 4g 4b =19 =19 =19 =19 4G] 2d 2a 2dd 4F# . . . [4E 4e 8gL 4cc . . 8f#J . =20 =20 =20 =20 8EL] 2e 2g 4b 8DJ . . . 4C . . 2a 4D 8dL 4f# . . 8cJ . . =21 =21 =21 =21 2GG; 2B; 2d; 2g; == == == == *- *- *- *- !!!hum2abc: -Q '' !!!title: @{PC#}. @{OTL@@DE} !!!YOR1: 371 vierstimmige Choralgesänge von Johann Sebastian Bach, !!!YOR2: 4th ed. by Alfred Dörffel (Leipzig: Breitkopf und Härtel, !!!YOR3: c.1875). 178 pp. Plate "V.A.10". reprint: J.S. Bach, 371 Four-Part !!!YOR4: Chorales (New York: Associated Music Publishers, Inc., c.1940). !!!SMS: B&H, 4th ed, Alfred Dörffel, c.1875, plate V.A.10 !!!EED: Craig Stuart Sapp !!!EEV: 2009/05/22

When this data is printed, it will be typeset with four staves -- one staff for each part:

autostem h://371chorales/chor001.krn | hum2muse \
| muse2ps '=z21js^[(....)]^v170,170,170,200' | ps2pdf - - > 4staves.pdf



Also, here is the same music printed using abcm2ps: hum2abc h://371chorales/chor001.krn | abcm2ps - -O - | ps2pdf - - > 4partabc.pdf

Using satb2gs, the music is placed onto two staves rather than four:

satb2gs h://371chorales/chor001.krn > chor001gs.krn !!!COM: Bach, Johann Sebastian !!!CDT: 1685/02/21/-1750/07/28/ !!!OTL@@DE: Aus meines Herzens Grunde !!!OTL@EN: From the Depths of My Heart !!!SCT: BWV 269 !!!PC#: 1 !!!AGN: chorale **kern **kern *clefF4 *clefG2 *^ *^ *ICvox *ICvox *ICvox *ICvox *Itenor *Ibass *Isoprn *Ialto *I"Tenor *I"Bass *I"Soprano *I"Alto *>[A,A,B] *>[A,A,B] *>[A,A,B] *>[A,A,B] *>norep[A,B] *>norep[A,B] *>norep[A,B] *>norep[A,B] *>A *>A *>A *>A !*clefGv2 !*clefF4 !*clefG2 !*clefG2 *k[f#] *k[f#] *k[f#] *k[f#] *G: *G: *G: *G: *M3/4 *M3/4 *M3/4 *M3/4 *MM100 *MM100 *MM100 *MM100 4B 4GG 4g 4d =1 =1 =1 =1 4B 4G 2g 4d 8cL 4E . 4e 8BJ . . . 4A 4F# 4dd 4d =2 =2 =2 =2 4G 4G 4.b 2d 4F# 4D . . . . 8a . 4G 4E 4g 4B =3 =3 =3 =3 8cL 4C 4.g 8eL 8BJ . . 8d 4c 8BBL . 8e . 8AAJ 8a 8f#J 4d 4GG 4b 4g =4 =4 =4 =4 2d;y 2D; 2a; 2f#;y 4d 4GG 4b 4g =5 =5 =5 =5 4A 4FF# 2dd 4d 4B 4GG . 4e 4c 4AA 4cc 4f# =6 =6 =6 =6 4d 4BB 4b 2g 4e 4C 2a . 8dL 4D . 4f# 8cJ . . . =7 =7 =7 =7 2B;y 2GG; 2g; 2d;y =:|! =:|! =:|! =:|! *>B *>B *>B *>B 4d 4GG 4b [4g =8 =8 =8 =8 4d 4GG 4b 8gL] . . . 8f#J 4c 4AA 4cc 8eL . . . 8f#J 8BL 4BB 4dd [4g 8AJ . . . =9 =9 =9 =9 8BL 4.BB 4.dd 8gL] 8cJ . . 8aJ 4d . . 8gL . 8AA 8cc 8f#J 4d 4GG 4b 4g =10 =10 =10 =10 2d;y 2D; 2a; 2f#;y 4B [4E 4g 4e =11 =11 =11 =11 4G 4E] 2b 4e 4B 4D . 8f#L . . . 8gJ 4e 4C 4cc 4a =12 =12 =12 =12 2d 4.BB 2dd 4a . . . 4.g . 8C . . 4d 4D 4cc . . . . 8f# =13 =13 =13 =13 2.d 8GGL 2.b 2g . 8AAJ . . . 4BB . . . 4GG . 4f =14 =14 =14 =14 2c;y 2C; 2g; 2e;y 4d 4GG 4b 4g =15 =15 =15 =15 8dL 4FF# 2dd 4.a 8cJ . . . 4B 4GG . . . . . 8g 4c 4AA 4cc 4f# =16 =16 =16 =16 2d 4BB 2b 2g . 4GG . . 8dL 4D 4a [4f# 8cJ . . . =17 =17 =17 =17 4B 8EL 4.g 8f#L] . 8D . 8eJ 4c 8C . 8eL . 8BB 8a 8f#J 4d 8AA 4b 4g . 8GGJ . . =18 =18 =18 =18 2d;y 2D; 2a; 2f#;y 4d [4G 4b 4g =19 =19 =19 =19 2d 4G] 2dd 2a . 4F# . . 4e [4E 4cc 8gL . . . 8f#J =20 =20 =20 =20 2e 8EL] 4b 2g . 8DJ . . . 4C 2a . 8dL 4D . 4f# 8cJ . . . =21 =21 =21 =21 2B;y 2GG; 2g; 2d;y == == == == *v *v * * * *v *v *- *- !!!hum2abc: -Q '' !!!title: @{PC#}. @{OTL@@DE} !!!YOR1: 371 vierstimmige Choralgesänge von Johann Sebastian Bach, !!!YOR2: 4th ed. by Alfred Dörffel (Leipzig: Breitkopf und Härtel, !!!YOR3: c.1875). 178 pp. Plate "V.A.10". reprint: J.S. Bach, 371 Four-Part !!!YOR4: Chorales (New York: Associated Music Publishers, Inc., c.1940). !!!SMS: B&H, 4th ed, Alfred Dörffel, c.1875, plate V.A.10 !!!EED: Craig Stuart Sapp !!!EEV: 2009/05/22

Notice that the exclusive interpretation line now contains two **kern spines rather than four, and that the fermatas in the inner voices are now marked as hidden.

This data will now print using a grand staff:

satb2gs h://371chorales/chor001.krn | autostem | hum2muse \
| muse2ps '=z21jv250,250s^{(..)}^C^^T^^' | ps2pdf - - > chor001gs.pdf



Here is an example of printing through abcm2ps rather than muse2ps (autostem is not needed to add stems for the input to hum2abc since abcm2ps determines all stem directions automatically):

satb2gs h://371chorales/chor001.krn | hum2abc | abcm2ps - -O - \
| ps2pdf - - > chor001gsabc.pdf

Here is an example of combining both layouts of the music into a single vocal/piano score. First generate a grand-staff format for the chorale, then assemble it with the original 4-staff layout and print.

humcat h://371chorales/chor001.krn > chor001.krn satb2gs chor001.krn > chor001gs.krn assemble chor001gs.krn chor001.krn > chor001comb.krn hum2abc chor001comb.krn | abcm2ps - -O - | ps2pdf - - > chor001abccomb.pdf autostem chor001comb.krn \    | hum2muse --mo 'z14js^[(....)]{(..)}^v140,140,140,160,180,185' \    | muse2ps | ps2pdf - - > chor001comb.pdf

Input arguments or piped data which are expected to be Humdrum files can also be web addresses. For example, if a program can process files like this:

       program file.krn

It can also read the data over the web:

       program http://www.some-computer.com/some-directory/file.krn

Piped data works in a somewhat similar manner:

       cat file.krn | program

is equivalent to a web file using ths form:

       echo http://www.some-computer.com/some-directory/file.krn | program

Besides the http:// protocol, there is another special resource indicator prefix called humdrum:// which downloads data from the kernscores website. For example, using the URI humdrum://brandenburg/bwv1046a.krn:

      program humdrum://brandenburg/bwv1046a.krn

will download the URL:

http://kern.humdrum.org/cgi-bin/ksdata?file=bwv1046a.krn&l=/brandenburg&format=kern
Which is found in the Musedata Bach Brandenburg Concerto collection.

This online-access of Humdrum data can also interface with the classical Humdrum Toolkit commands by using humcat to download the data from the kernscores website. For example, try the command pipeline:

      humcat humdrum://brandenburg/bwv1046a.krn | census -k

The compiled satb2gs program can be downloaded for the following platforms:
• Linux (i386 processors) (dynamically linked) compiled on 28 Jun 2012.
• Windows compiled on 29 Jun 2012.
• Mac OS X/i386 compiled on 13 Nov 2013.

The source code for the program was last modified on 6 Feb 2011. Click here to go to the full source-code download page.