WEB-based scoring software for the Farnsworth-Munsell 100-Hue, Roth 28-Hue, Farnsworth D-15, and the Lanthony D-15 desaturated color tests

Béla Török, M.D., Ph.D. bela@torok.info

1. Purpose and general informations

Web-based platform independent scoring for the Farnsworth-Munsell FM 100-Hue, the Farnsworth D-15 and the Lanthony D-15 color vision tests. The result of the test is a SVG (Scallable Network Graphics) polar diagram. Since SVG is a vetcor graphic file format, the quality of the output is limited only by the capabilities of the output device.  

The test programs are availble from the following URLs:
Primary server:
FM100-Hue scoring program:  http://www.torok.info/colorvision/fm100.htm
Roth 28-Hue scoring program: http://www.torok.info/colorvision/roth28.htm
Panel D-15 scoring program: http://www.torok.info/colorvision/d15.htm
Secondary server:
FM100-Hue scoring program:  http://www.belatorok.com/colorvision/fm100.htm
Roth 28-Hue scoring program: http://www.belatorok.com/colorvision/roth28.htm
Panel D-15 scoring program: http://www.belatorok.com/colorvision/d15.htm
Secure server: (Data transfer with SSL encryption)
FM100-Hue scoring program:  https://ssl4.webland.ch/www820/colorvision/fm100.htm
Roth 28-Hue scoring program: http://ssl4.webland.ch/www820/colorvision/roth28.htm
Panel D-15 scoring program: https://ssl4.webland.ch/www820/colorvision/d15.htm

The directions for use is (this file):
http://www.torok.info/colorvision/dir_for_use.htm
http://www.belatorok.com/colorvision/dir_for_use.htm

The scoring program is platform independent and can be used with any browsers supporting SVG (Scalable Vector Graphics). SVG is a new XML-based language for Web graphics, most of the current browsers like MS Internet Explorer, Netscape, etc., require a plugin (SVG Viewer). The coming generation of browsers will probably support SVG natively.
SVG Viewers for Win 98 - XP, MacOs 8.6-9.1, MacOs 10.1, RedHat Linux 7.1 and Solaris 8 are available for free from: http://www.adobe.com/svg/viewer/install/main.html. Use always the actual version of the SVG-Viewer! The latest Version of the SVG-Viewer at the time of this writing was 3.0.

Information on SVG is available at: http://wiki.svg.org/Viewer_Implementations, http://www.w3.org/Graphics/SVG/Overview.htm8 and http://www.adobe.com/svg/.

Browser setup: Javascript must be enabled! (Usually enabled as default.)

2. Direction for use

Enter patient data in the "Name", "Date of birth" and "Address" fields. 
The "Date" is the actual date (accuracy depends on the date and time settings of the client computer). If necessary this field can be overwitten. To change the date format see the customization section. 

If the "Send result to:" field contains a valid Email address results of the test are also forwarded to that address. A leave this fleld blank if you don't want to send the result by mail. The "Sender's Email address" field contains the mail address of the sender (the defalt is noreply@torok.info). To customize these two email addresses see the customization section. 

Select the eye(s) tested using the radio buttons.

The order of the color caps can be selected using the mouse. A red light above each boxes indicates an error (a cap was selected two or multiple times). A green light indicates that the selection is OK.

Clicking the "Calculate result" will compute the score and color defect type. The "Reset caps" button resets color caps to the default state (use) this button before retest, or side change. (The fields with patient information remain unchanged.)
Pressing the button "Reset all fields" clears the patient information fields, and resets the color caps to the default state.

After pressing the "Calculate results" button the patient data, date, the order of the color caps, a polar diagram, the total error score, midpoint and color defect type is presented in the same window.

After printing the results, the fellow eye can be calculated by pressing the "Back" button (left arrow) in the upper left corner of the browser (left arrow -> "reset caps" -> jump to the top of the page, select the other eye with the radion buttons, etc.).

3. Calculation of the total error score

The Farnsworth-Munsell 100-hue total error score is calculated as documented in the user's manual.

The Roth 28 error scores were calculated the similar way like the Farnsworth-Munsell 100-hue score. Since the cup-to cup diffrenece is 3, the total error score is similar to the FM 100-Hue test.

The Panel D-15 total error score is calculated using the calculation proposed by Lanthony: Lanthony P. Evaluation du Panel D-15 désaturé. I: Méthode de quantification et scores normaux. J. Fr. Ophtalmol. 1986, 9:843-847

Normative data for different age groups were incorporated  from the following publications in the scoring programs:

1. Verriest G, Van Laethem J, Uvijls A. A new assessment of the normal ranges of the Farnsworth-Munsell 100-hue test scores. Am J Ophthalmol. 1982; 93:635-642.

2. Kinnear PR, Sahraie A.New Farnsworth-Munsell 100 hue test norms of normal observers for each year of age 5-22 and for age decades 30-70. Br J Ophthalmol. 2002; 86:1408-1411.

3. Erb. C, Adler M, Stübiger N, Wohrab M, Zrenner E, Thiel HJ. Colour vision in normal subjects tested by the colour arrangement test 'Roth 28-hue desaturated'. Vision Research 1998; 38:3467-3471

The 95% confidence level of the total error score for different age groups according to Verriest et al., Kinnear and Sahraie and Erb et al., and Lanthony.

4. Calculation of the color defect type

Automatic calculation of the FM 100-Hue and Roth 28-Hue midpoint

1. The scores of each caps are stored in a circular array. 
2. A lowpass filter is applied to this array.
3. The midpoint is calculated as the index of the maximal value in the smoothed array

The color defec type is calculated if the error score is >= 80 according to Farnsworth (see table below). Literature: Farnsworth D. The Farnsworth-Munsell 100-Hue Test. Manual, Munsell Color Company, Baltimore, MD, 1957.

Farnsworth-Munsell 100-Hue, Roth 28-Hue, Farnsworth D-15 and Lantony D15 Desaturated color defect type calculation using the moment of inertia method according to Vingrys and King-Smith

If the selectivity index is larger than 1.65, the color defect type is calculated as follows:

5. Archiving the results

The resulsts of the test are stored in a html and a SVG file. Both files are generated by the scoring program running on the www server. Two methods of archiving are possible:

a. Archiving only the URL of the test result (Since the URLs can be openened with every SVG-enabled browsers, this is the recommended method.):

1. Calculate the results
2. Copy the URL of the resultpage to the clipboard. (Edit menu -> Copy option)
3. Paste the URL in a file, e.g., Excel, Word, etc. or in a database.

b. Archiving only the html file (not recommended, since it stores browser-specific html-code):

1. Calculate the results
2. Save the page as a html file. (File menu -> Save as... option)

The polar diagram is stored as a reference (URL). After opening the html file the polar diagram will be generated online.
Since the graphics is stored as reference an internet connection is necessary to reproduce the charts. 

c. Archiving the SVG files:

1. Calculate the results
2. Move the cursor over the polar diagram.
3. Press the right button, store the polar diagram as a SVG file using the "Save SVG As..." option, e.g., test123.svg.

6. Importing the charts in other applications

Method 1. Using the clipboard (works only with the Adobe SVG-viewer plugin):

1. Calculate the results
2. Move the cursor over the polar diagram.
3. Press the right button, copy the polar diagram to the clipboard using the "Copy SVG" option.
4. Paste data from the clipboard into other programs (PowerPoint, Word, etc.) using the "edit -> paste" commands.
5. Resize the image

Method 2. Using SVG files:

1. Calculate the results
2. Move the cursor over the polar diagram.
3. Press the right button, store the polar diagram as a SVG file using the "Save SVG As..." option, e.g., test123.svg.
4. Open the SVG with an other application supporting SVG, e.g., CorelDraw.

7. Customizing

Customizing the Title

The default title of the page with the ploar diagram is: Farnsworth-Munsell 100-Hue Test - Copyright: Béla Török M.D., Ph.D.
To include your institution name in the Title, e.g.: Farnsworth-Munsell 100-Hue Test - Dept. of Ophthalmology, Your University, Yourtown

1. Copy index.htm to your harddisk or server
2. Open index.htm with an editor and insert your institution name in the following line
   from
   <input type="hidden" name="INST" value="">
   to
   <input type="hidden" name="INST" value="Dept. of Ophtalmology, Your University, Yourtown">
3. Save index.htm
4. Start browser with the modified index.htm

Customizing the Date Format

To change the default date format (dd.mm.yyyy), e.g.: to (yyyy.mm.dd):

1. Copy index.htm to your harddisk or server
2. Open index.htm with an editor and insert your institution name in the following line
   from
   document.write('<input type="text" name="DATE" size="20" value= "', day, ".", month, ".", year,'">');
   to
   document.write('<input type="text" name="DATE" size="20" value="',  year, ".", month, ".",day, '">');
3. Save index.htm
4. Start browser with the modified index.htm

Customizing the default Email settings

1. "Mail a copy of the result to:" field. Insert the email address between the "" after the value= <br><td><tt>Mail a copy of the result to: </tt><input type="text" name="MAIL_TO" size="30" value=""></td>
   ,e.g.,<br><td><tt>Mail a copy of the result to: </tt><input type="text" name="MAIL_TO" size="30" value="name@server.com"></td>
   
2. "From:" field. Insert your email address between the "" after the value=
   <td align="right"><tt>From: </tt><input type="text" name="MAIL_FROM" size="30" value="noreply@torok.info"></td>
   ,e.g.,
   <td align="right"><tt>From: </tt><input type="text" name="MAIL_FROM" size="30" value="yourname@yourserver.com"></td>
   
3. "Email Subject" field. Insert your email address between the "" after the value=
   <td align="right"><tt>Email Subject: </tt><input type="text" name="MAIL_FROM" size="30" value="Farnsworth-Munsell 100-Hue Test Result"></td>
   ,e.g.,
   <td align="right"><tt>Email Subject: </tt><input type="text" name="MAIL_FROM" size="30" value="type your subject line here"></td>
   

Customizing the size of the polar diagram in the browser window

1. Remove the word "checked" from the line
   <input type= "radio" name= "IMG_SIZE" value= "650"checked>650&nbsp;&nbsp;
   e.g.,
   <input type="radio" name="IMG_SIZE" value="650">650&nbsp;&nbsp;
   
2. To change the default size, e.g, to 550, edit add the word "checked to the following line:
   <input type="radio" name="IMG_SIZE" value="550">550&nbsp;&nbsp;
   e.g.,
   <input type="radio" name="IMG_SIZE" value="550" checked>550&nbsp;&nbsp;
   

8. SVG Implementations

http://www.w3.org/Graphics/SVG

http://www.webreference.com/authoring/languages/svg

9. The Farnsworth-Munsell FM 100-Hue, Farnsworth D-15 and Lanthony D-15 tests are available from the following companies:

http://www.luneau.fr

http://www.xrite.com

http://www.richmondproducts.com

10. Operating System and Browser Compatibility

Windows 98 - Vista:

Macintosh: (Since I have no MACs, I could not test the compatibility.)

Linux:

Adobe SVG plugin for Internet Explorer Windows 98 - XP, also works with Vista with some limitations (officially not supported). Available until 31.12.2008

Apple Safari for MacOS and Windows XP & Vista

Opera for Windows, MacOS, Linux, Solaris, QNX, FreeBSD & BeOS

Firefox for Windows, MacOS, Linux