Instructions for Using Eureka!

Eureka! can search any plain text file (all the text files in the Thesaurus Musicarum Latinarum [TML], saggi musicali italiani [SMI], Texts on Music in English from the Medieval and Early Modern Eras [TME], and any of the data files in CANTUS) for words or strings arranged in as many as four fields linked by various Boolean operators. The individual "hits" in each text can be displayed in a window or exported to a text file. Each search can in turn be subjected to a sub-search, and any set of files subjected to a search or sub-search can be retrieved and searched once again.

To start Eureka!, double click on the icon labeled "Eureka4.exe."

In the "Drives" window, choose the drive containing the files you wish to search (this will normally be the D drive if you are searching the CHMTL CD-ROM), and all the available files and directories will appear in the window immediately below. To open a folder in the window, click on the +; to close it, click on the -.

To place folders or files for searching in the "File Set" window, highlight the folder or file and click the "Add File(s)" button. Double-clicking the folder or file will automatically add it to the "File Set" window.

If you want to be able to stop a search before it has been completed, click in the "Enable Stop" box and a check mark will appear. Clicking a second time will remove the check mark.

Enter a search term or string in the first term box. If the search should be case-sensitive, click in the "case" box. If the string should be regarded as a complete word, click in the "word" box (e.g., if you wished to find only instances of "breves" and not "semibreves," you would enter "breves" as your term and click the "word" box). If the search should identify only files that do not contain the string, click in the "not" box to the left of the first term box.

If your search should include two terms or strings, select the appropriate operator ("or" or "and") from the drop-down menu in the next box. Selecting an operator will cause the next term box to become active. If this second entry should be a term or string that does not appear in a file in which the first term or string appears (or does not appear, if you have checked "not" to the left of the first term box), click in the "not" box to the left of the second term box. If the operator "and" is selected, this will create a search that will identify only files that have (or do not have, if you have checked "not" to the left of the first term box) the first term or string but do not have the second; if the operator "or" is selected, the search will identify files that have (or do not have, if you have checked "not" to the left of the first term box) the first term or string or do not have the second.

By activating the second and third "and" or "or" operators, third and fourth terms or strings may be added to the search.

It is also possible for Eureka! to find terms or strings in a defined proximity to one another. In this case, the first term or string is entered in the first term box, the middle operator is set to "nearby" (which will disable the other operators and term boxes), and a defined number of lines is selected from the "Within" box (in general, a line in a plain text file contains no more than eighty characters). Here again, it is possible to define either or both strings with case-sensitivity and as whole words by clicking the appropriate boxes.

When the search is ready to run, click the "Search" button. Or, to clear all the term boxes, click the "Clear Terms" button. If "Enable Stop" has been checked, the "Search" button will change to "Stop" once the search has been initiated.

As the files are searched, their names will appear briefly at the bottom of the Eureka! window, and as files with the defined combination of terms or strings are found, their names will appear in the "File Set" box. When the search is completed, either double click on the first file or select it and click on the "View File" button; this will cause the file to be displayed in the large window below the search terms. Clicking the "Next Hit" button will cause each hit to be highlighted and displayed in sequence in the window; clicking the "Prev Hit" button will reverse the process. Both buttons cycle continuously throughout all the files displayed in the "File Set" window.

If you wish to do a sub-search on the files found in the first search, simply enter a new set of terms or strings, and click "Search." This process can be repeated over and over. To return to a previous set of found files, click the "Prev" button; to return to a subsequent set, click the "Next" button. The "First" button will return to the original set on which the first search was performed; the "Last" button will return to the most recent set.

The hits identified in a search can be exported to a text file by clicking on the "Export" button. To export a set of hits, select any or all of the files in the "File Set" window (this set of files must, of course, have been searched), click the "Export" button, select the number of lines of context surrounding each hit, select a name for the file, select a place where the file should be saved by clicking on the "Browse..." button, click "Save," and then click "OK." The export file will list the name of each file, the search pattern, and the number of lines of context, followed by each hit separated by a dashed line. As a plain text file, the export file can be opened by any word processor.


Eureka! has been tested on Windows98, NT, 2000, XP, and Vista, but the Center for the History of Music Theory and Literature (CHMTL) assumes no responsibility for the performance or suitability of the product. If the copy of the program supplied by the CHMTL is defective, it will be replaced with a new copy, but no refunds can be given. The CHMTL shall not be responsible for any direct, indirect, consequential, or incidental damages arising out of the use, the result of use, or inability to use this product. No warranties whatsoever are expressed or implied.
Return to CHMTL Home Page