ROOT in STAR

STAR Computing
ROOT in STAR
	Maintenance Valeri Fine

Learning to use ROOT for STAR

ROOT environment

To use ROOT framework some environment should be provided.

ROOT environment is set in two steps.

set ROOTSYS environment variable (on UNIX machines it is done by STAR login script)
Adjust the ROOT profile ".rootrc". This file contains some information ROOT consumes. ROOT looks for this file in

current directory
user's home directory
$ROOTSYS directory

The last means if you do nothing special your ROOT defaults are defined via the $ROOTSYS/.rootrc profile. ROOT profile defines many useful parameters. For example it defines

ROOT macro search path
ROOT dynamic library search path
the name and place of the root logon macro that is executed just one launches the ROOT session before he sees any ROOT prompt.
the name and place of the root alias macro that is loaded just before any ROOT
script is executed.

Below we present the piece of the STAR ROOT profile:

Unix.*.Root.DynamicPath: .:$(ROOTSYS)/lib:$(STAR_LIB):$(STAF_LIB)
Unix.*.Root.MacroPath: .:$(STAR)/StRoot/macros:$(STAR)/StRoot/test:$(ROOTSYS)/macros
WinNT.*.Root.DynamicPath:./;$(ROOTSYS)/star/bin;//Sol/afs_rhic/star/packages/dev/.intel_wnt/bin;$(ROOTSYS);$(ROOTSYS)/bin;$(PATH)
WinNT.*.Root.MacroPath:./;$(home)/root/macros;$(ROOTSYS)/tutorials;$(ROOTSYS)/star/macros;//Sol/afs_rhic/star/packages/dev/.intel_wnt/bin;$(ROOTSYS)/macros

# Rint (interactive ROOT executable) specific alias, logon and logoff macros
Rint.Load: $(ROOTSYS)/tutorials/rootalias.C
Rint.Logon: $(STAR)/StRoot/macros/rootlogon.C
Rint.Logoff: $(ROOTSYS)/tutorials/rootlogoff.C
Rint.History: $(HOME)/.root_hist

To see some ROOT startup options just type root4star to get:

J:\Public\root>root4star -h
Usage: root [-l] [-b] [-n] [-q] [file1.C ... fileN.C]
Options:
  -b : run in batch mode without graphics
  -n : do not execute logon and logoff macros as specified in .rootrc
  -q : exit after processing command line macro files
  -l : do not show splash screen

How to start STAR ROOT demos on UNIX
(Sun Solaris and Linux only, for the moment)

Select on the latest STAR Library versions:

starpro - to select <pro> version

stardev - to select <dev> version

starnew - to select <new> version

starver 98j - to select the version <98j> of STAR library

Type:
- root4star
See the Html version of the STAR_demos on Web below.

How to quit STAR ROOT

To end the interactive ROOT session just type ".q" command as follows:

root [3] .q
This is the end of ROOT -- Goodbye

How to install ROOT and start STAR ROOT demos with Windows NT

Click "START" button
Select "Run"
Type:
- \\hepburn\info\installation
Double click "ROOT icon"
Watch for ROOT banner:

See the Html version of the STAR_demos on Web below.
Read using "ROOT in Windows" by Andew Haas

ROOT integration into STAR offline

See the ROOT-related tutorials on the tutorials page
Class index of STAR-specific ROOT classes
How to call STAF module, Valeri Fine (fine@bnl.gov)
How to read the event from XDF file and build some histograms with ROOT , Valeri Fine (fine@bnl.gov)
How to pick the XDF file up with ROOT , Valeri Fine (fine@bnl.gov)
How to analyse multiple DST XDF files (de/dx vs p (GeV)), Craig Ogilvie
How to create a simple chain, Valeri Fine (fine@bnl.gov)
Example of ROOT use as physics analysis tool (Z-scaling in STAR), M. Tokarev and L. Potrebenikova

ROOT in STAR and RHIC

ROOT is under evaluation for use as an analysis tool in STAR, with possible application also for parts of the transient and persistent OO/C++ data model we plan to migrate to.
State of ROOT in STAR as of 6/23/98

CDF event store decision - BNL talk by Pasha Murat 6/16/98
Brun's transparencies from his 5/98 STAR visit
PHENIX ROOT tutorials, Mark Pollack
ROOT 1.03/09 release at RHIC, Victor Perevoztchikov
xdf2root, Herb Ward
ROOT access from STAF PAMs, Mark Pollack

ROOT-generated code documentation

ROOT itself (from CERN; we need a local copy, integrated with doc of our own classes)
Local ROOT-generated documentation
- Class index
STAR online software