Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kbenoit/ITAUR
Introduction to Text Analysis Using R
https://github.com/kbenoit/ITAUR
Last synced: 16 days ago
JSON representation
Introduction to Text Analysis Using R
- Host: GitHub
- URL: https://github.com/kbenoit/ITAUR
- Owner: kbenoit
- License: gpl-3.0
- Created: 2015-10-16T15:01:30.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2018-03-28T14:59:41.000Z (over 6 years ago)
- Last Synced: 2024-10-15T04:10:06.129Z (28 days ago)
- Language: HTML
- Size: 40.3 MB
- Stars: 75
- Watchers: 21
- Forks: 54
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Introduction to Text Analysis Using R
#### A Three-Day tutorial
[Kenneth Benoit]([email protected]), Department of Methodology, LSE
**Date:** Updated for newer versions (> 1.0.0) of **quanteda** in March 2018
**quanteda version:** 1.1.0 (CRAN)
This repository contains the workshop materials for a one-day version of a workshop [Introduction to Text Analysis Using R](link here) taught by Kenneth Benoit. This workshop and the materials it contains are funded by by the European Research Council grant ERC-2011-StG 283794-QUANTESS: *Quantitative Analysis of Text for Social Science*.
### Instructions for using this resource ###
You have three options for downloading the course material found on this page:
1. You can download the materials by clicking on each link.
2. You can "clone" repository, using the buttons found to the right side of your browser window as you view this repository. This is the button labelled "Clone in Desktop". If you do not have a git client installed on your system, you will need to [get one here](https://git-scm.com/download/gui) and also to make sure that [git is installed](https://git-scm.com/downloads). This is preferred, since you can refresh your clone as new content gets pushed to the course repository. (And new material will get actively pushed to the course repository at least once per day as this course takes place.)
3. Statically, you can choose the button on the right marked "Download zip" which will download the entire repository as a zip file.
You can also subscribe to the repository if you have [a GitHub account](https://github.com), which will send you updates each time new changes are pushed to the repository.
### Objectives
This workshop covers how to perform common text analysis and natural language processing tasks using R. Contrary to a belief popular among some data scientists, when used properly, R is a fast and powerful tool for managing even very large text analysis tasks.
The course comprises six mini "modules", each consisting of guided instruction in the form of presentation of methods followed by student implementation of those methods prior to advancing to the next module. Only after we have completed the practical exercises will we advance to the next stage.
We will cover how to format and input source texts, how to structure their metadata, and how to prepare them for analysis. This includes common tasks such as tokenisation, including constructing ngrams and "skip-grams", removing stopwords, stemming words, and other forms of feature selection. We show how to: get summary statistics from text, search for and analyse keywords and phrases, analyse text for lexical diversity and readability, detect collocations, apply dictionaries, and measure term and document associations using distance measures. Our analysis covers basic text-related data processing in the R base language, but most relies on the **quanteda** package (https://github.com/kbenoit/quanteda) for the quantitative analysis of textual data. We also cover how to pass the structured objects from quanteda into other text analytic packages for doing topic modelling, latent semantic analysis, regression models, and other forms of machine learning.
### Prerequisites
While it is designed for those who have used R in some form previously, expertise in R is not required, and even those with no previous knowledge of R are welcome.
### Reading materials
Designed to be done before the course or after, to augment what is presented during the course. These are just suggestions -- no reading before the course is required.
* Browse the **quanteda** R package website, http://quanteda.io, especially the tutorials (also known as vignettes).
* [Sanchez, G. (2013) Handling and Processing Strings in R Trowchez Editions. Berkeley, 2013.](http://www.gastonsanchez.com/Handling and Processing Strings in R.pdf)
* [**stringi** package page](http://www.gagolewski.com/software/stringi/), which also includes a good discussion of the [ICU library](http://site.icu-project.org)
* Some guides to regular expressions: [Zytrax.com's User Guide](http://www.zytrax.com/tech/web/regex.htm)
or the comprehensive resources from http://www.regular-expressions.info
* See the [`quanteda` tag on Stack Overflow](http://stackoverflow.com/questions/tagged/quanteda), where you can pose questions and see some brilliant answers by our development team.
### Schedule
The course will taught interactively, as a series of "mini-modules" consisting of presentations of different aspects of quantitative text analysis using R, followed by practical exercises.
### Module 0: Installation and setup of R and relevant packages
* [CRAN](https://cran.r-project.org) for downloading and installing R
* [GitHub page for the **quanteda** package](https://github.com/kbenoit/quanteda)
* **Exercise:**
- Make sure you have at least R 3.1.0 installed.
- Make sure your packages are up-to-date. From the command line, run
```r
update.packages(ask = FALSE)
```
- Install **quanteda** from CRAN. From the "Packages" pane in RStudio, or from the command line:
```r
install.packages("quanteda")
```
- Install **readtext** from GitHub, following [these instructions](https://github.com/quanteda/readtext/blob/master/README.md).
- Try "knitting" this RMarkdown file: [test_setup.Rmd](http://rawgit.com/kbenoit/ITAUR/master/0_setup/test_setup.Rmd). If it builds without error and looks like [this](http://rawgit.com/kbenoit/ITAUR/master/0_setup/test_setup.html), then you have successfully configured your system.
### Module 1: Overview and demonstration of text analysis using R
* Demonstration of text analysis using R: [demo.R](1_demo/demo.R)
* [Overview, motivation, and philosophy of the **quanteda** package](1_demo/motivation.pdf) (pdf slides)
* **Exercise:** [Step through execution of this example code `workflow.Rmd`.](1_demo/workflow.md)
### Module 2: Basic text data types and functions for text
* [Basic text manipulation using R](2_text_manipulation/text_manipulation.md)
* **Exercise:** Step through execution of the [.Rmd file](https://raw.githubusercontent.com/kbenoit/ITAUR/master/2_text_manipulation/text_manipulation.Rmd).
### Module 3: Getting textual data into R
Install the **readtext** package for this section.
* [Getting textual data into R](3_file_import/file_import.md)
* Example of importing and segmenting text: [2016 US Presidential Debates](3_file_import/create_presidential_debates_corpus.R)
* **Exercise:** Try importing some texts of your own.
* Sample data files: [SOTU_metadata.csv](https://github.com/kbenoit/ITAUR/blob/master/data/SOTU_metadata.csv), [inaugTexts.csv](https://github.com/kbenoit/ITAUR/blob/master/data/inaugTexts.csv), [tweetSample.RData](https://github.com/kbenoit/ITAUR/blob/master/data/tweetSample.RData)
### Module 4: Processing and preparing texts for analysis
* [Text processing in R](4_preparing_texts/preparingtexts.md)
* **Exercise:** Step through execution of the [.Rmd file](https://raw.githubusercontent.com/kbenoit/ITAUR/master/4_preparing_texts/preparingtexts.Rmd).
### Module 5: Descriptive analysis
* [Descriptive analysis of texts](5_descriptive/descriptive.md)
* **Exercise:** Step through execution of the [.Rmd file](https://raw.githubusercontent.com/kbenoit/ITAUR/master/5_descriptive/descriptive.Rmd).
### Module 6: Advanced analysis and working with other text packages
#### Advanced Analysis
* [Advanced analysis](6_advanced/advanced.md)
* [Analyzing social media](6_advanced/social_media_example.R)
* [Analyzing a new corpus: Example from the _Guardian_](6_advanced/Guardian.md)
* **Exercise:** Step through execution of the [.Rmd file](https://raw.githubusercontent.com/kbenoit/ITAUR/master/6_advanced/advanced.Rmd)
* **Twitter analysis example**, and the instructions for setting up your own Twitter app, in [Twitter.Rmd](https://raw.githubusercontent.com/kbenoit/ITAUR/master/6_advanced/Twitter.Rmd).
#### Integration with other packages
* [**stm**](http://www.structuraltopicmodel.com). See the `convert()` function, but also I have an outstanding pull request with the **stm** package maintainer to work directly on a **quanteda** dfm-class object.
* [**tokenizers**](http://github.com/ropensci/tokenizers). A package for tokenizing text in many different and flexible ways.
* [**readtext**](https://github.com/kbenoit/readtext): Import and handling for plain and formatted text files.
* [**spacyr**](https://github.com/kbenoit/spacyr): an R wrapper to the spaCy "industrial strength natural language processing" Python library from http://spacy.io.
* [**tidytext**](https://github.com/juliasilge/tidytext): Text mining using dplyr, ggplot2, and other tidy tools.
### Module 7: Tell us about your problems
* This session is intended for students to describe their own challenges and for the instructors to describe how to solve them. If you have some data you'd like us to work on live, as part of our interactive answers to your problems, you are encouraged to put them somewhere that can be accessed online, so that we will be able to access them in the class. Feel free to file issues at https://github.com/kbenoit/ITAUR/issues or even [fork the repository](https://help.github.com/articles/fork-a-repo/), [make a change, and issue a pull request](https://help.github.com/articles/creating-a-pull-request-from-a-fork/) to correct it!