Prev Next download

@(@\newcommand{\W}[1]{ \; #1 \; } \newcommand{\R}[1]{ {\rm #1} } \newcommand{\B}[1]{ {\bf #1} } \newcommand{\D}[2]{ \frac{\partial #1}{\partial #2} } \newcommand{\DD}[3]{ \frac{\partial^2 #1}{\partial #2 \partial #3} } \newcommand{\Dpow}[2]{ \frac{\partial^{#1}}{\partial {#2}^{#1}} } \newcommand{\dpow}[2]{ \frac{ {\rm d}^{#1}}{{\rm d}\, {#2}^{#1}} }@)@
Download The CppAD Source Code

Purpose
CppAD is an include file library and you therefore need the source code to use it. This section discusses how to download the different versions of CppAD.

Distribution Directory
We refer to the CppAD source directory created by the download instructions below as the distribution directory. To be specific, the distribution directory contains the file cppad/cppad.hpp.

Version
A CppAD version number has the following fields: yyyy is four decimal digits denoting a year, mm is two decimal digits denoting a month, and dd is two decimal digits denoting a day. For example version = 20160101 corresponds to January 1, 2016.

Release
Special versions corresponding to the beginning of each year have mm and dd equal to zero. These version numbers are combined with release numbers denoted by rel . Higher release numbers correspond to more bug fixes. For example version.rel = 20160000.0 corresponds to the first release of the version for 2016, 20160000.1 corresponds to the first bug fix for 2016. The compressed archive names on the Github download page have the format
    cppad-
version.rel.tgz
These archives correspond to the Eclipse Public License and do not have the documentation included in them.

License
We use lic to denote the licence corresponding to an archived version of CppAD. The GNU General Public License is denoted by lic = gpl and the Eclipse Public License is denoted by lic = epl .

Git
CppAD source code development is current done using git You can a git clone of the current version using the command
    git clone https://github.com/coin-or/CppAD.git cppad.git
This procedure requires that the git is installed on your system.

Version
After downloading the source code, and changing into the distribution directory, use the following command to determine the corresponding version :
 
    grep '^SET(cppad_version' CMakeLists.txt
Use the following command to determine the git hash code corresponding to this version:
 
    git show-ref | grep 'refs/heads/master'
You can get an old version using the command
    git checkout -q 
hash
You can check the corresponding version number using the command
 
    grep '^SET(cppad_version' CMakeLists.txt

Compressed Archives
You can build compressed archives with the GPL or EPL license using the script bin/package.sh. These archives have the documentation in the doc directory and do not have the git information. They are intended for re-distribution.

Documentation
The documentation at the web address https://coin-or.github.io/CppAD/doc/ is for the most recent version of CppAD. You can get the documentation for an other versions of CppAD. To do so, in the distribution directory execute the following commands:
 
    git checkout gh-pages
    git log > junk.log
The file junk.log will contain the git hash codes for different version of the documentation along with the date. Select the hash for the version you are using, execute the command
    git checkout 
hash
You can then view documentation for version you are using by opening the file doc/index.html in a web browser.

Building Documentation
If you are using a version before 20170716, you can build the documentation for the version you are using. The documentation for CppAD is built from the source code files using OMhelp . You will need to install the omhelp command so that
 
    which omhelp
shows it is in your path. Once you have done this, in the distribution directory execute the following command:
    bin/run_omhelp.sh htm
You can then view documentation for version you are using by opening the file doc/index.html in a web browser.
Input File: omh/install/download.omh