edu.stanford.nlp.semgraph.semgrex.Alignment Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of stanford-parser Show documentation
Show all versions of stanford-parser Show documentation
Stanford Parser processes raw text in English, Chinese, German, Arabic, and French, and extracts constituency parse trees.
package edu.stanford.nlp.semgraph.semgrex;
import edu.stanford.nlp.ling.CoreLabel;
import edu.stanford.nlp.ling.IndexedWord;
import edu.stanford.nlp.semgraph.SemanticGraph;
import edu.stanford.nlp.util.Generics;
import java.util.*;
/**
* Represents an alignment between a text and a hypothesis as a map from
* hypothesis words to text words, along with a real-valued score and
* (optionally) a justification string.
*
* @author Bill MacCartney
*/
public class Alignment {
private Map map;
protected double score; // kill RecursiveAlignment, make this private!
private String justification;
public Alignment(Map map,
double score,
String justification) {
this.map = map;
this.score = score;
this.justification = justification;
}
/*
* Returns the score for this Alignment.
*/
public double getScore() { return score; }
/*
* Returns the map from hypothesis words to text words for this
* Alignment.
*/
public Map getMap() {
return map;
}
/*
* Returns the justification for this Alignment.
*/
public String getJustification() { return justification; }
@Override
public String toString() {
return toString("readable");
}
public String toString(String format) {
StringBuilder sb = new StringBuilder();
if (format == "readable") {
// sb.append("Alignment map:\n");
List keys = new ArrayList<>(map.keySet());
Collections.sort(keys);
for (IndexedWord key : keys) {
sb.append(String.format("%-20s ==> %s%n",
iwToString(key),
iwToString(map.get(key))));
}
sb.append(String.format("%s %6.3f%n", "Alignment score:", score));
} else if (format == "readable-tag-index") {
List keys = new ArrayList<>(map.keySet());
Collections.sort(keys);
for (IndexedWord key : keys) {
sb.append(String.format("%-20s ==> %s%n",
iwToString(key),
iwToString(map.get(key))));
}
sb.append(String.format("%s %6.3f%n", "Alignment score:", score));
} else if (format == "readable-old") {
// sb.append("Alignment map:\n");
for (Map.Entry entry : map.entrySet()) {
sb.append(String.format("%-20s ==> %s%n",
iwToString(entry.getKey()),
iwToString(entry.getValue())));
}
sb.append("Alignment score: ");
sb.append(String.format("%6.3f", score));
sb.append("\n");
} else { // default
sb.append(map.toString());
}
return sb.toString();
}
private static String iwToString(IndexedWord iw) {
if (iw == null || iw.equals(IndexedWord.NO_WORD))
return "_";
return iw.toString(CoreLabel.OutputFormat.VALUE);
}
/**
* Defined on map only.
*/
@Override
public boolean equals(Object o) {
if (! (o instanceof Alignment)) return false;
Alignment other = (Alignment) o;
return map.equals(other.map);
}
/**
* Defined on map only.
*/
@Override
public int hashCode() {
return map.hashCode();
}
/**
* returns a new alignment with the guarantee that:
*
* (i) every node in hypGraph has a corresponding alignment
* (ii) no alignment exists that doesn't have a node in hypGraph
* (iii) the only alignment that exists that doesn't have a node in
* txtGraph is an alignment to NO_WORD
*
* wcmac: What is this for? Looks like nothing is using this?
*/
Alignment patchedAlignment(SemanticGraph hypGraph, SemanticGraph txtGraph) {
Map patchedMap = Generics.newHashMap();
Set txtVertexSet = txtGraph.vertexSet();
for (Object o : hypGraph.vertexSet()) {
IndexedWord vertex = (IndexedWord)o;
if (map.containsKey(vertex) && txtVertexSet.contains(map.get(vertex))) {
patchedMap.put(vertex, map.get(vertex));
}
else patchedMap.put(vertex, IndexedWord.NO_WORD);
}
return new Alignment(patchedMap, score, justification);
}
/**
* Constructs and returns a new Alignment from the given hypothesis
* SemanticGraph to the given text (passage) SemanticGraph, using
* the given array of indexes. The i'th node of the array should contain the
* index of the node in the text (passage) SemanticGraph to which the i'th
* node in the hypothesis SemanticGraph is aligned, or -1 if it is aligned to
* NO_WORD.
*/
public static Alignment makeFromIndexArray(SemanticGraph txtGraph,
SemanticGraph hypGraph,
int[] indexes,
double score,
String justification) {
if (txtGraph == null || txtGraph.isEmpty())
throw new IllegalArgumentException("Invalid txtGraph " + txtGraph);
if (hypGraph == null || hypGraph.isEmpty())
throw new IllegalArgumentException("Invalid hypGraph " + hypGraph);
if (indexes == null)
throw new IllegalArgumentException("Null index array");
if (indexes.length != hypGraph.size())
throw new IllegalArgumentException("Index array length " + indexes.length +
" does not match hypGraph size " + hypGraph.size());
Map map =
Generics.newHashMap();
for (int i = 0; i < indexes.length; i++) {
IndexedWord hypNode = hypGraph.getNodeByIndex(i);
IndexedWord txtNode = IndexedWord.NO_WORD;
if (indexes[i] >= 0)
txtNode = txtGraph.getNodeByIndex(indexes[i]);
map.put(hypNode, txtNode);
}
return new Alignment(map, score, justification);
}
public static Alignment makeFromIndexArray(SemanticGraph txtGraph,
SemanticGraph hypGraph,
int[] indexes) {
return makeFromIndexArray(txtGraph, hypGraph, indexes, 0.0, null);
}
public static Alignment makeFromIndexArray(SemanticGraph txtGraph,
SemanticGraph hypGraph,
int[] indexes,
double score) {
return makeFromIndexArray(txtGraph, hypGraph, indexes, score, null);
}
}