myank manpage

COMMAND

myank -- Extract selected measures from a Humdrum score.

myank [-m list | --mark ]

The myank program will extract a measure or range of measures from a score, including the prevailing key signature and time signature. In order to extract a particular measure, the measure needs a number present in the measure token in the first column of the data. Use the barnum program to add bar numbers if they are not present in the data already.

The myank program functions in a similar manner to the Humdrum Toolkit command yank. However, myank is optimized for pulling measures out of full scores, including one with complicated spine manipulations, and also keeping track of current key signatures, keys, time signatures, meter symbols, and tempo markings. Here is an example illustrating the difference between extracting a measure with myank and yank:

myank -m 90 input.krn !!!COM: Beethoven, Ludwig van !!!CDT: 1770///-1827/// !!!OTL: Piano Sonata no. 1 in F minor, mvmt. 1 !!!ODT: 1794///-1795/// !!!ODE: Joseph Haydn !!!OMD: Allegro !!!OPS: Op. 2 !!!ONM: No. 1 !!!OMV: No. 1 !!!AGN: Sonata Form **kern **kern *clefF4 *clefG2 *k[b-e-a-d-] *k[b-e-a-d-] *f: *f: *M2/2 *M2/2 *MM240 *MM240 =90- =90- 8A-\L 4cc'\ 4ccc'\) 8C\ . 8c\ 4cc'\ 4ccc'\ 8C\J . 8B\L 4r 8C\ . 8d\ 4ff\ (4fff\ 8C\J . = = *- *- !!!ENC: Craig Stuart Sapp !!!END: 2004/04/05/

yank -n ^= -r 90 input.krn **kern **kern *Ipiano *Ipiano *>[A,A,B,B] *>[A,A,B,B] *>A *>A *clefF4 *clefG2 *k[b-e-a-d-] *k[b-e-a-d-] *f: *f: *M2/2 *M2/2 *MM240 *MM240 * *^ * *v *v *^ * *v *v * *^ * *v *v * * *clefF4 * *clefG2 *clefG2 * *>B *>B *clefF4 * *^ * *v *v * *^ * *v *v * *^ * *v *v * *^ * *v *v * * *^ * *v *v =90 =90 8A-\L 4cc'\ 4ccc'\) 8C\ . 8c\ 4cc'\ 4ccc'\ 8C\J . 8B\L 4r 8C\ . 8d\ 4ff\ (4fff\ 8C\J . *- *-

Differences between the two programs:

• myank preserves reference records and global comments before and after the main body of the data (use rid -G to remove), while yank does not include these lines.
• yank echos all interpretation records prior to the extracted data which allows the monitoring of all global values and spine manipulations. myank simplifies this interpretation data and ignores interpretations which it does not understand and which are not present in the extracted measure(s). Global settings of clef, key signature, key, time signature, metric symbol, and tempo are the tandem interpretations which myank will keep track of, and display the current setting for this interpretations at the start of the extract measure(s).
• myank will close the data more gracefully than yank, joining any subspines together so that the number of columns at the start of the data on the first exclusive interpretation line matches the count on the end-of-data markers (*-) line.
• myank allows extracting measures in reverse orderings and duplications, while yank only extracts in forward temporal sequence.

Extracting a single measure

Use the -m option with a single integer to extract a particular measure.

input **kern *k[] *C: *M4/4 *MM120 =1- 1c =2 1d =3 1e =4 1f =5 1g =6 1a =7 1b =8 1c == *-

myank -m 5 **kern *k[] *C: *M4/4 *MM120 =5- 1g = *-

Extracting a range of measures

Use a dash in the measure string for the -m option to indicate the starting and ending measure of the extracted measures. If the range starts with the larger number, then the measures will be extracted in reverse order.

input **kern *k[] *C: *M4/4 *MM120 =1- 1c =2 1d =3 1e =4 1f =5 1g =6 1a =7 1b =8 1c == *-

myank -m 2-6 **kern *k[] *C: *M4/4 *MM120 =2- 1d =3 1e =4 1f =5 1g =6 1a = *-

myank -m 6-2 **kern *k[] *C: *M4/4 *MM120 =6- 1a =5 1g =4 1f =3 1e =2 1d = *-

Extracting non-contiguous range of measures

Multiple measures or ranges of measures can be extracted by placing a comma between the single measure and range of measures.

input **kern *k[] *C: *M4/4 *MM120 =1- 1c =2 1d =3 1e =4 1f =5 1g =6 1a =7 1b =8 1c == *-

myank -m 2,4,6,5-3,4-6 **kern *k[] *C: *M4/4 *MM120 =2- 1d =4 1f =6 1a =5 1g =4 1f =3 1e =4 1f =5 1g =6 1a = *-

Using dollar sign for last measure

The dollar sign ($) can be used to represent the last measure of the file when extracting single measures or range of measures. Place the measure list within single quotes so that the command-line interpreter does not try to interpret the dollar sign as the marker for an environmental variable.

input **kern *k[] *C: *M4/4 *MM120 =1- 1c =2 1d =3 1e =4 1f =5 1g =6 1a =7 1b =8 1c == *-

myank -m '$' **kern *k[] *C: *M4/4 *MM120 =8- 1c == *-

myank -m '4-$' **kern *k[] *C: *M4/4 *MM120 =4- 1f =5 1g =6 1a =7 1b =8 1c == *-

Placing a non-negative integer value immediately after a dollar sign will subtract that amount from the value represented by the dollar sign. If the last measure in the score is 100, then $5 is measure 95.

input **kern *k[] *C: *M4/4 *MM120 =1- 1c =2 1d =3 1e =4 1f =5 1g =6 1a =7 1b =8 1c == *-

myank -m '$1' **kern *k[] *C: *M4/4 *MM120 =7- 1b = *-

myank -m '$2-$5' **kern *k[] *C: *M4/4 *MM120 =6- 1a =5 1g =4 1f =3 1e = *-

Including instrument codes

To include instrument codes found before the start of any notes, measures, or spine manipulators, use the -i option.

input **kern *Ivioln *clefG2 *f#: *M2/4 *MM120 =1- 4f# 4g# =2 4a 4b =3 4cc# 4dd# =4 4ee 4ff# == *-

myank -m 3 **kern *clefG2 *f#: *M2/4 *MM120 =3- 4cc# 4dd# = *-

myank -m 3 -i **kern *Ivioln *clefG2 *f#: *M2/4 *MM120 =3- 4cc# 4dd# = *-

Supress last barline

Use the -B option to supress printing of the last barline in the list of extracted measures.

input **kern *clefG2 *k[] *C: *M4/4 *MM120 =1- 1c =2 1d =3 1e =4 1f =5 1g =6 1a =7 1b =8 1cc == *-

myank -B -m 5 **kern *clefG2 *k[] *C: *M4/4 *MM120 =5- 1g *-

myank -B -m 2,4,6 **kern *clefG2 *k[] *C: *M4/4 *MM120 =2- 1d =4 1f =6 1a *-

Double barline separator

The --double option can be used to place a double barline between mesures in the output which are not in sequential order. This is useful for separating different segments from the same score in the output from myank.

Measure extraction by marked notes

Instead of giving a measure list with the -m option, you can use the --mark option to extract all measures which contain a mark character in any **kern data. A mark character is defined by either of the following reference record starting characters:

     !!!RDF**kern: @= match
     !!!RDF**kern: |= mark 

If the --mark option is used, the program searches for reference records of this format (with any characters following on the lines after the above contents). In this case, any measures which contain the characters "@" or "|" in **kern data, that measure will be output by myank. The "@" and "|" characters are only examples. Any user-definable character can be used in an !!!RDF reference record, and any number of markers will be used to pull measures out of the input score. User-definable characters in **kern data are: i, j, l, N, U, V, Z, @, |, +, <, and >.

Example usages of the myank program are available on the myank examples page.

• yank
• barnum

The compiled myank program can be downloaded for the following platforms:
• Linux (i386 processors) (dynamically linked) compiled on 8 Nov 2013.
• 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 1 Apr 2013. Click here to go to the full source-code download page.