Skip to content

Dataset for exploring the uses of named entity recognition in information retrieval

Notifications You must be signed in to change notification settings

hltcoe/ner-for-ir-collection

Repository files navigation

ner-for-ir-collection

Collection for exploring the uses of named entity recognition in information retrieval

Introduction

Studying the effects of semantic analysis on retrieval effectiveness can be difficult using standard test collections because both queries and documents typically lack semantic markup. This collection is designed to support study of the utility of named entity annotation. It is derived from two underlying collections: CLEF 2003/2004 Russian and TDT-3 Chinese. We defined a new set of topic aspects for topics in those test collections that are expected to benefit from named entity markup, with two queries for each aspect. One of these queries uses named entities as a bag-of-words query term or as a semantic constraint on a free-text query term; the other is a bag-of-words baseline query without named entity markup. We performed exhaustive judgment of the documents annotated by CLEF or TDT as relevant to each corresponding topic, resulting in relevance judgments for 133 Russian and 33 Chinese topic aspects that each have at least one relevant document. To facilitate calibration to baseline scores, we also automatically generated named entity tags for the documents in both collections.

Contents

The collection includes the following components:

  • README.md: This file
  • full_collections: The full qrels and queries obtained during annotation
  • expt_collections: The qrels and queries for topic aspects for which there is at least one relevant document (this is the set used in our experiments)
  • collection-reconstructor.py: A python script to reconstruct the named entity annotations from source documents
  • chinese.tar.bz2: A tarred, compressed directory of encoded Chinese named entity files
  • russian.tar.bz2: A tarred, compressed directory of encoded Russian named entity files

In both full_collections and expt_collections, the qrels files are in standard TREC format. The queries files are csv files with the following columns:

  • subtopic_num: The ID used for the topic aspect to match with the qrels
  • subtopic_name: The English description of the topic aspect, usually in the form of a question
  • reg_query: The bag of words, non-NER query in collection language
  • ner_query: The query which does contain at least one named entity tag
  • reg_translation: The English translation of the reg_query
  • ner_translation: The English translation of the ner_query

An NER query term can be expressed in one of or a combination of the following three formats:

  • alone: if the term appears alone such as "GPE summit", the term signifies the tag should appear somewhere in the document (a GPE in a document about a summit)
  • | : if the term appears with a "|" character such as "GPE|Washington", the term signifies the tag serves as a constraint on the following term/entity (the term Washington but only used as a GPE, not as a person)
  • / : if the term appears wtih a "/" character such as "GPE/participant summit", the term signifies the tag serves as a classification of the following term (any GPE that was a participant in a summit)

Another way to think about "|" compared to "/" is that terms with "|" would most definitely like the following term to appear in the document. For GPE|Washington, the entity "Washington" should surely be in the document. For terms with "/", the following term may not need to be an exact match in the document. For GPE/participant summit, you are looking for any GPE that has participated in a summit, you may not be as concerned with the specific term "participant".

Recreating Named Entity Files

Because we are not allowed to distribute the documents themselves, the named entity files must be decrypted using the version of the document collection you have gained legally through other means.

Russian (CLEF)

The Russian collection is available from the ELRA (http://www.clef-initiative.eu/dataset/corpus) as collection ELRA-E0008 or ELRA-E0036. To recreate the Russian named entity files, do the following:

  • Extract the encoded files using tar xfj russian.bz2. This will create a directory called russian that contains the encrypted files.
  • Locate your version of the ELRA source collection. Suppose this is in a directory called CLEF.
  • Identify where you want the unencrypted NER files to go; suppose this is a directory called russian-ner.
  • Run the decoding software using Python 3:
python collection-reconstructor.py russian CLEF russian russian-ner

The resulting files in the russian_ner directory are in tab-separated format, with one token per line, and blank lines between sentences. The first column contains the token; the second column contains the named entity tag; and the third column contains the system's confidence value for this tag assignment.

Chinese (TDT)

The Chinese collection is available from the Linguistic Data Consortium (https://www.ldc.upenn.edu/) as collection LDC2001T58. To recreate the Chinese named entity files, do the following:

  • Extract the encoded files using tar xfj chinese.bz2. This will create a directory called chinese that contains the encrypted files.
  • Locate your version of the LDC source collection. Suppose this is in a directory called LDC2001T58.
  • Identify where you want the unencrypted NER files to go; suppose this is a directory called chinese-ner.
  • Run the decoding software, using Python 3:
python collection-reconstructor.py chinese LDC2001T58 chinese chinese-ner

The resulting files in the chinese_ner directory are in tab-separated format, with one token per line, and blank lines between sentences. The first column contains the token; the second column contains the named entity tag; and the third column contains the system's confidence value for this tag assignment.

Citation

If you use this collection, please cite:

Jacob Bremerman, Dawn Lawrie, James Mayfield and Douglas W. Oard, 2020. 'Two test collections for retrieval using named entity markup.' In Proceedings of the 29th ACM International Conference on Information and Knowledge Management (CIKM '20). October 19-23, 2020, Virtual Event, Ireland. ACM, New York, NY, USA. 4 pages. https://doi.org/10.1145/3340531.3417452.

About

Dataset for exploring the uses of named entity recognition in information retrieval

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages