Version 5.1
How To
    Learn More

      Gazetteer Lookup Extraction Index Stage

      The Gazetteer Lookup Extraction index stage (called the Gazetteer Lookup Extractor stage in versions earlier than 3.0) uses predefined lists of words and phrases to process specified text fields in a document. A gazetteer is a set of lookup lists over names of people, places, or things. These lookup lists are used to find occurrences of these names in text. The matched items are saved into separate fields on the document for downstream processing.

      Gazetteers and OpenNLP Tools

      The following video shows how to configure a Gazetteer Lookup Extraction stage in combination with OpenNLP:

      Uploading Lookup Lists to Fusion Blob Store

      Fusion includes a number of lookup lists in the directory {fusion_path}/data/nlp/gazetteer. To use the supplied lists or a list of your own data, each must list be uploaded to Fusion using the Blob Store API in order to make the list contents available to the Gazetteer Lookup Extraction stage.

      For example, to identify color names, you would first compile a list of color terms, one entry per line in a text file with suffix .lst and then upload that file using the Fusion REST API endpoint api/blobs/<listfilename>, as per the following example which uses the curl command-line utility, where 'admin' is the name of a user with admin privileges, and 'pass' is that user’s password:

      curl -u admin:pass -X PUT --data-binary @data/nlp/gazetteer/colours.lst -H 'Content-type: text/plain' http://localhost:8764/api/blobs/colours.lst

      Name Lookup Example

      Define a lookup-extractor to identify mentions of certain celebrities in text field description_t:

        "type" : "lookup-extractor",
        "id" : "peopleLookup",
        "rules" : [ {
          "source" : [ "description_t" ],
          "target" : "celebrities_ss",
          "entityTypes" : [ {
            "name" : "person_female",
            "definitions" : [ "person_female.lst" ]
          } ],
          "additionalEntities" : [ {
            "name" : "players",
            "definitions" : [ "sharapova", "murray" ]
          }, {
            "name" : "actors",
            "definitions" : [ "pitt", "jolie" ]
          } ],
          "caseSensitive" : false
        } ],
        "skip" : false


      When entering configuration values in the UI, use unescaped characters, such as \t for the tab character. When entering configuration values in the API, use escaped characters, such as \\t for the tab character.

      When using Fusion's REST API, the ID for this stage is:lookup-extractor.

      Loading liquid template...

      Loading configuration schema...