Document Type Collocate Frequencies Grid


Document Type Collocate Frequencies Grid provides and ordered list of word collocation for a specified word and document.

Getting Started

Unlike most tools Document Type Collocate Frequencies Grid does not only require an input corpus, it also requires a keyword to be specified before it can present an analysis. A keyword is provided when the user clicks on a linked word within another tool within the same skin as the Document Type Collocate Frequencies Grid tool. This dynamic can be achieved by building a custom skin with several tools one of them being Document Type Collocate Frequencies Grid.

There are several other tools in Voyant that behave similarly:

Interface Elements

Document Type Collocate Frequencies Grid includes the standard set of interface elements (see image to the right). For more help with these see the Voyeur Tools Standard Interface Elements page.

Standard UI Elements

Reading the tool

The tool provides a sortable table of word collocation for a specified keyword in a specified document. The keyword and the document are indicated in an information bar within the table body.


The default presentation provides three columns:

  • “Frequencies” which provides the words that are said to collocate with the keyword. It is the degree of collocation of these word with the keyword that is to be measured.
  • “Raw Frequency” which provides the number of times the word appears near the keyword and in brackets in the entire document.
  • “Ratio” provides the ratio with which these two frequencies (the frequency of word and keyword collocation, and the raw word frequency) occur in relation to each other. The higher the positive value of “Ratio” the more closely the collocate is associated with the keyword.


To the bottom left hand corner of the tool a set of navigation arrows allows the user to flip or jump between pages of results. As well to navigate through search, a search field to the bottom right of tool allows the user to jump to the page of a specified word.

Configuring the display

Clicking on any one of the down arrows to the right edge of any of the column headers will produce a drop-down menu that provides several options for configuring the display.

  • Firstly in this menu the “Sort Ascending” and “Sort Descending” buttons allow you to organize the table by ordering the rows. The column on which the sorting is toggled will be the one that will determine the order of the rows, the other columns will act subordinate to it. This however can be accomplished more simply by clicking on the column header anywhere to the left to the left of the drop-down menu arrow, clicking subsequently will toggle between “Sort Ascending” and “Sort Descending”.
  • Secondly within this drop-down menu there is also a sub-menu titled “Columns”. Hovering over this button will provide a further menu for all of the other possible column choices. Clicking on an additional column will immediately add it to the table. Clicking on a column choice that is already present in the table will remove it. The presence of a column choice in the table is indicated by the check-box to the left of the selection.


One way a keyword can be defined other than through an external tool is through the “Search” box in the bottom toolbar. Once the user begins typing a word the box will provide suggestions to auto-complete the word. To add the word to the tool, finish typing the word and pressing “Enter” on the keyboard or selecting one of the auto-completed suggestions. Through this method the user can see the keyword’s collocates across the corpus.


Adding and removing terms

The favourites list allows that user to compare terms that are not necessarily positioned near each other in the data, or to keep terms readily accessible. To add a term to the favourites list click the check-box next to any terms and click on the add icon to add them to your favourites list. The add icon is the heart overlayed with s plus sign within the green circle.

To view the favourites list click on the heart icon. To remove any term from the favourites list select the check-box next to any term in the favourites list and select the remove icon. The remove icon can be found in exactly the same position as the add icon, however it is only toggled when a term in the favourites list is selected. Similar to the add icon the remove icon is a heart overlayed with a minus sign within a red circle.


Like all Voyeur tools, Document Term Frequencies can be reused in a variety of ways:

  • create a link that is specific to the corpus and options that are currently being used
  • embed the current corpus and options as a tool in an external page

For more information see exporting and reusing Voyeur Tools.