User Support News 15 Jan 2007

The items from which I expect feed-back are marked in red.

Tutorials

Next tutorial

The next tutorial is planned for the CMS week in February. The suggested, preliminary agenda is Benedikt has volunteered for the analysis session, and Sridhara and Christos are happy to organize the online selection tutorial. I'm waiting feedback
  • from Tommaso and Shahram: are there some reconstruction items which should be presented (it is not possible cover all)?
  • from Luca and Chris on the contents of the analysis part: standard contents and/or some more advanced features?

Local tutorials - a pilot project

For your information, there will be a local tutorial session in Finland in late March. This session can function as a pilot project for other institutes willing to organize local sessions but lacking expert speakers.

In order the local tutorials to be useful, they have to correspond to the needs of the audience. To assure it, we plan the following

  • the participants are asked to indicate their interests and needs in registration
    • has to be done early enough so that the agenda can be build and speakers can be contacted
  • the basic information will be provided as material to be studied before the tutorial session (for example, the chapter 3 of the WorkBook)
    • useful if the participants do not have the same level of expertise
  • the tutorial session will contain some more advanced examples chosen to correspond the interest of the participants
    • if the number of participants is small, a hands-on session can be organized
For such tutorials in general, the local institutes should
  • provide a room for with computing facilities
  • have a person to verify the computing environment, have CMSSW installed locally if a hands-on session is organized
  • be willing to pay the travel for two to three speakers.
The CMS User Support can help in
  • building the agenda
  • finding the material
  • finding the speakers.
Obviously, all institutes are free to organize their own tutorial sessions without an intervention from the CMS User Support, this service is meant to help institutes who do not have local experts.

Tutorial speaker - call for volunteers

I will send around a mail calling for volunteers for tutorial speakers, something like:
Dear all,
                                                                                             
this is a call for volunteers. We are regularly organizing tutorial
sessions at CERN on CMS software and computing for physics analysis and
these sessions have been very popular. Furthermore, many institutes
would like to organize local tutorials but it is often difficult to
find qualified speakers.
                                                                                             
We are now organizing a team of tutorial speakers. The purpose is to build
a pool of people who can be asked to give tutorials so that the load will
not always be on the same people. In many cases, tutorial material
exists already and it may only require updating for new tutorial sessions
in the future. If you think you will be able to give a tutorial on some
aspects of CMS physics analysis, please follow this link
http://cmsdoc.cern.ch/cms/cpt/UserSupport/tutorial_speakers.html
You will be asked to give the name of a contact person in your institute or your 
group leader and the choice of the candidate speakers will be discussed with the
conveners of the group concerned.

This is a great opportunity for young people to learn the details
of the field (you only learn something when you have to teach it...),
to get experience in teaching and get an occasion to travel.
You will also get help from the CMS User Support team on any aspects
of the tutorials. The convenors, supervisors and team leaders are kindly asked
to encourage the qualified group members to register.

If you have comments, send them to me as soon as possible. If there are no objections, this will go out later this week.

Documentation

Reminder:

  • WorkBook: to get started and up to first analysis
  • Reference Manual: brief description of content and purpose of each package
  • User Manual and Developers Guide:
    • all details of CMSSW
    • links to the Reference Manual - no duplication of information
    • description of algorithms
    • usage and "how-to" documents which are too detailed for the WorkBook
    • gathers information currently spread in numerous wiki pages to a single structure.

WorkBook

The WorkBook was reviewed and printed in December. Anne Heavey left us for another project, currently the main editors are Kati and Jenny Williams. We would need someone to continue the extremely valuable work done by Anne (checking language errors, verifying that the instructions are clear, taking care that new concepts are properly introduced and giving immediate feedback when contacted).

Some possibilities:

  • hire a new technical writer (who pays) or find a CMS institute already having one and willing to contribute (I do not know of any)
  • such work could be envisaged as a cross-faculty collaboration in some university in an English speaking country
  • find collaborators who will be able to share the work.
Any other suggestions?

Reference Manual

A L2 milestone has been proposed which requires that all the packages in the Reference Manual have an adequate documentation (minimum: brief description of its content and purpose). Please, propose a release for which this could be done (separate from other major software milestones) .

User Manual and Developers Guide

I have started collecting the information to the User Manual and Developers Guide. As a very first step, some Usage and How-To items have been moved to the User Manual. It is important that all such items are collected to a single well defined structure so that end-user (and developer) will easily find the information he is looking for. This means that all the pages concerning different CMSSW issues currently spread around in various wiki pages should be moved (moved, not copied) to the User Manual and that any new documentation pages should be created in the User Manual and not in the different project pages (for these issues the project pages should just link to the User Manual). Please have a look at the proposed structure and let me know if you are not happy with it.

I will work through the document section by section. To start with, I am trying to find a contact from the Framework group to work together with me here at CERN to prepare the Framework page. Liz, can you suggest someone? Some work has been done with Luca for Physics Analysis Tools and the very first steps with Christos for Online Selection.

Getting help

Savannah for user problems

More news next time

Helpdesk

More news later

-- CMSUserSupport - 15 Jan 2007

Edit | Attach | Watch | Print version | History: r2 < r1 | Backlinks | Raw View | WYSIWYG | More topic actions
Topic revision: r2 - 2007-01-15 - CMSUserSupport
 
    • Cern Search Icon Cern Search
    • TWiki Search Icon TWiki Search
    • Google Search Icon Google Search

    Main All webs login

This site is powered by the TWiki collaboration platform Powered by PerlCopyright & 2008-2019 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback