edu.emory.mathcs.nlp.component.dep.DEPState Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of nlp4j-api Show documentation
The newest version!
/**
 * Copyright 2015, Emory University
 * 
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 * 
 *     http://www.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package edu.emory.mathcs.nlp.component.dep;

import edu.emory.mathcs.nlp.common.constant.StringConst;
import edu.emory.mathcs.nlp.component.template.eval.Eval;
import edu.emory.mathcs.nlp.component.template.feature.FeatureItem;
import edu.emory.mathcs.nlp.component.template.node.AbstractNLPNode;
import edu.emory.mathcs.nlp.component.template.state.NLPState;
import edu.emory.mathcs.nlp.learning.util.LabelMap;
import it.unimi.dsi.fastutil.ints.IntArrayList;

import java.util.Arrays;
import java.util.List;
import java.util.stream.Collectors;

/**
 * @author Jinho D. Choi ({@code [email protected]})
 */
public class DEPState> extends NLPState
{
	public static final String ARC_LEFT    = "L";
	public static final String ARC_RIGHT   = "R";
	public static final String ARC_NO      = "N";
	public static final String LIST_SHIFT  = "S";
	public static final String LIST_REDUCE = "R";
	public static final String LIST_PASS   = "P";
	
	private List> oracle;
	private IntArrayList    stack;
	private IntArrayList    inter;
	private int             input;
	
	public DEPState(N[] nodes)
	{
		super(nodes);
		stack = new IntArrayList();
		inter = new IntArrayList();
		input = 0;
		shift();
	}
	
//	====================================== ORACLE ======================================

	@Override
	public boolean saveOracle()
	{
		oracle = Arrays.stream(nodes).map(n -> n.clearDependencies()).collect(Collectors.toList());
		return oracle.stream().filter(n -> n.getNode() != null).findFirst().isPresent();
	}
	
	@Override
	public void resetOracle()
	{
		for (int i=1; i o = oracle.get(i);
			nodes[i].setDependencyHead(o.getNode(), o.getLabel());
		}
	}
	
	@Override
	public String getOracle()
	{
		DEPLabel label = getOracleLabel();
		return label.toString();
	}
	
	public DEPLabel getOracleLabel()
	{
		N stack = getStack();
		N input = getInput();
		DEPArc gold;
		String list;
		
		// left arc
		gold = oracle.get(stack.getID());
		
		if (gold.isNode(input) && !input.isDescendantOf(stack))
		{
			list = isOracleReduce(true) ? LIST_REDUCE : LIST_PASS;
			return new DEPLabel(ARC_LEFT, list, gold.getLabel());
		}
				
		// right arc
		gold = oracle.get(input.getID());
		
		if (gold.isNode(stack) && !stack.isDescendantOf(input))
		{
			list = isOracleShift() ? LIST_SHIFT : LIST_PASS;
			return new DEPLabel(ARC_RIGHT, list, gold.getLabel());
		}
		
		// no arc
		if      (isOracleShift())		list = LIST_SHIFT;
		else if (isOracleReduce(false))	list = LIST_REDUCE;
		else							list = LIST_PASS;
		
		return new DEPLabel(ARC_NO, list, StringConst.EMPTY);
	}
	
	/** Called by {@link #getOracleLabel()}. */
	private boolean isOracleShift()
	{
		// if head(input) < stack
		N stack = getStack();
		
		if (oracle.get(input).getNode().getID() < stack.getID())
			return false;
		
		// if child(input) < stack
		N input = getInput();
		int i = 0;

		while ((stack = peekStack(--i)) != null)
		{
			if (oracle.get(stack.getID()).isNode(input))
				return false;
		}
		
		return true;
	}
	
	/** Called by {@link #getOracleLabel()}. */
	private boolean isOracleReduce(boolean hasHead)
	{
		// if stack has no head
		N stack = getStack();
		
		if (!hasHead && !stack.hasDependencyHead())
			return false;
		
		// if child(stack) > input 
		for (int i=input+1; i= nodes.length;
	}
	
	private void shift()
	{
		while (!inter.isEmpty()) stack.push(inter.popInt());
		stack.push(input++);
	}
	
	private void reduce()
	{
		stack.popInt();
	}
	
	private void pass()
	{
		inter.push(stack.popInt());
	}
	
//	====================================== NODE ======================================

	/**
	 * @return the window'th top of the stack if exists; otherwise, -1.
	 * @param window 0: top, 1: 2nd-top, so one.
	 */
	public N peekStack(int window)
	{
		if (window <= 0)
		{
			window *= -1;
			if (window < stack.size()) return nodes[stack.peekInt(window)];
		}
		else if (window <= inter.size())
			return nodes[inter.peekInt(window-1)];

		return null;
	}
	
	public N getStack(int window)
	{
		return getNode(stack.topInt(), window, true);
	}
	
	public N getInput(int window)
	{
		return getNode(input, window, true);
	}
	
	public N getStack()
	{
		return getStack(0);
	}
	
	public N getInput()
	{
		return getInput(0);
	}
	
	@Override
	public N getNode(FeatureItem item)
	{
		N node = null;
		
		switch (item.source)
		{
		case i: node = getStack (item.window); break;
		case j: node = getInput (item.window); break;
		case k: node = peekStack(item.window); break;
		}
		
		return getRelativeNode(item, node);
	}
	
//	====================================== EVALUATE ======================================

	@Override
	public void evaluate(Eval eval)
	{
		int las = 0, uas = 0;
		DEPArc gold;
		N node;
		
		for (int i=1; i