VARS Query FAQ
- What is the VARS Query?
- Which platforms does the VARS Query run on?
- How do I download and use the VARS Query?
- Why do I get a popup message that says
“Security Warning: This application is requesting unrestricted
access to your local machine and network…It is highly
recommend not to install and run this code”? Should I click on
Start?
- I clicked on the Search button several
minutes ago, but the VARS Query is still running. Why is it
taking so long?
- What is this default concept called “-NIL-“?
- How do I pick which columns will show up in the
returns table?
- How do I view the frame grabs that were taken
when these annotations were created?
- Okay, I ran a search and got some results in a
table, now what should I do with them?
- What is the VARS Query?
- Which platforms does the VARS Query run on?
- How do I download and use the VARS Query?
- Why do I get a popup message that says, "Security Warning: This application is requesting unrestricted access to your local machine and network. It is highly recommend not to install and run this code"? Should I click on Start?
- I clicked on the Search button several minutes ago, but the VARS Query is still running. Why is it taking so long?
- What is the default concept called “-NIL-”?
- How do I pick which columns will show up in the returns table?
- How do I view the frame grabs that were taken when these annotations were created?
- Okay, I ran a search and got some results in a table, now what should I do with them?
As part of the Video Annotation and Reference System (VARS) project, a software tool, called VARS Query, was developed to give users access to information in MBARI's video annotation database. MBARI uses high-resolution video equipment to record more than 300 remotely operated vehicle (ROV) dives per year. In the 14 years between 1989 and 2003, 14,000 videotapes were annotated and archived into a centralized institutional resource. There are over 890,000 annotations in the video database. With the VARS Query, users can locate video sequences or access other information recorded during ROV research dives. Complex queries can be made by constraining temporal, spatial, or physical parameters (for example, season, location, or depth). The VARS Query references a knowledge base of over 3,000 biological, geological, and technical terms, providing consistent hierarchical information about objects and associated descriptions for annotating video at sea or on shore.
The VARS Query has been tested and runs on Windows 2000 and XP, Mac OS X, and Linux. It should run on any platform with Java Runtime Environment, version 1.4 or later. A fast internet connection is best.
Download links are on the .VARS Query Application page
User instructions are in the VARS Query User Guide.
Yes, you should click on Start. The VARS Query needs access to your local machine and network to store query results and configurations on your hard drive and connect to the query server and frame grab archive. Java’s security model warns you about this security issue so that you don’t accidentally install malicious programs without your knowledge. The VARS Query is not a malicious program.
The video annotation database contains over a million annotations. The query application cannot retrieve all of them at once. Try hitting Cancel and constraining your search to a few days, months, or years (depending on how frequently your chosen concept appears in ROV dive video). If you’re a new user who simply wants to try out the VARS Query, do your first search on something rare (in MBARI ROV dive videos) like pacific-viperfish, vampire-squid, basaltic-lava, or grimpoteuthis.
Running a search on the NIL concept means you want to see records of all concepts in the database. You’ll get every annotation record except for what is filtered out by your specified Constraints. To avoid getting tied up by an overwhelming number of hits, we recommend users only do NIL concept searches on a very limited date range, such as a few days.
The query opens with some default settings for columns and no constraints. After specifying a basic search, click on the Advanced tab, make selections with the returns and constrain checkboxes, and fill in the details/limits. See instructions on the Advanced Query page
If the return checkbox under Miscellaneous-Image on the Advanced tab is checked (a default selection), an Image column will be returned in the Results table. An entry in the Image column indicates that a frame grab was taken with that annotation. Double-click on the image name and the image will appear in a pop-up window. It may take several seconds to load the image. See the VARS Query Results page for instructions on how to save single or multiple images.
There are some suggestions on the VARS Query Results page.