Quick start

Introduction

In this "quick start" guide I will show you how to start your first visual field test with Specvis and how to preview your results. This guide is suitable for everyone, no matter if you are an individual who want to test itself, or a specialist who want to test a patient. If you want to know more about Specvis and its configuration possibilities, please go through its documentation, read the article published in the PLoS ONE journal, and visit Specvis code repository on GitHub (in close future I'll provide also a video tutorial describing work with Specvis in details). I believe, that you can find answers there to most of your additional questions. If you will have even more questions, please write to me directly at piotr.dzwiniel@gmail.com. Lets get started!


Step 1 - Checking/updating Java version

Make sure, that your computer has installed Java Runtime Environment (JRE; popularly called also simply as "Java") in version at least 8u121. You can check it, by typing in your computer terminal (also known as "command prompt" or "cmd" on Windows): java -version.

Here, we see java version "1.8.0_121", which stands for JRE version 8u121. Thus, we don't have to install a newer one. However, if JRE version is lower, than you should update it, for example by visiting this website, where you can download the newest JRE version suitable for your operating system.


After downloading and installing JRE on your computer, you are ready to go.


Step 2 - Download Specvis

If you have not already done so, you can do it here. The downloaded file is a *.zip archive. Unzip it in a desired location. The content of the unzipped folder should look like this:


Step 3 - Launch Specvis

You can run Specvis in two ways:

  • Double click on the Specvis.jar executable JAR file;
  • Type java -jar Specvis.jar in the terminal (while in the Specvis main directory).

When you launched Specvis, you will see its main window, which looks like this:


Step 4 - Add new or choose an existing patient

After Specvis launch, we have to add a new or choose an existing patient, for whom we will perform the visual field test. In order to add a new patient, click New in the Specvis main window, fill the form, and click Save. You can also choose an existing patient, by clicking Existing in the Specvis main window, choosing an existing patient from the table of a newly opened window, and clicking Choose to accept the choice.


Step 5 - Choose eye for the test

Now you have to choose which eye you want to test. Specify it by choosing appropriate option from expandable Tested eye list in the Specvis main window:


Step 6 - Select one of the predefined settings templates

In order to make Specvis more comfortable for the newcomers, I've prepared few settings templates you can choose from. You can choose one in the Specvis main window, by clicking button highlighted below:

At the moment, there are following settings templates available:

  • WhiteOnWhite_48p_SuperFast_FixMonN - for very fast screening testing (~2:30 min) without controlling patient's fixation;
  • WhiteOnWhite_48p_SuperFast_FixMonB_Left - for very fast screening testing (~3:20 min) of the left eye with controlling patient's fixation by presenting a control stimulus in a assumed blind spot location;
  • WhiteOnWhite_48p_SuperFast_FixMonB_Right - for very fast screening testing (~3:20 min) of the right eye with controlling patient's fixation by presenting a control stimulus in a assumed blind spot location;
  • Recommended WhiteOnWhite_48p_SuperFast_FixMonFPC - for very fast screening testing (~3:20 min) with controlling patient's fixation by changing fixation point look;
  • WhiteOnWhite_48p_SuperFast_FixMonBFPC_Left - for very fast screening testing (~3:30 min) of the left eye with controlling patient's fixation by presenting a control stimulus in a assumed blind spot location and by changing fixation point look;
  • WhiteOnWhite_48p_SuperFast_FixMonBFPC_Right - for very fast screening testing (~3:30 min) of the right eye with controlling patient's fixation by presenting a control stimulus in a assumed blind spot location and by changing fixation point look.

If you want to perform a realy fast (but still satisfactory reliable) screening test of your central visual field, and you are just starting work with Specvis, I recommend to pick settings templates with the green recommendation badge on them. Thus, in Step 7, I will use one of them as a reference to present how visual field test in Specvis looks like.

Important: The aforementioned settings templates assume performing visual field test on a most typical 15.6" laptop screen and for the patient sitting 30 cm away from the screen. The patient distance from the screen should be measured from the patient's eyes to the center of the screen perpendicularly. Performing test on a different screen will require to customize Specvis settings.


Step 7 - Conduct the visual field test

When you selected the appropriate settings template, you can now click Start in order to open a window, where you can start the visual field test.

To start the test click one more time Start in a newly opened window:

Now let's stop for a second and let's talk about the visual field test itself - description will be based on one of the Recommended settings templates.

From the patient point of view, you have to have in mind only three things during the test:

  • Gaze at the central fixation point during whole test;
  • Hit Space key on your keyboard, whenever you spot a gray/white dot displayed somewhere on the screen around the central fixation point;
  • Hit Space key on your keyboard, whenever central fixation point will change its color to red.

Knowing this, after starting the visual field test, you will see on your screen something like this (without white textboxes and arrows):

When procedure is running, visual stimuli will be displayed in random locations on the screen around the fixation point. Patient task is to respond to them by hitting Space key, while gazing on the central fixation point:

Patient should hit Space key also when fixation point will change temporary its color to red. This color change lasts the same amount of time as visual stimuli presentation around the fixation point:

When Specvis "think" that patient is not gazing on the fixation point properly, it will display ! symbol in orange box above the fixation point in order to remind the patient to gaze on the fixation point all the time and to respond to its color changes:

In any time during the procedure, patient can pause it by pressing P key. When procedure is paused, a triangle will appear around the fixation point. In order to resume the procedure press P key again - triangle around the fixation point will dissapear:

When patient finished the test, a square will appear around the fixation point. You can now press Escape key to go back to the Specvis window and preview the visual field examination results:


Step 8 - Preview the results

To preview the results from your test just click Show results in the window where you started the test. In order to make your results look "better" try to change Isofactor to 0,5 and Interpolation to 10. You can also consider changing Map to Color. After all changes click Redraw map to... redraw the map :)

I will be slowly leaving support for rainbow scale in visual field examination data, in favor of sequential color scales. If you are curious why, consider reading this article.


Additional information

Beside of this quick start guide, documentation, and article in PLoS ONE, I work on the video tutorial, which will cover Specvis use in details. If you have any ideas, which can make Specvis use easier for the patients and specialists, write to me. Good luck with your diagnosis!