lift_data: Lift up a piece of data

In HumanitiesDataAnalysis/TEIdy: Work with TEI and other XML Data as Tidy Text.

Description

Frequently a TEI document will have useful information about subheadings located inside another tag: for instance, consider this XML. The author is "HAMILTON", but authorship applies to the entire 'div.'

This function allows you to lift out the contents of any field up to every element in the same document (where 'document' is defined by the current tibble grouping.) Now every element in the div will have 'Hamilton' as author.

<div> <title>FEDERALIST No. 1</title> <p>General Introduction</p> <p>For the Independent Journal.</p> <author>HAMILTON</author> <text> <p>To the People of the State of New York:</p> [...] </text> </div>

The 'from' and 'to' arguments give finer-grained control, but generally it can be OK to populate the text from one tag to the full document.

Usage

lift_data(data, where, from = NULL, to = NULL)

Arguments

data	A tibble.
where	The tag where a value is located; eg, 'author'.
from	The tag to extract a value from. By default '.text'; i.e., the data is in the text field.
to	The new field to put the value into. By default, it overwrites

Value

A copy of the original tibble with one altered or new column.

HumanitiesDataAnalysis/TEIdy documentation built on May 11, 2019, 7:25 p.m.