Chapter 3. Settings

Selecting Settings->Configure Klusters will open the Settings Dialog. This lets you configure several default behaviors of Klusters.

General

In this page, you can configure the following:

  • Crash and recovery. To protect your data in the unfortunate event of a crash, Klusters can periodically save a hidden recovery copy of your data. Normally, this recovery file is deleted when you close the cluster file or quit the application. But if Klusters crashes, the recovery file remains on the disk and the next time you start working on the same data, Klusters will find the recovery file and propose to use it instead of the presumably less up-to-date cluster file. If you choose to do so, the cluster file will be renamed (the date will be appended to its name) and the recovery file will become the new cluster file. This setting lets you enable or disable this feature and, if enabled, choose how often the data should be saved to the recovery file.

    Notice that this is different from an auto-save feature, in that it is still your responsibility to save your work: remember that the recovery file is normally deleted when you close the cluster file or quit the application. The advantage of this mechanism is that you keep control of when the data is actually saved to the cluster file, thus reducing the risk of saving erroneous modifications.

  • Undo. You can set the maximum number of changes that can be undone. Be aware that the ability to undo an operation requires that an additional copy of the data be kept in memory: thus for large data files, increasing this value will significantly increase the memory load.

  • Reclustering. This allows you to choose the reclustering program and set its parameters. The default program is Kenneth D. Harris' KlustaKwik>. Alternative programs can be used, provided they also accept a feature file as their input and produce a cluster file with the same base name and electrode group ID (see Data Files for more information). Another possibility is to use a shell script, e.g. to move the temporary file where Klusters stores the features for the selected clusters to a more powerful server, process the data, and then move the newly created cluster file back to your workstation.

    Three variables are provided to help you build the command line: %fileBaseName, %electrodeGroupID, and %features. These are automatically set by Klusters to match the default values for the currently edited file: %fileBaseName will be replaced with the base name of the temporary feature file (see note below), and %electrodeGroupID will be replaced with the tetrode or shank ID. Finally, %features will be replaced with an ensemble of boolean values (flags) indicating which features should be used by the reclustering program, namely all features except the user-defined features. As an example, assume that the data was recorded from a tetrode and that the feature file contains three principal components for each electrode, as well as four additional user-defined values (e.g. spike height, width, etc.) and time. Then, %features will be replaced with 11111111111100001, which reads:

    1  use 1st principal component for electrode 1
    1  use 2nd principal component for electrode 1
    1  use 3rd principal component for electrode 1
    1  use 1st principal component for electrode 2
    ...
    1  use 3rd principal component for electrode 4
    0  do not use 1st user-defined feature
    0  do not use 2nd user-defined feature
    0  do not use 3rd user-defined feature
    0  do not use 4th user-defined feature
    1  use time
    

    Although the example above is for a tetrode with three principal components per electrode, in general the actual value for the %features variable is set dynamically based on the information provided by the parameter file. You can also decide not to use this variable and supply your custom flags instead.

    Note on %fileBaseName: Assuming that the base name for your data files is CS210904 and that clusters 2, 4 and 7 are selected for reclustering, %fileBaseName will be replaced with a value such as CS210904-[2-4-7]-02.13.2004-18.54 (the date and time are appended after the list of clusters). Although the temporary feature and cluster files are automatically deleted when automatic reclustering completes, depending on the reclustering program this base name may also be used for additional outputs such as log files.

  • Background color. This setting affects all views.

Cluster view

When time is selected as one of the projection dimensions in the Cluster View, thin lines are drawn at regular time intervals. This options enables you to change the default time interval.

Waveform view

The following items can be configured:

  • Waveform gain. This determines the initial vertical scale for the Waveform View.

  • Channel positions. This allows you to decide in which order individual electrodes are displayed in the Waveform View. This is most useful for multisite silicon probes.