Restore Microscope State

Edit Delete

Details

Name	Restore Microscope State
Permalink	https://serialemscripts.nexperion.net/script/32
Category	High-Level Functions
Language	SerialEM Scripting
Description	Restores a microscope state (illumination, image shift, focus, mag, and optionally stage position) from the parameters saved by the "Save Microscope State" script
Author	Guenter Resch
Website link	https://www.nexperion.net

Version History

Version 1.0 (February 26, 2018; 569 download(s); SerialEM version ≥ 3.6)

Version 1.0

Download

This script requires additional scripts to be run – please refer to the Required Scripts section below.

Upload date	February 26, 2018
Download count	569
SerialEM version ≥	3.6

# (C) Nexperion e.U. - Solutions for Electron Microscopy 2018
# https://www.nexperion.net
# Last update February 26, 2018
# Requires SerialEM >= 3.6.x

# Parameters not covered in this version of the script include: JEOL Alpha, diffraction/imaging mode, piezo drive, filter, camera settings (inserted/retracted)

ScriptName RestoreScopeState
SuppressReports

echo
echo RESTORING MICROSCOPE STATE:

IsVariableDefined _N3SFlag
if ( $ReportedValue1 == 0)
   echo No microscope state saved, cancelled.
   echo
   Exit
EndIf

ScreenDown

echo Restoring illumination ...
SetBeamTilt $_N3SBeamTiltX $_N3SBeamTiltY
SetProbeMode $_N3SProbeMode
SetSpotSize $_N3SSpotSize
SetPercentC2 $_N3SPercentC2
SetBeamShift $_N3SBeamShiftX $_N3SBeamShiftY

echo Restoring image shift ...
SetImageShift $_N3SImageShiftX $_N3SImageShiftY

echo Restoring focus ...
SetAbsoluteFocus $_N3SAbsoluteFocus

echo Restoring magnification ...
SetMag $_N3SMag

YesNoBox Restore stage position?
If ( $ReportedValue1 == 1) 
   echo Restoring stage position ...
   MoveStageTo $_N3SStageX $_N3SStageY $_N3SStageZ
   TiltTo $_N3SStageA
EndIf

NormalizeAllLenses
SetBeamBlank 0
ReportColumnOrGunValve 
if ( $ReportedValue1 != 1 )
   Pause Column valves are not open!
endIf

echo DONE.

Required Scripts

The following scripts are required to run this script, either because the are called directly or they provide functions:

Save Microscope State

Documentation

The state of the microscope is saved to persistent variables that live as long as a SerialEM session (regular variables only live as long as the script is running).

Various microscope parameters are not implemented yet, see comments in script.

License

This code can be shared and adapted under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0) License (https://creativecommons.org/licenses/by-nc-sa/4.0/)