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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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