Podd version 1.6.0

The Hall A software team is pleased to present version 1.6 of the C++ analysis software Podd. This version contains many significant improvements motivated by the long experience with version 1.5.

Version 1.6 is not binary compatible nor fully source-compatible with the previous release 1.5. Several parts of the programming interface have changed. As a result, libraries and plug-ins for version 1.5 will have to be recompiled and, in some cases, minor source code changes may be necessary.

As much as possible, the bug fixes as well as some of the additional functionality of this release will be) backported to version 1.5. We plan to support version 1.5 for several years into the future because many earlier Hall A experiments have spent considerable effort on developing complex libraries for this release. They should not be forced to upgrade. For new development, however, version 1.6 is strongly recommended.

The main improvements in this release are the modular decoder, the unbundled EVIO library, and a partial rewrite of the VDC reconstruction code. Additionally, all analysis classes now use the new database API that was introduced in version 1.5 and has been generalized since then.

What's new

• All analysis objects (detectors, spectrometers, etc.) that are part of the core analyzer now use the LoadDB database API, which reads database files in key/value format. This means that existing fixed-format databases for these detectors etc. must be converted to the new free-format key/value style. Release 1.6 includes a conversion program, dbconvert, that automates this task as much as possible. Please see the documentation for details.
• The EVIO subsystem is loaded from an external shared library. This brings support for the latest version of EVIO (currently 4.4.6) and permits updating of EVIO without having to rebuild the core analyzer. If EVIO is not installed on the user's system, the analyzer build system will attempt to download and install it automatically.
• The decoder has been rewritten to support drivers for front-end hardware as plug-ins. New decoding routines for new hardware can be added easily via user-written shared libraries. Documentation can be found here
• The new decoder makes the processing of different event or trigger types configurable via "event type handler" plug-ins.
• Preliminary support is available for JLab 12 GeV pipelined electronics (FADC250, F1TDC, etc.)
• The generic hardware channel decoder, THaDecData has been completely rewritten, using an object-oriented design.
• The track reconstruction of the VDCs of the Hall A HRS spectrometers has been partly rewritten. Known bugs have been fixed. The reconstruction of multi-cluster events should be greatly improved.
• The VDC efficiency calculation code has been moved from THaDecData into a standalone physics module, VDCeff.
• Many limitations of the formula and test package have been removed. It is now possible to define formulas and tests on variable-sized arrays, including std::vector global variables.
• Explicit support for simulation input data has been added, simplifying the handling of Monte Carlo truth data (base class Podd::SimDecoder).
• The analyzer can now be built with the SCons build system. In fact, this is the preferred build system now.
• Support for ROOT 6 and current compilers.
• Compatibility with macOS. The analyzer has been tested on macOS 10.6 (Snow Leopard) through 10.13 (High Sierra) with the matching command line tools for Xcode. A full installation of Xcode is not required.
• Miscellaneous minor bug fixes.

Compatibility

System requirements

• Linux with gcc/g++ 4 or higher; or Mac OS X 10.6 or higher with Apple's command line tools for Xcode (providing gcc/g++ or clang/clang++). Both 32-bit and 64-bit platforms are supported.
• ROOT 5.10 or higher, including ROOT 6. Version 6.12/06 or newer recommended.
• GNU make or SCons
• Reasonably powerful hardware (2GHz CPU, 2GB RAM). Less may work, but it won't be fun.

• RedHat Enterprise Linux 5, 6 and 7
• Fedora 14 through 25
• Ubuntu 12.04 LTS (Precise) and 14.04 LTS (Trusty)
• Mac OS X 10.6 through 10.13

Building and installing the software

Running the program / How to analyze data

Example Scripts

Documentation

Credits