home *** CD-ROM | disk | FTP | other *** search
/ Collection of Education / collectionofeducationcarat1997.iso / SCIENCE / PTCH_230.ZIP / PATCHIT.DOC < prev    next >
Text File  |  1993-12-16  |  54KB  |  962 lines
  1. Patchit
  2.  
  3. The Manual
  4.  
  5.  
  6. Introduction:
  7.      This manual describes the operation of the Patchit data
  8. acquisition program.  The current revision of this program is 2.30. 
  9. This software and manual are copyright 1993 through 1989 by George
  10. B. Grant, Somerville, MA  02144.
  11.  
  12. Compatibilities:
  13.      Patchit runs on IBM PC compatible computer systems.  It
  14. operates entirely in graphics mode.  As such, it requires a
  15. compatible graphics display adapter.  Patchit supports all major
  16. display adapters (Hercules, CGA, EGA, VGA) and has drivers for
  17. several other graphics display adapters including Super VGA.
  18. Patchit works with a Microsoft compatible mouse.
  19.      Patchit is a data acquisition program.  It therefore requires
  20. a data acquisition card.  Patchit should work with all cards in the
  21. Data Translation DT2821 family (except the DT2829) and in
  22. particular, has been thoroughly tested with both the DT2828 and
  23. DT2821 data acquisition cards.  Patchit also works with both the
  24. Tecmar Labmaster and Labmaster DMA data acquisition cards.   For
  25. configuring these boards, see the appendix at the end of this
  26. manual.  As of this time, these are the only data acquisition
  27. adapters supported by Patchit.
  28.  
  29. Starting Up:
  30.      Patchit runs entirely in graphics (not text) mode.  In order
  31. for it to run, a graphics driver for the graphics adapter that is
  32. installed in the computer must be available in the directory in
  33. which the Patchit executable file is.  These drivers have the file
  34. extension ".bgi".  The drivers required for the following screen
  35. types are as follows:
  36.      Display Adapter                         Display Driver
  37.      Hercules (Hercules Graphics Adapter)         herc.bgi
  38.      CGA (Color Graphics Adapter)            cga.bgi
  39.      EGA (Enhanced Graphics Adapter)              egavga.bgi
  40.      VGA (Video Graphics Adapter)            egavga.bgi
  41.      Super VGA                          svga16m.bgi
  42.           (Supports several common SVGA cards and the VESA standard
  43. SVGA interface)
  44.      IBM 8514 Graphics Adapter                    ibm8514.bgi
  45.      AT&T 400-Line Graphics Adapter               att400.bgi
  46.      3270 PC Graphics Adapter                pc3270
  47.  
  48.      By default, Patchit will automatically try to detect the
  49. proper graphics driver for the computer.  If the proper driver is
  50. not found by Patchit (in the same directory as Patchit) when it is
  51. started it will end with an error message.  Otherwise the program
  52. will start and Patchit's main screen will appear.
  53.  
  54. The Screen:
  55.      Patchit's main screen is divided into three areas.  The menu
  56. bar is on the top of the screen, it allows the user to access all
  57. of Patchit's commands.  The right-most portion of the menu bar
  58. shows the amount of free conventional (real mode) memory available
  59. for Patchit's use.  The lower part of the screen shows the status
  60. line.  This line displays information about the current status of
  61. the program (the amount of data sampled, the current parameter file
  62. and the last data file saved).  The data display area fills the
  63. screen between the menu bar and the status line.
  64.  
  65. Help:
  66.      On-line help is available throughout Patchit.  Just type the
  67. F1 key and a relevant help message will pop up.  The help file
  68. "Patchit.hlp" must be in the same directory as the Patchit
  69. executable file.
  70.  
  71. Accessing the Menus:
  72.      The menu bar has a series of pull down menus.  A menu (e.g.
  73. "File") can be accessed in a number of ways.  1) A menu can be
  74. pulled down by clicking on the desired menu entry with the mouse. 
  75. 2)  A menu can be pulled down by holding down the ALT key while the
  76. selection letter of the desired menu is typed (the selection letter
  77. is usually the first letter of the word and is shown underlined and
  78. in a different color from the rest of that word (unless the current
  79. graphics display only supports two colors, or the color
  80. configuration has been messed with)).  For example, to pull down
  81. the File menu, type ALT-F.  3)  A menu can be pulled down by first
  82. activating the menu bar with the F10 or "/" key.  The file menu
  83. will drop down, but not be selected.  The selection letter of any
  84. of the main menu items can then be typed in order to access that
  85. particular menu.
  86.      Certain functions on the individual menus can be accessed
  87. directly, without pulling down the menus, by typing a hot-key (the
  88. hot-keys are shown to the left of a menu entry, on its menu).  For
  89. instance, the F7 key will cause Patchit to read a parameter file if
  90. pressed when the menu bar is not activated.
  91.  
  92. The Menus:
  93.  
  94. File Menu:
  95. Read Parameter File:  Selecting this option allows the user to load
  96. a new set of parameters into Patchit.  The parameter sets determine
  97. how stimulus will be generated and how data will be recorded. 
  98. Parameters are stored in files called "parameter files".  If there
  99. are parameter files in the current directory, a selection box will
  100. appear listing the available parameter files.  A parameter file may
  101. be cursor selected from this box (with the mouse or keyboard) or
  102. else the name of a parameter file may be typed in (do not type the
  103. ".prm" extension).  To change directories, type the F2 key, or
  104. click the left mouse button in the upper, directory, window and
  105. type the pathname of the desired directory.  The list of parameter
  106. files will be updated for this new directory.
  107.  
  108. Write Parameter File:  Selecting this option allows the user to
  109. store the current parameter set to a parameter file. The name of
  110. the parameter file should be typed without the extension ".prm"
  111. (this is automatically appended by the program).
  112.  
  113. Save Data File:  Selecting this options allows the user to save the
  114. latest set of data that has been recorded.  When the data is saved,
  115. a complete copy of the parameters used to record this data is also
  116. stored along with it.  You must use this option to save the data
  117. that you have just recorded.  If you do not, then the data recorded
  118. by Patchit will be overwritten the next time you acquire data with
  119. Patchit.  The only exception to this is if you have configured
  120. Patchit to record data directly to your disk (see below,
  121. File:Options:Record to Disk).
  122.  
  123. Options:  Selecting this option allows the user to control several
  124. very important aspects of Patchit's operation.  These are:
  125. Record to Disk:  Selecting this toggles the state of this feature. 
  126. When this is enabled, Patchit will store each record as it is
  127. acquired to a disk file.  When you begin sampling data, Patchit
  128. will prompt you for the name of the file into which the data will
  129. be saved.  Prior to writing each record to this disk file, Patchit
  130. will check that there is sufficient disk space available.  You will
  131. be warned if there is not.
  132. Comments in Files:  Selecting this toggles the state of this
  133. feature.  When this is enabled, you will be prompted for a comment
  134. when you save data to a disk file.  The comment can be of any
  135. length and is useful for recording pertinent facts about the data.
  136. Okay:  Selecting this causes any changes that you have made to the
  137. state of these options to be saved.
  138. Cancel:  Selecting this causes any changes that you have made to
  139. the state of these options to be discarded.
  140.  
  141. DOS Shell:  When this is selected the user temporarily exits to DOS
  142. to perform simple commands.  In order to allow this, Patchit
  143. "spawns" a copy of the DOS command interpreter.  Note that Patchit
  144. is still loaded in memory so there will be less DOS memory
  145. available to execute a command.  Type "EXIT" at the DOS command
  146. line ("C:\>") to return to Patchit.
  147.  
  148. About:  When this is selected another the user can find out about
  149. Patchit.
  150. Patchit:  Selecting this causes information about Patchit to
  151. appear.  This information is the current revision level, a
  152. copyright notice and information about its author (me!).
  153. Memory:  Selecting this causes information about the memory on your
  154. computer and Patchit's use of it to appear.  There are three types
  155. of memory used by Patchit.
  156. Conventional Memory:  This is the memory used by all DOS real mode
  157. programs, it is limited to a maximum of 640 Kilobytes (KB). 
  158. Patchit will show you the total amount of conventional memory on