Analysis of Dramatic Texts

Analysis of preprocessed dramatic texts, with respect to literary research. The package provides functions to analyse and visualise information about characters, stage directions, the dramatic structure and the text itself. The dramatic texts are expected to be in CSV format, which can be installed from within the package, sample texts are provided. The package and the reasoning behind it are described in Reiter et al. (2017) <doi:10.18420/in2017_119>.

Readme

DramaAnalysis with R

This package contains a number of functions to support the analysis of dramatic texts.

Features

Summary statistics about the number of words and utterances per character
Statistics about word use from a dictionary per character
Support for stylometric analyses by character or text
Generation of a report for a dramatic text
Reads in preprocessed texts

Example

# loads a specific, pre-packaged play
data(rksp.0)

# calculates standard stats about a character
charStat <- characterStatistics(rksp.0)

# fix character names
charStat <- characterNames(charStat, rksp.0)

# plot them as a bar plot
barplot(charStat)

Requirements

DramaAnalysis works on Mac OS X, Windows 10 and Linuxes, and requires R 3.3 or later.

Installation

# installation from CRAN
install.packages("DramaAnalysis")

# Install newest development version, requires devtools to be installed
devtools::install_github("quadrama/DramaAnalysis", ref="develop/3.x")

Usage and Howto

Please refer to the tutorial.

Functions in DramaAnalysis

Name	Description
characterStatistics	Basic Character Statistics
newCollection	Create or Extend a Collection
isolateCharacterSpeech	Isolate Character Speech
presence	Active and Passive Presence
installData	Download preprocessed drama data
mapPrefix	Replace corpus prefix
postags	Provides lists of groups of pos tags for various word classes.
dramaNames	Format drama titles
numberOfPlays	Number of plays
ensureSuffix	Utility functions
loadCharacters	Character data loading
frequencytable2	Extract bigrams instead of words (currently not taking utterance boundaries into account)
segment	Segment
loadDramaTEI	Load drama
installCollectionData	Download and install collection data
loadMeta	Load meta data
setCollectionDirectory	This function initialises the paths to data files.
utteranceStatistics	Utterance Statistics
qd.colors	QuaDramA colors
loadDrama	Load drama
report	Report
personnelExchange	Measuring Personnel Exchange over Boundaries
split.QDDrama	Split multiple plays
tfidf	TF-IDF
loadAllInstalledIds	Installed texts
loadText	Load Text
loadSet	Load Collections
keyness	Keywords
filterByDictionary	Word frequencies
plot.QDUtteranceStatistics	Utterance positions
filterCharacters	Filter characters
plotSpiderWebs	Spider-Webs
dictionaryStatistics	Dictionary Use
configuration	Character Configuration
base_dictionary	Base dictionary
barplot.QDCharacterStatistics	Stacked Bar Plot
loadFields	Dictionary Handling
combine	Combine multiple plays
correlationAnalysis	Correlation analysis
characterNames	Format Names
data	Data sets
No Results!

Name

Description

characterStatistics

Basic Character Statistics

newCollection

Create or Extend a Collection

isolateCharacterSpeech

Isolate Character Speech

presence

Active and Passive Presence

installData

Download preprocessed drama data

mapPrefix

Replace corpus prefix

postags

Provides lists of groups of pos tags for various word classes.

Format drama titles

Number of plays

Utility functions

Character data loading

frequencytable2

Extract bigrams instead of words (currently not taking utterance boundaries into account)

segment

Segment

loadDramaTEI

Load drama

installCollectionData

Download and install collection data

loadMeta

Load meta data

setCollectionDirectory

This function initialises the paths to data files.

Utterance Statistics

QuaDramA colors

Load drama

Report

Measuring Personnel Exchange over Boundaries

Split multiple plays

TF-IDF

Installed texts

Load Text

Load Collections

Keywords

Word frequencies

plot.QDUtteranceStatistics

Utterance positions

Filter characters

Spider-Webs

Dictionary Use

Character Configuration

base_dictionary

Base dictionary

barplot.QDCharacterStatistics

Stacked Bar Plot

loadFields

Dictionary Handling

combine

Combine multiple plays

correlationAnalysis

Correlation analysis

characterNames

Format Names

data

Data sets

No Results!

Details

Type	Package
Date	2019-06-20
URL	https://github.com/quadrama/DramaAnalysis
BugReports	https://github.com/quadrama/DramaAnalysis/issues
License	GPL (>= 3)
LazyData	TRUE
RoxygenNote	6.1.1
Encoding	UTF-8
NeedsCompilation	no
Packaged	2019-07-03 13:21:24 UTC; reiterns
Repository	CRAN
Date/Publication	2019-07-10 12:30:07 UTC

imports	data.table (>= 1.10.4) , git2r (>= 0.24.0) , httr (>= 1.2.1) , readr (>= 1.1.1) , reshape2 (>= 1.4.2) , stats , stringr (>= 1.4.0) , tokenizers (>= 0.2.1) , utils , xml2 (>= 1.2.0)
suggests	fmsb , highcharter , igraph (>= 1.1.2) , knitr , magrittr , rmarkdown (>= 1.8) , testthat
depends	R (>= 3.3.0)
Contributors	Nils Reiter, Tim Strohmayer

DramaAnalysis v3.0.0