StringTools - Maple Programming Help

Home : Support : Online Help : Programming : Names and Strings : StringTools Package : English Text : StringTools/Readability

StringTools

 measure the readability of English text

Parameters

 text - string; substantial English text m - symbol; the name of one of the methods described below

Description

 • The Readability(text) command returns one of several measures of Readability of English language text. By default, when called without the method option, Readability computes the SMOG index of text. Several other measures of readability are provided. The following table lists the valid values of the method parameter m.

 SMOG the SMOG index GunningFog The Gunning-Fog index FRES Flesch Reading Ease Index FKGLF Flesch-Kincaid Grade Level Formula ARI Automated Readability Index ColemanLauIndex The Coleman-Lau Readability Index

 • Each of the readability indices (or other measures) is a statistical test that uses various properties of the text to determine a measure of the level of difficulty of reading the text. Small amounts of text are not suitable for input. It is recommended that you use at least 100 words of text for any of the measures to provide any meaning.
 • All of the StringTools package commands treat strings as (null-terminated) sequences of $8$-bit (ASCII) characters.  Thus, there is no support for multibyte character encodings, such as unicode encodings.

Examples

 > $\mathrm{with}\left(\mathrm{StringTools}\right):$
 > $\mathrm{text1}≔"See Spot. See spot run. Spot is a dog. Look Jill! Look! Look! Look at Spot! Tristan, see spot. See spot run. Spot runs and runs. Spot is funny. Spot is nice. Tristan is nice. Jill is nice. We are all nice. Spot is special. Spot is my special dog. My special dog Spot runs and runs. He is so special. Tristan is special. Jill is special. I am special. We are all special. Spot is black. Black dogs are special. So Spot is special. Jill is a big girl. Big girls are special. So Jill is special. Tristan is a big boy. Big boys are special. So Tristan is special. I am a little girl. Little girls are special. So I am special. We are all special. We are all very, very special.":$
 > $\mathrm{text2}≔"Long ago two Indian boys lived in the Canadian forest with their parents. One boy was much older and larger and stronger than the other. He forced his little brother to do all the hard work about the place. He stole from him all the good things his parents gave him and often he beat him until he cried with pain. If the little boy told his parents of his brother\text{'}s cruelty, his brother beat him all the harder, and the little boy found that it was more to his comfort not to complain. But at last he could stand the cruelty no longer, and he decided to run away from home. So one morning he took his bow and arrows and an extra pair of moccasins, and set out alone to seek his fortune and to find a kinder world.":$
 > $\mathrm{text3}≔"Not all that Mrs. Bennet, however, with the assistance of her five daughters, could ask on the subject, was sufficient to draw from her husband any satisfactory description of Mr. Bingley. They attacked him in various ways--with barefaced questions, ingenious suppositions, and distant surmises; but he eluded the skill of them all, and they were at last obliged to accept the second-hand intelligence of their neighbour, Lady Lucas. Her report was highly favourable. Sir William had been delighted with him. He was quite young, wonderfully handsome, extremely agreeable, and, to crown the whole, he meant to be at the next assembly with a large party. Nothing could be more delightful! To be fond of dancing was a certain step towards falling in love; and very lively hopes of Mr. Bingley\text{'}s heart were entertained.":$
 > $\mathrm{map}\left(\mathrm{nops},\mathrm{map}\left(\mathrm{Words},\left[\mathrm{text1},\mathrm{text2},\mathrm{text3}\right]\right)\right)$
 $\left[{134}{,}{141}{,}{135}\right]$ (1)
 > $\mathrm{Readability}\left(\mathrm{text1}\right)$
 ${3.0}$ (2)
 > $\mathrm{Readability}\left(\mathrm{text2}\right)$
 ${6.585685828}$ (3)
 > $\mathrm{Readability}\left(\mathrm{text3}\right)$
 ${12.48683298}$ (4)
 > $\mathrm{Readability}\left(\mathrm{text1},':-\mathrm{method}'=':-\mathrm{GunningFog}'\right)$
 ${1.448648649}$ (5)
 > $\mathrm{Readability}\left(\mathrm{text3},':-\mathrm{method}'=':-\mathrm{GunningFog}'\right)$
 ${13.93650794}$ (6)
 > $\mathrm{Readability}\left(\mathrm{text2},':-\mathrm{method}'=':-\mathrm{FRES}'\right)$
 ${80.7900000}$ (7)
 > $\mathrm{Readability}\left(\mathrm{text3},':-\mathrm{method}'=':-\mathrm{FRES}'\right)$
 ${53.7800000}$ (8)