location manpage

COMMAND

location -- List musical/file location of each data line.

location -flmbapdLQRS [-x|-q|-h|-w] [input(s)] [> output]

The location program generates an analysis spine which encodes the position of each data line in the file and/or musical score. By default, a single spine with all location features is output. The main use of this location data is to mark the original location of data when searching for patterns with grep. The hgrep program has similar funcionality built into itself for identifying the location of matched patterns in a data file.

example.krn **kern *M4/4 *k[] =-1 4c 4c 4g 4g = 4a 4a 2g; == *-

location example.krn **location * * =-1 "example.krn" L5 M1 B1 Q0 "example.krn" L6 M1 B2 Q1 "example.krn" L7 M1 B3 Q2 "example.krn" L8 M1 B4 Q3 = "example.krn" L10 M1 B1 Q4 "example.krn" L11 M1 B2 Q5 "example.krn" L12 M1 B3 Q6 == *-

The full location information is:

1. Filename enclose in double quotes.
2. Line number, prefixed by capital "L".
3. Measure number, prefixed by capital "M".
4. Beat number, prefixed by capital "B".
5. Absolute quarter note position. (time from start of music until current line), prefixed by capital "Q".

Each of these features can be selectively extracted from the score. When none of the location features are given as an option, all of them are extracted.

1. -f include the filename in the **location spine.
2. -l include the original file line number in the **location spine.
3. -m include the measure number in the **location spine.
4. -b include the metric beat position in the **location spine.
5. -q include the absolute quarter note position in the **location spine.

The location prefix markers can be duplicated after each feature in order to make regular expression more robust by using the -d option to double the labels. This helps to avoid matching cases such as M11 when searching for M1:

example.krn **kern *M4/4 *k[] =-1 4c 4c 4g 4g = 4a 4a 2g; == *-

location -d example.krn **location * * =-1 "example.krn" L5L M1M B1B A0A "example.krn" L6L M1M B2B A1A "example.krn" L7L M1M B3B A2A "example.krn" L8L M1M B4B A3A = "example.krn" L10L M1M B1B A4A "example.krn" L11L M1M B2B A5A "example.krn" L12L M1M B3B A6A == *-

Label prefixes can be removed with the -L option:

example.krn **kern *M4/4 *k[] =-1 4c 4c 4g 4g = 4a 4a 2g; == *-

location -L example.krn **location * * =-1 example.krn 5 1 1 0 example.krn 6 1 2 1 example.krn 7 1 3 2 example.krn 8 1 4 3 = example.krn 10 1 1 4 example.krn 11 1 2 5 example.krn 12 1 3 6 == *-

Spaces between the features can be removed with the -S option:

example.krn **kern *M4/4 *k[] =-1 4c 4c 4g 4g = 4a 4a 2g; == *-

location -S example.krn **location * * =-1 "example.krn"L5M1B1A0 "example.krn"L6M1B2A1 "example.krn"L7M1B3A2 "example.krn"L8M1B4A3 = "example.krn"L10M1B1A4 "example.krn"L11M1B2A5 "example.krn"L12M1B3A6 == *-

The -a option will append the **location spine to the input data, while -p will prepend the analysis data to the input data.

location -p example.krn **location **kern * *M4/4 * *k[] =-1 =-1 "example.krn" L5 M1 B1 A0 4c "example.krn" L6 M1 B2 A1 4c "example.krn" L7 M1 B3 A2 4g "example.krn" L8 M1 B4 A3 4g = = "example.krn" L10 M1 B1 A4 4a "example.krn" L11 M1 B2 A5 4a "example.krn" L12 M1 B3 A6 2g; == == *- *-

location -a example.krn **kern **location *M4/4 * *k[] * =-1 =-1 4c "example.krn" L5 M1 B1 A0 4c "example.krn" L6 M1 B2 A1 4g "example.krn" L7 M1 B3 A2 4g "example.krn" L8 M1 B4 A3 = = 4a "example.krn" L10 M1 B1 A4 4a "example.krn" L11 M1 B2 A5 2g; "example.krn" L12 M1 B3 A6 == == *- *-

The filename quotes can be removed by using the -Q option.

location -Qa example.krn **kern **location *M4/4 * *k[] * =-1 =-1 4c example.krn L5 M1 B1 A0 4c example.krn L6 M1 B2 A1 4g example.krn L7 M1 B3 A2 4g example.krn L8 M1 B4 A3 = = 4a example.krn L10 M1 B1 A4 4a example.krn L11 M1 B2 A5 2g; example.krn L12 M1 B3 A6 == == *- *-

Alternate absolute position descriptions

In addition to -q for absolute quarter note rhythmic positions of data lines, several other rhythmic values can be used:
• -x: express absolute position in terms of sixteenth notes.
• -e: express absolute position in terms of eighth notes.
• -q: express absolute position in terms of quarter notes.
• -h: express absolute position in terms of half notes.
• -w: express absolute position in terms of whole notes.

example.krn **kern *M4/4 *k[] =-1 4c 4c 4g 4g = 4a 4a 2g; == *-

location -xmb **location * * =-1 M1 B1 X0 M1 B2 X4 M1 B3 X8 M1 B4 X12 = M1 B1 X16 M1 B2 X20 M1 B3 X24 == *-

-emb **location * * =-1 M1 B1 E0 M1 B2 E2 M1 B3 E4 M1 B4 E6 = M1 B1 E8 M1 B2 E10 M1 B3 E12 == *-

-qmb **location * * =-1 M1 B1 Q0 M1 B2 Q1 M1 B3 Q2 M1 B4 Q3 = M1 B1 Q4 M1 B2 Q5 M1 B3 Q6 == *-

-hmb **location * * =-1 M1 B1 H0 M1 B2 H0.5 M1 B3 H1 M1 B4 H1.5 = M1 B1 H2 M1 B2 H2.5 M1 B3 H3 == *-

-wmb **location * * =-1 M1 B1 W0 M1 B2 W0.25 M1 B3 W0.5 M1 B4 W0.75 = M1 B1 W1 M1 B2 W1.25 M1 B3 W1.5 == *-

Rational numbers for rhythms

The -R option can be used to list rhythmic values as rational numbers instread of floating point:

location -mba | location -Rmba **kern **location **location *M4/4 * * =-1 =-1 =-1 4c M1 B1 M1 B1 28dLL M1 B2 M1 B2 28e M1 B2.14286 M1 B2+1/7 28f M1 B2.28571 M1 B2+2/7 28g M1 B2.42857 M1 B2+3/7 28a M1 B2.57143 M1 B2+4/7 28b M1 B2.71429 M1 B2+5/7 28ccJJ M1 B2.85714 M1 B2+6/7 2dd M1 B3 M1 B3 == == == *- *- *-

Locate French augmented-sixth chord sonorities in Bach chorales

 tntype -Da h://chorales | location -Qafmb | dittox -p | grep -i French
 
 8FnJ	8BJ	8d#J	(4a)	French-sixth Chord	chor146.krn M4 B2.5
 

A French sixth sonority occurs once in Chorale 146 at measure 4 on the offbeat of beat 2.

Compare to using hgrep:

 tntype -Da h://chorales  | hgrep -NHmb -x '**description' French
 
 chor146.krn:measure 4:beat 2.5:FnJ	8BJ	8d#J	(4a)	French-sixth Chord
 

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

• hgrep

The compiled location program can be downloaded for the following platforms:
• Linux (i386 processors) (dynamically linked) compiled on 24 Oct 2013.
• Mac OS X/i386 compiled on 13 Nov 2013.

The source code for the program was last modified on 17 Oct 2013. Click here to go to the full source-code download page.