eu.clarin.weblicht.wlfxb.tc.api
Interface ReferencesLayer

All Superinterfaces:

TextCorpusLayer

All Known Implementing Classes:

ReferencesLayerStored

public interface ReferencesLayer
extends TextCorpusLayer

The ReferencesLayer layer represents annotations on tokens, or sequences of tokens, that refer to the same entities. The layer consists of a list of entity elements. Each entity element consists of all the mentions (reference elements) that refer to this entity. Each reference element enumerates token identifiers, pointing to a sequence of tokens that represents this reference. Optionally, the minimum sequence of tokens of the reference can be specified (e.g. when reference is a long noun phrase, minimum representation is the head of the phrase). Linguistic type of the reference (pronoun/nominal/name/demonstrative/zero pronoun, other/finer distinctions are possible) type can be specified. Relation to another reference (to target reference) can be specified as well (anaphoric, cataphoric, coreferential, etc.). Additionally, an external identifier of the entity can be provided (url of a Wikipedia article for the entity, id of the entity in a database, etc.) References layer has optional attributes to specify type tagset for the case when linguistic types of references are specified, relation tagset for the case relations between references are specified, name of external reference source in case external references of entities are provided.

Author:

Yana Panchenko

Method Summary

ReferencedEntity	addReferent(List<Reference> references)
ReferencedEntity	addReferent(List<Reference> references, String externalId)
void	addRelation(Reference reference, String relation, Reference... target)
Reference	createReference(List<Token> referenceTokens)
Reference	createReference(List<Token> referenceTokens, List<Token> minReferenceTokens)
Reference	createReference(String type, List<Token> referenceTokens, List<Token> minReferenceTokens)
String	getExternalReferenceSource()
Token[]	getMinimumTokens(Reference reference)
List<ReferencedEntity>	getReferencedEntities(Token token)
ReferencedEntity	getReferencedEntity(int index)
String	getReltagset()
Reference[]	getTarget(Reference reference)
Token[]	getTokens(Reference reference)
String	getTypetagset()
boolean	hasExternalReferences()

Methods inherited from interface eu.clarin.weblicht.wlfxb.tc.api.TextCorpusLayer

isEmpty, size

Method Detail

getTypetagset

String getTypetagset()

getReltagset

String getReltagset()

hasExternalReferences

boolean hasExternalReferences()

getExternalReferenceSource

String getExternalReferenceSource()

getReferencedEntity

ReferencedEntity getReferencedEntity(int index)

getReferencedEntities

List<ReferencedEntity> getReferencedEntities(Token token)

getTokens

Token[] getTokens(Reference reference)

getMinimumTokens

Token[] getMinimumTokens(Reference reference)

getTarget

Reference[] getTarget(Reference reference)

addReferent

ReferencedEntity addReferent(List<Reference> references)

addReferent

ReferencedEntity addReferent(List<Reference> references,
                             String externalId)

createReference

Reference createReference(List<Token> referenceTokens)

createReference

Reference createReference(List<Token> referenceTokens,
                          List<Token> minReferenceTokens)

createReference

Reference createReference(String type,
                          List<Token> referenceTokens,
                          List<Token> minReferenceTokens)

addRelation

void addRelation(Reference reference,
                 String relation,
                 Reference... target)