Building on Linux

Building on Linux

Prerequisites

A suitable recent version of GCC (tested with 4.0.2)
Boost C++ libraries. This includes boost-regex, boost-program-options and the boost-test library which some distributions pack into separate packages.
wxWidgets >= 2.6.0 (it does not work with older versions)
Note that it was only tested with the gtk version of wxWidgets. Unfortunately Alwis only works with the non unicode version of wxWidgets. At the time Alwis was developed we were unable to get a unicode version running on both Windows and Linux.
GNU Scientific Library (GSL)
Automatically Tuned Linear Algebra Software (ATLAS)
OCaml including its build tools (aka findlib)
latex (only for manual in PDF format)
UPX (Ultimate Executable Packer)

As the installation procedure for the packages mentioned above differs widely across the different Linux distributions, we will not explain it here. Please refer to your distributions manual or ask your system administrator.

Please note that many distributions do not include the tex2rtf tool in their wxWidgets packages. If you want to use make use of the help facility you must acquire the sources to tex2rtf from the wxWidgets website and compile it yourself. As mentioned above you probably have to do so anyway, as many distributions only pack the unicode version of wxWidgets.

Building the Alwis suite

There is a global makefile in the directory "src''. There are five targets in this makefile: "gui'', "tools_gcc'', "tools_ocaml'', "help'' and "setup''. The target "setup'' only works on windows (it builds the installer). In order to build the whole package on Linux just type the following commands:

    make gui
    make tools_cpp
    make tools_ocaml
    make help

At the end of the compilation process the executables are still located at their corresponding source directories as listed below. You should copy them into a directory in your path.

Executable Location

cat2stream src/tools/stream/cat2stream

filterstream src/tools/stream/filterstream

stemstream src/tools/stream/stemstream

stream2queries src/tools/stream/stream2queries

stream2matrix src/tools/stream/stream2matrix

compute-spectral src/tools/compute-spectral/compute-spectral

compute-lsi src/tools/compute-lsi/compute-lsi

compute-plsi src/tools/compute-plsi/compute-plsi

engine src/queryengine/engine

alwis src/gui/alwis

All you need to do now is adapt the Alwis configuration file and copy it into the standard places. We provide a template configuration file at "src/linux/Alwis.conf'', which should work out of the box. Please refer to the corresponding section for further information.

Executable	Location
`cat2stream`	`src/tools/stream/cat2stream`
`filterstream`	`src/tools/stream/filterstream`
`stemstream`	`src/tools/stream/stemstream`
`stream2queries`	`src/tools/stream/stream2queries`
`stream2matrix`	`src/tools/stream/stream2matrix`
`compute-spectral`	`src/tools/compute-spectral/compute-spectral`
`compute-lsi`	`src/tools/compute-lsi/compute-lsi`
`compute-plsi`	`src/tools/compute-plsi/compute-plsi`
`engine`	`src/queryengine/engine`
`alwis`	`src/gui/alwis`