This command can be used only at the beginning of a Projection command file. In pipelines its syntax is slightly changed (see sections 4.3.2 and 4.3.3).
The INPUT command allows the reading of a photon list from disk and the definition of the corresponding virtual dataset. Its general structure is
INPUT <photon_event_table_name>where an identifier string may be optionally inserted at the beginning or at the end of the command line, as described previously.
Only one Photon Event Table at a time can be input to a Projection command file. Therefore the parameter list must always consist of a single filename, and no more than one INPUT command must be used in the same command file.
The INPUT command line must be the first one in a command file, simply because it must be the first one to be executed. When in a command file no INPUT command line is specified, the input filename is supposed to be supplied via the MAKE/PROJECTION command (see section 4.3.6).
When the input filename extension (e.g., .tbl) is not given, it will be assumed to be .tbl. The following INPUT command lines are valid:
INPUT filea ! To be used
ABCD = INPUT filea.tbl ! only in Projection
INPUT events ID=ABCD ! command files!