Versions Compared

Key

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

...

  1. Wiki Markup
    From lclshome -> User Dev Displays panel. !image:lclshomeUserDev.jpg|thumbnail!
  2. Wiki Markup
    Run one of the matlab scripts xalRunModel or xalGetModel !image:userDevPnl.jpg|thumbnail!
     *xalRunModel* simply runs the model and creates the upload files
     *xalGetModel* is as xalRunModel, but additionally returns ("gets") the model data to your matlab session. It also creates model plots. 
    Either of these buttons will start the corresponding matlab script...
    !xalGetModel.jpg|thumbnail! ... which immediately prompt for you to *Select a beamline*: !image:selectabeamline.jpg|thumbnail!
    \\
    The following is a run-through of running xalGetModel for the Extant machine. [Click here to see the full transcript of this example|^xalGetModelRun.jpg].   
    The procedure is as follows:
    1. For example, select "Cathode to Dump" (as shown in the example above). 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.
    2. Wiki Markup
      *Select whether to "Run extant machine or design model? (x/d) \[d\]:*". Hit x or d, and RETURN.
       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.jpg|thumbnail!
      *Stages of running the (extant) model are as follows:*
      • Wiki Markup
        *1) "Initial Twiss"* is displayed. Check the initial conditions which will be used for the model run. !image:extantinitconditions.jpg|thumbnail! These are presently taken from the SLC marker point 80. You can check these at any time with AIDAWeb ([MARK:VX80:80//twiss MODE=5|https://seal.slac.stanford.edu/aidaweb/dispatchQuery?Query=MARK%3AVX00%3A80%2F%2Ftwiss+MODE%3D5&Query+Action=Get+Data]; the values are Energy (GeV), psix, betax (m), alphax , etax (m), etax', psiy, betay (m), alphay, etay (m), etay')
        If these appear fine, then confirm to continue.
      • Wiki Markup
        *2) "Run LEM 'Lite'"*. This will calculate and display the fudge factors and predicted energy. When it has completed, _check in particular that the final energy at the undulator_ (see Energy comlumncolumn, and the row of output labelled "BSY") is reasonable, e.g. 9.25 GeV. If energy appears fine, then confirm to continue.
        !image:checkenergies.jpg|thumbnail! 
      • Wiki Markup
        *3) "Run XAL machine model."* This can take up to a minute to execute, so please be patient. When it has completed, if you ran xalGetModel, you should get 3 plots - the dispersion, betas, and energy vs Z. The plots may overlap, and the energy plot is on the bottom, so move the others to check it.
        !image:energyGraph.jpg|thumbnail!
      • 4) "Create MAD patch file". This stage is always entered, you don't need to do anything. It only takes a moment to create these.
      • Wiki Markup
        "Create and upload XML model files to Oracle? (y/n) \[n\]: " If it all looks good, and you want to upload to Oracle, say "y".
        !image:oracleuploadprompt.jpg|thumbnail! 
      • 5) "Run XML writer." If you said "y" to create the upload files, you'll now see "Run XML writer." This is where the file containing the model results to be uploaded to Oracle, is created. This also takes half a minute or so.
        When it has completed, you should see that 3 files have been created: E.g.
        Code Block
        /u1/lcls/physics/onlinemodel/xal/xalElements_20090120_115855.xml created
        /u1/lcls/physics/onlinemodel/xal/xalDevices_20090120_115855.xml created
        /u1/lcls/physics/onlinemodel/xal/xalModel_20090120_115855.mat created
        
    3. Upload the XAL model online on the web.
      The last part of xalGetModel gives some tips of uploading. It remins you where to find the model files in the browser, and the URL of this help. See next the section of help with uploading the model files.

Anchor
uploading
uploading
Uploading the XAL model files

...