home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / graf / digiplot.zip / DIGIPLOT.TXT < prev   
Text File  |  1990-08-31  |  10KB  |  216 lines
  1.                                     DIGIPLOT
  2.                                    Version 1.0
  3.                                 Alexander Walter
  4.  
  5.  
  6. 1.     Introduction and Summary of Capabilities
  7.  
  8.        DIGIPLOT is a tool to digitize curves using a Hewlett-Packard (or
  9. compatible) plotter. You insert a plot into the plotter bed and calibrate the
  10. corners as prompted by DIGIPLOT. Thereafter, when you move the plotter pen
  11. around your graph using the arrow keys on the plotter itself (pen up, of
  12. course!), DIGIPLOT continuously polls the plotter for its pen position.
  13. DIGIPLOT interpolates, extrapolates, and scales the plotter pen coordinates to
  14. your user coordinates. DIGIPLOT provides a continuous readout of the plotter
  15. (x,y) coordinates and your user (x,y) coordinates.
  16.  
  17.        DIGIPLOT can be used any time you have an (x,y) curve (such as
  18. engineering data, or stock market prices over time) but not the tabular values.
  19. DIGIPLOT will generate the tabular values at any points you like, and save them
  20. to a file. DIGIPLOT will handle curves which are rotated; i.e., the X-axis and
  21. Y-axis are not aligned with the physical edges of the page. Your plots can also
  22. be portrait or landscape, backwards or forwards. DIGIPLOT can handle it!
  23.  
  24.        If you find out later you made a mistake calibrating a curve (say you
  25. missed the decimal point or swapped two digits) DIGIPLOT is smart enough to
  26. allow you to go back and adjust your table of X,Y values without having to redo
  27. the plot!
  28.  
  29.        If you have a family of curves on the same page, DIGIPLOT can reuse the
  30. same calibration data. Or if you have a series of similar plots on different
  31. pages, where the position is slightly different on each page, DIGIPLOT can
  32. position itself during calibration to the corners of the previous plot.
  33.  
  34.  
  35. 2.     Digitizing a New Plot
  36.  
  37.        This section describes the way to set up DIGIPLOT to digitize a new
  38. curve.
  39.  
  40. 2.1.   Calibrating Your Plot
  41.  
  42.        At any point while calibrating your plot, pressing ESC will return you
  43. to the main menu.
  44.  
  45.        You will first be asked to supply a file name. DIGIPLOT will store
  46. calibration data and the X,Y user coordinates in this file.
  47.  
  48.        You then tell DIGIPLOT the orientation of the plot in the plotter bed,
  49. to the nearest 90 degrees, as viewed when facing the front of the plotter. The
  50. valid choices are:
  51.  
  52.        1. Portrait facing forward
  53.        2. Landscape facing left
  54.        3. Portrait facing backward
  55.        4. Landscape facing right
  56.  
  57.        If you have a CGA or better display, the choices will be displayed
  58. graphically. You will see a display similar to this:
  59.  
  60.                                   2:               Y
  61. 1:     Y│                             ┌─────────────
  62.         │                             │
  63.         │                             │
  64.         │                             │
  65.         │                             │
  66.         └────────────                X│
  67.                     X                     
  68.  
  69. 3:      X                         4:                  
  70.         ────────────┐                                │ X
  71.                     │                                │
  72.                     │                                │
  73.                     │                                │
  74.                     │                                │
  75.                     │Y                 ──────────────┘
  76.                                        Y              
  77.  
  78.  
  79.        This represents the four orientations in 90 degree increments. "X" and
  80. "Y" in the graphic above represent the positive X-axis and positive Y-axis. The
  81. numbering of the orientations corresponds to the listing given above.
  82.  
  83.        You then need to go to the lower right-hand corner of your plot.
  84. Depending on how your plot is oriented in the plotter bed, the lower right-hand
  85. corner of the plot may not be in the physical lower-right hand corner as you
  86. look at the plotter. For instance, in orientation 2 shown above, the lower
  87. right corner of the plot is physically located in the lower left corner as it
  88. is oriented in the plotter bed. Pressing ENTER tells DIGIPLOT you are at the
  89. corner. You will then need to enter your user X,Y coordinates for the corner.
  90.  
  91.        DIGIPLOT then prompts you to repeat the calibration process at the upper
  92. left corner. If your user coordinate do not make sense with the orientation you
  93. indicated (e.g., you indicated an orientation of "Portrait facing forward", but
  94. the X-coordinate in the lower right corner is less than the X-coordinate in the
  95. upper left corner) DIGIPLOT will not accept the erroneous calibration.
  96.  
  97.        When calibration is completed, you can then move the plotter pen around
  98. using the arrow keys on the plotter. Alternatively, you can move the plotter
  99. pen around in fixed increments using the arrow keys on the PC keyboard. In
  100. order to write a (X,Y) point to the data file, simply press ENTER. A running
  101. count of how many points have been written is displayed. When you are done
  102. digitizing, press ESC.
  103.  
  104.        At any point while digitizing, you can temporarily escape to DOS by
  105. pressing ALT-D.
  106.  
  107.  
  108. 2.2.   Rotating the Plot
  109.  
  110.        If your plot is rotated (i.e., the X-axis and Y-axis are not parallel to
  111. the physical edges of the page) you can handle this in DIGIPLOT by pressing
  112. ALT-R. Upon doing so, you are given two choices:
  113.  
  114.        1. Over true Lower Left corner of the plot
  115.        2. Over projection of the true Upper Left corner of the plot onto the
  116.           rotated X-axis
  117.  
  118.        The first option informs DIGIPLOT that you are about to calibrate the
  119. exact position of the lower left corner of your plot. Calibration proceeds
  120. similarly to the lower right corner and upper left corner. In general this will
  121. require moving both the horizontal and vertical pen motion keys.
  122.  
  123.        The second option requires you to calibrate the lower left corner by
  124. indicating the projection of the upper left corner onto the X-axis. The
  125. advantage of this method over the first method is that you only need to move
  126. the plotter pen in one coordinate, either horizontally or vertically. DIGIPLOT
  127. will take care of calculating the true lower left corner.
  128.  
  129.  
  130. 2.3.   Changing the Plotter Increment
  131.  
  132.        You can also move the plotter pen by pressing the arrow keys on the PC
  133. keyboard. DIGIPLOT will command the plotter to move from the current position
  134. so that it follows the orientation and any rotation of your plot. The default
  135. plotter increment per keypress is one-tenth the difference between the
  136. upper-left and lower-right user coordinates, in both the X-axis and Y-axis.
  137. This plotter increment can be changed by pressing F1 or F2. Negative increments
  138. will not be accepted.
  139.  
  140.  
  141. 2.4.   Readying for Another Plot
  142.  
  143.        When you are done digitizing a plot, DIGIPLOT will ask whether you have
  144. more plots, giving you the following choices:
  145.  
  146.        1. New graph & new calibration.
  147.        2. New graph & new calibration. Reposition to corners automatically.
  148.           Must have new graph inserted in plotter bed already.
  149.        3. New graph & use previous calibration.
  150.        4. No more graphs to digitize.
  151.  
  152.        The first choice will result in having to recalibrate the lower right
  153. and upper left corners just as was done for the first plot. Make this choice if
  154. your next plot is dissimilar to the first.
  155.  
  156.        The second choice will also result in recalibrating the corners, but the
  157. plotter pen will be moved automatically to the corners of the previous plot.
  158. From there, make any fine adjustments and press ENTER to mark the corner. The
  159. new plot must already be in the plotter bed before making this choice. Make
  160. this choice if your new curve is very similar to the previous (i.e., same X and
  161. Y scales) but is on a different sheet of paper. You can also make this choice
  162. if your new curve is on the same sheet of paper, but uses different scales.
  163.  
  164.        The third choice will use the previous curve's calibration. Make this
  165. choice if you are digitizing a family of curves printed on the same physical
  166. piece of paper.
  167.  
  168.        The fourth choice will return you to the main menu.
  169.  
  170.  
  171. 3.     Correcting Coordinates on an Old Plot
  172.  
  173.        This option will adjust the (X,Y) data points in the file you specify to
  174. a new set of calibration points. Use this if you discover an error in
  175. calibrating the corners after you have digitized a curve. Such an error could
  176. arise from:
  177.  
  178.        -  Wrong user X or Y value inputted at a corner while calibrating
  179.           (transposed digits, wrong decimal place, etc.).
  180.        -  Wrong tick mark on the X or Y axis used when positioning the plotter
  181.           pen.
  182.  
  183.        DIGIPLOT will ask for the input filename. The data in it will be
  184. interpolated, extrapolated, and scaled to fit the new calibration coordinates.
  185. The new data will be written to a new file with the suffix ".NEW". It will
  186. overwrite the file if it already exists. The original data file is kept without
  187. changes.
  188.  
  189.        DIGIPLOT must have the calibration header which it automatically inserts
  190. into the data file. Not that this calibration header provides a convenient
  191. check in case you suspect a corner was miscalibrated.
  192.  
  193.  
  194. 4.     Change the COM Port
  195.  
  196.        This choice allows the COM port to be changed. Invalid choices will be
  197. automatically detected by DIGIPLOT and will not be accepted.
  198.  
  199.  
  200. 5.     Quitting DIGIPLOT
  201.  
  202.        This option will will exit DIGIPLOT and will display the following
  203. message:
  204.  
  205. If you find this shareware product useful, please send
  206. your $20 registration to:
  207.  
  208.      Alexander Walter
  209.      182 ILER Dr.
  210.      Middletown, NJ.  07748
  211.  
  212.      (908) 389-6755  9 AM - 5 PM EDT
  213.      (908) 671-5080  otherwise
  214.  
  215. Free upgrades to those who register.
  216.