Page History

...

Here we cover topics specific to the offline TimeTool module. The TimeTool results can be obtained in one of two ways depending on the experimental setup. The first is directly during data acquisition. For , the second is during offline analysis using the psana module TimeTool.Analyze. Regrading data acquisition, for data recorded prior to Oct 13, 2014, the timetool results were always recorded as EPICS PV's. After Oct 13, 2014, they are still recorded as EPICS PV's, but also recorded in their own data type: TimeTool::DataV*. The version increments as the time tool develops. For data recorded up to around November 2014, this was DataV1. Around December of 2014 it changed to DataV2. The latter is the preferred way to access the data, preferred method of accessing the data is through the high level DataV* objects, but users must take care to use the correct type. EPICS PV's are still provided for backward compatibility. The second is during Regarding offline analysis using with the psana module TimeTool.Analyze . Similarlypsana module, similarly to the experiment data files, this module puts a TimeTool::DataV1 DataV* object in the event store. Previously, it the event store depending on the version of the software. The initial versions of the software put a collection of floats, or ndarrays in the event store (for backward compatibility, it still puts the floats in the event store). Documentation on the psana TimeTool modules can be found in the psana - Module Catalog.

The case studies below reference code in the TimeToolExamples package from the svn users repository at SLAC. The simplest way to work through these case studies is to add this package to a test release and build/run the code - potentially modifiying modifying it to run on the experimental data that you are have access to. If you are not at SLAC, downloads of the code are provides below.

...

newrel ana-current myrel
cd myrel
addpkg -u TimeToolExamples V00-00-0506
scons

If you have any trouble with the addpkg -u command, you may need to do

...

to get a kerberos ticket to access the users svn repository. This tag (V00-00-0506) has been tested with ana-0.13.4 10 and should work with later releases as well as earlier releases starting with ana-0.13.3. This is the release when the TimeTool.Analyze package started to use the TimeTool::DataV1 objectDataV* objects. It will not work with releases prior to this.

The package includes scripts in the TimeToolExamples/app subdirectory. It is intended that users will modify these scripts for their purposes.

...

The data dataset is the TimeTool::DataV1 objects. Note that when running the example from ana-0.13.10 and later, you will see a DataV2 instead of DataV1. If you get a verbose listing of this dataset, you'll see something like:

...

This shows you the six fields with the TimeTool DataDataV1 (there may be more if you are working with DataV2 or later), and also the enum values for the first field that identifies the event type.

...