3.0.2

Changelog

• Minor fixes for CRAN compatibility

Installation

install.packages("DramaAnalysis")

3.0.0

Changelog

This is a redesign and complete overhaul of the R package. Existing code that uses functions of the package cannot be expected to continue to run without modifications. The major changes (compared to 2.x) are:

• Classes: Most functions now produce a classed object.
  This makes it easier to prevent an erroneous use of functions.
• Ids and names: All functions now rely only on character ids. If one needs character
  names for plotting and visualisation, they can be inserted later using characterNames(),
  with a controlled formatting.
• Data files now include stage directions and character mentions, and functions can process them
• Extensive documentation in the form of a tutorial: https://quadrama.github.io/DramaAnalysis/tutorial/3/
• The wording in documentation and functions has been updated, so that figures are now called characters.
• Some functions have been renamed:
  • setup() is now called setDirectories() to avoid name conflicts
  • figureStatistics() is now called characterStatistics()
• Some functions have been removed:
  • rankFiguresByAppearance()
  • rankFiguresByDramatisPersonae()
  • regroup()
  • dictionaryStatisticsL()
  • limitFigures()
  • filterMentioned()
  • dramaHead()
  • dramaTail()
  • enrichDictionary()

Installation

install.packages("DramaAnalysis)

2.1.0

Changelog

• Calling setup() is no longer necessary, if the default paths are ok #78
• A new function filterMentioned() to remove mentions of characters that are not present #90
• A new option to limitFigures() to merge removed speech into a new character Others #90
• The function figureStatistics() can now be applied on segments of the play #85
• Report updates:
  • Personnel exchange in report is now expressed as a bar chart #93
  • Preparations for supporting multiple report types
  • Report is now more robust against weird plays #82
  • Report works better for plays with a large number of characters #84
  • Parameters that can be used for generating a report are now document on the bottom each report.

Installation

devtools::install_github("quadrama/DramaAnalysis", ref="v2.1.0") 

2.0.2

Changelog

• Fixed a bug that crashed the report when the play had no acts #82
• Fixed that limitFigures() did not remove characters from factor levels #83
• Fixed that the different character exchange metrics where shown on different scales in the report #92

Installation

devtools::install_github("quadrama/DramaAnalysis", ref="v2.0.2") 

2.0.1

Changelog

• Fixed a bug when loading certain plays #77

Installation

install_github("quadrama/DramaAnalysis", ref="v2.0.1") 

2.0.0

Changelog

• Texts are no longer loaded via a Java VM and XMI files. Instead, we provide GitHub repositories for different corpora that have been preprocessed and stored in the CSV format. They can be loaded directly in R.
• New features
  • We can now apply dictionaryStatistics() per scene or act #71
  • Report contains more information #72 #75 #70

Requirements

DramaAnalysis should work on Mac OS X, Windows 10 and Linuxes.

Installation

# If not installed before, this package handles the installation directly from GitHub
install.packages("devtools")
devtools::install_github("quadrama/DramaAnalysis", build_vignettes=TRUE)

1.2.0

Changelog

• Bugs fixed
  • Files created by report() now have proper file suffix #60
  • report() now honors the data directory set by users #58
  • Documentation has been updated #63
  • Added vignette about data loading #31
• New features
  • personnel exchange now part of the report #51
  • frequencytable() can be run for segments of the play #54
  • loadFields() can now be used to load enriched word fields #59. Enriched word fields are posted here. Also, enrichDictionary() has been added to enrich word fields using word2vec.

Requirements

DramaAnalysis should work on Mac OS X, Windows 10 and Linuxes, but the JVM needs a bit of memory, so we assume to be working on the 64bit variants.

• R (64 bit)
• Java
• rJava
  • Please make sure rJava finds the correct Java installation on your machine. Windows: This answer worked when testing.

Updating

In some cases, the old java code is not replaced if you just install the new version. Please restart R before and do not run setup() before installation.

Installation

install.packages("https://github.com/quadrama/DramaAnalysis/releases/download/v1.2.0/DramaAnalysis_1.2.0.tar.gz",
   repos=NULL, type="source", INSTALL_opts="--no-multiarch")

1.1.0

Changelog

• Improvements
  • One can now set the file suffix for the dictionaries (#42)
  • Functions of the load()-family now apply as.character() before passing stuff to Java (#43)
  • Handling of sets has been overhauled (#30). Sets are plain text files containing ids, located in the data directory.
  • We can now process documents from multiple collections (#33)
  • A default collection prefix can now be specified that is automatically used for ids w/o prefix (#39)
• New functions
  • Added functions to extract first or last scene(s) or act(s) (#37)
  • Added function to calculate keyness for figures or dramas (#32)
  • Added functions to calculate personnel exchange over scene boundaries #48
• Bugs fixed
  • Date of downloaded corpora is now properly stored (#53)
  • Re-enabled the reporting function (#34, #50)

Requirements

DramaAnalysis should work on Mac OS X, Windows 10 and Linuxes, but the JVM needs a bit of memory, so we assume to be working on the 64bit variants.

• R (64 bit)
• Java
• rJava
  • Please make sure rJava finds the correct Java installation on your machine. Windows: This answer worked when testing.

Updating

In some cases, the old java code is not replaced if you just install the new version. Please restart R before and do not run setup() before installation.

Installation

install.packages("https://github.com/quadrama/DramaAnalysis/releases/download/v1.1.0/DramaAnalysis_1.1.0.tar.gz",
   repos=NULL, type="source", INSTALL_opts="--no-multiarch")

1.0.3

Changelog

• Fixed bug in configuration() (#38)
• Export of meta data working again (#29)
• Fixed bug in figureStatistics() (#40)

Requirements

DramaAnalysis should work on Mac OS X, Windows 10 and Linuxes, but the JVM needs a bit of memory, so we assume to be working on the 64bit variants.

• R (64 bit)
• Java
• rJava
  • Please make sure rJava finds the correct Java installation on your machine. Windows: This answer worked when testing.

Installation

install.packages("https://github.com/quadrama/DramaAnalysis/releases/download/v1.0.3/DramaAnalysis_1.0.3.tar.gz",
   repos=NULL, type="source", INSTALL_opts="--no-multiarch")

1.0.2

Changelog

• Fixed bug in data loading (#35)

Requirements

DramaAnalysis should work on Mac OS X, Windows 10 and Linuxes, but the JVM needs a bit of memory, so we assume to be working on the 64bit variants.

• R (64 bit)
• Java
• rJava
  • Please make sure rJava finds the correct Java installation on your machine. Windows: This answer worked when testing.

Installation

install.packages("https://github.com/quadrama/DramaAnalysis/releases/download/v1.0.2/DramaAnalysis_1.0.2.tar.gz",
   repos=NULL, type="source", INSTALL_opts="--no-multiarch")