Download The CppAD Source Code
Keywords: download the cppad source code purpose distribution directory compressed archives current version release versions monthly unix file extraction windows testing install instructions subversion limitations stable

| Prev | Next |  |  |  |  | download |

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 instruction below as the distribution directory. To be specific, the distribution directory contains the file `cppad/cppad.hpp`.
Compressed Archives
These files have been archived using `tar` and compressed using `gzip`:

version `` | license `` | link
current | EPL | cppad-20160000.1.epl.tgz
current | GPL | cppad-20160000.1.gpl.tgz
old | Both | CppAD download page

Current Version
The current versions listed above correspond to the subversion trunk and the git master . These tarballs only last for a few days.
Release Versions
Release versions of the compressed tar files are available on the CppAD download page . This includes all the releases going back to 2007. These file have the form `
cppad-yyyymmdd.rel.lic.tgz
` The license code `lic` is `gpl`, `epl` or `cpl` where `gpl` denotes the GNU General Public License, `epl` denotes the Eclipse Public License, and `cpl` denotes the Common Public License (not being used for new versions). The version number `yyyymmdd` is the date at which the features of the program were frozen where `yyyy` is the year, `mm` is the month, and `dd` is the day. The release number `rel` corresponds to a bug fix index where higher numbers corresponding to more bug fixes.
Monthly Versions
Monthly versions of the compressed tar files are available on the CppAD download page . These are kept until the end of the current year, when the next release is created. The monthly versions have the form `
cppad-yyyy0101.lic.tgz
` where the license code `lic` is `gpl` or `epl` and `yyyy` is the current year.
Unix File Extraction
On unix, you can use the command `
tar -xvzf cppad-version.lic.tgz
` where `version` either refers to the current version, or one of the release versions. This will decompress and extract the CppAD into the distribution directory `cppad-version` . To see if this has been done correctly, check for the following file: `
cppad-version/cppad/cppad.hpp
`
Windows File Extraction and Testing
If you know how to extract the distribution directory from the tar file, just do so. Otherwise, below is one way you can do it. (Note that if `7z.exe`, `cmake.exe`, and `nmake.exe` are you your execution path, you will not need to specify their paths below.)

1. Download and install the open source program http://www.7-zip.org .
2. Download and install the Visual Studio Express; for example Visual Studio 2013
3. In a command window, execute the following commands: `
   set PATH=path_to_7_zip;%PATH%
   set PATH=path_to_cmake;%PATH%
   set VCDIR=path_to_vcdir;%PATH%
   call "%VCDIR%\vcvarsall.bat" x86
   ` For example, on one machine these paths had the following values: `
   path_to_7_zip=C:\Program Files\7-zip
   path_to_cmake=C:\Program Files (x86)\CMake\bin
   path_to_vcdir=C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC
   `
4. Use the following commands to extract the distribution from the tarball: `
   7z x cppad-version.lic.tgz
   7z x cppad-version.lic.tar
   `
5. To see if this has been done correctly, check for the following file: `
   cppad-version\cppad\cppad.hpp
   `
6. The commands below are optional. They run the CppAD tests using the default cmake settings (except for the generator option) `
   mkdir build
   cd build
   cmake -G "NMake Makefiles" ..
   nmake check
   `

Install Instructions
The instructions on the web correspond to the current version of CppAD. If you are using an old version of CppAD You should follow the install instructions in the `doc` subdirectory of the distribution directory.
Subversion
Limitations
This download procedure has the following limitations:

1. The subversion program must be installed on your system.
2. No documentation is included by this download procedure, though it can be build from the source code; see install instructions below.
3. Only the EPL licensed version of CppAD can be obtained by this download procedure (some old versions correspond to CPL instead of EPL).

Current Version
To obtain current version of CppAD, execute the following commands `
svn export https://projects.coin-or.org/svn/CppAD/trunk dir
` To see if this has been done correctly, check for the following file: `
dir/cppad/cppad.hpp
` We refer to your directory choice `dir` above as the distribution directory.
Stable Versions
Subversion downloads are available for a set of stable versions (after the specified date, only bug fixes get applied). The following link will list the available `dir` values corresponding to stable versions . The following command will download a stable version of the CppAD source code: `
svn export https://projects.coin-or.org/svn/CppAD/stable/dir dir
` To see if this has been done correctly, check for the following file: `
dir/cppad/cppad.hpp
` Note that it will correspond to the most recent release for this stable version.
Release Versions
Subversion downloads are available for a set of release versions (no changes are applied). The following link will list the available `dir` values corresponding to release versions . The following command will download a release version of the CppAD source code: `
svn export https://projects.coin-or.org/svn/CppAD/releases/dir dir
` To see if this has been done correctly, check for the following file: `
dir/cppad/cppad.hpp
`
Install Instructions
If you are using subversion to download an old version of CppAD, you will have to build the documentation to get the corresponding install instructions. 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: `
./build.sh omhelp
` You will then be able to follow the install instructions in the `doc` subdirectory of the distribution directory.

Input File: omh/install/download.omh