1. LCLS Commissioning & Operations High Level Software
PAL XFEL MAC Meeting
Henrik Loos
November 19, 2014

2. LCLS Commissioning Strategy
Hardware
Extensive pre-beam check-out (field probes for magnets etc.)
Check every device again with beam (functionality, polarity, calibrations, etc.)
Software
Need basic commissioning software on day 1 (beam orbit, size, emittance, bunch length, etc.)
Test software on virtual accelerator controls environment
Procedural HLAs for common task automation develop later
PAL XFEL MAC Meeting / Nov 19, 2014

3. General Controls Software
LCLS now has all Epics device controls
EDM screens, strip tool, alarm handler, etc.
Java applications
Oracle database
Configuration control (SCORE)
Archive engine
Machine model (XAL)
Beam orbit display
Matlab applications
High level software
Some Python also
PAL XFEL MAC Meeting / Nov 19, 2014

4. Matlab Commissioning and Operations Software
High Level (Physics) Applications developed in Matlab during LCLS-I commissioning by physicists
Quick to adapt changes, test in commissioning
Large suite of matured software after 7 years
Used in daily LCLS operation
3 levels of Matlab software
about 80 GUIs
~20 background scripts
low level services
Control system interface
EPICS (labCA) & Aida (Accelerator Independent Data Access)
PAL XFEL MAC Meeting / Nov 19, 2014

5. Matlab HLA GUIs Beam property measurements Beam corrections
Configuration control
Undulator & FEL
Others
PAL XFEL MAC Meeting / Nov 19, 2014

6. Matlab HLA Architecture
† SLC Control Program
LabCA
AIDA*
Control Systems
*Accelerator Integrated Data Access
High Level Applications
EPICS IOCs
Name
Server RF
Magnet
Real-Time Model
Model
XAL Model
SCP†
SLC Model
CA Simulation
Profiles
Images
PAL XFEL MAC Meeting / Nov 19, 2014

7. Basic Linac Commissioning Matlab HLAs
Correlation Plot
Profile Monitors
Emittance
Bunch Length
Wire Scan
Optics Matching CA
Phase Scans
Dispersion Correction
Bowtie Plots
SVD Steering
BSA GUI
PAL XFEL MAC Meeting / Nov 19, 2014

8. Profile Monitor Interface to a variety of SLAC camera IOC types
Image processing used by HLAs needing beam profile data
Different fit functions and rms methods for beam moments
PAL XFEL MAC Meeting / Nov 19, 2014

9. Wire Scan GUI Interface to EPICS scan software Beam jitter correction
From online model
Profile analysis same as for beam images
Raw Data
Processed Scan
PAL XFEL MAC Meeting / Nov 19, 2014

10. Emittance Beam profiles from wire scans or screens
Quad scan or multiple locations
Online model input
Results stored in PVs
Used by matching software
PAL XFEL MAC Meeting / Nov 19, 2014

11. Matching Configurable sets of locations for Uses online model
Twiss measurement
Goal locations
Optimization quads
Uses online model
Input from emittance GUI
PAL XFEL MAC Meeting / Nov 19, 2014

12. Correlation Plot Generic Epics part Matlab HLA interface
Scans 1 or 2 PVs
Reads multiple PVs
Matlab HLA interface
Beam profiles, emittance, bunch length
BSA acquisition
Data analysis
PAL XFEL MAC Meeting / Nov 19, 2014

13. Other Matlab HLAs Scan of single station, entire sector or linac phase
Time calibration and bunch length
Results in PVs to be picked up by XTCAV x-ray analysis
Scan of single station, entire sector or linac phase
RF Phase Scans
TCAV Bunch Length
PAL XFEL MAC Meeting / Nov 19, 2014

14. HLA for Beam Setup Automation
~ min
~1 - 5 min
Charge Change
~15 min
Energy Ramp
Energy Change/LEM
PAL XFEL MAC Meeting / Nov 19, 2014

15. Procedural Matlab GUIs
Bunch compressor R56 control
Beam destination switching (gun/injector spectrometers)
Self seeding setup
Hard x-ray chicane and diamond control
Soft x-ray chicane and optics control
PAL XFEL MAC Meeting / Nov 19, 2014

16. Beam-Based Alignment Software
Multi-purpose beam orbit fitting
Undulator BBA
SVD orbit steering
Undulator field integral
RF kicks
Integrated simulation mode
Data taking and correction application
Manual energy change
Simulation parameters
PAL XFEL MAC Meeting / Nov 19, 2014

17. Undulator Taper Control
PAL XFEL MAC Meeting / Nov 19, 2014

18. Gain Length Measurement
PAL XFEL MAC Meeting / Nov 19, 2014

19. LINAC Energy Management
“LEM”
Provides actual machine energy profile
Fudges RF vector sum energy gain to match fixed energy locations
Used for
Online model calculation
Scale magnet strengths to actual beam energy
Implementation
Originally XAL based
Now mainly Matlab process with EPICS PV interface
Added features
Sets bend magnet trims
Options to implement energy specific optics
Implement design or scale present
PAL XFEL MAC Meeting / Nov 19, 2014

20. LEM Server Display EDM screen to display LEM calculation results
Activate Matlab script to set optimized magnet settings
PAL XFEL MAC Meeting / Nov 19, 2014

21. Machine Save Restore
Saves and restores EPICS PVs to and from Oracle database
PAL XFEL MAC Meeting / Nov 19, 2014

22. Present Online Machine Model
Master source is MAD deck, Elegant etc. derived from it
Oracle as main device database
Populated from MAD deck
Other devices manually
XAL used for “official” online model
Design, equal to MAD output
Extant, uses actual RF and magnet settings
XAL XDXF input file generated manually
Java Model GUI to run XAL, upload to database, define “Gold”
Model data access
AIDA (Accelerator Independent Data Access) to retrieve model from Oracle database
MAD/Oracle/XAL synchronization process cumbersome
PAL XFEL MAC Meeting / Nov 19, 2014

23. Java Model Manager
PAL XFEL MAC Meeting / Nov 19, 2014

24. New Online Model System
MEME (MAD EPICS Matlab Environment)
MAD deck for model computation
Patch files to update device properties with actuals
Matlab used as GUI interface
Model runs uploaded to Oracle
EPICS V4 services
Retrieve online model data
Directory service (get device name lists based on MAD lines)
Possible extension to archive data and other data services
EPICS V4
Integration of high level control services beyond device IOCs
Adds structured data types to EPICS
Query with options and qualifiers
Greg White
PAL XFEL MAC Meeting / Nov 19, 2014

25. Summary Matlab convenient platform to develop GUIs and to analyze data
Simulation of control system and measurement data reduces development time in control room
Script automation saves enormous time in machine commissioning and tuning
PAL XFEL MAC Meeting / Nov 19, 2014