Versions Compared

Key

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

...

XtcExplorer (GUI interface to pyana)

Info

This page describes the package XtcExplorer V00-01-04.
XtcExplorer V00-01-05 is currently available in the release (ana-0.3.7, at time of writing this is the same as ana-current),
which means you don't need to check out this package to use it. Simply type 'xtcexplorer' to try it out.
This webpage will be updated shortly to reflect the latest tag. For now, the current page should have sufficient info to get you started.

Note! This package is a new version of the "XtcEventBrowser" which is the old name of the package.

This is a description and documentation of a GUI tool to explore the xtc data. It is written in python, relying on PyQt4 for graphical user interface. The data processing is done via the pyana framework and visualization provided by matplotlib. It can be run on any xtc file, including the file being written during data aquisition (DAQ).

...

  1. Set up your release work directory:
    You should always run this code from your own release working directory. It might work from other directories, but be aware that configuration files will be written to your current directory. Look out for files with names xb_pyana_XXXX.cfg, where XXXX is a random four-digit number. You can use them to run pyana directly from the command line. But they accumulate, so you might want to remove these regularly... from your own release working directory.
    See the Account Setup section to set up the analysis environment. Set up your release working directory from pslogin:
    Code Block
    none
    none
    [user@pslogin ~] newrel ana-current myrelease
    [user@pslogin ~] cd myrelease
    [user@pslogin myrelease] sit_setup
    

  2. Add the package:
    Next you want to add the XtcExplorer package to your analysis release. Once the package exists in the release, this will be optional. But you might want to have a local copy anyway to be able This step is optional. Since release ana-0.3.7, xtcexplorer has been built into the release so you can skip to (3).
    Checking out a local copy is beneficial, though! That will enable you to edit the source files to tweak your and customise the analysis.
    Note that you
    You need to have an afs token to check out the package, so if you didn't already you need to run 'kinit' first:
    Code Block
    none
    none
    [user@pslogin myrelease] kinit
    Password for user@SLAC.STANFORD.EDU:
    
    Now you're ready to check out the package and "compile":
    Code Block
    none
    none
    [user@pslogin myrelease] addpkg XtcExplorer V00-01-0405
    [user@pslogin myrelease] scons
    
    Note! You can If you omit the "tag" (VXX-XX-XX) to , you'll get the same version that's built into the release.
    Sometimes a more recent version exists. To get the latest and greatest version in the svn repository,
    instead do 'addpkg XtcExplorer HEAD', but this be aware that it may look different from described here, and
    might have more problemsfresh bugs as well as new features.

  3. Run the program:
    Launch the GUI with the command 'xtcexplorer' and optionally give the input xtc files that you want to read
    as arguments. You can also browse to find files after launching the browser.

    To have access to the xtc files, you need to login to psana for this:
    Code Block
    [user@psanaXXX myrelease] sit_setup
    [user@psanaXXX myrelease] xtcexplorer /reg/d/psdm/CXI/cxi22010/xtc/e60-r0465-s0*
    

...