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-ownblas.mk  

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

hfem 

HFEM asks the name of the input file e.g  test.inp

The outcome of HFEM will be in the following files:
 test.res   is an ascii file containing the results, 
            displacements & strains and stresses (or temperatures)
 test.out   is a log file containing some information e.g. CPU-times
 test.mes   contains the element and nodal point data in a simple format
 test.neu   contains data in NISA/DISPLAY III neutral file format


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.
MAY-2002  some errors corrected and the GPS bandwidth optimization
          added


May  13, 2002
Reijo Kouhia

e-mail reijo.kouhia@hut.fi

