Versions Compared

Key

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

...

Description of the GUIs

LCLS Xtc Explorer

xtcexplorer will launch the main GUI. It currently At startup, it has two sections:

  • File section: Shows a list of currently selected file(s). As you may have guessed, "File Browser" opens a file browser and Please be adviced that you should only select a single run at a time (or combine runs where you know the setup / configuration is the same). A single run is typically spread over several XTC files (divided into streams (-s0X) and chunks (-c0X)).
    A "Clear File List" clears removes all filenames from the current list of files. This section also allows you to add a file name by hand (or paste).list.
    You have three options for adding files:
    1. You can supply file names at the command line when launching the application.
    2. A "File Browser" button opens a file browser, where you can select one or more files.
    3. Or you can type file name by hand in the input line.
  • Scan section: Once you are done with selecting files, you should push one of the "Scan" buttons to connect and scan the files. If the file is large, the "Scan File(s)" button will be disabled. Push the "Quick Scan" to get a summary of the file contents.
    Scan section: The two buttons to the left allows you to scan the xtc file to get a summary of what datagrams are stored in it. Note, for most purposes, a "Quick Scan" is sufficient. If you need to scan the whole file, e.g. if you want to know the total number of events, number of calibration cycles, etc, you can enable the "Scan File(s)" button. If the files are big, this will take a lot of time...

The main window before any file selection. Click on "File Browser..." to select file(s).

A standard file browser pops up. Navigate the file browser till you find the xtc files for your experiment. (Remember, if this seems cumbersome, you can also give the file name(s) as argument to xtcexplorer when you first launch the GUI)

Mark the files you want to look at (Hold down the Ctrl-key to select more than one file). Note, you should only look at one run number at a time, since different runs might have different configurations.

This is the main window after a file has been selected. File name and file size is shown in the GUI. If the file is not too big, you can click the "Scan File(s)" button to get exact contents of the whole file. If the file is big, it's better to do a "Quick Scan" which will tell you all you need to know (except count number of events and calibration cycles).

...