The SM_GUI config file

When you start sm_gui, you can specify a configuration file (see Sec. 5.1). If you don't, the default is a file "sm_gui_config.dat" within your IDL path (in the same directory as the .sav file when you run the Virtual Machine version). If no config file is found, default values are taken for each of the parameters.

The config file is a plain text file. An example is packaged with the sm_gui.zip which you can download from the web. Lines which start with %, # or ; are considered comments and are therefore disregarded.

Currently, you can specify the following in the config file:

• stxm4_disp_settings_file "/path/to/file" will specify a STXM 4 display settings file to be read in at the beginning.

• workdir "/path/to/working/directory" will set the initial working directory (the default directory from which data files are opened etc.).

• n_recent_files n will specify that up to n files will be displayed in the list of recently opened files (bottom of File menu)

• client_logfile "/path/to/logfile" will make the client keep its log file at the location specified.

• congrid_nearest_neighbor 1 will make SM_GUI use nearest-neighbor sampling to recalculate the image when zooming, i.e. when zooming by a factor of two, each pixel will turn into 2 x 2 pixels of the exact same data value. If this config file entry is set to 0 (default), linear interpolation will be used, which gives smoother images. Nearest-neighbor sampling is most useful for debugging, when the exact data value is important.

• use_laser_positions_x_axis 1 will make the microscope use the laser positions for the X axis when SM_GUI starts. Set to 0 not to use the laser positions. Note that normally, this should be set to 1 (use the laser positions) for all axes!

• use_laser_positions_y_axis 1 - as above, but for the Y axis.

• use_laser_positions_z_axis 1 - as above, but for the Z axis.

• custom_display "name" "signal type::code" defines a new custom display combination. See Sec. 9.2.5 for more details.

• custom_display_errormessage 1 will display an error message in the IDL output log if you have specified a custom display combination in the config file which doesn't work for the given data file. See Sec. 9.2.5 for more details.

• aps_read_n_seg n sets the initial number of silicon detector segments which are attempted to be read from APS 2-ID-E files (see Sec. 5.19).

• aps_read_adc 1 or 0 is the initial setting for whether or not the ADC channels are attempted to be read when opening an APS 2-ID-E file (see Sec. 5.19).

• aps_skip_cols n will set the number of columns to be skipped at the left and right when reading APS 2-ID-E files (see Sec. 5.19).

• aps_disp_combinations_from_adc, if set to 1, will use the ADC data rather than the V2F data to calculate the predefined display combinations (see Sec. 5.19).