home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / education / b / supergram / Docs / Manual < prev    next >
Text File  |  1993-11-22  |  9KB  |  238 lines
  1. MANUAL
  2.  
  3. This contains a brief description of how to use the evaluation version
  4. of SUPERGRAM II.
  5.  
  6. 1. QUICK START
  7.  
  8. To try the program out without having to wade through the rest of this
  9. file try the following:
  10.  
  11. (1) Run !Supergram and click once on the iconbar icon. Enter your 
  12. full name as the 'Anagram text'. Click on Male if you are male and 
  13. Female otherwise and then click on the big 'Weed' button on the top 
  14. right of the window.
  15.  
  16. (2) When the run is over you will see a list of found anagrams in a big
  17. window. Find ones which could make sense (perhaps after some rearranging
  18. of the words) and double click on them. Select the correct word order,
  19. add punctuation and then click on OK. 
  20.  
  21. (3) When you have selected all the good anagrams press menu anywhere on 
  22. the window and Save the Report out to a filer window, editor or printer
  23. driver!
  24.  
  25. Now for some more detail....
  26.  
  27. 2. RUNNING THE PROGRAM
  28.  
  29. Run the program in the normal way by double clicking on the !Supergram
  30. application. It installs on the iconbar and opens a copyright window
  31. which closes automatically a few seconds later.
  32.  
  33. To do an anagram run click with the left button of the mouse on the
  34. iconbar icon. Supergram is multi-windowed. This means that if you
  35. continue to click on the iconbar icon more windows open and several
  36. anagram runs can be done simultaneously sharing resources. For this
  37. reason the program refuses to let itself be run more than once at
  38. the same time as there is no need to do this.
  39.  
  40. When the window is first open it is in the Input stage.
  41.  
  42. 3. THE STAGES
  43.  
  44. There are four stages during an anagram run. 
  45.  
  46. The first stage is the Input stage where the input text is entered 
  47. and described and options are set to do with the lexicon scan and 
  48. anagram search.
  49.  
  50. The second stage is the Scan stage where the lexicon of words within
  51. the program is consulted to get a list of 'Sub-words'. These are words
  52. composed only of the letters which make up the input text. All multi-word
  53. anagrams are composed only of such words. In addition Supergram 
  54. individually scores each sub-word according to its utility for forming
  55. meaningful and relevant anagrams. If you stop at this stage you can 
  56. manually override the score given by the program for any given word.
  57.  
  58. The third stage is the Search stage where the anagrams are generated.
  59.  
  60. The fourth stage is the Weed stage where the list of found anagrams
  61. is manually searched through. Good anagrams are picked out from the
  62. bad ones, word-orders are selected and punctuation is added.
  63.  
  64. The four stages are controlled by the big buttons on top of the main
  65. window for each run. When you click on one of those big buttons the
  66. program will do just enough work to get to the end of that particular
  67. stage.
  68.  
  69. 4. THE INPUT STAGE
  70.  
  71. The input window is divided up into three sections: Description,
  72. Dictionary and Search.
  73.  
  74.  
  75. 4.1 Description
  76. The Description section allows you to give the program a little
  77. information about the anagram text to help it in producing relevant
  78. anagrams.
  79.  
  80. Click on Male and Female for people and Inanimate otherwise. The
  81. Satire switch is to tell Supergram to try and produce Satirical
  82. anagrams, Flattery is for flattering anagrams and Normal is to 
  83. indicate no particular bias (other than that which already exists
  84. in the English language).
  85.  
  86. Political is to indicate that the text has something to do with
  87. Politics such as a politician, political party etc.
  88.  
  89. Business is to indicate that the text is a company or businessman or
  90. similar.
  91.  
  92. Computer is to indicate that the text is computer related.
  93.  
  94. 4.2 Dictionary
  95. This section controls the scan of the lexicon. 
  96.  
  97. Dropped 'H' words turns on or off use of words such as "'orrible", 
  98. "'ello" etc.
  99.  
  100. Interjections penalises Interjections such as "Wow!" much harder 
  101. than usual when switched off. Interjections are useful for anagrams
  102. as their presence does not affect the grammatical context of anything
  103. that follows them.
  104.  
  105. Shuffle bonus penalises words that are not a good mix of the initial
  106. text stopping trivial anagrams from being considered good.
  107.  
  108. Vulgar words allows or censors coarse or offensive language. When
  109. combined with the Satire flag these words are considered highly
  110. desirable! The licenced editions of this software come with a utility
  111. which can permanently remove this option from the window making the
  112. program more suitable for children. For more information see the file
  113. VERSIONS.
  114.  
  115. 4.3 Search
  116.  
  117. This section controls how the search is done. 
  118.  
  119. Maximum ... minutes sets a time limit on the anagram search and a
  120. sophisticated scheduling algorithm adjusts the search to make it
  121. finish within that time. However, if the search is too tight some
  122. good anagrams may get missed.
  123.  
  124. Score ... or better sets a minimum standard of anagram which should
  125. be generated. All the raw anagrams are assigned a percentage score.
  126. This score is based on the programs understanding of how likely they are 
  127. to make sense and how relevant they are to the initial text. Relevance
  128. is determined by what you have told the program about the initial text.
  129. The higher this lower limit is, the faster the run will go.
  130.  
  131. Maximum ... anagrams sets a limit on the number of raw anagrams that
  132. will be kept. It is a bad idea to set this off unless a high score
  133. limit has also been set as many thousands of anagrams may be generated
  134. and your machine may run out of memory.
  135.  
  136. Maximum ... words is a specialist options that allows you to set a
  137. limit on the number of words in the raw anagrams. For most applications
  138. leave this flag off.
  139.  
  140.  
  141. 5. THE SCAN STAGE
  142.  
  143. During this stage the found sub-words are automatically scored into
  144. one of six categories: Ideal, Excellent, Good, Average, Poor
  145. and Terrible. In addition there is one extra category Superb that
  146. can only be assigned to a word by hand.
  147.  
  148. To override a scoring given by the program (for example if you see
  149. an especially relevant word which has been given a bad score) you
  150. can change it by double clicking on it and then selecting a new
  151. category. If you want to do a good run then this is well worthwhile.
  152.  
  153. 6. THE SEARCH STAGE
  154.  
  155. During the anagram search the found anagrams are displayed in the
  156. top window and various statistics are continuously displayed in the
  157. botton window.
  158.  
  159. The statistics are:
  160.  
  161. Best, Worst and Average are the percentage scores of the best, worst
  162. and mean anagrams currently stored by the program.
  163.  
  164. Time is the amount of computer time used so far. When other programs
  165. or anagram runs are multitasking with it this will be slower than
  166. real time.
  167.  
  168. End is a rolling estimate of the total amount of computer time needed
  169. to finish the search. It can be highly inaccurate but is better than
  170. nothing.
  171.  
  172. Schedule shows whether the program is currently behind or ahead of
  173. the schedule set in the Input stage. If an asterisk is displayed
  174. it means that it has currently lost some anagrams in its attempts
  175. to make up time. Sometimes it catches up again and the asterisk
  176. disappears.
  177.  
  178. Stored is the number of anagrams currently retained by the program.
  179.  
  180. Done is the percentage of the search currently completed.
  181.  
  182. Found is the total number of anagrams that have ever been retained
  183. by the program including those which were stored at one point and
  184. then replaced when new better anagrams were found later.
  185.  
  186. The bottom bar shows a series of snapshots of the search as it
  187. progressses.
  188.  
  189. 7. THE WEED STAGE
  190.  
  191. This stage enables you to scan through the anagrams found by the
  192. program and select the best ones for preserving.
  193.  
  194. The raw anagrams are displayed in the word-order that the program
  195. thinks is most likely to make sense but it is often wrong. Only
  196. one permutation of the words is shown.
  197.  
  198. When you see a good anagram double click with the left button of
  199. the mouse and a window will open allowing you to select a word-order.
  200. When you have done this you can add punctuation and even exchange
  201. a few letters (a check to see that you have not made any errors
  202. is made when you press OK so do not worry about making mistakes).
  203.  
  204. A quicker way is to double click with the right button of the mouse.
  205. That preserves the anagram exactly as it appears.
  206.  
  207. The weeded anagrams appear in the smaller top window. When you save out
  208. the report it is these that are included in the final output.
  209.  
  210. 8. THE MENU O