While in your main directory, enter the commands gunzip auto07p-0.4.tar.gz, followed by tar xvfo auto07p-0.4.tar. This will result in a directory auto, with one subdirectory, auto/07p. Type cd auto/07p to change directory to auto/07p. Then type ./configure , to check your system for required compilers and libraries. Once the configure script has finished you may then type make to compile AUTO and its ancillary software. The configure script is designed to detect the details of your system which AUTO requires to compile successfully. If either the configure script or the make command should fail, you may assist the configure script by giving it various command line options. Please type ./configure -help for more details. Upon compilation, you may type make clean to remove unnecessary files.
To run AUTO you need to set your environment variables correctly. Assuming AUTO is installed in your home directory, the following commands set your environment variables so that you will be able to run the AUTO commands, and may be placed into your .login, .profile, or .cshrc file, as appropriate. If you are using a sh compatible shell, such as sh, bash, ksh, or ash enter the command source $HOME/auto/07p/cmds/auto.env.sh. On the other hand, if you are using a csh compatible shell, such as csh or tcsh, enter the command source $HOME/auto/07p/cmds/auto.env.
The Graphical User Interface (GUI) requires the X-Window system and Motif or LessTif. Note that the GUI is not strictly necessary, since AUTO can be run very effectively using the Unix Command Language User Interface (CLUI). Moreover, long or complicated sequences of AUTO calculations can be programmed using the alternative Python CLUI. THe GUI is not compiled by default. To compile AUTO with the GUI, type ./configure -enable-gui and then make in the directory auto/07p.
The new graphic tool for AUTO data visualization, PLAUT04, is compiled by default, but depends on a few libraries that may not be in a standard installation of a typical Unix-like system. These libraries may be available as optional packages, though. Specifically, PLAUT04 requires at least either SGI Open Inventor 2.5.10 or Coin3D 2.2 with SoXt 1.1.0. It also needs the libraries simage 1.6 and (Open)Motif or LessTif 2.0. Any higher version numbers should also work. One can download SGI's implementation of the Open Inventor libraries from: ftp://oss.sgi.com/projects/inventor/download/Because SGI's implementation for Linux cannot show text correctly, we recommend that Coin is used instead of SGI's implementation. Coin3D can be downloaded from: http://www.coin3d.org/download/It is also available as a package for many Linux distributions. You will probably need to compile and install the SoXt and simage libraries from the source code available at the above web site. If, after that, PLAUT04 still does not work then you might need to adjust the environment variable LD_LIBRARY_PATH to include the location of these libraries, for instance /usr/local/lib.
The configure script checks for these libraries and outputs a warning if any of these libraries cannot be found; if they are not available you can still compile all other components of AUTO using make.
For timing purposes, the file auto/07p/src/autlib1.f contains references to the function etime. Similarly, this file contains references to the subroutine FLUSH to avoid buffering of screen output when running AUTO from Python. These routines are not part of any Fortran standard but are common extensions. The configure script checks if your compiler supplies them. If they are not supplied then the dummy replacement routines in src/compat.f are used.
The PostScript conversion command @ps is compiled by default. Alternatively you can type make in the directory auto/07p/tek2ps. To generate the on-line manual, type make in auto/07p/doc.
To prepare AUTO for transfer to another machine, type make superclean in the directory auto/07p before creating the tar-file. This will remove all executable, object, and other non-essential files, and thereby reduce the size of the package.
Some EISPACK routines used by AUTO for computing eigenvalues and Floquet multipliers are included in the package (EISPACK:76 EISPACK:76).