JS-Jet/JetNconstituents/README.md

0001 This module is designed to create histograms for the jet constituents and jet energy fractions for each calorimeter layer.
0002
0003 # Running Module
0004 Histograms are made with the JetNConsituents analysis module, run using the macro macro/Fun4All_JetNconst.C.
0005
0006 To run the tree making step (note if you are using a bash shell use instead the versions of the commands in parentheses):
0007 1. Build the package in the [usual way](https://wiki.bnl.gov/sPHENIX/index.php/Example_of_using_DST_nodes#Building%20a%20package):
0008
0009    * Make a build directory inside the src directory:
0010
0011          cd src
0012          mkdir build
0013          cd build
0014
0015    * Setup the sPHENIX environment and install paths:
0016
0017          source /opt/sphenix/core/bin/sphenix_setup.sh -n
0018          export MYINSTALL=~/install
0019          source /opt/sphenix/core/bin/setup_local.sh $MYINSTALL
0020
0021    * Compile your code:
0022
0023          /PATH_TO_YOUR_SOURCE_DIR/autogen.sh --prefix=$MYINSTALL
0024          make -j4
0025          make install
0026
0027 2. Run the code using the Fun4All macro:
0028
0029    * Test run using Fun4All. The Fun4All macro takes in input file lists for the truth jet and calo cluster DSTs and an output file name as inputs. For example, you can run:
0030
0031           root -b -q 'Fun4All_JetNconst.C("dst_calo_cluster.list", "output.root")'
0032
0033    * This will create an output file containing histograms showing the total number of constituents in each jet, the number of constituents in each calorimeter layer, and the energy fraction in each calorimeter layer. The histograms are saved in a root file called output.root.
0034
0035
0036 # Making Histograms Pretty
0037 Once you have made the TFile containing the histograms, you can save these as pdfs in the SphenixStyle using plot_histos.C. How to run:
0038         root -b -q 'plot_histos.C("output.root", "0.4")'
0039
0040     * The first argument is the name of the root file containing the histograms. The second argument is the jet radius. This is used to label the histograms. The output pdfs are saved in the directory where you run the macro.
0041     * Example plots:
0042
0043 ![image](https://github.com/sPHENIX-Collaboration/analysis/assets/38924390/9c4aaab6-0c64-4c4e-a64c-b3f81ae4f4d9)
0044
0045 ![image](https://github.com/sPHENIX-Collaboration/analysis/assets/38924390/d6d7812a-06c0-4359-bcf4-3a2c612daf29)
0046
0047
0048 # Questions/suggestions
0049 Please send any questions, bugs, or suggestions for new features to Tanner Mengel (tmengel@vols.utk.edu)