Essay Analyzer Info

Essay Analyzer

A freeware tool for English instructors

Program Purpose
Disclaimer and Contact Information
Download
Install
Uninstall
Program Use: An Overview
Program Layout

Program Use: Step by Step

  1. Save the Original Essay as a Plain Text File
  2. Import the Text File
  3. Add a Prompt for the Essay
  4. Include Created By Information
  5. Add Notes
  6. Insert and Delete Text
  7. Define Notes
  8. Add a General Note for the Essay
  9. Export a Report for the Essay
  10. View the Note Categories for an Entire Folder

Report Parts


Program Purpose

The purpose of this software program is to aid English instructors and students. English instructors can add as much or as little information to their students’ essays as they desire. The instructor can add and delete text, or he or she can simply insert a note that gives the category of the writing problem that the student needs to address. The program totals the problems by category and subcategory. The student can then research the problems with the help of internet keywords and a grammar glossary that is attached to the essay report.

The English instructor can:

  • Analyze the essay, sentence by sentence.
  • Insert and delete text. (Inserted text is underlined and deleted text is shown with a strikethrough in the report.)
  • Add notes to the sentence. (These notes contain the category and subcategory of the writing problem. The six categories are Content, Grammar, Words, Punctuation, Citations, and Other.)
  • Export an HTML (web page) report for the student. (This report shows the insertions, deletions, and notes for each sentence, contains a summary of the note categories and subcategories, and includes a grammar glossary and internet search terms for the student’s reference.)
  • View the note category and subcategory totals for a student or for an entire class.

Top of Page


Disclaimer and Contact Information

This software program is provided as-is. No warranty is expressed or implied. By downloading, installing, and using the software program on this page, you agree not to hold the author of the software program liable for lost wages, time, material compensation, or any other loss. Every effort was made to make a bug-free program. However, as with all large programs, there could be some bugs. If you find a logical or programming bug, you can report it to the author on the contact form on this website. If the program gives you an error message, you can later save this message in a text file by using the Help, Make Error Log File function in the Help menu. Any comments, suggestions, questions, or problems can be reported on the contact page.

Top of Page


Download

The program is for Windows computers (XP and later). If you have an old Windows computer, the program might download a service pack from Microsoft when the program installs. This is so the newer features of Visual Basic will work on older computers. Click here to download the zip file (2.2 MB) containing the program.

  • Updated: October 22, 2013.
  • Initial release: October 10, 2013.

Top of Page


Install

  • The program is for Windows computers (XP and later). If you have an old Windows computer, the program might download a service pack from Microsoft when the program installs. This is so the newer features of Visual Basic will work on older computers.
  • Download the zip file above.
  • Extract the zip file on your computer.
  • Open the extracted folder and double click (run or open) the “setup” file.
  • The program will be installed.

Top of Page


Uninstall

You will need to uninstall the program if you install a newer version of the program.

To uninstall the program (on a Windows 7 computer):

  1. Click on the Windows circle icon at the lower left corner of your screen.
  2. Click on Control Panel.
  3. Click on Uninstall a Program.
  4. Click on the program named Essay Analyzer.
  5. Click on Uninstall/Change.
  6. Select Remove the application from this computer and click on OK.

Top of Page


Program Use: An Overview

To use the program, you will:

  1. Create a folder for your files.
  2. Save the essay file to the folder.
  3. Save the essay file as a plain text file (UTF-8 format).
  4. Start the Essay Analyzer program.
  5. Import the plain text file of the essay and create a data file for the essay.
  6. Enter the prompt for the essay, if there is one.
  7. Add zero, one, or more notes to each sentence of the essay.
  8. Write a general note for the student about his or her essay.
  9. Export an HTML (web page) report for the student to read about his or her essay.

Top of Page


Program Layout

EA6Top of Page


File Menu

EA7

  1. File Menu.
  2. Import Essay Text File: Select this to import an essay text file (UTF-8 format).
  3. Open Data File: Select this to open an existing data file. When you start the program, the last open data file will be automatically opened again.
  4. Open Recent Data File: Select this to open an existing data file that has been opened previously.
  5. Save Data File As: Select this to save the data file as a new file and increment the number of the data file by one. Each time you make a change, the current data file is automatically saved. That is why you don’t see a save option on the menu.
  6. Close Data File: Select this to close the currently open data file. This is not really necessary. When you open another data file, the current data file will automatically close.
  7. Export Report: Select this to export an HTML (web page) report for the student. See below to view the parts of the report.
  8. Note Summary For A Folder: Select this to create a summary of all the notes in the data files of a specified folder (and all the subfolders). All of the notes for each category will be totaled up.
  9. Exit: Select this to exit the program.

Top of Page


Essay Info Menu

EA3

  1. Essay Info Menu.
  2. Created By: Select this to add your name and organization. This information can optionally be included in the essay reports.
  3. Essay Prompt: Select this to add the prompt for the essay, if there is one.
  4. General Note: Select this to add a general note for the student about his or her essay.

Top of Page


Essay Analyzer Top Part

EA4

  1. Menu bar: Use the menu to access files, add essay info, change the font size, or check spelling. The word list for spell checking is not exhaustive, so the program might highlight a valid word that is not in the word list.
  2. Essay information: This information includes the file name, number of words in the original essay, current sentence, current paragraph, and editing time.
  3. Original sentences: This sentence is in gray, and it is the original, unedited sentence from the essay.
  4. Sentence with changes accepted: This is the sentence with the editing changes already accepted. Inserted text is present, and deleted text is absent.
  5. Sentence with changes shown: This sentence shows the changes made to it. Each time you make a change, the data file is saved. Notes that have been added have square parentheses: [[1]]. Deleted text is shown with a gray color and curly parentheses: {{deleted text}}. Inserted text is shown with regular parentheses: ((inserted text)). The current note is yellow.
  6. Insert text: This is where you type text to insert in sentence (5). If you press Enter without typing any text, the insert action will be cancelled.
  7. Note: Click this button after you have clicked on a location in sentence (5) where you want a simple note to be placed.
  8. Insert: Click this button after you have clicked on a location in sentence (5) where you want text to be inserted. If you select text in sentence (5) before you click the insert button, the selected text will be deleted and the inserted text will be placed after it.
  9. Delete: Click this button after you have selected text in sentence (5) to delete.
  10. Undo: Click this button to undo one insertion, deletion, or simple note. Once you define a note, you cannot undo the previous notes created. However, you can reset the sentence.
  11. Redo: Click this button to redo one insertion, deletion, or simple note.
  12. Reset: Click this button to remove all notes and editing changes from the original sentence. This action applies only to the current sentence.
  13. <<: Click this button to move to the first sentence of the current paragraph, then to the previous paragraph.
  14. <: Click this button to move to the previous sentence.
  15. >: Click this button to move to the next sentence.
  16. >>: Click this button to move to the next paragraph.
  17. Combine: Click this button to combine the current sentence with the next sentence. This might be necessary if the program cuts the sentence after an abbreviation, such as U.S., where there is a period.

Top of Page


Essay Analyzer Bottom Part

EA5

  1. Number of notes defined: This shows how many of the notes have been defined with categories and
    subcategories.
  2. Note list: This is the list of notes for the current sentence. The current note is highlighted with yellow.
  3. Previous note: Click this button to move to the previous note.
  4. Next note: Click this button to move to the next note.
  5. Current note number: This shows the number of the current note.
  6. Subcategory: This is the subcategory chosen for the note.
  7. Additional information: This text is additional information that has been added to the note by the instructor.
  8. Category / Subcategory: This shows the category and subcategory of the note. The category is selected automatically after the subcategory has been chosen. There are six categories: Content, Grammar, Words, Punctuation, Citations, and Other.

Top of Page


Program Use: Step by Step

1. Save the Original Essay as a Plain Text File

  • In Microsoft Word, choose Save As, Plain Text, and then choose Other Encoding, Unicode (UTF-8). When you save the essay as Unicode (UTF-8), all of the special characters and foreign words will be retained. However, all of the text formatting (including underlining, bold, and italics) will be lost.
  • If you have a class of students, I recommend that you create folders and subfolders with this hierarchy: [Class Name OR Class Number] ->[Student Name OR Student Number]->[Assignment Name OR Assignment Number], where Class Name is the folder at the highest level. Then, you can name the essay text files something like, “C1 Joe Smith A1,” where C1 represents Class 1 and A1 represents Assignment 1. Put the essay text file in the Assignment folder at the lowest (innermost) level.

Top of Page


2. Import the Text File

  • Within the Essay Analyzer program, select File, Import Essay Text File. Locate the text file on your computer and open it. Next, save a new data file. This data file will hold the essay text file, the prompt for the essay, the notes that you add to each sentence, and a general note for the essay as a whole.
  • The file name of the data file contains the name of the essay text file with the ending “_Data_#”. The symbol # represents a number that increases by one each time you create a new data file for the same essay text file. You must use the data file name that the program gives you.
  • Each time you make a change, the current data file is automatically saved. That is why you don’t see a save option on the menu.

Top of Page


3. Add a Prompt for the Essay

  • When you import the text file, you will be asked to add the essay prompt. You can add the essay prompt at this time or at any time that the data file is open. You can also leave the prompt blank. To add the prompt later, select Essay Info, Essay Prompt (3) from the menu at the top of the program.

Top of Page


4. Include Created By Information

  • You can enter your name and your organization. This information can be included on the reports that you create for your students. This information applies to all essays you analyze until you change the information. To add or edit this information, select Essay Info, Created By (2) from the menu at the top of the program.

Top of Page


5. Add Notes

  • Notes are added to a sentence each time you insert text, delete text, delete/insert text, or add a simple note.
  • To add a simple note to the sentence, click on the location in sentence (5) where you want the note to be placed, then click on the Note button (7).
  • To remove all the notes and changes to the sentence, click the Reset button (12).
  • To move to the previous or next sentence click on < (14) or > (15).
  • To move to the previous or next paragraph click on << (13) or >> (16).

Top of Page


6. Insert and Delete Text

  • To insert text, click on the location that the text will be inserted in sentence (5), click the Insert button (8), type the text to insert, and press Enter. If you press Enter without typing any text, the insert command will be cancelled.
  • To delete text, select the text to be deleted in sentence (5) and click the Delete button (9).
  • To delete and insert text, select the text to be deleted in sentence (5), click the Insert button (8), type the text to be inserted, and press Enter. The inserted text will be placed after the deleted text.

Top of Page


7. Define Notes

  • Notes are defined when the subcategory of the note is selected. The category of the note is chosen automatically by the program at the time the subcategory is selected. Additional information can also be added to the note.
  • The current note is highlighted yellow in sentence (5) and in the Note list (2).
  • To move to the previous or next note, click on the < (3) or > (4) buttons at the bottom left part of the program.
  • To add a note subcategory, select the note subcategory from the Subcategory list (6) or type the subcategory into the list text box (6). The category is selected automatically after the subcategory is chosen. There are six categories: Content, Grammar, Words, Punctuation, Citations, and Other. The category and subcategory for the note are shown in text box (8). You will want to become familiar with the note subcategories before you analyze too many essays. Of course, writing correction is not an exact science, and more than one subcategory may be suitable for the writing problem. If this is the case, use the subcategory that you feel is most appropriate or helpful.
  • To add additional information to the note, type the information into text box (7).
  • You can define the notes at any time the data file is open. You can define them after each note is created, or you can define them after all the notes for a sentences have been created. If you press Enter after you have typed a note subcategory, the cursor will move to the Additional information text box (7). If you press Enter again, the program will move to the next note.

Top of Page


8. Add a General Note for the Essay

  • After you have finished adding notes to each sentence of the essay, you can write a general note about the essay for the student by selecting Essay Info, General Note (4). While you write the general note, you can view the original essay and the totals of the categories and subcategories of the notes.

Top of Page


9. Export a Report for the Essay

  • When you are finished analyzing the essay, you can export an HTML (web page) report for the essay. The web page is self-contained and is viewed offline. To export a report, select File, Export Report (7). The parts of the report are shown below.

Top of Page


10. View the Note Categories for an Entire Folder

  • You can view the note category totals for all of the files in a folder and its subfolders by selecting File, Note Summary For A Folder (8) and selecting a folder. If there is more than one data file in an innermost folder, only the data file with the highest number of the same name will be included in the totals.

Top of Page


Report Parts

Sample Report

Click here to view a sample report for Essay Analyzer.

Top of Page


Title, Menu, and Header

This part shows the title of the report (from the text file name), a navigational menu, and general information about the essay and the report.

RE1Top of Page


Note From Instructor

This part is the general note for the essay as a whole. The instructor writes this for the student.

RE9Top of Page


Instructions

This part will be included in each report. This part gives general information to explain to the student how to understand the parts of the report.

RE2Top of Page


Summary

This part gives the totals of the categories and subcategories of the notes. It also includes the sentences where the notes can be found, glossary terms, and internet search terms.

RE3Top of Page


Essay Prompt

This part is optional. It is where the prompt for the essay is shown.

RE4Top of Page


Sentences

This is the heart of the report. This part shows each sentence and the notes for each sentence. The notes include grammar glossary links and search terms where available.

RE5Top of Page


Original Essay

This part shows the essay as it was originally saved in the text file.

RE6Top of Page


Essay With Changes Shown

This part shows the essay with changes shown, as in the separate sentences. This part, however, does not include the notes.

RE10Top of Page


Essay With Changes Accepted

This part shows the essay with deletions and insertions accepted. This part and the previous part are optional. They should be included if the instructor made all of the needed changes for the student.

RE7Top of Page


Grammar Glossary

This part is the grammar glossary. Students can research unfamiliar grammar terms here.

RE8Top of Page