System Administrator`s Manual

Transcription

Espion System Administrator's Manual
System Administrator's Manual
Espion Table of Contents
Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
System requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Contact Diagnosys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Installing Espion V5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Installing on a new Computer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Setting up system configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Updating old Espion V2, V3 or V4 to new Espion V5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Backup and copy existing files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Rename (and later remove) the old ESPION installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Removing INTERBASE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
System configuration check . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Setting up system security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Updating old databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Configure the Espion system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Pre-configured parameter values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Default value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Restricting access to configure system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Parameter storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Priority in loading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Default parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Local parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Selecting a parameter module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Parameter modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
PROGRAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
HARDWARE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
TESTMETHOD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
STIMULUS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Module options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Changing parameter values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Stimulator Colors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Working with color . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Color lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Default colors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Modifying color lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Selecting a color . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Editing colors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
DOC # 12431 REV B 20th May 2008
Page 2
Diagnosys UK Ltd, 54 Impington Lane, CB24 9NJ Cambridge, UK Tel: +44 (01223 520 699 Fax: +44 (0)1223 520699 email:[email protected]
Color Picker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Basic Phosphor / LED colors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Database parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Client/Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Database Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Unrestricted access. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Restricted access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Database manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Database Administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Register a new Host. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Connection parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Register a database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Add users to the database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Set a new password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Delete a user . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Adding user roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Espion database roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Adding users to roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Exit and unregister . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Database backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Autobackup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Customizing the subject fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Turn subject pages on/off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Enable and disable subject fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Renaming subject fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Turn on user fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Printing and exporting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Hospital name and address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Printing and exporting subject fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Patient Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Printing banners and pictures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Print margins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Print page template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Printer header and footer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Reviewer options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Days left to review. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
DOC # 12431 REV B 20th May 2008
Page 3
Diagnosys LLC, 175 Cabot Street, Suite 500, Lowell, MA 01854, USA Tel: +1 (978) 458 1600 Web: www.diagnosysllc.com email: [email protected]
Reviewer action list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Visit number list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Check subject details before test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Miscellaneous. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Camera mode (ColorDome only) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
EOG angle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Eye labeling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Ethnic origin, Eye color, Eye acuity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Protocol Category filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Report template file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Setting the system date & time. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Configuration parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
PROGRAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
HARDWARE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
TESTMETHOD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
STIMULUS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
DOC # 12431 REV B 20th May 2008
Page 4
Introduction
I
ntroduction
This manual is intended for the Espion system administrator and describes how to set system
security and how to change some of the most common used system configuration and protocol
settings. It also includes a list of all system configurations parameters at the back of the manual.
This manual is not written to describe the full features of the software. Further software information
can be found in the Espion Users Guide.
System requirements
You will need Espion V5 of the software, which includes the Espion application, Firebird database
server and client , backup scheduler (FIBS), and Database manager (IBManager).
If you require password protection in the Espion Software you will have to use the provided Database
Manager program to set usernames and passwords.
Contact Diagnosys
Head Office
Diagnosys LLC
175 Cabot Street, Suite 500
Lowel
MA 01854, USA
Tel: +1 (978) 458 1600
email:[email protected]
web: http://www.diagnosysllc.com
Manual version
V 1.2 2008
DOC # 12431 REV B 20th May 2008
Page 5
Installing Espion V5
I
nstalling Espion V5
Introduction
The Espion V5 comes with a lot of new features and enhancements including a new underlying
database. The new database is not directly compatible with the old style Espion database but the
Espion V5 software will enable you to update you to the new format.
New installation
If you have don't have a previous installation of the Espion software on your computer you can just
run the Espion V5 Setup.exe file which will install the Firebird database server and client and the
Espion V5 software.
Upgrade existing Espion
If you already have an installation of the Espion software there are a few things that you must do first
to remove the old installation of the Interbase client and server from your computer. The current
software version is shown on the front menu of your existing Espion software along with the release
date and the Espion serial number which should be the same as the console serial number found on
the back of the console.
NOTE: This is also true if you have other software applications installed that uses an Interbase
database.
Windows Vista
For installation on Windows Vista see separate application note.
Installing on a new Computer
You can install the Espion V5 software both on a computer with or without hardware connected (You
may have another machine for report writing). If you computer never have had an installation of the
Espion software follow the guidelines below (for Windows Vista installation see separate application
note):
l Run the Espion V5 Setup.exe and install the included software (Firebird Server & Client and
Database Manager) in the default directories (unless you want to install the software on a
Client/Server network where the Server may not reside on the same machine as the client. Note
that the Espion database file has to be physically located on the Server machine).
If you have hardware connected (Console and one or more stimulators) you must install the
hardware drivers.
l Plug the Espion console into the computer and point to the Espion USB drivers in the Espion
directory
l If applicable plug the ColorDome camera USB cable into the computer and point to the Camera
drivers (you may have to run the camera installation program first)
l Copy the calibration files from the CD into the Espion directory (COLDxxx.CAL (ColorDome),
COLBxxx.CAL (ColorBurst) or PSGxxx.CAL (pattern stimulator) where xxx=serial number of the
stimulator)
DOC # 12431 REV B 20th May 2008
Page 6
Setting up system configuration
Press the Configure System button on the main Espion menu to set up the system configuration
parameters for your installation.
Set up configuration
Parameter
Enter the serial number of the Console (displayed on the back of the
Console) if hardware is connected to computer.
Configure System\Program\Global\Serial number
Enter the serial number of the Stimulators if hardware is connected to
computer.
Configure System\HARDWARE\<required Stimulator>
Set up the Country type UK/USA for date and time formats
Configure System\Program\Global\Country Type
Set up mains frequency (50/60Hz) if any hardware is connected
Configure System\Program\Global\Main Frequency
Enter hospital name and address if you want it to be displayed on printouts
see page 32
Set up required system security for Password or non password
see page 19
Set up operator mode security
see page 11
Enable IO card if console is connected to computer.
Configure System\HARDWARE\IO Card Enabled
Check that Windows Direct IO is enabled
Configure System\HARDWARE\WINDOWS Direct IO
Set touch screen on/off to disable or enable the touch screen facilities such
as on screen keyboard
Configure System\Program\Global\Touch Screen
Set Backup frequency as required
see page 31
Check that the default backup destination is acceptable
see page 32
Check that the default Export destination is acceptable
Configure System\Program\Global\Export destination
Updating old Espion V2, V3 or V4 to new Espion V5
Before installing any of the new software, you must first remove the existing INTERBASE software
from the computer and copy system configuration and calibration files.
Backup and copy existing files
l Backup you database(s) to CD or DVD
Copy the the following files from the Espion directory (normally C:\Espion) to e.g. a memory stick:
l ESLOCAL.INI (local configuration settings)
l ESIMP.CAL (impedance calibration file)
l COLDxxxx.CAL (calibration file for existing ColorDome)
l COLBxxx.CAL (calibration file for existing ColorBurst)
l PSGxxx.CAL (calibration file for existing PSG)
l Any custom files such as files containing logo and banners that you store in the Espion directory.
Rename (and later remove) the old ESPION installation
Rename the Espion program to e.g. C:\OLD_Espion. When you are happy with the new installation
you can at a later date remove the old espion installation by delete the whole OLD_Espion directory
from Windows.
DOC # 12431 REV B 20th May 2008
Page 7
Removing INTERBASE
l Press CTL-ALT-DEL to bring up the Windows Task manager
l Click on the "Processes" tab
l Search for IBGUARD.EXE and "End process"
l Search for IBSERVER.EXE and "End process"
l Go to the Add/Remove programs menu, in the Windows Control Panel and uninstall both the
l
l
l
l
Interbase server and client software
Using the Windows browse options, look in the C:\WINDOWS\SYSTEM32 directory for
GDS32.DLL and delete this file (if you find it)
Reboot your machine and Press CTL-ALT-DEL to bring up the Windows Task manager and check
that the IBGUARD.EXE or the IBSERVER.EXE is not running anymore
Run the Espion V5 Setup.exe and install the included software (Firebird Server, & Client and
Database Manager) in the default directories (unless you want to set up a Client/Server network).
Copy your Calibration and configuration files into C:\Espion V5 (ESLOCAL, ESIMP,
COLDxxx.CAL, COLBxxx.CAL and PSGxxx.CAL)
System configuration check
Press the Configure System button on the main Espion menu to check that the system configuration
parameters is setup correctly for your installation.
Set up configuration
Parameter
Check the serial number of the Console (displayed on the back of the
Console) if hardware is connected to computer.
Configure System\Program\Global\Serial number
Check the serial number of the Stimulators if hardware is connected to
computer.
Configure System\HARDWARE\<required Stimulator>
Check up the Country type UK/USA for date and time formats
Configure System\Program\Global\Country Type
Check the mains frequency (50/60Hz) if any hardware is connected
Configure System\Program\Global\Main Frequency
Check hospital name and address for displaying on printouts
see page 32
Check that IO Card is Enabled if console is connected to computer.
Configure System\HARDWARE\IO Card Enabled
Check that Windows Direct IO is enabled
Configure System\HARDWARE\WINDOWS Direct IO
Check your Touch screen preference (touch screen on/off to disable or
enable the touch screen facilities such as on screen keyboard)
Configure System\Program\Global\Touch Screen
Set Backup frequency as required
see page 31
Check that the default backup destination is acceptable
see page 32
Check that the default Export destination is acceptable
Configure System\Program\Global\Export destination
Setting up system security
Espion V5 includes new improved system protection. To set up system security see page 19
required password (new feature) or non password (old style). For setting up old style operator mode
protection to restrict access to Configure System see page 11.
Updating old databases
The Espion V5 allows you to convert your old databases 'xxxx.GDB' into the new format 'xxxx
V9.FDB'.. (V9 is the internal database version number) All new databases ends in '.FDB'. Converting
a database does NOT delete the old database. Espion V5 won't allow you to use the old databases.
DOC # 12431 REV B 20th May 2008
Page 8
l Connect to your old database from the Espion Database Center
l Press the update button The update process may take some time depending on the size of your
database.
DOC # 12431 REV B 20th May 2008
Page 9
Configure the Espion system
C
onfigure the Espion system
System Configuration defines all the features which appear when configuring and running tests with
the Espion. This covers basic information such as the hospital name and the current date & time, but
also includes the ability to alter both the defaults and the actual values which appear as options in
many of the menus throughout the system.
A full list of all system configuration parameters is to be found at the back of this manual.
Fig 1 Espion start up menu
The "Configure System" menu is reached from the front page button.
Pre-configured parameter values
Throughout the Espion program, there are many menus of values and options which may need to be
configured. Some are accessible only in protocol configuration, and some can be accessed during
the test depending on your authorization level.
Most parameters can be set by touching the parameter entry box and selecting from a 2D grid of
possible values which will appear on the screen. The Espion is factory programmed with a list of
pre-configured parameter values for each of these boxes and a default value already selected from
the list. However, to make the system extremely flexible, both the defaults and the lists themselves
can normally be changed by using this System Configuration menu. You may want to add values to
the current list, or you may want to limit the list of values displayed in order to maintain compatibility
between tests, and avoid unsuitable values being selected (especially if many different people use
the system).
Default value
The Espion program is built around the concept of modules. Not only do all module parameters come
with a list of pre-configured values they also come with one value in the list being set as the default
option. This is the value that will be used when creating new protocols or tests, new subjects, new
normals etc.
Example
Consider the setting for result post trigger duration in the acquisition menu of the VEP-ERG protocol.
You can normally select any value from the list: 100ms, 200ms, 250ms, 300ms, 400ms, etc. But you
may decide that you wish to run a test with a trial duration of 150ms, or some other value which does
not appear. Provided that this value is within certain limits, you can add it to the list. You can also
change the default to be 150ms such that all new steps will by default have this parameter set to
150ms, and remove all the unwanted values from the list.
DOC # 12431 REV B 20th May 2008
Page 10
Restricting access to configure system
It is possible to restrict the access to the "Configure System" menu by requesting the user to enter a
password.
If you set the Configure System\Global\operator mode parameter is to INVESTIGATOR a
password will be required to enter the configure system menu. The Configure System entry
password is set in the Configure System\Global\operator password parameter.
Default password
If operator mode is left at ADMINISTRATOR the password is set in the Operator password
parameter and the default is "masterkey". (Other Operator modes are only provides for backwards
compatibility) You have to be in ADMINISTRATOR mode to view the full list of all System Configure
parameters. The full list is not available for the INVESTIGATOR.
Fig 2 Configure System\Global\Operator mode parameter
NOTE: If password was requested in the Password option parameter you will still have to set up
the Operator Mode to INVESTIGATOR if you want to password protect the Configure System menu.
Parameter storage
The Espion program is built around the concept of modules where each module has a unique set of
parameters and parameter values which control its behavior. These lists of parameters and their
values are stored depending on how the system is configured.
Priority in loading
The system configuration parameters can be stored in different locations and the order of priority
when loading the parameter value lists is highest Local followed by Global and lastly Defaults.
DOC # 12431 REV B 20th May 2008
Page 11
Default parameters
The system is shipped with one set of default parameters only. These parameters may be updated
with each new version installed and should not be altered.
Local parameters
When running on a network of Espions or machines with more than copy of the Espion software
loaded, each installation of the software will require its own local copy of some of the parameters.
For example different installations might have different hardware requirements, different operator
modes etc.
DOC # 12431 REV B 20th May 2008
Page 12
Selecting a parameter module
All parameters are grouped into logical modules (groups). In order to change a parameter, you must
first select the module which contains it. It should be quite easy to find the appropriate module, as
each one relates to a different section of the program. The list of modules which appears will vary
depending on which hardware and software modules you have chosen to purchase.
When a module is chosen, the parameters for that module will be shown. The number of parameters
shown will vary depending on the current operator mode selected. If you are using Administrator
operator mode then all parameters will be available. If you are using Investigator mode then only the
most useful parameters will be displayed, removing the clutter of unnecessary parameters spoiling
the view.
Parameter modules
PROGRAM
In the program group you find the global parameters relating to the entire system and the database
parameters.
Global
This module contains all the Parameters which relate the entire system. This includes,hospital
details, examining doctors, report headers and footers and operator mode.
Database
This module contains the default values for all the patient details, including patient, and protocol
categories, database password, and database housekeeping options.
HARDWARE
In the hardware group you will find a list of all hardware parameters
Console
The main parameters in this module enable and disable the Console. This includes the DSP card,
and any connected button box for recording user responses or program control.
Amplifier
Contains the default amplifier parameters.
PSG Pattern Stimulator
This stimulus module contains the parameters to setup the stimulator serial number, view module
information and calibrate monitor for the PSG
VSG Pattern Stimulator
This stimulus module contains the parameters to enable the stimulator, setup the stimulator serial
number, view module information and set up configuration file path name for the VSG (Espion Mk1 or
updated Espion Mk1 stimulus generator only).
DOC # 12431 REV B 20th May 2008
Page 13
ColorBurst
This stimulus module contains the serial number and the module information for the ColorBurst
stimulator.
ColorDome
This stimulus module contains the serial number and the module information for the ColorDome
stimulator.
TESTMETHOD
The test method group contains a module for each test method with all parameters that effect the
screen display, and protocol setup including printer options, markers, channels, steps and results,
acquisition parameters for new protocols including number of trials per result, sample frequency etc.
but not the stimulus parameters.
STIMULUS
The list contains all the parameters required to produce stimuli for all available stimulator (including
some you may not have purchased)
ColorBurst Ganzfeld
Contains the default protocol parameters required to control the ColorBurst to create single and
multiple flashes on a colored background using the LEDs. These include flash and background
colors, intensities and flash frequency. Colors can be set up using the Color picker system.
ColorDome Ganzfeld
Contains the default protocol parameters required to control the ColorDome to create single and
multiple flashes on a colored background using the LEDs and the Xenon tubes. These include flash
and background colors, intensities and flash frequency. Colors can be set up using the Color picker
system.
Ext Trigger Out
This stimulus parameter group contains all the default protocol parameters to produce single or
multiple pulses from the external trigger output on the back of the Console.
Ext Trigger In
This parameter group contains all the default protocol parameters to synchronize data capture with
either an external input trigger from the trigger input on the back of the Console, or the leading edge
of an analogue peak/trough on one of the input channels.
Chequers, bars, gratings
These parameters contains all the default protocol parameters to control the pattern stimulator and
generate checkerboards, bars and gratings. Parameters include size, contrast, color, and temporal
frequency.
EOG leds
Contains the default protocol parameters to set up EOG LED angle, display frequency, color and
background
DOC # 12431 REV B 20th May 2008
Page 14
Module options
Module Enabled
This parameter at the top of each Testmethod and Stimulus parameter list enables/disables the
particular module. This is useful if a e.g.piece of hardware is no longer available e.g. a stimulator or
you wish to deny access to certain tests or stimuli. Only external modules can be disabled and when
disabled will not appear and will not be available for use by the program.
For example if you disable the Color Burst stimulus module, then no protocols will appear that use
this module, no new protocol can be created using this module and no tests already performed using
this module will be available for review.
Information
Displays information about the selected software module. This information normally includes a
version number and other relevant facts about the module or hardware it supports. This information
may be required by the manufacturer in order to provide technical support. The information displayed
is constantly being updated, such that changes in hardware will be automatically reflected e.g.
pressing the ColorBurst buttons, will change the button status.
Configure the colors
This may appear when certain modules are selected, although not all modules have this option. If
this button si displayed, then the module has a custom method of changing some or all of its
parameters in a more helpful manner than simply typing in a number or string. This facility makes
setting certain types of parameters much easier particularly color parameters where it is very helpful
to be able to see the color you are entering. The text on this button may vary depending on the
module. Two modules that do use this button are the ColorBurst and pattern stimulator modules.
These allow you to add/delete/modify colors using a color picker system. For more information on
how to use this system see stimulator Colors on page 16.
Changing parameter values
All the parameters names for the selected module appear on the left hand side of the screen, and on
the right hand side the default value for this parameter is displayed (press the box to display the full
list of values). A parameter can also show a disabled/enabled tick box or a Configure colors button.
Factory
setting
default
parameter
(Def)
Default
value has
been
changed
locally (Loc)
DOC # 12431 REV B 20th May 2008
Page 15
Stimulator Colors
Certain stimulus generators can have programmable colors which are set using the Color button in
the parameter list. Colors are stored separately for each stimulator, but the way you choose them is
similar.
Working with color
The Espion’s color facilities are designed to further research into the exciting field of color visual
electrophysiology, and to allow the emerging clinical protocols to be performed reproducibly and
easily.
However, any visual electro-physiologist who has not previously studied color should be aware that
color vision and the technology for representing color are complex subjects, raising many issues
which will not be apparent without a reasonable working knowledge of these fields.
Color lists
Stimulus modules that produce color stimuli, choose the color(s) from a predefined list saved in the
module’s parameters. This list can be modified in a intuitive manner by selecting from a color
diagram rather than typing the color in directly. These lists are normally configured with a few
common default colors. Colors are internally stored in CIE coordinates but may be created using
other color spaces. The luminance of the color presented by the stimulus is controlled by protocol
parameters and is not defined at this point.
Default colors
Red, green, blue
The Espion is initially set up with red, green and blue corresponding to the three LEDs or phosphors
of the ColorBurst, ColorDome or Pattern Stimulator. These colors can be edited or deleted if
desired.
Peak
Peak is the brightest color (white) which can be produced (i.e. maximum red, blue and green
together). This color is a special case which is created if you enter 0,0 as the CIE coordinates. Again,
you can delete this color if you wish, and you may want to create your own white with a different color
balance, by creating a new color with real CIE coordinates.
Modifying color lists
To modify the color list for a particular stimulus module, select the module and press the Color
button.
This will produce a menu showing the current colors and allow further colors to be defined or current
entries to be deleted.
Selecting a color
To select a color for modification, touch the entry in the color list. This will not only select the color
but if the stimulator is connected and enabled, will be displayed by the stimulator.
DOC # 12431 REV B 20th May 2008
Page 16
Editing colors
List of existing colors
Current color name
editor
Current color CIE
editor
Delete the current
highlighted color
Displays the
maximum intensity
for the current color
Edit color using
color picker
Create a new color
Save the edited
color
New
A new color can be added by touching this button, then entering new values for the color name and
CIE x and y and press the save color button.
Name
Give the color a meaningful and unique name.
CIE x , y
Enter the CIE coordinates of the color. Alternatively, you can use the color picker.
max intensity
Each stimulator has its own color gamut (range of achievable colors and luminances), which
depends on the characteristics of its three phosphors or LEDs. This area will display the maximum
luminance for the current color if it lies in the stimulator color gamut otherwise it will display zero.
If the color can be created, a non-zero value will be displayed. This is the maximum luminance (in
cd.s.m-2) at which the color can be displayed. Check that this is bright enough for your purposes.
Save color
When the color is as required, touch this button to save it. It will then appear as an option in the
relevant menus for the stimulator.
Color Picker
The color picker is designed to make creating colors as obvious as possible. The color space is
selected at the bottom and the limits of the color space are displayed in the main area. The colors
displayed on the screen are the computer’s best attempt at showing the colors available but
remember that the computer displays color space and that of the stimulator may be different and
therefore these colors can only be used as a guide. You can move the color position around the
space either by touching the screen and dragging the cross or using the red arrow keys. You can
also drag the arrow in the X or Y axes to restrict motion to one axis only.
DOC # 12431 REV B 20th May 2008
Page 17
As you move around the space the stimulator (if it is connected) will show the current color.
Samples of original and
edited color
Return color to basic
phosphor/LED colors of
stimulator
3rd dimension in
color space, usually
luminance
Position of color in
color space
Co-ordinates of the new
color
Change color co-ordinates
in color space
Select the color
space
Change color
co-ordinates in
the 3rd
dimension
Return color back
to original
3rd dimension
For most color spaces the third dimension is the luminance except for RGB space where it becomes
the blue output.
Arrows
Use the red arrows to move around the two dimensional color space display, and the blue arrows to
move in the third dimension, which is represented by the slider. Alternatively, you can just touch the
display or slider.
Original
Cancel changes and return to the original color without leaving the color editor screen.
Colors
The original color is always displayed at the top of the screen under reference, next to a sample of
the selected new color. Note that due to the limitations of the Espion screen, these colors are not
accurate, and you should look at the stimulator to see exactly what you are creating.
Color space
The color can be represented in different color spaces by selected from the tab at the bottom of the
screen. CIE is the normal choice, as in this space equal distances correspond to roughly equal
changes in perceived color. RGB refers to the red green and blue phosphors or LEDs of the
stimulator, and can help to explain the physical reality in the stimulator. The others color spaces are
provided for any user with a special interest.
Co-ordinates
The coordinates for all the color spaces are displayed at the right of the screen.
OK
When you touch OK, you will return to the color editing screen, and the color you have selected will
appear as the current color automatically saved in the colors list.
Basic Phosphor / LED colors
The three buttons labeled ‘phosphors’ or ‘LEDs’ will take you to the three basic phosphor or LED
colors of the stimulator you are using. These colors have been calibrated for your stimulator and are
used to calculate all other colors: the values are defined when your
DOC # 12431 REV B 20th May 2008
Page 18
Database parameters
D
atabase parameters
The Espion software is written around an industry standard SQL server/client indexed relational
database which stores all the patient information, test details, test results, protocols and normals in
one database file.
Client/Server
All systems from Diagnosys are supplied with a local server, client interface, database manager and
the Espion program pre-installed.
The server program handles the simultaneous logons from the clients, prioritizes data access,
locks/unlocks data records and verifies all user passwords and the client interface software which
allows a client program access to the server program. The server program can also be installed onto
a remote computer connected via a TCP/IP network. The client interface must always be installed
onto the same computer as the Espion program (client program). The database file must reside on
the physical machine hosting the server, not on a mapped drive.
Database Security
There are two security modes to run the Espion program. Restrictions to the database are turned on
and off from the Configure System\PROGRAM\DATABASE\Password options parameter
Fig 3 Password options
DOC # 12431 REV B 20th May 2008
Page 19
Database parameters
Unrestricted access
If the Configure System\Program\Database\Password options = None the Espion
program uses the default password, username and role from the Configure
system\Database\database default parameters and allows unlimited and unrestricted
access to all users.
Fig 4 Database default parameters
The default username is “SYSDBA” and password is “masterkey” (no quotes). The default role is
Administrator. However, even though the user is not prompted for a username and password, the
default username and password must be a valid user setup on the server.
NOTE: Even when the system generally allows unrestricted access it is possible to password protect
the users access to the Configure system (see page 11) and limit the list of configuration
parameters that the user has access to.
DOC # 12431 REV B 20th May 2008
Page 20
Database parameters
Restricted access
The database can be configured to require an authentication username and password by selecting
the Configure System\Program\Database\Password options = requested parameter.
If you have selected password protection the username and password is prompted at log on and the
user role is read from the database. One username can only have one role. Adding users and
passwords and assigning them database roles is done from the database manager see page 22.
The server keeps a list of users which is applicable for all database controlled by this server. Users
are assigned database privileges (roles) to a particular database. The system administrator need to
assign users to roles for each database. The authenticated user can be given one of five roles with
restriction of viewing, modifying and deleting of records.
Role
Access
Viewer
View records only. No adding, modifying or deleting subjects or
protocols and no running of new tests.
Reviewer
The same as a viewer + ability to review (add review comments and
actions) and modify old tests (move markers) and save them.
Technician
Add new subjects, run and save tests, Limited run-time
environment. no modify or delete subjects, protocols and old tests.
No ability to review test.
Investigator
Add, modify or delete all records. Run new tests, review old tests.
No ability to setup users, passwords or roles
System administrator
The same as the investigator + ability to add/modify/delete users,
passwords and roles. Can set password protection on the configure
system menu and has access to extra configure system
parameters. Access to the database audit trail
When the user logs on with username and password their username and role are displayed at the
top of most windows. If the user hasn't been allocated a role for the current database the Espion
program will log on the user as a viewer with the default role PUBLIC.
NOTE: The software has a built in audit trail that logs every insert, modification or deletion of data. If
you want to have the full benefit of the built in system security you will need to implement the
password protection option.
DOC # 12431 REV B 20th May 2008
Page 21
Database manager
D
atabase manager
Database Administration
The Database manager program (IBManager.exe) program is part of your Espion installation and is
located in the Espion program group. Adding users and passwords and assigning them database
roles is done from the database manager. This program is the free LITE version from EMS and for
administrators who require more functionallity please visit their website where you can buy the full
application.
Select the Database manager program and run it. Any host (the machine on which the server
program resides) server and databases you have previously registered on the host will be displayed
in the list of databases. Double click on the database to make it active and perform actions on it. If
you haven't yet registered any host or want to register a new host the first step is to register the host
before you can register a database and add users and usernames. If you already have registered a
host you can go directly to page 24.
Fig 5 IBManager main menu
DOC # 12431 REV B 20th May 2008
Page 22
Database manager
Register a new Host
To register a new host, select the "Register Host..." option in the Databases drop down list.
Connection parameters
Specify the hostname (in this example localhost), protocol and system administrator username and
password. The default username is 'SYSDBA' and the default password is 'masterkey' (no quotes).
Press next.
Ignore all the specific connection options and just press finish.
You host should now be displayed in the databases list in the IBManager main menu. You can now
proceed to registering you database.
DOC # 12431 REV B 20th May 2008
Page 23
Database manager
Register a database
Select the "Register Database" option from the menu bar or right click on your host in the databases
list.
You are then asked to specify the database host.
In this example we have already registered the host and can use the default setting. Press next to
register the database. Enter the system administrator username and password when prompted.
DOC # 12431 REV B 20th May 2008
Page 24
Database manager
Press the Browse button to find the database file you want to register.
When you have entered a valid filename press the finish button to return to the main menu.
Your database is now displayed under the the hostname in the databases list.
DOC # 12431 REV B 20th May 2008
Page 25
Database manager
Add users to the database
Adding users to the database and assigning them roles is a two stage process.
From the tools drop down list select the "User Manager" option
If the host server is not selected you have to select it from the list of available servers.
All database comes with two default users (SYSDBA and PUBLIC)
DOC # 12431 REV B 20th May 2008
Page 26
Database manager
Press the Add user button to add a user and password. Repeat for all the users you want to enter.
Set a new password
From the toolbar drop down list select the "user manager" and the Edit user button. Double click the
username to select the user that you want to set a new password for.
NOTE: You cannot view the old password or see the new one.
Delete a user
From the toolbar drop down list select the "User Manager" and the delete user button. Double click
the username to select the user that you want to delete. Press "OK" to confirm that you want to
delete the user.
DOC # 12431 REV B 20th May 2008
Page 27
Database manager
Adding user roles
With the database selected press the toolbar drop down list and select the Role Manager.
There are four available roles in the Espion database. The roles relevant for the setup are:
Technician, Investigator, Reviewer and Viewer. You select the members of a role from a list of
available users. You can also remove members again.
NOTE: A user can only have one role in the Espion software. If you require one user to have more
than one role you will need to add separate usernames and passwords for each role for this user.
DOC # 12431 REV B 20th May 2008
Page 28
Database manager
Espion database roles
Viewer
View records only. No adding, modifying or deleting subjects or protocols and no running of new
tests.
Technicians
A technician can add new subjects, run and save tests.
Reviewers
A reviewer can modify tests (move markers) and add review comments and actions.
Investigators
An Investigator can add new, modify and delete subjects, set up and modify protocols and run tests,
load and modify old saved tests and review tests (add review comments and actions).
Adding users to roles
Select the required role from the list and press the Edit role members option. This will display a list of
available users. Select the user(s) that you want to give (grant) the role e.g. Investigator and press
the "OK" button. You will then be asked to commit your actions to the database. The username(s) of
the all the members(s) of the role including the new member will now be displayed in the list of role
members.
List of available
users
Add (or remove) the
selected user or all
users from the list
of role members
Role manager
displaying role
members
Commit the
changes to
the role
members list
DOC # 12431 REV B 20th May 2008
Page 29
Database manager
Fig 6 User roles and their members example
Exit and unregister
Select the exit option in the database drop down list and confirm you want to exit the program.
NOTE: To enforce password protection on the database file ensure that you remember to unregister
the database and the host when finished or someone with physical access to the machine where you
have the database manager residing will be able to use the stored password and username to gain
access directly to the database file.
DOC # 12431 REV B 20th May 2008
Page 30
Database backup
D
atabase backup
Although the Espion program has many built in features to prevent you from loss of data due to e.g.
power cut it can never be stressed enough that you always should backup your data and store a
copy of the data somewhere else.
Backing up is performed from the Database Center and requires making a copy of the database
file(s). This can be done either through Windows copy/paste or using the Espion Backup function.
Backing up the database file regular is essential for record recovery in the case of serious system
failure. The program can be configured to prompt the user to perform regular backups. The next
required backup date is displayed in the Database Control center window. The program will keep
reminding the user every time the program is started until the backup has been done. The frequency,
destination path and next date for the backups are set from Configure
System\Program\database.
Fig 7 Configuring backups
Backup frequency
Backup frequency can be set to one of the following options:
The "Every Session" option will prompt for a backup if any changes have been made to the
database.
DOC # 12431 REV B 20th May 2008
Page 31
Backup destination
Database backup
The program (WindowsXP only) will run the CD burning wizard automatically if the backup
destination is configured as the path to the CD RW (For DVD's you have to use the supplied DVD
burning software for the backup). To set up the backup destination as the CD RW use Windows
Explorer to identify the drive letter of the CD RW e.g. D:\ . The D drive is the default CD RW on the
Espion Panel PC. Point the backup destination to this path. The CD wizard can also be automatically
started by entering the destination path can as:
C:\Documents and Settings\<username>\Local Settings\Application Data\Microsoft\CD
Burning
where username is to be replaced with a valid username with the required permissions on the
system to access the CD RW.
Other backup destination options include:
l USB memory Key
l Removable hard drive
l Accross the network
l Copy the database ".fdb" file using Windows copy
NOTE: Save any changes to the configuration when prompted.
Backup next date
The next required backup date can be set from configure system. If the backup isn't performed the
system will keep nagging the user until they have performed a backup.
Autobackup
During the test, data is automatically saved to a temporary file after every result but not written
permanently to the database until you have pressed the "Exit" button and saved the test. The system
keeps the last 20 autobackup files. The temporary files are used to recover data if the system goes
down (e.g. a power cut or a software problem) in the middle of a test. When the system comes back
up you have the option of being returned back into the last test after the last recorded result.
You can restore unsaved data from any of the 20 autobackup files see separate Application Note.
DOC # 12431 REV B 20th May 2008
Page 32
Customizing the subject fields
C
ustomizing the subject fields
Introduction
The subject/patient fields are divided into three pages called “Patient”, “Details”, and “Address”. You
can manually change the appearance of these from Configure System
Fig 8 Configuring Subject fields
Turn subject pages on/off
Turn off address page
The Subject Address page can be turned on and off from the Configure
System\program\database\Subject Address Entry parameter.
Turn off details page
The Subject details page can be turned on and off from the Configure
System\program\database\Subject Details Entry parameter.
DOC # 12431 REV B 20th May 2008
Page 29
Enable and disable subject fields
The system can be configured to require certain patient fields be filled in, ignored, or disabled
whenever a new patient is added. Every patient field available has one of four code numbers
assigned to it which denotes one of the following:
l The field is disabled and greyed out (0)
l The field does not need to be entered (1)
l The field must be entered (2)
l The field is disabled and hidden (3)
This configuration is setup in the Configure System\database\Subject Field Codes. The
parameter consists of a series of numbers or codes which specify the option for each field. e.g.
01112111011112. The subject field code, the subject field name and the subject field print parameter
all relate to the same subject field and this way determines the name of the field, if it is displayed and
if it is displayed on printouts and when exporting using drag and drop.
Fig 9 Subject fields enable and disable codes
DOC # 12431 REV B 20th May 2008
Page 30
Renaming subject fields
There are 31 fields and they listed in the Subject Field Names parameter in the following order
from left to right along the string:
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
Family name
First Name
Initials
Data of birth
Hospital number
Gender
Referring doctor
Ethnic origin
Category
Normal
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
Street
Town
State
Zip Code
Country
Telephone
OD Acuity
OD Refraction
OS Acuity
OS Refraction
21.
22.
Comment
Eye Color
User fields 1..9
You can modify the values in the list by pressing the keyboard and typing in the new field name.
Turn on user fields
There are 9 user defined fields in total. As a default, 3 user defined fields are displayed on the
subject details page. To display all user fields turn off the subject address page and enable the user
fields in the subject field code parameter.
DOC # 12431 REV B 20th May 2008
Page 31
Printing and exporting
P
rinting and exporting
Hospital name and address
Fig 10 Hospital name and address parameters
The hospital name and address is setup from the Configure
System\Program\Global\Hospital Address and Configure
System\Program\Global\Hospital Name parameters. If you enter some values here this
information is displayed on your printouts. and on the start menu of the Espion program.
DOC # 12431 REV B 20th May 2008
Page 32
Printing and exporting subject fields
This print and export to drag and drop configuration is setup in Configure
Syste\Program\Database\Subject Field Print parameter. The parameter consists of a
series of numbers or codes which specify the option for each field. e.g. 01110111011110.
Fig 11Subject field print parameters
l The field is not included on a printout(0)
l The field is included on a printout (1)
l For a list of fields see page 22
DOC # 12431 REV B 20th May 2008
Page 33
Patient Notes
Fig 12 Notes template file name
As part of the run-time window menu you have the option of adding notes to the patients test. These
can be added to the patient printouts if you select the option on the print menu.
You can specify a template file filename for each test method e.g. for the ERG in Configure
System\Test method\ERG Test\Notes Template File. There can be one Notes template
file for each test method.The notes template files have to be in ASCII format and can e.g. be used for
requesting signatures on printouts.
Printing banners and pictures
Banner and picture for the printout is stored in a file in the Espion directory. The name of this file is
Espion.wmf. If you want to create your own banners you just need to create a new file with same
filename and save it in the Espion directory.
DOC # 12431 REV B 20th May 2008
Page 34
Print margins
You can specify printer margins in mm for each test method as four numbers (Left, Top, Right,
Bottom) e.g. for the ERG in Configure System\Test method\ERG Test\Print Margins
(mm). You can set these parameters to e.g. allow you to use headed notepaper or changing paper
size.
Fig 14 Print margins parameters
Print page template
You can specify the print page template option for each test method e.g. for the ERG in Configure
System\Test method\ERG Test\Print Page Template. This option allows you to remove
or enable the banner, box and lines on the printouts. Disable it if using headed notepaper.
Fig 13 Enable or disable the print page template
DOC # 12431 REV B 20th May 2008
Page 35
Printer header and footer
Use these parameters to print text on every page. You can either enter a line of text as the parameter
value and this text will be displayed on every page or you can enter a valid filename (as in the
example below) and it will pull in the text from the file. This enables you to display multiple lines and
can be useful if you e.g. require a signature on every page.
Fig 15 Add print header and footer
DOC # 12431 REV B 20th May 2008
Page 36
Reviewer options
R
eviewer options
If you have selected to setup your Espion program with usernames and passwords and are using the
option of running your test procedure in a two stage process (e.g. in a clinical trial) having a
technician running the test with a reviewer reviewing the test afterwards you may want to set some of
the available reviewer parameters.
Days left to review
Fig 16 Reviewer days left to review parameter
You can set a deadline for the reviewer to perform the review of a test in the Configure
System\Program\Database\Reviewer Days for Procedure (Days) parameter. The days
left to review a test is displayed in the review table together with the review status of the test.
DOC # 12431 REV B 20th May 2008
Page 37
Reviewer options
Reviewer action list
Fig 18 Pre-configured reviewer actions
After reviewing a test the Reviewer can select from a list of reviewer actions. These are set in the
Configure System\Program\Database\Reviewer Action ERG parameter.
The default list of reviewer actions are
Visit number list
When the technician has performed a test he can fill in a visit number for the test. Using a predefined
list of visit numbers reduced the likelihood of incorrect input. The list of available visit numbers
displayed at the end of a performed test are set in the Configure
System\Program\Database\Test Comment parameter. For historical reasons this is called test
comment.
Fig 17 Visit number list
DOC # 12431 REV B 20th May 2008
Page 38
Reviewer options
Check subject details before test
Fig 19 Confirm subject details message
Before running a test it is possible to display a message with the current selected subjects details to
allowing the technician to confirm that the correct subject has been selected for the test. This option
can be enabled from the Configure System\Program\Database\Subject Check Before
Test parameter.
DOC # 12431 REV B 20th May 2008
Page 39
M
Miscellaneous
iscellaneous
Camera mode (ColorDome only)
For each Test Method it is possible to set up the camera mode to display the ColorDome camera
either USB + Video ( display the image both on the screen on the video output e.g. an external
monitor) or Video only (Turn on the camera but display the picture only to the video output and
don't put the image on the screen).
Fig 20 ColorDome Camera mode
EOG angle
The angle is either 30o or 60o and is set in Configure System\Stimulus\EOG LEDs\EOG LED
Angle (deg).
Fig 21 EOG angle parameter
DOC # 12431 REV B 20th May 2008
Page 40
Miscellaneous
Eye labeling
The default displayed eye labeling (OS, OD, Both) can be changed to e.g. LE, RE, Both from the
Configure System\TestMethod\<test method>Channel Eye Tested parameter.
Fig 22 Changing the eye label
NOTE; If you change the displayed eye label for a test method it is important that you maintain the
order of the labels; Left eye, Right eye, both
Ethnic origin, Eye color, Eye acuity
The list of values for the Ethnic origin, eye color and eye Acuity are related to the subject fields. You
rename what is displayed in the selection list. You can change the parameters from Configure
System\Program\database\<parametername>.
Fig 23 Ethnic origin, eye color and acuity parameters
DOC # 12431 REV B 20th May 2008
Page 41
Miscellaneous
Protocol Category filter
It is possible to set up a default protocol category filter so that every time you enter the protocol page
only the protocols with the default category is shown.
Fig 24 Setting a default protocol category filter
The default filter is set up in Configure System\Program\Database\Protocol Category
Filter.
Report template file
A report template file is used by Microsoft Word when producing a report from within the Espion
program is set in the Configure system\programs\database\Report Template parameter.
Fig 25 Report template file name
DOC # 12431 REV B 20th May 2008
Page 42
Miscellaneous
Setting the system date & time
Adjusting Window’s date and time can be quite a tedious chore if you have a touch screen. To speed
up this process, the program includes the ability to change both the date and time using touch
sensitive buttons.
System date and time
The system date and time are displayed on the start-up screen and used to date-stamp tests as they
are performed. This menu allows easy changing of these resources, but you may still use the
standard Windows method as well. The date and time are set on the menu which appears when you
touch this button and will not be updated until the OK button is pressed.
Change time
Change month
Current day
Changing the date
To change the date, press either button to move through the months and then touching the current
date.
DOC # 12431 REV B 20th May 2008
Page 43
Configuration parameters
Appendix A
C
onfiguration parameters
What follows is a list of all system configuration parameters that are available.
NOTE: This list is not definitive and may not be correct for the current version of the software you are
running.
PROGRAM
Global Parameters
The following Global parameters are available:
Parameter Name
Parameter Description
Module information
Describes software information, login name, computer name
Autobackup directory
The default autobackup directory (used for backing up to an external device e.g. memory card)
Autobackup enabled
Enable or disable autobackup
Autosave directory
The name of the subdirectory in the espion directory for the ESSAVEx.BAK backup file (System keeps last 20 files
x=0...19) and the transfer file backup copy
Century Start date
Start year
Country type
Setup date & time format for UK or US
Debug mode
Factory parameter
Drug study role
Factory parameter
Drug Study
Factory parameter
Electrode types
List of electrodes
Examiner
Obsolete parameter
Export destination
Default path for export files
Export separator
Default export file value separator
Global INI not found warning
Factory parameter
Global INI Path
Factory parameter
Hospital Address
Hospital/site Address (displayed on printouts)
Hospital Name
Hospital/site name (displayed on print outs)
Mains frequency
Set local mains frequency 50Hz or 60Hz
Operator Mode
Select Administrator (no password for access to all configure system parameters) or Investigator (password for access
to configure system and not all system configuration parameters visible)
Operator password
Set up the password for the selected operator mode
Play Sounds
Enable or disable touch screen sounds
Print header
Enter text string or header filename (full path) for printouts
Print footer
Enter text string or header filename for printouts
Serial number
Console serial number and site number
DOC # 12431 REV B 20th May 2008
Page 44
Stimulator Buttons
Enable or disable stimulator buttons (ColorBurst only)
System Colors
List of colors that can be cycled through when selecting colors
Transfer Autosave Enabled
Save a copy of the transfer file locally when creating a transfer file
Touch Screen
Touch screen keyboard on/off
USB Camera Name
For systems with multiple cameras connected ensure that the Espion camera is selected
Database parameters
The following database parameters are available:
Parameter Name
Backup Destination
Default backup destination path
Backup Frequency
Manual, every day, every week, every month, every session
Backup Next Date
Next date where backup is prompted
Convert UNC to TCP/IP Drive
Convert addresses for network setup
Create Default Database
factory parameter
Database Default Password
Set database default password (used when no password option has been selected)
Database Default Role
Set database default role (used when no password option has been selected)
Database Default Username
Set database default username (used when no password option has been selected)
Database Path
Default database path
Database Script Path
Factory parameter
Diagnoses File
Name of file containing the list of patient diagnoses
Encrypt Data Records
Enable or disable data encryption in database
Encrypt Export File
Enable or disable encryption of data in the export file
Ethnic Origin
Used when describing a patient’s/ subject's origins. Selected in the patient/subject details menu. This is also used by
the normals system to select normals for patients with similar origins.
Eye Acuity
Used to describe a patient’s acuity. Selected in the patient details menu
Eye Color
Used to describe a patient’s eye color. Selected in the patient details menu
Ignore Missing Database
Display warning message if no database is found
Lock Database Path
Lock path
Old Test Filters
Apply filter to the old tests
Password Options
Allows you to decide the level of security attached to database access. None does not prompt for a password and
uses the standard firebird default system administrator user and password. Requested requires the user to enter both
the user and the password each time they start the program and the System administrator has to set up users and
allocate them roles using the database manager
Protocol Category
A list of categories that can be associated with any protocol to allow them to be filtered
Protocol Category Filter
Default filter when protocol page is first displayed
Reason Modified
Select from List of reasons for record modified
Report Template
File name for report template file
Reporter
Diagnosis person
Reviewer Actions ERG
Setup a list of reviewer actions that the reviewer can select from
Reviewer Actions VF
Factory parameter
Reviewer Days for Procedure
If required a deadline for reviewer can be set in this parameter and the review table will display the time left for
review.
Reviewer Days for Validation
Factory parameter
DOC # 12431 REV B 20th May 2008
Page 45
Subject Address Entry
Some users do not require the subject address page to be displayed or filled in and this will remove it from sight.
Subject Category
A list of categories that can be associated with any subject to allow them to be filtered
Subject Check Before Test
Display dialog box with subject name and DOB so the the identity of the subject can be confirmed before running a
test
Subject Details Entry
Some users do not require the subject details page to be displayed or filled in and this will remove it from sight.
Subject Field Codes
Allows you to select the edit status of any field in the patient’s information when creating a new patient.
It consists a string with an entry for each field. The entry can be 0 for disabled, 1 for enabled, 2 for must enter data
before proceeding and 3 for disabled and hidden.
Subject Field Names
List of subject Field names (Same order as field codes)
Subject Field Print
Allows you to select the print status of any field in the patient’s information. It consists a string with an entry for each
field. The entry can be 0 for disabled or 1 for enabled
Test Comment
list of e.g. Visit numbers
Update Script Files
Factory parameter
Validation Certificate
Factory parameter
HARDWARE
Console parameters
Internal Module. The following parameters are available:
Parameter Name
BNC Trigger Output
produce trigger output every time the stimulator produces a flash (Positive or negative)
Button Box Enabled
Some systems have a button box to control the test or enter user responses. If you don’t have such a box then this
option should be Off
Button Box Type
Different types of button box
Button Box Port
List of available button box ports
Espion Filter File
Factory parameter
Espion Program
Factory parameter
Front Panel LEDs
Turn off in software the green LED lights on the front of the Console
IO Card Enabled
Determines whether the hardware that the software is installed onto has an IO card installed for data acquisition. For
Espion systems, this should be On, for PC systems this should be Off
IO card voltage reading
Factory parameter
Trigger input edge
Set to negative or positive (E2 only)
Trigger output voltage
5V (TTL) or 12V (E2 only)
Windows XP Direct IO
Factory parameter
Amplifier Parameters
The following Amplifier parameters are available:
Parameter Name
ADC High Gain Scaling
Factory parameters
ADC Scaling
Factory parameters
Headbox Detection Enabled
Factory parameters
Impedance Gain +ve
Factory parameters
DOC # 12431 REV B 20th May 2008
Page 46
Impedance Gain -ve
Factory parameters
Impedance Offset +ve
Factory parameters
Impedance Offset -ve
Factory parameters
ColorBurst parameters
The following parameters are available:
Parameter Name
Serial number
ColorDome parameters
ColorBurst Serial number
The following parameters are available
Parameter Name
Serial number
PSG parameters
ColorDome Serial number
Parameter Name
Serial number
Pattern stimulator PSG serial number
Calibrate monitor
Run the Monitor calibration program
VSG parameters
Parameter Name
Pattern Stimulator config file
Path to configuration file
Pattern stimulator enabled
Enable or disable the stimulator
Pattern Stimulator Logo File
Path to logo file
Serial Number
Pattern stimulator VSG serial number
DOC # 12431 REV B 20th May 2008
Page 47
TESTMETHOD
VEP, ERG, EOG parametersThe following parameters are the default parameters available for the VEP and ERG Test, the ERG
Test, the VEP Test and the EOG Test. The default values are used when creating a new protocol
for a testmethod.
Note: The default values varies between the different types of test e.g marker names are different.
Parameter Name
Adaptation required
None, dark or light adaptation required
Autozero Enabled
Auto zeroing of sweeps is On/Off by default
Autozero Pre-trigger
The amount of time before the trigger to start the auto-zero
Autozero Range
The range of time from the autozero pre-trigger to include in the autozero calculation
Camera Frame Rate
Frame rate of the Espion camera
Camera Mode
USB+Video or Video (no display on screen)
Channel Axis Scale
Scaling values for Y axes divisions
Channel Eye Tested
Default eye being tested
Channel Names
List of names for channel description
Channel Positive Up
Direction of positive values on the channel axes
Channel Sweep Divide
Amount to scale down the trial amplitudes to display them on the average axis
Cycle Result Colors
Every new result captured is assigned a new color
Display Average Markers Only
Only display the average markers
Display Average Result Only
Only display the average result
Display Average Result Color
Select the display color for the Average
Display Axis Color
Color of the axes
Display Background Color
Color of the screen background, but not including graphs
Display Channel Labels
Display the channel name on the graph
Display Current Result Color
Color of the current result
Display Data Area Color
Color of the graph background
Display Data Text Color
Color of the text displayed on graphs
Display Eye Labels
Display the eye for each result tested on the graph
Display Grid
Display a grid on the graph
Display Layout
Default layout of all axes
Display Marker Labels
Display marker labels on the graph
Display Marker Shape
Marker shape (square, cross, line or none)
Display New Result Color
The color of each new result (unless cycle result colors is enabled)
Display Overlay Mode
Overlay channels, results or steps
Display Position
Position in pixels is saved so the main menu is displayed in the same position next time you return to the menu.
Display SCR Labels
Display each result’s step, channel result number on the graph
Display Separate Mode
Tile, stack or single graph view
Display Step Text
Disabled, before run or before load
Display Sweep Color
The color of each new sweep (unless cycle sweep colors is enabled)
DOC # 12431 REV B 20th May 2008
Page 48
Display Table
Display the marker table on the screen
Display Table Color
Marker table background color
Display Table Sort Order
Marker table sorting column
Drift Removal
Remove trend (baseline) drift from result
Export All Channels
include all channels in export file
Export All Results
Include all results in export file
Export All Steps
Include all steps in export file
Export Analysis Table
Include analysis table in export file (EOG normally)
Export Data Contents
Include information about the results and sweeps in the export file
Export Data Table
Include the data in the export file
Export Data Scaling
Factory parameters
Export Marker Table
Export all marker values
Export Header Table
Include Protocol description, testmethod, test date, number of steps, number of channels, subject name, DOB and
gender in export file
Export Results Column
Include result data
Export Single Column Tables
Factory parameters
Export Stimulus Table
Export stimulus information
Export Summary Table
Include results summary in export filel
Export Sweeps Column
Include sweep data
Export Titles
Export column headers
Export Vertical Tables
Place tables always starting in column o (otherwise in row 0)
First Sweep Delay
Delay before first sweep
Gain
Factory parameter
Ignore Sweep Saturation
Factory parameter
Impedance Pass Limit
Set pass limit for impedance windows display
Impedance Fail Limit
Set fail limit for impedance windows display
Inter Sweep Delay
Default delay between sweeps
Line Filter
Turn line filter on/off
Marker Amplitude Calculation
Type of marker amplitude calculation (Amplitude, RMS, Area or Slope)
Marker Averaged Over
Factory parameter
Marker Automatic
Position markers automatically
Marker Baseline Mode
Set to Oldest (by oldest date) or by visit number
Marker Baseline Visit
The visit number that is set as the baseline
Marker Baseline Enabled
Enable the baseline comparison
Marker Names
Select marker names from list (Varies between testmethods)
Marker Type
Select type of marker (positive, negative, fixed or baseline)
Marker Range Time
Range of time from start time that automatic markers start searching for a peak/trough
Marker Start Time
Start time that automatic markers start searching for a peak/trough
Max Voltage
Max voltage for rejection
Notes predefined comments
Predefined comments for when adding test notes
Notes Template File
Notes template file filename
DOC # 12431 REV B 20th May 2008
Page 49
Print All Steps
Print all steps by default
Print Analysis Table
Print analysis table(EOG normally)
Print Clip Region
Factory parameter
Print Steps
Print steps
Print Margins
Size of print margins in mm
Print Marker Table
Print marker table
Print Notes
Include the Patient notes on the printout by default
Print Orientation
Printer paper orientation
Print Page Template
Enable or disable page template. Turn off when use with headed notepaper.
Print Parameters
Print step parameters by default
Print Result Summary
Print step result summary by default
Print Steps Per Page
Number of steps
Printer Layouts
Storing print layouts
Review Buttons
Labels for the review buttons
Reject Range
The total length of the auto-Zero range.
Result Delay Time
Delay between results
Sample Frequency
The frequency at which data points are recorded
Save Sweeps
Save all sweeps for each result into the database by default
Step Adaptation Time
Step adaptation time
Step Comments
List of pre-determined step comments displayed at the end of the step before moving to next step or end test
Step Print Clip Range
Factory parameter
Step Print Clip Start
Factory parameter
Step Results Per Run
Number of results per step
Step Sequencer
Way steps are recorded for multi step tests (Manual, automatic or random)
Stimulator Sounds
Disable or enable the stimulator sounds (ColorDome only)
Sweep Duration
Default length of sweep (The amount of timer after the trigger point to include in each sweep)
Sweeps Per Result
Number of sweeps per result
Sweep Pre-trigger
Default pre-trigger per sweep
Test Adaptation Time
Factory parameter
Test Option Code
Factory parameter
Trigger Delay
Select default trigger delay
UCL Code
Factory parameter
FST parameters
The following parameters are available for the FST module
Parameter Name
Camera Enabled
Switch camera on/off
Camera Frame Rate
Set camera frame rate
Color Being Tested
The colors available are: White, blue, red, green or red+blue+green
Display Position
Save the last screen position of the main menu until next time you open the menu
DOC # 12431 REV B 20th May 2008
Page 50
Dark Adaptation Time
The adaptation timer can be set between 1 and 99 minutes
Eye Being Tested
Test right eye, left eye or both eyes
Input Device
Options for 1 or 2 button button box
Notes predefined comments
List of predefined comments for test notes
Number Correct Before Start
Require a set number of correct answers before start (ensure that the subject can see the stimulus)
Number Of Repeats
Number of tests per color
Overlay Results
Display with overlay of the results
Print Result Table
Print the individual results
Print Average Table
Print the average results (per eye and color)
Print Margins
Set up print margins in mm
Print Notes
Include the Notes on the printout
Print Orientation
Landscape or portrait
Print Page Template
Disable or enable page template (turn off when using headed notepaper)
Printer Layouts
Store the print layouts
Reversals Before Finishing
Number of times of "No" during the test
Sound Volume
Volume for the action triggered sounds
Stimulus Delay
Set the time-out delay
Stimulus Duration
Set up the flash duration of the stimulus
Stimulus Presentation Delay
Default delay before presenting a stimulus
Stimulus Start Intensity
Set the starting intensity for the test
Test Maximum Time
Total max test time in minutes
Test Option Code
Factory parameter
Zero dB Conversion
Convert dB into absolute intensity cd.s/m2
STIMULUS
ColorBurst parameters
Stimulus module for use only with the VEPERG, ERG, VEP Test methods. The following parameters
are available
Parameter Name
Background Intensity
Background photopic intensities
Calibration enabled
Enable ColorBurst built in relativ LED calibration
Calibrate every test
Enable or disable Calibration before every test
Color CIE(x)=
List of user defined color CIE x coordinates
Color CIE(y)=
List of user defined color CIE y coordinates
Color Name=
List of user defined color names
Fixation LEDs
Have fixation LED in Center, Left, Right or Off
LED intensity
LED intensity in %
Flash cycles
Continuos or single flash or select a number of flashes
Flash Mode
Type of flash: Pulse, Wave form or user defined (from file)
Frame Rate
Max time that is considered a flash (4ms)
DOC # 12431 REV B 20th May 2008
Page 51
Pulse alternate
Alternate flash with background or add flash on top of background
Pulse frequency
Pulse frequency in Hz
Pulse intensity
Required pulse intensity
Pulse period
Default flash on time (default 4ms = flash duration will vary depending on required intensity)
User file delimiter
Delimiter used in the Flash mode userdefined file
Waveform contrast
Contrast in %
Waveform Frequency
Frequency in Hz of waveform
Waveform shape
Square, Ramp up, Ramp down, Sine, Exp or Inv Exp waveform shape
Waveform Time constant
Time constant in ms
Color Dome parameters
Stimulus module for use only with the VEPERG, ERG, VEP, FST Test methods. The following
parameters are available
Parameter Name
Background photopic intensities
Calibration enabled
Enable ColorBurst built in relativ LED calibration
Calibrate every test
enable or disable Calibration before every test
Color CIE(x)=
Color CIE(y)=
Color Name=
Fixation LEDs
Have fixation LED in Center, Left, Right or Off
LED intensity
LED intensity in %
Flash cycles
Continuos or single flash or select a number of flashes
Flash Mode
Type of flash: Pulse, Wave form or user defined (from file)
Frame Rate
Max time that is considered a flash (4ms)
Pulse alternate
Alternate flash with background or add flash on top of background
Pulse frequency
Pulse frequency in Hz
Pulse intensity
Required pulse intensity
Pulse period
Default flash rate (default 4ms = flash duration will vary depending on required intensity)
User file delimiter
Delimiter used in the Flash mode userdefined file
Waveform contrast
Contrast in %
Waveform Frequency
Frequency in Hz of waveform
Waveform shape
Square, Ramp up, Ramp down, Sine, Exp or Inv Exp waveform shape
Waveform Time constant
Time constant in ms
Xenon Filter Attenuation
Factory parameter
DOC # 12431 REV B 20th May 2008
Page 52
ExtTrig Out parameters
Stimulus module for use only with the VEPERG, ERG, VEP test methods. The following parameter
are available:
Parameter Name
Glitch removal
Averaging adjusted over a set period from time zero (just before the flash)
Invert Output
Invert the output pulse
Pulse count
Default number of pulses (single or pulse train)
Pulse Mark Period
The amount of time that the pulse remains active
Pulse Space Period
The amount of time between pulses (for pulse trains only)
Ext Trig In parameters
Stimulus module for use only with the VEPERG and ERG test methods. The following parameter are
available:
Parameter Name
Analogue
Monitor one of the 5 possible input channels for a raising or falling signal before registering a trigger
Channel
Channel number to be monitored
Digital
Registered on either rising of falling edge of the trigger pulse
Glitch removal
Averaging adjusted over a set period from time zero (just before the flash)
Time
Default time for the voltage comparison
Volts
Default Input voltage of the channel to be compared with
Chequers, bars and gratings parameters
Stimulus module for use only with the VEPERG, ERG, VEP test methods. The following parameter
are available:
Parameter Name
Color CIE(x)=
Color CIE(y)=
Color name
Contrast
Color contrast
Dartboard spokes
Number of dartboard spokes
Default units
Show some units in degrees or minutes by default
Delta luminance
A change in color vector luminance between end colors
Fixation Eccentricity
Move fixation in deg away from the center of the screen
Fixation Enabled
Fixation point is enabled
Fixation Rotation
Rotate the fixation point in deg
Fixation Shape
Fixation point shape
Fixation Size
Fixation point size
Luminance
Luminance of color vector end colors
Frame rate
Monitor frame rate - factory set
Patch Eccentricity
Patch offset from center
DOC # 12431 REV B 20th May 2008
Page 53
Patch Enabled
Patch of stimulus enabled
Patch Rotation
Patch rotation
Patch Shape
Patch shape
Patch Size
Patch size
Presentation
Presentation mode for stimulus
Reversals
Number of reversal a second
Rotation Angle
Rotation angle of stimulus
Spatial Size
Spatial size/frequency of stimulus
Stimulus Type
Stimulus type (Chequerboard, bars, gratings or dartboard)
Temporal Onset
Time stimulus is presented for
Temporal Offset
Time stimulus is remove for
Trigger Phase
Where the output trigger is produce in relation to the frame timing
Trigger Polarity
Trigger output polarity
View Distance
Viewing distance of patient
EOG parameters
Stimulus module for use only with the VEPERG, VEP and EOG test method. The following
parameter are available:
Parameter Name
Intensity if background
Color CIE(x)
Color CIE(y)
Color name
EOG LED angle
set angle to either 30 deg or 60 deg
LED Frequency
Reversal frequency in Hz
LED Intensity
Adjust LED intensity on scale of 1-100%
DOC # 12431 REV B 20th May 2008
Page 54

System Administrator`s Manual

Transcription

Similar documents

Windows XP Configuration

Nursing and Residential Staffing Solutions

Inlandsbanan A3.indd

ORGANIC ROOT STIMULATOR Carrot Oil

Stallions are Sons of Doc O Lena, Smooth as a Cat, Peptoboonsmal

Lorenz system II - Harvard Mathematics Department

Work Placement - Practice Work

PDF - The Maxwell

Tutorial of the STRUCTURE software

Kwele Mask - NOA Living