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.

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 - Check Java version on your computer

Make sure, that your computer has installed Java SE Runtime Environment in version specifically 8u121. You can check it, by typing in your computer terminal (also known as "command prompt" or "cmd"): java -version.

As you can see on the image above, I have version 1.8.0_121, which can be also described as 8u121.

Important: For current version of Specvis (1.1.1) you will need Java SE Runtime Environment specifically in version 8u121. You can find it here. Before installing downloaded items please make sure to remove older/newer versions from your computer.

After downloading and installing Java SE Runtime Environment 8u121 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:

Important: You can move Specvis folder frealy, but do not change location of its individual items (sub-folders, files etc.).


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:

  • Recommended 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;
  • 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.

Important: 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.

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, in order to assure visual field test reliability.


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 or shape - Only if you choose settings including monitoring fixation by changing fixation point characteristics.

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 and/or shape:

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/shape 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:

Important: Procedure can differ based on the chosen/created settings. But rules described above are universal for Specvis visual field test.


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.


Do you want/don't want something in Specvis?

Specvis is under constant development, but I need your opinions on its current versions in order to make next versions better. Taking this into account, please consider filling up this questionnaire. Thank you!