Last modified: Mon Apr 9 09:00:00 PDT 2018
SLAC National Accelerator Laboratory LCLS-II High Energy (HE) Lattice
 Accelerator Directorate  LCLS-II-HE Project Site  Lattice Descriptions  LCLS-II-HE Device Database

This is the home page of the lattice descriptions of the proposed Linac Coherent Light Source II High Energy upgrade (LCLS-II-HE) Accelerator.

The lattice descriptions are expressed in the Methodical Accelerator Design (MAD) language (version 8), and in ELEGANT. There is also a similar page for the LCLS-II accelerator, parts of which are under construction (superconducting linac systems), and parts of which are currently being commissioned (copper linac systems).

MAD Input Files

The following are the LCLS-II-HE MAD input files in SLAC's CVS:

File Description MAD Input file name
Main command file LCLS2sc_main.mad8
Matching command file LCLS2sc_match.mad8
Master definitions LCLS2sc_master.xsif
Common definitions common.xsif
Cryomodule definitions CM.xsif
LCLS-II Injector + Laser Heater + collimation section 0 definitions INJ.xsif
Low Emittance Injector + dogleg definitions INJ2.xsif
Low Emittance Injector diagnostic line definitions DIAGI.xsif
Post-LH diagnostic line definitions DIAG0.xsif
Bunch compressor 1 + collimation section 1 definitions BC1.xsif
Bunch compressor 2 + emittance diagnostic section definitions BC2.xsif
High Energy bypass dogleg definitions DLBM.xsif
High Energy bypass (NIT) line definitions BYP.xsif
3-way High Energy beam spreader definitions SPRD.xsif
SXR/HXR LTU + dump area definitions LTU.xsif
SXR/HXR undulator area definitions UND.xsif
SXR/HXR safety dump line definitions SFT.xsif
DASEL definitions DASEL.xsif
Beam Switch Yard (BSY) beamline definitions BSYsc.xsif
SXR XTES system definitions SXTES.xsif
LCLS Main command file LCLS2cu_main.mad8
LCLS Matching command file LCLS2cu_match.mad8
LCLS Master definitions LCLS2cu_master.xsif
LCLS definitions LCLS2cu.xsif
LCLS Linac 1 as built LCLS_L1.xsif
LCLS Linac 1 for Elegant LCLS_L1e.xsif
LCLS Linac 2 as built LCLS_L2.xsif
LCLS Linac 2 for Elegant LCLS_L2e.xsif
LCLS Linac 3 as built LCLS_L3.xsif
LCLS Linac 3 for Elegant LCLS_L3e.xsif
LCLS BSY to SXR definitions CUSXR.xsif
LCLS BSY to A-line definitions ALINE.xsif
LCLS Beamline definitions BSYcu.xsif
HXR XTES system definitions HXTES.xsif

MAD Output Files

The MAD output results of the above files, are in directories under /afs/slac/www/grp/ad/model/output/lcls2he/mad/. Those output directories containing files resulting from official lattice releases, are named after their release date in the form ddMMMyy, eg "07JAN16". The date string is also used as the CVS tag of their release. The data of official releases should also be found in the Oracle database (see below). Additionally, the latest output is always in /afs/slac/www/grp/ad/model/output/lcls2he/mad/latest/. Note that the "latest" link may contain results from lattice development following the last release - so it is not necessarily the output of the most recent official release. That is, "latest" may contain updates to files in an official release.

ELEGANT Input Files

The following are the LCLS-II-HE ELEGANT input files in SLAC's CVS:

File Description ELEGANT Input file name
CM01 exit to SXR dump (high energy) commands LCLS2scS.ele
CM01 exit to SXR dump (high energy) definitions LCLS2scS.lte
LH undulator MATRIX definition UMHTR.rmat
XLEAP undulator segment MATRIX definition UMXL.rmat
SXR undulator segment MATRIX definition UMASX.rmat
SXR phase shifter MATRIX definition PSSX.rmat
CM01 exit to HXR dump (high energy) commands LCLS2scH.ele
CM01 exit to HXR dump (high energy) definitions LCLS2scH.lte
HXR undulator segment MATRIX definition UMAHX.rmat
HXR phase shifter MATRIX definition PSHX.rmat
100 pC SC linac input beam definition (F. Zhou) FZ_100pC_10NOV17.sdds
250 pC Cu linac input beam definition (Y. Ding) WS02_250pC_rescaleto540um_solGTF1M_flat.out
1.3 GHz longitudinal wakefield definition zWake_1.3GHz_OneCavity_dz2um_TESLA2003-09.sdds
1.3 GHz transverse wakefield definition xWake_1.3GHz_OneCavity_dz2um_TESLA2003-09.sdds
3.9 GHz longitudinal wakefield definition zWake_3.9GHz_OneCavity_dz2um_TESLA2004-01.sdds
3.9 GHz transverse wakefield definition xWake_3.9GHz_OneCavity_dz2um_TESLA2004-01.sdds
2.856 GHz longitudinal wakefield definition Sz_1um_75mm.sdds
2.856 GHz transverse wakefield definition Sx_1um_75mm.sdds
resistive wall wakefield definition Al5mmgap_flat_0p5um10mm.sdds
resistive wall wakefield definition Cu_17.4mmR_100nm3mm.sdds
resistive wall wakefield definition SS_17.4mmR_100nm_3mm.sdds
resistive wall wakefield definition SS_24.5mmR_100nm3mm.sdds

ELEGANT Output Files

The output results of "official" ELEGANT runs are in timestamped directories under /afs/slac/www/grp/ad/model/output/lcls2he/elegant.


Modelled element and device data of LCLS-II-HE are also available in SLAC's Oracle Database. See the Elements and Symbols tabs (they contain largely the same information).

Optics Plots

These are the Twiss parameter plots for each beampath. Click on an image for the set of plots of that beampath.

Superconducting linac (from LCLS-II gun) related optics:

CM01 exit to SXR dump
CM01 exit to HXR dump
CM01 exit to BSY dump
CM01 exit to DIAG0
CM01 exit to DASEL

Superconducting linac (from Low Emittance Injector gun) related optics:

CM00 exit to SXR dump
CM00 exit to HXR dump
CM00 exit to BSY dump
CM00 exit to DIAG0
CM00 exit to DASEL
CM00 exit to DIAGIS

Warm copper linac (from LCLS gun) related optics:

Cathode to HXR dump
Cathode to SXR dump
Cathode to A-line


The following are descriptions of each electron beam traversal through the LCLS-II-HE accelerator complex. These include both the paths relating to superconducting accelerating structures (those originating at CM01 exit and those originating at CM00 (LEI) exit) and the original warm copper related paths (those originating at the LCLS-I cathode).

Beampath Table: Primary RF refers to the technology used for radio frequency structures of the primary acceleration of the beamline; "SC" = superconducting, "Cu" = warm copper. Status refers to the administrative standing of the beampath. MAD filename prefix refers to the filenames of the MAD output relating to the beampath. The Beampath ID is the unique tag of the beampath understood by the MEME directory service. The maps are zoomable PDF. Middle-click to download, open with for instance Adobe Reader (zoom in with for instance View ↳Zoom ↳ Pan and Zoom). The maps show the all modelled elements of the LCLS-II mad deck, including devices (where the element has one), markers etc, with their suml and Z positions, arranged left to right by Z and hierarchically by modelled line. Arrows link the elements to show the path of the beam from element to element through the machine.
Primary RF Description HE upgrade Status MAD output filename prefix Beampath ID Elements / devices file (None yet) Map Link
SC LCLS-II gun to SXR dump Proposal LCLS2scS SC_SXR
SC LCLS-II gun to HXR Proposal LCLS2scH SC_HXR
SC LCLS-II gun to BSY dump Proposal LSCLS2scD SC_BSYD
SC LCLS-II gun to DIAG0 Diagnostics line Proposal DIAG0 SC_DIAG0
SC Low Emittance Injector gun to SXR dump Proposal LCLS2scS2 SC_SXR2
SC Low Emittance Injector gun to HXR Proposal LCLS2scH2 SC_HXR2
SC Low Emittance Injector gun to BSY dump Proposal LSCLS2scD2 SC_BSYD2
SC Low Emittance Injector gun to DIAG0 Diagnostics line Proposal DIAG02 SC_DIAG02
SC Low Emittance Injector gun to DASEL Proposal LCLS2scDA2 SC_DASEL2
SC Low Emittance Injector gun to DIAGI Diagnostics line Proposal DIAGIS SC_DIAGIS
Cu LCLS gun to HXR dump Proposal LCLS2cuH CU_HXR
Cu LCLS gun to SXR dump Proposal LCLS2cuS CU_SXR
Cu LCLS gun to A-line Proposal LCLS2cuA CU_ALINE

No devices are as yet assigned to LCLS-II-HE. These lines files and maps were created using an awk script mad2dot.awk. mad2dot takes as input the print and survey files as output from Mad (see header of mad2dot), plus one or more "elementdevices" files. mad2dot creates a "lines" file for each beampath (for consumption by the directory service, so on-line apps know the device-line hierarchy), and a dot file, for instance, for each beampath. We then use the unix command dot, or Graphviz, to create a PDF from the dot file.

Publication Guide

For those people who need to change the lattice files, there is a README in CVS, in the same directory as the lattice files. That README describes how to do the CVS, and use a makefile to publish the output files to /afs/slac/www/grp/ad/model/output/.

SLAC homepage Operated by Stanford University for the U.S. Dept. of Energy Office of Science
Page Owners: Greg White and Mark Woodley