ADMB Project

ADMB-11.2
Released December 23, 2014

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.2-src.zip.

Use the command below to extract contents of zip file to ~/admb/.
```
   [~]$ unzip admb-11.2-src.zip
```
Alternative — Use Subversion client to download from version control.
```
   [~]$ svn checkout http://www.admb-project.org/svn/tags/admb-11.2 admb
```
This will download source directory 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: QuickStartUnixSource.txt 2876 2014-12-23 17:38:30Z johnoel $