7.4. TGraphErrors
Table of Contents
X uncertainties
A TGraphErrors extends TGraph by storing an uncertainty for every point on both the X and Y coordinates. Instead of only arrays of $x_i$ and $y_i$, you provide four arrays: $x_i$, $y_i$, $\sigma_{x,i}$, and $\sigma_{y,i}$, where $\sigma_{x,i}$ and $\sigma_{y,i}$ are the uncertainties on each coordinate.
In ROOT, the class is called TGraphErrors. A typical constructor looks like:
int n = 5;
double x[5] = {1, 2, 3, 4, 5};
double y[5] = {2.1, 4.2, 6.3, 8.1, 10.2};
double ex[5] = {0.1, 0.1, 0.1, 0.1, 0.1}; // X errors
double ey[5] = {0.2, 0.2, 0.3, 0.3, 0.4}; // Y errors
TGraphErrors *g = new TGraphErrors(n, x, y, ex, ey);
g->Draw("AP");
The X uncertainties $\sigma_{x,i}$ are drawn as horizontal error bars centered on each $x_i$. If you set all ex values to zero, the graph still works, but horizontal error bars are not visible.
X uncertainties are usually relevant when the quantity on the X axis is not known exactly. Examples are beam energy with a small spread, calibration constants with uncertainty, or measurement time with a finite resolution. In such cases, each $x_i$ represents a central value, and $\sigma_{x,i}$ represents a one standard deviation spread or another chosen confidence measure.
You can also modify individual X uncertainties after creation:
g->SetPointError(ipoint, ex_new, ey_new);
where ipoint is the index of the point and ex_new is the new X error. SetPointError always expects both X and Y uncertainties.
To retrieve X errors, you can call:
double *ex_vals = g->GetEX();This returns a pointer to the internal array of X uncertainties, which you can read or change carefully.
In TGraphErrors, each point has its own X and Y uncertainty, stored separately. Horizontal error bars are controlled by the X uncertainties EX, and if you forget to fill or set them, ROOT will not draw any horizontal error bars for that point.
When plotting and fitting, X uncertainties may or may not be used by the fit, depending on the fitting method and options. Y uncertainties are typically the main input to chi-square fits, so do not assume X errors are automatically included in the statistical model unless specified in the relevant fitting chapter.
Y uncertainties
Y uncertainties are the most common reason to use TGraphErrors. Each data point $y_i$ has an associated uncertainty $\sigma_{y,i}$, which ROOT shows as a vertical error bar centered on the point.
In the constructor example above, the ey array provides these Y uncertainties. If you only care about Y errors, you can set all X errors to zero:
double ex[5] = {0, 0, 0, 0, 0}; // ignore X errorsand still take full advantage of Y error bars.
Y uncertainties usually come from counting statistics, instrumental resolution, or error propagation. For instance, if $y_i$ is a measured cross section, $\sigma_{y,i}$ might include both statistical and systematic contributions. The details of how to compute these belong to statistical analysis, but TGraphErrors provides the container and plotting.
You can adjust Y uncertainties point by point:
int i = 2;
double ex_old, ey_old;
g->GetPointError(i, ex_old, ey_old);
g->SetPointError(i, ex_old, 0.5); // change only Y errorTo access the whole array of Y uncertainties:
double *ey_vals = g->GetEY();
Do not change the size of this array; it is owned and managed by the TGraphErrors object.
When you draw the graph, the choice of drawing option controls how error bars appear. For example:
g->Draw("AP"); // axes and points, with error bars by default
g->Draw("PE"); // points with error bars, no axes resetSome styles can hide markers or lines but still show errors, while others focus on a clean line with visible bars. These fine details are part of graph styling.
In TGraphErrors, Y uncertainties define the vertical error bars and are typically used as the point-by-point uncertainties in fits. Make sure that the EY values are filled correctly, because many fitting methods interpret them as $1\sigma$ errors and build the chi-square as
$$
\chi^2 = \sum_i \frac{\left(y_i - f(x_i)\right)^2}{\sigma_{y,i}^2}.
$$
If you do not provide meaningful Y uncertainties, or leave them all equal, you may still get a visual plot with error bars, but any statistical interpretation based on those errors will be misleading.
Experimental measurements
TGraphErrors is particularly suited to represent experimental measurements where each data point consists of a central value and an uncertainty. In many analyses you have a small or moderate number of measurements, each at some X coordinate (for example energy, angle, time, or bin center), and you want to show both the measured value and its uncertainty.
Typical use cases include cross section measurements as a function of energy, detector efficiency versus threshold, calibration curves relating two measured quantities, or time evolution of a quantity with measurement errors at each time point.
A simple example that reflects a typical experimental dataset is:
const int n = 4;
double energy[n] = {50., 100., 150., 200.}; // MeV
double sigma[n] = {1.2, 2.5, 3.1, 3.8}; // arbitrary units
double dE[n] = {1.0, 1.0, 1.0, 1.0}; // energy resolution
double dSigma[n] = {0.1, 0.2, 0.2, 0.3}; // measurement errors
TGraphErrors *gXS = new TGraphErrors(n, energy, sigma, dE, dSigma);
gXS->SetTitle("Cross section vs energy;Energy (MeV);#sigma (arb. units)");
gXS->Draw("AP");
Here, each point represents an independent measurement. The horizontal bars show the uncertainty in the energy, and the vertical bars show the uncertainty in the cross section. The string passed to SetTitle encodes the plot title and the axis labels in a compact way.
When you later fit a model curve to these measurements, the graph already contains the uncertainties, so the fit can make use of them. The fitting procedures and their statistical interpretation are handled in the dedicated fitting chapters.
You can compare multiple measurements on the same plot by using several TGraphErrors objects and drawing them together, for example with a TMultiGraph. This allows a visual comparison of different experimental conditions or different datasets, each with its own error bars.
For clarity in experimental presentations, it is common to distinguish between purely statistical and total uncertainties. In practice, one often combines them in quadrature and stores the result in the EY array. The underlying decision about which uncertainties to include and how to combine them belongs to the physics and statistics of your analysis, while TGraphErrors provides a straightforward way to store and display the resulting error bars.
When using TGraphErrors for experimental data, ensure that each point’s errors accurately represent the uncertainties you intend to show. The visual impression of error bars heavily influences how others interpret the reliability and precision of your measurements, and any fits or further statistical analysis will typically assume that the stored uncertainties are correct.
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!