Content-type: text/html Manpage of BEAT

BEAT

Section: 7 July 1998 (HUMDRUM++)
Updated: Humdrum++ Commands
Index Return to Main Contents

 

NAME

beat - generates metric position/duration of **kern records

 

SYNOPSIS

beat [-a] [-b kern-rhythm] [-h] [-s|-d] [inputfile1 [inputfile2 ...]] [> outputfile]

 

DESCRIPTION

beat generates a beat location for each **kern record in a humdrum file. All other exclusive interpretations in the file are ignored. The program can also print the duration of a record by using the -d option, and can print the total number of beats in a measure with the -s option.

 

OPTIONS

-a
assembles the input data along with the output analysis spine.

-b kern-rhythm
Sets the rhythmic unit for calculating metrical location. For example, the meter 12/8 can be analyzed either by eighth notes, or by dotted quarter notes. If there is a tandem interpretation for meter in the input file, then the base of the meter will be used by default (for 12/8, eighth notes will be used as the beat). the -b option allows for overriding the meter interpretation. The parameter given to the -b options is in the syntax of a kern rhythm, e.g., eighth note = 8, quarter note = 4, dotted quarter note = 4. If neither a meter interpretation exists nor the -b option is given, then the base rhythm will be set to quarter notes.

-d
displays the duration values of the **kern records as a fraction of the beat instead of giving the metrical position of the record.

-h, --help
Print a usage message and exit with a status code indicating success.

-n
keeps null records when using the -s option.

-s
gives the sum (number) of beats contained in each measure instead of giving the metric position of each record.

-z
assigns the downbeat value to zero rather than the default of one for the first beat of a measure.

--debug
causes a line number message to print to standard output as each input humdrum file line is processed by the beat program.

--example
prints to standard output, some example calls to the beat program.

--options
displays a database of the available options for the command as well as any alias and default values.

--version
prints version information on standard output then exits.

 

EXAMPLES

To find the metric position of kern records:


   beat chor217.krn

To find the beat count for each measure:


   beat chor217.krn -s

To find th duration of each kern record in units of sixteenth notes:


   beat chor217.krn -d -b 16

 

SEE ALSO

composite(humdrum++)

 

LIMITS

The spine count must remain constant throughout an input file. Doesn't detect pickup beats yet.


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
SEE ALSO
LIMITS

This document was created by man2html, using the manual pages.
Time: 03:53:31 GMT, May 12, 2000