<%= @analysis.readability_score %>

READABILITY

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

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

How is this calculated?
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.smog_grade %>
  • SMOG grade: <%= @analysis.smog_grade.try(:round) %> / 16
    • <% end %> <% if @analysis.combined_average_reading_level %>
  • Combined average reading level: <%= @analysis.combined_average_reading_level.try(:round) %> / 16
    • <% end %>
Readability scales
<%= render partial: 'document_analyses/readability/flesch_kincaid', locals: { analysis: @analysis } %> <%= render partial: 'document_analyses/readability/smog_grade', locals: { analysis: @analysis } %> <%= render partial: 'document_analyses/readability/coleman_liau', locals: { analysis: @analysis } %> <%= render partial: 'document_analyses/readability/dale_chall', locals: { analysis: @analysis } %> <%= render partial: 'document_analyses/readability/gunning_fog', locals: { analysis: @analysis } %> <%= render partial: 'document_analyses/readability/automated_readability_index', locals: { analysis: @analysis } %> <%= render partial: 'document_analyses/readability/linsear_write', locals: { analysis: @analysis } %> <%= render partial: 'document_analyses/readability/forcast', locals: { analysis: @analysis } %>
Lexical richness
Word variety

Number of unique 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?
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

Of all your words...

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

A complex word is a word made up of at least three 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 "math" is a simple word with just one morpheme: "math".

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 ) %>
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]) %>
Averaged structure ratios
... per word ... per sentence ... per paragraph
Letters... <%= (@analysis.character_count.to_f / @analysis.word_count).round(4) %> <%= (@analysis.character_count.to_f / @analysis.sentence_count).round(4) %> <%= (@analysis.character_count.to_f / @analysis.paragraph_count).round(4) %>
Words... <%= (@analysis.word_count.to_f / @analysis.word_count).round(4) %> <%= (@analysis.word_count.to_f / @analysis.sentence_count).round(4) %> <%= (@analysis.word_count.to_f / @analysis.paragraph_count).round(4) %>
Simple words... <%= (@analysis.simple_words_count.to_f / @analysis.word_count).round(4) %> <%= (@analysis.simple_words_count.to_f / @analysis.sentence_count).round(4) %> <%= (@analysis.simple_words_count.to_f / @analysis.paragraph_count).round(4) %>
Complex words... <%= (@analysis.complex_words_count.to_f / @analysis.word_count).round(4) %> <%= (@analysis.complex_words_count.to_f / @analysis.sentence_count).round(4) %> <%= (@analysis.complex_words_count.to_f / @analysis.paragraph_count).round(4) %>
Sentences... <%= (@analysis.sentence_count.to_f / @analysis.word_count).round(4) %> <%= (@analysis.sentence_count.to_f / @analysis.sentence_count).round(4) %> <%= (@analysis.sentence_count.to_f / @analysis.paragraph_count).round(4) %>
Paragraphs... <%= (@analysis.paragraph_count.to_f / @analysis.word_count).round(4) %> <%= (@analysis.paragraph_count.to_f / @analysis.sentence_count).round(4) %> <%= (@analysis.paragraph_count.to_f / @analysis.paragraph_count).round(4) %>
<% if @analysis.adult_content_flag? %> Potential adult content detected <% else %> No adult content detected <% end %>
<% if @analysis.profanity_content_flag? %>
warning <%= pluralize @analysis.profanity_trigger_words.count, 'potentially profane word' %> detected:
<% @analysis.profanity_trigger_words.each do |word| %> <%= word %> <% end %>
<% else %> check No profane words detected. <% end %>
<% if @analysis.violence_content_flag? %>
warning <%= pluralize @analysis.violence_trigger_words.count, 'potentially violent word' %> detected:
<% @analysis.violence_trigger_words.each do |word| %> <%= word %> <% end %>
<% else %> check No violent words detected. <% end %>
<% if @analysis.hate_content_flag? %>
warning <%= pluralize @analysis.hate_trigger_words.count, 'potentially hateful word' %> detected:
<% @analysis.hate_trigger_words.each do |word| %> <%= word %> <% end %>
<% else %> check No hateful words detected. <% end %>
<% if @analysis.sex_content_flag? %>
warning <%= pluralize @analysis.sex_trigger_words.count, 'potentially sexual word' %> detected:
<% @analysis.sex_trigger_words.each do |word| %> <%= word %> <% end %>
<% else %> check No sexual words detected. <% end %>