Versions Compared

Old Version 3

changes.mady.by.user Unknown User (iyerv)

Saved on

compared with

New Version Current

changes.mady.by.user Unknown User (iyerv)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

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:

Panel
titleStandard Controls
Center
Image Modified
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.
Panel
bgColor#DDFFFF
titleINI File _Rig Configuration_ Changes
Center

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.