Versions Compared

Key

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

...

Typing xtcexplorer will launch the main GUI, which looks something like this:

You need to connect an XTC file in order to get any further. You have 4 options:

  1. You can give file names as arguments on the command line, and the file will automatically be opened/connected< e.g. xtcexplorer /reg/d/psdm/CXI/cxi22010/xtc/e60-r0465-s0*
  2. If you know the Instrument / Experiment number / run number you'd like to investigate, simply select from the pull-down menus.
  3. There's also a 'File Browser' that allows you to browse for the files you want. Be aware that many runs are split into several files, in chunks and streams, and to get a complete dataset you do need to use all of the files for a given run. It will probably 'work' for single files too, but we cannot guarantee completely synchronized date, in particular, EPICS data is stored at a different rate than 'event' (shot) data, so if you make use of EPICS PV data, use the complete dataset.
  4. Finally, you have the option of adding file names by hand.

Once a file or more has been connected, another GUI will pop up  (possibly after a short delay while the file(s) content is being investigated). This GUI displays information about the file content and help with further processing of the data in pyana.

Pyana Control Center

After scanning, a The new GUI will pop up showing (Pyana Control Center) will show you a list of detectors/devices found in the file. A little more information is written to the terminal window too.

...

Image Removed

...

.

...

Another window, the The Pyana Control Center, pops up after the file scan.

In the pyana control center, select general run options and plot options from the panel to the right, and detectors/devices from the list to the left. Once you checkmark the detectors, a new "Pyana Configuration" tab pops up over the run/plot option panel. You can always go back to the "General Settings" tab.

"General Settings" have two components: run options (number of events to run, to skip, and multiprocessing), and plot options (frequency of plotting, display mode, ipython at end job).

A note on multiprocessing: You are allowed to select how many CPUs to use, mostly to advertise this possibility when running pyana. It is not possible to interact with all subprocesses, so the XtcExplorer will only be able to make plots from one of the subprocesses.

Some more information is printed to the terminal window from which the xtcbrowser xtcexplorer was launched

Once you checkmark the detectors you want to display information from, another tab will pop up showing pyana configuration text. "Current pyana configuration": as you select devices from the list, a tentative configuration file for running pyana is written and shown in this field.

If a ControlPV is present and checked off, only a pyana_scan module will be used. All the other devices you check will be added to the input of the scan.
If no ControlPV is used, other pyana modules will be configured as appropriate to display a variety of information from the events.
If "Epics Process Variables" are checked off, another Gui appears that lists all the epics variables. Select the ones you want to display.

Press the "Write configuration to file" button once you're done. Once a file is written, a "Run pyana" button will appear.

You can further edit the configuration file by hand. If you click on "Edit configuration", the file will open in the default editor. Note! The default editor is defined in your EDITOR environment variable. Make sure it is set to your editor of choice (e.g. setenv EDITOR emacs).

"Run pyana" lauches an input GUI that shows you the runstring. You can use the same runstring from the command line. Or hit "OK" and it'll run.

After launching pyana, another button "Quit pyana" appears... If you see you need to change parameters, you can stop pyana, edit the configuration file, and start over again.

...