*-------------------------------------------------------------------------------
Elizabeth Wong                                                       10 Feb 2010
snctrl/README

This directory contains the optimal control interface SNCTRL.


The user needs to configure and compile the control package since it isn't a
part of the installation of SNOPT.


SNCTRL has been tested on the g95, gfortran and nagfor compilers.  Appropriate
settings for these compilers are included in the Makefile.  The user should
comment/uncomment the appropriate lines.  If another compiler is used, the
appropriate variables need to be set in the Makefile.


By default, the Makefile assumes SNOPT7 is located in ${HOME}/snopt7.  Change
the SNOPT_DIR variable to the correct path if necessary.


*------------------------*
For 64-bit systems:
  1. The user will need to change the integer kinds in src/precision.f90.

  2. Add an option to FFLAGS to set default integers to kind = 8:
       - For gfortran, add '-fdefault-integer-8'
       - For g95 with 32-bit integer default, add '-i8'
       - For nagfor, add ??

  3. If shared libraries were created when compiling SNOPT, add the option
     '-fPIC' to FFLAGS in the Makefile if using g95 or gfortran or '-PIC' if
     using nagfor.
*------------------------*


Once the Makefile is correctly configured, a simple
  % make

will compile the source files, examples and a MATLAB executable (see
README.matlab for more info).

8 examples (coded for each of the 3 interfaces) are included in the package.

Assuming no modifcations to the location of files and libraries, an example can
be run with the following commands
  % cd examples                (assuming you are in the SNCTRL directory)
  % ./run rocketA ../../lib

