#ADMB Project 

*ADMB-11.2*  
*Released December 23, 2014*  

ADMB source build and usage procedures for Windows.

---

_For Windows computers with Visual C++ compiler already installed, 
read and follow the instuctions in [QuickStart for Visual C++](QuickStartVisualC++.html)._

_For builds within *Cygwin* and *MinGW-Msys* shells, read and follow the
instructions in the [QuickStart for Unix](QuickStartUnix.html)._

Prerequisites
-------------

The following programs are required to be installed on the local computer.

* C++ Compiler (see list below)

      Supported C++ Compilers for Windows

      * [MinGW](http://www.mingw.org/)
      * [MinGW-w64](http://mingw-w64.sourceforge.net/)
      * [Cygwin](http://www.cygwin.org/)
      * [Rtools](http://cran.r-project.org/bin/windows/Rtools/)     

      _**Note**_ &mdash; C++ Compilers should be included in the System Enviroment **PATH**.

* _**Optional**_ &mdash; Installed Subversion Client such as SlikSVN.

Quick Start
-----------

1. **Download** ADMB

       Download source distribution [admb-11.2-src.zip](http://ftp.admb-project.org/admb-11.2/admb-11.2-src.zip).

       Double click downloaded zip file and copy admb directory to the Local Drive (**C:\\>)**.

       _**Alternative**_ &mdash; To download from directly from ADMB version control use the command below.

        C:\> svn checkout http://www.admb-project.org/svn/tags/admb-11.2 admb

       This will download admb-11.2 source directory to **C:\\admb\\>**.

2. **Build** ADMB source

       Open **Command Prompt** window.

       Change to admb directory.

        C:\> cd admb

       To build with **MinGW** C++ compiler, use the command below.

        C:\admb\> utilities\make

       If debug symbols are needed, use the command below.

        C:\admb\> utilities\make debug

       To build with **MinGW** C++ compiler and **Msys** , use the command below.

        C:\admb\> make

       To build 64 bit with **Rtools**, use the command below.

       _**Note** &mdash; The outdated make utility from Rtools is incompatible with ADMB build files._

        C:\admb\> utilities\make CXXFLAGS=-m64 LDFLAGS=-m64

       _**Note**_ &mdash; When the build is completed, **C:\\admb\\build\\dist\\>** is the binary distribution directory.

3. **Use** ADMB
 
       In the **Command Prompt** window, use the steps below to build and run the simple example.
 
       Change to simple example directory.       

           C:\admb\> cd examples\admb\simple

       Build simple example.

           C:\admb\examples\admb\simple\> C:\admb\admb simple.tpl

       Run simple example.

           C:\admb\examples\admb\simple\> simple.exe

       Read [manuals](http://ftp.admb-project.org/admb-11.2/manuals/) for more information.

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

$Id: QuickStartWindowsSource.txt 2875 2014-12-23 17:24:13Z johnoel $
