Sentence lengths¶

sentence_lengths_plot(source, window=10, inset=True, ax=None, labels=None, sents_extractor=None, words_extractor=None, join_hyphens=False)

The curve of the lengths of the sentences - the rhythm of a text: the length of every sentence in words, in order, the moving average over window sentences and an inset with the histogram of the lengths. Short and long sentences in turn are an editorial sign of a lively text, a flat curve of a monotonous one. The function takes the axes ax and returns Axes.

from anyts.visualizers import sentence_lengths_plot

text = "The cat sleeps. Does the dog? It eats, she said. Then both of them went out."
sentence_lengths_plot(text, window=2)

Parameters¶

Parameter	Type	Default	Description
`source`	`str` / `Doc` / `Iterable[int]`	-	Text, Doc object or lengths of the sentences (a list, a numpy array, a Series)
`window`	`int`	`10`	Window of the moving average in sentences
`inset`	`bool`	`True`	Show the inset with the histogram
`ax`	`Axes`	`None`	Axes for the plot
`labels`	`dict[str, str]`	`None`	Labels over the defaults: `title`, `xlabel`, `ylabel`, `length` (the curve), `average` (a format string with `window`), `distribution` (the inset)
`sents_extractor`	`SentsExtractor`	`None`	Extractor of the sentences of a string; the sentence extractor of the library by default
`words_extractor`	`WordsExtractor`	`None`	Extractor of the words of a sentence of a string; the word extractor of the library by default

The source and the extractors raise the errors of sentence_lengths, and no sentences raise SourceError; a window that is not an integer of at least one, labels that merge_labels refuses and an ax that is not a matplotlib Axes raise ParameterError.

The core functions also take join_hyphens, False by default, which joins the parts of hyphenated words of a Doc with sentence boundaries (iter_doc_words). The extractors of the core are SentsExtractor() and WordsExtractor().

Lengths of the sentences¶

sentence_lengths(source, sents_extractor=None, words_extractor=None, join_hyphens=False)

The lengths of the sentences in words, in order: a string is split by the sentence and the word extractors, a Doc by its boundaries and iter_doc_words with join_hyphens, and a Doc without boundaries or with partial ones (has_sents) is counted as its text. Sentences without words are skipped. Ready lengths (non-negative integers in a sequence or an iterator) are used as they are. The arguments are those of sentence_lengths_plot.

A table, a set, a mapping, bytes, a length that is not an integer and an extractor of another type raise SourceTypeError, a negative length SourceError.

CodeResult

from anyts.visualizers import sentence_lengths

sentence_lengths("The cat sleeps. Does the dog? It eats, she said. Then both of them went out.")

[3, 3, 4, 6]