Nov. 6, 2001.

                        DNA routines for Maple 7
Contents:

	1) Instructions for Windows users
	2) Instructions for Linux/Sun users

This release of DNA includes the addition of piecewise and Heaviside
functions to the list supported by DNA.

A. Wittkopf,
Centre for Experimental and Constructive Mathematics - SFU - Canada

E.S. Cheb-Terrab
Centre of Experimental and Constructive Mathematics - SFU - Canada
The Physics Institute, State University of Rio de Janeiro - UERJ - Brazil.

*********************************************************************

1) Instructions for Windows users

    1) unzip dna.zip into any directory

                            !!! WARNING !!!
                            
      ***   DO NOT UNZIP ode-pde.zip INTO THE "Lib" or "Update"   ***
      ***   DIRECTORIES CONTAINING THE STANDARD Maple Libraries   ***


	2) copy the file dna.dll to the directory where wmaple.exe exists
	(typically: "C:\Program Files\Maple 7\bin.wnt")

	3) copy the files maple.ind and maple.lib to any directory of your
	   preference (for example: "C:\Program Files\Maple 7\lib\DNA")
	   
    4) add the directory you choose in '3)' to the  Maple 'libname' variable.


The 'libname' variable indicates to Maple where the libraries are found.

To have all correctly installed it is required that the directory containing
the DNA library (files maple.ind and maple.lib and maple.hdb) appears BEFORE
the directory containing the standard Maple library.

To see what is the libname during a Maple session input:

  > libname;

at the maple '>' prompt. To add a directory to the libname, for example
the directory "C:\Program Files\Maple 7\lib\DNA" input:

  > libname := "C:\Program Files\Maple 7\lib\DNA", libname;

Note that the added directory is enclosed between doublequotes.
----------------------------------------------------------------------
The maple.ini (windows) or .mapleinit (UNIX) Maple initialization file
----------------------------------------------------------------------

The procedure outlined above works well but it may be boring to add the
directory to the libname each time one runs Maple. An alternative to that is
to add the directory to the libname directly in the Maple initialization
file.

- Under windows

    1) Edit the file maple.ini found in "C:\Program Files\Maple 7\lib"
       or "C:\Program Files\Maple 7\users".

If the file does not exist *you can create it*. To edit the file any ascii
editor is good, for instance the windows 'notepad'.

    2) at the end of the file write

libname := "C:\Program Files\Maple 7\lib\DNA", libname;

       The above assumes that you unzipped the dna.zip file and put the
       files maple.ind and maple.lib in the directory
       "C:\Program Files\Maple 7\lib\DNA" but you choose any other
       directory.

*********************************************************************

2) Instructions to Linux/Sun Users

Linux: The numeric library only works with libc6 a.k.a. glibc2 on x86
	   platforms.
Sun: The numeric library was compiled under Sun/Solaris on a Sparc 5.

* Unpack the distribution and place the maple.* files and the libdna
  files into an installation directory. Say for example ~/dna.

* Rename the appropriate libdna-<platform>.so file to libdna.so
  So for Linux users, you would type
  mv libdna-x86-Linux.so libdna.so
  Sun users would type
  mv libdna-Sun-Solaris.so libdna.so

* Set the environment variable
  LD_LIBRARY_PATH=~/dna:$LD_LIBRARY_PATH, as this tells UNIX where to look
  for the shared library libdna.so.
  In the bash shell this can be accomplished by the command:
     export LD_LIBRARY_PATH=~/dna:$LD_LIBRARY_PATH

* Launch Maple 7 from the command line in the session that has the
  LD_LIBRARY_PATH set.

* Once Maple 7 is running, type
  > libname := "<full path to home dir>/dna",libname:
  and now you should be able to use the new dna method.

Alternate instructions:

If you have the privileges to move the libdna.so shared library to
/usr/lib or /usr/local/lib (assuming /usr/local/lib is in your
/etc/ld.so.conf file), you could do this and avoid the hassle with the
LD_LIBRARY_PATH environment variable.

If you do not have privileges, you can avoid having to type this every
time you launch Maple in a new window by setting it in your ~/.bashrc or
~/.profile file.

You can also avoid having to add "~/dna" to the libname every time
you start maple by adding the line:
libname := "~/dna",libname:
to the .mapleinit file in your home directory (if not present then you
can create it).
Note: you will need to expand the "~".

*********************************************************************