stemmatology (version 0.3.2)

PCC.Stemma: PCC.Stemma: Building the Stemma Codicum

Description

Builds a stemma codicum of the tradition, following the Poole-Camps-Cafiero method.

Usage

PCC.Stemma(x, omissionsAsReadings = FALSE, limit = 0, recoverNAs= TRUE,
           layout_as_stemma = FALSE, ask = TRUE, verbose = FALSE)

Arguments

x

a numeric matrix, with witnesses in columns, variant locations in rows, and readings coded by a number; or a character matrix, with witnesses in columns, variant locations in rows, and, in each cell, one or several readings, coded by numbers and separated by a comma (e.g. '1,2,3', if the witness has three different readings).

omissionsAsReadings

logical; if TRUE, omissions are treated as variant readings. They are taken into account in determining conflicts between variant locations or in computing severe disagreements between witnesses).

Default: FALSE.

limit

The maximum number of severe disagreements expected for witnesses to be in the same group.

Default: 0.

recoverNAs

logical; if TRUE, when an actual witness or reconstructed subarchetype is identified to the reconstructed model of a group, every NA it has is recovered by taking the value of the reconstructed model; if FALSE, their NAs values are kept. Default: TRUE.

layout_as_stemma

logical; if TRUE, the witnesses will be placed vertically according to the distance from their parent, as per the function layout_as_stemma (experimental!) Default: FALSE

ask

logical; if FALSE, decisions will be made without asking the user for input. Default: TRUE

verbose

logical; if FALSE, the function will only return the results, without information on the operations. Default: FALSE.

Value

The function returns either a single list, or a list containing several lists (if multiple stemmata were drawn). Each list contains:

fullDatabase

The full database, with the new reconstructed models and recovered NAs (if applicable).

database

The same with the descripti removed.

edgelist

An edgelist expressing the relations between the witnesses of each group with, as a third column, the distances between witnesses.

models

A list containing the database of readings for each model at the time of their reconstruction (i.e., before they are compared to extant witnesses).

modelsByGroup

A matrix with, in columns the groups, and a single row containing the label of their model.

Details

The PCC.Stemma function calls successively the functions PCC.disagreement, PCC.buildGroup and PCC.reconstructModel to build a stemma codicum of the tradition studied. By default, it stops when less than four witnesses are to be compared, as the possibility of errors becomes high. The user is however able to ask the algorithm its final answer for those last witnesses.

References

Camps, Jean-Baptiste, and Florian Cafiero. <U+2018>Stemmatology: An R Package for the Computer-Assisted Analysis of Textual Traditions<U+2019>. Proceedings of the Second Workshop on Corpus-Based Research in the Humanities (CRH-2), edited by Andrew U. Frank et al., 2018, pp. 65<U+2013>74, https://halshs.archives-ouvertes.fr/hal-01695903v1.

Camps, Jean-Baptiste, and Florian Cafiero. <U+2018>Genealogical Variant Locations and Simplified Stemma: A Test Case<U+2019>. Analysis of Ancient and Medieval Texts and Manuscripts: Digital Approaches, edited by Tara Andrews and Caroline Mac<U+00E9>, Brepols, 2015, pp. 69<U+2013>93, https://halshs.archives-ouvertes.fr/halshs-01435633, DOI: 10.1484/M.LECTIO-EB.5.102565.

Poole, Eric. <U+2018>L<U+2019>analyse stemmatique des textes documentaires<U+2019>. La pratique des ordinateurs dans la critique des textes, Paris, 1979, p. 151-161.

Poole, Eric, <U+2018>The Computer in Determining Stemmatic Relationships<U+2019>. Computers and the Humanities, 8-4 (1974), p. 207-16.

See Also

PCC.disagreement, PCC.buildGroup, PCC.reconstructModel, layout_as_stemma.

Examples

# NOT RUN {
# Load data
data("parzival")
# or alternatively, import it
#fournival = import.TEIApparatus(file = "myFournival.xml", 
#                      appTypes = c("substantive"))
# }
# NOT RUN {
# Interactive mode
# Analyse it with the PCC functions
myDBs = PCC.Exploratory(parzival)
# draw a stemma
PCC.Stemma(myDBs$databases[[2]])
# }
# NOT RUN {
# Non interactive mode
myDBs = PCC.Exploratory(parzival, ask = FALSE, threshold = 0.06)
PCC.Stemma(myDBs$databases[[2]], ask = FALSE)
# }