Lemur Toolkit Documentation

4.2

Installation

To configure the lemur toolkit
1. go to top level lemur directory.
2. run configure to generate MakeDefns, Makefile, and Makefile.app. configure accepts following arguments:
  - --enable-distrib compiles and installs the distributed retrieval components. Default is disabled.
  - --enable-summarization compiles and installs the summarization components. Default is disabled.
  - --enable-cluster compiles and installs the document clustering components. Default is disabled.
  - --enable-assert Enable assert statements in the code. Default is disabled.
  - --prefix=<install-directory> Specifies the directory for the installed toolkit. Default is /usr/local.

To make the lemur toolkit library and applications
1. go to top level lemur directory.
2. run make (or gmake)

To clean the lemur toolkit (remove everything but the source)
1. go to top level lemur directory.
2. run make clean (or gmake clean)

To install the lemur toolkit library and applications.
1. follow the instructions above for configuring and making the toolkit library and applications.
2. go to top level lemur directory.
3. run make install (or gmake install)

The lemur include files will be installed in <install-directory>/include, the lemur library will be installed in <install-directory>/lib/liblemur.a, and the applications will be installed in <install-directory>/bin. If you only want the applications, you can use make install-bin. If you only want the library and header files, you can use make install-lib. The stemmer data files are installed in <install-directory>/kstem_data and <install-directory>/arabic_stem_data when either the applications or the library are installed.

Programming with the lemur toolkit

To build an application using the toolkit library:

follow the instructions above for installing the toolkit library.
Copy Makefile.app from the top level lemur directory to the directory with your application's source code. Edit the file and fill in values for
- OBJS -- list of each of the object files needed to build your application.
- PROG -- name for your application.
use make -f Makefile.app to build your application.

Change the toolkit

Modifying the toolkit is not recommended, but individual users may need to customize its behavior.

To modify an existing file or add a file to an existing directory:
1. Make the changes
2. follow the instructions above for making the toolkit library and applications.
3. follow the instructions above for installing the toolkit library.

To add a new (library) module to the toolkit:
1. Add the module subdirectory to lemur, for example "<new-module-dir>".
2. Put all include files in the subdirectory named "<new-module-dir>/include".
3. Put all implementation files in the subdirectory named "<new-module-dir>/src".
4. Add the module directory name to the Makefile variable LIBDIRS and to the MakeDefns variables MODULES and ALLMODULES. New modules should be placed at the front of the lists. Note: If you rerun configure, you will have to make this change again. Advanced users should edit MakeDefns.in to add the module directory name to ALLMODULES and edit configure.ac to add an AC_ARG_ENABLE for the new module (see the distrib entry in configure.ac) and then use autoconf to generate a new configure script.
5. Copy a Makefile from an existing module directory (e.g, index/src/Makefile) to <new-module-dir>/src, and change the variable MODULE to the name of the new module (<new-module-dir>).

To run lemur applications

Create a parameter file with value definitions for all the input variables of an application. For example,
```
    <parameters>
      <index>/usr0/mydata/index.ifp</index>
    </parameters>
  
```
Most applications will display a list of required input variables, if you run it with the "--help" option.

Run the application program without the parameter file as the only argument.

To try the sample data

Go to the data directory, run "test_pos_index.sh" which is a self-explanatory shell script that will build an index, run several retrieval algorithms with some sample parameter files, and then evaluate the retrieval performance.

Generated on Tue Dec 13 10:18:38 2005 for LEMUR by

1.4.2