Skip to main content

numeric fused-head identification and resolution

Project description

Numeric Fused-Head

This is the code used in the paper:

"Where’s My Head? Definition, Dataset and Models for Numeric Fused-Heads Identification and Resolution" Yanai Elazar and Yoav Goldberg

to appear in TACL

preprint demo


Installing the num_fh package is simple as:

pip install num_fh


  • at least python 3.6 (and specific libraries in the requirements.txt)

We strongly recommend that you use a new virtual environment to install num_fh

create a clean conda env

conda create -n nfh python==3.6 anaconda
source activate nfh

Cloning and Running the Library by Yourself

clone this repo:

git clone

installing python packages

pip install -r requirements.txt

Example Usage

import spacy
from num_fh import NFH
nlp = spacy.load('en_core_web_sm')
nfh = NFH(nlp)
nlp.add_pipe(nfh, first=False)

doc = nlp("I told you two, that only one of them is the one who will get 2 or 3 icecreams")
assert doc[16]._.is_nfh == True
assert doc[18]._.is_nfh == False
assert doc[3]._.is_deter_nfh == True
assert doc[16]._.is_deter_nfh == False
assert len(doc._.nfh) == 4

The paper (and therefore, also the code) deals with two sub-tasks of the FH solution:

  • Identification
  • Resolution

These are dealt with separately, and discussed in the paper in sections (3,4) and (5,6). These parts are also solved separately in the code, and contain further instructions for each one in dedicated README files: Identification and Resolution


To run the demo, run the following:

export FLASK_APP=num_fh/demo/
flask run --port 5000 --host ""


If you find this work relevant to yours, please consider citing us:

    title={Where's My Head? Definition, Dataset and Models for Numeric Fused-Heads Identification and Resolution},
    author={Yanai Elazar and Yoav Goldberg},


If you have any question, issue or suggestions, feel free to contact us with the emails listed in the paper.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for num-fh, version 1.1.1
Filename, size File type Python version Upload date Hashes
Filename, size num_fh-1.1.1-py3-none-any.whl (33.7 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size num_fh-1.1.1.tar.gz (23.0 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page