Generator Input Files

The initial setup of a KEPLER problem is specified by a series of instructions (known as cards for historical reasons) that each occupy one line in an input file termed a generator file. (Or sometimes a generator deck for the same historical reasons – backup versions of KEPLER were kept on punch cards until 1978). Running KEPLER always requires the regular KEPLER generator specified in the next section. In addition, a separate BURN generator, specified in the section following, is required if BURN co-processing is specified by the inclusion of a GENBURN card in the regular generator. Both files must be in the working directory in which the problem is being run.

A generator card may be up to 120 characters-long and contain up to 60 blank, tab, or equal-sign delimited words, each at most 60 characters long. Words are interpreted as being integer, character or floating point depending on their format and must match the type specified for each card or a fatal error message will be sent. Except as noted below, words representing input character variables are truncated to 8 characters, while numerical input is field-free, except that floating point numbers must be distinguished from integers by a decimal point or exponent.

Card types allowed in the regular KEPLER generator file are listed below.

Note

Each card keyword is given in bold letters, followed by its arguments, if any, in ITALIC CAPITAL LETTERS. For each commands, an example is given, which also serves to indicate the expected type of the arguments. Note that, as indicated by the examples, actual communication with the computer should be made in lower case and that character parameters are never enclosed in quotes.

Complete historic sample KEPLER and BURN generator files are available, along with some useful variants. These are taken directly from recently executed KEPLER jobs.