Usage: pick_events [options] <eventlist file>

pick_events selects events from raw data files stored in SAM. The command is
given a file containing a list of events to pick and will create a SAM dataset
for the raw data files containing those events and then submit a job to obtain
the files and extract the specified events into a separate file. An example
eventlist file is given below.

You can check that the eventlist file is valid by doing:

  pick_events --check eventlist.dat

This will perform a 'sam translate constraints' command and print the list of
files in the dataset.

After checking you can run the job to extract the events by doing:

  pick_events eventlist.dat

If you want to reuse an existing SAM dataset definition you can use:

  pick_events --rerun eventlist.dat

When the job is complete you should check the output to make sure all your
files have been delivered.
  
Options:

 --help,-h : Print this text.
 --check   : Check that events are available.
 --rerun   : Rerun mode - assumes that the sam dataset already exists.
 --runmode=<val> : Run using this rund0exe mode (eg batch, cabsrv1, cabsrv2)
 --batch   : Send job to the batch system (same as --runmode=batch) [default].
 --queue=<val> : Submit to this queue.
 --interactive : Run interactively.
 --scratch=<val> : Scratch directory location. Required for running on cabsrv1
                   & cabsrv2.
 --runargs=<val> : Additional arguments to pass to rund0exe.
 --debug         : Don't create the SAM dataset definition or submit the job
 --datatier=<val> 
 --version=<val> : Instead of picking raw files, pick files with this datatier
                   and version number. This is an experimental feature: it may
                   be slow, fail to find any or all the files you are looking
                   for, or even select multiple copies of the same event. Use
                   at your own risk.
 --thumbnail-version=<val> : Equivalent to --datatier=thumbnail --version=<val> 

The event list file consists of lines specifying '<key> = <value>' 
or '<run number> <event number>' pairs.

Example eventlist file for three events:

defname = test-pick-events-1
group = dzero
outfile = mypickedevents

175892 29740141
174236 9820200
176844 36085159


defname, and outfile are required. If not specified the group will default to
'dzero'. Optionally runmode, queue, scratch, runargs may be specified with
the same meaning as the command line options.

The copysam program is run using rund0exe, so the output appears in the normal
place for that (for interactive and batch mode below the current directory,
for cabsrv1 and cabsrv2 in the scratch directory).

By default the job is sent to the local batch system. This can be overridden
with --interactive to run interactively or --runmode=<system>, where system
can be cabsrv1,cabsrv2 or any other value which can be passed to rund0exe.

runargs may be used to pass arbitary arguments to rund0exe, e.g.
--runargs='-mem=2048M' in the unlikely event that a pick event job on clued0
requires this much memory.