Release Notes for COBRA 8.1.0

Overview

This is the release 8.1.0 of COBRA. It includes Porting, CARF, Utilities, GeneratorInterface, ClassReuse, DDD, MagneticField, Mantis, Profound, DaqPrototype and Visualisation.

Functionality and interface in line with production of DST requirements.

Major difference w.r.t previous releases

Introduction of namespaces for CLHEP 1.9.1.2, SEAL 1.4.3 and POOL 1.8.1 and Geant4 6.2.p02.clhep1912. Please refer to the individual sub-system release notes for further details and to the Savananh portal for the full list of bug fixes applied.

Binary support

COBRA exports its bin directory of the release area which is added to the runtime path.
pre-bound libraries (modules) are located in its module directory of the release area. Python modules are built and located in the lib directory. lib and module are added to the PYTHONPATH.
A python start-up cobrash script (including Cobra bootstrap) is located in the bin directory of the release area.

Distribution

COBRA is distributed together with all other CMS software using XCMSI
Those you wish to install just COBRA on their local system We suggest to do it by tar-ball or cp -r from the CERN local installation.
Optionally use usual check-out procedure and run scram b release from inside the src directory.

Unit Tests

to test COBRA installation go in the release COBRA area and 
 
 scram b test
 eval `scram runtime -csh`
 rm -r  ${SCRATCH}/testCOBRA
 mkdir -p ${SCRATCH}/testCOBRA
 cd ${SCRATCH}/testCOBRA
 set log=${PWD}/runTests.log
 touch $log
 foreach x ( $LOCALRT/src/*/*/test/runTests )
 set tdir=`dirname $x`
 set ldir=`dirname $tdir`
 set ldir=`basename $ldir`
 cp -r $tdir  ${ldir}Test
 pushd  ${ldir}Test
 echo "==>> " $x > runTests.log
 echo "---------------------"  >> runTests.log
 (source runTests) >>& runTests.log
 cat  runTests.log >> $log
 popd 
 end
 wc $log
 du -s ${SCRATCH}/testCOBRA

It takes quite some time as it includes a long POOL test. The result of wc for COBRA 7.10.0 should be
66717 309726 3679351
and the one of du
358732
(trust only the word count, not the character count...)

Full Test

 
cd ${SCRATCH}/testCOBRA 
ln -s  ${SCRATCH}/testCOBRA  ${SCRATCH}/testcobra
rm -rf ${SCRATCH}/testCOBRA/*
set this environment to your datafile location
  setenv DATADIR /afs/cern.ch/cms/oo/reconstruction/datafiles/cms133
  setenv EVDIR /castor/cern.ch/cms/reconstruction/datafiles/cmsim/cms133
then
(source $LOCALRT/src/Profound/PersistentTrackingHits/test/runtest) >& /dev/null

diff runtestlog.log $LOCALRT/src/Profound/PersistentTrackingHits/test/logs/runtestlog.log781 | wc
du -s ${PWD}
the result of wc for COBRA 7.10.0 should be
20694 142575 1421120
and the one of du
459344

Platforms

Backwards Compatibility and migration

The introduction of the namespace based CLHEP version may introduces partial backward incompatibility. POOL, ROOT and Objectivity schema are incompatible: COBRA 7.10 cannot read COBRA 7.3 or COBRA 6 data and vice-versa.
7.10 is compatible with 7.4 provided the POOL Catalog is migrated to the new schema.

System requirements, configuration, and runtime environment

The external components needed are listed here. The Root bin directory is available in the runtime path.

List of requirements for upcoming releases

Know problems, workarounds, bugs