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 humInterpretations
[(interps, i)
# S3 method for 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. Ifcharacter
, 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")
#> Finding and reading files...
#> REpath-pattern '/home/nat/.tmp/Rtmpn4KeFS/temp_libpath7af94615c2ed/humdrumR/HumdrumData/BachChorales/*.krn' matches 10 text files in 1 directory.
#> Ten files read from disk.
#> Validating ten files...
#> all valid.
#> Parsing ten files...
#> Assembling corpus...
#> Done!
interpretations(chorales)
#>
#> ###### Interpretation content in humdrumR corpus "chorales" (ten pieces):
#> {X} **kern BPM Clef Instrument ***
#> (Total.Unique.Spines)
#> chor001.krn [ 1] {A} 4 4.1.4 4.3.4 8.8.8 ***
#> chor002.krn [ 2] {A} 4 4.1.4 4.3.4 8.8.8 ***
#> chor003.krn [ 3] {A} 4 4.1.4 4.3.4 8.8.8 ***
#> chor004.krn [ 4] {A} 4 4.1.4 4.3.4 8.8.8 ***
#> chor005.krn [ 5] {A} 4 4.1.4 4.3.4 8.8.8 ***
#> chor006.krn [ 6] {A} 4 4.1.4 4.3.4 8.8.8 ***
#> chor007.krn [ 7] {A} 4 4.1.4 4.3.4 8.8.8 ***
#> chor008.krn [ 8] {A} 4 4.1.4 4.3.4 8.8.8 ***
#> chor009.krn [ 9] {A} 4 4.1.4 4.3.4 8.8.8 ***
#> chor010.krn [10] {A} 4 4.1.4 4.3.4 8.8.8 ***
#> (Total.Unique.Spines)
#> ###### Totals:
#> {X} **kern BPM Clef Instrument ***
#> Hits: 10 10 10 10 ***
#>
#> (***five columns not displayed due to screensize***)
#> Tallies:
#> {A} = **kern, **kern, **kern, **kern: 10
#>