[Developers] Final request for testing and feedback
Allan Hicks - NOAA Federal
allan.hicks at noaa.gov
Mon Apr 15 11:20:28 PDT 2013
Hi Johnoel and Developers,
Great job with the INSTALL.txt file. I am wondering, I had not noticed the
last section of "Configuring MS Express", and I wonder if this is the best
place for that section, or if it should be in a different section. It
seems to me that the INSTALL.txt file is mainly explaining how to compile
the ADMB source. And, what Ian Taylor referred to above describes how to
install the already built ADMB (downloaded files). Would it be worthwhile
to maybe call this INSTALL.txt file BUILD.txt, and write an INSTALL.txt
file that contains the instructions that Ian refers to above (as well as
the section on "Configuring MS Express")?
I have attached my ideas for these two files. The BUILD file is what
Johnoel has been calling the INSTALL.txt file (which I think is great), and
the INSTALL file contains the installation instructions from the webpage
that Ian was referring to.
Just my thoughts, and I hope I'm not throwing a wrench in the works here,
Allan
On Mon, Apr 15, 2013 at 10:57 AM, Ian Taylor - NOAA Federal <
ian.taylor at noaa.gov> wrote:
> Hi Johnoel,
> Thanks for keeping this moving forward, and sorry I haven't had time to
> contribute this round.
>
> Developers,
> In the last round of releases, I helped Johnoel and others put together
> installations instructions on the web:
> http://www.admb-project.org/documentation/installation
> which are now presumably out of date.
>
> Does it make more sense to update the web versions (which have
> illustrations and are maybe easier to read than plain text) or should we
> just point people to install.txt as install guide (which is quicker to
> update)?
>
> -Ian
>
>
>
> On Fri, Apr 12, 2013 at 5:44 PM, Johnoel Ancheta <johnoel at hawaii.edu>wrote:
>
>> Hi all,
>>
>> After some help and feedback from Allan Hicks, Shareef Siddeek, Larry
>> Jacobson and
>> Chris Grandin. The trunk is ready for distribution. Please give the
>> trunk one final
>> try and provide any feedback. Follow the procedures in
>>
>> http://www.admb-project.org/svn/trunk/INSTALL.txt
>>
>> Alot has changed. The installation is much easier. This upcoming release
>> contains numerous bug fixes. If there is no major issues found, we will
>> start
>> rolling out the distributions.
>>
>> Thanks again,
>> Johnoel
>>
>> _______________________________________________
>> Developers mailing list
>> Developers at admb-project.org
>> http://lists.admb-project.org/mailman/listinfo/developers
>>
>>
>
> _______________________________________________
> Developers mailing list
> Developers at admb-project.org
> http://lists.admb-project.org/mailman/listinfo/developers
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.admb-project.org/pipermail/developers/attachments/20130415/5d2f0268/attachment-0001.html>
-------------- next part --------------
Describe ADMB installation from source and binary distributions.
Requirements
============
ADMB has been tested and used on Windows and Linux operating systems in both 32
and 64 bit versions. A C/C++ compiler must be be installed on the local computer.
Below is a list of supported compilers:
* GNU gcc version 4.7
* Microsoft Visual C++ 2010 and 2012
* MacOS XCode(with the Command Line Tools) version 4.6
* Clang version 3.0
* Intel C++ Compiler 11
* Solaris Studio 12
If the compiler is not listed, try building from the source distribution. Email
users at admb-project.org for help.
Download
========
Source and precompiled binary distributions can be downloaded from
'http://www.admb-project.org/downloads/'.
Quick Start
===========
Windows
-------
1. Download ADMB source distribution.
http://www.admb-project.org/buildbot/snapshots/admb-latest-src.zip
Right click the downloaded file and extract to C:\admb-trunk\.
2. Open Comand Prompt window.
3. Change to admb directory.
C:\> cd admb-trunk
4. Install MinGW C++ compiler (32 Bit).
C:\admb-trunk\> utilities\get-mingw.bat
If mingw is already installed, then it will just update it.
Note: This will download approximately ~177M from 'sourceforge.net'.
Add MinGW to PATH.
C:\admb-trunk\> set PATH=%CD%\utilities\mingw\bin;%PATH%
5. Build libraries
C:\admb-trunk\> utilities\make
Note: Build times vary from machine to machine, but it usually
takes approximately 15-25 minutes.
6. Build and run the simple example.
C:\admb-trunk\> cd examples\admb\simple
C:\admb-trunk\examples\admb\simple\> C:\admb-trunk\build\dist\bin\admb simple
C:\admb-trunk\examples\admb\simple\> simple
Windows and Visual C++
----------------------
1. Download ADMB source distribution.
http://www.admb-project.org/buildbot/snapshots/admb-latest-src.zip
Right click the downloaded file and extract to C:\admb-trunk\.
2. Open Visual Studio Comand Prompt window.
3. Change to admb directory.
C:\> cd admb-trunk
4. Build libraries
C:\admb-trunk\> nmake
Note: Build times vary from machine to machine, but it usually
takes approximately 15-25 minutes.
5. Build and run the simple example.
C:\admb-trunk\> cd examples\admb\simple
C:\admb-trunk\examples\admb\simple\> C:\admb-trunk\build\dist\bin\admb simple
C:\admb-trunk\examples\admb\simple\> simple
Unix
----
1. Download ADMB source distribution.
http://www.admb-project.org/buildbot/snapshots/admb-latest-src.zip
2. Open Terminal windows.
3. Extract files in HOME directory.
[~]$ unzip admb-latest-src.zip
Note: This will extract admb-trunk folder to HOME.
3. Change to admb directory.
[~]$ cd admb-trunk
4. Build libraries
[~/admb-trunk/]$ make
Note: Build times vary from machine to machine, but it usually
takes approximately 15-25 minutes.
If you are NOT using the default C++ compiler, specify compiler on
the command line. For example,
[~/admb-trunk/]$ make icpc
Use help to show available compiler targets.
[~/admb-trunk/]$ make help
6. Build run the simple example.
[~/admb-trunk/]$ cd examples/admb/simple
[~/admb-trunk/examples/admb/simple/]$ ~/admb-trunk/admb simple
[~/admb-trunk/examples/admb/simple/]$ ./simple
7. [Optional] Installation
Copy entire distribution.
[~/admb-trunk/]$ sudo cp -Rvf ../admb-trunk /usr/local/admb
Create symlink to main admb script. Check to that '/usr/local/bin/' exists.
[~/admb-trunk/]$ sudo ln -sf /usr/local/admb/admb /usr/local/bin/admb
Note: make install is no longer supported.
After the copying the libraries, build run the simple example.
[~/admb-trunk/]$ cd examples/admb/simple
[~/admb-trunk/examples/admb/simple/]$ admb simple
[~/admb-trunk/examples/admb/simple/]$ ./simple
--------------------------------------------------------------------------------
$ID$
-------------- next part --------------
Configure GCC for Windows
----------------------------------
1. Download the 32-bit version of GCC version 4.5.2 from the gcc page.
and unzip the file into a C:\MinGW\.
2. Edit your PATH environmental variable to include the location where you put GCC.
In Windows 7 this can be done as follows:
a) Right-click on "My Computer" and click "Properties".
b) Click the "Advanced System Settings" link in the left column.
c) In the "System Properties" window click the "Environment Variables" button.
d) Highlight the "Path" variable in the Systems Variable section and click "Edit"
e) Add the location from step 1 to the existing path, separated by a semi-colon.
3. Download ADMB for Windows GCC from the downloads tab of this website.
4. Double click the installer and follow the instructions. If you have administrative
privileges, the default installation in Program Files should be fine.
If you DO NOT have administrative privileges, choose a location like
c:\ADMB. This might be preferable regardless.
5. If you chose a location other than C:\MinGW\ to unzip the GCC files, you need
to edit the file c:\ADMB\bin\set-admb-mingw.bat and change the MINGW_HOME setting
to match the location you chose.
6. Once the installer is Finished, open the ADMB Command Prompt located in
Start->All Programs->ADMB (MinGW GCC-4.5.2)->ADMB Command Prompt (MinGW GCC-4.5.2)
7. In the Command prompt, type the commands below to build and run the simple example.
c:\ADMB> cd examples\admb\simple
c:\ADMB\examples\admb\simple> admb simple
c:\ADMB\examples\admb\simple> simple
Configure Microsoft Visual C++ 2010 Express
-------------------------------------------
1. Download and install the following software, install them in their default
locations:
A. Microsoft .NET 4
B. Microsoft Windows SDK 7.1
C. Microsoft Visual Studio 2010 Express
2. Download the executable installer for Windows MSVC from
http://www.admb-project.org/downloads and run it. Make sure to choose the
install location as the default C:\ADMB or another location without spaces in
the name.
3. Add the following to the PATH in the order given. If you are using a 32-bit
machine, enter only the first, third, fourth, and fifth path listed in that
order. If you are using a 64-bit machine, enter all five paths in the order
listed. If you are compiling for a 64-bit machine, the second path listed
here must reflect which architecture you want to compile for, this example
is for Intel 64-bit processors - for most people this should not be changed.
Also, if you are on a 32-bit machine, remove the ' (x86)' from these paths.
C:\Program Files\Microsoft SDKs\Windows\v7.1
C:\Program Files (x86)\Microsoft Visual Studio 10.0\VC\bin\amd64
C:\Program Files (x86)\Microsoft Visual Studio 10.0\VC\bin
C:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE
4. Add the following environment variables:
INCLUDE = C:\Program Files (x86)\Microsoft Visual Studio 10.0\VC\include;
C:\Program Files\Microsoft SDKs\Windows\v7.1\Include
For the LIB variable, choose either 32-bit or 64-bit.
32-bit LIB:
LIB = C:\Program Files (x86)\Microsoft Visual Studio 10.0\VC\lib;
C:\Program Files\Microsoft SDKs\Windows\v7.1\Lib
64-bit LIB:
LIB = C:\Program Files (x86)\Microsoft Visual Studio 10.0\VC\lib\amd64;
C:\Program Files\Microsoft SDKs\Windows\v7.1\Lib\x64
5. Logout and login again to make the environment variable changes take effect.
6. You may now open any command shell (DOS window) or call admb from within an
editor window using whatever compile command you would like. Try this using the
"Simple" example. Open a command window, by clicking Start->Run then typing cmd.exe
and enter the following commands in the window:
C:
cd ADMB\examples\admb\simple
admb simple
simple
Configure Linus
----------------------------------
1. Download and extract ADMB Linux binaries from downloads tab of the ADMB-project website.
2. Open a bash shell, change to extracted Linux ADMB Home directory,
then type the following commands .
#Change to ADMB folder.
cd ~/admb
# Sets ADMB Home directory.
export ADMB_HOME=~/admb
# Adds ADMB bin to $PATH
export PATH=$ADMB_HOME/bin:$PATH
3. Change into ADMB Home directory, then run examples for verification.
cd $ADMB_HOME
chmod -R u+w examples
cd examples
make
Configure Mac XCode
-----------------------------------------
Prerequisites:
Apple Developer Tools (XCode) must be installed from http://developer.apple.com/xcode/.
1. Open Terminal located in /Applications/Utilities, then type admb for Usage options.
2. Copy the "simple" model from the examples directory.
cp -R /usr/local/admb/examples/admb/simple .
3. Must change to the copied simple directory.
cd simple
4. Build the simple example.
admb simple
5. Run the simple example.
./simple
More information about the Developers
mailing list