Reads a data stream from a file and fills in the data stream with the appropriate value. Controls the pipeline so that the process() stage is run once for each event that was in the file. The init() and global() stages also run as normal. During each stage, data from the file is copied into the data stream, allowing modules to operate on it.
If no file is given, this module operates similarly to EventCounter -- it does nothing during the init() and global() stages, and runs the process() a certain number of times (given by the Cycles parameter), and then tells the pipeline to move to the global() stage.
The input file may be in either the standard text or html formats. Text is assumed unless the filename ends with ".html".
Parameters
| Name | Type | Description |
|---|---|---|
| Filename | string | Name of the file from which to read input. |
| Cycles | int | If Filename is not present, run process() stage for this number of cycles before stopping. |
Inputs
None.
Outputs
During each stage, the data contained in the file for that stage will be copied to the
data stream. For instance, the header information will be copied to the active header
event during the init() stage. During each process() stage, the data from the corresponding
event in the file will be copied into the current event.