| ARCHETYPE ID | openEHR-EHR-OBSERVATION.visual_acuity.v0 |
|---|---|
| Concept | Visual acuity test |
| Description | A test to quantify an individual's visual acuity, as a measure of the ability to discern small visual differences. |
| Use | Use to record a single assessment of visual acuity per event. Use both for 'minimum resolveable visual acuity' and 'reading acuity', but specify this using the 'Perceptive Task' element. Use both for assessments attempting to identify the highest attainable visual acuity, as well as those where the visual acuity under special conditions is of interest. Use the 'Result'-cluster to record the primary notation of the assessment, typically only using one of the contained elements per event. Use the 'Derived Results' Cluster to record any number of conversions or derivations into other notations. Use the 'Supplementary results'-SLOT for structured results not covered by other elements. Use the 'Visual aid per eye' SLOT to record what was positioned in front of the eye(s) during the assessment. This allows flexible combination of aids to be recorded, including multiple corrections in front of the same eye. Population of 'Visual aid type' element is recommended under all circumstances. Use the value "unaided" for uncorrected tests where nothing was positioned in front of the tested eye(s). |
| Misuse | Not to be used to record multiple visual acuity tests in one event. The "Result" cluster is not to be used to record the same visual acuity test in multiple converted units - only the primary notation is to be documented there. If the same test result is to be converted to other units, use the "derived result" cluster for all conversion results. Not to be used for assessments of fixation behaviour (e.g. fixes and follows, central steady maintained fixation; no appropriate archetype available at the time of writing). Not to be used for assessing light projection, use 'light_projection_test' instead. |
| Purpose | For recording the results of visual acuity assessments, which are typically performed by testing the individual's ability to resolve symbols, discern gratings or to read text at a defined distance using either the right, left or both eyes. |
| References | Elliott DB. The good (logMAR), the bad (Snellen) and the ugly (BCVA, number of letters read) of visual acuity measurement. Ophthalmic Physiol Opt. 2016 Jul;36(4):355-8. doi: 10.1111/opo.12310. PMID: 27350181. Bach M. Visual acuity “cheat sheet” for high and low vision [Internet]. Freiburg (Germany): Michael Bach; 2017 Oct 20 [updated 2026 Jun 11; cited 2026 Jun 13]. Available from: https://michaelbach.de/sci/acuity.html Beck RW, Moke PS, Turpin AH, Ferris FL 3rd, SanGiovanni JP, Johnson CA, Birch EE, Chandler DL, Cox TA, Blair RC, Kraker RT. A computerized method of visual acuity testing: adaptation of the early treatment of diabetic retinopathy study testing protocol. Am J Ophthalmol. 2003 Feb;135(2):194-205. doi: 10.1016/s0002-9394(02)01825-1. PMID: 12566024. Early Treatment Diabetic Retinopathy Study design and baseline patient characteristics. ETDRS report number 7. Ophthalmology. 1991 May;98(5 Suppl):741-56. doi: 10.1016/s0161-6420(13)38009-9. PMID: 2062510. de Jong PTVM. A history of visual acuity testing and optotypes. Eye (Lond). 2024 Jan;38(1):13-24. doi: 10.1038/s41433-022-02180-6. Epub 2022 Aug 3. Erratum in: Eye (Lond). 2024 Jan;38(1):226. doi: 10.1038/s41433-023-02612-x. PMID: 35922542; PMCID: PMC10764321. Radner W. Toward an internationally accepted standard for reading charts. Prog Retin Eye Res. 2024 Jul;101:101262. doi: 10.1016/j.preteyeres.2024.101262. Epub 2024 Apr 2. PMID: 38574851. IHE Eye Care Domain. General Eye Evaluation (GEE) [Internet]. IHE; 2012. Available from: http://www.ihe.net/Technical_Framework/upload/IHE_EyeCare_Supp_GEE_Rev1-1_TI_2012-06-29.pdf Royal College of Ophthalmologists. Cataract National Dataset for Adults [Internet]. 2011. Available from: http://www.rcophth.ac.uk/page.asp?section=583§ionTitle=Cataract+National+Data+Set+for+Adults Laidlaw D a. H, Tailor V, Shah N, Atamian S, Harcourt C. Validation of a computerised logMAR visual acuity measurement system (COMPlog): comparison with ETDRS and the electronic ETDRS testing algorithm in adults and amblyopic children. Br J Ophthalmol [Internet]. 2008 Feb 1 [cited 2012 Sep 26];92(2):241–4. Available from: http://bjo.bmj.com/content/92/2/241 Chiang MF, Boland MV, Brewer A, Epley KD, Horton MB, Lim MC, et al. Special Requirements for Electronic Health Record Systems in Ophthalmology. Ophthalmology [Internet]. 2011 Aug [cited 2012 Sep 26];118(8):1681–7. Available from: http://www.aaojournal.org/article/S0161-6420(11)00374-5/abstract Chen DZ, Tham YC, Shen L, Chee SP. A Comparative Validation Study of Near Visual Acuity Assessment Using Different Handheld Acuity Charts. Ophthalmol Sci. 2025 Apr 8;5(5):100790. doi: 10.1016/j.xops.2025.100790. PMID: 40469897; PMCID: PMC12135357. |
| Copyright | © openEHR Foundation |
| Authors | Author name: Ian McNicoll Organisation: Ocean Informatics, UK Email: ian.mcnicoll@oceaninformatics.com Date originally authored: 2012-07-18 |
| Other Details Language | Author name: Ian McNicoll Organisation: Ocean Informatics, UK Email: ian.mcnicoll@oceaninformatics.com Date originally authored: 2012-07-18 |
| Other Details (Language Independent) |
|
| Keywords | eye, sight, vision, VA, ophthalmic, visual, Snellen, low contrast, defocus, pinhole, light perception, grating, BCVA, BRVA, EDTRS, logMAR, decimal, logRAD, reading |
| Lifecycle | in_development |
| UID | 93b051f7-c9a6-4728-92aa-13a3af7114d5 |
| Language used | en |
| Citeable Identifier | 1013.1.7723 |
| Revision Number | 0.0.1-alpha |
| state | |
| Visual aid per eye | Visual aid per eye: A cluster describing what type of visual aid was used during the test, and which eye it was positioned in front of. Where multiple devices are positioned in front of the same eye, this cluster is expected to be used once for each. |
| Aided eye | Aided eye: The eye in front of which the visual aid was positioned. For monocular tests where the partner eye is fully occluded, the assumption is that the visual aid is positioned in front of the eye being tested. In these circumstances autopopulation from the 'Eye examined' element is possible.
|
| Visual aid type | Visual aid type: Information specifying the type of device, or lack of a device positioned in front of one of the eyes.
Avoid using the generic value "Corrected" where the device or provenance of corrective values are known. Coding with a terminology is recommended. Free text entry should only be permitted if no appropriate coded value is available. Choice of:
|
| Cycloplegia during refraction | Cycloplegia during refraction: Information on whether the correction used was based on a measurement of the refractive error in a cycloplegic state.
|
| Power of sphere | Power of sphere: The refractive power that is equal in all meridians. Used as the base correction upon which cylinder and axis are applied. Property: Refractive power Units: dioptre |
| Power of cylinder | Power of cylinder: The refractive power added to the spherical correction at the meridian 90° from the cylinder axis to compensate for astigmatism. Property: Refractive power Units: dioptre |
| Axis of cylinder | Axis of cylinder: The orientation of the cylinder in degrees. By convention, the axis of the cylinder is defined by its meridian of zero power. Property: Angle, plane Units: ° |
| Near addition | Near addition: The additional spherical lens power for near vision. Property: Refractive power Units: dioptre |
| Visual aid details | Visual aid details: Structured details about the device used as a visual aid during testing, such as a phoropter, trial frame, glasses, or contact lenses. Include: openEHR-EHR-CLUSTER.device.v1 and specialisations |
| Comment | Comment: Narrative comment about the specific visual aid used. |
| Pupil state | Pupil state: Statement describing the condition of the individual's pupils during the test. The physical examination of the eye will be recorded using the CLUSTER.exam-eye family of archetypes. Coding with a terminology is recommended. Free text entry should only be permitted if no appropriate coded value is available. Choice of:
|
| Type of ancillary lighting used | Type of ancillary lighting used: Type of light sources used in addition to the typical room, stimulus or chart lighting. Coding with a terminology is recommended. Free text entry should only be permitted if no appropriate coded value is available.
|
| Ancillary lighting details | Ancillary lighting details: Details on the use of ancillary lighting sources, including brightness acuity testing and glare lights. Include: openEHR-EHR-CLUSTER.vision_ |
| Light adaptation state | Light adaptation state: The presumed adaptation state of the visual system during testing. This is a categorical description of the individual's presumed retinal adaptation state, not a measurement of the ambient lighting.
|
| Ambient illuminance | Ambient illuminance: The ambient illuminance in the room where the visual acuity testing is taking place. Property: Illuminance Units: lx |
| Background luminance | Background luminance: Background luminance of the visual stimulus, such as the white background on a chart. Candela per square meter is equivalent to the non-SI unit 'nit'. Units: cd/m2 |
| Confounding factors | Confounding factors: Description of any incidental factors related to the state of the subject which may affect clinical interpretation of the measurement. Examples: 'Patient was confused', "Lid held open by hand" "Eccentric Fixation". |
| protocol | |
| Extension | Extension: Additional information required to capture local content or to align with other reference models/formalisms. For example: local information requirements or additional metadata to align with FHIR or CIMI equivalents. Include: All not explicitly excluded archetypes |
| data | |
| Eye examined | Eye examined: The eye which was examined, or both eyes in case of a binocular test. 'Both eyes' may only be used for test of binocular visual acuity.
|
| Result | Result: A grouping of data elements to represent the primary notation of the visual acuity assessment result.
Typically, only one result should be populated. Converted or derived values should be stored in the appropriate element in the 'Derived result' cluster. |
| logMAR result | logMAR result: The visual acuity measured and expressed as the base-10 logarithm of the minimum angle of resolution (MAR). Do not use this element unless the visual acuity was initially recorded in LogMAR notation. Sometimes referred to as 'logRAD' in reading acuity tests. Units: 1{logMAR} |
| Metre ratio result | Metre ratio result: The visual acuity measured and expressed as a metre Snellen ratio or M-Scale ratio.
For Snellen ratios, a distance of 6 metres is typically used as the reference distance (numerator). For M-Scale notation, the numerator is equal to the real testing distance. To avoid ambiguity, populate the 'Testing distance' element if M-Scale notation is used, and generally whenever possible.
Denominator: >0.0..99999.0 |
| Feet ratio result | Feet ratio result: The visual acuity measured and expressed as a feet Snellen ratio.
A reference distance of 20 feet is often used as the default numerator, even when it is not the real testing distance. Use of the 'Testing distance' element is encouraged to avoid ambiguity.
Denominator: >0.0..99999.0 |
| Decimal notation result | Decimal notation result: The visual acuity measured and expressed as a decimal notation. Units: >0.0..999.0 1{decimal VA} Limit decimal places: 3 |
| ETDRS letter score | ETDRS letter score: The visual acuity measured and expressed as the ETDRS letter score. Caution: The 30 letters presumed readable at 1m distance are added to the results of testing at 4m distance. See ETDRS report number 7 in References. A letter score of 85 is equivalent to 20/20, 1.0 decimal, 0.0 logMAR. min: >=0; max: <=999 |
| 5-Score notation result | 5-Score notation result: The visual acuity measured and expressed using the 5 mark record method. Defined as 5 minus the LogMAR result, part of the Chinese national standard GB11533-1989. Units: 1{5PointVA} |
| N point font size notation result | N point font size notation result: The N point font size of the smallest recognized line or text. Strictly not a unit of visual acuity but a measure of stimulus size. 1.0: N 1 [N font size 1.] 1.5: N 1.5 [N font size 1.5.] 2.0: N 2 [N font size 2.] 2.5: N 2.5 [N font size 2.5.] 3.0: N 3 [N font size 3.] 3.5: N 3.5 [N font size 3.5.] 4.0: N 4 [N font size 4.] 4.5: N 4.5 [N font size 4.5.] 5.0: N 5 [N font size 5.] 5.5: N 5.5 [N font size 5.5.] 6.0: N 6 [N font size 6] 6.5: N 6.5 [N font size 6.5.] 7.0: N 7 [N font size 7.] 7.5: N 7.5 [N font size 7.5.] 8.0: N 8 [N font size 8.] 9.0: N 9 [N font size 9.] 10.0: N 10 [N font size 10.] 11.0: N 11 [N font size 11.] 12.0: N 12 [N font size 12.] 13.0: N 13 [N font size 13.] 14.0: N 14 [N font size 14.] 15.0: N 15 [N font size 15.] 16.0: N 16 [N font size 16.] 18.0: N 18 [N font size 18.] 20.0: N 20 [N font size 20.] 22.0: N 22 [N font size 22.] 24.0: N 24 [N font size 24.] 26.0: N 26 [N font size 26.] 28.0: N 28 [N font size 28.] 30.0: N 30 [N font size 30.] 32.0: N 32 [N font size 32.] 36.0: N 36 [N font size 36.] 40.0: N 40 [N font size 40.] 42.0: N 42 [N font size 42.] 44.0: N 44 [N font size 44.] 48.0: N 48 [N font size 48.] 54.0: N 54 [N font size 54.] 56.0: N 56 [N font size 56.] 60.0: N 60 [N font size 60.] 66.0: N 66 [N font size 66.] 72.0: N 72 [N font size 72.] |
| Jaeger font size notation result | Jaeger font size notation result: The Jaeger font size of the smallest recognized line of text. Strictly not a unit of visual acuity but a measure of stimulus size. 1.0: J1 [Jaeger font size 1.] 2.0: J2 [Jaeger font size 2.] 3.0: J3 [Jaeger font size 3.] 4.0: J4 [Jaeger font size 4.] 5.0: J5 [Jaeger font size 5.] 6.0: J6 [Jaeger font size 6.] 7.0: J7 [Jaeger font size 7.] 8.0: J8 [Jaeger font size 8.] 9.0: J9 [Jaeger font size 9.] 10.0: J10 [Jaeger font size 10.] 11.0: J11 [Jaeger font size 11.] 12.0: J12 [Jaeger font size 12.] 13.0: J13 [Jaeger font size 13.] 14.0: J14 [Jaeger font size 14.] 15.0: J15 [Jaeger font size 15.] 16.0: J16 [Jaeger font size 16.] 17.0: J17 [Jaeger font size 17.] 18.0: J18 [Jaeger font size 18.] 19.0: J19 [Jaeger font size 19.] 20.0: J20 [Jaeger font size 20.] |
| Cycles per centimetre result | Cycles per centimetre result: The number of cycles (line pairs) per centimetre of the finest grating pattern recognized by the individual. Strictly not a unit of visual acuity but a measure of stimulus size. Units: >0.0..9999.0 1/cm |
| Cycles per degree result | Cycles per degree result: The visual acuity measured and expressed as the number of pairs of black and white lines (cycles) that subtend an angle of one degree at the tested eye. Used in grating based tests such as Teller acuity cards. Units: >0.0..9999.0 1/deg |
| Best qualitative result | Best qualitative result: The highest level of visual function demonstrated by the individual during qualitative assessment. Not to be used for light projection testing. Use OBSERVATION.light_projection_test archetype for this purpose. Higher ordinal values represent better visual function. 1: No light perception [The individual was unable to identify the absence or presence of light.] 2: Light perception [The individual correctly identified the absence or presence of light.] 3: Hand Movement [The individual perceived hand movements.] 4: Count Fingers [The individual correctly counted fingers.] |
| Missed or additional optotypes | Missed or additional optotypes: Information on single optotypes where the main score was based on the whole line.
Positive: Number of correct letters in largest line that was not scored.
Negative: Number of letters missed in smallest scored line.
"Partial" code refers to the concept of "partially" read line.
Choice of:
|
| Derived result | Derived result: A grouping of calculated or estimated visual acuity result values derived by conversion from the primary recorded result. |
| Derived logMAR result | Derived logMAR result: Visual acuity in logMAR notation, derived by conversion from the primary recording. |
| Derived meter ratio result | Derived meter ratio result: Visual acuity in metre ratio (Snellen or M-Score) notation, derived by conversion from the primary recording.
|
| Derived feet ratio result | Derived feet ratio result: Visual acuity in feet (Snellen) ratio notation, derived by conversion from the primary recording.
|
| Derived decimal notation result | Derived decimal notation result: Visual acuity in decimal notation, derived by conversion from the primary recording. |
| Derived ETDRS letter score result | Derived ETDRS letter score result: Visual acuity as ETDRS notation, derived by conversion from the primary recording. Typically in study settings, this score describes either the number of optotypes identified (letters read): 1. Out of 30 at 1m distance. Or 2. Out of 70 at 4m distance. In which case the 30 letters from the 1m distance are added to the result as they are presumed readable. Typically, an ETDRS letter score of 85 is equivalent to 20/20, 1.0 decimal, 0.0 logMAR. Conversion of this notation requires precise understanding of testing procedures and intended meaning. |
| Derived cycles per degree | Derived cycles per degree: Visual acuity as cycles per degree, derived by conversion from the primary recording. Property: null Units: arb. unit |
| Supplementary results | Supplementary results: Additional structured details on visual acuity test result not captured in other data elements. Examples include specifying the card scored in a Cardiff acuity test, or supplementary results on reading visual acuity tests. Include: openEHR-EHR-CLUSTER.cardiff_ openEHR-EHR-CLUSTER.reading_ |
| Testing distance category | Testing distance category: A categorisation of the testing distance. Boundary definitions may vary, therefore population of the 'Testing distance' is encouraged, especially for Intermediate or near distances.
|
| Testing distance | Testing distance: The distance between the tested eye and the apparent location of the stimulus. The stimulus may be a virtual image. Property: Length Units:
|
| Perceptual task | Perceptual task: The type of perceptual task endpoint that the result represents. Reading visual acuity expressed LogMAR is sometimes referred to as LogRAD. Supplementary results of reading Visual acuity tests can be recorded via the 'supplementary results' slot.
|
| Stimulus method | Stimulus method: Information on the way the visual stimulus is displayed. Allows for the capture of basic information where additional detail about the type or device name of the stimulus are unknown.
|
| Chart or card type | Chart or card type: The type of chart or card used to measure visual acuity. Coding with a terminology is recommended. Free text entry should only be permitted if no appropriate coded value is available. Choice of:
|
| Chart or stimulus device details | Chart or stimulus device details: Details of the devices used provide a stimulus to be resolved by the eye being tested, such as a chart, projector or digital display. Include: openEHR-EHR-CLUSTER.device.v1 and specialisations |
| Optotype | Optotype: The type of symbol used to assess visual acuity. Coding with a terminology is recommended. Free text entry should only be permitted if no appropriate coded value is available.
|
| Crowdedness | Crowdedness: A categorical statement on whether a crowding effect is expected to be induced by the visual stimulus. Additional detail on the degree of crowding, and presence of crowding bars can be recorded using the 'Optotype presentation details' SLOT.
|
| Optotype presentation details | Optotype presentation details: Details on how the optotypes were presented, including statements on crowding. Include: openEHR-EHR-CLUSTER.optotype_ |
| Contrast category | Contrast category: A statement on the contrast level of the test. Note that the majority of visual acuity tests are performed under high contrast conditions. Where possible, population of quantitative elements on contrast is encouraged.
|
| Contrast | Contrast: Structured detail on the contrast of the visual stimulus used during testing. |
| Weber contrast | Weber contrast: The difference between stimulus and background luminance divided by background luminance. |
| Michelson contrast | Michelson contrast: The difference between maximum and minimum luminance of the stimulus divided by their sum. |
| RMS contrast | RMS contrast: The standard deviation of the pixel intensity values of the stimulus. |
| No improvement note | No improvement note: A note indicating that the addition or use of another type of aid did not result in a better test result. Used where a determination of the exact visual acuity with the additional correction (in another event) was not performed, typically because it was deemed irrelevant for lack of improvement. Coding with a terminology is recommended. Free text entry should only be permitted if no appropriate coded value is available. Choice of:
|
| Comment | Comment: Narrative comment about the visual acuity test. It is a common but controversial practice to comment "partial" where the last line was not read entirely even in line-based scoring. This is covered by the "Letters missed or read in addition to scored line" element. |
| Interpretation | Interpretation: Interpretation of the results. Not to be used for information about how the test was performed or patient circumstances affecting result. |
| Comparative label | Comparative label: Classification of the test and its result as 'best corrected', 'best recorded' visual acuity, or similar statements. These classifiers do not contain information on the actual correction used and they are used with significant variability in different settings. It is encouraged to record the specific aids used within 'Visual aid per eye' clusters. Choice of:
|
| Test not done | Test not done: Details to explicitly record that this test was not performed. Include: openEHR-EHR-CLUSTER.exclusion_ |
| events | |
| Any event | Any event: Default, unspecified point in time or interval event which may be explicitly defined in a template or at run-time. |
| Other contributors | Silje Ljosland Bakke, Norway Severin Kohler, Germany Lars Fuhrmann, Germany (Editor) Bill Aylward, openEyes Project, UK Gustavo Bacelar-Silva, Brazil (Editor) Stephen Chu, NeHTA, Australia Alistair Laidlaw, Guys and St Thomas NHS Trust, UK Heather Leslie, Ocean Informatics, Australia Gustavo M Bacelar-Silva, Brazil Mike Mair, Timaru Eye Clinic, New Zealand Ian McNicoll, Ocean Informatics, United Kingdom (Editor) |
| Translators |
|