Installation
Installation
How to obtain iMath
iMath is hosted at SourceForge. You can download the curent release from [1]. A complete overview of all files is available in the files section [2].
Requirements
To compile and use iMath, the GiNaC, CLN, GMP and EQC libraries are required, as well as the standard C++ development libraries, flex and bison. Information about these libraries can be found at the GiNaC library homepage, CLN library homepage and EQC library homepage. Compilation has been tested with EQC 1.4.1 using g++-4.4. Older versions will most probably not work.
Compilation and installation
In order to compile and install iMath on your system, type the following in the base directory of the iMath distribution:
% ./configure % make % make install
Since iMath uses autoconf you should have no trouble compiling it. Should you run into problems please report them to the the author.
Cross-compiling for Windows
I have given up on this, maybe someone else wants to try? The following is what I tried, but I could never get configure to build DLLs.
iMath could maybe be cross-compiled for windows by installing the mingw32 package. The following steps are necessary to build iMath for windows under Debian GNU Linux:
* Compile and install the CLN library (run configure with --host=i586-mingw32msvc --prefix=/usr/i586-mingw32msvc --without-gmp, then make and make install). Maybe it needs to be patched (see http://thep.physik.uni-mainz.de/pipermail/cln-list/2005-April/000116.html). * Compile and install the gmp library. (run configure with --host=i586-mingw32msvc --prefix=/usr/i586-mingw32msvc, then make and make install). On my system, this requires a patch to configure: Replace the statement BITS_PER_MP_LIMB=`expr 8 \* $ac_cv_sizeof_mp_limb_t` with BITS_PER_MP_LIMB=32 (or whatever value is correct for your system. To find this out, insert an echo $ac_cv_sizeof_mp_limb_t and multiply by 8 manually). * Compile and install the ginac library (run configure with --host=i586-mingw32msvc --prefix=/usr/i586-mingw32msvc --with-cln-prefix=/usr/i586-mingw32msvc, then make and make install).. You can ignore the error about libreadline not being found, since we will not be needing ginsh. * Compile and install the eqc library. * If make reports an error while compiling input_lexer.cc, edit the file config.h created by configure, and at the end, put #define YYTEXT_POINTER 1. If you don't want to rebuild all the files compiled up to then, run make -t, remove all files with size 0, and re-run make. * Probably, linking of ginsh.exe and viewgar.exe in GiNaC will also fail, but since they are not necessary, just run make -t in the subdirectories ginsh and tools. * Set the environment variable CPPFLAGS to -DMINGW. * Run 'make distclean' if necessary. * Run configure with --host=i586-mingw32msvc --prefix=/usr/i586-mingw32msvc --with-ginac-prefix=/usr/i586-mingw32msvc. This might require a patch to /usr/i586-mingw32msvc/bin/ginac-config: Replace the line saying "echo $libdirs -lginac -L/usr/lib -lcln -lgmp" with "echo ${exec_prefix}/lib/libginac.a ${exec_prefix}/lib/libcln.a ${exec_prefix}/lib/libgmp.a" * You might want to strip the imath.dll library: i586-mingw32msvc-strip imath.dll. This will greatly reduce the file size. * Install imath.oxt into openoffice using the extension manager (options-extension manager). * Install the html documentation from the doc subdirectory in your favourite location.
Compiling for Windows
Preparing the Openoffice SDK with Microsoft Visual C++
To build iMath for Windows, you need the Windows Openoffice SDK.
* Download and install the Openoffice SDK * The following is explained in detail in "SDK installation directory"\sdk\docs\install.html * Install Microsoft Visual C++ (the free express version will do, then you also need to install the Microsoft Visual Studio 2008 Redistributable Package * Install make and zip (for example, in WINDOWS\system32, or somewhere else in your path)
To test the SDK installation, open a command prompt and cd to the ...\sdk\examples\cpp\DocumentLoader directory. Run ...\sdk\setsdkenv_windows.bat to configure your environment. This should create a custom batch file somewhere in your home directory. I had to edit this custom batch file and add a correct URE path: set OO_SDK_URE_HOME=C:\Programme\OpenOffice.org 3\URE Now try to build the example by typing make, if this is not successful fix the problems before continuing.
Preparing MSYS and Mingw
Download the necessary files from mingw.
* Install msys and msysdtk from www.mingw.org. You will need flex and bison, among others * Click on the MSYS icon to start a Bourne shell * Add .../Microsoft Visual Studio 9.0/Common7/IDE and .../Microsoft Visual Studio 9.0/VC/BIN to PATH (PATH="$PATH":"..."). You can find these paths in vsvars32.bat somewhere in the Visual Studio installation directory. * If you want to use cl (the Microsoft compiler) to compile something, copy .../Microsoft Visual Studio 9.0/BIN to the msys /vc (or find a better way to make CPPFLAGS accept path names with spaces) * Copy Microsoft SDKs/Windows/Vxxx/lib to msys /sdk (or find a better way to set the cl.exe LIB path)
Compiling gmp with gcc
Download and unpack gmp into your msys home directory.
* Change into the new directory.
* For a shared library build, run configure with --disable-static --enable-shared. Then do make, make check and make install
* Change into the .libs subdirectory
* Make sure the MSVC binaries are in your path and run lib /def:libgmp-3.dll.def /out:libgmp-3.lib
* Copy libgmp-3.exp, libgmp-3.dll.def and libgmp-3.lib into /usr/local/lib.
* Do make distclean
* For a static library build, run configure with --enable-static --disable- shared (note that it is not possible to build both
static and shared libraries in one compilation run).
* Do make, make check and make install
* Note that make install overwrites the libgmp.la for dynamic linking in /usr/local/lib.
* Download objconv objconv and put the executable somewhere into your msys path.
* Change into the .libs subdirectory
* Run objconv -fcoff -nr:___chkstk:__chkstk libgmp.a libgmp.lib to make the symbols compatible with MSVC
* Copy the new libgmp.lib into /usr/local/lib
To compile a test program with MSVC:
* Open a DOS command shell and go to the gmp directory.
* You can find some example files in the demos subdirectory of gmp.
* For a dynamically linked program, run cl /MD -I \vc\include -I \sdk\include -I \local\include isprime.c
/link /LIBPATH: \vc\lib /LIBPATH: \sdk\lib LIBPATH: \local\lib libgmp-3.lib
* For a static link, substitute libgmp-3.lib with libgmp.lib
Compiling CLN with gcc
Download the CLN source code and unpack it into your msys home directory
* Change to the source directory * run configure with --with-gmp=/usr/local CPPFLAGS="-DNO_ASM" LDFLAGS="-Wl,--enable-auto-import -static". * Note: I tried --enable-shared --enable-static --with-gmp=/usr/local/ and it failed * Note: Without the -static the program crashes because it is linked to libstdc++.dll.a, but it works when linking manually to libstdc++.a * Note: Without the -DNO_ASM there is alinker error at pi.exe: multiple definition of shift1right_loop_down * Do make, make check, make install * Do NOT strip the libcln.a even though it is huge, linking to it will subsequently fail. Instead, strip the .exe files produced
Compiling GiNaC 1.5.7 with gcc
Download the GiNaC source code and unpack it into your msys home directory
* Download pkg-config, glib from the GTK project. Unzip the files and install them under /mingw * Change to the source directory * Run configure with --disable-shared PKG_CONFIG_PATH=/usr/local/lib/pkgconfig LDFLAGS="-Wl,--enable-auto-import -static" * Do make, make check, make install * If the compile fails in function.cpp line 1800: Remove "new" and make "->" become "." (IMHO the return type of the function is ex and not ex*) * According to this post changing "power::power" to "GiNaC::power" is enough
Compiling eqc with gcc
Download the EQC source code and unpack it into your msys home directory
* You might be missing some autoconf macros (e.g. ac_cxx_have_sstream.m4). Get Autoconf archive and install it into /usr/share/aclocal. * You also need Mingw libasprintf from the gettext directory * Run configure with PKG_CONFIG_PATH=/usr/local/lib/pkgconfig LDFLAGS="-Wl,--enable-auto-import -static" *
TODO and ideas
* EQC: In utils.h make ext/hash_fun.h be backward/hash_fun.h for mingw windows compile (but ext/hash_fun.h is correct for mingw linux cross-compilation) * CLN: use gcc-created cl_asmXXX files with cl compilation? * For C++, /EHsc is recommended by MSVC to remove errors concerning exception handling * According to the GMP documentation, MSVC must use the /MD flag when linking to gmp * objconv -fcoff -nu works on libeqc.a and libginac.a from a standard Ubuntu install. Use it instead of compiling it under msys?
Compilation with Microsoft Visual C++
This is what I tried to get a native MSVC compile (because Openoffice is compiled with MSVC). But after some trying and reading I found out the CLN is not compileable with anything except gcc. So I gave up on this.
* Install mingw (the minimal version will do since we will be using the Microsoft compiler) * Set your PATH as described above in the gcc compile section and create the msys /vc and /sdk directories * Create the /vc/include/sys directory and put /vc/include/time.h into it
Download the CLN source code and unpack it into your msys home directory
* Change to the source directory * run ./configure CC=cl CXX=cl CCAS=cl CPPFLAGS="-DNO_ASM -EHsc -MD -I/vc/include -I/sdk/include" LIB=/vc/lib:/sdk/lib --with-gmp=/usr/local LDFLAGS=/usr/local/lib/libgmp.lib * make will stop and complain about missing files cl_asm.obj and cl_asm_GF2.obj * copying cl_asm.o from a gcc compile to cl_asm.obj gives lots of linker errors * change to the src subdirectory * Remove cl_asm.lo and cl_asm_GF2.lo * Edit the Makefile and find the lines starting with "cl_asm.lo:" and "cl_asm_GF2.lo:". Remove the comment from the first line below them * Change cl_asm.S and cl_asm_GF2.S to cl_asm.cc and cl_asm_GF2.cc in the first lines and in the lines you just uncommented (because MSVC doesn't recognize the .S extension) * cp base/digitseq/cl_asm.S to base/digitseq/cl_asm.cc. cl_asm_GF2.cc already exists in my distribution and is identical to cl_asm_GF2.S * run make cl_asm.lo and make cl_asm_GF2.lo. This should create cl_asm.obj and cl_asm_GF2.obj * If you get a libtool error about not finding cygpath, edit libtool in the cln root directory and find the line reading fix_srcfile_path="\`cygpath -w \"\$srcfile\"\`. Change it to fix_srcfile_path="$srcfile". * Run make again. The build will finish with some linker warnings about duplicate definitions and create the library in .libs * To make check, edit Makefile and add /vc/lib/msvcprt.lib /vc/lib/msvcrt.lib /vc/lib/oldnames.lib /sdk/lib/Kernel32.lib to linking of exam.exe Make check chokes on the link with 83 undefined references * For a dynamic link to gmp, substitute libgmp.lib with libgmp-3.dll in the configure step. This two libraries must be created as explained above in the compiling GMP with gcc section * tried (--without-gmp --enable-shared --disable-static) * The compile chokes on the assembler routines without -DNO_ASM, and with it, on "cygpath" (probably a libtool problem) * Copy cl_asm.o and cl_asm_GF2.o from a gcc compile of CLN to src/cl_asm.obj and src/cl_asm_GF2.obj * Now the library will link with a lot of warnings about duplicate references
Download the Ginac source code and unpack it into your msys home directory
* Download pkg-config, glib from the GTK project. Unzip the files and install them under /mingw * Change to the source directory * Run ./configure CC=cl CXX=cl CPPFLAGS="-I/vc/include -I/sdk/include" LIB=/vc/lib:/sdk/lib PKG_CONFIG_PATH=/opt/ginac/lib/pkgconfig --enable-shared * I had to edit clifford.cpp and change "or" to "||" and "not" to "!" (Am I missing new developments in the C language?). In function.cpp, I removed "new" and made "->" be ".". In symmetry.cpp, "iterator" became "const_iterator". parser/parse_binop_rhs.cpp "__func__" became ""unknown"", and also in polynomial/debug.h
Binary packages
If all this is too complicated for you, RPM and Debian packages have been released on SourceFourge. They are accessible on the iMath project page [3]
Bugs
Known bugs
* ...
Reporting bugs
Please report all bugs to the author. You should include the following information:
* Version of iMath, how you obtained it (RPM, CVS, binary or source). * The input file that produces the errors. * The output produced by iMath when running openoffice.org -writer <input file> from the command line * Set the debugging option (Extras-Options-Writer-iMath) to a higher value to get more debugging output