Skip to content

Voyant Tools Guide

Approved for data classification level

0 1 2 3


Voyant is a text reading and analysis environment. It is possible to work with one or more texts in a variety of formats.

1. Using the Voyant application

1.1 Finding the application

  • Click on the applications button


VoyantApp


  • Click on search


VoyantApp


  • Search ”Voyant”


VoyantApp


  • Click on Voyant


VoyantApp


1.2 Using the application

You should now see the following screen:


VoyantApp


There are several options here, and it can seem overwhelming. For this example, we’ll walk through the quickest way to start the app.

1.2.1 Choose a name for your job

  • Pick a name that makes it easy to find your work later and distinguish between different jobs
  • Write the name under “Job Name”.
  • Example: "Voyant_demo1". Note: Job and file names cannot include special characters such as "æøå".

1.2.2 Select the duration of your job

  • Select the duration of your job and enter the number under “Hours”
  • You need to estimate for how long time you will need to use the app. The application can take some time to show results, because it analyzes all text before showing you, afterwards you can edit what types of reading or analysis you will receive.

Note: If you run out of allocated time, the application still shows the results, but you cannot use the functions or make any changes. You can allocate more time after starting the job if needed.

1.2.3 Pick a machine to use

  • We recommend the u1-standard-16.


VoyantApp


Feel free to test what works best for you. Now, you are ready to begin your work. Click Submit to start the process.


VoyantApp


  • Click on “Open interface” and the application will open.

Note: There can be waiting time before the interface is ready for you. Just wait until it looks like this:


VoyantApp


Now the application pops op in a new window and you can upload the files you would like to work on. The entire text collection you are working on is called corpus in the application.

There are three main ways of selecting a corpus in Voyant Tools:

  1. type or paste into the main text area, either normal text or a
  2. insert a URL link to a webpage, one per line.
  3. Upload one or more files from your computer.

The upload file selector should allow you to choose one or more files using Ctrl and Shift keys. If you have several documents to add at once, it may be easiest to first create a zip archive containing the files and then upload the one zip file.

It is possible to work on one or more files and have combination of files and webpages.

  • Press “Reveal” when you have all the texts for the corpus.


VoyantApp


It can take some time for the application to read the corpus. Once the corpus is read you will be presented with the default skin. There are many more types of


VoyantApp


You can choose other options of analysis here


VoyantApp


Here’s a link to the different type of analysis called “skins” Click Here

You can edit the list of “stop words” so the tools will not include the stop words. Click on “Define options for this tool”


VoyantApp


This window pops up and click on “Edit List” next to “Stopwords”


VoyantApp


Now you can add the words you don’t want to see in your research, one term per line


VoyantApp


Click "Save" and then "Confirm" in options