24.1. Project Overview
Table of Contents
Goals of the Final Project
The final project is your chance to put together everything you have learned into one coherent analysis. You will work through a full mini analysis, starting from raw data and ending with physics results and plots that you could, in principle, show in a presentation or report.
You will take a real or realistic dataset, convert or load it into ROOT, explore the variables, select interesting events, build histograms and graphs, fit relevant distributions, extract physical quantities with uncertainties, and present your results in clear and reproducible form.
The aim is not to produce a perfect professional analysis, but to practice the complete workflow so that, after this course, you know how to approach real problems with ROOT.
The final project should:
- Use ROOT for every stage from data input to final plots.
- Keep analysis steps scripted or in macros so they are reproducible.
- Document assumptions, cuts, and methods clearly.
Structure of the Project
The project is divided into logical steps, each corresponding to a later section of this Final Project chapter:
- Import the data into ROOT.
- Explore the dataset to understand its variables and basic distributions.
- Apply data selection to define signal and background regions.
- Create histograms and other ROOT objects that summarize the data.
- Fit the relevant distributions to extract model parameters.
- Calculate physics or application specific quantities from fit results or event variables.
- Estimate statistical uncertainties on the main results.
- Produce publication quality figures that communicate the results clearly.
- Save the analysis results for later reuse.
- Write a short report that explains what you did and what you found.
Each of these steps will have its own section with practical guidance. You are encouraged to structure your code and directories so that each step is a separate macro or script, or at least a clearly separated function, which makes the workflow easier to understand and modify.
Example Datasets and Context
You can choose from several types of datasets, depending on your interests and what is provided with the course materials. Typical examples include:
A simple particle or nuclear physics dataset. For instance, events from a detector where each event contains measured energies, times, and possibly reconstructed momenta of particles. You might study an energy spectrum, a time distribution, or an invariant mass distribution to identify a peak corresponding to a known particle or transition.
A detector calibration or laboratory experiment dataset. For example, measurements from a scintillator, a Geiger counter, a semiconductor detector, or a spectroscopy setup. The analysis might focus on calibrating energy, resolving multiple peaks, or estimating detector resolution.
A general statistical dataset provided in text or CSV form. Even if the context is not strictly particle or nuclear physics, you can still use ROOT to perform histograms, fits, and uncertainty estimates exactly as you would in a physics analysis.
The project is designed so that the exact physics context is less important than practicing ROOT skills. However, you should still describe in your report what the quantities represent and what physical or experimental question you are answering.
Required ROOT Skills and Concepts
The project assumes that you have basic familiarity with the topics covered earlier in the course, especially:
Reading and writing ROOT files with TFile, and handling TTrees for event based data.
Creating and using histograms and graphs, including drawing and basic styling.
Performing fits with TF1 and understanding parameters and uncertainties.
Running ROOT macros and organizing analysis code into functions or separate files.
You do not need to use every advanced feature from the course, but you should demonstrate that you can combine several core elements in a consistent way.
Your project must include at least:
- One TTree or equivalent structured dataset.
- Several TH1 histograms and at least one fit using TF1.
- At least one final plot saved in a non ROOT format, such as PDF or PNG.
Typical Workflow for the Project
You should think of the project as a small version of a real analysis workflow. A typical sequence looks like this:
First, you obtain the raw data. This might be a text or CSV file, or an existing ROOT file with a TTree. If needed, you convert the data into a ROOT file with a structured TTree so that later steps are efficient and clean.
Next, you open the dataset in ROOT, list its contents, and inspect the tree structure and branches. You make a first round of simple plots, often one dimensional histograms of key variables, to see basic shapes, ranges, and any obvious problems in the data.
Then you define selection criteria, usually simple cuts on variables, to isolate the region of interest. You check how many events pass the cuts and whether the resulting distributions look reasonable compared to the full dataset.
After the selections are fixed, you construct the main histograms or graphs that will be used in your final physics results. You choose binning, ranges, and labels carefully so that the distributions are informative and suitable for fitting.
You then perform fits to key distributions with appropriate functions. You check the goodness of fit and extract parameter values such as means, widths, or slopes. From these, you compute the physical quantities you care about, for example a particle mass, an energy calibration factor, or a decay constant.
Finally, you estimate statistical uncertainties, improve the visual appearance of the plots, save all relevant objects and outputs, and write a short report explaining what you did.
Throughout, you should keep your code organized so that you can easily re run the entire chain if the input data or your selection criteria change.
Assessment Criteria
The project will be evaluated on the clarity and completeness of your analysis workflow, not only on the final numerical values. The main aspects are:
Correct use of ROOT tools. Scripts or macros should run, use ROOT objects appropriately, and avoid common pitfalls such as lost object ownership or inconsistent histogram binning.
Logical and transparent workflow. Each step from data import to final results should be understandable, with clear rationale for choices like binning, cuts, and fit ranges.
Quality of plots and outputs. Figures should have readable axes labels, units where appropriate, sensible ranges, and minimal unnecessary clutter. They should be saved in a format suitable for inclusion in a report or presentation.
Documentation and reproducibility. Your analysis should be reproducible from the stored files and code, with comments and a written report that explain what each major piece does.
Physical interpretation. You should briefly interpret the main result in the context of the dataset. This includes explaining what a peak or parameter represents, and how the uncertainty affects your conclusion, even at a basic level.
Planning Your Own Analysis
Before you start coding, it is helpful to sketch your analysis plan. Identify the main question you want to answer with the dataset, such as determining a peak position, measuring a rate, or comparing two distributions. Then outline which variables in the dataset are relevant and what kind of histograms or fits will be needed.
You can then map each part of your plan to one section of the project:
Which files to import, and whether a ROOT conversion step is needed.
Which quick plots to make first to understand the data.
Which cuts to try and how to define signal and background.
Which final histograms and graphs will appear in your figures.
Which function models to use for fits.
Which numerical results you will quote and how to compute uncertainties.
Which plots and tables you will include in the report.
If you treat the project like a small real analysis, you will gain much more from the experience and be better prepared for future work with ROOT and experimental data.
How This Chapter Guides You
The remaining sections of the Final Project chapter follow the same order as the project workflow. Each section gives practical advice, typical ROOT commands, and example structures, but it does not prescribe a single exact solution. You will make choices that fit your particular dataset and analysis goal.
As you read and work through these sections, you can develop your own macros, modify them to match your data, and gradually build a complete and coherent ROOT analysis from input to final report.
Views: 0
Where to Move
Move chapter:
- ☰ 1. Introduction to ROOT
- ☰ 1.1. What Is ROOT?
- ☰ 1.2. Installing ROOT
- ☰ 1.3. Starting ROOT
- ☰ 1.4. Your First ROOT Session
-
- ☰ 2. C++ Basics for ROOT
- ☰ 2.1. Why ROOT Uses C++
- ☰ 2.2. Variables and Data Types
- ☰ 2.3. Operators
- ☰ 2.4. Conditional Statements
- ☰ 2.5. Loops
- ☰ 2.6. Functions
- ☰ 2.7. Arrays and Vectors
-
- ☰ 3. ROOT Macros
- ☰ 3.1. What Is a ROOT Macro?
- ☰ 3.2. Running ROOT Macros
- ☰ 3.3. Functions Inside ROOT Macros
- ☰ 3.4. Compiling ROOT Macros
- ☰ 3.5. Organizing a ROOT Project
-
- ☰ 4. ROOT Objects and the ROOT Object Model
- ☰ 4.1. Introduction to ROOT Classes
- ☰ 4.2. Object Names and Titles
- ☰ 4.3. ROOT Collections
- ☰ 4.4. Inspecting ROOT Objects
-
- ☰ 5. Histograms
- ☰ 5.1. Introduction to Histograms
- ☰ 5.2. Creating a 1D Histogram
- ☰ 5.3. Filling Histograms
- ☰ 5.4. Drawing Histograms
- ☰ 5.5. Histogram Properties
- ☰ 5.6. Accessing Histogram Bins
- ☰ 5.7. Histogram Errors
- ☰ 5.8. Normalizing Histograms
- ☰ 5.9. Combining Histograms
-
- ☰ 6. Two-Dimensional Histograms
- ☰ 6.1. Creating 2D Histograms
- ☰ 6.2. Filling 2D Histograms
- ☰ 6.3. Drawing 2D Histograms
- ☰ 6.4. Projections
- ☰ 6.5. Profiles
-
- ☰ 7. Graphs
- ☰ 7.1. Introduction to TGraph
- ☰ 7.2. Creating a TGraph
- ☰ 7.3. Graph Styling
- ☰ 7.4. TGraphErrors
- ☰ 7.5. TGraphAsymmErrors
- ☰ 7.6. MultiGraph
-
- ☰ 8. Canvases and Plotting
- ☰ 8.1. TCanvas
- ☰ 8.2. Dividing a Canvas
- ☰ 8.3. Drawing Multiple Objects
- ☰ 8.4. Legends
- ☰ 8.5. Text and Annotations
- ☰ 8.6. Logarithmic Axes
- ☰ 8.7. Saving Plots
-
- ☰ 9. Styling ROOT Plots
- ☰ 9.1. ROOT Plot Styles
- ☰ 9.2. Axis Configuration
- ☰ 9.3. Line Styles
- ☰ 9.4. Marker Styles
- ☰ 9.5. Publication-Quality Figures
-
- ☰ 10. Mathematical Functions
- ☰ 10.1. Introduction to TF1
- ☰ 10.2. Built-in Functions
- ☰ 10.3. Custom Functions
- ☰ 10.4. Evaluating Functions
- ☰ 10.5. Function Integrals
-
- ☰ 11. Curve Fitting
- ☰ 11.1. Introduction to Fitting
- ☰ 11.2. Gaussian Fits
- ☰ 11.3. Polynomial Fits
- ☰ 11.4. Custom Fit Functions
- ☰ 11.5. Fit Parameters
- ☰ 11.6. Goodness of Fit
- ☰ 11.7. Fit Residuals
- ☰ 11.8. Fitting Graphs
-
- ☰ 12. ROOT Files
- ☰ 12.1. Introduction to ROOT Files
- ☰ 12.2. Creating ROOT Files
- ☰ 12.3. Writing Objects
- ☰ 12.4. Reading ROOT Files
- ☰ 12.5. Exploring ROOT Files
- ☰ 12.6. Directories Inside ROOT Files
-
- ☰ 13. TTrees
- ☰ 13.1. Introduction to TTrees
- ☰ 13.2. Creating a TTree
- ☰ 13.3. Filling a TTree
- ☰ 13.4. Writing a TTree to a File
- ☰ 13.5. Reading a TTree
- ☰ 13.6. Inspecting TTrees
- ☰ 13.7. Drawing Data from TTrees
- ☰ 13.8. Applying Selection Cuts
- ☰ 13.9. Branch Addresses
-
- ☰ 14. Event-Based Data Analysis
- ☰ 14.1. Understanding Event Data
- ☰ 14.2. Event Loops
- ☰ 14.3. Event Selection
- ☰ 14.4. Derived Quantities
- ☰ 14.5. Analysis Workflow
-
- ☰ 15. Working with Real Experimental Data
- ☰ 15.1. Importing Text Data
- ☰ 15.2. Converting Data to ROOT
- ☰ 15.3. Data Cleaning
- ☰ 15.4. Data Calibration
- ☰ 15.5. Signal and Background
-
- ☰ 16. Random Numbers and Simulations
- ☰ 16.1. Random Number Generation
- ☰ 16.2. Common Distributions
- ☰ 16.3. Simple Monte Carlo Simulation
- ☰ 16.4. Detector Resolution Simulation
- ☰ 16.5. Efficiency Simulation
-
- ☰ 17. Statistical Analysis with ROOT
- ☰ 17.1. Basic Statistics
- ☰ 17.2. Probability Distributions
- ☰ 17.3. Statistical Uncertainties
- ☰ 17.4. Chi-Square Tests
- ☰ 17.5. Confidence Intervals
-
- ☰ 18. Modern ROOT with RDataFrame
- ☰ 18.1. Introduction to RDataFrame
- ☰ 18.2. Loading Data
- ☰ 18.3. Filtering Data
- ☰ 18.4. Defining New Columns
- ☰ 18.5. Creating Histograms
- ☰ 18.6. Statistical Operations
- ☰ 18.7. Saving Results
- ☰ 18.8. Multithreading
-
- ☰ 19. ROOT and Python
- ☰ 19.1. Introduction to PyROOT
- ☰ 19.2. ROOT Objects in Python
- ☰ 19.3. Reading ROOT Files with Python
- ☰ 19.4. PyROOT and NumPy
- ☰ 19.5. PyROOT and Matplotlib
- ☰ 19.6. Choosing Between C++ and Python
-
- ☰ 20. Advanced TTree Techniques
- ☰ 20.1. Trees with Multiple Branches
- ☰ 20.2. Storing std::vector Objects
- ☰ 20.3. TChain
- ☰ 20.4. Friends
- ☰ 20.5. Efficient TTree Analysis
-
- ☰ 21. ROOT for Particle and Nuclear Physics
- ☰ 21.1. Four-Vectors
- ☰ 21.2. Particle Kinematics
- ☰ 21.3. Invariant Mass
- ☰ 21.4. Angular Distributions
- ☰ 21.5. Detector Spectra
-
- ☰ 22. Debugging and Common ROOT Problems
- ☰ 22.1. ROOT Object Ownership
- ☰ 22.2. Null Pointers
- ☰ 22.3. Segmentation Faults
- ☰ 22.4. Missing Histograms
- ☰ 22.5. ROOT File Problems
- ☰ 22.6. TTree Branch Problems
- ☰ 22.7. Histogram Range Problems
- ☰ 22.8. Fit Failures
- ☰ 22.9. Debugging ROOT Macros
-
- ☰ 23. Writing Better ROOT Analysis Code
- ☰ 23.1. Separating Analysis and Plotting
- ☰ 23.2. Using Functions
- ☰ 23.3. Using Header Files
- ☰ 23.4. Naming Conventions
- ☰ 23.5. Avoiding Hard-Coded Values
- ☰ 23.6. Configuration Parameters
- ☰ 23.7. Reproducible Analysis
- ☰ 23.8. Version Control with Git
-
- ☰ 24. Final Project
- ☰ 24.1. Project Overview
- ☰ 24.2. Analyze a complete scientific dataset using ROOT.
- ☰ 24.3. Import the Data
- ☰ 24.4. Explore the Dataset
- ☰ 24.5. Apply Data Selection
- ☰ 24.6. Create Histograms
- ☰ 24.7. Fit the Data
- ☰ 24.8. Calculate Physical Quantities
- ☰ 24.9. Estimate Statistical Uncertainties
- ☰ 24.10. Create Publication-Quality Figures
- ☰ 24.11. Save the Analysis Results
- ☰ 24.12. Write a Short Analysis Report
-
- ☰ 25. Appendices
- ☰ 25.1. A. ROOT Command Cheat Sheet
- ☰ 25.2. B. ROOT Histogram Classes
- ☰ 25.3. C. ROOT Graph Classes
- ☰ 25.4. D. Common TTree Commands
- ☰ 25.5. E. Common Drawing Options
- ☰ 25.6. F. Common Fit Functions
- ☰ 25.7. G. ROOT C++ Cheat Sheet
- ☰ 25.8. H. PyROOT Cheat Sheet
- ☰ 25.9. I. Common ROOT Errors and Solutions
- ☰ 25.10. J. Recommended ROOT Analysis Workflow
-
Comments
Please login to add a comment.
Don't have an account? Register now!