// Author: Herbert Greenlee
// Date:   4/9/98
//
// $Id: ReadEvent.rcp,v 1.23 2005/11/08 17:18:02 greenlee Exp $
//
//

string PackageName = "ReadEvent"

// Allowed formats for input file names and lists.
//
// 1.  A single filename.
// 2.  A wildcard filename.
// 3.  A space-separated list of files or wildcards.
// 4.  An rcp vector of filenames or wildcards: ("file1" "file2")
// 5.  A list file (e.g. listfile:mylist.dat)
// 6.  A file on a remote computer (host:file.dat or user@host:file.dat)
//     File is staged to directory specified by rcp parameter 
//     StagingDirectory using copy command specified by rcp parameter
//     RemoteCopyCommand.
//
// Command line overrides (only for first ReadEvent package).
//
// RCP parameter    Command line option
//-------------------------------------
// InputFile         -input_file <file>
// SkipEvents        -skip_events <n>
// NumEvents         -num_events <n>
// MaxEventsPerFile  -per_input_file <n>
// NumFiles          -num_files <n>
// OnlyCollids       -only_collids <run1> <event1> <run2> <event2> ...
// SkipCollids       -skip_collids <run1> <event1> <run2> <event2> ...
// SelectCollids     -select_collids <event-list-file>
// OnlyRuns          -only_runs <run1> <run2> ...
// SkipRuns          -skip_runs <run1> <run2> ...
// RunMin	     -run_min <run1>
// RunMax	     -run_max <run2>
// RemoteCopyCommand -stager <copy-command>

string InputFile = "input"   // Can be space-separated list or vector.
string InputFormat = ""
int SkipEvents = 0           // Number of events to skip (from start of job).
int NumEvents = 0            // Maximum number of events to read (0 = all).
int MaxEventsPerFile = 0     // Maximum number of events per file (0 = all).
int NumFiles = 0             // Maximum number of files to read (0 = infinite).
string ApplicationName = "ReadEvent"  // String passed to d0om_init.

// Optional parameters

// Selecting or skipping events by collision id.  Run and event numbers 
// are listed alternately, starting with run number, in rcp integer vector 
// notation. For example:
//
// int SkipCollids = (1000, 123, 1000, 431)
//
// will skip run 1000, events 123 and 431.
//
// The size of the SkipCollids vector must be even.

int OnlyCollids = ()         // Collision ids. to select (empty = all).
int SkipCollids = ()         // Collision ids. to skip.
string SelectCollids = ""    // Event list file.

// Selecting or skipping events by run number.  

int OnlyRuns = ()            // Runs to select (empty = all).
int SkipRuns = ()            // Runs to skip.


int RunMin = 0		     // must set both
int RunMax = 0               // if either is 0 no range is checked

// if Skip, Only and/or RunMin/Max are set run only goes if it satisfies all conditions.
// Status file.

string StatusFile = ""        // Name of status file (updated every event).
int StatusLevel = 1           // Status detail level
                              //  0 = None.
                              //  1 = Less detail.
                              //  2 = More detail (includes individual events).

// Remote file expander configuration parameters.

string RemoteCopyCommand = "rcp"  // Remote copy command (default "rcp")
string StagingDirectory = "."     // Staging directory (default ".")

// D0om parameters.

bool MakeUnknown = false      // Instantiate unknown objects?
bool ExceptUnknown = false    // Throw exception for unknown objects?

// Event reordering.

string EventOrder = "sequential" // Event order:
                                 // sequential (default)
                                 // numeric (sort by numbers embedded in key)
                                 // reverse_sequential
                                 // reverse_numeric
                                 // random

// Use this parameter to disable the generation of file open and close events.
// (One might want to do this for secondary input stream.)

bool DisableFileEvents = false

// Use the next two parameter to put more than one event onto the framework 
// work queue.  This is useful, e.g., for reading multiple minimum bias 
// events from a single input file for processing by a later merging package.
//
// To get a fixed multiplicity, set EventMultiplicity to the desired 
// multiplicity and set MeanMultiplicity to zero.
//
// To get a Poisson distributed random multiplicity, set EventMultiplicity
// to zero and MeanMultiplicity to the desired Poisson mean.

int EventMultiplicity = 1
double MeanMultiplicity = 0.