## 20 Analysis Window - The Search Statistics Tab

The Search Statistics Tab displays a detailed statistical analysis of the last search done. Brief statistics are available immediately after doing a Command Line search by looking at the display area in the far left area of the Main Window Status Bar. If these statistics are too brief you can display the Search Statistics tab to get more information. This section discusses interpretation of the statistics in these two areas.

What to Plot

Options Button

### Interpreting the Status Area Search Statistics

When you do a search, the status bar across the bottom of the BibleWorks main window displays the basic statistics for the search. This section explains how to interpret the statistics. In addition, detailed statistics for the search are available in the Search Statistics Tab. This tab is also described below.

In order to make the best use of these statistics you will need to understand the distinctions between the various statistics. The statistics involve verses, words, and hits. It is important to understand how these work together. A hit (or a match) is composed of one or more words satisfying the search conditions. For example, in a search looking for all verses containing a noun and a verb, a hit is composed of two words where the two words are a noun-verb pair found in a verse. In addition, a hit may be contained within a verse, or span several verses, and a verse may contain more than one hit. In the example above, the exhaustive count of hits must count all noun-verb pairs, so that if a given verse contained two nouns and three verbs, there would be six unique noun-verbs pairs, and thus, six hits within that verse.

The status bar across the bottom of the main window in BibleWorks displays the follow basic statistics after each search:

§         Number of Verses
This first statistic gives the total number of verses which contained a hit. Note that if you are doing a linear search that crosses verse boundaries (see More Complex Word and Phrase Searches), this parameter has limited significance. But for the vast majority of search types its meaning is straight-forward.

§         Number of Words/Forms
This statistic gives the total number of words or forms involved in the search. For simple searches, this is just the number of words entered on the Command Line. If your search contained wildcards, this parameter includes all words matched by the wildcard(s) regardless of whether or not they were included in the final list of verses matched.

§         Number of Hits
This statistic gives the number of hits (as defined above) that occurred over all verses. The number of hits is determined by permuting the matches over each verse. For example, if we do a search on <.god love> one of the verses found will be 1 John 4:7. Note that there are 6 hits in this verse as follows:

 1 Beloved, let us love one another: for love is of God; and every one that loveth is born of God, and knoweth God. {is born: or, has been born 2 Beloved, let us love one another: for love is of God; and every one that loveth is born of God, and knoweth God. {is born: or, has been born 3 Beloved, let us love one another: for love is of God; and every one that loveth is born of God, and knoweth God. {is born: or, has been born 4 Beloved, let us love one another: for love is of God; and every one that loveth is born of God, and knoweth God. {is born: or, has been born 5 Beloved, let us love one another: for love is of God; and every one that loveth is born of God, and knoweth God. {is born: or, has been born 6 Beloved, let us love one another: for love is of God; and every one that loveth is born of God, and knoweth God. {is born: or, has been born

There are six different combinations of these two words in this single verse, so there are six hits. If you do not want permutations to be counted you can go into the Options Window under the Tools | Options | General | Flags | Command Line Search Options section and turn off the "Compute Search Window hits by permutation" flag. If you do that you will get 5 hits in this verse, namely:

Beloved, let us love one another

for love is of God

and every one that loveth is born of God,

and knoweth God. {is born: or, has been born

This is done just by adding up the matched words in a verse (the highlights).

### Verse Limits Settings and Statistics in the Search Window

On occasion you will see statistics in parentheses. When you see the results in this format it indicates that you have limited the search via the Search Limits Window to certain books. The statistics in parentheses tell you what the results would have been if you had searched the entire version of the Bible that you are currently using as a search version. If you are doing concatenated searches (i.e. multiple searches enclosed in parentheses) this additional information is not reported even if you have search limits set. However, if limits are set on the current search version, an asterisk will always precede the statistical information.

### The Search Statistics Tab

To examine the results of a search in even more detail, you need to look at the Search Statistics Tab. When you display the Search Statistics Tab, a detailed list of statistics per chapter, per book, or per verse will be displayed. You can choose from several types of statistics, some based on hit counts, some based on word counts, and some based on verse counts. You can manipulate the graph, copy it to the clipboard, export it, and print it.

When viewing the results in this window, you can resize the window by moving the separator line between the Browse Window and the Analysis Window. You can also open the Search Statistics Tab in a new window, then grabbing the edge of the new window with your mouse, holding down the left mouse button, and dragging the window to desired size. This allows you to display more of the graph at once. The configuration options are listed below.

Old Testament hits appear with a green bar, New Testament hits appear with a red bar, and hits in the Apocrypha or non-Biblical books appear with a blue bar.

What to Plot

This dropdown determines how the search statistics are plotted.

When the Detail Level is Book, these options are visible:

§         Number of verses in the book containing a hit - For each book of the Bible version, the number of verses containing one or more hits is shown for each book in the Bible version.

§         Number of hits in the book - For each book of the Bible version, the number of hits in the book is shown.

§         %: (verses in the book with a hit) / (verses in book) - For each book in the Bible version, this shows the percentage of verses in the book that contain one or more hits.

§         %: (hits in the book) / (hits in version) - For each book in the Bible version, this shows the percentage of the total hits in the Bible version occurring in each book.

§         %: (verses in the book with a hit) / (verses in version) - For each book in the Bible version, this shows the percentage of the total number of verses in the version that occur in this book of the Bible and also contain a hit.

§         %: (hits in the book) / (words in the book) - For each book in the Bible version, this shows the percentage of words in the book that are in a hit. This is only valid if the query describes single-word hits (hits that have no more than one word). For queries where a hit may have more than one word, this view is not valid.

§         %: (hits in the book) / (words in the version) - For each book in the Bible version, this shows the percentage of the total number of words in the Bible version that are in a hit occurring in the book. This is only valid if the query describes single-word hits (hits that have no more than one word). For queries where a hit may have more than one word, this view is not valid.

When the Detail Level is Chapter, these options are visible:

§         Number of verses in the chapter containing a hit - For each chapter of the Bible version, the number of verses containing one or more hits is shown for each chapter in the Bible version.

§         Number of hits in the chapter - For each chapter of the Bible version, the number of hits in the book is shown.

§         %: (verses in the chapter with a hit) / (verses in chapter) - For each chapter in the Bible version, this shows the percentage of verses in the chapter that contain one or more hits.

§         %: (hits in the chapter) / (hits in version) - For each chapter in the Bible version, this shows the percentage of the total hits in the Bible version occurring in each chapter.

§         %: (verses in the chapter with a hit) / (verses in version) - For each chapter in the Bible version, this shows the percentage of the total number of verses in the version that occur in this chapter of the Bible and also contain a hit.

§         %: (hits in the chapter) / (words in the chapter) - For each chapter in the Bible version, this shows the percentage of words in the chapter that are in a hit. This is only valid if the query describes single-word hits (hits that have no more than one word). For queries where a hit may have more than one word, this view is not valid.

§         %: (hits in the chapter) / (words in the version) - For each chapter in the Bible version, this shows the percentage of the total number of words in the Bible version that are in a hit occurring in the book. This is valid only if the query describes single-word hits (hits that have no more than one word). For queries where a hit may have more than one word, this view is not valid.

When the Detail Level is Verse, these options are visible:

§         # hits in verse - For each verse in the Bible version, this option shows the total number of hits in each verse.

§         % hits in verse / words in book  - For each verse in the Bible version, this shows the percentage of hits in the verse that are in a hit compared to the words in the book. This is only valid if the query describes single-word hits (hits that have no more than one word). For queries where a hit may have more than one word, this view is not valid.

Sort Books

This dropdown box allows you to specify the sorting order of the data. The data can be sorted according to regular book name order, according to ascending statistics values, according to descending statistics values, or according to a custom book ordering.

You can customize the order in which books of the Bible versions are displayed in the Search Statistics Tab. Keep in mind that you can also change the normal sort order of any single Bible version in the Options Window. The Search Statistics Tab uses the sort order specified in the Tools | Options | Bible Versions | Book Order as the normal book order.

When you select [Edit Custom] from the Sort books dropdown, the Customize Book Order for Graphs Window will open up. Using the options in this window you can create up to four custom book orderings for the Search Statistics Tab. In the Short menu name field, you enter the title for the custom ordering. This title will appear in the Sort books by dropdown. The Sort order field is where you specify the book ordering. You must use the standard three-letter book names (see Book Name Abbreviations for more information). Not all books in the Bible version have to be entered in these fields. Books that are not listed in this field will be automatically added to the end of the ordering, appearing in the standard sort order for Bible books.

Options Button

The Options Button contains the following menu items.

§         Graph Options. The Graph Options menu item contains the following submenu items:

Show Zeros. When selected, the graph will also show the chapters, books, or verses that do not contain a search hit.

Swap Axis. Displays book names across the horizontal axis, instead of the vertical axis.

Make Fit. If the search returns more books than will fit into the window, this option condenses the results graph so that the entire graph of results fits into the window. When the window is resized, the graph automatically will shrink or grow to fill the window. When this option is off, the graph is displayed using the Search Window font and a vertical scroll bar appears allowing you to scroll through the graph.

Filter zeros using Search Window limits. This option limits the results displayed to the ranges specified in the Search Window search limits. See Setting Search Limits for more information.

§         Detail Level. The Detail Level menu item contains the options of showing the search statistics according to Book, Chapter, or Verse.

§         Export Graph. The Export Graph menu item contains the following options:

Export List to File. This option saves the displayed statistics as an ASCII text file. This data can be read by a spreadsheet program or word processor. To export the other statistics, select the statistics to be saved in the What to Plot dropdown (see above), and then select this option.

Copy List to Clipboard. This option copies the displayed statistics as ASCII text to the clipboard.

Copy Graph to Clipboard. This option copies the entire graph to the clipboard as an image file. This graphic can be pasted into the BibleWorks editor or a word processing program.

Print Graph. This option prints the visible portion of the results graph. To print the entire graph, first select the Graphics Options | Make fit, and then select this option.

§         New Window. This option opens the Search Statistics Tab in a new window. The window is resizable. You can have multiple new windows. Opening new Search Statistics windows enables you to compare the search statistics side-by-side with the original Search Statistics Tab or a new Search Statistics Window.