Main Page Namespace List Class Hierarchy Compound List File List Namespace Members Compound Members File Members Related Pages

Lemur Toolkit Documentation

2.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.
  - --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 Note: If you rerun configure, you will have to make this change again. Advanced users should edit configure.ac and 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. Terminate each line with a semicolon. For example,
```
    index = /usr0/mydata/index.ifp;
  
```
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 Fri Feb 6 07:11:45 2004 for LEMUR by

1.2.16