44 Related Verses Tool (RVT)
The Related Verses Tool (RVT) enables you to find the verses that most closely match the content of a search verse based on the number of words in common between the search verse and other verses in the remainder of the Bible. It can be accessed by selecting Tools/Analyzing the text/Related Verses Tool from the main menu, or by selecting Find Related Verses (RVT) from the Command Line Tools options button menu.
The Related Verses Tool (RVT) Overview
The Related Verses Tool (RVT) searches using the words of your choosing in a specified verse to determine the verses in the remainder of the Bible that most closely match the search verse.
You can choose the particular words that you want to be used to find related verses. By default common words such as prepositions, articles, conjunctions, and pronouns are unchecked in Greek and Hebrew morphology versions, as these words will probably not be significant words for identifying verses that contain similar concepts.
You can double-click on a word to give it extra weight in the search. This enables you to indicate that a particular word is more important for identifying related verses. For searches performed using a Greek or Hebrew morphology version, you can also modify the morphological codes used in the search, or even search on only the codes and not the lemma.
You can also add words to the search that are not in the search verse. You can even include the words from a wordlist. For searches performed using a Greek morphology version you can also insert words from a semantic domain.
The related verses display allows you to view the search results in the version of your choice. The search results can be displayed according to the number of hits or according to book order.
Using the Related Verses Tool
To use the Related Verses Tool to find similar verses, follow these steps:
Step 1 - Select the base verse used to build the search
Enter the verse reference you wish to search in this text box. When you open the RVT the current Browse Window verse is entered by default.
Use this dropdown box to select your preferred search version.
Step 2 - Specify the words for which to search
With the input focus on the verse reference text box, press the RETURN key. This will cause the words in the verse to be loaded into the "search words" list box below. Each word in the verse will appear only once in the display list box, even if the word appears more than once in the verse. Pressing RETURN will also initiate the search with all words checked. You can then examine the results and modify (by unchecking) the words used in the search.
By default common words such as prepositions, articles, conjunctions, and pronouns will be unchecked for Greek and Hebrew morphology versions. In English Bible versions common words (such as “the”, “is”, “of”, etc.) are unchecked. The list of common English words that are unchecked can be edited in the Word List Manager. The appropriate file is named “common-eng.iel” and is located in the BibleWorks 9\init folder. Double-clicking on a word turns the background blue. The blue background indicates that this word will be given greater weight in the search than simply the number of times it appears in the text. The word will be weighted as if it occurred three times in the verse.
Adding a word - you can also add a new word to the list by entering the word in the text box next to the "Add word" label and pressing the RETURN key. The word does not need to be in the search verse.
Editing a word - you can change a word already in the word list by selecting the word and clicking on the "Edit Word" button.
Deleting a Word - to delete a word from the list, select the word, and right click on the word list box. Then choose "Delete selected word" from the context menu.
Adding a Semantic Domain or wordlist
To add a semantic domain wordlist or a word list stored in a file, click on the "Add sem. domain or wordlist" button. This will open a menu with three options.
Convert selected word to LN semantic domain
When you choose this option the word currently selected in the RVT word list will be looked up in the Louw-Nida Sematic Domain dictionary. The corresponding L-N word list will be displayed. You can then add the entire list or select particular words to add.
Add LN semantic domain
This option functions the same way as the first option, except that you do not have to first select a word in the display window. You must navigate the domain list to find the words that you want to add.
The third option, Add wordlist, opens the WLM. You can use the WLM to open or create a word list. Click Close to close the WLM and add the new words in the RVT display window. Be sure to check the check box next to the new word. See the chapter on the Word List Manager (WLM) for help with using the WLM.
Changing morphology display options - if the RVT word list contains a list of words from a morphologically tagged version, you can specify how you want the morphological tags to be used to perform the search. You can specify the full morphological code information be included, or that only the first word of morphological codes be used in the search. You can also choose to search on lemmas only (i.e. exclude morphological codes) or on codes only. To select which of these options you want to choose, right click on the word list and choose the appropriate option.
Step 3 - Find related verses
After loading the words, and adding or modifying words in the search word list, click on the "Find verses" button to run the search. Pressing the RETURN key with the input focus set to the verse reference entry textbox will also initiate the search.
Step 4 - View related verses
By default the search results are listed according to the number of hits per verse. The number of hits is listed in the header above the list of verses. Next to each hit is a check box, followed by the number of hits in brackets.
There are a number of options that can be changed to determine how the results of the RVT search are displayed.
If your searches are resulting in too many hits, the Display threshold dropdown box enables you to trim the search results list to a more manageable size. The default threshold changes depending upon the number of checked words in the display window. The default threshold is 1/3 or less of the checked words in the display window.
The dropdown list box next to the "Display" label enables you to change the search results display version. This enables you to search in one version while displaying the text of the search results in a different version.
Verse List Context Menu
If you right click on the RVT results verse list, a context menu will be displayed. It permits you to set more display configuration options, and also allows you to copy the RVT verse list to the clipboard and to the Main Search Results list box outside the RVT. The options are as follows:
Sort by book order
This option enables you to view the search results in book order. This setting is useful if you wish to find similar verses in a specific book or section of the Bible.
Cross verse boundaries
This option enables the search engine to look for hits across consecutive Bible verses. When this box is checked, the search results will show the number of hits in the first verse, a comma, then the number of hits in the second verse. The search results are listed according to the first of the two consecutive verses.
Select all verses
The first option selects all the verses in the RVT verse list box. It is used with the copy options described below.
Unselect all verses
The second option unchecks all the check boxes in the search results list box. It is used with the copy options described below.
Copy selected verses to Search Window
The option copies the selected verses to the main Search Window where they can be processed or examined by other BibleWorks tools.
Copy selected verses to the Clipboard
This option copies the selected verses to the clipboard. Copying the verses to the clipboard also retains all the headings containing the number of hits in a single verse, plus the number of hits in the verses being copied, and the verse reference. The verses appear in the Bible version specified in the Display text using dropdown box.
If you want to view a particular verse in the related verse list in the main Browse Window, just double click on the verse text (outside the check box).
The Options Button
The Options button opens a menu with additional PMT configuration options.
Search all versions in same language
If this option is selected, the RVT searches all Bible versions sharing the language of the base version. For instance, if the base version is the NAS and this option is checked, all English versions will be searched. If the base version is the BGT and this option is checked, all Greek versions will be searched.
Search all Display versions in same language
If this option is selected, the RVT searches all Bible versions displayed in the main window's Browse Window that share the language of the base version. For instance, if the base version is the NAS and this option is checked, all English versions Displayed in the main window's Browse Window will be searched. If the base version is the BGT and this option is checked, all Greek versions displayed in the main window's Browse Window will be searched. To limit a search to a specific collection of versions, set those versions as Display versions in the main window and check this option.
Cross verse boundaries - this is the same option as provided in the verse list context menu (see above).
Use search limits from main window
If this option is selected, when the RVT searches for verses, the results will be limited by the Search Limits set in the main window.
On startup set search to main Search Window version
If this option is selected, when the RVT opens, both the RVT search and display versions will be set to the current main window search version.
On startup set search auto set to BGM or WTM
If this option is selected, when the RVT opens, the search version will be set to BGM for New Testament and WTM for Old Testament.