Skip to content

sightline-ophthalmic/OS-Acuity

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

40 Commits
 
 
 
 
 
 

Repository files navigation

OS-Acuity

Open Source Visual Acuity Testing for Optometrists. This open source project (and it's continued support) is funded by Sightline Ophthalmic Associates. Original code by James Watt. This repo contains a copy of Optician-Sans.

A live version of this site is available for use at acuity.sightlinelaser.com.

Requirements

OS-Acuity was written for the Google Chrome web browser on the following hardware.

Exam room

Line-of-sight distance from patient to display should be inside the range 10 ft to 30 ft. Distances outside that range may be inaccurate. Use something like a Bosch laser tool to measure the exact distance. OS-Acuity supports reversed optotype for rooms with mirrors.

Understanding sizing

The most complicated part of this project is displaying and resizing optotype accurately. The ViewSonic is a professional grade display, making it a perfect candidate for this task.

Each pixel on this display measures exactly 0.274mm in the real world. This was calculated by four separate formulas and then verified through rigorous testing. Because of the work involved, this will be the only display officially supported.

Keep in mind, all existing visual acuity equipment at offices around the world are already loaded with proprietary optotype software. Those systems will never need to display OS-Acuity on their monitors. Our solution is intended for those looking to roll their own hardware.

Using another display

If you still must use another display, please consider:

  • 1920x1080 is recommended.
  • The correct aspect ratio should be used for your display.
  • DPI scaling should be set to 100%.
  • Open a picture of a perfect square. Vertical pixel height must equal horizontal pixel height. If one side of the square is longer than the other, do not use this display.

You can use this calculator tool to estimate the size of each pixel. This tool provides a rough estimate only; it should not be trusted until you verify the dimensions. Once you know the size of each pixel on your display, enter the value in the configuration menu.

Installation and usage

Put the contents of wwwdata into the root directory, subfolder, or subdomain of your website. It is recommended that you clone this repo and then symlink the folder to streamline future updates.

Configuration

Press Q to open the configuration menu. Your settings are saved as a cookie.

Enter only whole numbers for feet (e.g. 5, 10, 20) and decimal numbers for inches (e.g. 1.0625, 2, 3.5.) Please do not enter fractions (e.g. 3/4".)

Usage

Press ↑ or ↓ (up or down) to increase or decrease the size of the optotype. Press ← or → (left or right) to randomize the letters.

Formulas & Calculations

Optotype calculations provided by Dr. Christopher Carver, O.D.