...
ScanImage
...
requires
...
an
...
initialization
...
(INI)
...
file,
...
usually
...
named
...
standard.ini
...
,
...
to
...
be
...
specified
...
at
...
startup.
...
This
...
file
...
initializes
...
state
...
variables
...
for
...
ScanImage
...
that
...
are
...
considered
...
to
...
be
...
invariant
...
with
...
respect
...
to
...
experiment
...
or
...
user
...
employing
...
the
...
ScanImage
...
installation
...
(a
...
'rig').
...
Typically
...
there
...
is
...
only
...
one
...
INI
...
file
...
per
...
'rig'.
...
The
...
INI
...
file
...
should
...
generally
...
be
...
stored
...
in
...
the
...
same
...
directory
...
with
...
one
...
or
...
more
...
user
...
(USR)
...
files.
...
On
...
startup,
...
ScanImage
...
prompts
...
for
...
a
...
USR
...
file
...
to
...
be
...
selected.
...
If
...
one
...
is
...
chosen,
...
then
...
ScanImage
...
loads
...
the
...
standard.ini
...
file
...
located
...
in
...
the
...
same
...
directory,
...
if
...
found.
...
ScanImage only prompts to directly select an INI file if 1) no USR file is specified or 2) no file named standard.ini is found in the selected USR file's directory.
| Tip | ||
|---|---|---|
| ||
The first time running ScanImage, one will not have a USR file configured yet. When prompted to select a USR file, 'Cancel' should thus be selected. Then ScanImage will prompt for an INI file – the configured standard.ini file should then be selected. To avoid this double prompting going forward, it is highly recommended that users save a USR file to load on future startups. |
Configuring the INI File
Each release of ScanImage (beginning with ScanImage r3.5) contains a file standard_model.ini located in the directory 'ScanImage\init_files' (and also provided below).
The user should:
- Copy this standard_model.ini file to the desired INI (and USR) file directory (e.g. C:\Data\Config\ScanImage)
...
- Rename
...
- the
...
- file
...
- to
...
- standard.ini
...
- .
...
- Edit
...
- the
...
- file
...
- as
...
- appropriate
...
- for
...
- the
...
- hardware
...
- and
...
- experimental
...
- requirements
...
- of
...
- the
...
- rig.
...
The standard_model.ini
...
file
...
contains
...
comments
...
which
...
document
...
the
...
meaning
...
of
...
each
...
of
...
the
...
variables.
...
The INI file parser is whitespace sensitive. The format <VARNAME>=<VARVALUE>
...
must
...
be
...
strictly
...
followed,
...
i.e.
...
no
...
space
...
to
...
left
...
or
...
right
...
of
...
the
...
equal
...
sign
...
Find
...
below
...
the
...
standard
...
_model.ini
...
file
...
for
...
each
...
ScanImage
...
release
...
and
...
a
...
note
...
for
...
each
...
indicating
...
the
...
changes,
...
if
...
any,
...
compared
...
to
...
the
...
prior
...
release:
| Center |
|---|
| Info | ||
|---|---|---|
| ||
As a general rule, only one INI file should be required per 'rig' (ScanImage installation). In rare circumstances, however, a rig might require more than one INI file. For instance, if two users – or two types of experiment – require that one of the variables contained in the INI file must differ from session to session. In such cases, there are two options:
|