PCC.conflicts: PCC Exploratory Methods: Conflicts between Variant Locations

Description Usage Arguments Details Value Author(s) References See Also Examples

View source: R/PCC.conflicts.R

Description

Given a matrix of variant locations, this function compares them by pairs to identify conflicting genealogical information between them.

Usage

1
PCC.conflicts(x, omissionsAsReadings = FALSE, alternateReadings = FALSE)

Arguments

x

if alternateReadings = FALSE (default), a numeric matrix, with witnesses in columns, variant locations in rows, and readings coded by a number; if alternateReadings = TRUE, 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 (and taken into account in determining contradictions between variant locations or in computing disagreements between witnesses). Default: FALSE.

alternateReadings

logical; if TRUE, a witness can have multiple variants for a single variant location (contaminated manuscripts, editio variorum, …), encoded as comma-separated values. Default: FALSE.

Details

This function tries to identify conflicts between variant locations, understood as contradictions in the genealogical information they might contain. In order to do that, every possible pair of variant locations is analysed in order to see if both can denote at least one possible normal genealogy (i.e. a genealogy without contamination or polygenesis). If not, they are considered "conflicting".

A network representing all the conflicts between variant locations is drawn, and the total number of conflicts and centrality index by variant location is given, as an help to estimate which variant locations are unreliable. This output can be then passed to the function PCC.overconflicting. See Camps & Cafiero 2015 for more details.

Value

An object of class "pccConflicts", a list containing

edgelist

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

conflictsTotal

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

database

the original database used for the calculations

Author(s)

Jean-Baptiste Camps (jbcamps@hotmail.com) & 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.overconflicting.

Examples

1
2
3
4
5
# Load data
data(fournival)
 
# Analyse its conflicts
myConflicts = PCC.conflicts(fournival)

stemmatology documentation built on May 2, 2019, 5:10 a.m.