Babar logo
SPIRES E S & H Databases PDG arXiv
Organization Detector Computing Physics Documentation
Personnel Glossary Sitemap Search Hypernews
Unwrap page!
 1. Introduction
 2. Accnt. Setup
 3. QuickTour
 4. Packages
 5. Modules
 6. Event Info.
 7. Tcl Cmds.
 8. Editing
 9. Comp.+Link
 10. Run the Job
 11. Debugging
 12. Parameters
 13. Tcl Files
 14. Find Data
 15. Batch
 16. Analysis
 17. ROOT I
 18. Kanga
Additional Info.
 Other Resources
 SRT/CVS Cmds.
 CM2 NTuples
 Root II, III
 tcsh Script
 perl Script
Check this page for HTML 4.01 Transitional compliance with the
W3C Validator

(More checks...)

Workbook Introduction

How to use the Workbook

The Workbook is divided into two sections: the Workbook Core, and Additional Information. The Workbook Core is the "mandatory" section, and Other Workbook Pages is the "optional" section.

The Workbook Core

All users should work through the Workbook Core. The Workbook Core is made up of different sections. Many of the later sections assume that you have completed the earlier sections, so it is important to complete the sections in order.

Some of the Workbook Core sections include tutorials/examples, while others are mostly read-only documents. The examples will teach you how to use BaBar software, and can be very useful as a guide later on when you are ready to perform your own analysis. The read-only sections are also very useful, because they will help you to understand what you were doing in the tutorials.

Once you have completed the Workbook Core, you will have mastered the fundamentals of working with BaBar software and running analysis code.

Additional Information

The "Additional Inforamtion" are pages that do not belong in the Workbook Core. Unlike the pages of the "Core", they are not interdependent - you can choose to read/try any or none of them. You do not have to complete them in any particular order.

The Additional Inforamtion Workbook Pages have been futher divided into four different categories:

  • Reference - Some read-only reference information about BaBar and SLAC. Independent of the Workbook Core.
  • Basic tutorials - You will need to learn unix and C++ at some point during your BaBar career.
  • Advanced Tutorials - These are optional tutorials that are more advanced than the ones in the Workbook Core. The skills they teach may not be needed by all users.

Workbook Contents

Here is a list of the contents of the BaBar Workbook, with a brief description of each section. The following sections should be completed in order. The descriptions may help you to decide what pages in the "Other" section you want to use.

  1. Introduction
    How to use the Workbook.
  2. Account Setup
    How to set up your SLAC Account.
  3. QuickTour
    A quick tutorial in which you perform all the basic steps of a BaBar analysis. This section is the core of the Workbook; most other pages refer back to it as the main example.
  4. Packages and Releases
    Packages and releases: what they are, how they are named, and how they are organized in BaBar's file system. How to use SRT/CVS commands to check out releases and packages.
  5. Modules and the Framework
    Introduction to modules. How modules are put together to make an analysis job.
  6. Event Information
    How to access the event information, and what information is available. Includes tables of the main particle candidate lists and event variables in the Event Store database.
  7. Tcl: Run-time Job Control
    How to interact with the Framework and talk to modules.
  8. Editing Module Code
    How to write code in modules. Using the main C++ objects: HepHistogram, HepTuple, BtaCandidate, and HepAList.
  9. Compile and Link
    All about gmake, BaBar's compile-and-link utility.
  10. Run the Job
    How to run BaBar executables. Program flow. The workdir package.
  11. Debugging
    Using the debuggers to track run-time errors.
  12. Run-time Parameters
    How to make module parameters into run-time parameters.
  13. Tcl Files
    Basic Tcl commands. How Tcl files work. Tcl files in the context of packages.
  14. Find Data
    Using BbkDatasetTcl to find data, and to produce tcl files that can be used as input to an analysis job.
  15. Batch Processing
    How to use the batch system. Batch commands. The batch queues and what they are for. Computing CPU time for batch system log files.
  16. Analysis Tools
    An overview of important analysis tools, including PID, vertexing and fitting, particle composition, and more.
  17. ROOT I
    An introduction to ROOT. Focus is on histograms. Soon will be updated to include a section on TTrees.
  18. Interactive Kanga
    Resources for using Interactive Kanga.

[Workbook Author List] [Old Workbook] [BaBar Physics Book]

Valid HTML 4.01! Page maintained by Adam Edwards

Last modified: May 2008