MINOS Batch Group

Birch Release Information

Birch Environment (root, db, release)
Birch Configuration Summary
Known Birch Problems
Birch Scripts

What Defines Birch?
The Birch Release had two effective iterations when the underlying root software was upgraded to Root 5. It began in November of 2005 and concluded in December of 2006.

Birch with Root 5.10

This version is synonymous in common MINOS parlance as the R1-18-4 processing which was undertaken starting in May 2006. This includes a migration to root 5.10/00c and GCC 3-4-3.

MINOSSOFT Release: R1.18.4
Root Version: 5.10/00c
GCC Version: 3-4-3
Database: Frozen at update 21113
               BEAMMON* and SPILLTIMEEND updated daily
Magnetic Field Used: 208 (Far) and 160 (Near)
Scripts: Production/Birch


The Birch release is synonymous in common MINOS parlance as the R1-18-2 processing which was undertaken starting in November 2005. This included a suite of bug fixes in preparation for the 1e20 benchmark studies.

MINOSSOFT Release: R1.18.2
Root Version: 4.02/00
Database: Frozen at update 21113
               BEAMMON* and SPILLTIMEEND updated daily
Magnetic Field Used: 208 (Far) and 160 (Near)
Scripts: Production/R1.18/R1.18.X

Birch Configuration

In the transition to R1-18-2 there were a few changes introduced into the reconstruction scripts. These changes include

  • all of the scripts now use the function based running format
  • New calibration settings were used see Birch Calibration Page
  • New Photon Transport constant: GeVPerMip = 0.001759/0.001737 near/far
  • The nominal bfield maps used were 160 and 208
  • Changes the Near Detector cosmic prescaling ratio from 1:2 to 1:8

Known Birch Problems

1. Missing SimSnarl Information: The SimSnarl record is in general supposed to be written out to the Cand Stream during MC reconstruction, this was lost during Birch and will be restored in Cedar. This was simply a script issue.
2. Missing MC Events: Filtering at the level of the Reroot and DetSim modules were removing events in the Far stream that produced no actual hits in the Far Detector. This required modification to MINOSSOFT as well as the reconstruction scripts. From a script side fixing this simply requires turning the filtering off for the Reroot and DetSim modules.
3. In Birch 2.0 (R1.18.4) processing there is a concern with the performance of the CandSubShower software. Shower clusters are loaded into a TSpectrum array and then returned to the program. However, the returned clusters are not always in the correct order. This can result in a shw.clu being assigned -1 and the following error being generated in the log file:
=E= NtpSR date time [run|snarl] NtpSRModule.cxx,v1.109:1277>
Shower CandSubShowerSR w/Uid 388952496 does not match any in cluster
list. shw clu entry will not be properly filled

If you find such an event you should consider it suspect and remove it from your event sample. Chris Smith is investigating this bug and intends a fix before Cedar. (added July 21, 2006)

Birch Reconstruction Scripts
Birch with Root 5 and standard Birch used virtually identicle scripts but different ID tags.

Far Spill Data Production Script
Far Cosmic Data Production Script
Near Spill Data Production Script
Near Cosmic Data ProductionS Script
Far MC Production Script
Near MC Production Script

Far Detector Spill Script:


This script is the final production script used in R1-18-4 processing. These script has the Spill Filter applied to capture the data that came in during the beam spills. Other filtering is not applied, this tends to result in a large number of files with only junk events. The CandSubShower package is in use as well as the AltDemux package. After standard reconstruction is applied the blinding algorithm is applied and a second set of data output is produced. In total this script produces six different output streams: the cand, sntp, and snts files for both the open and closed data sets. When modifying this file be very careful as changing the order of the blinding operations and output settings can result in doubled ntuples, or only producing stripped ntuples. This is a known feature of the linearity of job control.

Far Detector Cosmic Production Scripts


This script is the final production script used in R1-18-4 processing. CandSubShower is not ready to work with Cosmic data. It uses the AltDemux package but otherwise is equivalent to earlier releases for Far Detector Cosmic Production. These scripts do not have a spill filter attached at all. This means that beam events will be present in these files. However, more restrictive filtering is also applied. This includes but is not limited to the noise filtering module and the 4/5 plane trigger in FilterDigitList. This will remove a number of the events from the spill stream. These are called All files though due to their lack of a spill filter operating in either direction. All of the All files produce only the three standard output streams.

Near Spill Data:


This is the final production script that was used for data processing. This script utilizes the CandSubShower package and produces the standard three output files. Near Detector Spill data is again isolated using the spill filter based primarily on timing information.

Near Cosmic Data:


This is the final production script. This script does not use the CandSubShower package as it was determined not to be ready for Cosmic data at this time. The 1:8 prescaling on the activity and planes triggers though is performed. Near Cosmic Data uses the spill filter in reverse to pull out any beam events from the stream. Some of these scripts make use of the new Prescaling module which reduces the number of cosmics that are passed to the reconstruction in order to reduce file size.

MC Processing:


The Far production of the MC is meant to simulate the far spill production scripts for data. As such it also makes use of the AltDemux and CandSubShower packages. Blinding is not enabled. It also has the standard reroot packages. It makes use of the legacy names ScintHit an dDigitoPe instead of PhotonTransport and DetSim although this should have no impact on the output.


The near Production script simulates the near spill data. It makes use of the CandSubShower package.