multicastR (version 1.3.0)

mc_metadata: Access the Multi-CAST metadata

Description

mc_metadata downloads a table with metadata on the texts and speakers in the Multi-CAST collection. The data is downloaded from the servers of University of Bamberg and presented as a data.table.

Usage

mc_metadata(vkey)

Arguments

vkey

A numeric or character vector of length 1 specifying the requested version of the annotation values. Must be one of the four-digit version keys in the first column of mc_index, or empty. If empty or no value is supplied, the most recent version of the annotations is retrieved automatically.

Value

A data.table containing metadata on the Multi-CAST collection. The table has the following eight columns:

[, 1] corpus

The name of the corpus.

[, 2] text

The title of the text.

[, 3] type

The text type, either TN 'traditional narrative', AN 'autobiographical narrative', or SN 'stimulus-based narrative'.

[, 4] recorded

The year (YYYY) the text was recorded.

[, 5] speaker

The identifier for the speaker.

[, 6] gender

The speaker's gender.

[, 7] age

The speaker's age at the time of recording. Approximate values are prefixed with a c.

[, 8] born

The speaker's birth year (YYY). Approximate values are prefixed with a c.

See Also

multicast, mc_index, mc_referents, mc_clauses

Examples

# NOT RUN {
  # retrieve the most recent version of the Multi-CAST metadata
  mc_metadata()

  # retrieve the lists of referents published in May 2019
  mc_metadata(1905)   # or: mc_metadata("1905")

  # join the metadata to a table with annotation values
  mc <- multicast()
  merge(mc, mc_metadata(), by = c("corpus", "text"))
# }
# NOT RUN {
# }