Skip to content

DCS-training/IntroToTextAnalysis

Repository files navigation

Intro To Text Analysis

This tutorial on Text Analysis was developed for CDCS by Dave Elsmore (Edina). This workshop uses the programming language Python to perform some common text analysis tasks. No previous experience of using Python is required, we will not be taking a deep-dive into programming but rather just using some basic commands to handle and analyse text.

Areas we will cover:

  • Handling text files and strings
  • Cleaning texts
  • Word frequency
  • Frequency distribution
  • Parts of speech tagging

Copyright

This repository has a License: CC BY-NC 4.0 license

How to use this repository

Inside this repository you are going to find an a Jupyter Notebooks that will allow learning how to perform text analysis and a series of datasets (.txt files). If you want more information on how to use RegEx (Regular Expression) via Python you can have a look to this module.

How to use the Jupyter Notebooks

1. Noteable

If you are part of the University of Edinburgh you can use Noteable the cloud-based computational notebook system which work on your browser from any device.

To get started:

Get the Notebook files for this tutorial

Download the files listed on the right to a location on your computer Make sure you know the location they have been downloaded to (usually your 'Downloads' folder) as you will need to upload them to Noteable. (The filename should end with '.ipynb'. If your computer has appended '.txt' to the end of the file make sure this is removed)

Start Noteable

  1. Open the following link in a new tab: https://noteable.edina.ac.uk/login
  2. Log in with your EASE credentials
  3. Under 'Standard Notebook' click 'Start'

Upload the Notebook to Noteable

  1. From the Noteable home page, click on the 'Upload' button at the top right of the screen and browse to one of the files you saved earlier to select it.
  2. Now click the blue 'Upload' button to load it into Noteable
  3. Once the file has been uploaded, click on the filename to start the Notebook

2. Installing Python via Anaconda

Python is great for general-purpose programming and is a popular language for scientific computing as well. Installing all of the packages required for this lessons individually can be a bit difficult, however, so we recommend the all-in-one installer Anaconda.

Regardless of how you choose to install it, please make sure you install Pythonversion 3.x (e.g., Python 3.6 version).

Windows - Video tutorial

  1. Open anaconda.com/download with your web browser.

  2. Download the Python 3 installer for Windows.

  3. Double-click the executable and install Python 3 using MOST of the default settings. The only exception is to check the Make Anaconda the default Python option.

  1. Open anaconda.com/download with your web browser.

  2. Download the Python 3 installer for macOS.

  3. Install Python 3 using all of the defaults for installation.

Starting Python

To start Jupyter Notebook Open the Anaconda Navigator and Launch Jupyter Notebook

Upload the Notebook

  1. Download the notebook on your machine
  2. Go to Upload
  3. Navigate to where you have download your file
  4. Select Upload again
  5. Double click on the uploaded file

3. Run the notebooks via GoogleColab

Open Google Colab: https://colab.research.google.com If you are not already logged you will be prompted to log-in via gmail

Upload the Notebook to Google Colab

  1. Go on the GitHub header and copy paste this link to the notebook you want to use and press enter

4. Using the Notebook

The Notebook contains paragraphs of explanatory text interspersed with grey cells containg code blocks. To run a code block and see the result:

  1. Place your cursor within the cell
  2. Click the 'Run' button on the top menu
  3. The results of running this code will appear below
  4. if the results don't appear immediately, check the icon in the browser tab. AN eggtimer icon indicates it is processing the code.
  5. It is best to follow the Notebook from top to bottom as some code blocks will depend on results from previous cells
  6. You can edit code blocks yourself and run them to see the results of your changes

5. Clearing the cells

To clear the results and run the code again you can use the 'Cell' menu on the top menu bar

  1. To clear the results of the current cell: Cell > Current Outputs > Clear
  2. To clear the results of all cells: Cell > All Output > Clear