This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

A text summarization and keyword extraction package

Project Description

TextRank implementation for text summarization and keyword extraction in Python

Features

  • Text summarization
  • Keyword extraction
  • Text modeling with graph and gexf exportation

Examples

Text summarization:

>>> text = """Automatic summarization is the process of reducing a text document with a
computer program in order to create a summary that retains the most important points
of the original document. As the problem of information overload has grown, and as
the quantity of data has increased, so has interest in automatic summarization.
Technologies that can make a coherent summary take into account variables such as
length, writing style and syntax. An example of the use of summarization technology
is search engines such as Google. Document summarization is another."""

>>> from summa import summarizer
>>> print summarizer.summarize(text)
'Automatic summarization is the process of reducing a text document with a computer
program in order to create a summary that retains the most important points of the
original document.'

Keyword extraction:

>>> from summa import keywords
>>> print keywords.keywords(text)
document
automatic summarization
technologies
technology

Installation

This software depends on NumPy and Scipy, two Python packages for scientific computing. You must have them installed prior to installing summa:

pip install summa

If you are going to use the export function, you also need NetworkX. For a better performance of keyword extraction, install Pattern

This version has been tested under Python 2.7

More examples

  • Command-line usage:

    cd path/to/folder/summa/
    python textrank.py -t FILE
    
  • Export:

    >>> from summa.export import gexf_export
    >>> gexf_export(text, path="graph.gexf")
    
  • Define length of the summary as a proportion of the text (also available in keywords):

    >>> from summa.summarizer import summarize
    >>> summarize(text, ratio=0.2)
    
  • Define length of the summary by aproximate number of words (also available in keywords):

    >>> summarize(text, words=50)
    
  • Define input text language (also available in keywords):

    >>> summarize(text, language='spanish')
    

The available languages are “danish”, “dutch”, “english”, “finnish”, “french”, “german”, “hungarian”, “italian”, “norwegian”, “porter”, “portuguese”, “romanian”, “russian”, “spanish”, “swedish”

  • Get results as a list (also available in keywords):

    >>> summarize(text, split=True)
    ['Automatic summarization is the process of reducing a text document with a
    computer program in order to create a summary that retains the most important
    points of the original document.']
    

Summa is open source software released under the The MIT License (MIT). Copyright (c) 2014 - now Summa NLP

Release History

Release History

This version
History Node

0.0.7

History Node

0.0.6

History Node

0.0.5

History Node

0.0.1

Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
summa-0.0.7.tar.gz (41.6 kB) Copy SHA256 Checksum SHA256 Source Apr 20, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting