org.apache.ctakes.temporal.ae

Class EventEventRelationSeedBasedAnnotator

java.lang.Object

org.apache.uima.analysis_component.AnalysisComponent_ImplBase

org.apache.uima.analysis_component.Annotator_ImplBase

org.apache.uima.analysis_component.JCasAnnotator_ImplBase

org.apache.uima.fit.component.JCasAnnotator_ImplBase

org.cleartk.ml.CleartkAnnotator<String>

org.apache.ctakes.relationextractor.ae.RelationExtractorAnnotator

org.apache.ctakes.temporal.ae.EventEventRelationSeedBasedAnnotator

All Implemented Interfaces:

org.apache.uima.analysis_component.AnalysisComponent, org.apache.uima.fit.factory.initializable.Initializable

@PipeBitInfo(name="E-E Seed TLinker",
             description="Creates Event - Event TLinks from Seeds.",
             dependencies={SECTION,SENTENCE,EVENT},
             products=TEMPORAL_RELATION)
public class EventEventRelationSeedBasedAnnotator
extends RelationExtractorAnnotator

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.ctakes.relationextractor.ae.RelationExtractorAnnotator

RelationExtractorAnnotator.IdentifiedAnnotationPair

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	eventExpansion

Fields inherited from class org.apache.ctakes.relationextractor.ae.RelationExtractorAnnotator

category_frequency, coin, NO_RELATION_CATEGORY, PARAM_PROBABILITY_OF_KEEPING_A_NEGATIVE_EXAMPLE, probabilityOfKeepingANegativeExample

Fields inherited from class org.cleartk.ml.CleartkAnnotator

classifier, dataWriter, PARAM_CLASSIFIER_FACTORY_CLASS_NAME, PARAM_DATA_WRITER_FACTORY_CLASS_NAME, PARAM_IS_TRAINING

Constructor Summary

Constructors

Constructor and Description
EventEventRelationSeedBasedAnnotator()

Method Summary

Modifier and Type	Method and Description
static org.apache.uima.analysis_engine.AnalysisEngineDescription	createAnnotatorDescription(File modelDirectory) Deprecated. use String path instead of File. ClearTK will automatically Resolve the String to an InputStream. This will allow resources to be read within from a jar as well as File.
static org.apache.uima.analysis_engine.AnalysisEngineDescription	createAnnotatorDescription(String modelPath)
static org.apache.uima.analysis_engine.AnalysisEngineDescription	createDataWriterDescription(Class<? extends org.cleartk.ml.DataWriter<String>> dataWriterClass, File outputDirectory, double probabilityOfKeepingANegativeExample, boolean expandEvent)
protected void	createRelation(org.apache.uima.jcas.JCas jCas, IdentifiedAnnotation arg1, IdentifiedAnnotation arg2, String predictedCategory) Create a UIMA relation type based on arguments and the relation label.
protected List<RelationExtractorAnnotator.IdentifiedAnnotationPair>	getCandidateRelationArgumentPairs(org.apache.uima.jcas.JCas jCas, org.apache.uima.jcas.tcas.Annotation sentence) Selects the relevant mentions/annotations within a covering annotation for relation identification/extraction.
protected Class<? extends org.apache.uima.jcas.tcas.Annotation>	getCoveringClass()
protected List<RelationFeaturesExtractor<IdentifiedAnnotation,IdentifiedAnnotation>>	getFeatureExtractors() Defines the list of feature extractors used by the classifier.
protected String	getRelationCategory(Map<List<org.apache.uima.jcas.tcas.Annotation>,BinaryTextRelation> relationLookup, IdentifiedAnnotation arg1, IdentifiedAnnotation arg2) Looks up the arguments in the specified lookup table and converts the relation into a label for classification

Methods inherited from class org.apache.ctakes.relationextractor.ae.RelationExtractorAnnotator

classify, clearCategoryFrequency, getRelationClass, initialize, process

Methods inherited from class org.cleartk.ml.CleartkAnnotator

collectionProcessComplete, isTraining

Methods inherited from class org.apache.uima.fit.component.JCasAnnotator_ImplBase

getLogger

Methods inherited from class org.apache.uima.analysis_component.JCasAnnotator_ImplBase

getRequiredCasInterface, process

Methods inherited from class org.apache.uima.analysis_component.Annotator_ImplBase

getCasInstancesRequired, hasNext, next

Methods inherited from class org.apache.uima.analysis_component.AnalysisComponent_ImplBase

batchProcessComplete, destroy, getContext, getResultSpecification, reconfigure, setResultSpecification

Methods inherited from class java.lang.Object

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

Field Detail

eventExpansion

public static boolean eventExpansion

Constructor Detail

EventEventRelationSeedBasedAnnotator

public EventEventRelationSeedBasedAnnotator()

Method Detail

createDataWriterDescription

public static org.apache.uima.analysis_engine.AnalysisEngineDescription createDataWriterDescription(Class<? extends org.cleartk.ml.DataWriter<String>> dataWriterClass,
                                                                                                    File outputDirectory,
                                                                                                    double probabilityOfKeepingANegativeExample,
                                                                                                    boolean expandEvent)
                                                                                             throws org.apache.uima.resource.ResourceInitializationException

Throws:

org.apache.uima.resource.ResourceInitializationException

createAnnotatorDescription

public static org.apache.uima.analysis_engine.AnalysisEngineDescription createAnnotatorDescription(String modelPath)
                                                                                            throws org.apache.uima.resource.ResourceInitializationException

Throws:

org.apache.uima.resource.ResourceInitializationException

createAnnotatorDescription

public static org.apache.uima.analysis_engine.AnalysisEngineDescription createAnnotatorDescription(File modelDirectory)
                                                                                            throws org.apache.uima.resource.ResourceInitializationException

Deprecated. use String path instead of File. ClearTK will automatically Resolve the String to an InputStream. This will allow resources to be read within from a jar as well as File.

Throws:

org.apache.uima.resource.ResourceInitializationException

getFeatureExtractors

protected List<RelationFeaturesExtractor<IdentifiedAnnotation,IdentifiedAnnotation>> getFeatureExtractors()

Description copied from class: RelationExtractorAnnotator

Defines the list of feature extractors used by the classifier. Subclasses may override this method to provide a different set of feature extractors.

Overrides:

getFeatureExtractors in class RelationExtractorAnnotator

Returns:

The list of feature extractors to use.

getCoveringClass

protected Class<? extends org.apache.uima.jcas.tcas.Annotation> getCoveringClass()

Specified by:

getCoveringClass in class RelationExtractorAnnotator

getCandidateRelationArgumentPairs

protected List<RelationExtractorAnnotator.IdentifiedAnnotationPair> getCandidateRelationArgumentPairs(org.apache.uima.jcas.JCas jCas,
                                                                                                      org.apache.uima.jcas.tcas.Annotation sentence)

Description copied from class: RelationExtractorAnnotator

Selects the relevant mentions/annotations within a covering annotation for relation identification/extraction.

Specified by:

getCandidateRelationArgumentPairs in class RelationExtractorAnnotator

createRelation

protected void createRelation(org.apache.uima.jcas.JCas jCas,
                              IdentifiedAnnotation arg1,
                              IdentifiedAnnotation arg2,
                              String predictedCategory)

Description copied from class: RelationExtractorAnnotator

Create a UIMA relation type based on arguments and the relation label. This allows subclasses to create/define their own types: e.g. coreference can create CoreferenceRelation instead of BinaryTextRelation

Overrides:

createRelation in class RelationExtractorAnnotator

Parameters:

jCas - - JCas object, needed to create new UIMA types

arg1 - - First argument to relation

arg2 - - Second argument to relation

predictedCategory - - Name of relation

getRelationCategory

protected String getRelationCategory(Map<List<org.apache.uima.jcas.tcas.Annotation>,BinaryTextRelation> relationLookup,
                                     IdentifiedAnnotation arg1,
                                     IdentifiedAnnotation arg2)

Description copied from class: RelationExtractorAnnotator

Looks up the arguments in the specified lookup table and converts the relation into a label for classification

Overrides:

getRelationCategory in class RelationExtractorAnnotator

Returns:

If this category should not be processed for training return null otherwise it returns the label sent to the datawriter