/*
* 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.formats;
import java.io.IOException;
import java.io.InputStream;
import java.io.UnsupportedEncodingException;
import java.util.ArrayList;
import java.util.List;
import opennlp.tools.namefind.NameSample;
import opennlp.tools.util.InvalidFormatException;
import opennlp.tools.util.ObjectStream;
import opennlp.tools.util.PlainTextByLineStream;
import opennlp.tools.util.Span;
import opennlp.tools.util.StringUtil;
/**
* Parser for the dutch and spanish ner training files of the CONLL 2002 shared task.
* <p>
* The dutch data has a -DOCSTART- tag to mark article boundaries,
* adaptive data in the feature generators will be cleared before every article.<br>
* The spanish data does not contain article boundaries,
* adaptive data will be cleared for every sentence.
* <p>
* The data contains four named entity types: Person, Organization, Location and Misc.<br>
* <p>
* Data can be found on this web site:<br>
* http://www.cnts.ua.ac.be/conll2002/ner/
* <p>
* <b>Note:</b> Do not use this class, internal use only!
*/
public class Conll02NameSampleStream implements ObjectStream<NameSample>{
public enum LANGUAGE {
NL,
ES
}
public static final int GENERATE_PERSON_ENTITIES = 0x01;
public static final int GENERATE_ORGANIZATION_ENTITIES = 0x01 << 1;
public static final int GENERATE_LOCATION_ENTITIES = 0x01 << 2;
public static final int GENERATE_MISC_ENTITIES = 0x01 << 3;
public static final String DOCSTART = "-DOCSTART-";
private final LANGUAGE lang;
private final ObjectStream<String> lineStream;
private final int types;
public Conll02NameSampleStream(LANGUAGE lang, ObjectStream<String> lineStream, int types) {
this.lang = lang;
this.lineStream = lineStream;
this.types = types;
}
/**
* @param lang
* @param in an Input Stream to read data.
* @throws IOException
*/
public Conll02NameSampleStream(LANGUAGE lang, InputStream in, int types) {
this.lang = lang;
try {
this.lineStream = new PlainTextByLineStream(in, "UTF-8");
} catch (UnsupportedEncodingException e) {
// UTF-8 is available on all JVMs, will never happen
throw new IllegalStateException(e);
}
this.types = types;
}
static final Span extract(int begin, int end, String beginTag) throws InvalidFormatException {
String type = beginTag.substring(2);
if ("PER".equals(type)) {
type = "person";
}
else if ("LOC".equals(type)) {
type = "location";
}
else if ("MISC".equals(type)) {
type = "misc";
}
else if ("ORG".equals(type)) {
type = "organization";
}
else {
throw new InvalidFormatException("Unkonw type: " + type);
}
return new Span(begin, end, type);
}
public NameSample read() throws IOException {
List<String> sentence = new ArrayList<String>();
List<String> tags = new ArrayList<String>();
boolean isClearAdaptiveData = false;
// Empty line indicates end of sentence
String line;
while ((line = lineStream.read()) != null && !StringUtil.isEmpty(line)) {
if (LANGUAGE.NL.equals(lang) && line.startsWith(DOCSTART)) {
isClearAdaptiveData = true;
continue;
}
String fields[] = line.split(" ");
if (fields.length == 3) {
sentence.add(fields[0]);
tags.add(fields[2]);
}
else {
throw new IOException("Expected three fields per line in training data!");
}
}
// Always clear adaptive data for spanish
if (LANGUAGE.ES.equals(lang))
isClearAdaptiveData = true;
if (sentence.size() > 0) {
// convert name tags into spans
List<Span> names = new ArrayList<Span>();
int beginIndex = -1;
int endIndex = -1;
for (int i = 0; i < tags.size(); i++) {
String tag = tags.get(i);
if (tag.endsWith("PER") && (types & GENERATE_PERSON_ENTITIES) == 0)
tag = "O";
if (tag.endsWith("ORG") && (types & GENERATE_ORGANIZATION_ENTITIES) == 0)
tag = "O";
if (tag.endsWith("LOC") && (types & GENERATE_LOCATION_ENTITIES) == 0)
tag = "O";
if (tag.endsWith("MISC") && (types & GENERATE_MISC_ENTITIES) == 0)
tag = "O";
if (tag.startsWith("B-")) {
if (beginIndex != -1) {
names.add(extract(beginIndex, endIndex, tags.get(beginIndex)));
beginIndex = -1;
endIndex = -1;
}
beginIndex = i;
endIndex = i +1;
}
else if (tag.startsWith("I-")) {
endIndex++;
}
else if (tag.equals("O")) {
if (beginIndex != -1) {
names.add(extract(beginIndex, endIndex, tags.get(beginIndex)));
beginIndex = -1;
endIndex = -1;
}
}
else {
throw new IOException("Invalid tag: " + tag);
}
}
// if one span remains, create it here
if (beginIndex != -1)
names.add(extract(beginIndex, endIndex, tags.get(beginIndex)));
return new NameSample(sentence.toArray(new String[sentence.size()]), names.toArray(new Span[names.size()]), isClearAdaptiveData);
}
else if (line != null) {
// Just filter out empty events, if two lines in a row are empty
return read();
}
else {
// source stream is not returning anymore lines
return null;
}
}
public void reset() throws IOException, UnsupportedOperationException {
lineStream.reset();
}
public void close() throws IOException {
lineStream.close();
}
}