Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This page describes the process of running an XAL model of the LCLS accelerator, and uploading that model to Oracle, from where it can be accessed by Matlab and Java applications through AIDA.

Run a model

To run an XAL model, you can use the interactive matlab scripts xalRunModel.m or xalGetModel.m. These can be run directly from matlab, or from lclshome (as described below). The basic process is the same in either case - xalGetModel additionally plots dispersion, betas, and energy.
Summary of running the model:

  • Select a beamline to be modelled
  • Decide whether to run extant or design model
  • If "extant", run LEM lite, to check energy profile
  • Run the XAL model
  • unmigrated-wiki-markup
    \[IF you ran xalGetModel, then inspect the model plots \]
  • Run the XA XML Writer (to create the model upload file)
  • Upload the model to the database
    Note: there is no "back" facility. Just abort (ctrl-c to get to the matlab prompt, and start over).

Running a model in detail

  • From lclshome -> User Dev Displays panel.
  • run Run one of the matlab scripts xalRunModel or xalGetModel.
    • Wiki Markup
      xalGetModel.
      !image:xalGetModel.
    • jpg|thumbnail!
      • Wiki Markup
      xalRunModel
      • Select a beamline.

        
         For example, select "*Cathode to Dump*" This runs the LCLS "Full Machine" model, from the LCLS Cathode to the main Dump. See [Why are all models from Cathode to some location|#whysameloc].
        !image:selectabeamline.jpg|thumbnail!
      • Wiki Markup
        Select whether to "*Run extant machine or design model? (x/d) \[d\]:*".
         Running the "design" model (choice "d") causes the XAL model to be run with the element setpoint values in the model input files. Those design setpoint values are, [to the extent possible, identical to the MAD design|#modeldiffs]. Running the "extant" model (choice "x") will cause the model execution to first replace the design values of beamline devices, with the actual readback values, as acquired through EPICS and AIDA, prior to running the envelope tracker.  That is, "extant" is equivalent to what was called "DATABASE" in the SLC modelling system,; it describes the extant machine at the time the model is run.
        !image:xalGetModelextant|thumbnail!
      • Check the initial conditions which will be used for the model run. These are presently taken from the SLC marker point 80. You an check this with AIDAWeb beforehand ( MARK:VX80:80//twiss MODE=5
    • xalGetModel

Model Notes

Anchor
whysameloc
whysameloc
Why are all models from Cathode to some location?

...