GF OAA Agent

Björn Bringert, bringert@cs.chalmers.se

Introduction

The Open Agent Architecture (OAA) is "a framework for integrating a community of heterogeneous software agents in a distributed environment".

This document describes the GF OAA Agent included with the GF Java interpreter.

Running

If the grammar properties file is test.properties and the facilitator is running on $FAC_HOST, port $FAC_PORT, the GF agent is started with:

$ java -cp $CLASSPATH:gfc2java.jar:. se.chalmers.cs.gf.oaa.GFAgent test.properties -oaa_connect "tcp('${FAC_HOST}',${FAC_PORT})"

Notes

• $CLASSPATH must contain the paths to:

  • OAA 2.3.0 and all its requirements.
  • The Trindikit Java library (for the OAAAgent class).
  • The directory where the properties file is located.

Solvables

The OAA agent declares these solvables:

• parse
• linearize
• translate
• list_grammars
• list_languages
• load_grammar

parse

parse(Grammar,Lang,Text,Tree)

Parameters

Grammar

The name of the grammar. This is the value of the name parameter in the properties file.

Lang

The name of the concrete syntax that should be used for parsing. If Lang is not instantiated, the parser will try all available languages in the given grammar, and return results for each language that the text can be parsed in.

Text

The text to parse. Must be instantiated.

Tree

The parse tree. Normally not instantiated. The parse tree from the parser is unified with this value. Parse trees are represented as ICL structs.

Examples

• Language given, unambiguous parse:

  parse(numerals, german, 'drei hundert', Tree)
  =>
  parse(numerals,german,'drei hundert',gf(num,gf(pot2as3,gf(pot2,gf(pot0,gf(n3))))))
  

• Language uninstantiated, unambiguous parse:

  parse(numerals, Lang, 'three hundred', Tree)
  =>
  parse(numerals,english,'three hundred',gf(num,gf(pot2as3,gf(pot2,gf(pot0,gf(n3))))))
  

• Language uninstantiated, parses with several languages to same parse tree:

  parse(numerals, Lang, 'tre', Tree)
  =>
  parse(numerals,albanian,tre,gf(num,gf(pot2as3,gf(pot1as2,gf(pot0as1,gf(pot0,gf(n3)))))))
  parse(numerals,danish,tre,gf(num,gf(pot2as3,gf(pot1as2,gf(pot0as1,gf(pot0,gf(n3)))))))
  parse(numerals,italian,tre,gf(num,gf(pot2as3,gf(pot1as2,gf(pot0as1,gf(pot0,gf(n3)))))))
  parse(numerals,norwegian_book,tre,gf(num,gf(pot2as3,gf(pot1as2,gf(pot0as1,gf(pot0,gf(n3)))))))
  parse(numerals,swedish,tre,gf(num,gf(pot2as3,gf(pot1as2,gf(pot0as1,gf(pot0,gf(n3)))))))
  

• Language uninstantiated, parses with several languages to different parse trees:

  parse(numerals, Lang, 'tres', Tree)
  =>
  parse(numerals,catalan,tres,gf(num,gf(pot2as3,gf(pot1as2,gf(pot0as1,gf(pot0,gf(n3)))))))
  parse(numerals,danish,tres,gf(num,gf(pot2as3,gf(pot1as2,gf(pot1,gf(n6))))))
  parse(numerals,spanish,tres,gf(num,gf(pot2as3,gf(pot1as2,gf(pot0as1,gf(pot0,gf(n3)))))))
  

linearize

linearize(Grammar,Lang,Tree,Text)

Parameters

Grammar

The name of the grammar. This is the value of the name parameter in the properties file.

Lang

The name of the concrete syntax that should be used for linearization. If Lang is not instantiated, linearizations for all available languages in the given grammar will be returned.

Tree

The abstract syntax tree to linearize. Must be instantiated.

Text

The linearization of the given tree.

Examples

• Language given:

  linearize(numerals,english,gf(num,gf(pot2as3,gf(pot1as2,gf(pot0as1,gf(pot0,gf(n3)))))),Str)
  =>
  linearize(numerals,english,gf(num,gf(pot2as3,gf(pot1as2,gf(pot0as1,gf(pot0,gf(n3)))))),three)
  

translate

translate(Grammar,FromLang,Input,ToLang,Output)

Parameters

Grammar

The name of the grammar. This is the value of the name parameter in the properties file.

FromLang

The name of the concrete syntax that should be used for parsing the input text. If Lang is not instantiated, all available languages in the given grammar will be tried.

Input

The input text. Must be instantiated.

ToLang

The name of the concrete syntax that should be used for linearizing the output.

Output

The output text. Normally not instantiated.

Examples

• Input language not given:

  translate(numerals, Lang, 'tres', english, Str)
  =>
  translate(numerals,catalan,tres,english,three)
  translate(numerals,danish,tres,english,sixty)
  translate(numerals,spanish,tres,english,three)
  

list_grammars

list_grammars(Grammars)

Parameters

Grammars

The list of available grammars.

Examples

• Get all grammars:

  list_grammars(Grammars)
  =>
  list_grammars([query,answer])
  

list_languages

list_languages(Grammar, InputLangs, OutputLangs)

Parameters

Grammar

The grammar to get the languages for. If uninstantiated, there will be one answer for each available grammar.

InputLangs

A list of the available input languages for the grammar.

OutputLangs

A list of the available output languages for the grammar.

Examples

• Get languages for all grammars (Grammar uninstantiated):

  list_languages(Grammar, InputLangs, OutputLangs)
  =>
  list_languages(query,['*all*','GbgQueryEng','GbgQuerySwe'],['*all*','GbgQueryEng','GbgQuerySwe'])
  list_languages(answer,['*all*','GbgRouteEng','GbgRouteMap','GbgRouteSwe'],['*all*','GbgRouteEng','GbgRouteMap','GbgRouteSwe'])
  

• Get languages for the query grammar (Grammar instantiated):

  list_languages('query', InputLangs, OutputLangs)
  =>
  list_languages(query,['*all*','GbgQueryEng','GbgQuerySwe'],['*all*','GbgQueryEng','GbgQuerySwe'])
  

load_grammar

load_grammar(PropFile,Name)

Parameters

PropFile

The path to a grammar properties file (required). This path is relative to the working directory of the GF agent.

Name

This parameter will be set to the name of the grammar. This name is the one that should be passed as the Grammar parameter to the other solvables.

Examples

• Load a grammar:

  load_grammar('test.properties', Test)
  =>
  load_grammar('test.properties', 'test')