Production Release p13 DONE

NOTE: Another HepTuple bug has been found that might crash Level 3 in TrigSim. Please see this page for instructions on how to fix this bug.

• Overall Status: It is based on t02.35.00. Version p13.06.00 is really the first version that runs "out of the box". p13.08.00 will be the last release with the "p13" label, however the "p14" releases are really a continuation of "p13" release as far as TrigSim is concerned. Everything should be fine on MC inputs. On data -l3only should be ok. Behaviour of L1/L2 on data is a little funky....don't trust it unless you know what you are doing. Problems with l1muo and l2stt are known, solutions are not.
• Known Problems, Tips and Tricks
  1. Caution! There is a bug which affects the default trigger list in p13. It also affects any lists (*.sim files) generated with the p13 version of COOR. The effect is that, regardless of the triggerlist configuration, TrigSim L2 will use 3x3 jets rather than 5x5 jets when run offline. Online is properly configured to use 5x5 jets. Details and fixes.
  2. Heptuple Bug. There is a bug in HepTuple (a zoom package - external to D0) which seems to get exercised heavily by L3 analyze packages. In particular, examiners for L3 unpackers should not be run. Default triggerlists are accompanied by a toollist.txt that takes care of this. If you need to make your own triggerlist you can create and fix a toollist.txt by

     ParseToolList  level3.sim
     edit resulting toollist.txt to remove all lines containing "unp"
     add -l3toollist=filename to the runD0TrigSim commandline to pass this new toollist to the executable
     

     You may instead patch Heptuple and relink the executable ( instructions).
  3. Triggerlist Stuff. The triggerlist that comes out of the database/coor has certain features that d0trigsim can't cope with. We also have some hand configuration needed in L3 to handle various input types.
  • level2.sim-stripped: Need to add

    L2GBL ADMIN GLOBALWORKER {
        USEL1BITS = 0
    }
    

    to the file. We hope that either COOR or the XML generator adds this automatically in the future.
  • level3.sim
  • For MC input files:

     
        GEO L3GeometryManagement (MCTag="p10.06.01")|
    

    So, you need to specify what version of the MC was used to produce the input.
  • For data input files:

       GEO L3GeometryManagement(
                       tooltype="utility",
                       RunNo=-1,
                       MCTag="xxx.xx.xx")|
    

    Note that "RunNo=-1" will give you the latest geometry available. If you instead insert a specific run number (like 123456), then it will use the geometry from the DB which was available for that run.

P13.10.00 (01/29/2003)

• Status Frozen.
• Package changes included

d0trigsim

p13-10-00a

- fix trigger list in p13 so that scriptrunner will not use L2 bits

P13.09.00 (01/29/2003)

• Status Frozen.
• Package changes included

l3filters	p13-br-07	- fix problem with missing _v_cand.set_count(0) in the reset method of the physics filters
ScriptRunner	p13-br-13	- add reseting of some global flags at the AddL2Bits stage to make sure when a new client is defined they are set to their default values - now SR takes the l3fserver address from the coor database - d0onlinenames.py

P13.08.00 (01/29/2003)

• Status Frozen.
• Package changes included

  d0trigsim     p13-br-08 - add a framework rcp for ease-of-use by mc_runjob (farms)
  l2monitor     p13-br-04 - gcc fixes
  l2slic        p13-br-15 - fixed warnings
  -----------------------
  ScriptRunner  p13-br-11 - registered L3FMHt filter in ScriptRunner/FilterMaker.hpp
  

P13.07.00 (01/21/2003)

• Status Frozen.
• Package changes included

  d0trigsim           p13-br-07 - add cal_nlc to trigsim rundata for easier farm running
  l1cal_analyze       p13-br-02 - gcc fixes;
                                \ atuomate code to deal with small or full eta coverage
  l1l2_evt            p13-br-03 - back port code changes from HEAD version:
                                |    define the total number of towers stored in the 
                                |     chunk through a constant (not an hardcoded value);
                                |    add the run number in the class constuctor (needed 
                                |     for handling run number dependent configurations 
                                \     in data)
  l1l2_reco           p13-br-02 - back port corrections from HEAD version:
                                |    enable decoding of L2 information for MC;
                                |    disable (via RCP) decoding of L2STT also in MC 
                                \     (appears to be broken)
  l2gbljet            p13-br-02 - bug fix in calculation of MJT
  l2gblmuon           p13-br-02 - fix baseobjects for global muons made from two 
                                \  preprocessor muons
  l2mu_analyze        p13-br-11 - do not unpack data taken before completion of L2 
                                \  commissioning
                                / fix permissions on rundata area;
  l2slic              p13-br-14 - fix gcc warnings;
                                \ tune-up central BC algorithms & scintillator unpacking
  l2slic_tables       p13-br-10 - new LUT tables; 
                                | central: larger statistics and increased LUT size; 
                                | forward: use correct/surveyed p13.03 muon det. geom.;
                                \ scripts & batch files for clued0 added
  tsim_l1cal          p13-br-03 - fix gcc error and fix the pass through mode error
  tsim_l1l2           p13-br-07 - remove unneccessary lines from rcp
  tsim_l1muo          p13-br-02 - fix B layer eta range errors;
                                | add read out of data with wrong word size;
                                \ fix A layer jkl centroid finder that misplaced centroid offsets in i deck
  tsim_l2slic         p13-br-12 - fix minor UBS-mode-related bugs;
                                | redirect error output from screen to log file; 
                                \ fix gcc warnings
  -----------------------------
  l3fmuo_centralmatch p13-br-01 \ / angular range calc. in MuoCentralMatch improved;
  l3fmuo_local        p13-br-04  - central axial-only tracks are now taken into account;
  l3fmuo_test         p13-br-01 / \ remove incompatible reference set names in test pkg
  l3ftrack_phys       p13-br-03 - remove cout statement in L3TrackPhysicsResults.cpp
  l3utilities         p13-br-01 - add setters to L3PZRegion for L3Muo*
  sim_exam            delete
  trig_exam           delete
  

P13.06.01 (01/14/2003)

• Status Frozen.
• Package changes included

  tsim_l1muo    p13-br-01 - fix trigger manager download bug;
                          | fix forward boundry region dimuon bug;
                          \ fix central bottom triggers (add b-layer scint)
  l2monitor     p13-br-03 - small updates to XML generation;
                          \  more error checking when reading a monitor buffer
  -----------------------
  ScriptRunner  p13-br-10 - bug fixes from Moacyr
  

P13.06.00 (12/21/2002)

• Status Frozen
• Tricks This and previous versions will cause Reco to crash if it is run over TrigSim output. This problem is fixed in version p13.06.01.
• Package changes included

  d0trigsim      p13-br-06 - enable autogeneration of l3calib.ev file for data
  l2caljetworker p13-br-02 - remove 0GeV jets
  l2cps_analyze  p13-br-01 - replace extpt and ptbin with pt
  l2cpsworker    p13-br-01 - replace extpt and ptbin with pt
  l2cttcftworker p13-br-05 - change to sttctt tracks
  l2gbl_analyze  p13-br-01 - fix bug in crashing on old runs
  l2gblworker    p13-br-04 - add missing include;
                           \ add mjt filter/tool
  l2io           p13-br-04 - change cps to use pt;
                           \ add "template" keyword in declaration of variable
  l2slic         p13-br-12 - put lookup tables in rundata;
                           | sim.: Table Loader looks in local "job" directory first for the lookup tables
                           \ on-line: Minor change for handling wDSP fatal errors
  l2sttcttworker p13-br-05 - change to sttctt tracks
  l2trackerbase  p13-br-06 - change to sttctt tracks;
                           | l2iso algoritm change;
                           | pT look-up table expansion to lower pT;
                           \ fix for missing header
  -----------------------------
  l3fCalMEt      p13-br-05 - change order of threshold and eta cuts;
                           \ correct threshold cut to keep same behavior as p12
  l3x_qt_display delete
  

P13.05.00 (12/03/2002)

• Status 5 builds were done, frozen.
• Tricks A calibration file needed by TrigSim did not make it into this build. To run, you need to copy the file cal_nlc_146225.coef into your trigsim directory.
• Package changes included

  d0trigsim      p13-br-05 - change default triggerlist;
                           - change default level3.sim MC version to p11.08.00;
                           - remove default station name from sam manager rcp
  l1l2collector  p13-br-01 - fix bad use of iterator
  l2calemworker  p13-br-01 \ use only neighbor TTs with counts >0 for weighted 
  l2caljetworker p13-br-01 /  eta and phi calculation
  l2cttcftworker p13-br-04 - add "newEvent" method, which sets _ntracks=0 before 
                              each new event so it does not overflow the limit
  l2gblworker    p13-br-02 - add circular buffers for monitoring trigger bits
  l2monitor      p13-br-02 - make sure changes for xml and worker IDs are in p13
  l2mucworker    p13-br-11 \ fix SCL-init bug
  l2mufworker    p13-br-11 / 
  tsim_l1l2      p13-05-00a - new default triggerlist (MC list);
                            - rcp changes to turn on l2stt_analyze and 
                               l2mu_analyze, other rcp fixes;
                            - update for new data format
  -----------------------------
  l3exceptions    p13-br-01 - explicitly list all severity levels for which we want throttling
  l3fanalyze      p13-br-05 - remove obsolete debug cout statements
  l3tCalUnpTool   p13-br-08 - upgrade ctest and itest to use initScriptRunner.sh
                            - remove obsolete debug cout statements
  l3fcalib_cft    p13-br-02 \
  l3fcalib_config p13-br-02 - auto generate l3calib.ev file for running on data
  l3fcalib_smt    p13-br-02 /  (not made default yet)
  l3fCalMEt       p13-br-04 - fix missing #include in the L3MEtPhysicsResults.hpp
  l3fcpsunp       p13-br-02 - change l3fcpsunp-rundata.sh to copy needed files
  l3fsmtunptool   p13-br-03 - auto generate l3calib.ev file for running on data
                               (not made default yet)
  tsim_l3         p13-br-02 - update initScriptRunner script to copy cal_nlc file into environment;
                            - change tsim_l3-rundata.sh to copy needed files
  

P13.04.00 (11/19/2002)

• Status 6 builds were done, frozen
• Tricks The default triggerlist distributed with this version does not work for MC. Please see the Trigger List page to get a tarball with the corrected files.
• Package changes included

  l1l2trigbits        p13-br-01 - Change in the connection to the DBserver
                                   to use the code inside D0reco
  l2cttcft_analyze    p13-br-01 - protect against NULL pointers in unpack
  l2sttcttworker      p13-br-04 \
  l2gblbase           p13-br-01 - increase max number of tracks to 100
  l2sttctt_analyze    p13-br-03 /
  l2io        \
  l2mu_util    \
  l2mucworker   \_   p13-04-00a - change l2muon data format for new online running
  l2mufworker   /
  l2slic       /
  tsim_l2slic /
  l2monitor           p13-br-01 - add l1MaskID and l2MaskID for circular buffers 
                                   holding the L1 and L2 masks
  tsim_l1l2           p13-br-04 - new rcps to correspond to Josh's l1cal changes
  tsim_l2cal_inputfix p13-br-01 - fix bug when towers are saturated
  -----------------------------
  l3fchunk            p13-br-09 - put physical stream names into event;
                                - remove logicalstream from event
  l3femtools          p13-br-03 - add methods to support TMB unpacking
  l3filters           p13-br-06 - remove EMFR parameter from the jet filter;
                                - bugfix to L3FMHt filter's return value;
                                - introduce the Missing Ht filter
  l3ftrack_phys       p13-br-02 - new
  l3streaming         p13-br-01 - insert new streaming code from p12
  l3tCalUnpTool       p13-br-06 - remove old files before copies or copy fails
  ScriptRunner        p13-br-09 - fix usel1/usel2 problem where both could 
                                   be simultaneously defined;
                                - add new streaming code from p12;
                                - introduce the Missing Ht filter
  trigdb_scripts      p13-br-02 - add new filter L3FMHt
  

P13.03.00 (11/12/2002)

• Status Frozen. Will run with corrected triggerlist.
• Tricks The default triggerlist distributed with this version does not work for MC. Please see the Trigger List page to get a tarball with the corrected files.
• Package changes included

  d0trigsim     p13-br-04 - change default level3.sim MC version to p11.08.00;
                            remove default station name from sam manager rcp
  l1cal_analyze p13-br-01 - port MET fix into p13
  l1l2unpacker  p13-br-02 - fix CFT unpacking for real data
  l2base        p13-br-01 - gcc fixes
  l2gblgeneric  p13-br-01 - add unported p12 code for new filters
  l2io          p13-br-01 - add byteswap function for CFT real data
  l2iogen       p13-br-01 - gcc fixes
  l2parser      p13-br-01 - gcc fixes
  l2trackerbase p13-br-03 - fix memory overwrite;
                            update stt phi bins
  tsim_l1cal    p13-br-01 - port MET fix into p13
  tsim_l1l2     p13-br-04 - rcp change to turn on l2stt_analyze and l2mu_analyze;
                             other rcp fixes
  -----------------------
  l3fCalMEt     p13-br-03 - update calls to HotCells to reflect var. type change
  l3fchunk      p13-br-08 - The method that was used to insert PhysicsResults
                             into L3Chunk before L3Chunk started using d0_Ref
                             instead of bare pointers no longer works. As
                             result, a change is needed so that L3Chunk can
                             be reconstituted in UnpThumbNail;
                          - Implement operator= & copy constructor for L3TmbObj;
                          - fix outdated component test L3TmbObj_t.cpp;
                          - updates to l3 tmb contents - now contains extra
                             info for specific types of object - electron,
                             muon, tau etc.
  l3fmuo_local  p13-br-03 - was using a wrong RCP file in p12, p13 and test 
                             branch. Fix l3fmuo_local/rcp/MuoSegmentReco.rcp 
                             to point at muo_segmentlinkedlist/rcp/MuoSegmentLLReco_L3.rcp
  l3fsmtunptool p13-br-01 - change script to copy the l3calib.ev file rather than link it
  l3node        p13-br-01 - when updating collisionID, use cached run number
  l3tCalUnpTool p13-br-05 - memory leak fix and add config to SUBDIRS
  

P13.02.00 (11/06/2002)

• Status Frozen. Default config crashes in destructor of L2 tracking packages. Also some random-looking crashes. Fixes below.
• Tricks
  • The default triggerlist distributed with this version does not work for MC. Please see the Trigger List page to get a tarball with the corrected files.
  • runD0TrigSim may crash in L2 if you try to run p13.02.00. To fix it you need to check out and compile a new version of l2trackerbase:

     setup D0RunII p13.02.00
     setup d0cvs
     newrel -t p13.02.00 p1302
     cd p1302
     addpkg l2trackerbase p13-br-03
     addpkg d0trigsim
     gmake all
     
     THEN (FOR EXAMPLE)
     ------------------
     setup d0tools -t
     runD0TrigSim -filelist=myfiles.txt -format=mc -localbuild
     

• Package changes included

  d0trigsim       p13-br-02 - insert missing Regtsim_l2stt statement in 
                               d0trigsim/bin/OBJECTS;
                              fix l2 triggerlist
  l1l2unpacker    p13-br-01 - fix for l1ft unpacking on data
  tsim_l1l2       p13-br-02 - new L2 triggerlist
  l2trackerbase   p13-br-01 - Skip pT conversion, pT=4*pT
  --------------------------
  l3fanalyze      p13-br-04 - fix error in Reg_L3Examiners;
                            - add L3TrackPhysResultsExaminer;
                            - a few updates to Reg_L3Examiners and ExaminerLists.rcp
  l3fbtag_ip      p13-br-02 - fix bug in the calculation of the impact parameter error
  l3fCalCalibTool p13-br-01 - new format of output chunk to fix not understood crash
  l3fchunk        p13-br-06 - delete code in main();
                            - add data members toolname and toolresults
  l3fcpsunp       p13-br-01 - install new map generated in Oct. 2002
  l3femtools      p13-br-02 - fix detector eta calculation;
                            - modifications for L3 thumbnail support
  l3filters       p13-br-03 - update L3FTrack to use L3TPhysTracker;
                            - update L3FCFTVertex to use vertexer base class;
                            - comment out lines left in L3FHt;
                            - activate L3FJAcop component test
  l3ftrack_phys   v00-01-01 - new
  l3fxy_vertex    p13-br-01 - add square root of track error in Track object;
                            - remove MCSMEAR from rcp and comment it out in L3TXYVertex
  l3tCalUnpTool   p13-br-04 - add "config" directory to file SUBDIRS;
                            - L3Nada uncommented and bug fix;
                            - reinsert removed d0tools compatibility lines in 
                               config/l3tCalUnpTool_rundata.sh;
                            - fix rundata (pedestals.txt)
  ScriptRunner    p13-br-06 - added some missing tool decls;
                            - change ExternIterator.cpp to get physics results 
                               used by the filter
  trigdb_scripts  p13-br-01 - add entry in tools.rcp for the L3TPhysTracker tool;
                            - add a parameter in tools.rcp for the L3TBTagIP tool
  

P13.01.00 (10/15/2002)

• Status Frozen. Release does not contain a viable TrigSim.
• Tricks runD0TrigSim will crash if you try to run p13.01.00 straight out of the box. There are two fixes you need to make and then rebuild in your own area. Then always run with the option -localbuild. We plan to correct these bugs in p13.02.00.
  1. tsim_l2stt OBJECT missing in d0trigsim - checkout the default version of d0trigsim. Edit the file d0trigsim/bin/OBJECTS to insert the line "Regtsim_l2stt" between "Regtsim_l2slic" and "Regl1cal_analyze".

        ...
        Regtsim_l1muo
        Regtsim_l2slic
        Regtsim_l2stt
        Regl1cal_analyze
        Regl1frm_analyze
        ...
     

  2. missing pedestals.txt file - grab a pedestals.txt file from wherever you want and put it in your trigsim directory. If you want, you can grab it here : pedestals.txt
• Implimented Fixes
• Package changes included

  d0trigsim       p13-br-01 - fix default trigger list
  l2admin         deleted
  l2buffer        deleted
  l2emulator      deleted
  l2exampleworker deleted
  l2fic           deleted
  l2gblem         p13-br-01 - track changes
  l2gblem_analyze deleted
  l2gbljet        p13-br-01 - port
  l2gblmuon       p13-br-01 - track changes
  l2gbltrack      p13-br-01 - track changes
  l2gblworker     p13-br-01 - remove inline keyword
  l2request       deleted
  l2slic_driver   deleted
  l2worker        deleted
  tsim_l1ft       p13-br-01 - improve link/copy script
  tsim_l1l2       p13-br-01 - improve Runme script
  tsim_l2cal      deleted
  tsim_l2ctt      deleted
  tsim_l2muo      deleted
  unpack_muo_l2   p13-br-10 - modifications in getDriftDist method due to p13 interface 
                               changes in package muo_util
  ---------------------------------
  l3datastream    deleted
  l3fchunk        p13-br-04 - fixed problem with backwards compatability in changes to L3Chunk;
                            - include fixes from P.Tambarello to avoid interface change which
                               breaks RECO;
                            - interface change - the way the physics results are fstored in the 
                               l3chunk has been changed. Now d0_Ref objects are used instead of 
                               bare pointers.  The bare pointer interface to consumers is 
                               maintained by copying the pointers from the d0_Ref to a transient 
                               list in the L3chunk  on demand.  This means there is no interface 
                               change for consumers of the l3chunk.
  l3fhmatrix      deleted
  l3fmuo_local    p13-br-02 - add new RCP parameter to L3 version of MuoTrackReco.rcp to comply 
                               with muo_trackreco
  l3fshop         deleted
  l3ftools        deleted
  l3tCalUnpTool   p13-br-01 - zero sigma bug fix
  run_config_mgr  p13-br-01 - update the constructor of rdc_run_config_mgr to set the _init_status
                               bits for the run configuration. This is required so that when
                               rdc_run_config_mgr is used in conjunction with trigsim and L3, L3
                               can determine whether or not it should try to initialise the run
                               configuration itself.
  ScriptRunner    p13-br-03 - fixed bug when selecting events for debug chunk insertion;
                              update to match interface change in l3fchunk - fill physics 
                               results list in the l3chunk using d0_Ref's instead of bare pointers
   

P13.00.00 (10/7/2002)

• Status Created as a copy of t02.35.00.
• Tricks Do not use this version
• Implimented Fixes None yet