TkI - The Perl/Tk Interface to Online Version November 6, 2019 by Thorsten Kracht Contents 1 The Introduction 6 2 Acknowledgments 7 3 Whattodo,if... 8 3.1 GRA GCI:Usedmemory¿90%oftotalspace . ........ 8 3.2 online -tki: START TIMER:T1isbusy................................. 8 3.3 online -tki: no file scan list.pl ...................................... 8 4 News 9 5 General Remarks 11 5.1 CommandLineOptions.............................. ............ 11 5.2 Tango: Alternative online.xml . ................. 11 5.3 Tango: Use tags for selecting devices from .xml file . ...................... 12 5.3.1 Tags,usecase1:detectors . ............. 13 5.3.2 Tags, use case 2: user vs. expert view . ............... 13 6 The Toplevel Widget 15 6.1 TheStartupScriptTkIrc.pl. ................ 15 6.2 TheFileMenuButton ............................... ........... 16 6.3 TheScanMenuButton............................... ........... 17 6.4 TheDiffMenuButton ............................... ........... 17 6.5 TheMiscMenuButton............................... ........... 17 6.6 TheOptionsMenuButton ............................ ............ 19 6.7 TheTableMenuButton .............................. ........... 20 6.8 TheDiagMenuButton............................... ........... 21 6.9 SelectableApplications . ............... 23 6.10 BeamlineSpecificCode . ............. 24 6.11 StopFunction................................... ............ 24 7 Scans 29 7.1 TheScanWidget................................... .......... 29 7.1.1 ’PrepareRegions’Menu. ........... 30 7.1.2 Scan’Options’Menu ............................. ......... 31 7.1.3 Scan’Utils’menu ............................... ......... 33 7.1.4 Scan’Types’menu............................... ......... 34 7.1.5 Scan’Flags’menu............................... ......... 35 7.2 The ’Scan Device Selection’ Menu . ............... 40 7.2.1 TheWidget..................................... ....... 40 7.2.2 VirtualCounters ............................... .......... 42 7.2.3 %Spectra::data scan....................................... 42 7.2.4 Extracode ..................................... ....... 43 7.3 ContinuousScans................................. ............ 43 7.3.1 Scanintervaltoosmall. ............ 45 7.4 NexusOutput..................................... .......... 45 7.5 Performance ..................................... .......... 46 1 8 Diffractometer 47 8.1 Creating the Diffractometer Server . ................... 47 8.1.1 4-Circle ...................................... ....... 47 8.1.2 6-Circle ...................................... ....... 49 8.2 E4Cvs.E6C ....................................... ........ 50 8.3 The Diffractometer GUI (SOLEIL) . ............... 51 8.4 TheOrientation.................................. ............ 51 8.4.1 Differences: Petra III (SOLEIL) and DORIS . ................ 51 8.5 TheUBMatrixWidget............................... ........... 53 8.6 The Diffractometer Alignment Widget . .................. 56 8.7 ThehklScanWidget ................................ ........... 58 8.8 ThePerlInterface ................................ ............ 60 8.9 The.graInterface................................ ............. 62 9 Sweep 63 9.1 TheWidget ....................................... ......... 63 9.2 SweepList.pl .................................... ........... 65 9.3 SweepList.pl with device specification . .................... 66 10 Preliminary: The General Scan 68 10.1 A Template for a General Scan Module . ................ 69 11 The Move Widget 76 11.1 TheMotorPropertiesWidget . ............... 77 11.2 TheEncoderWidget ............................... ............ 78 11.3 VirtualMotors .................................. ............ 79 11.4 Slits.......................................... .......... 79 12 The MCA Widget 81 13 The DSO Widget 84 14 Beamline Specific Code by Examples 86 14.1 ’Helloworld’,Button. ............... 86 14.2 Energy ......................................... ......... 87 14.3 EntryWidgets ................................... ........... 87 14.4 Buttons,Keithley-428 . ............... 88 14.5 Motors ......................................... ......... 90 14.6 Monochromator .................................. ........... 90 14.7 hkl ............................................ ........ 92 14.8 Pilatus-300K, B1, BW4, P03, P09 . ............... 93 14.9 MAXVEncoder,Tango .............................. ........... 96 14.10Spk/Slt,Tango ................................. ............. 97 14.11VHSC005N,HVPS,ISEG. ............ 99 14.12 Lom, Compound Device, P08, Tango . ................ 100 14.13 FMB Oxford DCM, CalibrationUnits, P01, P02, Tango . ...................... 101 14.14MAR-CCD....................................... ......... 104 14.15 Hexapod, Tango, P03 . .............. 104 14.16 Analyzer, Tango, P09 . ............... 105 14.17 MultipleMotors, Tango, P09 . ................. 106 14.18 Lenses Box, Tango, P10 . .............. 108 14.19LCX,P10....................................... .......... 109 14.20 Photonic Science Camera, P03 . ................. 110 14.21 VFCADC, gain, offset and polarity . .................. 111 14.22PerkinElmerDetector . ............... 112 14.23ProsilicaCamera ............................... .............. 114 14.24MythenDetector ................................ ............. 114 14.25TwoThetaP07................................... ............ 116 14.26PCO4000Detector .. ..... ..... ..... .... ..... ..... ............. 116 14.27RoperQuadRO................................... ........... 119 14.28MarCCD ........................................ ......... 124 14.29PiezoPiE712 ................................... ............ 124 14.30GalilSlit ..................................... ............ 126 15 Symbols 129 15.1 Introduction................................... ............. 129 15.2 DORIS MCA............................................... 129 15.3 FLAG TKI STOP ............................................ 129 15.4 INTERRUPT SCAN ........................................... 129 15.5 RETURN VALUE ............................................ 129 15.6 SCAN NAME DONE.......................................... 129 16 Functions 130 16.1 Util::display text() ............................................ 130 16.2 Util::edit file() .............................................. 130 16.3 FileSelector................................... ............. 130 16.4 Util::log().................................... ............. 130 16.5 Util::prompt()................................. .............. 130 16.6 Util::refresh()................................ ............... 131 16.7 Util::yesno() .................................. ............. 131 16.8 Util::zoom() ................................... ............ 131 17 Examples 132 17.1 Access device selection in before-code, P03, Lambda . ........................ 132 17.2 Sweep with outer loop motor, P10 . ................ 132 17.3 PE image series, incl. loop over SDD positions, P02 . ...................... 134 17.4 Interrupting Perl code that was started from online -tki(P10)...................... 136 17.5 Optimizing a motor position, while the MCA menu is active(P01)................... 137 List of Figures 6.1 TheTkIToplevelMenu.............................. ............ 16 6.2 TheZoomMenu ..................................... ........ 17 6.3 TheTkIFileMenu .................................. .......... 18 6.4 TheTkIScanMenu.................................. .......... 19 6.5 TheTkIDiffractometerMenu . .............. 20 6.6 TheTkIMiscMenu.................................. .......... 21 6.7 TheMoveSlitMenu ................................. .......... 22 6.8 TheMOSTABMenu ................................... ........ 23 6.9 TheMonitorWidget ................................ ........... 23 6.10 TheMonitorConfiguration . ............... 24 6.11 ThePerlScriptsMenu ............................. ............. 24 6.12 TheTkIOptionsMenu .............................. ............ 25 6.13 SelectWorkstationViewport . ................. 26 6.14 TheTkITableMenu ................................ ........... 27 6.15 TheTkIDiagnosticsMenu . .............. 28 6.16TheVMEWidget................................... .......... 28 7.1 TheTkIScanWidget ................................ ........... 29 7.2 CM Scans (Combined Moves Scans) . .............. 31 7.3 2DScans ......................................... ........ 31 7.4 3DScans ......................................... ........ 32 7.5 TheOuterLoopList ................................ ........... 32 7.6 TheRegionsWidget ................................ ........... 33 7.7 TheEXAFSRegionsWidget . ............ 34 7.8 TheScanOptionsMenu .............................. ........... 35 7.9 TheScanParametersMenu. ............. 35 7.10 TheScanUtilsMenu ............................... ............ 36 7.11 The EXAFS Sample Scan Menu . ............ 36 7.12 TheScanTypesMenu............................... ............ 37 7.13 TheScanFlagsMenu............................... ............ 37 7.14 TheScanDeviceSelection . ............... 40 7.15 AVirtualCounter................................ ............. 42 7.16 TheVirtualCounterFileMenu . ................ 43 7.17 TheVirtualCounterVersions . ................. 44 7.18 AnExtraCodeExample ............................. ............ 45 8.1 Jive: Create Diffractometer Server . ................... 47 8.2 Jive: Diffractometer Properties . ................... 48 8.3 Jive:CreatePseudoAxis . .............. 48 8.4 Jive: PseudoAxis Properties, h, E4C . .................. 49 8.5 Jive: PseudoAxes