edu.nyu.jet.aceJet

Class Gazetteer

java.lang.Object

edu.nyu.jet.aceJet.Gazetteer

public class Gazetteer
extends Object

a set of names of locations (countries, cities, etc.).

Since names often consist of several tokens, all name parameters are of type String[], with one array element for each token of a name.

Constructor Summary

Constructors

Constructor and Description
Gazetteer() create a new, empty Gazetteer.

Method Summary

Methods

Modifier and Type	Method and Description
String[]	canonicalCountryName(String[] s) if s is the alias of a location name, returns the primary location name, else null.
String[]	capitalToCountry(String[] s) if s is the name of the capital of a country, returns the associated country name, else null.
boolean	isCountry(String[] s) returns true if s is the name of a country (either the primary name or an alias).
boolean	isCountryAlias(String[] s) returns true if s is an alias of a location name.
boolean	isLocation(String[] s) returns true if s is the name of any type of location (either the primary name or an alias).
boolean	isNational(String[] s) returns true if s is the name of a national.
boolean	isNationality(String[] s) returns true if s is a nationality adjective.
boolean	isNationals(String[] s) returns true if s is the name of a set of nationals.
boolean	isRegionOrContinent(String[] s) returns true if s is the name of a region or continent (either the primary name or an alias).
boolean	isState(String[] s) returns true if s is the name of a U.S.
void	load() load the Gazetteer from the file specified by parameter Gazetteer.fileName of the configuration file.
void	load(String fileName) load the Gazetteer from file fileName.
String	locationType(Document doc, String locationName) returns "country", "stateorprovince", or "city" as the type of 'locationName' based on three types of evidence: - entries in the gazetteer itself - a coreferential nominal mention, typically from a construct 'city of X' or 'X province' - the last token of the location name
static void	main(String[] args)
String[]	nationalityToCountry(String[] s) if s is a nationality adjective, returns the associated country name, else null.
String[]	nationalsToCountry(String[] s) if s is the name of a set of nationals, returns the associated country name, else null.
String[]	nationalToCountry(String[] s) if s is the name of a national, returns the associated country name, else null.
void	setMonocase(boolean monocase) sets the monocase which, when true, ignores case for Gazetteer predicates.
static String[]	splitAtWS(String s)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Gazetteer

public Gazetteer()

create a new, empty Gazetteer.

Method Detail

load

public void load()
          throws IOException

load the Gazetteer from the file specified by parameter Gazetteer.fileName of the configuration file.

Throws:

IOException

load

public void load(String fileName)
          throws IOException

load the Gazetteer from file fileName.

Throws:

IOException

setMonocase

public void setMonocase(boolean monocase)

sets the monocase which, when true, ignores case for Gazetteer predicates.

isNationality

public boolean isNationality(String[] s)

returns true if s is a nationality adjective.

nationalityToCountry

public String[] nationalityToCountry(String[] s)

if s is a nationality adjective, returns the associated country name, else null.

isNational

public boolean isNational(String[] s)

returns true if s is the name of a national.

nationalToCountry

public String[] nationalToCountry(String[] s)

if s is the name of a national, returns the associated country name, else null.

isNationals

public boolean isNationals(String[] s)

returns true if s is the name of a set of nationals.

nationalsToCountry

public String[] nationalsToCountry(String[] s)

if s is the name of a set of nationals, returns the associated country name, else null.

capitalToCountry

public String[] capitalToCountry(String[] s)

if s is the name of the capital of a country, returns the associated country name, else null.

isLocation

public boolean isLocation(String[] s)

returns true if s is the name of any type of location (either the primary name or an alias).

isCountry

public boolean isCountry(String[] s)

returns true if s is the name of a country (either the primary name or an alias).

isCountryAlias

public boolean isCountryAlias(String[] s)

returns true if s is an alias of a location name.

isState

public boolean isState(String[] s)

returns true if s is the name of a U.S. state (either the primary name or an alias).

isRegionOrContinent

public boolean isRegionOrContinent(String[] s)

returns true if s is the name of a region or continent (either the primary name or an alias).

canonicalCountryName

public String[] canonicalCountryName(String[] s)

if s is the alias of a location name, returns the primary location name, else null.

main

public static void main(String[] args)
                 throws IOException

Throws:

IOException

splitAtWS

public static String[] splitAtWS(String s)

locationType

public String locationType(Document doc,
                  String locationName)

returns "country", "stateorprovince", or "city" as the type of 'locationName' based on three types of evidence: - entries in the gazetteer itself - a coreferential nominal mention, typically from a construct 'city of X' or 'X province' - the last token of the location name