prajna.entity.alchemy

Class AlchemyExtractor

java.lang.Object

prajna.entity.EntityExtractor

prajna.entity.alchemy.AlchemyExtractor

All Implemented Interfaces:

RecordReasoner

public class AlchemyExtractor
extends EntityExtractor

Entity extractor which uses the Alchemy public service at http://www.alchemyapi.com. This extractor requires an API key, which is specified with the setModel method. An API key may be obtained from the Alchemy web site.

Author:

Edward Swing

Constructor Summary

Constructors

Constructor and Description
AlchemyExtractor() Create a new, uninitialized Alchemy Entity Extractor.
AlchemyExtractor(java.lang.String alchemyKey) Create a AlchemyExtractor, using the API key specified

Method Summary

Methods

Modifier and Type	Method and Description
protected void	extractEntities(java.lang.String text, java.util.Map<java.lang.String,EntityTag> tokenMap) Extract the entities from the text provided.
java.util.HashMap<java.lang.String,java.lang.String>	extractEntityRawTypes(java.lang.String text) Retrieve the entities and the raw types for this entity extractor.
java.lang.String	getModel() Get the model string.
void	setModel(java.lang.String model) Set the model for this entity extractor.

Methods inherited from class prajna.entity.EntityExtractor

addTagFieldMapping, addTextField, augmentRecord, extract, extract, extract, extract, getDefaultTagField, isDebug, setDebug, setDefaultTagField

Methods inherited from class java.lang.Object

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

Constructor Detail

AlchemyExtractor

public AlchemyExtractor()

Create a new, uninitialized Alchemy Entity Extractor. When using this constructor, setModel() must be called prior to extracting entities

AlchemyExtractor

public AlchemyExtractor(java.lang.String alchemyKey)

Create a AlchemyExtractor, using the API key specified

Parameters:

alchemyKey - the API key

Method Detail

extractEntities

protected void extractEntities(java.lang.String text,
                   java.util.Map<java.lang.String,EntityTag> tokenMap)

Extract the entities from the text provided. This method queries the Alchemy server to run entity extraction on the text, and then determine what the matching entity types are for each raw type discovered. This method calls extractEntityRawTypes(), then uses an internal map to map the raw entity types to EntityType objects.

Specified by:

extractEntities in class EntityExtractor

Parameters:

text - the text to extract

tokenMap - the map to contain the tokens in.

extractEntityRawTypes

public java.util.HashMap<java.lang.String,java.lang.String> extractEntityRawTypes(java.lang.String text)

Retrieve the entities and the raw types for this entity extractor. This method runs the extraction process on the text, and generates a map that identifies each entity with a type. The types returned from this method are not normalized, and dependent on the entity extractor implementation.

Specified by:

extractEntityRawTypes in class EntityExtractor

Parameters:

text - the text to parse for entities

Returns:

the raw entity types

getModel

public java.lang.String getModel()

Get the model string. This returns the API key for the AlchemyExtractor

Overrides:

getModel in class EntityExtractor

Returns:

the API key

setModel

public void setModel(java.lang.String model)

Set the model for this entity extractor. The AlchemyExtractor uses an API key, which should be provided as the model argument.

Overrides:

setModel in class EntityExtractor

Parameters:

model - the API key