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.

Example:
'WITH CHARACTER(4)
ENVIRONMENTAL DATA
'WILL BE INTERPRETED AS
ENVI DATA
'WITH CHARACTER(6)
ENVIRONMENTAL DATA
'WILL BE INTERPRETED AS
ENVIRO DATA

1.2.3. Integer Data Items (denoted integer)

All characters must be digits. The first digit may be preceded by a + or a - character.

Example:
0 1 -27 +66

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

Example:
0 -1. -0.2E14 +17.E-3 1.78E+3

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.

Example:
'THE DEFAULT VALUE OF THE SECOND DATA ITEM IS 2. THEN 3 / 5
'WILL BE INTERPRETED AS
3 2 5
'6 DATA ITEMS ARE REQUIRED AND THE LAST 3 DATA ITEMS HAVE DEFAULT VALUES
'6, 7 AND 8, THEN
1 2 3
'WILL BE INTERPRETED AS
1 2 3 6 7 8

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.

Example:
1 2 &
3
'IS THE SAME AS GIVING
1 2 3

1.2.7. The input description list

<parameter names, in the order decoded>

  • Parameter: type, default: Default value: Description \(\mathrm {[unit]}\)

    • 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.

Example:
IKS DAMP

  • IKS: integer: Stiffness code 1

    • 1 : Constant spring compression stiffness

    • N : Table with N pairs of pressure force - displacements to be specified

      • N > 2

  • DAMP: real, default: 0: Dash pot damping coefficient \(\mathrm {[FT/L]}\)

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.

Example:
EVALUATION CONTROL PARAMETERS

May be given as

EVAL CONT PARA

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.