Configuration, Compilation, and Installation

We assume you have already downloaded and unpacked APPSPACK; if not, see Downloads.

Step 1: Configuring APPSPACK

Before you can compile APPSPACK, you must run configure. As much as possible, configure will automatically detect the appropriate settings for your system. However, there are options that allow you to tweak the settings to your situation. In particular, you must use configure options to specify that the MPI version of APPSPACK should be built.

The configuration should be run from the top-level APPSPACK source directory. Here are some common examples of using configure.

Configure to build the serial version of APPSPACK.
```
configure
```
Configure to build both the serial and MPI versions of APPSPACK.
```
configure --with-mpi-compilers
```
This version uses the MPI compilers (mpicxx or mpiCC, mpicc, and mpif77).
Configure with degenerate constraint support (disabled by default).
```
configure --enable-cddlib
```

If you do not like the choices that configure makes, you may overide them by using the Configure Options.

Step 2: Compiling APPSPACK

Once you have successfully configured APPSPACK, you may use the following commands to build the libraries and executables, from the top-level APPSPACK source directory.

To compile APPSPACK:
```
make
```

Depending on the options specified during configure, the compilation creates the following libraries and executables.

src/appspack_serial (APPSPACK_Main_Serial.cpp)
src/appspack_mpi (APPSPACK_Main_MPI.cpp)
src/libappspack.a
cddlib/cddlib.a
examples/example1 (example1.c)
examples/example2 (example2.cpp)
examples/example2a (example2a.cpp)
examples/example3 (example3.cpp)
examples/example4 (example4.cpp)
examples/example5 (example5.cpp)

Step 3: Installing APPSPACK (optional)

Once you have successfully compiled APPSPACK, you may use the following commands to install the executables, libraries, and header files.

To install APPSPACK:
```
make install
```

The following files will be installed in the following locations. The locations may be overridden by specifying the appropriate configure options.

Header files - /usr/local/include
Executables (appspack_serial and appspack_mpi) - /usr/local/bin
Libraries (libappspack.a, libcdd.a) - /usr/local/lib

Step 4: Using APPSPACK

Now you are reading to use APPSPACK; see Using the APPSPACK Executables.