Old Skimmer v7r1 online help

$ /afs/slac/g/glast/ground/DataServer/v7r1/bin/tskim -h

ROOTSYS=/afs/slac/g/glast/ground/GLAST_EXT/rh9_gcc32opt/ROOT/v5.18.00c-gl1/root
TS_BINARY_DIR=/afs/slac/g/glast/ground/DataServer/v7r1/linux/5.18/00c
%INFO: ROOT version is 5.18/00c

Usage:

1) Set up the choice of input data files.

  GLAST_TASK
    When one want to skim data from GLAST Pipeline I, name of the task.
    You must not define both GLAST_TASK and TS_INPUT_FILE_LIST. See also TS_INPUT_CEL.
    (default value is "")
  GLAST_RUN_MIN
    When one want to skim data from GLAST Pipeline I, beginning of requested run range.
    (default value is "0")
  GLAST_RUN_MAX
    When one want to skim data from GLAST Pipeline I, end of requested run range.
    (default value is "0")
  TS_INPUT_FILE_LIST
    Full name of a parameter file providing the list of input data files.
    You must not define both GLAST_TASK and TS_INPUT_FILE_LIST. See also TS_INPUT_CEL.
    (default value is "")
  TS_OUTPUT_FILE_LIST
    Optional full name of a parameter file receiving the list of data files which were kept after skimming.
    (default value is "")
  TS_DEBUG_FILE_LIST
    The bigger than 0, the more debug output during the files mining step.
    (default value is "0")

2) Set up the selection of events.

  TS_INPUT_EVENT_LIST
    Full name of a parameter file providing the list of events of interest.
    You must not define both TS_INPUT_EVENT_LIST and TS_TCUT. See also TS_INPUT_CEL.
    (default value is "")
  TS_TCUT_DATA_TYPE
    Relevant type of data for TS_TCUT,
    used for the events filtering step.
    (THIS VARIABLE IS MANDATORY)
  TS_TCUT
    ROOT-style cut TString, applied to TS_TCUT_DATA_TYPE,
    used for the events cutting step.
    You must not define both TS_INPUT_EVENT_LIST and TS_TCUT. See also TS_INPUT_CEL.
    (default value is "")
  TS_OUTPUT_EVENT_LIST
    Optional full name of a parameter file receiving the list of events which were kept after skimming.
    (default value is "")
  TS_DEBUG_EVENT_LIST
    The bigger than 0, the more debug output during events filtering step.
    (default value is "0")

3) Set up the choice of branches.

  TS_INPUT_BRANCH_LIST
    Optional full name of a file specifying branches to disable/enable during skimming.
    (default value is "")
  TS_OUTPUT_BRANCH_LIST
    Optional full name of a file receiving the list of branches which were active while skimming.
    (default value is "")
  TS_DEBUG_BRANCH_LIST
    The bigger than 0, the more debug output during branches extraction step.
    (default value is "0")

4) Set up the list of libraries to be loaded.

  TS_INPUT_LIBRARY_LIST
    Full name of a file providing the list of the shared libraries to load.
    This depends on the relevant release for the input data files.
    If the file does not exist yet, tskim tries to guess the release and deduces the libraries.
    We will call this the "automatic release determination".
    (default value is "")
  TS_LIBRARY_DIR
    The UNIX path, eventually relative, where to find the shared libraries. It is expected to dependon the code release used to generate the data to be skimmed..
    (default value is "")
  TS_LIBRARY_DIRS
    Places to search for shared libraries in general, and eventually the relative subdirectory defined by TS_LIBRARY_DIR..
    (default list is "")
  TS_OUTPUT_LIBRARY_LIST
    Optional full name of a file receiving the list of shared libraries mandatory for skimming.
    (default value is "")
  TS_DEBUG_LIBRARY_LIST
    The bigger than 0, the more debug output during automatic release determination.
    (default value is "0")

5) Set up skimming parameters.

  TS_DATA_TYPES
    Kinds of data to be skimmed, formatted as a ":" separated string.
    (default list is "")
  TS_OUTPUT_DIR
    Directory path where you wish the output ROOT files to be written. See also TS_OUTPUT_CEL.
    (default value is "/afs/slac.stanford.edu/u/ec/dragon/glast/routineSkims")
  TS_OUTPUT_FILE_BODY
    Body of the filename for output ROOT files. See also TS_OUTPUT_CEL.
    (default value is "SkimmedData")
  TS_MAX_FILE_SIZE

    Max output file size in bytes. If set to 0, the ROOT default max size will be used.
    (default value is "0")
  TS_SKIP_SKIM
    When true, tskim does not perform the skimming.
    It can be useful if you only want to generate some of above output parameter files.
    (default value is "false")
  TS_DEBUG_SKIM
    The bigger than 0, the more debug output while skimming.
    (default value is "0")

6) Eventually use CompositeEventList instead of input textual filse and deep copy

  TS_INPUT_CEL
    Full path of a CEL ROOT file containing both the data files paths and the list of events of interest.
    The input CEL list of files will only be taken into account if neither GLAST_TASK nor TS_INPUT_FILE_LIST is defined.
    The input CEL list of events will only be taken into account if neither GLAST_TASK nor TS_EVENT_FILE_LIST is defined.
    (default value is "")
  TS_OUTPUT_CEL
    Full path of a CEL ROOT file receiving the selected list of files and events for all data types with run/event id branches.
    Only apply if a cut has been made on events in a way or another.
    If applied, is done instead of the real copy for concerned data types, and bran pruning is disabled.
    (default value is "")

7) Parameters for expert users.

  TS_DIR
    Directory where the tskim code is located.
    (default value is "")
  TS_FORCE_OUTPUT_FILES
    Create each output file even when empty (useful for production).
    (default value is "false")
  TS_DATA_DIRS
    Place to search for data files, when their paths are relative ones in the file list.
    (default list is "")
  TS_META_DATA
    The name of a file describing input meta data.
    (default value is "")
  TS_REBUILD_INDEX
    When true, tskim does not trust the TTree indexes found within input data files, and rebuild them all.
    (default value is "true")
  TS_OUTPUT_FILE_PATH
    In case of a single data type, one can directly give the complete path of the output file.
    (default value is "")
  TS_SKIP_ESTIMATE
    Skip the skimming time estimate.
    (default value is "false")
  TS_TESTDB
    Enable using the Oracle TestDB.
    (default value is "false")
  TS_SKIP_CHECK
    When false, some (long) tests are done on the output data files.
    (default value is "true")
  TS_DEBUG_CHECK
    The bigger than 0, the more debug output during final check.
    (default value is "0")

8) Execute the command

  /afs/slac/g/glast/ground/DataServer/v7r1/bin/tskim