opennlp.tools.parser.treeinsert.CheckContextGenerator Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of opennlp-tools Show documentation
The newest version!
/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You 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 opennlp.tools.parser.treeinsert;

import java.util.ArrayList;
import java.util.Collection;
import java.util.Collections;
import java.util.List;
import java.util.Set;

import opennlp.tools.parser.AbstractContextGenerator;
import opennlp.tools.parser.Parse;

/**
 * Generates predictive context for deciding when a constituent is complete.
 *
 * @see AbstractContextGenerator
 */
public class CheckContextGenerator extends AbstractContextGenerator {

  private final Parse[] leftNodes;

  /**
   * Instantiates a {@link CheckContextGenerator} for making decisions using a {@code punctSet}.
   *
   * @param punctSet A set of punctuation symbols to be used during context generation.
   */
  public CheckContextGenerator(Set punctSet) {
    this.punctSet = punctSet;
    leftNodes = new Parse[2];
  }

  public String[] getContext(Object o) {
    Object[] params = (Object[]) o;
    return getContext((Parse) params[0], (Parse[]) params[1], (Integer) params[2], (Boolean) params[3]);
  }


  /**
   * Finds the predictive context used to determine how constituent at the specified {@code index}
   * should be combined with a {@code parent} constituent.
   *
   * @param parent The {@link Parse parent} element.
   * @param constituents The {@link Parse constituents} which have yet to be combined into new constituents.
   * @param index The index of the constituent which is being considered.
   * @param trimFrontier Whether the frontier should be trimmed, or not.
   *
   * @return The context for deciding whether a new constituent should be created.
   */
  public String[] getContext(Parse parent, Parse[] constituents, int index, boolean trimFrontier) {
    List features = new ArrayList<>(100);
    //default
    features.add("default");
    Parse[] children = Parser.collapsePunctuation(parent.getChildren(),punctSet);
    Parse pstart = children[0];
    Parse pend = children[children.length - 1];
    String type = parent.getType();
    checkcons(pstart, "begin", type, features);
    checkcons(pend, "last", type, features);
    String production = "p=" + production(parent,false);
    String punctProduction = "pp=" + production(parent,true);
    features.add(production);
    features.add(punctProduction);


    Parse p1 = null;
    Parse p2 = null;
    Collection p1s = constituents[index].getNextPunctuationSet();
    Collection p2s = null;
    Collection p_1s = constituents[index].getPreviousPunctuationSet();
    Collection p_2s = null;
    List rf;
    if (index == 0) {
      rf = Collections.emptyList();
    }
    else {
      rf = Parser.getRightFrontier(constituents[0], punctSet);
      if (trimFrontier) {
        int pi = rf.indexOf(parent);
        if (pi == -1) {
          throw new RuntimeException("Parent not found in right frontier:" + parent + " rf=" + rf);
        }
        else {
          for (int ri = 0; ri <= pi; ri++) {
            rf.remove(0);
          }
        }
      }
    }

    getFrontierNodes(rf,leftNodes);
    Parse p_1 = leftNodes[0];
    Parse p_2 = leftNodes[1];
    int ps = constituents.length;
    if (p_1 != null) {
      p_2s = p_1.getPreviousPunctuationSet();
    }
    if (index + 1 < ps) {
      p1 = constituents[index + 1];
      p2s = p1.getNextPunctuationSet();
    }
    if (index + 2 < ps) {
      p2 = constituents[index + 2];
    }
    surround(p_1, -1, type, p_1s, features);
    surround(p_2, -2, type, p_2s, features);
    surround(p1, 1, type, p1s, features);
    surround(p2, 2, type, p2s, features);

    return features.toArray(new String[0]);
  }

}