How to Run the Program
1. How to give input - general rules
1.1. Organization of input data
The input data are organized in groups, each group starting with a data group identifier, and terminating on the next data group identifier.
A data group identifier may consist of one, two or three words, which gives a unique description of the data group. Each word may consist of several characters, but only the first four characters of each word are checked. The user may, however, write the complete word if so desired.
In this manual each input line is presented within a standard list, and each list represents either one single input line or a sequence of similar input lines.
1.2. Formats
All input data are read by FREAD which is a FORTRAN free-format reader and decoder. This means that the data items may be written anywhere on the input line, as long as the specified order is satisfied. The data items must be separated with at least one blank (exceeding blanks are ignored). Note that since blank is exclusively interpreted as a delimiter, blank can not be used to specify a zero value. All digits, letters and/or special symbols in a data item must be given consecutively without blanks.
Tabulators should not be used in the input files.
1.2.1. Comments
Input lines with an apostrophe (’) in the first column are interpreted as comments, and simply ignored. Comments may be inserted in the input data stream in order to improve the readability of the input file.
Only the first 80 characters on each line are decoded.
1.2.2. Alphanumeric Data Items
In this manual, three types of alphanumeric data items are interpreted, denoted character(4), character(6) and character(8).
An alphanumeric data item may consist of one or more characters. The first character is always a letter (A-Z), while the remaining ones may be letters, digits or special symbols (except /, $, & and blank).
There is no upper limit to the number of characters in an alphanumeric
data item. However, a maximum of 4 ('character(4)'
), 6
('character(6)'
) or 8 ('character(8)'
) characters will be decoded,
and all characters in excess of this are simply ignored.
1.2.3. Integer Data Items (denoted integer)
All characters must be digits. The first digit may be preceded by a + or a - character.
1.2.4. Real Number Data Items (denoted real)
A real number data entry may consist of up to 3 components, i.e. an integer part i, a decimal part d, and exponent part e. The following 4 basic forms are accepted:
(+)i (+)i. (+)i.d (+).d
These may all be combined with exponent parts yielding the forms:
(+)iE(+)e (+)i.E(+)e (+)i.dE(+)e (+).dE(+)e
1.2.5. Default data items
Some of the input data have default values. These values are inserted when no other values are given. There are two ways to signal that the program shall insert default values. One, that may always be used, is to type a slash (/) for the actual data item. Second, if the actual data item ( or data items) is (are) the last one(s) on the input line, no slash(es) is (are) necessary. FREAD will insert the number of slashes needed. Note that a slash is also a data item, and must be separated from adjacent data items by one or more blanks.
1.2.6. Continuation of input statements
An input statement may consist of one or several input lines. If an input statement consists of more than one input line, all its card images except the last one must be terminated by the character &, which must be preceded by at least one blank. This implies that on such cards data cannot be specified beyond column 78.
1.2.7. The input description list
<parameter names, in the order decoded>
-
Parameter: type, default: Default value
: Description-
Optional additional information for the given parameter.
-
Comments, notes etc.
If there is no default value, that part of the line is skipped. The parameter types are integer, real and character.
If unit is not applicable, e.g. for integer options, that part of the line is skipped.
1.2.8. Data group identifier
As previously mentioned, the input data are organized in groups.
A data-group identifier is given on the first input line of each group.
IDW1 IDW2 IDW3
-
IDW1: character(4)
: First word of the identifier -
IDW2: character(4)
: Second word of the identifier -
IDW3: character(4)
: Third word of the identifier
Data-group identifiers may consist of one, two or three words
In the input description, data-group identifiers are not presented within the standard list, but the words of the identifiers are written completely in the code box above. With format character(4), only the first four characters are checked, and these parts of the words are marked.
2. Running VIVANA
VIVANA
can be run using the graphical interface VIVANA4WIN
or using
standard run command procedures.
2.1. VIVANA4WIN
VIVANA4WIN
is a utility program for running VIVANA
analysis modules
and viewing key results.
2.2. How to use standard run command procedures
This section will give a description of how to use the standard VIVANA
run command procedure delivered as a part of a VIVANA
installation.
The file name convention used consists of a prefix in addition to the basic file names described in Explanation of files used. The prefix and the basic file names are separated by an underscore.
The same type of file name convention is also used for RIFLEX
. Prior
to running VIVANA
, the RIFLEX
modules INPMOD
and STAMOD
must be
run according to the RIFLEX
is given in the RIFLEX User Guide.
Necessary commands to do this are given in the following:
riflex inpmod prefix riflex stamod prefix
The necessary commands to run VIVANA
is given by:
riflex vivana prefix prefix
The file names used by the different modules are summarized in the following. For description of the files used for internal communication, see Explanation of files used.
The run command procedure can easily be modified to allow other use of
prefixes for file identification, e.g. separate prefixes for STAMOD
and INPMOD
runs.
2.2.1. INPMOD files:
-
prefix_inpmod.inp
- symbolic input file -
prefix_inpmod.res
- symbolic result file . -
prefix_ifninp.sam
- internal communication file
2.2.2. STAMOD files:
-
prefix_stamod.inp
- symbolic input file -
prefix_stamod.res
- symbolic result file -
prefix_stamod.mpf
- MatrixPlot file (ascii format) . -
prefix_ifnsys.sam
- internal communication file -
prefix_ifnsta.ffi
- internal communication file -
prefix_ifndmp.sam
- internal communication file
2.2.3. VIVANA files:
-
prefix_vivana.inp
- symbolic input file -
prefix_vivana.res
- symbolic result file -
prefix_vivana.mpf
- MatrixPlot file (ascii format) -
prefix_ifnviv.ffi
- internal communication file
The user input is given on files with extension .inp
while key
results can be found on files with extension .res
.