interpretations: Summarize humdrum corpus interpretations.

In Computational-Cognitive-Musicology-Lab/humdrumR: humdrumR

Summarize humdrum corpus interpretations.

Description

interpretations is used to summarize the interpretations in the pieces of a humdrumR corpus, including exclusive (⁠**⁠) and tandem (*) interpretations. interpretations is one of humdrumR's basic corpus summary functions.

Usage

interpretations(humdrumR)

## S3 method for class 'humInterpretations'
interps[i]

## S3 method for class 'humInterpretations'
print(interps, showEach = TRUE, screenWidth = options("width")$width - 10L)

Arguments

humdrumR	HumdrumR data to summarize. Must be a humdrumR data object.
i	Index for rows. If numeric, selects rows by index. If character, the string is matched as a regular expression against the filenames in the corpus.

Details

interpretations returns a special data.frame called a humInterpretations table. Each row in the table represents a single piece in the corpus. The first column ({X}) is a variable indicating a unique "exclusive pattern" associated with each piece—the exclusive patterns are tallied at the bottom of the printout. The remaining columns indicate how many of each interpretation (indicated by column name) appear in each piece.

For tandem interpretations, counts are returned in the format Total.Unique.Spines:

• Total: The total instances of this interpretation, across all spines.

• Unique: The number of unique versions of this interpretation.

• Spines: The number of spines that this interpretation appears in.

For example, consider the following piece:

**kern   **kern   **silbe
   *C:      *C:         *
     c        e        La
     d        f        la
     e        g        la
   *e:      *e:         *
    f#       d#        la
     g        e         _
     a        b         _
   *G:      *G:         *
    f#        a       doo
     g        b       wop
    *-       *-        *-

In this piece, there is several tandem key interpretations, which humdrumR will call Key. The tabulation by interpretations will return a Key column with the value ⁠6.3.2⁠ for this piece:

• 6 because there are six key interpretations in total.

• 3 because there are three unique keys: ⁠*C:⁠, ⁠*e:⁠ and ⁠*G:⁠.

• 2 because the key interpretations only occur in two spines.

See Also

Other corpus summary functions: census(), humSummary, reference(), spines()

Examples

chorales <- readHumdrum(humdrumRroot, "HumdrumData/BachChorales/*.krn")
interpretations(chorales)

Computational-Cognitive-Musicology-Lab/humdrumR documentation built on Oct. 22, 2024, 9:28 a.m.