mirror of
https://github.com/sshlien/abcmidi.git
synced 2025-12-06 06:55:06 +00:00
114 lines
3.8 KiB
Groff
114 lines
3.8 KiB
Groff
.TH MIDISTATS 1 "17 November 2023"
|
|
.SH NAME
|
|
\fBmidistats\fP \- program to summarize the statistical properties of a midi file
|
|
.SH SYNOPSIS
|
|
midistats \fIinfile\fP
|
|
|
|
.SH DESCRIPTION
|
|
\fImidistats\fP analyzes the contents of a midi file and outputs key
|
|
information and various statistical measures. Each line of output
|
|
starts with the name of the variable or variable array and the
|
|
associated values. The output is interpreted by the user interface
|
|
midiexplorer.tcl. Both programs are still being improved. Here
|
|
is an explanation of some of the output.
|
|
.PP
|
|
ntrks indicates the number of tracks in the midi file.
|
|
.PP
|
|
ppqn the number of midi pulses per quarter note.
|
|
.PP
|
|
keysig the key signature, followed by a major/minor flag, the number
|
|
of sharps (positive) or flats (negative) in the key, and the beat number
|
|
where the key signature was found.
|
|
.PP
|
|
trk is followed by the track number for which the following information
|
|
applies.
|
|
.PP
|
|
program is followed by the channel number and the General Midi Program
|
|
number.
|
|
.PP
|
|
trkinfo is an array of 8 numbers which indicates the statistical properties
|
|
of the track of interest. The following data is given:
|
|
the channel number,
|
|
the first program assigned to this channel,
|
|
the number of notes for this channel counting any chords as one note,
|
|
the total number of notes for this for this channel,
|
|
the sum of the MIDI pitches for all the notes,
|
|
the sum of the note durations in MIDI pulse units,
|
|
the number of control parameter messages,
|
|
the number of pressure messages.
|
|
the number of distinct rhythm patterns for each channel
|
|
the number of pulses the channel was inactive
|
|
the minimum pitch value
|
|
the maximum pitch value
|
|
the minimum note length in pulses
|
|
the maximum note length in pulses
|
|
the number of gaps in the channel
|
|
the entropy of the pitch class histogram for that channel
|
|
.PP
|
|
After processing all the individual tracks, the following information
|
|
applies to the entire midi file.
|
|
.PP
|
|
npulses is the length of the longest midi track in midi pulse units
|
|
.PP
|
|
tempocmds specifies the number of times the tempo is changed in this
|
|
file.
|
|
.PP
|
|
pitchbends specifies the total number of pitchbends in this file.
|
|
.PP
|
|
progs is a list of all the midi programs addressed
|
|
.PP
|
|
progsact the amount of activity for each of the above midi programs.
|
|
The activity is the sum of the note durations in midi pulse units.
|
|
.PP
|
|
progcolor: is a 17 dimensional vector where each component maps into
|
|
a specific group of MIDI programs. Some of these groups are, keyboard
|
|
instruments, brass instruments, wind instruments, and etc. More information
|
|
can be found in the midiexplorer documentation.
|
|
.PP
|
|
drums is a list of all the percussion instruments (channel 9) that were
|
|
used.
|
|
.PP
|
|
drumhits indicates the number of notes for each of the above percussion
|
|
instruments.
|
|
.PP
|
|
pitches is a histogram for the 11 pitch classes (C, C#, D ...B)
|
|
that occur in the midi file.
|
|
.PP
|
|
pitchact is a similar histogram but is weighted by the length of
|
|
the notes.
|
|
.PP
|
|
chnact returns the amount of note activity in each channel.
|
|
.PP
|
|
trkact returns the number of notes in each track.
|
|
.PP
|
|
totalrhythmpatterns is the total number of bar rhythm patterns for
|
|
all channels except the percussion channel.
|
|
.PP
|
|
collisions. Midistats counts the bar rhythm patterns using a hashing
|
|
function. Presently collisions are ignored so occasionally two
|
|
distinct rhythm patterns are counted as one.
|
|
.SH Advance Percussion Analysis Tools
|
|
.PP
|
|
A number of experimental tools for analyzing the percussion channel
|
|
(track) were introduced into midistats and are accessible through
|
|
the runtime arguments. When these tools are used in a script which
|
|
runs through a collection of midi files, you can build a database
|
|
of percussion descriptors. Some more details are given in the
|
|
file drums.txt which comes with this documentation.
|
|
|
|
.SH OPTIONS
|
|
.TP
|
|
.B -corestats
|
|
.TP
|
|
.B -pulseanalysis
|
|
.TP
|
|
.B etc. (See drums.txt in doc folder.)
|
|
|
|
|
|
|
|
.SH AUTHOR
|
|
Seymour Shlien <fy733@ncf.ca>
|
|
|
|
|
|
|