1. A step-by-step tutorial to launch Terrier under Eclipse
Institut de Recherche en Informatique de Toulouse – Paul Sabatier University
A step-by-step tutorial to launch Terrier under Eclipse
Duy Dinh IRIT, Paul Sabatier University

2. Download Download Terrier on the Terrier website
Select the appropriate version
Check out the following resources:
Terrier forum
Terrier documentation
Terrier tutorial
Extract Terrier to a directory on your local machine (e.g., /usr/local/Downloads).

3. Create New Project with Terrier
Under Eclipse, create a new Java project in your workspace (e.g., /usr/local/workspace).
Name project as terrier-xx, where ‘xx’ stands for Terrier’s version. Your project will be created in the current workspace (e.g., /usr/local/workspace/terrier-xx)
Copy the following folders from the extracted folder to the target project (e.g., …./terrier-xx) in your workspace:
‘src’ : Java source
‘lib’ : referenced library
‘etc’ : configuration
‘share’ : resource files
‘var’ : index, resutls.

4. Create New Project with Terrier
Reorganize ‘src’ folder so that the project structure looks like as follows: src/org/terrier/….

5. Import library
Right-click on the project name in the ‘Package Explorer’
Select Build path  Configure build path
Select the tab ‘Libraries’  Add External Jar
Select all the .jar files in the ‘lib’ folder

6. Locating the main class
Go to the package org.terrier.applications.TrecTerrier.java

7. Locating the main class
Double click on TrecTerrier.java, click on the main() method and modify it as follows:

8. Configure Terrier
Go to the terrier-xx/etc, copy the terrier.properties.sample to terrier.properties
Modify the following properties
terrier.home=…/terrier-xx/
terrier.index.path=…/terrier-xx/var/index
terrier.results=…/terrier-xx/var/results
etc…
Specify the input of Terrier:
Document collection
Topics (queries)
Qrel files
Etc…
For more details on the properties, please check the properties list of Terrier.

9. Launch TrecTerrier.java
Right click on the TrecTerrier.java
Run as  Run configuration  Java application

10. Specifying virtual arguments
Select Arguments tab and specifying virtual arguments
An alternative method to avoid specifying VM arguments is to modify the class ApplicationSetup.java so that Terrier is able to locate the settings in the /etc directory

11. A step-by-step tutorial to launch Terrier under Eclipse
Institut de Recherche en Informatique de Toulouse – Paul Sabatier University
A step-by-step tutorial to launch Terrier under Eclipse
Duy Dinh IRIT, Paul Sabatier University