How to catalog STNTUPLE dataset

Catalog of a STNTUPLE dataset is created by the Stntuple/scripts/catalog_stntuples script, see its source for instructions

Call format:

Stntuple/scripts/catalog_stntuples -b book -d dataset -m mode -v verbose -u user -h host -D directory -p pattern  

Parameters:

-D directory: directory with the STNTUPLE files to catalog

-p pattern : pattern, grepping on which one can create a list of files

-d dataset : dataset ID (name)

-b book : datasets could be associated with several books, for example, personal

user books: book=gianipez or book=murat

-h host : if datasets are stored on a remote host

-u user : user name on a remote host to login

Notes on the catalog file format:

1) Lines starting from '#' are comment lines. Exceptions – metadata lines (keys are 'NTOTAL:' and such, no space between 'NTOTAL' and ':')

'# NTOTAL: xxxxx' : defines total number of events on disk

'# NGENERATED: xxxx' : defines total number of generated events (>= NTOTAL because of filtering)

'# SIGNAL_PARTICLE: xx' : PDG code of the 'signal' particle, i.e. 11

'# GENERATOR_CODE: xx' : generator code

'# DESCRIPTION: …..' : brief , one-line, description of the dataset, Stntuple/scripts/update_book_catalog includes the description line into the book catalog

2) If a AAA_DESCRIPTION.html file exists in the dataset catalog directory, a link to it will be included into the html directory of the book. This allows to have a more detailed description of the dataset available on the web

The metadata may or may not be present, currently there is no software tools which would be relying on the metadata presence.