
                                     README

                               GENESIS Version 9.0

                                  December 2006


The files included with the GENESIS distribution are:

    vrand/gen90/UNICOS/genesis.x
                - the GENESIS UltraSPARC executable created using
                  UNICOS/mp 3.1.25 and Cray Fortran 5.5.0.7

    vrand/gen90/UNICOS/Makefile
                - makefile that can be used to compile and link GENESIS.
                  Now, this is probably not necessary.  See the Design Manual
                  for information about the executive control commands
                  GNUSER, DLIB, and DRESP3.  See the vrand/gen90/user_routines
                  directory for example source files.

    vrand/gen90/UNICOS/g00.f
                - the source code of the main program and system dependent
                  subroutines.

    vrand/gen90/UNICOS/glba.f
    vrand/gen90/UNICOS/glbb.f
                - subroutines for user defined library elements and subroutine
                 "GNUSER" which interfaces to user supplied program responses.
                  Also contain template for users routines for DRESP3.

    vrand/gen90/UNICOS/gup.f
                - file used to update GENESIS, if necessary.

    vrand/gen90/UNICOS/libgenesis.a
    vrand/gen90/UNICOS/modules/GN02.mod
    vrand/gen90/UNICOS/modules/GNKIND.mod
                - The genesis library used to rebuild genesis when glba.f or
                  g00.f has been modified. The library was created using
                  UNICOS/mp 3.1.25 and Cray Fortran 5.5.0.7.

    vrand/gen90/examples/*.dat
                - example input data (Described in Volumes III and IV).

    vrand/gen90/examples/*.out
                - example results files

    vrand/gen90/examples/*TSURF??.dat
                - topology isodensity results files

    vrand/gen90/extras/rplot.f
                - example program to read plot files.

    vrand/gen90/extras/optfile.f
                - a program for splitting .OPT file to separate files, one for
                  each design cycle.

    vrand/gen90/extras/readska.f
                - example program showing how to read *.SKA or *.SMA files.

    vrand/gen90/user_routines/drespu.f
                - skeleton GNUSER program showing how to use the default
                  GNUSER.FOR subroutine for DRESPU.

The enclosed genesis.x and libgenesis.a are the genesis 
executable and genesis library that were created on a Cray X1 under the 
operating system UNICOS/mp 3.1.25 and Cray Fortran 5.5.0.7. They 
are to be used on Cray X1/X1E with UNICOS/mp 3.1.25 or higher. For compiling 
and linking Cray Fortran 5.5.0.7 or compatible is required. 

The files g00.f glba.f and glbb.f may be modified (e.g. to increase the working
storage) and then compiled and linked with rest of the object codes to create a
runnable module.  GENESIS is written in standard Fortran. If the files are
modified, use the makefile to rebuild genesis. To do that simply type "make".
 
The file gup.f should not be modified. This is for updating GENESIS and may
be provided as needed by VR&D. To compile gup.f and link it with the 
GENESIS library to create or rebuild GENESIS type: "make".
 
If there are any questions do not hesitate to call VR&D 
at (719) 473-4611 or email to genesis.support@vrand.com.
