First Presentation to CMS Software Group on the Offline Workbook

Purpose of Workbook

• Workbook is intended as a comprehensive, but not detailed, introduction to the CMS offline system.
• Goal: after a new CMS member works through the workbook from beginning to end, he or she is familiar with all the concepts and tools that are involved in CMS analysis, and has learned how to create, configure, and run simple analysis jobs.
• Maybe after initial goal is met, add more detailed information.
• The workbook should also serve as a useful introduction to new developers, and should provide an introduction for more expert users to new aspects of the CMS software and analysis tasks.

Philosophy

• Keep explanations brief, and provide links to supplementary information (the supplementary info should NOT be needed in order to complete the workbook)
• Use a step-by-step format wherever possible
• Include a set of tutorials for the various tasks
• Organization (table of contents) will evolve to accommodate content (form follows function)
• Make the information accessible from two points of view: the detector framework, and the computing model.

Participants and Contributors

• Lucia and Avi
  • are ultimate decision-makers for workbook structure and content
  • provide guidance on structure, content and priorities
  • provide names of experts on various topics for workbook content
• Anne
  • about me: studied physics long ago, worked at SLAC (BGO research) and CERN (L3). Later found my niche as a technical writer, and have been working as such in the Computing Division at Fermilab for several years. I can communicate in French and Italian in case that helps any of you.
    Now, my role in the workbook:
  • reports to Avi and Lucia
  • is available ~20 hr/week
  • coordinates/manages project
  • solicits, gathers, compiles, edits content
• Jenny
  • about Jenny (in her words): "I'm a postdoc at the University of Canterbury, Christchurch, New Zealand newly working on the CMS experiment. I joined in november last year, in one of the smallest groups on CMS. In my last job I was for 5 years a postdoc on BaBar doing tau physics analysis and working as editor of the BaBar workbook (http://www.slac.stanford.edu/BFROOT/www/doc/workbook/workbook.html)."
    Now, her role in the workbook:
  • reports to Avi and Lucia (keeping Anne in the loop!)
  • can devote a day or two per week, I believe
  • works with Anne to solicit, gather, compile, edit content
  • responsible for twiki configuration
• CMS members (offline-related)
  • respond to requests for information (existing doc, new content, clarifications, etc.)
  • respond to requests for review/update of information
  • may offer suggestions for content and organization (encouraged!)
  • may offer content (strongly encouraged!)

Initial Work completed or in progress

• The workbook is in twiki format, as part of the CMS twiki (see Offline Work Book (CMSSW User Guide)
• Jenny got assistance from Atlas workbook people and has configured the CMS workbook twiki similiarly to theirs.
• Initial organization (table of contents) agreed to by Anne, Jenny, Avi, Lucia, and has been entered into twiki
• Initial content in progress:
  • CMSSW Tutorial (twiki-ized version of J. Mans and P. Dudero revision February 9, 2006)
  • Description of computing model and detector framework (I need to understand this before moving ahead on special topics!)
  • Some initial admin pages (purpose, formatting rules, how to get account, etc.)

Workplan

• Set up hypernews forum for workbook documentation; purposes:
  • discussion of content and organization of the workbook
  • a staging place for suggested new content from CMS contributors
  • request review of content here prior to adding directly in workbook
• We have not yet set any projected completion dates for any sections
• First priority: How to run the analysis application (Filip Moorgat/Joanna Weng are contacts for the generation part, Julia Yarba on the Simulation and Digitization part)

Experts Identified

• Oliver Gutsche -- overview of computing model
• Liz Sexton-Kennedy -- analysis framework, EDM
• Nicola Amapane -- muon barrel tutorial
• Emilio Meschi -- Event Filter
• Christos Leonidopous -- Data Quality Monitoring
• Filip Moorgat/Joanna Weng -- Generation
• Julia Yarba (also Maya and Daniel) -- Simulation
• Stefano Argiro -- Development tools, releases etc.
• Tommaso Boccali -- Reconstruction
• Luca Malgeri -- Calibration
• Oliver Buchmuller -- Alignment
• Mike Case -- Geometry
• Luca Lista -- Data Formats for Analysis and Physics Tools

-- AnneHeavey - 02 Mar 2006