PCC.overconflicting {stemmatology}

PCC Exploratory Methods: Identification of Over-Conflicting Variant Locations

Description

Given a network of conflicts (contradictions) between variant locations, this function helps in assessing which are the problematic ones.

Usage

PCC.overconflicting(x, ask = TRUE, threshold = NULL)

Arguments

x

an object of class pccConflicts.

ask

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

threshold

numeric; the centrality threshold above which variant locations are considered to be over-conflicting. Used only with ask = FALSE.

Details

This function is dedicated to the identification of problematic variant locations, as defined in Poole 1974 and Camps & Cafiero 2015. It helps the user defining a threshold, defined in terms of centrality index, above which variant locations are considered to be over-conflicting. This output can be then passed to the function PCC.elimination, to remove them from the database.

Value

An object of class "pccOverconflicting", a list containing the three same first objects as the "pccConflicts" input,

edgelist

a two-column character matrix, giving the edges between variant locations in the network of conflicts

conflictsTotal

a one-column numeric matrix, giving the total number of conflicts per variant location

database

the original database used for the calculations

and adding

vertexAttributes

a two column character matrix, with a row per vertex of the network (i.e. variant location), giving its label and colour

Author(s)

Jean-Baptiste Camps ([e-mail]) & Florian Cafiero

References

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

Camps, Jean-Baptiste, and Florian Cafiero. ‘Genealogical Variant Locations and Simplified Stemma: A Test Case’. Analysis of Ancient and Medieval Texts and Manuscripts: Digital Approaches, edited by Tara Andrews and Caroline Macé, Brepols, 2015, pp. 69–93, https://halshs.archives-ouvertes.fr/halshs-01435633, DOI: 10.1484/M.LECTIO-EB.5.102565.

Poole, Eric. ‘L’analyse stemmatique des textes documentaires’. La pratique des ordinateurs dans la critique des textes, Paris, 1979, p. 151-161.

Poole, Eric, ‘The Computer in Determining Stemmatic Relationships’. Computers and the Humanities, 8-4 (1974), p. 207-16.

See Also

PCC.Exploratory, PCC.conflicts, PCC.elimination.

Examples

# Load data
data("fournival")

# Analyse its conflicts
myConflicts = PCC.conflicts(fournival)
## Not run: 
# Interactive mode: identify over-conflicting VL
PCC.overconflicting(myConflicts)

## End(Not run)
# Non interactive mode
PCC.overconflicting(myConflicts, ask = FALSE, threshold = 0.06)