Quick Start Unix from Source

ADMB-11.6pre
Released December 12, 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.6pre-src.zip.

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

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