• Created by Unknown User (iyerv), last modified on Dec 08, 2008

In ScanImage 3.0, image data acquired during a GRAB was buffered into (Matlab) memory, and then saved to disk following the acquisition. For applications requiring long imaging records (e.g. optical recording during behavior protocol), this restriction limited the number of frames that could be obtained without either 1) running out of memory or 2) breaking the acquisition into several LOOP iterations, with a 'gap' of time employed to allow for the TIF image data to be written to disk.

To overcome this, ScanImage 3.5 adds the capability to 'stream' to disk continuously. This has been implemented for 'standard mode' operation only. Thus, the new controls can be seen on the Standard Controls window:

Standard Controls
This page contains macros or features from a plugin which requires a valid license.

You will need to contact your administrator.

New Controls
  • Save during acquisition?: When selected, data is streamed to disk continuously during GRAB/LOOP acquisitions. The number of frames (# Frames) that can be entered is unlimited.
  • # Frames/File: Some users may prefer to separate ('chunk') data from very long acquisitions into several smaller files. This control specifies the number of frames to log to each file during the acquisition. As further data is collected, a new data file is automatically created.
    • To disable such 'chunking', this value should be set to Inf (or set to exceed the # Frames). Then all data is logged to a single file.
    • When chunking is enabled, a three-digit number (e.g. 001, 002, etc) is appended to the filename, following an underscore. The number is auto-incremented as each new file is added.
    • For example, if 3000 frames are collected with 500 frames/file, with Basename='BehaviorExpt' and Acquisition #=1, specified in the Main Controls window, there will be six files named BehaviorExpt1_001 through BehaviorExpt1_006.
INI File Rig Configuration Changes

New Variables

maxBufferedGrabTime: Specifies the maximum duration, in seconds, to allow a GRAB acquisition to proceed with Save during acquisition? option not selected. If long acquisitions are desired without streaming-to-disk, then this number can be increased. The maximum value reached will depend on computer memory. Increasing/adjusted this value is not generally recommended.

Usage Notes

(tick) If acquisition is interrupted, whether by aborting the acquisition or by some other event, data logged to the file has been found to be readable and uncorrupted (in tests thus far). Thus, file chunking is not generally advised/required.
(warning) ScanImage 3.5 writes image data to uncompressed TIF files, as did ScanImage 3.0. Files can become quite large. The use of data compression will be added in future versions.

  • No labels