Warning, /analysis/TPC/DAQ/macros/README.md is written in an unsupported language. File is not indexed.
0001 Procedure for creating TPC event display:
0002
0003 * Make sure you have locally installed the TPCRawDataTree module located at `analysis/TPC/DAQ/TPCRawDataTree/` in orderto be able to unpack the prdf files
0004 * Edit the following variables in `run_TPCEventDisplay.sh` to adjust for your input/output directories and other conditions:
0005 * `nEvents` - set to 2 by default since the first event for the pedestal runs I've been using don't have data in the 1st event. Should only really run this for 1 event for now because it's not currently designed to make multiple output files for multiple events just yet. (Will update this eventually)
0006 * `outDir` - directory where you want the root files from the prdfs stored (needs to be one you have write access to)
0007 * `adcCut` - whatever you'd like the ADC cut for all channels in the TPC to be, will only display hits above this threshold
0008 * `outFile` - path and name of output json file (I just use the convention `<directory you have write access to>/TPCEventDisplay_<run_number>.json`, but feel free to use whatever works best)
0009 * `runName` - name of the run in whatever file format you're using (e.g. for files labeled like `TPC_ebdc*_pedestal-00010151-0000.prdf` this would just be `pedestal-00010151`
0010
0011 * Run the `run_TPCEventDisplay.sh` script for all TPC sector input files using:
0012 ```
0013 source run_TPCEventDisplay.sh <path_to_prdf_files>/TPC_ebdc*<run_number>.prdf
0014 ```
0015 * Download the output json file to your local machine and pass it to the [sPHENIX Event Display Website](https://www.sphenix.bnl.gov/edisplay/ "sPHENIX Event Display Website") in the `EVENT` box at the top right
0016
0017 Procedure for processing PRDF pedestal run files:
0018
0019 * Make sure you have locally installed the TPCRawDataTree module located at analysis/TPC/DAQ/TPCRawDataTree/
0020 * Edit the `Fun4All_TPC_UnpackPRDF.C` macro to point the outDir variable to whichever directory you'd like to store the output root files in. The macro is located in the `analysis/TPC/DAQ/macros/` directory
0021 * Run the `run_UnpackPRDF.sh` shell script with all files you want to process as an argument, making sure to set the number of events variable in the shell script to be however many events you need. An example of running the script for all TPC sectors in run 10151:
0022
0023 ```
0024 source run_UnpackPRDF.sh /sphenix/user/jinhuang/TPC/commissioning/pedestal/TPC_ebdc*_pedestal-00010151-0000.prdf
0025 ```
0026
0027 Procedure for creating plots of each sectors dead channels, pedestal mean, and pedestal rms:
0028 * Edit the `TPC_Channel_QA.C` macro to have the `runNumber` string be the name of the file run you want to process and edit the `fileName` to match wherever you have stored the output root files from processing the PRDFs using TPCRawDataTree as above. Also edit the `saveName` variable at the end of the file to point to wherever you'd like the png images to be stored instead of just an `images` directory wherever you're running the macro
0029 * Run `TPC_Channel_QA.C` with `root -l TPC_Channel_QA.C` and you'll generate 24 pngs, one for each sector in the TPC
0030
0031 Procedure for making root file containing channel averaged pedestal info:
0032 * Run the `run_TPCPedestalCalibration.sh` script from the command line with all root files (output from converting the PRDF files) you want to process as an argument. Example for processing all TPC sectors from run 10151:
0033 ```
0034 source run_TPCPedestalCalibration.sh /sphenix/user/rosstom/test/testFiles/TPC_ebdc*_pedestal-00010151-0000.prdf_TPCRawDataTree.root
0035 ```
0036 * Should produce a new root file for each sector's channels with information about each channel's alive/dead status, pedestal mean, and pedestal rms
0037
0038 If you have any questions, send Thomas Marshall (@rosstom, rosstom@ucla.edu) or Aditya Dash (@adityadash, adityaprasaddash55@gmail.com) a message on mattermost or over email
