Skip to main content

Calculate statistics from text

Project description

Python package to calculate statistics from text, which helps to decide readability, complexity and grade level of a particular corpus.

Install

You can install textstat either via the Python Package Index (PyPI) or from source.

To install using pip:

>>>pip install textstat

To install using easy_install:

>>>pip easy_install textstat

Downloading and installing from source

Download the latest version of textstat from http://pypi.python.org/pypi/textstat/

You can install it by doing the following,:

>>>pip tar xfz textstat-*.tar.gz

>>>pip cd textstat-*/

>>>pip python setup.py build

>>>pip python setup.py install # as root

List of Functions

Syllable Count

function name - syllable_count(text)

returns - the number of syllables present in the given text.

Lexicon Count

function name - lexicon_count(text, TRUE/FALSE)

Calculates the number of words present in the text. TRUE/FALSE specifies whether we need to take in account in punctuation symbols while counting lexicons or not. Default value is TRUE, which removes the punctuation before counting lexicons.

Sentence Count

function name - sentence_count(text)

returns the number of sentences present in the given text.

The Flesch Reading Ease formula

function name - flesch_reading_ease(text)

returns the Flesch Reading Ease Score. Following table is helpful to access the ease of readability in a document.

  • 90-100 : Very Easy

  • 80-89 : Easy

  • 70-79 : Fairly Easy

  • 60-69 : Standard

  • 50-59 : Fairly Difficult

  • 30-49 : Difficult

  • 0-29 : Very Confusing

The The Flesch-Kincaid Grade Level

function name - flesch_kincaid_grade(text)

returns the grade score using the Flesch-Kincaid Grade Formula.

For example a score of 9.3 means that a ninth grader would be able to read the document.

The Fog Scale (Gunning FOG Formula)

function name - gunning_fog(text)

returns the FOG index of the given text.

The SMOG Index

function name - smog_index(text)

return the SMOG index of the given text.

Automated Readability Index

function name - automated_readability_index(text)

returns the ARI(Automated Readability Index) which outputs a number that approximates the grade level needed to comprehend the text.

For example if the ARI is 6.5, then the grade level to comprehend the text is 6th to 7th grade.

The Coleman-Liau Index

function name - coleman_liau_index(text)

returns the grade level of the text using the Coleman-Liau Formula

Linsear Write Formula

function name - linsear_write_formula(text)

returns the grade level using the Lisear Write Formula

Dale-Chall Readability Score

function name - dale_chall_readability_score(text)

Different from other tests, since it uses a lookup table of most commonly used 3000 english words. Thus it returns the grade level using the New Dale-Chall Formula.

Readability Consensus based upon all the above tests

function name - readability_consensus(text)

Based upon all the above tests returns the most appropriate grade level under which the given text belongs to.

Usage

A sample script showing the usage of all the above functions:

from textstat.textstat import textstat

if __name__ == '__main__':
               test_data = """Playing games has always been thought to be important to the development of well-balanced and creative children; however, what part, if any, they should play in the lives of adults has never been researched that deeply. I believe that playing games is every bit as important for adults as for children. Not only is taking time out to play games with our children and other adults valuable to building interpersonal relationships but is also a wonderful way to release built up tension."""

       print textstat.flesch_reading_ease(test_data)

       print textstat.smog_index(test_data)

       print textstat.flesch_kincaid_grade(test_data)

       print textstat.coleman_liau_index(test_data)

       print textstat.automated_readability_index(test_data)

       print textstat.dale_chall_readability_score(test_data)

       print textstat.difficult_words(test_data)

       print textstat.linsear_write_formula(test_data)

       print textstat.gunning_fog(test_data)

       print textstat.readability_consensus(test_data)

The arguement (text) for all the functions defined remains same - i.e the text for which statistics needs to be calculated

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

textstat-0.1.6.tar.gz (15.8 kB view details)

Uploaded Source

File details

Details for the file textstat-0.1.6.tar.gz.

File metadata

  • Download URL: textstat-0.1.6.tar.gz
  • Upload date:
  • Size: 15.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for textstat-0.1.6.tar.gz
Algorithm Hash digest
SHA256 8f458d70ccb2d1c9ee91894d8307e4ab5cf0365ee2d695c04b91eef72d71d9b9
MD5 762759879ef2ef4ffe0be173612b4b87
BLAKE2b-256 fa0e416bff9ef5650fe170f8e7ac97920cedfd410e4bcb9154c90e48886c9a9f

See more details on using hashes here.

Supported by

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