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.
First Time Starting ScanImage?
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:
Multiple INI Files (Rarely Needed)
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:
- Maintain separate folders for each INI file, each named standard.ini. Each folder contains the USR file(s) associated with that INI configuration. In this case, selecting the USR file on startup will cause the appropriate INI file to be loaded.
- Name the INI files something other than standard.ini (e.g. rigConfig1.ini and rigConfig2.ini) and then select the particular INI file when prompted, after selecting the desired USR file (if any) on startup.