This is a readme file for the HFEM program.

Unzipping the tar archive will create directory hfem and
three subdirectories hfem/doc, hfem/exa, hfem/src
The hfem/src contains the source files and the makefile.
The hfem/exa contains input files and output files of some examples. 

Use make system to compile the executable in the way:

make -f hf.mk

then the program can be run as (if you make an alias for hfem)

hfem < inputfile >outputfile or hfem < inputfile 

File fort.11 is also genereted containing all results, the standard output
contains only brief summary of operations, CPU-time information.
File fort.7 contains the nodal point coordinates and the element connectivity 
array.

The HFEM program has been used in several UNIX computers.
Source files are mostly of standard Fortran 77, except some routines
with DO -- END DO loops which are accepted for most of compilers.

One call to a system dependent routine is in file hfem.f:  
CALL ETIME.  
If your particular system do not know this routine, just comment the line,
or replace it by a proper routine.
Commenting the call to ETIME only supresses the CPU time information.

Unfortunately at the moment there is no documentation of the program.
It will be available in future.

The input generation is similar to the DLEARN program described in
T.J.R. Hughes: The Finite Element Method, Linear Static and Dynamic Analysis,
Chapter 11, pages 631 --796, Prentice-Hall, 1987.
Some of the generation routines from DLEARN are used also in HFEM.



Version history:

OCT-98  preliminary version
MAR-99  some features added and the following errors are corrected:
        1) the ambiquity with labels TRUSS and BEAM corrected
        2) an error in the BEAM element B-matrix corrected.
           In version OCT-98 the beam element performed correctly
           only if it is aligned with the x-axis direction.



March 15, 1999
Reijo Kouhia

e-mail reijo.kouhia@hut.fi

