Riemann Package
                 (Version  1.4  - Aug 18, 1997)
          by Renato Portugal (portugal@cat.cbpf.br)
          and Sandra L. Sautu (sautu@lca1.drp.cbpf.br)

FTP address: anonymous@lca1.drp.cbpf.br (152.84.252.200)
Directory:   pub/Riemann/maplev4

The available files are:

README       - This file.

Riemann1.ms   - Tutorial worksheet with general explanations.

Riemann2.ms   - Worksheet showing the calculation of the geometrical 
                quantities of the Schwarzschild metric in coordinate basis.

Riemann3.ms   - Worksheet with calculations in Kerr metric
                using null tetrads.

Riemann       - The code of the package.

maple.hdb     - The help file

riemann.zip   - All previous files (zipped - zip or pkzip).

riemann.tar.gz - All previous text files (compressed by gzip).




INSTALLATION INSTRUCTIONS (in three steps): 

# The Riemann package is distributed freely. The program source, the
# help and some example worksheets are available . After copying the
# program source, one can create a compiled version as explained. The
# necessary informations are given bellow:
# 
# First step: copy the package using one of the following addresses
# (using netscape, mosaic, anonymous ftp or equivalent):
# 
# http://www.cbpf.br/~portugal/Riemann.html
# ftp://lca1.drp.cbpf.br/pub/Riemann/maplev4
# http://daisy.uwaterloo.ca:80/~rportuga/Riemann.htm
# 
# Put all files in a directory which we are calling /XXX here. 
# 
# Second step: Enter in Maple and give the following commands:
> read(`/XXX/Riemann`); # to read the source file

[acomp, amap, antisymmetrize, apply, bintnames, calc, clear,

    clearbint, clearcomp, cleartensor, codiff, comp, complist,

    coordinates, dalembertian, definetensor, entertensor, evalt, init,

    invariants, ivierbein, lptensor, ltensor, metric, metricV, off,

    on, path, petrov, printtensor, readmetric, readtensor,

    readvierbein, savemetric, savetensor, savevierbein, show, simpfcn,

    sumt, switches, symmetrize, tdiff, tmap, vierbein, viertocoord]

> save(`/XXX/Riemann.m`); # to create a compiled version
# 
# Third step: If you have succeded in the second step, from now on it is
# advisable to load the package using the following commands:
> libname:=libname,`/XXX`;

             libname := /soft/maple5.4/distrib/lib, /XXX

# The output of the last command in your machine will be different from
# the above output, but it must contain the /XXX directory. The next
# command is:
> with(Riemann);

[acomp, amap, antisymmetrize, apply, bintnames, calc, clear,

    clearbint, clearcomp, cleartensor, codiff, comp, complist,

    coordinates, dalembertian, definetensor, entertensor, evalt, init,

    invariants, ivierbein, lptensor, ltensor, metric, metricV, off,

    on, path, petrov, printtensor, readmetric, readtensor,

    readvierbein, savemetric, savetensor, savevierbein, show, simpfcn,

    sumt, switches, symmetrize, tdiff, tmap, vierbein, viertocoord]

# Try some help command:
> ?riemann     
> ?definetensor
> ?evalt
# 
# Possible problems: If you have received the message:
  *** Error, (in with) undefined package , Riemann 
# after loading the package then there are two possibilities. Either
# Riemann.m  file is not in the directory  /XXX or the variable libname
# has not been setup properly. In the first case you must redo the
# second step paying attention to the file paths. In the second case you
# should verify if the value of the variable libname is the correct one.
# Verify if the name Riemann has been spelled correctly with capital
# letter. Restart the session and try again.
# 
# If you have received the message: Coud not find any help on ''topic''
# then verify if the file maple.hdb is in the directory /XXX. If it is
# there then verify if the variable libname is the correct one. Maple
# can find the Riemann help worksheets only by way of the variable
# libname.
# 
# 
# Hint: One can avoid to setup every time the variable libname by
# putting this information in the maple initialization file (see ?maple
# and ?libname). For unix users: the initialization file is called
# .mapleinit and stays in the home directory. One should edit it and add
# the line: libname := libname, `/XXX`:.  
#