| Wiki Markup |
|---|
{composition-setup}
{cache:refresh=30d}
----
{comment}{toc:type=flat|maxLevel=24}{comment}
{center}
{report-blocklist:depth=01|injected=true}
{local-reporter:page:sorted children}
{report-header}* [About This Release|#AboutThisRelease]{report-header}{report-body}\[[%content:title%|#%content:title%]\] {report-body}
{report-blocklist}
{comment}{hide-from:groups=ephus-users|users=@anonymous}{create-page:prompt=Enter section name|postfix=(%ident%)|addspace=true}Add new section!{create-page}{hide-from}{comment}
{center}
----
{report-block}
{local-reporter:page:sorted children}
{report-body:injected=trueheader}
{anchor:%content:title%AboutThisRelease}
h1. About This Release {hide-from:groups=ephus-users|users=@anonymous}
h1. {link-to:page edit|page=%content:title%}%content:title%ScanImage r3.5.1 README}^\[Edit\]^{link-to}
{hide-from}
{show-to:groups=ephus-users|users=@anonymous}
h1. %content:title%
{show-to}
{include:%content:title%include:ScanImage r3.5.1 README}
{report-header}
{report-body:injected=true}
{report-block}
----
anchor:%content:title%}
h1. %content:title% {hide-from:users=@anonymous|groups=ephus-users|users}
h5. [To be added to the documentation]
=@anonymous}{link-to:page edit|page=%content:title%}^\[Edit\]^{link-to}{hide-from}
{comment}
{toc:minLevel=2|indent=10px}
----
h2. New Feature Details
h2. Changes (from v3.0)
h4. Startup & Initialization File
The startup selection screen is no longer active by default. The file _scim_startup.m_ remains in the ScanImage installation, in the ScanImage\UserTools directory. Its contents can be copied to, or it can be invoked from, the _startup.m_ file for a given Matlab installation (located at <MATLABROOT>\toolbox\local), if desired.
The initialization file supplied in the ScanImage installation (in the _init_files_ folder) is now considered a model and therefor named _standard_model.ini_. It should not generally be edited directly. Individual users on a rig should copy this file to the same directory where they keep their user configuration (._USR_) files. It should be edited to match specifics of their rig and renamed to _standard.ini._ ScanImage now automatically looks for a file named _standard.ini_ in the same directory where the user file is selected on startup. (If no user file is specified, ScanImage prompts selection of a directory where a _standard.ini_ file can be found; if none is specified, then the installation _standard.ini_ file is used).
There are then two typical arrangements for a rig used by multiple users. In the first case, each user has their own _standard.ini_ file, in their own _.USR_ directory. As an alternative, all users can share a single _standard.ini_ file, provided that all users also share a common _.USR_ file directory.
\\
{tip}If multiple _.INI_ files are desired by a single user (not typical), then they should be located in the same directory as the _.USR_ files and *not* named _standard.ini_. If no _standard.ini_ file is found after loading a ._USR_ file, ScanImage prompts to select a _.INI_ file in that folder.
{tip} A principal advantage of the new scheme is that the configuration file is decoupled from the ScanImage installation. Therefore upgrading ScanImage, as new versions are released, requires simply pointing the path to a new installation folder (and revert by pointing back to a previous folder). The same standard.ini file is employed with each version. Occasionally, upgrades may require additions or changes to the standard.ini file, which will be reflected in the new version's standard_model.ini file. These changes will be clearly documented, to make upgrading/reverting as easy as possible.
\\
\\
\\
\\
\\
h4. Clock Synchronization
The Pockels Cell and mirror output boards are typically not the same. In this case, it is required that the clocks of these boards be synchronized to ensure that flyback blanking remains phase locked with the line scan signal.
In v3.0, this clock synchronization was done by using the RTSI7 terminal (also termed RTSI_OSC) on the RTSI (Real Time Synchronization Interface) available on the National Instruments boards.
In v3.5, synchronization synchronization is now on a terminal specified in the _standard.ini_ file (search for 'outputBoardClockTerminal'). The default is now RTSI6, but can be specified as anything from RTSI<0-6> or PFI<1-9>. Note that RTSI7 is _not an option_ for the clock synchronization terminal at this time. Therefore, RTSI connections made via a pair of wires (as opposed to a RTSI ribbon cable) should be changed from RTSI7 (and its ground) to the selected terminal (and its ground).
\\
h4. Documentation Amendments
The following points were either omitted or unclear in the ScanImage 3.0 documentation.
* The Image Processing toolbox is _required_ for complete ScanImage functionality. Without the toolbox, features (such as ROI/power box) requiring graphical selection of areas, lines, and sites are not supported.
* The mirror and acquisition boards _must_ be the same - this ensures timebase synchronization.
h4. Other Changes/Additions
_Naive Pockels Cell Calibration_
If no photodiode is associated with a particular Pockels Cell (by leaving the photodiodeInputBoardId# property blank in _standard.ini_), a naive linear calibration is employed. This allows the power level to be adjusted via the *Power Control* window (in a nonlinear fashion) and also supports flyback blanking.
_Improved handling for multiple Pockels Cells_
Three Pockels Cells ('beams') are now supported. The specification of which beams are available in each of FOCUS/GRAB/Snapshot, as determined in the 'Laser Function Panel' GUI, is now saved as a user setting, and no longer as a configuration setting. To turn 'off' individual beams for a particular configuration, set the power to 1% (this will set the power to the minimum value as determined by the calibration, if available).
_Modified Servo/Mirror Parameter Names_
In the *Configuration* window (*Edit>>Configuration...* from *MainControls* menu), the 'Line Delay' parameter has been renamed to 'Line (Flyback) Delay' and the 'Cusp Delay' parameter has been renamed to 'Cusp (Servo) Delay'. See [here|(DOC) ScanImage 3.5 Documentation^advancedConfigurationGUI_formatted2.png]. The renamings provide better intuition for what each parameter compensates for.
The 'Line (Flyback) Delay' parameter accounts for the time required for the mirror to catch up with the command signal following a rapid mirror flyback time: rapid flybacks in unidirectional scanning mode typically cause the mirror servo slew rate limit to be exceeded, ultimately requiring extra time for the mirror to "catch up" at the beginning of each line scan.
The 'Cusp (Servo) Delay' parameter refers to the constant lag of the mirror position, relative to the command signal. For the bidirectional scanning case, this is specified as a fraction of the 'ms/Line' value, and can vary as the line speed is varied. For unidirectional scanning, the value is specified in time (in milliseconds).
_Additional Fast Configurations_
_'Safe' Hot Key Option_
By selecting the 'Safe Hot Key' option in the *User Preferences* window (*Settings>>Edit>>User Preferences...* from *MainControls*), the application hot keys require the \*<*CTL> key to be simultaneously pressed in order to be activated.
_ROI Cycler Power Modulation_
The ROI Cycler contains a Power field that allows the power level to be specified, as a percentage, for each position in the cycle. In ScanImage 3.0, this modulation applied to the beam specified as the 'scanLaserBeam' in the standard.ini file. Now, the modulation applies to the beam selected in the beam pulldown menu. This control is connected to the main Power Control GUI's beam selection menu.
\\
h4. Bug Fixes
* The 'pixel time' and 'bin factor' parameters now update correctly following changes to the 'Fill Fraction' or 'ms/line' parameters.
* _Power Box_
** 'Constrain to Line' functionality is actually turned off at startup, matching the startup checkbox setting in the GUI
** Selecting 'Constrain to Line' no longer causes Power Box to 'shift' each time
**
h2. Appendix A: _Standard.ini_ Additions
This section summarizes *new* _state_ variables that have been added to ScanImage via the _standard.ini_ file, including both those that are meant to be user/rig-modified and those which should not generally be modified.
h5. Frequently Modified Variables
* _state.init.triggerInputTerminal: _
* _state.init.externalTriggerInputTerminal:_
* _state.init.externalTriggerTimeout_:
* _state.init.outputBoardClockTerminal:_
* _state.init.shutter.shutterBoardIndex:_ Specifies board index or name (DAQmx) for board on which the DIO line(s) employed for the shutter(s) are located
\\
\\
h5. Infrequently Modified Variables
* _state.init.minUnidirectionalLinePeriodGUI_: Specifies the smallest of the enumerated ms/line options to support for unidirectional scans. Values of ms/line s smaller (faster) than this are exclusively for bidirectional scanning.
* _state.init.maxBufferedGrabTime:_ Specifies the threshold of time for a Grab acquisition, above which data will be saved during the acquisition, instead of afterwards, where possible.
* _state.init.outputChanBufferTime:_ Specifies in time (seconds) the length of the data buffer for the output channels (mirrors and Pockels Cell(s)). Increasing this time increases the frame rate at which data logging and/or merge display can occur reliably, at some expense of memory. This will be computer dependent.
* _state.acq.inputVoltageRange:_Specifies input voltage range to use for PMT input boards. Typically 10V, but lower voltages can allow for more dynamic range. (_{*}NOTE:\_* This feature not currently supported\!)
* _state.acq.inputBitDepth_: Specifies ADC resolution of PMT input boards \-\- typically 12 bits
* _state.internal.fastParkFOVFactor_: Specifies the multipler of the full FOV amplitude to use when parking the beam quickly, e.g. when stopping-and-restarting focus during zoom or rotation update (Default=1.2)
*
h5. Non-modifiable Variables
Other variables added in ScanImage 3.5, which should not be modified by the user in their own _.INI_ files, are simply listed here.
* _state.internal.saveDuringAcquisition_
* _state.internal.framesPerFileGUI_
* _state.internal.framesPerFile_
* _state.internal.triggerTimer_
* _state.acq.saveDuringAcquisition_
* _state.acq.framesPerFile_
* _state.acq.externallyTriggered_
* _state.acq.infiniteFocus_
* _state.acq.bidirectionalScan_
* _state.acq.channelMerge_
* _state.acq.mergeFocusOnly_
* _state.init.hotKeysNeedCtl_
h5. Other _standard.ini_ changes
h2. Appendix B: Hardware Notes
\\
{commenthide-from:groups=ephus-users|users=@anonymous}
{hide-from}
{include:%content:title%}
{report-body}
{report-block}
{cache} |
Page History
Overview
Content Tools