Ease of reading

<%= analysis.readability_score %>

READABILITY

<% Documents::Analysis::ReadabilityService.readability_score_category(analysis.readability_score) %>

<%= Documents::Analysis::ReadabilityService.readability_score_text(analysis) %>

Readability scales close

In order to provide you with a generalized score in Notebook.ai, we compute several of the most well-known readability scores on your text. For all scales other than the Flesch-Kincaid reading ease, a higher score means a greater difficulty reading. Conversely, lower scores mean text is easier to read.

We take a weighted composite score of all readability scales to give you a singular readability score.

    <% if analysis.flesch_kincaid_reading_ease %>
  • Flesch-Kincaid reading ease: <%= analysis.flesch_kincaid_reading_ease.try(:round) %> / 100
  • <% end %> <% if analysis.flesch_kincaid_grade_level %>
  • Flesch-Kincaid grade level: <%= analysis.flesch_kincaid_grade_level.try(:round) %> / 16
  • <% end %> <% if analysis.flesch_kincaid_age_minimum %>
  • Flesch-Kincaid age minimum: <%= analysis.flesch_kincaid_age_minimum.try(:round) %> / 20
  • <% end %> <% if analysis.forcast_grade_level %>
  • Forcast grade level: <%= analysis.forcast_grade_level.try(:round) %> / 16
  • <% end %> <% if analysis.coleman_liau_index %>
  • Coleman liau index: <%= analysis.coleman_liau_index.try(:round) %> / 16
  • <% end %> <% if analysis.automated_readability_index %>
  • Automated readability index: <%= analysis.automated_readability_index.try(:round) %> / 16
  • <% end %> <% if analysis.gunning_fog_index %>
  • Gunning fog index: <%= analysis.gunning_fog_index.try(:round) %> / 16
  • <% end %> <% if analysis.combined_average_reading_level %>
  • Combined average reading level: <%= analysis.combined_average_reading_level.try(:round) %> / 16
  • <% end %>
Show more readability statistics
Word variety

Number of words used...

<%= pie_chart({ 'exactly once' => analysis.words_used_once_count, 'multiple times' => analysis.words_used_repeatedly_count }, colors: ["#FF6977", Document.hex_color]) %>
Why is this important? close

The higher percentage of reused words you have, the more likely a reader will be able to understand new words from context alone, as they'll have more instances in which they can infer a meaning from that word's surroundings.

Having a higher number of reused words can make text much easier to read and understand, but a limited vocabularity may result in repetition and bland writing. Having a higher number of unique words may indicate more effective word choice, but can also be indicative of jargon.

Word complexity

Number of unique...

<%= pie_chart({ 'simple words' => analysis.simple_words_count, 'complex words' => analysis.complex_words_count }, colors: [Document.hex_color, "#FF6977"]) %>
Why is this important? close

A complex word is a word made up of at least two morphemes, or parts. Conversely, a simple word consists of only one. For example, "bookishness" is a complex word with morphemes "book", "ish", and "ness"; while "active" is a simple word with just one morpheme: "active".

Having a healthy mixture of simple and complex words is an important aspect of variety in your writing. Replacing complex words with simple words can make your story easier to understand, while replacing simple words with complex words can enable you to more efficiently pack more context and information into the words you choose to use.

Number of N-syllable words
<%= column_chart( analysis.n_syllable_words.map { |k, v| [k.to_s + "-syllable words", v] }, colors: [Document.hex_color], # todo more readable tooltips ) %>
<%# TODO: Order these cards by % %> <%# TODO: Darken/lighten card based on % %>
<%= analysis.pos_percentage(:adjective) %>%
Adjectives
<%= analysis.pos_percentage(:noun) %>%
Nouns
<%= analysis.pos_percentage(:verb) %>%
Verbs
<%= analysis.pos_percentage(:pronoun) %>%
Pronouns
<%= analysis.pos_percentage(:proper_noun) %>%
Proper nouns
<%= analysis.pos_percentage(:conjunction) %>%
Conjunctions
<%= analysis.pos_percentage(:adverb) %>%
Adverbs
<%= analysis.pos_percentage(:interrogative) %>%
Interrogatives
Stylistic baseline comparison
<%= column_chart([ { name: 'This document', data: [ ['% Adjectives', analysis.pos_percentage(:adjective)], ['% Adverbs', analysis.pos_percentage(:adverb)], ['% Nouns', analysis.pos_percentage(:noun)], ['% Pronouns', analysis.pos_percentage(:pronoun)], ['% Verbs', analysis.pos_percentage(:verb)] ] }, { name: 'Average writing', data: [ ['% Adjectives', 8], ['% Adverbs', 5], ['% Nouns', 25], ['% Pronouns', 5], ['% Verbs', 17] ] }, { name: 'Hemingway', data: [ ['% Adjectives', 5], ['% Adverbs', 7], ['% Nouns', 18], ['% Pronouns', 12], ['% Verbs', 23] ] } ]) %>
Lexical richness: % unique words per passage
<%= column_chart([ ['This document', analysis.pos_percentage(:words_used_once)], ['Hemingway', 12.5], ['The Grapes of Wrath', 14.5], ['The Great Gatsby', 16], ["Swann's Way", 17], ["Typical Writing", 22] ], colors: [Document.hex_color]) %>