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