d0tools

Purpose:

General purpose DØ software tools.

See the Release Notes for details.

Usage:

This package is a UPS product, and is available on all Fermilab DØ computing systems. To use, issue the command setup d0tools. Announcements of new versions of this product are made in the Computing-Software DØ News folder.

There are typically three versions supported. Most users should use current:

• Current: use setup d0tools
• Test: use setup d0tools -t - the latest version that is pretty well tested.
• Development: use setup d0tools -d - the latest version that has new features that have not been completed tested, but are probably OK.

If your institution has not yet installed this product, you can install a personal version by following these configuration instructions.

Utilities to run DØ executables:

• rund0exe - Runs any DØ framework executable. Requires detailed knowledge of the DØ software development infrastructure. Many standard DØ executables have specialized scripts to run them (see below for what's available). All features supported by rund0exe are available in the specialized versions.
• runreco - Run reco.
• runrecoanalyze - Run reco_analyze.
• runScriptRunner - Run scriptrunner.
• runD0TrigSim - Run trigsim.
• rund0analyze - Run d0analyze.
• runchunkanalyze - Run the D0 Chunk Analysis example.
• runRecoCert - Run recocert.

General utilities:

• mybatch - Prints a summary of batch jobs running on D0 systems.
• pick_events - Copies desired events to disk.
• recentDataInSam - Summarize real data recently available in SAM.

Utilities to analyze output from DØ executables:

• cpustats - Extract CPU usage information from a framework.out file.
• memstats - Extract memory usage information from a framework.log file.
• chunkstats - Print summary of chunk sizes for a given DSPACK file.
• recostats - Print summary of results from running DØRECO.
• recoanalstats - Print summary of results from running RecoAnalyze.
• events_read - Summarizes status of jobs submitted with rund0exe, etc.

Miscellaneous:

• chunkdoc - Provides documentation on chunks.
• cvs_latest_version - Returns the latest (active) tag for a given CVS package.
• cvs_next_version - Tag a CVS package with the next appropriate version number.
• dirdiff - Find the difference between two directories.
• samLite - A simple wrapper around some useful SAM functionality.
• scriptutil - Python module to support python scripts.

Release notes