40 The Graphical Search Engine (GSE) Reference

 

 

The Query Window

The GSE Menu

The Query Window Button bar

The GSE Status Bar

GSE Mode Buttons

The GSE Word Box Window

The GSE Merge Box Window

 The GSE Ordering and Proximity Box Window

Agreement Windows

An Overview of GSE Agreement Windows

The GSE General Agreement Box Window

The GSE BW Hebrew Agreement Window

The GSE GNT Agreement Window

The GSE BNM Agreement Window

The GSE Robinson GNT Agreement Window

The Query Properties Window

The GSE Query Properties - Description Tab

 The GSE Query Properties - Flags Tab General Settings                                   
Accent and vowel settings

Hebrew/Greek settings

The GSE Query Properties - Punctuation Tab

 


The Query Window

 

This button will open the Graphical Search Engine Query Window. The GSE Query Window is used to create, edit, and run GSE queries. This is the only interface to the Graphical Search Engine. The input for the GSE is displayed and built here. You can open a Query Window in several ways:

 

1.       From the main window of BibleWorks, select Search | Graphical Search Engine, from the main menu.

2.       From the Search Window, click the Tools button below the Command Line, and select Graphical Search Engine from the menu. This will also import the current query displayed on the Command Line into the new GSE Query Window.

3.       From the button bar in the main window of BibleWorks, press the    button.

 

4.       Press the F9 function key on your keyboard.

 

5.       From the GSE Query Window, select File | New from the menu. A New GSE Query Window will open.

 

Purpose

 

The majority of the Query Window is devoted to the main working area (the large white area in the main section of the window). It is here that you build queries, connecting and arranging word boxes, merge boxes, etc. Queries can be quite large and spread out, so the scroll bars on the side and bottom of the Query Window pan across the full contents of the window. Each Query Window also has its own menu, button bar, and status bar (see below for more information).

 

Sometimes, you will be working on several GSE queries at once, or comparing several GSE queries. BibleWorks allows you to open more than one Query Window at a time. You can also save queries to a file and reload them later. These files can also be e-mailed and exchanged with other BibleWorks users. From this window, you can also import existing saved GSE queries, and add them to the current query. Finally, the Query Window supports standard clipboard operations, so you can select, cut, copy, and paste portions of a GSE query.

 

For a thorough understanding of how to use the GSE, we suggest that you read An Overview of the Graphical Search Engine.

 

See also:

The GSE Menu bar and Button bar

The GSE Status Bar


The GSE Menu

The Query Window has a Menu Bar across the top of the window. It can be used to build, initiate and edit GSE searches. The Menu functions provided are as follows:

 

File Menu

New, Open, Save - Opens a new GSE window with a new query.

Save As - Opens, saves, and renames a query file.

Load into existing query - Opens an existing, saved query and loads it into the current GSE window without clearing the current contents of the window. This allows you to merge multiple queries, or to reuse parts of existing queries.

Save Verse to File - Saves the Search Window Verse List to a verse list (VLS) file so it can be used in other GSE searches.

Print - Prints the contents of the current window. The borders of the window define the bounds of the image to be printed.

Exit - Closes the query window.

Edit Menu

Copy - Copies the selected items in the GSE window to the clipboard.

Cut - Cuts the selected items in the GSE window to the clipboard.

Paste - Pastes the current contents of the clipboard into the GSE window.

Delete - Deletes the selected items in the GSE window.

Select All - Selects all items in the current GSE window.

Change version of selected objects - Allows user to change the Bible version of all selected items.

Disconnect - Removes connecting links between all selected objects. If two selected word boxes are connected by an ordering link, the ordering box will be deleted.

 

Insert Menu

Word Box, Merge Box, Agreement Box - Inserts a new, empty word/merge/agreement box into the current query window.

Mode Menu

Select - Switches the mouse to Select mode. In this mode, you can move objects in the query window by highlighting them and dragging them. To move a single object, click and drag the object. To move a group of objects, click on an empty part of the window, and drag a surrounding box around the objects to move. More objects can be selected by holding down the <Ctrl> key and clicking on the objects. All selected objects can then be moved. Selected objects can also be disconnected or deleted from the query window (see the | Edit |  menu).

Connect - Switches the mouse to Connect mode. In this mode, you can connect word boxes to a merge box, and word boxes to agreement boxes. If a group of word boxes are selected, dragging a connection to a merge box will allow all of the word boxes to be connected to the merge box (or agreement box) at once. It is important to note that the first object connected to an agreement box is differentiated by a longer dashed line. In queries when disagreement is being specified between three or more objects, this first object is the reference for testing disagreement. For example, if words A, B, C and D are specified for disagreement and A is the first object, then the disagreement test is done by testing disagreement between A and B, A and C, and A and D.

Ordering and proximity - Switches the mouse to Ordering mode. In this mode, you can specify ordering between two word boxes. Note that if multiple words are selected, dragging an ordering connection from them will connect all of the words to the destination word box.

 

View Menu

View - Changes the zoom factor of the query window.

Query Menu

Run - Runs the query. If there are errors in how the query is constructed, the query will not run and a message will pop up indicating the nature of the mistake.

Properties - Displays detailed options (such as punctuation, accents, etc.) for the current query. These options are only applied to the GSE query currently displayed in the window. They do not apply to GSE queries in other Query Windows. For more details on these options, see The Query Properties Window.

Utils Menu

Import Command Line - Opens a new query window and builds a new query using the contents of the Command Line.

Arrange - Rearranges the contents of the query window into an orderly layout.

 

Help Menu

GSE Help - Opens BibleWorks Help

 

The Query Window Button bar


The Query Window Button bar provides much of the same functionality as the GSE Menu, but is accessed by clicking on buttons instead of menus.

 

Opens a new GSE window with a new query.

Saves GSE window to file.

Displays detailed options (such as punctuation, accents, etc.) for the current query. These options are only applied to the GSE query currently displayed in the window. They do not apply to GSE queries in other Query Windows. For more details on these options, see The Query Properties Window. Same as Query | Properties.

Switches the mouse to Select mode. In this mode, you can move objects in the query window by highlighting them and dragging them. To move a single object, click and drag the object. To move a group of objects, click on an empty part of the window, and drag a surrounding box around the objects to move. More objects can be selected by holding down the <Ctrl> key and clicking on the objects. All selected objects can then be moved. Selected objects can also be disconnected or deleted from the query window (see the | Edit |  menu).

Switches the mouse to Connect mode. In this mode, you can connect word boxes to a merge box, and word boxes to agreement boxes. If a group of word boxes are selected, dragging a connection to a merge box will allow all of the word boxes to be connected to the merge box (or agreement box) at once. It is important to note that the first object connected to an agreement box is differentiated by a longer dashed line. In queries when disagreement is being specified between three or more objects, this first object is the reference for testing disagreement. For example, if words A, B, C and D are specified for disagreement and A is the first object, then the disagreement test is done by testing disagreement between A and B, A and C, and A and D.

Switches the mouse to Ordering mode. In this mode, you can specify ordering between two word boxes. Note that if multiple words are selected, dragging an ordering connection from them will connect all of the words to the destination word box.

Inserts a new, empty word box into the current query window.

Inserts a new, empty merge box into the current query window.

Inserts a new, empty agreement box into the current query window.

Runs the query. If there are errors in how the query is constructed, the query will not run and a message will pop up indicating the nature of the mistake.

 


The GSE Status Bar

 

The Query Window Status Bar is located across the bottom of the Query Window.  Indicators in the status bar show the state of different options from the Query Properties window.  Options for case sensitivity, accents, vowels, qere, kethib, cross verse boundaries, and hit highlighting can be quickly toggled from the status bar by double-clicking the appropriate status bar indicator. Active options will be ungrayed. If you double-click on Search lim., for example, the search limits window opens, allowing you to restrict the text to limited areas of the Bible. If the Search lim. indicator is activated (not grayed), then search limits are being used to filter the results. The status indicators are:

 

If this status indicator is active the current search will be case sensitive.

If this status indicator is active the current search will be accent sensitive if accent sensitivity is supported by the database. This flag is not for Hebrew searches. There is a separate flag for Hebrew accents.

If this status indicator is active the search will be vowel point sensitive. This is for Hebrew searches only.

If this status indicator is active Hebrew morphological searches will be accent sensitive.

If this status indicator is active qere readings in Hebrew searches will be ignored.

If this status indicator is active kethib readings in Hebrew searches will be ignored.

If this status indicator is active, limits are set on the current search. Search limits are not saved in query files but are inherited from the Search Window.

If this status indicator is active searches may cross verse boundaries.

If this status indicator is active hit and highlighting data will be collected for searches. This is slower but is necessary if you want results highlighted.


GSE Mode Buttons

 

The GSE Button bar contains three mode buttons. Only one can be selected at a time. The active mode button determines how the mouse is used in the GSE Query Window. The three modes are:

 

Selection Mode - This button activates Selection Mode. When it is active you use the mouse to drag word, merge, ordering and agreement boxes around the screen. You can also double-click on these objects to open up their respective configuration windows.

 

Word Connection Mode - This button activates word connection mode. When this mode is active you use the mouse to draw lines (connections) between word boxes and agreement and merge boxes. Connections between word and merge boxes will be solid black lines. It does not matter what order you connect multiple words in. When you connect word boxes and agreement boxes the lines will be dashed green lines. The first link will be a long dashed line and it specifies the base state with which subsequent connections must agree.

 

Ordering Mode - This button activates ordering mode. When this mode is active you use the mouse to connect words to specify order. When connecting two words, the first word clicked will be required to precede the second word clicked when the search is processed. The line between the two words will be a curved line pointing towards the second word.

 

For more information see An Overview of the Graphical Search Engine.

 


The GSE Word Box Window

 

A GSE word box will be added to the GSE query window when you click on the  button in the GSE button bar. You then use the  tool to connect the word box to other objects. When you double-click on the word box, the Word Box Window will open up. You use it to specify the properties of a word box. The following options are presented:

 

§         Version - Shows the Bible version to be searched by this word box. When you select a Bible version in this control, the fonts will automatically be changed in the rest of the window.

 

§         Show Only Active Display Versions - When checked, this reduces the Bible versions shown in the Version control so that only the versions that have been selected to be shown in the Browse Window are shown in this list.

 

§         Search Method: Word query - Specifies a word/wildcard search. For non-morphological versions, the morphology text entry window is deactivated. To search for any word, enter a "*" under lemma (a "@*" for the morphology is automatically added). For the syntax of wildcards see the section on Command Line Wild Card Searches. For more details on the morphology codes, see the section on Doing Command Line Greek and Hebrew Word Searches.

 

§         << help - For morphology versions, this opens the Morphology Assistant. The Assistant walks you through a series of windows to help you construct complex morphology expressions.

 

§         Search Method: Reference list from disk - Specifies that a verse list from disk is to be used for the word box. In contrast to the Word query method in the previous radio button, this method makes the word box to appear as a list of verse references, with no word string associated with it. These verse lists are created in the Verse List Manager, or by saving the results of a GSE query from BibleWorks Main Window File | Save Verse List option.. Clicking the Browse button allows you to select the file to load.

 

§         Search Method: Inclusion/exclusion list - Specifies that the word box represents any of the words or wildcards listed as inclusions, but not any word listed as an exclusion. The entries in this list may contain wildcards. Any word in the text that matches an inclusion word entry will be a possible hit, unless the word in the text matches an exclusion word entry. Words in the text are first tested against the inclusion words, and then they are tested against the exclusion words.

The Add button lets you add a new inclusion/exclusion word or wildcard to the list. The Remove button removes the highlighted word from the list. The Edit button opens a window for editing the highlighted word in the list. For the syntax of wildcards see Command Line Wild Card Searches. For more details on the morphology codes, see the section on Doing Greek and Hebrew Morphological Searches. The Load IEL lets you load a saved word list from a file. The Save IEL lets you saved the current word list to a file. When you click More>>, a menu with more choices opens. From this menu, you can select Open Word List Manager with current list. This loads the Word List Manager and fills it with the Word List from the Word Box Window. You can do extensive editing and comparison with word lists in the Word List Manager. The More>> menu also lets you select Add Louw-Nida domain. This opens a window from which you can create inclusion/exclusion lists based on semantic domains. Finally, the More>> menu gives you rudimentary ability to manage the IEL list. From here you can select Include all to set all words to be inclusion words. When you select Exclude all, all words are set to be exclusion words. The Invert Inclusion/exclusion... option makes all inclusion words to be exclusion words and changes all exclusion words to be inclusion words. Finally, the Clear all option removes all words from the IEL list. For more powerful editing features for the IEL word list, use the Word List Manager.

 

§         Invert results (NOT) - This tells the search engine to find the verses containing only words that do not meet the word box specification. This flag works in two different ways. The subtleties of this flag are described in Query Processing Phases.

 

§         Case sensitive - Matches are only made for this word box if the case of the word in the text matched the case of the word box strings.

 

§         Suppress highlighting - When this box is checked, highlighting information for this word is not shown when displaying results in the Browse Window. This is useful to prevent highlighting in queries without ordering or agreement when this word box has "Invert results" checked. This option is also useful for searches which result in so many highlighted words that it becomes difficult to isolate the significant parts.

 

§         Exclusion words eliminate entire verse - If the word box is an inclusion/exclusion list and there are exclusion words specified, this option determines how to process the exclusion words. If this option is checked, then if a verse contains a word which matches an exclusion word,  the entire verse will be rejected during the Boolean Operation phases, even if the word box is connected to ordering or agreement boxes. If this box is not checked, then the exclusion words are not tested during the Boolean Operation phases and are only checked during the Verse Test phase. For more details, see Query Processing Phases.

 

§         Match the following spec in - This activates the "brother text" matching feature of the GSE. For Greek and Hebrew Morphology versions and text versions with morphology counterparts, you can now specify a match parameter for the related database. For example if you are searching the GNM (Greek morphology) database, you can also specify matching criteria for the corresponding word in the GNT (we call these "brother" texts). This basically means that you can search not just on the lemma/code doublet, but also the form/lemma/code triplet. Simply enter the extra search string in the extra text box labeled "Match the following spec in ..." If you put nothing in the text box, the search will behave just as before. Most people will have no use for this option, but it has been requested over the years by advanced users.

 

§         Position: Specify position in verse - When checked, this specifies that the word described by the word box must occur at exactly the position specified, either n words from the beginning of the verse or n words from the end of the verse. If 1 is entered, then the word must be the very first word in the verse (if from beginning is selected) or the very last word in the verse (if from end is selected).

 

§         How to apply
 

1.       Normal - This is the normal setting that doesn't alter the processing of the word box.

 

2.       Range filter (all specified words must match and must exist within the verse bounds setting) - This option applies to word boxes which are not connected to merge boxes and preceded and/or followed in ordering by Normal word boxes. It tells the GSE to require this word box to apply to all words in the ordering range. In addition, any agreement conditions attached to this word box must match all of the words in the range. When checked, this word box is not processed in the Boolean Operation phase. When a query uses a range filter word box to describe words that must appear at the very beginning or at the very end of a phrase and you want to insist that the words described by the range filter word box must exist, you use this range filter option. For more details, see Query Processing Phases.

3.       Range filter (all specified words must match IF they are within the verse bounds setting) - This option applies to word boxes which are not connected to merge boxes and preceded and/or followed in ordering by Normal word boxes. It tells the GSE to require this word box to apply to all words in the ordering range. In addition, any agreement conditions attached to this word box must match all of the words in the range. When checked, this word box is not processed in the Boolean Operation phase.  When a query uses a range filter word box to describe a specification that you want to apply to words if they exist within the verse boundaries (depending on the setting of the "cross verse boundaries" option), then you should use this range filter option. For more details, see Query Processing Phases.

4.       Agreement condition - This option applies to word boxes which are not connected to merge boxes, and are preceded and/or followed in ordering by Normal word boxes, and have agreement conditions attached to them. These word boxes tell the GSE to apply the agreement test attached to this word box only if a word matching this word box and its ordering appears in the text. This word box is not processed in the Boolean Operation phase, and does not require a word matching its specification to exist. It only serves as a conditional trigger for the attached agreement tests. For more details, see Query Processing Phases.

Beginning in Version 5, BibleWorks added a new range filter option to the word box that distinguishes between two different ways to handle cases in which a range filter covers words that might fall outside of a verse (e.g. the last verse in the Bible, or words outside of a verse if "Cross verse bounds" is off). The first option requires all words in the filter range to exist and match. The second option only requires any existing words in the range to match. This happens only when filtered words fall outside the verse boundaries (when "Cross verse bounds" is off) or beyond the first or last verse of the Bible.

 

Say, for example, the filter specifies "Apply a range filter to exactly three words before N, requiring none of the words covered to be 'the'."  If the first range filter option is selected, then there must exist three non-"the" words before N. If N is the first word in the verse, and "Cross verse bounds" is not on, then the filter will fail for N since no words exist before N. On the other hand, if the second range filter option is selected, then N will always pass the range filter test if it is the first word of the verse.

 

With this understanding, the Search Method radio buttons in the Word Box Window are not too difficult to understand. The Word Query radio button sets the word box to represent a single word or wildcard. The Inclusion/Exclusion radio button sets the word box to represent one or more words or wildcards in the inclusion list, and requires that the box may not represent the words and wildcards in the exclusion list. For example, we would use an inclusion/exclusion word box if we wanted the word box to represent a word with lemmas A or B, but not C. Finally, the Verse list from disk radio button sets the word box to simply represent a list of verses, loaded from a file on disk. This sort of word box can only be used in normal mode and may not be used in any query requiring phase three operations (the query may not contain ordering or agreement, among other things).

 


The GSE Merge Box Window

A GSE merge box will open when you click on the  button in the GSE button bar. You then use the  tool to connect the merge box to the words that you want to "merge". When you double-click on the merge box, the Merge Box Window will open up. You use it to specify how the merge is to take place.

 

The merge box specifies the logical conditions for determining if a verse has the right words. It is used in the second and third phases of query operation (see Query Processing Phases.  In the second phase, a merge box collects verse lists from all word boxes and merge boxes with an incoming connection arrow. It converts each verse list to the Bible version specified in the target merge box, and it then performs the AND or OR operation to combine the incoming verse lists. If the Invert box is checked, the results are then inverted so that all verses not in the list are included and all verses that were in the list are removed. Finally, if this merge box has an outgoing arrow to another merge box, the resulting verse list is passed to the next merge box.

In the third phase, merge boxes are used to generate the possible match lists. For example, if a query specified all verses where (A or B) occur before (C or D), the query would have three merge boxes (one for the AND and two for the ORs). We would specify that A occurred before C, A occurred before D, B occurred before C, and B occurred before D. Accordingly, the possible match lists would be "A and C", "A and D", "B and C", and "B and D".

When you double click on a merge box, a window with the following options will open:

 

§         How to merge

AND -
Specifies that the input verse lists to the merge box are to be combined into a single verse list consisting of all verses common to all of the lists. During the Verse Test phase, this merge box option represents a Boolean AND when the different word combinations are considered. For more information on the specific phases during query processing, see Query Processing Phases. The option labeled Only require n of the attached word boxes lets you specify that only n word boxes attached to this AND merge box must have matching words in the text of a matching verse. Entering 0 in this option requires that all word boxes attached to this AND merge box must have matching words in the text of a matching verse. This option can be used if you have a list of m words and only want to require that n of the words existing in the text of a matching verse. This option cannot be used with ordering, agreement, and crossing verse boundaries.
OR - Specifies that the input verse lists to the merge box are to be combined into a single verse list consisting of all verses appearing in at least one of the input lists. During the Verse Test phase, this merge box option represents a Boolean OR when the different word combinations are considered. For more information on the specific phases during query processing, see Query Processing Phases

§         Invert results - Tells the GSE to perform a logical NOT on the merge box's final verse list during the Boolean Operation phase.  For more information on the specific phases during query processing, see Query Processing Phases.

§         Make sub-query - Tells the GSE that this merge box and the boxes connected under it (other merge boxes, word boxes, agreement boxes, etc.) form a subquery. This allows you to designate a merge box and all boxes below it as a separate query. The easiest way to understand this is to imagine that a merge box with "Make subquery" checked is disconnected from any merge box above it. This checked merge box can now be viewed as a separate query, with the checked merge box at the top. The resulting tree with the subquery merge box at the top is run as a separate query, and returns a list of verses. This list of verses (along with hit and highlighting information), is then fed back into the original query at the place where the subquery was cut off. For more information on subqueries and the specific phases during query processing, see Query Processing Phases

§         Version - Tells the GSE to convert all input verse lists to the selected version before performing the Boolean operations.

§         Show Only Active Display Versions - When checked, this reduces the Bible versions shown in the Versions control so that only the versions that have been selected to be shown in the Browse Window are shown in this list.

§         Proximity - Tells the GSE the distance in verses that verses must have with each other when performing the Boolean operations. Thus, if the proximity is set to 5, and two verses are being AND-ed together, any two verses within 5 verses of each other would pass the test. A merge box should not have proximity specified if word boxes below it have ordering. This option is processed during the Boolean operation phase. For more information on the specific phases during query processing, see Query Processing Phases


 The GSE Ordering and Proximity Box Window

 

 

 The ordering box specifies the ordering conditions for two word boxes. It can specify that the words represented by the word boxes have exactly n words between them, at least n words between them, at most n words between them, or between n and m words between them. In addition, the ordering box is used to specify that punctuation does or does not occur between two words. The set of characters to be included in the punctuation test can be defined per query.

When you double-click on an ordering box, a window with the following options will open:

§         How many intervening words:

Exactly
- Specifies that exactly N words must appear between the two word boxes connected by this ordering link.
Between - Specifies that between N and M words must appear between the two word boxes connected by this ordering link.
At least - Specifies that at least N words must appear between the two word boxes connected by this ordering link.
At most - Specifies that at most N words may appear between the two word boxes connected by this ordering link.

§         Ignore word order - Specifies that the order between the two connected words does not matter. Only the How many intervening words and Punctuation tests are done.

§         Punctuation: Allow - Does not check for punctuation between the two words.

§         Punctuation: Exclude - Specifies that no punctuation (defined in the query properties window) may occur between the two words.

§         Punctuation: Require - Specifies that punctuation from the punctuation group (defined in the Query Properties Window) must occur between the two words.

§         Punctuation: Custom punctuation - Allows the global punctuation group (see the Query Properties Window to be overridden. If this box is checked, the GSE will do punctuation checking for this ordering box using the punctuation marks typed into this window. Punctuation entered here does not affect other ordering boxes. See the Query Properties Window for more details on punctuation.

 


Agreement Windows

 

An Overview of GSE Agreement Windows  

 

When you click on the  button in the Graphical Search Engine an agreement box is created. You then use the  tool to connect the agreement box to the words you want to agree. To specify the details of the agreement you then can double-click on the agreement box. An Agreement Box Window will open that presents you with the options necessary to specify the agreement terms. The contents of this window will depend on the type of version to which the agreement box is connected. Morphology Versions, for example, require a far more complex agreement context than, say, an English Bible version. The possibilities for Agreement Windows are:

 

§         The GSE General Agreement Box Window

§         The GSE BW Hebrew Agreement Window

§         The GSE GNT Agreement Window

§         The GSE BNM Agreement Window

§         The GSE Robinson GNT Agreement Window

 

The agreement box specifies that all word boxes connected to the agreement box must agree in all fields checked in the agreement box. If you wanted to require that words A and B agree in gender, case, and number, you would connect A and B to a single agreement box, with gender, case, and number checked in the agreement box's window.

Agreement boxes are also used to specify that connected word boxes do not agree. It is important to note that agreement and disagreement are tested against the first word box connected to the agreement box. This first word box is connected by a primary link to the agreement box and is shown by a long dash connection. All other connections to the agreement box are short dash connections (see Example 5). For example, if we want to specify that words A, B, and C disagree in case with word D, the word box for word D must be the first box connected to the agreement box. The word box for word D will be connected to the agreement box by a primary link. The other word boxes will be connected to the agreement box by non-primary links.

There are two forms of disagreement. You can require that all word boxes connected to the agreement box must disagree with the primary word box, or you can require that at least one of the word boxes connected to the agreement box must disagree with the primary word box. The difference between these two forms of disagreement is significant, when there are more than two word boxes connected to the agreement box.

Word boxes can also be connected to more than one agreement box. This allows you to specify agreement between different sets of word boxes. For instance, you can connect a set of word boxes to a single agreement box and specify that they must agree in gender, case, and number. You can then connect some of these word boxes to other word boxes not yet connected and a second agreement box, and specify that these word boxes must agree in lemma.

 

If the Bible version of the word box that the agreement box is connected to is a Greek or Hebrew Morphological version (GNM, BNM, SCM, TIM, BYM, STM, WTM, etc.) you will see a similar box that has been expanded to include check boxes for morphological attributes. The window will be different for each version.

 


The GSE General Agreement Box Window

 

 

The GSE General Agreement Window will open up when you double-click on an agreement box that is connected to a non-morphological version. See An Overview of GSE Agreement Windows  for details.

 

When you click on an agreement box a window will be displayed. The nature of the box will depend on the Bible version of the word box that the agreement box is connected to. If it is a non-Morphological version you will see a window with the following options:

 

§         Compare whole word - Specifies that all word boxes connected to this agreement box must be identical.

 

§         All disagree with first link - Specifies that all word boxes connected to the agreement box must disagree with the first word box. The first word box is recognized by a long dashed connection to the agreement box (in contrast to the short dashed lines connecting the other word boxes). If checked, agreement has to fail for only one of the checked fields. To specify that all fields must disagree, use multiple agreement boxes (one per field) specifying disagreement.

 

§         One or more disagree with first link - Specifies that one or more word boxes connected to the agreement box must disagree with the first word box. The first word box is recognized by a long dashed connection to the agreement box (in contrast to the short dashed lines connecting the other word boxes). If checked, agreement has to fail for only one of the checked fields. To specify that all fields must disagree, use multiple agreement boxes (one per field) specifying disagreement.



The GSE BW Hebrew Agreement Window

 

The GSE BW Hebrew Agreement Window will open up when you double-click on an agreement box that is connected to a WTM or related version. See An Overview of GSE Agreement Windows  for details. The options presented in the GSE BW Hebrew Agreement Window are:

 

§         General: Lemma - Specifies that all word boxes connected to this agreement box must have the same lemma.

§         General: Entire morphology - Specifies that the entire morphology string must be identical.

§         General: Part of speech - Specifies that the part of speech must be identical.

§         General: Checked fields must exist - Specifies that for any fields in the window marked for agreement (such as gender, case, or number), all connected word boxes must agree in these fields and the fields must exist in the morphology of the word in the text. If this option is not selected, then if a field is not present in the morphology or a word, any agreement test against that field succeeds.

§         All disagree with first link - Specifies that all word boxes connected to the agreement box must disagree with the first word box. The first word box is recognized by a long dashed connection to the agreement box (in contrast to the short dashed lines connecting the other word boxes). If checked, agreement has to fail for only one of the checked fields. To specify that all fields must disagree, use multiple agreement boxes (one per field) specifying disagreement.

§         One or more disagree with first link - Specifies that one or more word boxes connected to the agreement box must disagree with the first word box. The first word box is recognized by a long dashed connection to the agreement box (in contrast to the short dashed lines connecting the other word boxes). If checked, agreement has to fail for only one of the checked fields. To specify that all fields must disagree, use multiple agreement boxes (one per field) specifying disagreement.

§         General: Secondary PGN for primary link word - These radio buttons allow you to select how to do agreement matching using the main PGN (person, gender, number) morphology codes and secondary PGN code suffixes in Hebrew. The Replace main PGN radio button lets you choose to treat the secondary PGN codes as if they were the main PGN codes when comparisons are done, thus overriding the main PGN codes. The Include with main PGN radio button treats the secondary PGN codes as if they were main PGN codes in addition to the actual PGN codes. This means a given word would be treated as if it had two sets of main PGN codes when words are compared. The Neither option tells the GSE to treat the secondary PGN codes as secondary PGN codes only and not to use them in comparisons with main PGN codes.

§         This group of options determines how the secondary PGN codes for the primary link word box are treated. The primary link word box is the word box first connected to the agreement box. It is attached by a long-dashed link. The primary link word box is the word box against which each of the other word boxes are tested for agreement. See An Overview of GSE Agreement Windows  for more information.

§         General: Secondary PGN for non-primary link word - These radio buttons are the same as the ones described above, except that they apply to the word boxes that are connected to this agreement box by a non-primary link. The primary link word box is the first word box connected to the agreement box. It is attached by a long-dashed link. The primary link word box is the word box against which each of the other word boxes are tested for agreement. See An Overview of GSE Agreement Windows  for more information.

§         Type-specific fields (Noun, Verb, Adjective, etc.) - These type-specific fields (e.g. Noun: case, Noun: gender, Verb: person, etc.) for each part of speech represent agreement tests to be applied only when the words to be tested are of the marked part of speech. If a box in one of these sections is checked, the condition is tested only if a word is of the same part of speech. For instance, if Verb: person is checked, and a word box connected to the agreement box maps to a noun in the text, the Verb: person test will not be done. On the other hand, in the same query, in the next verse to be tested, the same word box may map to a verb in the text of the verse. In this case, the Verb: person agreement test will be done.

 


The GSE GNT Agreement Window

 

 

The GSE GNT Agreement Window will open up when you double-click on an agreement box that is connected to the Friberg GNM version. See An Overview of GSE Agreement Windows for details. The options presented in the GSE GNT Agreement Window are:

 

§         General: Lemma - Specifies that all word boxes connected to this agreement box must have the same lemma.

§         General: Lemma accented - Same as General: Lemma except that accents are also compared.

§         General: Entire morphology - Specifies that the entire morphology string must be identical.

§         General: Part of speech - Specifies that the part of speech must be identical.

§         General: Checked fields must exist - Specifies that for any fields in the window marked for agreement (such as gender, case, or number), all connected word boxes must agree in these fields and the fields must exist in the morphology of the word in the text. If this option is not selected, then if a field is not present in the morphology or a word, any agreement test against that field succeeds.

§         All disagree with first link - Specifies that all word boxes connected to the agreement box must disagree with the first word box. The first word box is recognized by a long dashed connection to the agreement box (in contrast to the short dashed lines connecting the other word boxes). If checked, agreement has to fail for only one of the checked fields. To specify that all fields must disagree, use multiple agreement boxes (one per field) specifying disagreement.

§         One or more disagree with first link - Specifies that one or more word boxes connected to the agreement box must disagree with the first word box. The first word box is recognized by a long dashed connection to the agreement box (in contrast to the short dashed lines connecting the other word boxes). When this option is checked, agreement has to fail for only one of the checked fields. To specify that all fields must disagree, use multiple agreement boxes (one per field) specifying disagreement.

§         Type-specific fields (Noun, Verb, Adjective, etc.) - These type-specific fields (e.g. Noun: case, Noun: gender, Verb: person, etc.) for each part of speech represent agreement tests to be applied only when the words to be tested are of the marked part of speech. If a box in one of these sections is checked, the condition is tested only if a word is of the same part of speech. For instance, if Verb: person is checked, and a word box connected to the agreement box maps to a noun in the text, the Verb: person test will not be done. On the other hand, in the same query, in the next verse to be tested, the same word box may map to a verb in the text of the verse. In this case, the Verb: person agreement test will be done.

 


The GSE BNM Agreement Window

 

The BNM Agreement Window will open up when you double-click on an agreement box that is connected to the BNM, or a related version. See An Overview of GSE Agreement Windows for details. The options presented in the GSE BNM Agreement Window are:

 

§         General: Lemma - Specifies that all word boxes connected to this agreement box must have the same lemma.

§         General: Lemma accented - Same as General: Lemma except that accents are also compared.

§         General: Entire morphology - Specifies that the entire morphology string must be identical.

§         General: Part of speech - Specifies that the part of speech must be identical.

§         General: Checked fields must exist - Specifies that for any fields in the window marked for agreement (such as gender, case, or number), all connected word boxes must agree in these fields and the fields must exist in the morphology of the word in the text. If this option is not selected, then if a field is not present in the morphology or a word, any agreement test against that field succeeds.

§         All disagree with first link - Specifies that all word boxes connected to the agreement box must disagree with the first word box. The first word box is recognized by a long dashed connection to the agreement box (in contrast to the short dashed lines connecting the other word boxes). If checked, agreement has to fail for only one of the checked fields. To specify that all fields must disagree, use multiple agreement boxes (one per field) specifying disagreement.

§         One or more disagree with first link - Specifies that one or more word boxes connected to the agreement box must disagree with the first word box. The first word box is recognized by a long dashed connection to the agreement box (in contrast to the short dashed lines connecting the other word boxes). If checked, agreement has to fail for only one of the checked fields. To specify that all fields must disagree, use multiple agreement boxes (one per field) specifying disagreement.

§         Type-specific fields (Noun, Verb, Adjective, etc.) - These type-specific fields (e.g. Noun: case, Noun: gender, Verb: person) for each part of speech represent agreement tests to be applied only when the words to be tested are of the marked part of speech. If a box in one of these sections is checked, the condition is tested only if a word is of the same part of speech. For instance, if Verb: person is checked, and a word box connected to the agreement box maps to a noun in the text, the Verb: person test will not be done. On the other hand, in the same query, in the next verse to be tested, the same word box may map to a verb in the text of the verse. In this case, Verb: person agreement will be tested.

 


The GSE Robinson GNT Agreement Window

 

The Robinson GNT Agreement Window will open when you double-click on an agreement box that is connected to a BYM, SCM, TIM, or STM version. See An Overview of GSE Agreement Windows for details. The options presented in the GSE Robinson GNT Agreement Window are:

 

§         General: Lemma - Specifies that all word boxes connected to this agreement box must have the same lemma.

§         General: Lemma accented - Same as General: Lemma except that accents are also compared.

§         General: Entire morphology - Specifies that the entire morphology string must be identical.

§         General: Part of speech - Specifies that the part of speech must be identical.

§         General: Checked fields must exist - Specifies that for any fields in the window marked for agreement (such as gender, case, or number), all connected word boxes must agree in these fields and the fields must exist in the morphology of the word in the text. If this option is not selected, then if a field is not present in the morphology or a word, any agreement test against that field succeeds.

§         All disagree with first link - Specifies that all word boxes connected to the agreement box must disagree with the first word box. The first word box is recognized by a long dashed connection to the agreement box (in contrast to the short dashed lines connecting the other word boxes). If checked, agreement has to fail for only one of the checked fields. To specify that all fields must disagree, use multiple agreement boxes (one per field) specifying disagreement.

§         One or more disagree with first link - Specifies that one or more word boxes connected to the agreement box must disagree with the first word box. The first word box is recognized by a long dashed connection to the agreement box (in contrast to the short dashed lines connecting the other word boxes). If checked, agreement has to fail for only one of the checked fields. To specify that all fields must disagree, use multiple agreement boxes (one per field) specifying disagreement.

§         Type-specific fields (Noun, Verb, Adjective, etc.) - These type-specific fields (e.g. Noun: case, Noun: gender, Verb: person) for each part of speech represent agreement tests to be applied only when the words to be tested are of the marked part of speech. If a box in one of these sections is checked, the condition is tested only if a word is of the same part of speech. For instance, if Verb: person is checked, and a word box connected to the agreement box maps to a noun in the text, the Verb: person test will not be done. On the other hand, in the same query, in the next verse to be tested, the same word box may map to a verb in the text of the verse. In this case, Verb: person agreement will be tested.

 


The Query Properties Window

 

The Query Properties Window is opened by pressing the  button on the GSE button bar, or by selecting the menu option Query | Properties. In this window, you can set properties and options for the current GSE query. These options are set only for the GSE query that is currently open and are saved with the query when the query is saved to a file. Each GSE query may have different option settings.

 

The options for a GSE query are divided into several tabs:

 

The Description Tab

The Flags Tab

The Punctuation Groups Tab

 

The GSE Query Properties - Description Tab

 

The Query Properties Description Tab allows you to customize your query. You can add a title and short description that will be saved with the other search parameters. The Options are as follows:

 

§         Title - The user-defined title for the query

§         Summary - Allows the user to type in a title and paragraph description of the query.

 

 The GSE Query Properties - Flags Tab

 

§         Do highlights and always compute hits & word counts - Always compute highlighting information for the Browse Window and count number of hits (which may be more than number of verses). This forces the GSE to always run the Verse Test phase, which is slower for queries with only Boolean operations. For more information on the specific phases during query processing, see the Query Processing Phases section.

§         Cross verse boundaries - Allows GSE to find hits that span verse boundaries. If this option is off, then all words in a hit must be in the same verse. Note that even if this option is on, the GSE does not cross Psalm chapters and ends of books in phrase searches. In other words, a "hit" will not span two books or Psalm chapters.

§         Extend Strong's numbers to previous words in the phrase - By default, when searching for Strong's numbers in a tagged Bible version, the Strong's number is assigned to the word in the text immediately preceding the Strong's number. But not every word in the text of a given Bible version is followed by a Strong's number. A Bible version may map several words to a single Strong's Number, so you may have several words in the text followed by a single Strong's number. If you want to extend a Strong's number to map to all words that precede it (back to the previous Strong's number), then you should turn on this option.

 

Accent and vowel settings

 

§         Search on Greek accents - Enables accent searching in Greek versions. This requires you to enter accents in your word box specifications.

§         Search on Hebrew vowels - Enables vowel searching in Hebrew versions. This requires you to enter vowels in your word box specifications.

§         Search on WE/EE accents - This option toggles accent searching for Western and Eastern European languages. If you turn accent sensitive searching off, diacritics on letters will be ignored in searches.

§         Search on Hebrew accents - If this option is enabled, extra parsing codes will be added to the WTM database so that you can search for accent information.

 

Hebrew/Greek settings

 

§         Map GNT/BNT to BNM instead of GNM in brother text searches - When using the brother text search in word boxes, this pairs the GNT and BNT to the BNM, instead of mapping them to the GNM.

§         Ignore paragraph marker (*@x*) in Hebrew morph - Ignores the paragraph marker in Hebrew morphology versions. This "erases" *@x* words from the Hebrew morphology text when you are doing the search, so that the GSE will not see the paragraph marker when testing ordering conditions.

§         Search Qere codes - Makes words that are tagged with qere codes visible when searching Hebrew morphology versions. Otherwise, such words are ignored by the GSE when searching the text.

§         Search Kethib codes - Makes words that are tagged with kethib codes visible when searching Hebrew morphology versions. Otherwise, such words are ignored by the GSE when searching the text.

§         Ignore dagesh - Ignores the dagesh in Hebrew versions. This "erases" the dagesh from the Hebrew morphology text when you are doing the search, so that the GSE will not see the dagesh when testing ordering conditions.

 

Save default - Makes settings in the window the default settings for all future query windows (but does not affect query settings for queries loaded from disk).

 

The GSE Query Properties - Punctuation Tab

 

This is where the user can specify the punctuation group for each language. The punctuation group is the punctuation used in the Ordering Box Windows. The default punctuation groups include all legal characters for the language group. In Hebrew versions, you can specify the maqqef ("dash") and sof passuq (end of verse marker) as Hebrew punctuation characters.

 

§         Save default - Makes settings in the window the default settings for all future query windows (but does not affect query settings for queries loaded from disk).

 

§         Reset punc. - Restores all punctuation settings to the default settings.