Difference between revisions of "ApCoCoALib:Install"
From ApCoCoAWiki
(pushing in current state.) |
(first corrections. more to come.) |
||
| Line 1: | Line 1: | ||
This is a copy of ApCoCoALib's INSTALL file: | This is a copy of ApCoCoALib's INSTALL file: | ||
| + | To see a more detailed guide to built ApCoCoALib, please consult [[ApCoCoALib:CompilationInstructions]]. | ||
| − | + | INSTALLATION guide for the ApCoCoALib | |
| − | INSTALLATION guide for the | ||
=================================== | =================================== | ||
Currently these instructions are for Unix/Linux and MacOSX machines. | Currently these instructions are for Unix/Linux and MacOSX machines. | ||
| − | |||
This library is supplied as source code in C++, and must be compiled | This library is supplied as source code in C++, and must be compiled | ||
| Line 24: | Line 23: | ||
* an installation of GMP (version 4.1.4 or later) -- see http://www.swox.com/gmp/ | * an installation of GMP (version 4.1.4 or later) -- see http://www.swox.com/gmp/ | ||
[GMP 4.1.3 contains a critical bug affecting CoCoA::RingFloat] | [GMP 4.1.3 contains a critical bug affecting CoCoA::RingFloat] | ||
| + | |||
| + | * an installation of CoCoALib (version 0.9.10 or later) -- see http://cocoa.dima.unige.it/ | ||
| + | |||
| + | Optionally you can include the following software | ||
| + | |||
| + | * a Blas / Lapack installation (for example Atlas, or Apple's acceleration framework) | ||
| + | |||
| + | * an installation of Linbox | ||
| + | |||
| + | * an installaion of Bertini | ||
| + | |||
| + | These optional libraries / software packages enhance ApCoCoALib's functionality. | ||
If you need to install g++ or GMP, please refer to their distributions | If you need to install g++ or GMP, please refer to their distributions | ||
| Line 30: | Line 41: | ||
| − | Compilation of | + | Compilation of ApCoCoALib |
----------------------- | ----------------------- | ||
| − | Short instructions: just run these commands from the | + | Short instructions: just run these commands from the ApCoCoALib root directory |
./configure | ./configure | ||
make | make | ||
| Line 39: | Line 50: | ||
| − | To be able to use the | + | To be able to use the ApCoCoA library you must first compile it. Currently |
the library has been built and tested only on Linux/Unix platforms and on | the library has been built and tested only on Linux/Unix platforms and on | ||
MacOSX. The instructions below refer to these platforms only. | MacOSX. The instructions below refer to these platforms only. | ||
| Line 53: | Line 64: | ||
Ideally you should check through the output produced to ensure that | Ideally you should check through the output produced to ensure that | ||
no errors were found. The presence of a few compiler warnings may | no errors were found. The presence of a few compiler warnings may | ||
| − | safely be ignored. The compiled library is placed in lib/ | + | safely be ignored. The compiled library is placed in lib/libapcocoa.a. |
The command "make install" does not yet work. | The command "make install" does not yet work. | ||
| Line 60: | Line 71: | ||
(4) Have a look at the examples in the subdirectory examples/ and enjoy | (4) Have a look at the examples in the subdirectory examples/ and enjoy | ||
| − | + | ApCoCoALib. We look forward to hearing from you. | |
| Line 67: | Line 78: | ||
-------- | -------- | ||
| − | If you encounter problems while trying to compile | + | If you encounter problems while trying to compile ApCoCoALib, try writing on |
| − | the CoCoA Forum: | + | the (Ap-) CoCoA Forum: |
| − | http:// | + | http://apcocoa.org/forum/ |
In your message you should state the platform and compiler you are | In your message you should state the platform and compiler you are | ||
| − | using; also the version of GMP should be mentioned. | + | using; also the version of GMP should be mentioned. |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
[[Category:ApCoCoALib]] | [[Category:ApCoCoALib]] | ||
Revision as of 16:02, 13 December 2007
This is a copy of ApCoCoALib's INSTALL file: To see a more detailed guide to built ApCoCoALib, please consult ApCoCoALib:CompilationInstructions.
INSTALLATION guide for the ApCoCoALib =================================== Currently these instructions are for Unix/Linux and MacOSX machines. This library is supplied as source code in C++, and must be compiled before you can use it -- instructions on how to do this are below. Prerequisites ------------- Before compilation you must ensure that you have available:- * a "make" program (any version should suffice); * a C++ compiler together with the standard C++ libraries (we use extensively g++ (versions 3.4.n and 4.0.n)) * an installation of GMP (version 4.1.4 or later) -- see http://www.swox.com/gmp/ [GMP 4.1.3 contains a critical bug affecting CoCoA::RingFloat] * an installation of CoCoALib (version 0.9.10 or later) -- see http://cocoa.dima.unige.it/ Optionally you can include the following software * a Blas / Lapack installation (for example Atlas, or Apple's acceleration framework) * an installation of Linbox * an installaion of Bertini These optional libraries / software packages enhance ApCoCoALib's functionality. If you need to install g++ or GMP, please refer to their distributions for the appropriate instructions. Compilation of ApCoCoALib ----------------------- Short instructions: just run these commands from the ApCoCoALib root directory ./configure make make examples # if you want to compile the examples To be able to use the ApCoCoA library you must first compile it. Currently the library has been built and tested only on Linux/Unix platforms and on MacOSX. The instructions below refer to these platforms only. (1) The (interactive) configure script attempts to find a C++ compiler, and the GMP library and header files. If it has trouble, it will print out a message telling you. (2) If you are confident about choosing the compiler and its compilation flags then run "./configure --help" for information about specifying these. (3) Execute "make" -- this will compile the library and run the tests. Ideally you should check through the output produced to ensure that no errors were found. The presence of a few compiler warnings may safely be ignored. The compiled library is placed in lib/libapcocoa.a. The command "make install" does not yet work. The command "make library" will compile the library but not run the tests. The command "make check" will run the tests -- the tests are in src/tests/. (4) Have a look at the examples in the subdirectory examples/ and enjoy ApCoCoALib. We look forward to hearing from you. Trouble? -------- If you encounter problems while trying to compile ApCoCoALib, try writing on the (Ap-) CoCoA Forum: http://apcocoa.org/forum/ In your message you should state the platform and compiler you are using; also the version of GMP should be mentioned.
