text2map: R Tools for Text Matrices

This is an R Package with libraries and utility functions for computational text analysis.

The functions are optimized for working with various kinds of text matrices. Focusing on the text matrix as the primary object – which is represented either as a base R dense matrix or a Matrix package sparse matrix – allows for a consistent and intuitive interface that stays close to the underlying mathematical foundation of computational text analysis. In particular, the package includes functions for working with word embeddings, text networks, and document-term matrices.

Related text datasets are available on GitLab in text2map.corpora and text dictionaries are available in text2map.dictionaries.

Installation

Install the CRAN version:

install.packages("text2map")

Or install the latest development version from GitLab:

library(remotes)
install_gitlab("culturalcartography/text2map")

Get started with “Concept Mover’s Distance by reading:

vignette("CMDist-concept-movers-distance", package = "text2map")

Related Packages

There are three related packages in development, and hosted on GitLab:

• text2map.corpora: collection of 13+ text datasets
• text2map.dictionaries: collection of dictionaries, currently:
  • Sensorimotor Norms Dictionary for English, N = 40,000 (Lynott, et al. 2020)
  • Concreteness Dictionary for English, N = 40,000 (Brysbaert et al. 2014)
  • NRC Valence, Arousal, and Dominance Dictionary for English (Mohammad et al. 2018)
• text2map.theme: changes ggplot2 aesthetics and loads viridis color scheme as default
• text2map.pretrained: collection of pretrained embeddings and stm models

The above packages can be installed using the following:

library(remotes)
install_gitlab("culturalcartography/text2map.theme")
install_gitlab("culturalcartography/text2map.corpora")
install_gitlab("culturalcartography/text2map.pretrained")
install_gitlab("culturalcartography/text2map.dictionaries")

Contributions and Support

We welcome contributions!

For any contributions, feel free to fork the package repository on GitLab or submit pull requests. We follow the Tidyverse and rOpensci style guides (see also Advanced R). In terms of adding functions, we encourage any method that works with base R matrices or the Matrix package’s dgCMatrix class.

Please report any issues or bugs here: https://gitlab.com/culturalcartography/text2map/-/issues

Any questions and requests for support can also be directed to the package maintainers (maintainers [at] textmapping [dot] com).