Documentation

Welcome to the ROOT User's Guide page. From here you can download the current version of the User's Guide or only the chapters you are interested in. Each chapter is available in the Adobe Portable Document Format (PDF) to help you to find faster answers from the basics of getting started up to the detailed information on how to use ROOT advanced features. We will appreciate your comments on this edition. If you would like to contribute to a chapter, section, or even a paragraph, do not hesitate to contact us and send your comments to: rootdoc@root.cern.ch

Files available for download:

User's Guide v5.21

1 page per sheet  ~9MB

User's Guide v5.21 TwoInOne

2 pages per sheet ~7MB

User's Guide v5.21

MSWord Doc ~13MB

User's Guide v5.21

Preface, Table of Contents and Table of Figures


Introduction

1

 

Collection Classes

283

 

Contact information, used conventions, the ROOT framework

 

 

 

Collection types, general characteristics, iterators, memory management, hash tables

 

Getting Started

9

  Physics Vectors

291

 

Two examples to start, coding conventions, global variables, ROOT environment, HBOOK/PAW Files    

 

The TVector3 and TLorentzVector classes, rotation algorithms, transformations  

Histograms

23

 

The Geometry Package

299

 

Creating and filling histograms, drawing options, histogram features    

 

Geometrical modeler, shapes, available transformations, navigation, tracking, checking and visualization  

Graphs

51

  Python and Ruby Interfaces

351

 

Creation of graphs, draw options, errors, graph filling, exclusion zone    

 

PyROOT and RubyROOT are Python and Ruby extension modules allowing an interaction with ROOT/CINT  

Fitting Histograms

65

  Tutorials and Tests

365

 

Fit panel, methods and functions, parameter setting, sub-ranges, the package Minuit

      ROOT examples in tutorials and test directories: Event application, benchmarks  

A Little C++

81

  Example Analysis

371

 

Classes, methods and objects; inheritance and data encapsulation

   

 

An example of typical physics analysis of large data files chained together

 
CINT the C++ Interpreter

85

  Networking

377

 

CINT command line interface, scripts, inspecting objects, ACLiC compiler

   

 

The use of ROOT socket classes for sending data over the network

 

Object Ownership

101

  Threads

379

 

The ownership by current directory, by master TROOT object, by user

   

 

Thread classes, threads and processes, known problems

 

Graphics and Graphical User Interface

105

  PROOF: Parallel Processing

387

 

Graphical containers: canvas and pad, graphical objects, axis, legends, postscript interface, 3D viewers

   

 

The parallel ROOT facility

 

Folder and Tasks

155

  Writing a Graphical User Interface

389

 

How to create folder hierarchy, posting/reading data to/from a folder, execute and debug tasks

   

 

Widgets and frames, layout management, signals/slots event processing

 

Input/Output

159

  ROOT / Qt Integration Interfaces

423

 

The ROOT files, streamers, pointers and references, schema evolution

   

 

Qt BNL and Qt GSI ways of access to the ROOT graphics

 

Trees

189

  Automatic HTML Documentation

433

 

Using trees, branches, examples for writing and reading trees, trees in analysis

   

 

The automatic generation of ROOT reference guide

 

Math Libraries in ROOT

233

  Install and Build ROOT

437

 

MathCore and MathMore libraries and their set of mathematical and statistical functions

   

 

Installing ROOT, copyright and licensing agreement; system.rootrc settings  

Linear Algebra in ROOT

257

  Index

447

 

Overview of the matrix classes available in the linear algebra library

   

 

Detailed index, all ROOT classes and their methods used in this User's Guide

 

Adding a Class

271

   

 

 

TObject, the CINT dictionary generator, adding a class with a shared library, with ACLiC

   

 

   

           ROOT Packages Documented Elsewhere

RooFit A toolkit for modeling the expected distribution of events in a physics analysis

TMVA A toolkit for Multivariate Data Analysis


Versions

Revision History

Date

v5.21 Download

Updates and fixes

See changes

18-Nov-2008

v5.20 Download

Updates and fixes

See changes

30-Jul-2008

v5.16 Download

New sub-chapters, updates and fixes

See changes

16-Jul-2007

v5.14 Download

New sub-chapters, updates and fixes

See changes

20-Dec-2006

v5.12 Download

New sub-chapters, updates and fixes

See changes

11-Jul-2006


 

Last update: 18-Nov-2008