Page History
Include Page | ||||
---|---|---|---|---|
|
Table of Contents |
---|
Include Page | ||||
---|---|---|---|---|
|
xtcexplorer (GUI interface to pyana)
...
This is a description and documentation of a GUI tool to explore the XTC data (see Analysis Workbook. Data Formats). The executable is named xtcexplorer, and the software package is named XtcExplorer. The GUI is written in Python/PyQt, while the data is extracted using the LCLS framework pyana (we're currently in process of switching to using psana for this). Visualization of data is obtaned with the plotting package matplotlib, while much of the data algorithms in python relies on NumPy / SciPy libraries.
...
For a similar tool to explore the HDF5 data format, look at HDF5 Explorer - Old.
How to get started
- Set up your release work directory:
You should always run this code from your own release working directory.
See Account Setup for more details on how to set up the analysis environment:Code Block none none [user@pslogin ~] newrel ana-current myrelease [user@pslogin ~] cd myrelease [user@pslogin myrelease] sit_setup
- Check out the
XtcExplorer
package from the SVN software repository:
This step is optional. But without it, you will not be able to edit/customize any source files.
You need an afs token to check out the package, which onpslogin
is automatic (I think), but if you're on psananeh/psanafeh, issue akinit
command first:
Now you're ready to check out the package and "compile":Code Block none none [user@pslogin myrelease] kinit Password for user@SLAC.STANFORD.EDU:
Note! You can also do 'Code Block none none [user@pslogin myrelease] addpkg XtcExplorer [user@pslogin myrelease] scons
addpkg XtcExplorer VXX-XX-XX
' to get a specific version of the package, or 'addpkg XtcExplorer HEAD
' to get the very latest version. - Run the program:
Launch the GUI with the command 'xtcexplorer' and optionaly 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 topsananeh/psanafeh
for this:Code Block [user@psanaXXX myrelease] sit_setup [user@psanaXXX myrelease] xtcexplorer /reg/d/psdm/CXI/cxi22010/xtc/e60-r0465-s0*
...
More information on how to run pyana by itself (see 'pyana -h' for more help, or the pyana section of confluence).
The pyana modules
...
Once you've identified the command line to run your pyana job, you can submit this to the LFS batch queue system as described in Computing (including Analysis).
Be aware that the pyana scripts used by the explorer use matplotlib QtAgg backend to display plots, and this will fail if you submit it to batch processing. While I look for a better solution, you can do the following to work around this problem:
...