StanfordNLPConnector (HAWK - Hybrid Question Answering using Linked Data 0.3.1 API)

java.lang.Object
- org.aksw.hawk.controller.StanfordNLPConnector

```
public class StanfordNLPConnector
extends Object
```
This class is a Connector between HAWK and StanfordNLP Usage: Either pass a List of Annotators to Constructor, {Complete Annotator list at http://stanfordnlp.github.io/CoreNLP/annotators.html} or use empty Constructor with default annotators. Then use runAnnotation() and pass returned Annotoation-Object to combineSequences(Annotation,HAWKQuestion) to find and registerNounPhrases in given Question or pass Annotation-Object to process(Annotation) to get dependency-Graph

Author:

Jonathan

Field Summary

Fields
Modifier and Type	Field and Description
`private static org.slf4j.Logger`	`log`
`private int`	`nodeNumber`
`static StringBuilder`	`out`
`private static String`	`STANFORD_IP`
`private static int`	`STANFORD_PORT`
`private edu.stanford.nlp.pipeline.StanfordCoreNLPClient`	`stanfordPipe`
`private static int`	`USED_CORES`
`private Set<edu.stanford.nlp.ling.IndexedWord>`	`visitedNodes`

Constructor Summary

Constructors
Constructor and Description
`StanfordNLPConnector()` Initializes CoreNLP with default Annotators.
`StanfordNLPConnector(String annotators)` Initializes the StanfordNLP with given Annotators.Complete Annotator list at http://stanfordnlp.github.io/CoreNLP/annotators.html}

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`private void`	`convertGraphStanford(MutableTreeNode parentMutableNode, edu.stanford.nlp.ling.IndexedWord parentGraphWord, edu.stanford.nlp.semgraph.SemanticGraph graph)` The recursive Function to convert a Semantic Graph into MutableTree
`Map<String,String>`	`generatePOSTags(edu.stanford.nlp.pipeline.Annotation document)` Generates POS tags with StanfordCoreNLP.
`static String`	`getStanfordIp()`
`static int`	`getStanfordPort()`
`MutableTree`	`parseTree(HAWKQuestion q, UnitController numberToDigit)` Runs Stanford Pipeline on given question.
`String`	`postprocessStringForStanford(edu.stanford.nlp.ling.IndexedWord node)` Deals with the problem of Stanford splitting by "(" and ")" in a previous step, we replace this by "////" This method regexes it back to normal.
`String`	`preprocessStringForStanford(String input)` Stanford splits by sentences with "(" and ")" in them.
`MutableTree`	`process(edu.stanford.nlp.pipeline.Annotation document)` Extracts dependency Graph from processed Annotation.
`edu.stanford.nlp.pipeline.Annotation`	`runAnnotation(HAWKQuestion q)` Runs StanfordNLP on given HawkQuestion`s question in English and returns processed Annotation
`edu.stanford.nlp.pipeline.Annotation`	`runAnnotation(String s)` Runs StanfordNLP on given bare String and returns processed Annotation
`private MutableTree`	`semanticGraphToMutableTree(edu.stanford.nlp.semgraph.SemanticGraph graph, HAWKQuestion q)` Converts a SemanticGraph from StanfordNLP to a Mutable tree recursively with DFS.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - stanfordPipe
```
private edu.stanford.nlp.pipeline.StanfordCoreNLPClient stanfordPipe
```
  - nodeNumber
```
private int nodeNumber
```
  - visitedNodes
```
private Set<edu.stanford.nlp.ling.IndexedWord> visitedNodes
```
  - out
```
public static StringBuilder out
```
  - log
```
private static org.slf4j.Logger log
```
  - STANFORD_IP
```
private static final String STANFORD_IP
```
    See Also:
    
    Constant Field Values
  - STANFORD_PORT
```
private static final int STANFORD_PORT
```
    See Also:
    
    Constant Field Values
  - USED_CORES
```
private static final int USED_CORES
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - StanfordNLPConnector
```
public StanfordNLPConnector(String annotators)
```
    Initializes the StanfordNLP with given Annotators.Complete Annotator list at http://stanfordnlp.github.io/CoreNLP/annotators.html}
    
    Parameters:
    
    annotators - Annotators to run
  - StanfordNLPConnector
```
public StanfordNLPConnector()
```
    Initializes CoreNLP with default Annotators. "tokenize, ssplit, pos, lemma,ner, parse,"
- Method Detail
  - runAnnotation
```
public edu.stanford.nlp.pipeline.Annotation runAnnotation(String s)
```
    Runs StanfordNLP on given bare String and returns processed Annotation
    
    Parameters:
    
    s - The String to be processed.
    
    Returns:
    
    processed Question as Annotation
    
    See Also:
    
    preprocessStringForStanford(String)
  - runAnnotation
```
public edu.stanford.nlp.pipeline.Annotation runAnnotation(HAWKQuestion q)
```
    Runs StanfordNLP on given HawkQuestion`s question in English and returns processed Annotation
    
    Parameters:
    
    q - The HAWKQuestion to be processed.
    
    Returns:
    
    processed Question as Annotation
  - process
```
public MutableTree process(edu.stanford.nlp.pipeline.Annotation document)
```
    Extracts dependency Graph from processed Annotation.
    
    Parameters:
    
    document - an Processed Annotation
    
    Returns:
    
    Dependency Graph as MutableTree
  - parseTree
```
public MutableTree parseTree(HAWKQuestion q,
                             UnitController numberToDigit)
```
    Runs Stanford Pipeline on given question. Extracts dependency graph, POStags,lemma
```
 Note: Extracted MutableTree will be set in HAWKQuestion>
 
```
    Note:
    Parameters:
    
    q - Question to process.
    
    Returns:
    
    Extracted MutableTree.
  - generatePOSTags
```
public Map<String,String> generatePOSTags(edu.stanford.nlp.pipeline.Annotation document)
```
    Generates POS tags with StanfordCoreNLP. This has an equivalent in SentenceToSequence Maybe Keep this for testing?
  - semanticGraphToMutableTree
```
private MutableTree semanticGraphToMutableTree(edu.stanford.nlp.semgraph.SemanticGraph graph,
                                               HAWKQuestion q)
```
    Converts a SemanticGraph from StanfordNLP to a Mutable tree recursively with DFS.
  - preprocessStringForStanford
```
public String preprocessStringForStanford(String input)
```
    Stanford splits by sentences with "(" and ")" in them. But they occur on a regular basis through replacing names with url, because different meanings of a named entity are specified in brackets:
```
 http://dbpedia.org/page/Pound_(mass)
 http://dbpedia.org/page/Pound_(band)
 
```
    So we replace round brackets with "////"
    See Also:
    
    postprocessStringForStanford(IndexedWord)
  - postprocessStringForStanford
```
public String postprocessStringForStanford(edu.stanford.nlp.ling.IndexedWord node)
```
    Deals with the problem of Stanford splitting by "(" and ")" in a previous step, we replace this by "////" This method regexes it back to normal.
    
    See Also:
    
    preprocessStringForStanford(String)
  - convertGraphStanford
```
private void convertGraphStanford(MutableTreeNode parentMutableNode,
                                  edu.stanford.nlp.ling.IndexedWord parentGraphWord,
                                  edu.stanford.nlp.semgraph.SemanticGraph graph)
```
    The recursive Function to convert a Semantic Graph into MutableTree
  - getStanfordIp
```
public static String getStanfordIp()
```
  - getStanfordPort
```
public static int getStanfordPort()
```

Class StanfordNLPConnector

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

stanfordPipe

nodeNumber

visitedNodes

out

log

STANFORD_IP

STANFORD_PORT

USED_CORES

Constructor Detail

StanfordNLPConnector

StanfordNLPConnector

Method Detail

runAnnotation

runAnnotation

process

parseTree

generatePOSTags

semanticGraphToMutableTree

preprocessStringForStanford

postprocessStringForStanford

convertGraphStanford

getStanfordIp

getStanfordPort