Video Annotation and Reference System (VARS)

VARS Annotation User Guide – Video File

This guide gives basic instructions for starting and using the VARS annotation interface. Useful definitions and descriptions can be found in the Glossary. If you need extra help or information, please contact us.

Getting started

    1. Start the program by double-clicking on the varsannotation-video.jnlp.varsannotationjnlp
    2. The VARS logo will appear while the knowledge base loads and the annotation app starts up. This may take a minute or so.annot_loading
      After the knowledgebase finishes loading, the annotation interface opens.
    3. To begin using VARS for video files, you must first login, then open the video file that you wish to annotate.
      For user login, type in your username and your password (or type ‘guest’).vars_annotation_video_files

      If you have not created a user account previously, select the Create a new user account. In the Create new user window choose an appropriate user login name and password. Also fill in your personal details including affiliations/organization. Once completed, select OK. Note: Do NOT use your network or any other secure password as it will be viewable by the VARS administrators.


    4. Select the video button to open and existing or new video file. Within the new window that opens, do the following:
      • To open new video files select open by location, browse to and select the video file you wish to annotate and choose open then select the ROV name from the camera platform drop-down menu and enter the dive number into the sequence number box.
      • To open a previously annotated video file, choose open existing and select the name of the file you wish to re-open. Select a timecode source, choices include automatic, timecode track, or elapsed depending upon needs and file source. Press OK.vars_open_video_file


The interface screen now appears as below, note that the user and video connection boxes should now appear as green checks instead of red X’s.


Under video player, you may choose to play videos using the built in player or the Quicktime component. The video player you select will depend upon the video container and codec that you are using.

Annotation mode: At the lower left of the VARS annotation screen, choose an annotation mode (style of annotation). The default mode is Outline mode and is used for at-sea annotations.

Camera direction: At lower right of screen describes the direction of ROV travel. The default direction is descend, but the direction should be updated as ROV direction changes throughout the dive.

Adding and modifying annotations

These are basic directions for creating and modifying annotations. Definitions or descriptions of the various parts of the interface can be found in the Glossary. Some keyboard shortcuts are included in the instructions. NOTE: We use the terms observation and annotation interchangeably in the documentation below.

Adding an annotation

  1. Click on the New button (or ctrl+N / cmd+N). A new line will be created in the observation table with the default object in the observation column and with the current video file timecode.annotation_NEW
  2. Type the concept name in the editor and press Enter. The new concept name will be updated in the observation table. For faster annotations see information below about a custom icon panel.


Adding an annotation with a frame grab

  1. To create an annotation associated with a frame grab, click the frame grab (F) button (or ctrl+F/ cmd+F ). The frame grab will be displayed in the upper right corner of the user interface, under the Frame-grab tab. By default, the concept physical-object will be entered in the observation column. The F button in the FG/S column of the observation table will be highlighted in green, indicating there is a frame grab associated with this observation.annotation_Framegrab
  2. To give the annotation a more specific name (concept), type the concept in the concept editor (located just under the observation table), and press Enter.

Duplicating an observation

    1. Click on the row with the observation to be copied.
    2. Click on the green Copy Anno button (or press cntrl + G on the keyboard). This will duplicate the observation and its associations to a new row with a new time code.


Creating multiple observations for a single time code

  1. To create multiple observations with the same time code, click the row with the desired time code.
  2. Select the Copy TC button (or press Cntrl + D on the keyboard). Rename the duplicate timecode observations as appropriate.


Adding an association to an observation

An association is a structured descriptor that provides additional information about an annotation. For example, color of the item, behavior such as swimming or eating, resting on some substrate, etc.

  1. Add an association by selecting a row in the annotation table.annotation_duplicate_TC
  2. In the concept editor click on the green + button.
  3. In the association search box, type part of the association you wish to search for and press Enter. You can continue to press Enter to scroll through additional matches.annotation_edit_window
  4. Press the green + button again to add the association. (The association editor will automatically close.)


Adding an association using the blue ‘Quick annotation association’ buttons

    1. Click on the blue annotation button that represents the association you wish to add. The choices are:
      S (sample)
      N (population)
      ? (identity uncertain)
      C (close-up)
      New# (new reference number)
      Old# (old reference number)
      Good (good image quality)
      D (dense population).
      See buttons in the annotation glossary, for details.


Deleting an observation

    1. Highlight the observation line to be deleted.
    2. Click the red Delete button. The row will be deleted from the table (with a warning). Multiple lines can also be selected and deleted.


NOTE: VARS has undo/redo buttons on the toolbar in case you delete observations you meant to keep. You can undo the last 25 operations in VARS.

Deleting an association from an observation

    1. Highlight the observation row to be edited, so that the associations for that observation will appear in the concept editor.
    2. In the concept editor, highlight the association to be deleted.
    3. Click the red X (Remove Association) button and the association will disappear from the concept editor or the observation table.


Custom icon tabs

If you do a lot of annotations, setting up a custom icon tab (in the panel area across the bottom of the interface) allows adding new observations quickly. For this panel, each icon is really a word—specifically the name of a concept. For efficient annotation, you can create separate tabs for different types of dives, such as Geology or Midwater, and populate each with the names of commonly observed objects in those categories.

Creating custom icon tabs

If you do a lot of annotations, setting up a custom icon tab (in the panel area across the bottom of the interface) allows adding new observations quickly. For this panel, each icon is really a word—specifically the name of a concept. For efficient annotation, you can create separate tabs for different types of dives, such as Geology or Midwater, and populate each with the names of commonly observed objects in those categories.

  1. To create an icon tab, click on the New (green +) button at the right of the icon panel. At the prompt, name the new tab.
  2. In the concept edit window search box, type the name of the object that you would like to add to the tab.
  3. Press Enter until the correct object is highlighted.
  4. Click on the name, and drag it onto the tab that you created. The name is now an icon.
  5. Continue adding icons as needed.
  6. Organize the icons by dragging them around within the tabs.
  7. To delete an icon (concept) from a tab, right-click on the icon, and select Delete from the drop-down menu.
  8. To locate a concept in an icon tab within the knowledge base tree (for reference), right-click on the icon in the panel, and select Find in knowledgebase tree from the drop-down menu. The concept will be highlighted in its correct position in the knowledge base.

Adding observations using icons

  1. Click on the icon with the name of the concept to be added. The observation will be added to the table along with the current VCR time code.
  2. Add associations as necessary using the Associations buttons or association editor.


Data repository
Data policy
Deep-Sea Guide
What is happening in Monterey Bay today?
Central and Northern California Ocean Observing System
Chemical data
Ocean float data
Slough data
Mooring ISUS measurements
Southern Ocean Data
Mooring data
M1 Mooring Summary Data
M1 Asimet
M1 download Info
M1 EMeter
Molecular and genomics data
ESP Web Portal
Seafloor mapping
Soundscape Listening Room
Upper ocean data
Spatial Temporal Oceanographic Query System (STOQS) Data
Image gallery
Video library
Creature feature
Deep-sea wallpapers
Previous seminars
David Packard Distinguished Lecturers
Research software
Video Annotation and Reference System
System overview
Data Use Policy
Video Tape User Guide
Video File User Guide
Annotation Glossary
Query Interface
Basic User Guide
Advanced User Guide
Query Glossary
VARS publications
VARS datasets used in publications
Oceanographic Decision Support System
MB-System seafloor mapping software
How to download and install MB-System
MB-System Documentation
MB-System Announcements
MB-System Announcements (Archive)
MB-System FAQ
MB-System Discussion Lists
MB-System YouTube Tutorials
Matlab scripts: Linear regressions
Introduction to Model I and Model II linear regressions
A brief history of Model II regression analysis
Index of downloadable files
Summary of modifications
Regression rules of thumb
Results for Model I and Model II regressions
Graphs of the Model I and Model II regressions
Which regression: Model I or Model II?
Matlab scripts: Oceanographic calculations
Matlab scripts: Sound velocity
Visual Basic for Excel: Oceanographic calculations
Educational resources
Navigating STEM careers
MBARI Summer Internship Program
2017 Summer Interns Blog
Education and Research: Testing Hypotheses (EARTH)
EARTH workshops
2016—New Brunswick, NJ
2015—Newport, Oregon
2016 Satellite workshop—Pensacola, FL
2016 Satellite workshop—Beaufort, NC
EARTH resources
EARTH lesson plans
Lesson plans—published
Lesson plans—development
Lesson drafts—2015
Lesson drafts—2016 Pensacola
Adopt-A-Float Program
Center for Microbial Oceanography: Research and Education (C-MORE) Science Kits
Science at home: Curriculum and resources
Sample archive
SciComm Resources