ADMB Project

ADMB-11.5pre
Released December 1, 2015

ADMB source build and usage procedures for Unix operating systems such as Linux, MacOS, Solaris and BSD.

Prerequisites

The following programs should be installed on the local computer.

C++ compiler

Supported C++ Compilers for Unix
- GNU C++
- Intel C++ Compiler
- Oracle Solaris Studio 12.3
GNU make
GNU stream editor (sed)
GNU flex
Optional — Subversion Client to download from source version control.

Note — For MacOS, install XCode with command line tools includes all the prerequistes.

Quick Start

Open a Terminal window
Download ADMB source distribution

Download ADMB source distribution admb-11.5pre-src.zip.

Use the command below to extract contents of zip file to ~/admb/.
```
   [~]$ unzip admb-11.5pre-src.zip
```
Alternative — Use Git client (see command below) to download directly from ADMB version control repository.
```
   [~]$ git clone https://github.com/admb-project/admb.git
```
This will download latest source repository to ~/admb/.
Build ADMB source

Change to admb directory.
```
   [~]$ cd admb
```
To build ADMB, use the commands below.
```
   [~/admb/]$ make
```
If debug symbols are needed, use the commands below.
```
   [~/admb/]$ make debug
```
Note — When the build is completed, ~/admb/build/dist/ is the binary distribution directory.
Use ADMB

In the Terminal window, use the steps below to build and run the simple example.

Change to simple example directory.
```
   [~/admb/]$ cd examples/admb/simple
```
Build simple example.
```
   [~/admb/examples/admb/simple/]$ ~/admb/admb simple.tpl
```
Note — For MinGW-Msys and Cygwin shells, use the 'admb.sh' script.
```
   [~/admb/examples/admb/simple/]$ ~/admb/admb.sh simple.tpl
```
Run simple example.
```
   [~/admb/examples/admb/simple/]$ ./simple
```
Read manuals for more information.
Optional — Multi-User Installation

Installs binary distribution folder to /usr/local/ as super-user.
```
   [~/admb/]$ sudo make install
```
Build and run the simple example without the directory prefix.
```
   [~/admb/]$ cd examples/admb/simple
   [~/admb/examples/admb/simple/]$ admb simple.tpl
   [~/admb/examples/admb/simple/]$ ./simple
```
If unable to build simple example, then use the Manual Installation below.

Alternative — Manual Installation

Copy binary distribution folder to /usr/local/ as super-user.
```
   [~/admb/]$ sudo cp -Rvf build/dist /usr/local/admb
```
Note — The dist folder can be copied to other computers with similar configurations.

Create symlink to main admb script. Directory /usr/local/bin/ should already exist.
```
   [~/admb/]$ sudo ln -sf /usr/local/admb/admb /usr/local/bin/admb
```

For help and support, contact users@admb-project.org.

$Id$