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 email@example.com. Lets get started!
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):
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.
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:
You can run Specvis in two ways:
Specvis.jarexecutable JAR file;
java -jar Specvis.jarin the terminal (while in the Specvis main directory).
When you launched Specvis, you will see its main window, which looks like this:
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.
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:
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;
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.
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:
Spacekey on your keyboard, whenever you spot a gray/white dot displayed somewhere on the screen around the central fixation point;
Spacekey 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:
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
10. You can also consider changing
Color. After all changes click
Redraw map to... redraw the map :)
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!