NAME:  recentDataInSam

Print a summary of recent data files (raw + reco).

USAGE:

  recentDataInSam [options]
  

OPTIONS
-------

  GENERAL OPTIONS:

    -h, --help          --  Print help text and exit.

    --days=N            --  Show files created in SAM since N days ago [default = 2 days]

    --since=mm/dd/year  --  Show files created in SAM since given date
                            [default = show files created in last 2 days]
    
    --version=xxx       --  Only show reconstructed files based on this version (supports SAM wildcard)
    --run=xxx           --  Limit to this specific run (supports SAM wildcard)

    --noraw             --  Don't display RAW files [default = yes]
    --nodst             --  Don't display DST files [default = no]
    --notmb             --  Don't display TMB files [default = yes]
    
  SPECIAL OPTIONS:

    --runtype              --  Override run type [default = physics_data_taking]
    --physical_datastream  --  Override physical_datastream [default = all]
    
    --verbose              --  Used to debug this script


DESCRIPTION
-----------

  This command summarizes RAW, DST and TMB files that have been
  recently added to SAM.  By default, users get a summary of real data
  files created within the last two days. The total number of files
  and events are printed, and then the number of files per run number
  are displayed (separated by RECO version number for DST's and
  TMB's).

  Users may override the age of the files by using the --days=N
  option.  Alternatively, users may specify a specific date by using
  the --since=mm/dd/year option (the date format should conform to the
  SAM schema of mm/dd/year).

  By default, all found RECO versions are included for DST and TMB
  files.  Users can see files from a specific version by using
  --version=xx.xx.xx.

  Files from all runs will be summarized.  Users may limit this by
  using the --run=xxx option.

  The --run and --version options support the SAM wildcard.

  To ignore a given data tier, you may use the --noraw, --nodst and /
  or --notmb options.
  

EXAMPLES
--------

  To get a summary of what new real data files (RAW and reconstructed)
  have appeared in SAM in the last two days:
  
   > recentDataInSam

  To see what files have appeared in the last four days:

   > recentDataInSam --days=4

  To limit the summary to DST files from a given version of RECO:

   > recentDataInSam --noraw --notmb --version=p14.03.00
  

REQUIREMENTS
------------

  1) setup sam
  2) setup d0tools

  
LIMITATIONS
-----------

  1) An internal limit in SAM prevents looking back more than about 4
  days.  This is under investigation by the SAM team.


SUPPORT
-------

  Harry Melanson, melanson@fnal.gov