...
The correlation plot GUI functions as a device to manipulate, measure and correlate various physical quantities that govern LCLS beam quality. It may read, move and measure any process variables (PVs) that exist in an IOC (as long as the IOC is ON). PV format is usually, DEVICE:MICRO:UNIT#:DESCRIPTION. Correlation plot allows for 2 PVs to be controlled during a measurement of any number of other PVs and plots the result(s). It can drive a bunch length measurement, wire scanner, emittance application and the lclshome Profile Monitor individually.
https://confluence.slac.stanford.edu/index.php/Image:Corplot1.jpg
...
RED BOX!
...
Corplot3.jpg Image:
...
Corplot3.jpg
- CONTROL PV NAME is the process variable name of the device that you would like to change during your scan. After typing the name in the box, press "ENTER". If the PV is real (correct name), you will see the "Current" and "Initial" values of the PV show up underneath the "Control PV Name". If they do not chnage from NaN (Not a Number) you have an incorrect name or the PV does not exist.
...
- SAMPLE DELAY(s) is the time in seconds the GUI will wait before taking the next sample point after the previous sample.
BLUE BOX
...
!Corplot4.jpg! Image:
...
Corplot4.jpg
- START SCAN will start the scan of the PV(s), at this point the initial settle time will start to count down. If this is not the first scan a window will pop up asking you if you want to discard or save the data (to disk) previously generated. You may want to save the data, although pressing "LOGBOOK" should do this automaticly.
...
- LOGBOOK sends the generated plot(s) to the lcls-physics logbook and saves a copy to disk automatically. An image will be exported to the front of the desktop.
GREEN BOX
...
!Corplot5.jpg! Image:corplot5.jpg
- PROFILE MONITOR is a pull down menu of profile monitors used for LCLS. This can be driven by correlation plot to calculate beam statistics such as x and y size, rms and beam profile. Once started, you will get a figure plotting x (um), y(um), the beam X section and a small list of stats. A "# BG" box will appear for you to select the number of background images for the measurement.
...
- BUNCH LENGTH is a pull down menu of profile monitors capable of measuring longitudinal beam size (Z hat) using the TCAV application driven by the correlation plot. When started, the TCAV application will be called and a streaked beam (long in Z hat) will be incident on the profile monitor selected.
- FORCE check box
YELLOW BOX
...
!Corplot6.jpg!
- Plot Header will name the plots, M-files and configs generated by the gui. The name will also contain the date and time stamp corresponding to when they were saved.
...
- U Axis is used for the 3D plots that can and may be generated. X, Y, U. PVs from the Read PV List and entered in the Formula box will also show up in the U Axis pull down menu.
ORANGE BOX
...
!Corplot12.jpg!
- Read PV Listis a list of PVs to be read in by correlation plot. You may type (press enter when done) or drag PV names into this field.
- Random Order when checked,
- Pull Down Menu allows operators to choose the rate at which the read PVs are sampled if they are beam synchronous acquisition (BSA) PVs. The settle time vars have no effect when a rate is selected. Options are: 1, 10, 30 Hz.
- Slider under the PV list shows the current value and name of the control PV during the scan. The left most position corresponds to the starting value (Ctrl PV Low).For each step the ctrl PV is moved, the slider will move to the right until it reaches the ending value (Ctrl PV High) which is the right most slider position.
- Sample Slider allows you to view single sample points for a given value of the control PV. If the GUI measures n points (samples) before changing the control PV, (and AVG is not selected) you may view these points individually on the plot by sliding the slider.
- Method Select is a slider with 7 options of methods to fit the data plotted.
- 1 = Gaussian
- 2 = Asymetric Gaussian
- 3 = RMS
- 5 = RMS Cut Peak
- 6 = RMS Cut Area
- 7 = RMS Cut Floor
- 3D Pull Down Menu exports an image with plotted data in one of three options: 3D, surface or scatter plots. Uses the U Axis.
- Fit Pull Down Menu gives you a choice for fitting your data. Polynomial (choose the order), Gaussian, Sine and Parabola.
- Show AVG when checked will avg the number of samples for one value of the control PV and plot a single data point with error bars. When left un-checked, the plot will show each sample individually for each value of the control PV.
- Order is the order number used for the polynomial fit.
PLOTS
...
!Corrplot2.jpg!
The top graph is utilized only when needed to show additional or supplemental information regarding the primary scan of the slow and/or fast control PVs. This is an example of a single OTR measurement
Henrik Loos's TalkRetrieved from "http://ad-linux04.slac.stanford.edu/index.php/Correlation_Plots_GUI"