Viewpoints

Video tutorial available.


With viewpoints, you will be able to analyze themes that are not dominant in the document collection (and so may not show up as peak labels) but which are of particular interest to you. You can define one or more viewpoints for your dataset, each one having list(s) of terms. Viewpoints can be saved for reuse with different datasets, however, if you are using the web-based version of IN-SPIRE, viewpoints cannot be shared across users.

Creating and using viewpoints consists of four main steps:

  1. Setting up viewpoints. Define one or more viewpoints (baseball, economics, etc.) Each viewpoint may have one or more lists of terms. The terms may contain multi-word terms and may also contain terms that appear on default stopword or stopmajor lists. This creates a set of vectors used by the system.

  2. Attaching a viewpoint to a dataset. After opening a dataset, you can select a viewpoint to attach to the dataset.

    1. If the viewpoint was defined prior to the creation of the dataset the appropriate indices should be available (such as multi-word terms and default stops). If one of the terms on the viewpoint list is a default stopmajor, then it still becomes a viewpoint term for this dataset.

    2. If the viewpoint was saved after the dataset was created, some terms may not have been indexed. The system will notify you of any unindexed terms.

  3. Opening a dataset with new or modified viewpoints.

  4. Dataset creation with viewpoints when a dataset is made. The system ensures that all terms on your viewpoint list are indexed.

    1. Vocabulary consistency has to be accomplished during creation. Your viewpoints may contain entities which must be added to the entity list for the dataset.

    2. Your viewpoints may contain stop terms which must be removed from the stop list and added to the stopmajor list.

Setting Up Viewpoints

Each viewpoint may have one or more lists of terms. The terms may contain multi-word terms and may also contain terms that appear on default stopword or stopmajor lists. This creates a set of vectors used by the system. To create a viewpoint:

  1. From the IN-SPIRE main toolbar window Viewpoints menu, select Manage Viewpoints.
    Selecting Manage Viewpoints
    The Manage Viewpoints window appears.
    Manage Viewpoints Window

  2. In the Viewpoints field, type the name of the new viewpoint and Click Add. The new viewpoint name will be added to the column under the Viewpoints field. The Enter key will also add the name to the Viewpoints list.

  3. Next, add a list of terms to your viewpoints. Enter the name of the list of terms you will create in the Lists field.
    Terms are case-insensitive, so when terms are added to the list, they will be converted to all lower-case.
    Add a List to the Viewpoint

  4. Click the Add button. The name of the new List will be added to the column under the Lists field.
    Add New List

  5. Now you need to add terms to the list you have created. Type a term of interest to you in the Terms field and click Add. The term will be added to the column under the Terms field.
    Add Terms to Viewpoints
    Enter as many terms as you wish.

  6. You can import a list of terms you have saved and used elsewhere. To import a list of terms, click the Import button. A file chooser will display a list of any *.term or *.txt files. Select the file containing the list of terms. Terms in the selected file will be added to the currently selected List. Click OK to import the list of terms.

  7. To associate the list of terms with a viewpoint, highlight the viewpoint you want, and check the box next to the List name.
    Selecting Terms for a Viewpoint

  8. When you are finished building your new viewpoint, click Done. The viewpoints and terms will be saved.

Attaching a Viewpoint to a Dataset

Once you have created a viewpoint, you can attach it to your currently open dataset.

  1. From the IN-SPIRE main toolbar window Viewpoints menu, select Attach Viewpoints.
    Attach Viewpoint Menu
    The Attach Viewpoint window opens.
    Attach Viewpoint Window
    Active viewpoints with associated lists of terms will be selectable. Viewpoints that are grayed out need to have terms associated with them before they can be attached to a dataset.

  2. From the Attach Viewpoint window, select a viewpoint and click Attach.
    Unused Terms Window
    The Unused Terms window will display messages about the terms in your selected viewpoint.

  3. Click Continue. A progress message will display as the viewpoint is attached to the dataset. The new viewpoint will be added to the bottom of the Viewpoints menu in the main toolbar. This area displays the three most recently used viewpoints.
    New Viewpoint Added to Menu
    On the menu bar for both Galaxy and ThemeView Classic, you will be able to see which viewpoint can be attached to the open dataset.
    Viewpoints Selector in Galaxy

  4. To view the effect the viewpoint will have on your dataset, click On. The dataset will recalculate and display a new view in both the Galaxy and the ThemeView Classic.
    Viewpoint On in Galaxy View

Opening a Dataset with Viewpoints

When you open a dataset with viewpoints attached to it, IN-SPIRE will check to see if you have updated any of the viewpoints or lists of terms.

Dataset Creation with Viewpoints

When a dataset is created, the system ensures that all terms on your viewpoint list are indexed. These viewpoints are then available for selection from the Viewpoints menu. You can select and attach these viewpoints to your new dataset .

New Viewpoint Added to Menu

When you create a new dataset, IN-SPIRE will check for vocabulary consistency during creation. Your viewpoints may contain entities which must be added to the entity list for the dataset. Your viewpoints may also contain stop terms which must be removed from the stop list and added to the stopmajor list. If this is necessary, IN-SPIRE will prompt you for these when you attach a viewpoint to the new dataset.