# Step 1: Exercise One

In this two-part exercise, you will dive straight into Voyant to get a sense of how the tool works and what the text analysis process can look like. In part one, you will learn how to copy and paste text into Voyant and see how different Voyant tools work together. In part two, you will learn how to upload a text file to Voyant and a little about preparing a text for text analysis.

### **Part One**

**1.)** Copy Martin Luther King Jr.'s "I Have a Dream" speech from [this site](https://www.americanrhetoric.com/speeches/mlkihaveadream.htm). (If the site is down, search for a full version of the speech.) Make sure **only to copy the speech** and not other text on the webpage. (Incorporating any other text will impact the results.)&#x20;

**2.)** Go to [Voyant](https://voyant-tools.org/)

**3.)** Paste the text into the "Add Text" box and click "Reveal":

![](https://4055173823-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LgXtIWpHMikxGQHLU5T%2F-MTaQbqTiK37NhU72dMi%2F-MTaTHRqsgrH0pwIpFtc%2Fvoyant_reveal.jpg?alt=media\&token=2168f7bb-49c6-4d72-8bd0-9a249b8eadf5)

The results should look  something like this:

![](https://4055173823-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LgXtIWpHMikxGQHLU5T%2F-MTaWv1ruqeMC2pQGmO_%2F-MTaYLgIrVQa1mFDYpEa%2FVoyant_MLK.jpg?alt=media\&token=4881b57d-1596-437f-a2fb-d4b42088597b)

**4.)** To get a sense of how Voyant works, click on the word "freedom" in the **Cirrus \[A],** or word cloud, then scroll through the **Reader \[B]** and notice how the word "freedom" is highlighted throughout.&#x20;

In **Trends \[C],** notice how the line graph only shows "freedom." Now click on one of the line graph points and see how the **Contexts \[D]** changes to show the context in which "freedom" appears throughout the speech. (It should look like the below).

!["Freedom" as it appears in Trends and Contexts.](https://4055173823-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LgXtIWpHMikxGQHLU5T%2F-MTfDwnvFkyxF862PdQ3%2F-MTfI-DuETjMKIb1Ihpu%2Fvoyant-mlk-trends-context.png?alt=media\&token=2349f2ab-5f01-4dac-a33b-65cb077ae6a4)

Note: If you click the question mark in the upper right corner of each tool, e.g., Cirrus, you will get an explanation of that specific one.

Text analysis is more often associated with working with a large corpus (for example, all the works of a single author) or an enormous one (for example, all fiction publications from 1800-1900). In the case of a smaller corpus, a single speech being particularly small, using a text analysis tool like Voyant can facilitate close reading and is especially good for examining structure and word usage.

### Part Two

**1.)** Download the following text file. (It's [_The Complete Works of Shakespeare_](https://www.gutenberg.org/ebooks/100) in Project Gutenberg.) It will likely download to your download folder or desktop.

{% file src="https://4055173823-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LgXtIWpHMikxGQHLU5T%2F-MU5wm5_zUKbaY6RNOIL%2F-MU5xQ1lEJ-PqZVDkijY%2FCompleteWorks-Shakespear.txt?alt=media&token=54256943-8115-4371-b5aa-4240d2aeefb0" %}
Shakespeare Text File
{% endfile %}

**2.)** Go to [Voyant](https://voyant-tools.org/) again to launch a new instance and upload the text file by clicking on "Upload," navigating to the downloaded file, and select it. It will automatically "reveal" and will look something like the following: &#x20;

![](https://4055173823-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LgXtIWpHMikxGQHLU5T%2F-MT70I7A9cWyVOP00VxO%2F-MT79Ws6yGoZZDWLOWoz%2Fshakespeare-voyant-visualization01.png?alt=media\&token=f7522556-e815-4b31-ae9c-2e8c148753b1)

Take a minute to look the Voyant instance over. Notice words like "shall, "hath," and any special characters in the word cloud. Notice the Project Gutenberg "boilerplate text" in the Reader. In Trends, notice that the horizontal line has numbers, and notice that as you scroll down in Contexts, the name in the Document column comes from the text file name and never changes. &#x20;

**3.)** Now [take a look at this Voyant instance](https://voyant-tools.org/?corpus=fda801306cf9029b49fa46e5a97df0db\&stopList=keywords-f4a6821a0e081fdd1ac32d4c0617eb32\&panels=cirrus,reader,trends,summary,contexts) (also seen in the image below) that contains _The Complete Works of Shakespeare_ as well. This time the text was prepared prior to it being uploaded.&#x20;

Notice that words like "shall, "hath," and special characters are no longer in the word cloud. This is because stopwords were applied to remove them. Notice that the boilerplate text is gone. This is because it was deleted from the text file before being uploaded. In Trends, the play names can now be seen below the horizontal line, and they can also be seen in Contexts' Document column. This is because the file, which contained all of Shakespeare's plays, was cut up into individual text files, one for each play. The files were also renamed to represent the play titles. The sonnets, which were also in the text, were removed so that the instance would be solely focused on plays.&#x20;

![](https://4055173823-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LgXtIWpHMikxGQHLU5T%2F-MT7CgXR-kIGVflw_Xf4%2F-MT7DRhy01Iq7I4fRyjm%2Fshakespeare-voyant-visualization02.png?alt=media\&token=51afe976-2a92-4f8c-9138-526c1fc96aa4)

As you explore Voyant, keep in mind that it, and all text analysis tools, do not do the analysis. It provides ways into texts that enable users to come to conclusions based on their own knowledge and analytical skills.
