Skip to main content

A package and utilities providing a variety of discourse segmentation evaluation metrics

Project description

https://travis-ci.org/cfournie/segmentation.evaluation.png?branch=master https://coveralls.io/repos/cfournie/segmentation.evaluation/badge.png?branch=master https://pypip.in/v/segeval/badge.png https://pypip.in/d/segeval/badge.png

Text segmentation is the task of splitting up any amount of text into segments by placing boundaries between some atomic unit (e.g., morphemes, words, lines, sentences, paragraphs, sections, etc.). It’s a common pre-processing step in many Natural Language Processing (NLP) tasks.

This package is a collection of metrics and for comparing text segmentations and evaluating automatic text segmenters. Both new (Boundary Similarity, Segmentation Similarity) and traditional (WindowDiff, Pk) are included, as well as inter-coder agreement coefficients and confusion matrices based upon a boundary edit distance.

To see some examples of its usage, read the docs.

Feature Support

Included is a variety of segmentation comparison metrics, including:

  • Boundary Edit Distance (BED)

  • Boundary Similarity (B)

  • BED-based confusion matrices (and precision/recall/F1)

  • Segmentation Similarity (S)

  • WindowDiff

  • Pk

Additionally, B-based inter-coder agreement coefficients for segmentation that are suitable for 2 or more coders are provided, including:

  • Fleiss’ Pi (i.e., Siegel and Castellan’s K)

  • Fleiss’ Kappa

Installation

To install SegEval, simply run:

$ pip install segeval

Documentation

Documentation is available at http://segeval.readthedocs.org/.

Citing SegEval

If you’re using this software for research, please cite the ACL paper [PDF] and, if you need to go into details, the thesis [PDF] describing this work:

  • Chris Fournier. 2013. Evaluating Text Segmentation using Boundary Edit Distance. Proceedings of 51st Annual Meeting of the Association for Computational Linguistics. (ACL 2013), to appear. Association for Computational Linguistics, Stroudsburg, PA, USA.

  • Chris Fournier. 2013. Evaluating Text Segmentation. (Master’s thesis). University of Ottawa.

BibTeX:

@inproceedings{Fournier2013a,
        author          = {Fournier, Chris},
        year            = {2013},
        title           = {{Evaluating Text Segmentation using Boundary Edit Distance}},
        booktitle       = {Proceedings of 51st Annual Meeting of the Association for Computational Linguistics},
        publisher       = {Association for Computational Linguistics},
        location        = {Sophia, Bulgaria},
        pages           = {to appear},
        address         = {Stroudsburg, PA, USA}
}

@mastersthesis{Fournier2013b,
        author          = {Fournier, Chris},
        title           = {Evaluating Text Segmentation},
        school          = {University of Ottawa},
        year            = {2013}
}

Project details


Download files

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

Source Distribution

segeval-2.0.5.tar.gz (12.0 kB view details)

Uploaded Source

File details

Details for the file segeval-2.0.5.tar.gz.

File metadata

  • Download URL: segeval-2.0.5.tar.gz
  • Upload date:
  • Size: 12.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for segeval-2.0.5.tar.gz
Algorithm Hash digest
SHA256 3c611ba457b7cf7e64a0f49dc554c7ad2f47546dd1a2875a04f821dbaf0c867a
MD5 f33787996b2754a268aa500474e249c9
BLAKE2b-256 49b1d36b9ed28be1b588efbc14abd993b0fa6aa52375d718f77a42dd8a538afb

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page