org.apache.stanbol.enhancer.engines.poschunker.engine

Class PosChunkerEngine

java.lang.Object

org.apache.stanbol.enhancer.servicesapi.impl.AbstractEnhancementEngine<RuntimeException,RuntimeException>

org.apache.stanbol.enhancer.engines.poschunker.engine.PosChunkerEngine

All Implemented Interfaces:

org.apache.stanbol.enhancer.servicesapi.EnhancementEngine, org.apache.stanbol.enhancer.servicesapi.ServiceProperties

@Service
@Properties(value={@Property(name="stanbol.enhancer.engine.name",value="pos-chunker"),@Property(name="enhancer.engine.poschunker.languages",cardinality=2147483647,value="*"),@Property(name="enhancer.engine.poschunker.minPosScore",doubleValue=0.5),@Property(name="enhancer.engine.poschunker.nounPhrase",boolValue=true),@Property(name="enhancer.engine.poschunker.verbPhrase",boolValue=false),@Property(name="service.ranking",intValue=-100)})
public class PosChunkerEngine
extends org.apache.stanbol.enhancer.servicesapi.impl.AbstractEnhancementEngine<RuntimeException,RuntimeException>
implements org.apache.stanbol.enhancer.servicesapi.ServiceProperties

A noun phrase detector (chunker) for English and German language base on OpenNLP. Uses the following chunker models for OpenNLP:

• English: http://opennlp.sourceforge.net/models-1.5/en-chunker.bin
• German: http://gromgull.net/blog/2010/01/noun-phrase-chunking-for-the-awful-german-language/

The noun phrase detector requires a org.apache.stanbol.enhancer.engines.opennlp.pos.model.POSContentPart to be present in the content item and will extend each org.apache.stanbol.enhancer.engines.opennlp.pos.model.POSSentence with an array of chunks.

Author:

Sebastian Schaffert

Field Summary

Fields

Modifier and Type	Field and Description
static String	CONFIG_LANGUAGES Language configuration.
static double	DEFAULT_MIN_POS_SCORE
static boolean	DEFAULT_NOUN_PHRASE_STATE
static boolean	DEFAULT_VERB_PHRASE_STATE
static String	MIN_POS_SCORE
static String	NOUN_PHRASE_STATE
static String	VERB_PHRASE_STATE

Fields inherited from interface org.apache.stanbol.enhancer.servicesapi.ServiceProperties

ENHANCEMENT_ENGINE_ORDERING, ORDERING_CONTENT_EXTRACTION, ORDERING_DEFAULT, ORDERING_EXTRACTION_ENHANCEMENT, ORDERING_NLP_CHUNK, ORDERING_NLP_LANGAUGE_DETECTION, ORDERING_NLP_LEMMATIZE, ORDERING_NLP_POS, ORDERING_NLP_SENTENCE_DETECTION, ORDERING_NLP_TOKENIZING, ORDERING_POST_PROCESSING, ORDERING_PRE_PROCESSING

Fields inherited from interface org.apache.stanbol.enhancer.servicesapi.EnhancementEngine

CANNOT_ENHANCE, ENHANCE_ASYNC, ENHANCE_SYNCHRONOUS, PROPERTY_NAME

Constructor Summary

Constructors

Constructor and Description
PosChunkerEngine()

Method Summary

Methods

Modifier and Type	Method and Description
protected void	activate(org.osgi.service.component.ComponentContext ce) Activate and read the properties.
int	canEnhance(org.apache.stanbol.enhancer.servicesapi.ContentItem ci) Indicate if this engine can enhance supplied ContentItem, and if it suggests enhancing it synchronously or asynchronously.
void	computeEnhancements(org.apache.stanbol.enhancer.servicesapi.ContentItem ci) Compute enhancements for supplied ContentItem.
protected void	deactivate(org.osgi.service.component.ComponentContext context)
Map<String,Object>	getServiceProperties()

Methods inherited from class org.apache.stanbol.enhancer.servicesapi.impl.AbstractEnhancementEngine

getName, toString

Methods inherited from class java.lang.Object

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

Field Detail

CONFIG_LANGUAGES

public static final String CONFIG_LANGUAGES

Language configuration. Takes a list of ISO language codes of supported languages. Currently supported are the languages given as default value.

See Also:

Constant Field Values

MIN_POS_SCORE

public static final String MIN_POS_SCORE

See Also:

Constant Field Values

DEFAULT_MIN_POS_SCORE

public static final double DEFAULT_MIN_POS_SCORE

See Also:

Constant Field Values

NOUN_PHRASE_STATE

public static final String NOUN_PHRASE_STATE

See Also:

Constant Field Values

DEFAULT_NOUN_PHRASE_STATE

public static final boolean DEFAULT_NOUN_PHRASE_STATE

See Also:

Constant Field Values

VERB_PHRASE_STATE

public static final String VERB_PHRASE_STATE

See Also:

Constant Field Values

DEFAULT_VERB_PHRASE_STATE

public static final boolean DEFAULT_VERB_PHRASE_STATE

See Also:

Constant Field Values

Constructor Detail

PosChunkerEngine

public PosChunkerEngine()

Method Detail

canEnhance

public int canEnhance(org.apache.stanbol.enhancer.servicesapi.ContentItem ci)
               throws org.apache.stanbol.enhancer.servicesapi.EngineException

Indicate if this engine can enhance supplied ContentItem, and if it suggests enhancing it synchronously or asynchronously. The EnhancementJobManager can force sync/async mode if desired, it is just a suggestion from the engine.

Returns CANNOT_ENHANCE if the content item does not have a POSContentPart, the language of the content is not available or no chunker for the language is available.

Specified by:

canEnhance in interface org.apache.stanbol.enhancer.servicesapi.EnhancementEngine

Throws:

org.apache.stanbol.enhancer.servicesapi.EngineException - if the introspecting process of the content item fails

computeEnhancements

public void computeEnhancements(org.apache.stanbol.enhancer.servicesapi.ContentItem ci)
                         throws org.apache.stanbol.enhancer.servicesapi.EngineException

Compute enhancements for supplied ContentItem. The results of the process are expected to be stored in the metadata of the content item.

The client (usually an EnhancementJobManager) should take care of persistent storage of the enhanced ContentItem.

Specified by:

computeEnhancements in interface org.apache.stanbol.enhancer.servicesapi.EnhancementEngine

Throws:

org.apache.stanbol.enhancer.servicesapi.EngineException - if the underlying process failed to work as expected

getServiceProperties

public Map<String,Object> getServiceProperties()

Specified by:

getServiceProperties in interface org.apache.stanbol.enhancer.servicesapi.ServiceProperties

activate

@Activate
protected void activate(org.osgi.service.component.ComponentContext ce)
                 throws org.osgi.service.cm.ConfigurationException

Activate and read the properties. Configures and initialises a ChunkerHelper for each language configured in CONFIG_LANGUAGES.

Overrides:

activate in class org.apache.stanbol.enhancer.servicesapi.impl.AbstractEnhancementEngine<RuntimeException,RuntimeException>

Parameters:

ce - the ComponentContext

Throws:

org.osgi.service.cm.ConfigurationException

deactivate

@Deactivate
protected void deactivate(org.osgi.service.component.ComponentContext context)

Overrides:

deactivate in class org.apache.stanbol.enhancer.servicesapi.impl.AbstractEnhancementEngine<RuntimeException,RuntimeException>