Difference between revisions of "ApCoCoA-1:HowTo:Compile ApCoCoALib on Windows"

From ApCoCoAWiki
(Complete Redesign of the page)
m (Bot: Replacing category HowTo with HowTo Old)
 
(10 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
This page is outdated, please see [[ApCoCoALib:CompilationInstructions]]
 +
 
=Introduction=
 
=Introduction=
 
*This site is set up to collect all necessary bits and pieces to compile the ApCoCoALib on Windows.
 
*This site is set up to collect all necessary bits and pieces to compile the ApCoCoALib on Windows.
Line 8: Line 10:
 
*CoCoALib: The ApCoCoALib is based on and extends the functionalities of the CoCoALib. You need to compile the CoCoALib prior to the ApCoCoALib.
 
*CoCoALib: The ApCoCoALib is based on and extends the functionalities of the CoCoALib. You need to compile the CoCoALib prior to the ApCoCoALib.
 
**Find a description on how to install the CoCoALib on Windows [http://www.apcocoa.org/wiki/HowTo:Compile_CoCoALib_on_Windows here].
 
**Find a description on how to install the CoCoALib on Windows [http://www.apcocoa.org/wiki/HowTo:Compile_CoCoALib_on_Windows here].
 +
**This description is based on CoCoALib 0.99.30.
  
*Blas and Lapack Library: You will need those libraries to enable a few features in the ApCoCoALib. You can either download the full libraries or get a selection of files needed for the ApCoCoALib.
+
*Boost Library: You will need this library to enable a few features in the ApCoCoALib. You can [http://www.boostpro.com/download download] precompiled libs for windows. Ensure to install the Libs Date-Time and Thread in order to use the ApCoCoALib for the MatlabToolbox.
** Download and install the complete libraries via [http://math-atlas.sourceforge.net/ ATLAS].
 
** A selection of needed files can be found ''[http:// here]''. Download the archive and extract it to your local harddisk. We will refer to these files with the keyword %BLLApath
 
  
*Optionally you can install [http://linalg.org LinBox] which can improve the FGLM techniques especially over finite fields and lets you call LinBox functions from within the ApCoCoA GUI.
+
*Blas and Lapack Library: You will need those libraries to enable a few features in the ApCoCoALib. The current Repository version of the ApCoCoALib needs you to have one of the following programms installed:
 
+
** Matlab
*HG mercurial: You will need this software to download the latest ApCoCoALib from a repository. The ApCoCoALib is managed with the source control system mercurial. We will refer to TortoiseHG. TortoiseHG will install mercurial on your system and adds a context menu in the MS Explorer providing many of the needed functionalities.
+
** Intel MKL
** Download TortoiseHG [http://tortoisehg.sourceforge.net/ here].
 
** A more detailed documentation on you how to use mercurial can be found [http://www.selenic.com/mercurial/wiki/ here].
 
** General information on the ApCoCoALib source code management can be found [http://www.apcocoa.org/wiki/ApCoCoA:SourceCodeManagement here].
 
 
 
*Intel MKL: You need the Intel MKL installed on your computer.
 
  
 
=Download Instructions=
 
=Download Instructions=
Get your prefered ApCoCoALib version (stable or developer) from the [http://www.apcocoa.org/hg/ repo site].
+
Get your prefered ApCoCoALib version (stable or developer) from the [[ApCoCoA:SourceCodeManagement|subversion repository]]. General information on the ApCoCoALib source code management can be found [http://www.apcocoa.org/wiki/ApCoCoA:SourceCodeManagement here].
A brief instruction using TortoiseHG is:
 
* Add a folder on your local harddisk for the local repo copy.
 
* Open the context menu entry TortoiseHG->Clone a repository. As the source path copy the selected link from the repo site. As the destination path select your created folder. Start the download of the ApCoCoALib with the clone button.
 
  
 
=Compilation Instructions=
 
=Compilation Instructions=
 +
 
==Config File==
 
==Config File==
 
Prior to compilation you have to adjust the configuration file. Open the file makefile.vc.conf in the configuration subfolder.
 
Prior to compilation you have to adjust the configuration file. Open the file makefile.vc.conf in the configuration subfolder.
Set the %GMPpath by adapting the following two lines:
+
Set the pathes accordingly. To use the Intel MKL uncomment line 11 and 14 by removing the # and comment line 09 and 13 by adding a #.
<c>
+
<pre>#-------------------------------------------------------------------------------
_GMP_INCLUDE=..\..\..\gmp_p4_dll
+
# Adjust the following names and pathes
_GMP_LIB=..\..\..\gmp_p4_dll\gmp.lib
+
#-------------------------------------------------------------------------------
</c>
+
_COCOALIB_INCLUDE = ..\..\..\CoCoALib-0.9918\include
_GMP_INCLUDE contains the path to your GMP binaries. _GMP_LIB points to the gmp.lib file.
+
_GMP_INCLUDE= C:\Programme\gmp-4.2.2\build.vc8\lib\Win32\Release
 
+
_BOOST_INCLUDE= C:\Programme\boost\boost_1_38
Set the include pathes for the CoCoALib and the Intel MKL in the following lines
+
# Use the LAPACK/BLAS Libs provided with
<c>
+
#Matlab
_INCLUDES=/I $(_GMP_INCLUDE) /I ..\..\include /I ..\..\..\CoCoALib-0.9914\include \
+
_LB_INCLUDE = C:\Programme\MATLAB\R2007b\extern\include
          /I ..\..\..\IntelMKL\include
+
#or Intel MKL
</c>
+
#_LB_INCLUDE = C:\Programme\Intel\MKL\9.0\include
 +
#-------------------------------------------------------------------------------
 +
...
 +
                  -DUSEMatlab -D__MSVC__
 +
#   -DUSEIntelMKL -D__MSVC__
 +
</pre>
  
 
Note: All pathes shown here are relative pathes to the ApCoCoALib folder.
 
Note: All pathes shown here are relative pathes to the ApCoCoALib folder.
Line 48: Line 47:
 
==Compilation==
 
==Compilation==
 
Open a Visual Studio command prompt and change to your local ApCoCoALib folder. Use the nmake command to compile the ApCoCoALib:
 
Open a Visual Studio command prompt and change to your local ApCoCoALib folder. Use the nmake command to compile the ApCoCoALib:
<c>nmake -f Makefile.vc</c> Will display all available targets.
+
<pre>nmake -f Makefile.vc ApCoCoALib</pre>
<c>nmake -f Makefile.vc ApCoCoALib</c> Will build the ApCoCoALib.
+
To show all available targets call
 +
<pre>nmake -f Makefile.vc</pre>
  
 
==Problems==
 
==Problems==
 
If you encounter problems check out the forum: [http://www.apcocoa.org/forum/ ApCoCoA Forum]
 
If you encounter problems check out the forum: [http://www.apcocoa.org/forum/ ApCoCoA Forum]
  
[[Category:HowTo]][[Category:ApCoCoALib]]
+
[[Category:HowTo Old]]
 +
[[Category:ApCoCoALib]]

Latest revision as of 09:41, 29 October 2020

This page is outdated, please see ApCoCoALib:CompilationInstructions

Introduction

  • This site is set up to collect all necessary bits and pieces to compile the ApCoCoALib on Windows.
  • This description is made for compiling the ApCoCoALib with MSVC 2003/2005.

Preparation

Before compiling the ApCoCoALib you need to install the following files/libraries:

  • CoCoALib: The ApCoCoALib is based on and extends the functionalities of the CoCoALib. You need to compile the CoCoALib prior to the ApCoCoALib.
    • Find a description on how to install the CoCoALib on Windows here.
    • This description is based on CoCoALib 0.99.30.
  • Boost Library: You will need this library to enable a few features in the ApCoCoALib. You can download precompiled libs for windows. Ensure to install the Libs Date-Time and Thread in order to use the ApCoCoALib for the MatlabToolbox.
  • Blas and Lapack Library: You will need those libraries to enable a few features in the ApCoCoALib. The current Repository version of the ApCoCoALib needs you to have one of the following programms installed:
    • Matlab
    • Intel MKL

Download Instructions

Get your prefered ApCoCoALib version (stable or developer) from the subversion repository. General information on the ApCoCoALib source code management can be found here.

Compilation Instructions

Config File

Prior to compilation you have to adjust the configuration file. Open the file makefile.vc.conf in the configuration subfolder. Set the pathes accordingly. To use the Intel MKL uncomment line 11 and 14 by removing the # and comment line 09 and 13 by adding a #.

#-------------------------------------------------------------------------------
# Adjust the following names and pathes
#-------------------------------------------------------------------------------
_COCOALIB_INCLUDE = ..\..\..\CoCoALib-0.9918\include
_GMP_INCLUDE= C:\Programme\gmp-4.2.2\build.vc8\lib\Win32\Release
_BOOST_INCLUDE= C:\Programme\boost\boost_1_38
# Use the LAPACK/BLAS Libs provided with 
#Matlab
_LB_INCLUDE = C:\Programme\MATLAB\R2007b\extern\include
#or Intel MKL
#_LB_INCLUDE = C:\Programme\Intel\MKL\9.0\include
#-------------------------------------------------------------------------------
...
                  -DUSEMatlab -D__MSVC__
#		  -DUSEIntelMKL -D__MSVC__

Note: All pathes shown here are relative pathes to the ApCoCoALib folder.

Compilation

Open a Visual Studio command prompt and change to your local ApCoCoALib folder. Use the nmake command to compile the ApCoCoALib:

nmake -f Makefile.vc ApCoCoALib

To show all available targets call

nmake -f Makefile.vc

Problems

If you encounter problems check out the forum: ApCoCoA Forum