| import.TEIApparatus {stemmatology} | R Documentation |
Import TEI apparatus
Description
Import a TEI encoded parallel-segmentation apparatus.
Usage
import.TEIApparatus(file = "", appTypes = c("substantive"))
Arguments
file |
Path to a valid TEI file. |
appTypes |
a vector of strings giving the types of entries that should be retained (as per |
Details
This function takes in input the path to a TEI file, with a <listWit>, with <witness> identified by an @xml:id,
and with <app> entries encoded in parallel-segmentation mode. Using the witness sigla, it then creates a database of variant locations, with witnesses in columns and variant locations in rows.
The @types attributes of the <app> elements are used to assess if they should be included in the variant locations matrix (default: only ‘substantive’ app entries).
The readings are identified either by a code
reflecting their order in the file (1 … n) and omissions by 0. If <app> entries have @xml:id, they are used as rownames. Otherwise, the index is used.
Value
Either a numeric matrix, with witnesses in columns, variant locations in rows, and readings coded by a number;
or, if alternative readings were found at some point, 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).
The output of this function can be used as input for the PCC functions.
Note
If you want more control over the conversion, you can use directly the stylesheets available at https://github.com/Jean-Baptiste-Camps/stemmatology-utils.
Author(s)
Jean-Baptiste Camps (jbcamps@hotmail.com) & Florian Cafiero
References
Jean-Baptiste Camps, 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://hal.archives-ouvertes.fr/hal-01695903/document.