KAHIBARO Bookshelves
Discord Login Register

9.2. Axis Configuration

Axis titles

Every plot in ROOT should have clear, informative axis titles. Axis titles tell the reader what quantity is plotted and in which units. ROOT gives you full control over these strings and their appearance.

For most 1D objects you configure axis titles through the object’s axis. A very common pattern is to use the histogram’s helper:

cpp
h->SetTitle("Energy spectrum;Energy [MeV];Counts");

This single string contains three parts separated by semicolons: the overall plot title, the X axis title, and the Y axis title. This is quick for simple plots, but for fine control you will usually work directly with the axes:

cpp
h->GetXaxis()->SetTitle("Energy [MeV]");
h->GetYaxis()->SetTitle("Events / bin");

For graphs and functions the syntax is analogous:

cpp
g->GetXaxis()->SetTitle("Time [s]");
g->GetYaxis()->SetTitle("Position [cm]");

ROOT does not enforce any convention on units or formatting, so it is your responsibility to choose meaningful and consistent titles. It is good practice to always include units in square brackets and to use a readable style, for example p_{T} [GeV/c] for transverse momentum.

You can also change the font, size, and color of axis titles. Common methods on TAxis include

cpp
axis->SetTitleFont(42);   // a standard sans serif font
axis->SetTitleSize(0.05); // relative to pad size
axis->SetTitleColor(kBlack);

These settings let you match axis titles to the rest of the figure style, especially when preparing publication quality plots.

Always give axes clear titles with units, using consistent notation across all plots in an analysis.

Labels

Axis labels are the numbers or text marks that appear along the axes to indicate positions or categories. ROOT distinguishes between numeric tick labels and user defined textual labels.

For numeric axes, the default labels are automatic. You can control their appearance using:

cpp
axis->SetLabelFont(42);
axis->SetLabelSize(0.04);
axis->SetLabelColor(kBlack);
axis->SetLabelOffset(0.005); // distance from axis line

SetLabelSize uses a value relative to the pad size, not in pixels. If labels look too small when exporting to PDF, increase this value slightly.

For categorical or sparse data you may want to use text labels instead of numbers, for example for histogram bins that represent detector modules or particle types. In 1D histograms you can assign labels to bins:

cpp
h->GetXaxis()->SetBinLabel(1, "Module A");
h->GetXaxis()->SetBinLabel(2, "Module B");
h->GetXaxis()->SetBinLabel(3, "Module C");

ROOT will then draw these strings under the bins instead of numeric coordinates. In this case you often need to increase SetLabelSize and maybe rotate the labels using:

cpp
h->GetXaxis()->LabelsOption("v"); // vertical labels

or

cpp
h->GetXaxis()->LabelsOption("h"); // horizontal labels, the default

You can also control the number of numeric labels and their format. For example, to reduce clutter on a logarithmic axis or when values are very large or very small, you can use:

cpp
axis->SetNdivisions(510);          // main and secondary tick divisions
axis->SetNoExponent(kTRUE);        // avoid scientific notation on axis
axis->SetMoreLogLabels(kTRUE);     // better label placement on log axes

These options give you direct control over readability. If labels overlap or look crowded, adjust the number of divisions and label size until the axis is clear.

Do not let labels overlap or become unreadable. Adjust label size, spacing, or number of divisions to keep axes clear.

Title offsets

Title offset controls how far the axis title is placed from the axis and its labels. If the offset is too small, the title overlaps with tick labels. If it is too large, the title appears visually detached from the axis.

You change title offsets through the axis:

cpp
axis->SetTitleOffset(1.2);

The numeric value is relative and dimensionless. Typical values depend on the axis direction and canvas aspect ratio.

For most rectangular plots a useful starting point is:

cpp
h->GetXaxis()->SetTitleOffset(1.1);
h->GetYaxis()->SetTitleOffset(1.4);

The Y axis usually needs a larger offset than the X axis because the title is drawn vertically and must clear the numeric labels to remain legible.

If you change the pad margins, especially the left margin, you will often need to retune the Y axis title offset to keep titles inside the visible area and avoid collisions with the frame. For example, after increasing the left margin:

cpp
gPad->SetLeftMargin(0.15);
h->GetYaxis()->SetTitleOffset(1.8);

For 2D histograms and plots with a Z axis the same principle applies:

cpp
h2->GetZaxis()->SetTitleOffset(1.2);

Adjusting the Z axis offset is important if you have a color bar with a title, so the title does not overlap with numeric scale labels.

If you change pad margins or text sizes, revisit SetTitleOffset on each axis so titles remain readable and properly aligned.

Axis ranges

Axis range configuration controls which part of your data is visible and how it is displayed. ROOT chooses an automatic range by default, but for analysis and presentation you often want explicit control.

The simplest way to set a numeric range is with SetRangeUser on the axis:

cpp
h->GetXaxis()->SetRangeUser(0.0, 10.0);
h->GetYaxis()->SetRangeUser(0.0, 100.0);

This keeps the full histogram data in memory but shows only the selected interval. For graphs the pattern is the same:

cpp
g->GetXaxis()->SetLimits(0.0, 10.0); // for TGraph

Ranging via object methods like hist->GetXaxis()->SetRangeUser is part of styling and does not modify the underlying bin contents.

You can also zoom interactively in the ROOT canvas by dragging with the mouse. When you have found a good range interactively, you can read it back and hard code it in a macro for reproducibility.

On logarithmic axes, the range has an additional constraint. The visible part of the axis must stay strictly positive, since log(0) and log of negative values are undefined. Make sure your lower bound is greater than zero, for example:

cpp
gPad->SetLogy();
h->GetYaxis()->SetRangeUser(1e-1, 1e4);

If you set a lower bound of zero on a log axis, ROOT will ignore that value and may emit warnings. Always check that minimal positive values are used when combining log scaling with custom ranges.

To focus on a specific subset of data, you can use ranges directly on the X axis while still keeping all Y values. For histograms:

cpp
int binLow  = h->GetXaxis()->FindBin(2.0);
int binHigh = h->GetXaxis()->FindBin(5.0);
h->GetXaxis()->SetRange(binLow, binHigh);

This selects a range by bin index rather than numeric value. It is useful when you know bin indices from previous calculations.

For clarity in multi plot figures, keep axis ranges consistent across related plots. If you compare two histograms, give them the same X and Y ranges so visual differences represent physics, not changing scales.

Never rely only on automatic ranges when comparing plots. Explicitly set consistent axis ranges so visual comparisons are meaningful.

Views: 0

Comments

Please login to add a comment.

Don't have an account? Register now!

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