...

Below we discuss the new translator, which is called psana-translate. The input and output formats have not changed between o2o-translate and psana-translate, however if filtering events with psana-translate, the h5 output file will include new groups discussed below.

Running the Translator

There are three ways to run the translator

...

If the Interface Controller

...

has been configured to run psana-translate

...

, then psana can be run through the interface controller.

Otherwise, run psana-translate as you would any other psana module. Either through psana command line options or writing a psana configuration file.  The module is Translator.H5Output.

...

When using the psana command line

...

The interface to run the module, the only option that is required to give to the Translator is the name of the output file.  This must be a fully qualified filename, with the output directory.  For example:

...

The easiest way to try different translator options to write a psana.cfg file.  Copy the file default_psana.cfg that is included below (this is also in the Translator package directory) and modify option values that you wish.  The file default_psana.cfg includes extensive documentation on all the translator options.One can also use the command line tool psana-translate.  This is similar to running psana from the command line, but will have a shorter command line when setting many of the Translator options. psana-translate is run as

   psana-translate [simple psana arguments] [--modules=...] --output_file=h5outfile [optional H5Output options] input files

For example

   psana-translate -v -v -n 5 --output_file=output.h5 --store_epics=no --Epics=exclude Control=exclude src_filter="exclude NoDetector.0.Evr.2" /reg/d/psdm/mec/mec01/xtc/e01-r001-s0*-c0*.xtc

would use psana options to get debugging output and only read the first 5 events from the mec01 run1 files. Then it uses translator options to exclude all epics data, as well as the Control types (Psana types that start with ControlData::ConfigV) and it excludes data coming from the src NoDetector.0.Evr.2).  Note the use of double quotes to specify the multiword value for the src_filter option.

New Features

With psana-translate, you can

...