optovist interface description

1

Optovist Interface description

As on: 15.05.2013 from version 2.0.009 Vistec AG Vision Technologies Werner-von-Siemens-Str. 13 82140 Olching Tel. 08142/44857-60 Fax 08142/44857-70 Email: [email protected] www.vistec-ag.de

2

Table of Contents

1 Information................................................................................................................................................................3 1.1 Optovist Standard – Findings..............................................................................................................................3 1.2 Start from Optovist with – Call-up parameters....................................................................................................3

2 GDT-Interface ...........................................................................................................................................................4 2.1 Exchange of data with external EDP ..................................................................................................................4

2.1.1 Interface settings........................................................................................................................................4 2.2 Application - Possibilities ....................................................................................................................................4 2.3 Data transfer .......................................................................................................................................................5

2.3.1 File – naming convention ...........................................................................................................................5 2.3.2 File - extension...........................................................................................................................................5 2.3.3 Directory structure......................................................................................................................................5 2.3.4 EDP – MG (Request file)............................................................................................................................6 2.3.5 MG - EDP (Result file)................................................................................................................................6 2.3.6 Detail significance ......................................................................................................................................8 2.3.7 Structure of test types ................................................................................................................................9 2.3.8 Commented example (with blanks for better readability) :.......................................................................15 2.3.9 Result – Export.........................................................................................................................................23 2.3.10 Data transfer – Procedure........................................................................................................................23 2.3.11 Display Test ..............................................................................................................................................23

2.4 GDT Record types Specification.......................................................................................................................24 2.4.1 Supported record types............................................................................................................................24 2.4.2 Import by EDP..........................................................................................................................................24 2.4.3 Export to EDP ..........................................................................................................................................25 2.4.4 PDF/XML..................................................................................................................................................25

3 XML-Interface .........................................................................................................................................................26 3.1 General Structure..............................................................................................................................................26 3.2 Structure of Individual Test Types .....................................................................................................................28

3.2.1 Visual Acuity Test .....................................................................................................................................28 3.2.2 Phoria test ................................................................................................................................................28 3.2.3 Stereo test ................................................................................................................................................29 3.2.4 Color test (Device) ...................................................................................................................................29 3.2.5 Accommodation test.................................................................................................................................30 3.2.6 Contrast test.............................................................................................................................................31 3.2.7 Glare test ...................................................................................................................................................32 3.2.8 Visual field ................................................................................................................................................33 3.2.9 Hyperopia test ..........................................................................................................................................34 3.2.10 Amsler Documentation.............................................................................................................................35 3.2.11 Color test Ishihara Book (Documentation) ...............................................................................................35 3.2.12 Color test Velhagen Book (Documentation).............................................................................................35

4 Data base ...............................................................................................................................................................36 4.1 Database Structure ...........................................................................................................................................36

5 CSV-Interface .........................................................................................................................................................37 5.1 Export of subjects .............................................................................................................................................37 5.2 Import of subjects..............................................................................................................................................37

3

1 Information

Optovist controls following interfaces:

• GDT-Interface, optional with PDF and/or XML-Data

• XML-Interface to import/export the findings

• CSV-Interface to import/export the tests

• SQLite-Database

1.1 Optovist Standard – Findings

Following types of screening are to be installed by default on delivery.

• G37 Landoltring

• G37 Letters

• G37 Numbers

• G25 Landoltring

• G25 Letters

• G25 Numbers

• FeV Group 1

• FeV Group 2

• Contrast- and glare

• Pilots

• Accommodation

• EM 1

• EN 473

• Visual field

• Hyperopia

1.2 Start from Optovist with – Call-up parameters

While starting the Optovist software, an XML or GDT-file can be transferred with or without path details. If a file, which is to be imported is given without a path then this will be searched in a standard folder.

Standard directories: (freely definable):

• GDT: Optovist-Install-folder\gdt

• XML: Optovist-Install-folder\examinations

Example-GDT:

• With path details:

• “Optovist.exe C:\GDT\EDVOPT.gdt"

• Without path details:

• "Optovist.exe EDVOPT.gdt"

Example-XML:

• With path details:

• “Optovist.exe C:\Exam\Testexam.vax"

• Without path details:

• "Optovist.exe Testexam.vax"

4

2 GDT-Interface

2.1 Exchange of data with external EDP

Exchange of data is based on the GDT-Interface of "Quality ring Medical Software" (QMS).

2.1.1 Interface settings

GDT Version 2.10

Device – ID Opto00 (optional Opto00 – Opto09)

Naming convention from EDP to MG OPTEDV

Naming convention from MG to EDP EDVOPT

File extension .gdt (optional .001 - .999)

Additional export PDF, XML - Datei

Standard GDT-Transfer-directory "C:\Program Files\VISTEC\Optovist\GDT".

Table 1: GDT – Interface settings

2.2 Application - Possibilities

As an indication, Optovist "always" saves all results redundantly in its own database, regardless of which of the following options will be used.

EDV – To store the findings:

• It reads the test results directly from the GDT-file and displays it on screen

• It imports the test results as PDF-file and displays it when necessary

• It imports the test results as XML-file and returns this XML-file to the Optovist when required. Optovist loads all the results exclusively from this XML-file.

◦ Options to return the XML-file

▪ The XML-file can be transferred in the GDT-file, see Chapter 2.4.2

▪ The XML-file can be transferred as per parameter call-up, see Chapter 1.2

▪ The XML-file can be started by double clicking directly from windows with Optovist. For this purpose, the XML-extension (.vax) must be linked in windows with the Optovist program.

• It imports test results as GDT-file, i.e. saves the complete GDT-file similar PDF and XML and returns this GDT-file to Optovist when required. Optovist loads all the results exclusively from this GDT-file.

◦ The GDT-file can be transferred as per parameter call-up, see Chapter 1.2

◦ The GDT-file can be started by double clicking directly from windows with Optovist. For this purpose, the GDT-extension (.gdt) must be linked in windows with the Optovist program.

• The test results are not imported. Only subject and date, and also optional additional time of results are returned. A GDT-file with subject and date and also optional additional time of results can be returned. On the basis of this data, Optovist automatically loads the results from its own database.

5

2.3 Data transfer

The data is transferred from the freely definable folder, in which the GDT-files are exported and imported.

2.3.1 File – naming convention

The data of patients is transferred from/to EDP from 2 files, whose naming convention can be set arbitrary in the Optovist configuration. The standard values are to be taken from the table 1.

• <Receiver-Code><Sender-Code> . GDT

or

• <Receiver-Code><Sender-Code> . <increasing No> (e.g. *.005)

2.3.2 File - extension

The extension of the generated GDT-files is ".gdt" by default. If an already existing file of the same name is located in the GDT-folder, then this file will be deleted and replaced with a new one. In order to store various tests serially in the GDT-folder, Optovist can be configured in such a way that the file name extension for "transferring results of data" can be with increasing numbers (*.001 to *.999)

2.3.3 Directory structure

The GDT-files should be stored in the freely definable transfer-directories. The standard directory can be taken from table 1. The transfer-path for import and export can be separately changed in the Optovist-system configuration. Therefore the UNC-addresses can also be provided.

6

2.3.4 EDP – MG (Request file)

Commented example (with spaces for better readability) :

013 8000 6302 Record type: Request new tests

014 8100 00159 Record length

014 9218 02.10 GDT-Version

015 8402 OPTO00 Device and process-specific diagram

009 3000 1234 Patients-No / -identification

019 3101 Maier Name

015 3102 Monika First name

017 3103 01061997 Date of birth DDMMYYYY

022 3106 82140 Olching Place

024 3107 Max Otto Str. 7 Street

010 3110 2 Sex (1 = male, 2 = female)

013 8410 G37 Landolt‘s ring Test designation

012 8411 G37 Landolt‘s ring optional test designation

The test designation indicates the tests that are to be carried out. The type of tests is taken from Chapter 1.1 Optovist Standard – Findings.

2.3.5 MG - EDP (Result file)

Test results:

A test consists of a single test steps (visual acuity test, color test....). In a test step more eyes can be tested (e.g. visual acuity). A single test step should be stored in GDT as a test block successively for every eye. Every test detail is to be saved separately with its own test-ID. The first two letters of the test-ID indicate the type of test, then one letter is for the eye, and the last two letters indicate the measurement.

e.g. : CVRDS : CV = Color test; R = Right; DS = Distance

Creating a test block

014 8410 VFRDS - Type of test, eye, distance (Example: Long distance vision, right eye, distance)

010 8420 6 - Distance value in meter (Example: 6m)

014 8410 VFRGL - Type of test, eye, vision aid (Example: Long distance vision, right eye, vision aid)

013 8420 0 - see Chapter 2.3.6 Vision aid (Example: no vision aid)

014 8410 VFRVA - Type of test, eye, result value (Example: Long distance vision, right eye, vision)

011 8420 0.80 - recognized vision (Example: Vision 0.80)

010 8438 1 - Index of test steps (Example: 1 = first test within the examination)

014 8410 VFRRS - Type of test, eye, result (Example: Long distance vision, right eye, result)

011 8420 1 - see Chapter 2.3.6 Result (Example: recognized)

010 8438 0 - see Chapter 2.3.6 Data stream(Example: no data stored)

7

Type of test

VN = Visual acuity at a near distance

VM = Visual acuity at middle distance

VF = Visual acuity at far distance

VA = Visual acuity in all areas

CV = Color test (device)

CL = Manual color test with Velhagen board

CH = Manual color test with Ishihara board

PR = Field of vision

ST = Stereo test

PH = Phoria test

HY = Hyperopia

CT = Contrast (with "LT = 0”) / Glare (with "LT = 1”)

AK = Accommodation test

AM = Manual Amsler test

NT = Night visual acuity test

TW = Twilight test

SE = Long Stereo test 1 Manual

(without Device, with board)

SZ = Long Stereo test 2 Manual


SO = TNO Stereo test Manual


RT = Recoverytest (Erholung nach Blendung)

AT = Astigmatismustest

DC = Duochromtest

FT = Fusionstest

DO = DOG-Test

PL = Phoria horizontal letters test

PN = Phoria vertical numbers test

Eye mode

R = Right eye

L = Left eye

B = Both sides / Binocular

Additional information

DS = Distance

CT = Contrast value

LT = Lighting (blend lamps)

GL = Glasses (vision aid)

VA = Value (result value), data stream contains details of current type of test

RS = Result, data stream contains details

Manual tests (e.g. color - or Amsler test) are recorded only as a supplement to vision test. They can be scanned and saved directly from EDP software, if they are present on the screens.

Test-ID (8410), result value (8420) and data stream (8438) form a group of related data and repeat for different tests.

Depending on the type of test only important information is transferred: e.g. if the contrast and glare is missing with normal vision test, then the result value would be verified only with vision and stereo test.

8

2.3.6 Detail significance

Distance (*DS)

Field 8420

Unit: Meter

Area: 0.33 – 20 Meter

"U" = infinitely

Visual aid (*GL) :

Field 8420

0 = No visual aid

1 = with reading glasses

2 = with bifocal glasses

3 = with trifocal glasses

4 = with Progressive glasses

5 = with BAP-glasses

6 = with contact lenses

7 = with distance glasses

Note: User can activate the "user-defined input" for the visual aid and freely define the visual aid. Then an ID-number will not be given here, but a clear text of name.

Identified visual acuity (*VA)

Field 8420

0.00 = no visual acuity is used

-1 = no visual acuity is identified

0.1 - 1,6 = identified visual acuity

Result (*RS):

Field 8420

-1 = incomplete

0 = irregular / not identified / noticeable

1 = regular / identified

2 = doubtful / partially complied

Field 8438

Details: Specific type of test, see Chapter 2.3.7 type of test structure

Contrast value (*CT):

Field 8420

Contrast value of the images in percent 0-100%

Blend lamps (*LT):

Field 8420

0 = Lighting source off (Glare)

1 = Lighting source on (Glare)

9

2.3.7 Structure of test types

Visual acuity- Visual acuity test

014 8410 VNLDS Short-range vision left eye distance

010 8420 0.33 Distance, see Chapter 2.3.6 Detail (*DS)

014 8410 VNLGL Visual aid

013 8420 0 Visual aid, see Chapter 2.3.6 Detail (*GL)

014 8410 VNLVA identified visual acuity value

011 8420 0.7 Visual acuity, see Chapter 2.3.6 Detail (*VA)

010 8438 1 Index of test steps within examinations

014 8410 VNLRS Results

011 8420 -1 1 = identified, 0 = unidentified, -1 = incomplete

010 8438 0 Details are not to be used, always "0"

Stereo test

014 8410 STBDS Stereo binocular distance


014 8410 STBGL Visual aid


014 8410 STBVA Visual acuity value

013 8420 0.00 not used, 2.3.6 Detail (*VA)


014 8410 STBRS Results

011 8420 1 1 = Regular, 0 = irregular, -1 = incomplete

011 8438 96 Value: -1 = no value identified

Value: between 0 – 800 identified angular seconds

Color test (Device)

014 8410 CVBDS Color test binocular distance


014 8410 CVBGL Visual aid


014 8410 CVBVA Visual acuity value


010 8438 5 Index of test steps within the examinations

014 8410 CVBRS Result

011 8420 -1 1 = regular, 0 = irregular, -1 = incomplete


10

Hyperopia

014 8410 HYRDS Hyperopia right eye distance

010 8420 U Distance, see Chapter 2.3.6 Detail (*DS)

014 8410 HYRGL Visual aid


014 8410 HYRVA Visual acuity value



014 8410 HYRRS Result

010 8420 0 1 = regular, 0 = irregular, -1 = incomplete / no evaluation

020 8438 1,0,1 Sequence: 0.5dpt, 1dpt, 1.5dpt

Value: -1 = no measurement / incomplete

Value: 0 = bad

Value: 1 = better / same

Example: 1, 0, 1

0.5dpt = better / same

1dpt = bad

1.5dpt = better / same

Contrast test

014 8410 CTRDS Contrast right eye distance


014 8410 CTRGL Visual aid


014 8410 CTRVA used visual acuity value



014 8410 CTRRS Result

010 8420 0 1 = regular, 0 = irregular, -1 = incomplete


014 8410 CTRCT Contrast in percent

013 8420 80.0 Contrast value (Example: 80%), see Chapter 2.3.6 Detail (*CT)

014 8410 CTRLT Glare

010 8420 0 Source of glare always = 0, see Chapter 2.3.6 Detail (*LT)

11

Glare test (Contrast test with glare)

014 8410 CTRDS Contrast right eye distance


014 8410 CTRGL Visual aid


014 8410 CTRVA used visual acuity value



014 8410 CTRRS Result



014 8410 CTRCT Contrast in percent

013 84208 0.0 Contrast value (Example: 80%), see Chapter 2.3.6 Detail (*CT)

014 8410 CTRLT Glare


Twilight test

014 8410 TWRDS Twilight test right eye distance


014 8410 TWRGL Visual aid


014 8410 TWRVA used visual acuity value



014 8410 TWRRS Result Contrast

010 8420 0 1 = identified, 0 = unidentified, -1 = incomplete


014 8410 TWRCT Contrast

013 8420 1 : 2,71 Contrast value

014 8410 TWRLT Glare


12

Twilight test with glare

014 8410 TWRDS Twilight test right eye distance


014 8410 TWRGL Visual aid


014 8410 TWRVA used visual acuity value



014 8410 TWRRS Result Contrast

010 8420 0 1 = identified, 0 = unidentified, -1 = incomplete


014 8410 TWRCT Contrast

013 8420 1 : 2,71 Contrast value

014 8410 TWRLT Glare


Night visual acuity test

014 8410 NTRDS Night test right eye distance


014 8410 NTRGL Visual aid


014 8410 NTRVA used visual acuity value



014 8410 NTRRS Result



13

Phoria test

014 8410 PHBDS Phoria binocular distance


014 8410 PHBGL Visual aid


014 8410 PHBVA Visual acuity value



014 8410 PHBRS Result

011 8420 -1 1 = regular, 0 = irregular, -1 = incomplete

011 8438- 0,0,1,0,1 Order: orthophoria, hypophoria, hyperphoria, esophoria, exophoria

Value: 0 = unidentified, 1 = identified

Example: 0, 0,1,0,1 = Hyperphoria and exophoria identified

Significance: regular = Orthophoria

irregular = hyperphoria, hypophoria, esophoria, exophoria

Accommodation test

014 8410 AKRDS Accommodation right eye distance


014 8410 AKRGL Visual aid


014 8410 AKRVA Visual acuity value



014 8410 AKRRS Result

010 8420 1 1 = regular, 0 = Suspicion of retinal damage, -1 = incomplete

027 8438 0.7,1.5,0.4,2.5

Order: Maximum acco., free sight distance, use acco., free sight distance

Value: -1 = no measurement taken

Value: 0 – 20 Dioptres or meter indications, depending on the position

Units:

Max. acco. = 0 - 20 Dioptres (dpt)

Free distance = 0 - 20 Meter (m)

Use acco. = 0 - 20 Dioptres (dpt)

Free distance = 0 - 20 Meter (m)

Example: 0.7,1.5,0.4,2.5

Max. acco. = 0.7 dpt

Free distance = 1.5 m

Use acco. = 0.4 dpt

Free distance = 2.5 m

14

Note:

If the accommodation test was done then all the values are used and if the test is not done then the information is always missing (-1,-1,-1,-1), it does not seem that only the partial value within the accommodation test is present.

Perimetry test

014 8410 PRBDS Perimetry binocular distance

010 8420 6 Distance, see Chapter 2.3.6 Detail (*DS)

014 8410 PRBGL Visual aid


014 8410 PRBVA Visual acuity value



014 8410 PRBRS Result



Amsler test (without device, with chart)

014 8410 AMRDS Amsler right eye distance


014 8410 AMRGL Visual aid


014 8410 AMRVA Visual acuity value



014 8410 AMRRS Result

011 8420 -1 1 = regular, 0 = Suspicion of retinal damage, -1 = incomplete

023 8438 1,0,1 Order: Question-1, Question-2, Question-3

Value: 0 = No, 1 = Yes

Question-1: Is the white point identified in the middle of the square?

Question-2: Is the grid square completely visible?

Question-3: Are all lines in the grid square parallel?

15

Ishihara test (without device, with chart)

014 8410 CHRDS Ishihara right eye distance


014 8410 CHRGL Visual aid


014 8410 CHRVA Visual acuity value



014 8410 CHRRS Result



Velhagen test (without device, with chart)

014 8410 CLRDS Velhagen right eye distance


014 8410 CLRGL Visual aid


014 8410 CLRVA Visual acuity value



014 8410 CLRRS Result



Long Stereo test 1 Manual (without Device, with chart)

014 8410 SEBDS Long Stereo test 1 binocular distance


014 8410 SEBGL Visual aid


014 8410 SEBVA Visual acuity value



014 8410 SEBRS Result


023 8438 1,0,1 identified angular seconds: Pos-1, Pos-2, Pos-3

Value: 1 = identified, 0 = unidentified, -1 = incomplete

Pos-1: 550 angular seconds



16

Long Stereo test 2 Manual (without Device, with chart)

014 8410 SZBDS Long Stereo test 2 binocular distance


014 8410 SZBGL Visual aid


014 8410 SZBVA Visual acuity value



014 8410 SZBRS Result


023 8438 1,0,1 identified angular seconds: Pos-1, Pos-2, Pos-3





TNO Stereo test Manual (without Device, with chart)

014 8410 SOBDS TNO Stereo test binocular distance


014 8410 SOBGL Visual aid


014 8410 SOBVA Visual acuity value



014 8410 SOBRS Result


023 8438 0,0,0,0,1,30 results: Pos-1, 2, 3, 4, 5


results: Pos-6: (identified angular seconds)

Value: 0 - 480

Pos-1: Chart 1 – All butterflies identified

Pos-2: Chart 2 – Largest circle identified

Pos-3: Chart 3 – All 4 symbols identified

Pos-4: Chart 4 – All 3 circles identified

Pos-5: Larger circle is right (if not identified (0) == left)

Pos-6: identified angular seconds (30, 60, 120, 240, 480)

17

Recoverytest

014 8410 RTBDS Recoverytest binocular distance


014 8410 RTBGL Visual aid


014 8410 RTBVA Visual acuity value



014 8410 RTBRS Result


023 8438 15 Value: -1 = unidentified

Value between: 0 – 8000 = time in seconds

Astigmatismtest

014 8410 ATBDS Astigmatismtest binocular distance


014 8410 ATBGL Visual aid


014 8410 ATBVA Visual acuity value



014 8410 ATBRS Result


023 8438 6 Value: -1 = unidentified

Value between: 0 – 7 = position of line, that is thicker

1-3 = right site, 4 = middle, 5-7 = left site

Duochromtest

014 8410 DCBDS Duochromtest binocular distance


014 8410 DCBGL Visual aid


014 8410 DCBVA Visual acuity value



014 8410 DCBRS Result



18

Fusionstest

014 8410 FTBDS Fusionstest binocular distance


014 8410 FTBGL Visual aid


014 8410 FTBVA Visual acuity value



014 8410 FTBRS Result



DOG-Test

014 8410 DOBDS DOG-Test binocular distance


014 8410 DOBGL Visual aid


014 8410 DOBVA Visual acuity value



014 8410 DOBRS Result



Phoria horizontal letters test

014 8410 PLBDS Phoria horizontal letters test binocular distance


014 8410 PLBGL Visual aid


014 8410 PLBVA Visual acuity value



014 8410 PLBRS Result



19

Phoria vertical numbers test

014 8410 PNBDS Phoria vertical numbers test binocular distance


014 8410 PNBGL Visual aid


014 8410 PNBVA Visual acuity value



014 8410 PNBRS Result



20

2.3.8 Commented example (with blanks for better readability) :

013 8000 6310 Record type: Transfer data of a test

014 8100 01729 Record length

014 9218 02.10 Version GDT

010 9206 3 used font 3 = ISO8859-1(ANSI) CP 1252

015 8402 OPTO00 Device map

014 3000 12345 Patient number

014 8410 VFRDS Visual acuity – right eye - far Distance

014 8420 6 6.00m

014 8410 VFRGL Visual aid

013 8420 0

014 8410 VFRVA Level of visual acuity

013 8420 0.50

010 8417 1

014 8410 VFRRS Result

010 8420 0

018 8417 0 Details

014 8410 VFLDS Visual acuity – left eye - far Distance

014 8420 99.00

014 8410 VFLGL Visual aid

013 8420 0

014 8410 VFLVA Level of visual acuity

013 8420 0.63

010 8417 1

014 8410 VFLRS Result

010 8420 0

019 8417 0 Details

014 8410 VFBDS Visual acuity – Binocular - far Distance

014 8420 99.00

014 8410 VFBGL Visual aid

013 8420 0

014 8410 VFBVA Level of visual acuity

013 8420 0.80

010 8417 1

014 8410 VFBRS Result

010 8420 1

019 8417 0 Details

21

014 8410 VMRDS Visual acuity – right eye - middle Distance

013 8420 0.55

014 8410 VMRGL visual aid

013 8420 0

014 8410 VMRVA Level of visual acuity

013 8420 1.00

010 8417 2

014 8410 VMRRS Result

010 8420 1

018 8417 0 Details

014 8410 VMLDS Visual acuity – left eye - middle Distance

013 8420 0.55

014 8410 VMLGL Visual aid

013 8420 0

014 8410 VMLVA Level of visual acuity

013 8420 1.25

010 8417 2

014 8410 VMLRS Result

010 8420 1

019 8417 0 Details

014 8410 VMBDS Visual acuity – Binocular - middle Distance

013 8420 0.55

014 8410 VMBGL Visual aid

013 8420 0

014 8410 VMBVA Level of visual acuity

013 8420 0.50

010 8417 2

014 8410 VMBRS Result

010 8420 0

019 8417 0 Details

014 8410 PHBDS Phorie Binocular Distance

013 8420 0.55

014 8410 PHBGL Visual aid

013 8420 0

014 8410 PHBVA Level of visual acuity

013 8420 0.00

010 8417 3

014 8410 PHBRS Result

010 8420 1

010 8417 1,0,0,0 Details

22

014 8410 STBDS Stereo Binocular Distance

013 8420 0.55

014 8410 STBGL Visual aid

013 8420 0

014 8410 STBVA Level of visual acuity

013 8420 0.00

010 8417 4

014 8410 STBRS Result

010 8420 1

020 8417 40 Details

014 8410 CVBDS Color test Binocular Distance

013 8420 0.55

014 8410 CVBGL Visual aid

013 8420 0

014 8410 CVBVA Level of visual acuity

013 8420 0.00

018 8417 5

014 8410 CVBRS Result

010 8420 1

016 8417 0 Details

014 8410 VNRDS Visual acuity – right eye - near Distance

013 8420 0.33

014 8410 VNRGL Visual aid

013 8420 0

014 8410 VNRVA Level of visual acuity

013 8420 0.63

010 8417 6

014 8410 VNRRS Result

010 8420 0

018 8417 0 Details

014 8410 VNLDS Visual acuity – left eye - near Distance

013 8420 0.33

014 8410 VNLGL Visual aid

013 8420 0

014 8410 VNLVA Level of visual acuity

013 8420 0.80

010 8417 6

014 8410 VNLRS Result

010 8420 1

019 8417 0 Details

23

014 8410 VNBDS Visual acuity – Binocular - near Distance

013 8420 0.33

014 8410 VNBGL Visual aid

013 8420 0

014 8410 VNBVA Level of visual acuity

013 8420 1.00

010 8417 6

014 8410 VNBRS Result

010 8420 1

019 8417 0 Details

2.3.9 Result – Export

Optovist can be configured that while exporting a PDF-document and/or a XML-file, which contain the test results, the GDT-test results are also exported along with it.

2.3.10 Data transfer – Procedure

The Import file OPTEDV.gdt is generated by the EDP before starting the optovist-program (record type “request New Test“). It contains the data of study participant (at least name and surname) and the test to be carried out (e.g. G37 Landoltrings).

While starting the Optovist, this data of study participant is read from the Gdt file in Optovist and transferred to the Optovist-database, the GDT-file is deleted by Optovist after reading.

The export file EDVOPT.gdt is directly generated by Optovist while saving the test (record type “Transfer data of test”). It contains the data of study participant, the date and time of test. If set in Optovist, additionally a PDF and/or XML-file is generated with the test results.

2.3.11 Display Test

Already carried out test can be resent to Optovist, there it is loaded again and displayed: OPTEDV.gdt is generated by EDP before starting the Optovist-program (Record type “Display data of test.”). It contains the data of study participant, the date and time of test carried out.

Only study participant-data

• If only the study participant and no time of test should be transferred, Optovist opens a window for selection, with all tests of study participant transferred.

Study participant-data and date

• If the study participant and the date should be transferred, but no time, Optovist opens a window for selection, with all tests of study participant on the date of transfer.

24

2.4 GDT Record types Specification

2.4.1 Supported record types

• Request master data “6300" - (is not supported by Optovist)

• Transfer master data "6301" - Import

• Request new test "6302" - Import

• Transfer data of test "6310" - Export and Import (requires XML-file)

• Display data of test "6311" - Import

2.4.2 Import from EDP

Following record types, with information associated to them, can be read. Thereby the sequence of information in the GDT-file does not play any role.

Mandatory data:

• GDT-Version: 2.1

• Devices-known value: OPTO00 (optionally also OPTO00 – 09)

• While doing GDT-import for capturing data of study participant at least name and surname must be stated.

6301 – Transfer master data

• 9218 - Version GDT

• 8402 - Devices characteristic diagram

• 3000 - Patient No. / ID

• 3101 - Surname

• 3102 - First name

• 3103 - Date of birth

• 3106 - Place of residence

• 3111 - Place of birth

• 3107 - Street

• 3110 - Gender

6302 – Request new test




• 3101 - Surname





• 3107 - Street

• 3110 - Gender

• 8990 - Examiner

• 8410 - Test-type

• 8411 - optional test-type

6310 – Transfer data of test



• 8411 - additional known value (Optovist)


• 6303 - File format

• 6305 - File reference

◦ optional Test results

6311 – Display test




• 3101 - Surname





• 3107 - Street

• 3110 - Gender

• 8990 - Examiner

• 6200 - Test-Date

• 6201 - Test-Time

• 8432 - optional Test-Date

• 8439 - optional Test-time

25

2.4.3 Export to EDP

6310


• 9206 - Character set (ISO 8859-1)


• 8411 - additional characteristic diagram (Optovist)

• 3000 - Patient No / characteristic diagram

• 3101 - Surname




• 3107 - Street

• 3110 - Gender

• 8990 - Examiner

• 8470 - Note





• 8410 - Test-Ident

• 8420 - Value (Result)

• 8438 - Data stream (Details)

6310 – optional (for PDF or/and XML)

• 6303 00000x - FileArchivCharacter

• 6303 - File format ( "VAX" or "PDF")

• 6304 - File content ("Name")

• 6305 - file reference (path for data )

– optional test results see section 2.3.7

2.4.4 PDF/XML

Optovist can return the test PDF or/and as XML-file to the EDP on request. Example:

0156302000001 0126303VAX 0276304Testdata 0766305file:///C:/Program Files/Vistec/Optovist/gdt/EDVOPT_examination.vax 0156302000002 0126303PDF 0376304Testsummary 0726305file:///C:/Program Files/Vistec/Optovist/gdt/EDVOPT_summary.pdf

26

3 XML-Interface

Optovist facilitates to export a complete test as XML-file. These XML-files have the ending ".vax". If this file-ending is registered in windows under the program Optovist, by double clicking on the XML-file, it can directly start and load with Optovist.

With the help of XML-file it is possible to reload the complete test in Optovist without database; thereby the test is automatically imported (if not already changed).

This option would be helpful e.g. in case of following scenario:

Initial situation:

• Optovist database is not allocated through the network.

• PC-A has got local Optovist installation and EDP-Network-connection.

• PC-B has got local Optovist installation and EDP-Network-connection.

1. On PC-A a test is carried out and transferred to EDP.

2. On PC-B with the help of EDP the test of PC-A should be displayed again.

• PC-B – Optovist database empty

• PC-B – EDP transfers the already saved XML-file of test of PC-A while doing GDT-Transfer

• Optovist can load and display test from the XML-file

3.1 General Structure

<Untersuchung> <Proband> <Identitaet> </Identitaet> </Proband> <Sequenz> <Einstellungen> <Einstellung /> </Einstellungen> <Testschritt> <Testart> ...optional je nach Testart... </Testart> <Quoten> </Quoten> </Testschritt> <NotesK /> </Sequenz> </Untersuchung> Element - Untersuchungen

• Untersucher

• Name

• Zeitstempel [ "YYYY-MM-DDTHH:MM:SS" ]

27

Element Study Subject

• Element Identitaet

◦ Name

◦ Vorname

◦ Geburtstag [ "YYYY-MM-DD" ]

◦ Bundesland

◦ Kommentar

◦ Land

◦ Strasse

◦ IdNr

◦ Postleitzahl

◦ gdtid

◦ Geschlecht [ 'm' = male, 'f' = female ]

◦ Ort

• Element Firma

◦ Firmenname

◦ None ['1' = no company assigned, '0' = company assigned]

◦ Bundesland

◦ Kommentar

◦ Land

◦ Strasse

◦ Abteilung

◦ IdNr

◦ Postleitzahl

◦ Ort Element Sequence

• Element Einstellungen

◦ Sehhilfe [user defined visual aid] [Standard: without, reading glasses, Bifocal glasses, Trifocal glasses, Progressive glasses, BAP-glasses, Contact lenses, Distance glasses]

◦ Element Einstellung

▪ Bereich [ '1' = Nearby area, '2' = Intermediate area, '3' = Far area ]

▪ Distanz [ value between 0.33 - 20 Meter]

• Element Testschritt

◦ Typ [ Test type – see section " 3.2 Design of individual test types " ]

◦ Sehhilfe [ Visual aid in this test ]

◦ Bereich [ Distance-Area of test ]

◦ Mod [ '0' = not started, '1' = started ]

◦ Distanz [ Distance with which the tests would be carried out ]

◦ Element Quoten

▪ Klim [ Contrast-Limit off when the test value is Ok]

▪ VLim [ Visual acuity-Limit off when the test value is OK]

▪ Slim [ Stereo-Limit off when the test value is Ok]

▪ Element Quote

• Kon [ Contrast – Level ]

• Vis [ Visual acuity – Level ]

• Quo [ Quote in percentage, how many signs must be identified, thereby level OK ]

28

3.2 Structure of Individual Test Types

3.2.1 Visual Acuity Test

General Structure

<SehschaerfeK > <Bildgruppen> <Bildgruppe> <Bild> <Symbols> <Symbol /> </Symbols> <Levels> <Level /> </Levels> </Bild> </Bildgruppe> </Bildgruppen> </SehschaerfeK> Element Visual Acuity K

• Augenmodus [ 'r' = right eye, 'l' = left eye, 'b' = Binocular]

• Element Bildgruppen

◦ Index [ Pre-selected group of images]

◦ Element Bildgruppe

▪ Sortiert [ '1' = image sequence fixed, '0' = Image sequence random]

▪ Auswahlmenge [ Number of images which may be displayed each eye]

▪ ok [ complete OK ]

▪ Index [ preselected image within its group of images]

▪ Element Bild

• Id [ File name ]

• Element Symbols

◦ Element Symbol

▪ Kon [Contrast]

▪ Vis [Visual acuity]

▪ Var

▪ Deg [ Grade° of sign]

▪ ok [ '0' = not identified, '1' = identified ]

▪ nok [ ' ' = Signs not tested, '1' = not identified ]

▪ Typ [ Type of sign "Landolt ring", "Characters", "Number", "Tumbling E" ]

▪ Pos="0|0" [Sign position in image]

• Element Levels

◦ Element Level

▪ Vis [Level of visual acuity]

▪ ok [ '0' = not identified, '1' identified ]

3.2.2 Phoria test

General structure

<PhorieK> <Phorie /> </PhorieK>

29

Element PhorieK

• Augenmodus [ 'b' = Binocular]

• Element Phorie

◦ Ortho [ '0' = not set, '1' = set = proper]

◦ Exo [ '0' = not set, '1' = set = not proper]

◦ Hyperi [ '0' = not set, '1' = set = not proper]

◦ Eso [ '0' = not set, '1' = set = not proper]

◦ Hypo [ '0' = not set, '1' = set = not proper]

3.2.3 Stereo test

General Structure

<StereoK > <Bildgruppen> <Bildgruppe> <Bild> <ObereReihe /> <UntereReihe /> </Bild> </Bildgruppe> </Bildgruppen> </StereoK> Element StereoK



◦ Index [ preselected group of images]


▪ Sortiert [ '1' = Sequence of images fixed, '0' = Sequence of images random ]




▪ Element Bild

• Id [ File name]

• Element Symbols

◦ Element ObereReihe

▪ ok [ '-1' = not tested, '0' = not identified, '1' = identified]

◦ Element UntereReihe

▪ ok [ '-1' = not tested, '0' = not identified, '1' = identified ]

3.2.4 Color test (Device)

General Structure

<ColorK> <Bildgruppen> <Bildgruppe> <Bild> <Symbols> <Symbol /> </Symbols> </Bild> </Bildgruppe> </Bildgruppen>

</ColorK>

30

Element ColorK



◦ Index [ preselected group of images]


▪ Sortiert [ '1' = Sequence of image fixed, '0' = Sequence of image random ]




▪ Element Bild


• Element Symbols

◦ Element Symbol

▪ Kon [Contrast]


▪ Var



▪ nok [ ' ' = Sign not tested, '1' = not identified]

▪ Typ [ Type of sign "Landolt ring", "Characters", "Numbers", "Tumbling E" ]

▪ Pos="0|0" [Sign position in image]

3.2.5 Accommodation test

General Structure

< Akkommodation > <Bildgruppen> <Bildgruppe> <Bild> <Symbols> <Symbol /> </Symbols> <Levels> <Level /> </Levels> </Bild> </Bildgruppe> </Bildgruppen> </Akkommodation> Element Accommodation


• GuiRange [ Distance of respective eye ]


◦ Index [pre-selected group of images]


▪ Sortiert [ '1' = Image sequence fixed, '0' = Image sequence random ]



▪ Index [ pre-selected image within its group of images]

▪ Element Bild


• Element Symbols

◦ Element Symbol

31

▪ Kon [Contrast]


▪ Var

▪ Deg [ Grade° of sign ]


▪ nok [ ' ' = Sign not tested, '1' = not identified ]

▪ Typ [ Type of sign "Landolt ring", "Characters", "Numbers", "Tumbling E" ]

▪ Pos="0|0" [Sign position in the image]

• Element Levels

◦ Element Level

▪ Vis [Level of visual acuity]


3.2.6 Contrast test

General Structure < KontrastK > <Bildgruppen> <Bildgruppe> <Bild> <Symbols> <Symbol /> </Symbols> <Levels> <Level /> </Levels> </Bild> </Bildgruppe> </Bildgruppen> </KontrastK> Element ContrastK



◦ Index [ pre-selected group of images]





▪ Index [ pre-selected image within its group of images]

▪ Element Bild


• Element Symbols

◦ Element Symbol

▪ Kon [Contrast]


▪ Var



▪ nok [ ' ' = Sign not tested, '1' = not identified ]

▪ Typ [ Type of sign "Landolt ring", "Characters", "Numbers", " Tumbling E " ]

▪ Pos="0|0" [Sign position in the image]

• Element Levels

◦ Element Level

▪ Vis [Visual acuity/Contrast-level]


32

3.2.7 Glare test

General Structure <BlendungK> <Bildgruppen> <Bildgruppe> <Bild> <Symbols> <Symbol /> </Symbols> <Levels> <Level /> </Levels> </Bild> </Bildgruppe> </Bildgruppen> </BlendungK> Element GlareK

• Augenmodus [ 'r' = right Eye, 'l' = Left Eye, 'b' = Binocular]


◦ Index [preselected Imagegroup]



▪ Auswahlmenge [Number of Images allowed to be displayed per eye]

▪ ok [ Complete OK ]

▪ Index [preselected image with its Imagegroup]

▪ Element Bild

• Id [ Filename ]

• Element Symbols

◦ Element Symbol

▪ Kon [Contrast]

▪ Vis [Visual]

▪ Var

▪ Deg [ Degree° of Symbol]

▪ ok [ '0' = unidentified, '1' = identified]

▪ nok [ ' ' = Symbol not tested, '1' = unidentified ]

▪ Typ [ Type of Symbol "Landolt ring", "Alphabet", "Number", "Tumbling E" ]

▪ Pos="0|0" [Symbol position in Image]

• Element Levels

◦ Element Level

▪ Vis [Visual/Contrast-Level]

▪ ok [ '0' = unidentified, '1' identified]

33

3.2.8 Visual field

General Structure <PeriK /> Element PeriK


• Ok [ Number of identified LED's ]

• LED1 [ '-1' = not tested, '0' unidentified, '1' = identified]

• LED2 ...

• LED3

• LED4

• LED5

• LED6

• LED7

• LED8

• LED9

• LED10

• LED11

• LED12

• LED13

• LED14

• LED15

• LED16

• LED17

• LED18

• LED19

• LED20

• LED21

• LED22

• LED23

• LED24

• LED25

• LED26

• LED27

• LED28

34

3.2.9 Hyperopia test

General Structure < HyperopieK > <Bildgruppen> <Bildgruppe> <Bild> <Symbols> <Symbol /> </Symbols> <Levels> <Level /> </Levels> </Bild> </Bildgruppe> </Bildgruppen> <HyperopieSchritte> <Hyperopie /> </HyperopieSchritte> </HyperopieK> Element Accommodation

• Augenmodus [ 'r' = right Eye, 'l' = left Eye, 'b' = Binocular]


◦ Index [preselected Imagegroup]



▪ Auswahlmenge [ Number of Images allowed to be displayed per eye ]

▪ ok [ Complete OK ]

▪ Index [ preselected image inside his Imagegroup ]

▪ Element Bild

• Id [ Filename ]

• Element Symbols

◦ Element Symbol

▪ Kon [Contrast]

▪ Vis [Visual]

▪ Var

▪ Deg [ Degree° of Symbol]

▪ ok [ '0' = unidentified, '1' = identified]

▪ nok [ ' ' = Symbol not tested, '1' = unidentified]

▪ Typ [ Type of Symbol "Landolt ring", "Alphabet", "Number", "Tumbling E" ]

▪ Pos="0|0" [Symbol position in Image]

• Element Levels

◦ Element Level

▪ Vis [Visual-Level]

▪ ok [ '0' = unidentified, '1' identified]

• Element HyperopieSchritte

◦ Index [ active Range ( '0'= +0,5dpt, '1'= +1dpt, '2'= +1,5dpt ) ]

◦ Element Hyperopie

▪ Dpt [ '+0.5' , '+1' , '+1,5' ]

▪ schlechter [ '0' = no, '1' = yes]

▪ besser [ '0' = no, '1' = yes]

35

3.2.10 Amsler Documentation

General Structure <AmslerK> <Spot /> <Square /> <Parallel /> </AmslerK> Element AmslerK

• Augenmodus [ 'r' = right Eye, 'l' = left Eye, 'b' = binocular]

• Element Spot

◦ ok [ ''-1' = not tested, 0' = unidentified, '1' = identified ]

• Element Square


• Element Parallel


3.2.11 Color test Ishihara Book (Documentation)

General Structure

< IshiharaK /> Element IshiharaK

• Augenmodus

• Ok [ '0' = unidentified, '1' = identified]

• Nok [ '0' = unidentified, '1' = identified ]

3.2.12 Color test Velhagen Book (Documentation)

General Structure

< VelhagenK /> Element VelhagenK

• Augenmodus

• Ok [ '0' = unidentified, '1' = identified]

• Nok [ '0' = unidentified, '1' = identified ]

36

4 Database

The database consists of a file, and is located in the program folder by default. In addition there is a possibility to configure Optovist in such a way that a database of another Folder can be swapped. Thereby the UNC – Addresses are also supported. Database-Properties:

• Name of the Database: "optovist.vdb"

• Type of the Datenbase: SQLite Version 3.5.9

4.1 Database Structure

Subjects-Index:

Name: "proband”

• id [integer] - primary key,

• persistent [integer]

• personalid [TEXT ]

• vorname [TEXT]

• lastname [TEXT]

• gender [varchar(1)]

• birthday [DATE] (yyyy-MM-dd)

• street [TEXT]

• postCode [TEXT]

• location [TEXT]

• federalState [TEXT]

• country [TEXT]

• comment [TEXT]

• companyid [integer]

• gdtid [TEXT]

Company Index:

Name: "company”

• id [integer] - primary key

• persistent [integer]

• companyid [TEXT]

• name [TEXT]

• branch [TEXT]

• location [TEXT]

• postCode [TEXT]

• street [TEXT]

• federalState [TEXT]

• country [TEXT]

• comment [TEXT]

Research Index:

Name: "examination”

• id [integer] - primary key

• probandid [integer]

• day [TEXT] ISO 8601 "YYYY-MM-DD" • name [TEXT]

• xmlfile [BLOB]

37

5 CSV-Interface

With the help of the CSV export interface, it is possible to export subjects from the database into a CSV file as well as to import subjects from a CSV file into the Optovist-database.

5.1 Export of subjects

During Export of Subjects, all subjects selected in a file with the extension.csv are exported.

Each line provides the data of the subject. The individual parameters are separated by semicolons.

The structure of this file is as follows:

• First Name

• Family Name

• Birth date

• YYYY-MM-DD

• Gender

• Personnel Number

• ZIP Code

• Place

• Street

• House Number

• State

• Country

• Company

• Department

• GDT-UserID

5.2 Import of subjects

During import of subjects, all subjects are imported from a file with the extension.csv.

Similar to Export, each line in the file of the subject will be read. The individual parameters must be separated by semicolons. For a proper Import the Parameter sequence should be similar to the Export.

Parameter sequence

• First Name

• Family Name

• Birth date

• YYYY-MM-DD

• Gender

• Personnel Number

• ZIP Code

• Place

• Street

• House Number

• State

• Country

• Company

• Department

• GDT-UserID

38

Vistec AG

Werner - von - Siemens - Str. 13

D - 82140 Olching

Telefon: +49/8142/44 857-60

Telefax: +49/8142/44 857-70

Email: [email protected]

Internet: www.vistec-ag.de

02/11

optovist interface description

Documents