...
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 Mode Controls window:
| Panel |
|---|
| title | Standard Mode Controls |
|---|
| | Wiki Markup |
|---|
{center}[!ScanImage Pics^r3_5_standardModeGUI.png|height=200!|ScanImage Pics^r3_5_standardModeGUI.png]{center}
h6. 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. When this option is selected, 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. Thus, 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_. If this value is _Inf_, or the _\# Frames/File_ specified exceeds the _# Frames_, file 'chunking' is disabled, and all data is logged to a single file, named as usual (e.g. _BehaviorExpt1_).
|
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 |
|---|
| title | INI File _Rig Configuration_ Changes |
|---|
|
New VariablesmaxBufferedGrabTime: 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
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.
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.
...
| bgColor | #DDFFFF |
|---|
| title | INI File Change Summary |
|---|
One variable related to this feature has been added to the standard_model.INI file:
...
.
