Make LUTs Walkthrough

Introduction

The purpose of this tutorial is to provide an walkthrough showing how to generate LUTs that are used in describing the detector geometry in the CSC Track Finder.

Set Up Your Environment

First, set up your CMSSW_2_1_0_pre4 directory and your path to the CVS repository by typing the following commands into your home directory:

export SCRAM_ARCH=slc4_ia32_gcc345
. /raid/raid4/pg/app/cmssoft/cms/cmsset_default.sh
export CVSROOT=:pserver:anonymous@cmscvs.cern.ch:/cvs_server/repositories/CMSSW
scramv1 project CMSSW CMSSW_2_1_0_pre4
cd CMSSW_2_1_0_pre4/src

Now, you will need to set up your runtime environment. This command is different if you are working in C-shell or bash. Type the correct command from below while in your src directory:

eval `scramv1 runtime -sh` (if you are using bash)
eval `scramv1 runtime -csh` (if you are using C-shell)

Log into the CVS repository and check out the necessary packages by typing the following commands:

cvs login (use the password "98passwd")
cvs co -r CMSSW_2_1_0_pre4 L1Trigger/CSCTrackFinder

You now have all the files necessary to generate LUTs for the CMSSW_2_1_0_pre4 release, so now you should compile and build the code using:

scramv1 b

You are prepared to begin writing LUTs!

Generating LUTs

In this section of the tutorial, you will actually generate the LUTs for CMSSW_2_1_0_pre4

To do this, you need to move to the proper directory by typing:

cd L1Trigger/CSCTrackFinder/test

The config file that is used to generate the LUTs is in this directory and is called "makeLUTs.cfg". This file has several options that can adjust the LUTs being generated. These options are the following:

isBinary - Binary or ascii output?
WriteGlobalEta - Write Global Eta?
WriteGlobalPhi - Write Global Phi?
WriteLocalPhi - Write Local Phi?
Station, SubSector, Endcap, and Sector - What station, sub-sector, endcap, and sector do you want to use? Note: if these values are set to -1 or the lines are commented out, all stations, sub-sector, endcaps, and sectors are looped through
isTMB07 - Do you want to use the the 2007 version of the trigger motherboard firmware?
UseMiniLUTs - Do you want to generate LUTs from mini LUT parameterization or from the standard method of writing LUTs
DeltaX_End_1_Sta_1, DeltaX_End_1_Sta_2, ... - Alignment correction in the X direction for each endcap/station combination. These parameters should be entered in centimeters. Note: This feature is not currently implemented into CMSSW_2_1_0_pre4.
DeltaY_End_1_Sta_1, DeltaY_End_1_Sta_2, ... - Alignment correction in the Y direction for each endcap/station combination. These parameters should be entered in centimeters. Note: This feature is not currently implemented into CMSSW_2_1_0_pre4.

By default, the config file is set up to generate SR LUTs using the the Mini LUT parameterizations, and the 2007 version of the TMB (TMB07). These will be generated for all station, sub-station, endcap, and sector and PT LUTs, both in ascii format format.

Once you have selected the desired options, you can finally make the LUTs type the following commands into the command prompt prompt:

cmsRun makeLUTs.cfg

If this ran successfully, you will how have several files in your test directory. These files should be moved to a directory where they can be easily accessed in the future. This is done using the following commands.

mkdir ../LUTs
mv *.dat ../LUTs (if the files are written in acsii format)
mv *.bin ../LUTs (if the files are written in binary format)

You are now have generated LUTs for CMSSW_2_1_0_pre4!