This page contains all tutorials on STAR computing. Report inaccuracies and deficiencies to the maintainer. Comments welcome; send to starsofi-hn@www.star.bnl.gov. Please contribute tutorials! There's a template in /afs/rhic/star/doc/www/comp/train/tut/template.html.
Use the icon to flag new and heavily modified tutorials.

GENERAL

RCF Monitoring

• RCF monitoring shifts for Year2
• RCF monitoring shifts for Year3

Computing environment

• If you're new to STAR
• Getting help and reporting problems
• Setting up your computing environment
• Setting up a Mac OS X machine for STAR offline computing
• Setting up a user account for AFS home directory owners

• Information on Available Facilities

• Guide to AFS and ACLs in STAR
• Guide to the computing web and web development
• Using CVS in STAR
• Usage of cons (make replacement) in STAR
• KAI KCC documetation

OFFLINE SOFTWARE

STAR Offline Software - General

• Introduction to the Computing Environment (2003, Betty Bezverkhny)
• Basics for using the STAR offline computing environment
• Setting up your offline computing environment
• Software releases and release policy
• Offline directory structure
• Developing offline software
• Building your own release copy
• Building your own environment (offsite)

ROOT for STAR

• ROOT in STAR
• STAR's ROOT C++ classes and the source tree organization
• PAW to CINT/ROOT equivalences
• StAF to CINT/ROOT equivalences

Using ROOT in STAR

• I/O and DB Maker Operation

DST production and analysis

Running Production

• bfc.C Usage - to run DST production
• bfc.C Maker Names - set when calling constructor of each Maker
• bfc.C output files - written during production

Reading DST Files in table format:

• Reading/Examining table DST files - available library macros & usage

Reading DST Files and converting to StEvent format:

• StEvent Tutorial
• doEvents.C usage - Analyzing DSTs using StEvent, filling physics tags
• doEvents.C Maker Names - set when calling constructor of each Maker
• Analysing DST files using StEvent - available library macros & usage

Reading StEvent Files and analyzing :

• Reading/Examining StEvent DST files - available library macros & usage

STAR Offline Software - Development

• Software Packages - Directory Structure and Explanation (domains, packages, modules)
• How to document software packages
• How to create a new or edit an existing software package
• How to change an existing Module
• How to test your changes to reconstruction code - used during chain to produce DST
• Commit your new/changed Module to CVS
• How to change an existing IDL-defined table
• C to C++ conversions
• Status Codes used by root4star

Info about developing offline software

• Developing C++ software for STAR

• The STAR Class Library

• How to use Insure++/CodeWizard

• C++ coding standards

• How to use dynamically created arrays in FORTRAN to save memory

Standard ROOT

• Root educational resources at Fermilab

• Root course by Fons Rademakers, 76p (incomplete, but a good place to start)

• ROOT Primer by Soren Lange

• ... much more info on the ROOT tutorial page

• ROOT class reference guide

GSTAR Simulation software

• GSTAR detector simulation tools

• GSTAR setup kumacs and scripts

• Handling of secondaries in GSTAR

Windows NT in STAR

• Introduction to Windows NT - D. Olson

• Using the offline software on Windows NT - V. Fine

TUTORIAL SESSIONS

Tutorial Sessions

STAR offline software tutorials are generally held monthly (first Friday of the month), with more extensive sessions surrounding the collaboration meetings.

Needless to say, old tutorials are out of date and are here only as an archive.

• Summer 2000 tutorials
  • Basics for using the STAR offline computing environment
  • Star C++ Examples Tutorial
  • StEvent Tutorial

  • HBT Tutorial

• Dec '99 computing week tutorials
  • Agenda
  • STAR Software Basics - Kathy Turner
  • Basic Design, Layout and Information about STAR Offline Software - Kathy Turner
  • Basics of Using ROOT in STAR Offline Software to do data reconstruction (bfc), DSTs, histogramming, examples - Kathy Turner
  • Event Display (ROOT) - Wensheng Deng
  • StEvent Data Structures in ROOT - Gene Van Buren
  • L3 Code in bfc - Dominik Flierl
• Oct '99 computing week tutorials
  • Agenda
  • bfc in ROOT - running, reading output dsts, making histograms - Kathy Turner
  • GSTAR - single particles - Pavel Nevski
  • Automatic QA System Demonstration - Peter Jacobs
  • StEvent description and usage - Gene Van Buren
  • CERNLIB matrix packages - Valeri Fine
• Aug '99 collaboration meeting tutorials

  • Agenda

  • STAR software and ROOT basics - Gene Van Buren
  • Using ROOT for offline - Kathy Turner
  • Databases - Jeff Porter
  • STAR online software - Claude Pruneau
  • Data Set Visualization (DSV) Program - Duncan Prindle
  • EventDisplay Maker in ROOT - Valeri Fine
• July 9, 1999 tutorials, 2:30 - 5:30 in Bldg. 118
  • Announcement

  • Basics of STAR computing environment and software - Kathy

• May 28 tutorials, 10am in B.118
  • Announcement, request for input

  • How to read in DST produced from bfc.C using bfcread.C - Kathy - for software versions 99d,99e

• Apr 2 tutorials

  • Basics of STAR computing environment and software - Kathy - 40min

  • Guide to the revised Maker scheme - Gene or Victor - 40min

  • STAR analysis tutorial - Gene - 60min
  • STAR database tutorial - Jeff - 60min

• Feb '99 collab meet tutorials

• Jan 8, 1999 tutorials at BNL
  • How-to on ROOT based software - from the end-user perspective (Akio Ogawa, Gene Van Buren)
  • Break
  • Chains, Makers and all that - technical details and questions answered (Yuri Fisyak, Valery Fine)
• November 6, 1998 Tutorials at BNL:

  • 9am: Using the offline software on NT with standard makefiles (Valery Fine)

  • 10:30am: GSTAR tutorial (Pavel Nevski)
• October 2, 1998 Tutorials at BNL:
  • Offline Software Tutorial: STAF-based (Kathy Turner)
  • Offline Software Tutorial: ROOT-based (Valery Fine)
• July 1998 Tutorials: Information, Offline tutorial
• March 1998 Offline Computing and Software Tutorials
• January 1997 Offline software training school
• October 1997 Wayne State training school

ARCHIVES

ROOT info

• ROOT based EMC software: Akio's ROOT diary (last updated '98)

• ROOT based TPC test analysis: Bill Love's ROOT experiences (last updated '98)

STAF-based Offline Software (this may be no longer valid - May99, Kathy)

• Introduction to STAF

• Basic STAF Commands

• PAM initialization and foreign key usage

Using STAF to run Offline Software (this may be no longer valid - May99, Kathy)

• Building STAF executable

• Running STAF
• Kumac Usage and Approach
• Guide to STAF kumacs
• Currently available kumacs
• Table Directory Structure in STAF
• Details of big full chain kumac
• Example kumacs used to run BFC kumac
• Example kumacs used to read DSTs using BFC kumac
• How to run Example Kumacs in STAF
• Output file structure from BFC
• How to run GSTAR with standard kumacs
• GSTAR settings in BFC
• How to use "user" chain in BFC to execute your own kumacs or commands
• Info on how to do your analysis using BFC

Developing Code for STAF (this may be no longer valid - May99, Kathy)

• Creating new Module (incl. PAM and Domain)

• Testing new/changed Module using BFC

• Test CVS version of your new/changed Module

• Example PAMS/modules