Quick Start Unix from Source

ADMB-11.6
Released December 20, 2016

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.

• Supported C++ compiler 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

1. Open a Terminal window

2. Download ADMB source distribution

   Download ADMB source distribution admb-11.6-src.zip.

   Use the command below to extract contents of zip file to ~/admb/.

       [~]$ unzip admb-11.6-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/.

3. 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.

4. 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.

5. 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.