muTENSOR is a tensor algebra and General Relativity system add-on for
muMATH.  It will run on any machine for which muMATH is available, eg.
IBM-AT, PC and clones, DEC Rainbow etc. You must obtain muMATH
yourself, it is not included here. 

There is also a system very similar to muTENSOR called REDTEN which
runs in REDUCE on larger machines (eg. SUN, VAX), with essentially the
same syntax and capabilities.

To make a muTENSOR system (see also note 11):

1) Uncompress and extract the files from mutensor.tar. (If you're
reading this then presumably you have done that).

2) Transfer the source files and examples to your PC. Be sure to use a
binary mode as you are transferring a pair of executables as well. You
require at least 256k memory; a hard drive is a handy option. Version
4.12 of muSIMP/muMATH is recommeded since it has a more efficient
compiler.

3) Check the path for the help file (HELP.TXT) in SYS.ENV. The default
is the same directory that muTENSOR is in. Check also the escape
sequences for both the console and the printer. The console is
presumed to be ANSI, this may require running an ANSI.SYS from DOS.
Ensure that the lengths of the escape sequences are correctly set.

4) Build a muMATH system with the following modules (optional marked
with a *): 

	arith.mus
	algebra.ari
	dif.alg     (optional, but you can't do much without it)
       *trg.alg     (highly recommended)
       *log.alg
       *atrg.alg
       *hyper.alg
       *absval.alg
       *int.dif     (not very useful)
       *intmore.int
       *lim.dif

 NOTE 1: muTENSOR is incompatible with the muMATH array and vector packages.
 NOTE 2: There is not sufficient room in muSIMP for all these modules and all
         the muTENSOR source as well.

 You will have to build this part of the system by hand. You can
either save it as a .SYS file, or continue directly with step 5. You
may also wish to configure the system to suit taste (eg. set BELL
FALSE).

5) In the muTENSOR source directory start the system created in step 4
and RDS(SYS,GEN) to build muTENSOR.

You may wish to examine the SYS.GEN file to see what files can be left
out. (Note: I have never built a muTENSOR lacking major files, so I
can't be sure it will all work correctly. You are probably safe
leaving out anything after SHIFT.IND). 

Note that a full system as described above will very nearly fill
muSIMP's code segment, so that not much more code can be loaded, in
particular, the trace package is a near thing, and the editor won't
fit.

6) When the bell sounds, save the system into TNSR.SYS (or similar,
but see step 8). The generation file cannot perform the save because
it resets the driver loop, which causes the generation file to be closed.

7) The executables garb.exe and manual.exe exist in the source
directory. They were compiled on an IBM-AT with the MSC 4.0 compiler;
they will very likely run on any system for which muMATH is available.
The executables must sit in the same directory as muTENSOR, since
muSIMP does not handle path names. If for some reason they fail to run
correctly, compile them yourself; the only option required in
compiling is perhaps the optimization switch; depending on the
compiler the manual function can be quite slow.

8) If you wish, begin a lone muSIMP and RDS the MUTNSR.GEN file. This
writes out a MUTNSR.COM file which when executed automatically loads
TNSR.SYS. Note that this file also disables the PUTD and GETD
functions, so you may wish to comment out that code.

9) The system should now be complete. Test the help facility to see if
the system can find manual.exe and it can find the help file. As noted
above, the manual program must be in the same directory as muTENSOR,
the help file can be at a location as specified in the SYS.ENV file.
If the virtual memory code has been included, garb.exe should also be
in the same directory as muTENSOR.

10) If you wish to make a hard copy of the manual, cd into the man
directory and `make hardcopy'. Check first the Makefile for the name
of the program used to print troff/nroff files. You can also make an
online manual suitable for reading with more. (The above is presumably
to be done on a unix machine, unless you have nroff or troff on your
PC).

11) Included with this distribution are the files MUTNSR.COM and
TNSR.SYS. These files have been used in previous distributions via
mail (Canada Post); and are suitably modified to satisfy the authors
of muSIMP/muMATH, i.e the functions GETD, PUTD, and LOAD are disabled.
These should run on any IBM personal computer, or DEC Rainbow (8086
based systems). Running MUTNSR automatically loads the TNSR.SYS file.
If you wish to use the source provided in this distribution, you MUST
obtain muMATH from the authors at The Soft Warehouse.

---

If you want to poke into the code, you will have to pardon the lack of
comments, these are forthcoming (most of the comments are in the
REDTEN source).


Suggestions and bug reports can be sent to:

John harper                    or       Charles Dyer
harper@manitou.astro.utoronto.ca        dyer@manitou.astro.utoronto.ca

