Revision: 16608
http://sourceforge.net/p/gate/code/16608
Author: johann_p
Date: 2013-03-20 12:43:45 +0000 (Wed, 20 Mar 2013)
Log Message:
-----------
Remove dead links from the LKB documentation and add documentation of
how to load the LKB from gazetteer list files and how to set
the feature separator.
Modified Paths:
--------------
userguide/trunk/gazetteers.tex
Modified: userguide/trunk/gazetteers.tex
===================================================================
--- userguide/trunk/gazetteers.tex 2013-03-20 11:45:00 UTC (rev 16607)
+++ userguide/trunk/gazetteers.tex 2013-03-20 12:43:45 UTC (rev 16608)
@@ -776,18 +776,20 @@
The large KB gazetteer provides support for ontology-aware NLP. You can load
any ontology from RDF and then use the gazetteer to obtain lookup annotations
-that have both instance and class URI.
+that have both instance and class URI. Alternately, the PR can read in
+LST and DEF files in the same format as the Default Gazetteer. For both
+data sources, the Large KB Gazetteer PR allows to use large gazetteer
+lists and speeds up subsequent loading of the data by caching.
The large KB gazetteer is available as the plugin \texttt{Gazetteer\_LKB}.
The current version of the large KB gazetteer does not use GATE ontology
language resources. Instead, it uses its own mechanism to load and
-process ontologies. The current version is likely to change significantly
-in the near future.
+process ontologies.
The Large KB gazetteer grew from a component in the semantic search platform
-\htlink{http://ontotext.com/kim/}{Ontotext KIM}. The gazetteer is developed by
-people from the KIM team
(see~\url{http://nmwiki.ontotext.com/lkb_gazetteer/team-list.html}). You
+\htlink{http://ontotext.com/kim/}{Ontotext KIM}. The gazetteer was developed by
+people from the KIM team. You
may find the name \pitalic{kim} left in several places in the source code,
documentation or source files.
@@ -796,8 +798,9 @@
\begin{itemize}
\item{} To use the Large KB gazetteer, set up your dictionary first. The
dictionary is a folder with some configuration files. Use the samples at
-\pitalic{GATE\_HOME/plugins/Gazetteer\_LKB/samples} as a guide or download a
-prebuilt dictionary from http://ontotext.com/kim/lkb\_gazetteer/dictionaries.
+\pitalic{GATE\_HOME/plugins/Gazetteer\_LKB/samples} as a guide. There are
+samples for loading the gazetteer data from a local repository, a remote
+repository or from a set of list files as configured in a \texttt{.def} file.
\item{} Load \pitalic{GATE\_HOME/plugins/Gazetteer\_LKB} as a CREOLE plugin.
See Section~\ref{sec:developer:plugins} for details.
@@ -811,7 +814,11 @@
\item{} The gazetteer will create annotations with type `Lookup' and two
features; `inst', which contains the URI of the ontology instance, and `class'
-which contains the URI of the ontology class that instance belongs to.
+which contains the URI of the ontology class that instance belongs to. If
+the gazetteer was loaded from gazetteer list files, the `inst' and `class'
+features are set from the `minorType' and `majorType' settings for the list
+file or from the `inst' and `class' features stored for each entry in
+the list file (see below).
\end{itemize}
\subsect{Dictionary setup}
@@ -904,6 +911,49 @@
\end{verbatim}\end{small}
\end{pverbatimbox}
+\subsect{Dictionary for Gazetteer List Files}
+
+In order to load the gazetteer from gazetteer list files,
+place a file with extension \texttt{.def} in the dictionary
+directory. This file should have the same format as for
+the Default Gazetteer, however the fields for language and
+annotation type are ignored. The values for the fields
+`majorType' and `minorType' are converted to URIs by
+prepending `urn:' and the URI from `majorType' is used for
+assigning the `class' feature, the URI from `minorType'
+for assigning the `inst' feature of all annotations created
+from the list. These valus can be overwritted by features
+from the individual entries in a list file, if the
+`gazetteerFeatureSeparator' configuaration option is set
+to a non-blank value in the configuration file. In that
+case, each line in a list file is split by the separator
+and the first part is used as the gazetteer entry. The
+remaining parts are interpreted as feature/value pairs
+of the form \texttt{feature=value}. If a feature `inst'
+is found the value is used as the inst URI for that entry,
+overwriting the URI taken from the `minorType' of the list
+file. If a feature `class' is found, the value is used as
+the class URI for that entry, overwriting the URI taken from
+the `majorType' of the list file.
+
+The \texttt{config.ttl} file for a loading the gazetteer
+from list files should have the following content (the example
+shows a tab character to be used as the feature separator
+for list files):
+
+\begin{pverbatimbox}
+\begin{small}\begin{verbatim}
+@prefix lkbg: <http://www.ontotext.com/lkb_gazetteer#>.
+lkbg:DictionaryConfiguration
+ lkbg:caseSensitivity "caseinsensitive" ;
+ lkbg:caching "enabled" ;
+ lkbg:ignoreList "ignoreList.txt" ;
+ lkbg:gazetteerFeatureSeparator "\t" .
+\end{verbatim}\end{small}
+\end{pverbatimbox}
+
+
+
\subsect{Processing Resource Configuration}
The following options can be set when the gazetteer PR is initialized:
This was sent by the SourceForge.net collaborative development platform, the
world's largest Open Source development site.
------------------------------------------------------------------------------
Everyone hates slow websites. So do we.
Make your web apps faster with AppDynamics
Download AppDynamics Lite for free today:
http://p.sf.net/sfu/appdyn_d2d_mar
_______________________________________________
GATE-cvs mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/gate-cvs
