CVS Version Tree Display Richard Thomas Benedict College Supervisor Dr. David J Ritchie Computing Division Fermilab Summer 2003

Introduction My project… My project… –Created a software program –That will be used at the DZero experiment –That will provide a display Of source code Of source code –Organized version by version –In a web table format But, first, some background… But, first, some background…

Background Nature is based on… Nature is based on… –four forces: gravity, the electromagnetic force, the weak force, and the strong force. –30 years of experiment and theory have resulted in… the Standard Model (SM). the Standard Model (SM). During the 1960’s and 1970’s, research showed that During the 1960’s and 1970’s, research showed that –Electromagnetic and weak forces could be unified... –Strong force and gravity are still separate. The Standard Model… The Standard Model… –Is believed to be only an approximate theory. –May show through these approximations areas of “new physics” One of the goals of Fermilab is to explore these areas. One of the goals of Fermilab is to explore these areas.

The DZero Experiment Fermilab accelerator complex collides… Fermilab accelerator complex collides… –Proton and anti-proton beams –At the world's highest energy: 900 GeV in each beam. –At two locations: CDF and DZero The DZero experiment The DZero experiment –Was proposed in 1983 and approved in –Recorded its first antiproton-proton collision on May 12, –Took data during Run 1: 1992 – 1996 –Is now taking data for Run 2a –Is Planning to take data as Run 2b in the near future.

The DZero Detector Tracking chambers: purple, gray and pink. Tracking chambers: purple, gray and pink. Calorimeters: yellow, blue, and green. Calorimeters: yellow, blue, and green. Muon chambers: orange. Muon chambers: orange. Iron magnets: red. Iron magnets: red.

The DZero Software… Is custom-written. Is custom-written. Is in the C++ programming language. Is in the C++ programming language. Grouped into units called packages. Grouped into units called packages. Is how the experiment is monitored, controlled, read-out, and analyzed. Is how the experiment is monitored, controlled, read-out, and analyzed.

DZero Software Releases Test releases issued weekly. Test releases issued weekly. –Introduces new features into packages. –May have bugs. Production releases issued every three months. Production releases issued every three months. –Based on a test release –Has only bug fixes made to packages. –Intended to be used to produce publishable results. –Must be as correct as possible!!!

Example: The d0reco package Characteristics Characteristics –One of 500 packages –Many versions to date (>50) –Kept in the Concurrent Versions System (CVS) repository –All versions kept –Can list its version history with… cvs history –Tan d0reco cvs history –Tan d0reco Operation – the developer… Operation – the developer… –Checks out the d0reco package –Makes changes (to add new features or fix bugs). –tests, changes, tests until tests are successful. –Checks package back into CVS giving it a unique identifier (a “tag”). A tag must follow a standard format. Example: A tag must follow a standard format. Example: Trunk release: v Trunk release: v Test release: t Test release: t Production release: p Production release: p

Tag Syntax Designates what is being done. Designates what is being done. –Example: p14-br marks the checked in package as the latest production release of “p14”. p14-br marks the checked in package as the latest production release of “p14”. Known as the “head of the p14 branch” Known as the “head of the p14 branch” –Example: t marks the checked in package as the test release t t marks the checked in package as the test release t –Example: V marks the checked in package as a trunk version v V marks the checked in package as a trunk version v Other information (from the cvs history output): Other information (from the cvs history output): –[p14–br:v ] says that the p14 branch has been created as split off the main development at v

Project Goal Phase 1: Phase 1: –Write a Python program that… analyzes the output from a CVS history command analyzes the output from a CVS history command displays the versions as a web page (html table). displays the versions as a web page (html table). Phase 2: Phase 2: –Extend the program to provide an option to display graphically using the Python software called Tkinter.

The Program written in Python written in Python –The programming language chosen by Dzero for this sort of application –uses the HTMLgen Python extension to write HTML from Python Uses functions to organize tasks. Uses functions to organize tasks.

Functions A means to A means to –group a set of statements into one place and –give it a name so that they can be run more than once in the program. Let’s us specify parameters, which may differ each time a function’s code is run. Let’s us specify parameters, which may differ each time a function’s code is run.

Function Definitions def print_menu(): def print_menu(): –displays a menu of user options. def print_all_data(bodylist): def print_all_data(bodylist): –generates an output of all the tags loaded in the repository. def print_trunk_data(bodylist): def print_trunk_data(bodylist): –gives the tags on the trunk of the development tree. def print_p13_branch(bodylist): def print_p13_branch(bodylist): –returns the tags on the p13 branch in the order of creation. def print_p14_branch(bodylist): def print_p14_branch(bodylist): –returns the tags on the p14 branch in the order of creation. def print_p15_branch(bodylist): def print_p15_branch(bodylist): –returns the tags on the p15 branch in the order of creation. def load_data(filename): def load_data(filename): –loads a file containing the result of the history command. def main(): def main(): –the main program which is called.

Results This is a example of the result of a test run of the program. This is a example of the result of a test run of the program.

Branch Report The branches are as follows: Module AuthorDateTimeZoneModuleTag trunk serban : d0reco [v :A] serban : d0reco [v :A] serban : d0reco [v :A] p14 jonckh : d0reco [p14-br:p a] melanson : d0reco [p14-br-01:p14-br] p15 jonckh : d0reco [p15-br:v ] jonckh : d0reco [p :v ] suyong : d0reco [p15-br-01:p15-br] jonckh : d0reco [p :p15-br-01]

Conclusion The purpose of this project was to write a program that displays the output of a cvs history command as a web page. The purpose of this project was to write a program that displays the output of a cvs history command as a web page. The project was a success. The project was a success. It is expected that future versions will result in a useful tool to present this information. It is expected that future versions will result in a useful tool to present this information.

Acknowledgements I would like to thank David Ritchie, Alan Jonckheere, Paul Russo And Geoff Savage for taking the time out to mentor me and making sure that my experience here was the best possible. I would like to thank David Ritchie, Alan Jonckheere, Paul Russo And Geoff Savage for taking the time out to mentor me and making sure that my experience here was the best possible. I would also like to give a special thank you to the SIST Committee. I would also like to give a special thank you to the SIST Committee.