SHOE Search User's Guide

Contents

Introduction

This guide describes how to configure and use SHOE Search, a general purpose tool for querying SHOE knowledge.

This version of SHOE Search uses Parka as its knowledge base and will not work without it. It is possible to design variants of SHOE Search that work with other types of knowledge bases by creating different implementations of the abstract class ShoeKb.KBInterface.

SHOE Search is provided under the terms of the GNU General Public License. See the file License.html for details.

Running the Program

The SHOE Search application can be executed with the following command:

java ShoeSearch.SS_Frame kbname kbhost kbport
The kbname parameter is the name of a Parka knowledge base, kbhost is the host machine of a Parka server, and kbport is the port number of a Parka server.

Alternatively, a subclass of ShoeSearch can be created which sets default values for each of these parameters. For example, the following code sets the default kbname to mykb, kbhost to myserver.com, and kbport to 9999.

   DEFAULT_KB_NAME = "mykb";
   DEFAULT_HOST    = "myserver.com";
   DEFAULT_PORT    = 9999;

Usage

SHOE Search is relatively simple to use. Once the application is running, just follow these steps:
  1. Select an ontology.The pull-down list allows you to select from one of the available ontologies. By default, the base ontology is selected for you.
  2. Select the category that best describes the subject of your query. The list displays all terms used by the ontology. Subcategories are indented beneath their parent categories.
  3. Press the Select button. A list of properties that apply to the category you have chosen is displayed to the right of the category list.
  4. Enter your query terms.Type in values (e.g., URLs, names, numbers, etc.) for those properties which you wish to use to restrict your search. Use the Show checkbox to display a property in your query results without restricting it to a particular value. Use the Find button to display all instances that have a value for that property and the corresponding values. To use one of these values in your query, select it and press the Add To Query button.
  5. Press the Query button. The results of your query are displayed below the category list and properties. Click and drag on the borders between column headings to change the size of columns.
  6. View a Web page. Double-click on a URL or select one and press Get Page to open another window that displays the web page.
  7. Issue the same query to the general web. Press Web Search to issue a similar query to a popular search engine.