home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / utility / sm22a.zip / PLOTDATA.HLP < prev    next >
Text File  |  1993-04-23  |  14KB  |  410 lines
  1.     PlotData 1.3: A Plotter with Analysing Data
  2.  
  3.         by Dr. Weiguang Huang
  4.     Dept. Analytical Chemistry, University of New South Wales,
  5.     Kensington, Sydney, NSW 2033, Australia
  6.     E-mail: w.huang@unsw.edu.au
  7.     Phone: 61-2-697-4643, Fax: 61-2-6622835
  8.  
  9.         Copyright (C) 1991-1993
  10.         8 April 1993
  11.  
  12.     Please report any error or suggestion to the author.
  13.  
  14.  
  15.         Contents
  16. 1. Introduction
  17. 2. Shareware, Student and Advanced Versions
  18. 3. Main Menu
  19.     3.1 Read Menu
  20.     3.2 Graph Menu
  21.         3.2.1 Plot
  22.         3.2.2 Zoom
  23.         3.2.3 Crosshairs
  24.         3.2.4 Axes
  25.         3.2.5 Clear
  26.         3.2.6 Text
  27.         3.2.7 Color
  28.     3.3 Enter Menu
  29.     3.4 View Menu
  30.     3.5 Anal Menu
  31.         3.5.1 Differentiate
  32.         3.5.2 Integrate
  33.         3.5.3 Average
  34.         3.5.4 Peak
  35.     3.6 DOS
  36.     3.7 Mode Menu
  37.         3.7.1 Set Monitor Display Mode
  38.         3.7.2 Save
  39.     3.8 Help
  40. 4. Print
  41. 5. Interface
  42.     5.1 With SymbMath
  43.     5.2 With CurFit
  44. 6. References
  45.  
  46.  
  47.         1. Introduction
  48.  
  49.     PlotData is a software package consisting of a plotter with 
  50. data analysis capability.  With PlotData, data can be plotted on the
  51. screen, viewed, edited, analysed, differentiated, integrated,
  52. calculated, and reproduced graphically.  Many sets of data can be
  53. overlapped to solve systems of equations graphically.  Users can
  54. zoom in and out within graphics.  There is an interactive menu
  55. and on-line help in an editable text file.
  56.     It can be interfaced with other software, such as SymbMath 
  57. (a symbolic calculator) or CurFit (separation of overlapping peaks).  
  58. PlotData can read data from these software packages, without any 
  59. modification, in the BAS-100 instrument format and in many other 
  60. data formats.
  61.     If SymbMath is interfaced with PlotData, SymbMath produces 
  62. the data table of functions, and PlotData plots from the table. So
  63. SymbMath seems to plot the functions. This interface can be used to 
  64. solve equations graphically.
  65.     It runs on an IBM-PC under MS-DOS with 100 KByte free memory, 
  66. monitors such as CGA, EGA, or Hercules, and many kinds of printers.
  67.     It has three versions: shareware, student and advanced. Its 
  68. shareware version (Plotd13A.ZIP) is available from the Plot directory 
  69. in SIMTEL20 archives on many anonymous FTP sites (wsmr-simtel20.army.
  70. mil, garbo.uwasa.fi, rana.cc.deakin.oz.au, etc.) or by e-mail from 
  71. listserv@vm1.nodak.edu, listserv@ndsuvm1.bitnet. 
  72.  
  73.         2. Shareware, Student and Advanced Versions
  74.     Please read the document file PlotData.DOC and all *.TXT 
  75. files before running PlotData. You should print them out if you need 
  76. the printed documents. Please follow examples in the document to 
  77. practise.
  78.     Type PlotData on the MS-DOS prompt to run.
  79.     PlotData has three versions: Shareware Version A, Student
  80. Version B and Advanced Version C. 
  81.  
  82. ----------------------------------------------------------------------
  83. Version        Class    Data point        Price
  84.  
  85. Shareware    A    20            US$20 or AU$25
  86. Student        B    100              US$40 or AU$50
  87. Advanced    C    1000            US$60 or AU$75
  88. ----------------------------------------------------------------------
  89. Upgrade        same                50%
  90. ----------------------------------------------------------------------
  91.     Multiple copies discount is less 20% for each
  92. ---------------------------------------------------------------------
  93.  
  94.     Other foreign money is accepted at the current exchange rate.
  95.     You must provide the copy of your license or license number
  96. for upgrades.    
  97.     Non-registered users are granted a limited license to try
  98. the shareware version for a period of two weeks. After the trial
  99. period you are required to register and to pay the registration fee.    
  100. If you send the author your payment by cheque, money order
  101. or bank draft that must be drawn in Australia, you will get the
  102. latest version. If you sign the license (see the LICENSE.TXT file) 
  103. and send it to the author, you will be legal users and get upgrades
  104. on discount. If you write a paper about this software on publication, 
  105. you will get a free upgrade.
  106.     If you have any problem or advice, please feel free to write 
  107. to the author.
  108.  
  109.         3. Main Menu
  110.     PlotData provides an easy-to-use menu, so users only need to
  111. choose a number from the menu. Each menu has its default value. 
  112. Users hit the <RETURN> or <ENTER> key to get the default value. This 
  113. default value is usually 0 (i.e. 0=exit).
  114.     The main menu has the following choices:
  115. 0=exit, 1=read, 2=graph, 3=enter, 4=view, 5=anal, 6=DOS, 7=mode, 8=help
  116.  
  117.         3.1 Read Menu
  118.     This menu reads data from a data file. It has the following 
  119. choices:
  120. 0=exit, 1=x,y, 2=SymbMath, 3=BAS-100, 4=x,y,blank, 5=x,y1,y2,...
  121.     PlotData can read data in these data formats:
  122. 1=x, y
  123. 2=SymbMath
  124. 3=BAS-100
  125. 4=x,y,blank
  126. 5=x,y1,y2,...
  127.  
  128. The format 1=x,y:
  129. -----------------
  130. 1,    1.1
  131. 2,    2.1
  132. 3,    3.1
  133. ------------------
  134.  
  135. The format 2=SymbMath:
  136. -----------------------
  137. string
  138. 1,    1.1
  139. 2,    2.1
  140. 3,    3.1
  141. -----------------------
  142.  
  143. The format 3=BAS-100:
  144. --------------------------
  145. string
  146. :
  147. string
  148. #
  149. 1
  150. 1.1
  151. 2
  152. 2.1
  153. 3
  154. 3.1
  155. *
  156. ---------------------------
  157.  
  158. The format 4=x,y,blank:
  159. ------------------------
  160. 1,    1.1
  161.  
  162. 2,    2.1
  163.  
  164. 3,    3.1
  165. --------------------------
  166.  
  167. The format 5=x,y1,y2,... :
  168. ----------------------------
  169. 1,    1.1,    1.2
  170. 2,    2.1,    2.2
  171. 3,    3.1,    3.2
  172. ------------------------------
  173.  
  174.         3.2 Graph Menu
  175.     The graph menu has the following choices:
  176. 0=exit, 1=plot, 2=zoom, 3=crosshairs, 4=axes, 5=clear, 6=text, 7=color
  177.  
  178.         3.2.1 Plot
  179.     This option plots data. 
  180.     When you are viewing the graphics screen, you will see a
  181. cross somewhere on the screen.  On a new screen it appears in the 
  182. upper-right-hand corner.  This is the crosshairs.  The coordinates of 
  183. the center of the crosshairs are printed at the lower-right-hand 
  184. corner of the screen.  You can move the crosshairs with the cursor 
  185. (arrow) keys.  Try it, and see how the coordinates change.  You can 
  186. change the step lenghth of the crosshairs movements (see Section 3.2.3).
  187.         By using Crosshairs, you can locate a point and/or zoom the graph:
  188.     (1) The crosshairs are useful for locating the intersections 
  189. of curves or points where graphs cross the axes. When users move the 
  190. crosshairs by an arrow key, the crosshairs value in X-Y axes will 
  191. automatically change in 
  192. (x,y) = (xxx, yyy). 
  193.     (2) to zoom the graph:
  194. move the crosshairs to a place which is a corner of a rectangle, 
  195. hit the <Ins> key, move the crosshairs to another place which is 
  196. another corner of the rectangle, and hit the <Del> key. The graph 
  197. within the rectangle will become large.
  198.     There are other two ways to zoom the graph:
  199. (1) hit the <+> key to zoom in or the <-> key to zoom out within 
  200. graphics one step.
  201. (2) go to the Zoom option.
  202.  
  203.     Table 1         Key Function
  204. ------------------------------------------------------------------
  205. Key             Function
  206.  
  207. <-              move left one step
  208. ->              move right one step
  209. Up              move up one step
  210. Down            move down one step
  211. Home            move both left and up one step
  212. Pg Up           move both right and up one step
  213. End             move both left and down one step
  214. Pg Dn           move both right and down one step
  215. -               zoom out one step
  216. +               zoom in one step
  217. Ins             a corner of a rectangle for zooming in
  218. Del             another corner of the rectangle for zooming in
  219. ------------------------------------------------------------------
  220.  
  221.         3.2.2 Zoom
  222.     The graph will zoom to special X-Y axes values that users
  223. provide.
  224.  
  225.         3.2.3 Crosshairs
  226.     Users can change the step lenght of the crosshairs movements
  227. by changing the X-rate or Y-rate value. The default values of X-rate 
  228. and Y-rate are 0.01. The X-rate value of 0.01 means to move the 
  229. crosshairs from the left to the right side (or from right to left) of 
  230. the graph screen by 100 (1/0.01 = 100) steps. The maximum rate is 1. 
  231. The Y-rate value is similar to the X-rate value.
  232.  
  233.         3.2.4 Axes
  234.     This option plots X-Y axes on origin.
  235.  
  236.         3.2.5 Clear
  237.     This option clears the graphics screen only.
  238.  
  239.         3.2.6 Text
  240.     This option tells the program to go to a text mode, and to 
  241. clear all graph and text.
  242.  
  243.         3.2.7 Color
  244.     This option changes the curve color. The default value is 1.
  245.  
  246.  
  247.         3.3 Enter Menu
  248.     Users enter data from keyboard.
  249.  
  250.  
  251.         3.4 View Menu
  252.     Users can view any range of data, e.g. all data points, or 
  253. from 4th data point to 10th data point.
  254.  
  255.  
  256.         3.5 Anal Menu
  257.     The anal menu has the following choices for analysing data:
  258. 0=exit, 1=differentiate, 2=integrate, 3=average, 4=peak
  259.  
  260.         3.5.1 Differentiate
  261.     This option differentiates data and displays a
  262. differentiated curve.
  263.  
  264.         3.5.2 Integrate
  265.     This option integrates data and displays an integrated
  266. curve.
  267.  
  268.         3.5.3 Average
  269.     This option calculates X average and Y average values.
  270.  
  271.         3.5.4 Peak
  272.     This option finds peaks, and outputs the number of peaks, 
  273. and the peak location and height.
  274.  
  275.  
  276.         3.6 DOS
  277.     Users can go to the DOS shell for executing any DOS command
  278. or another program. After execution, type EXIT to return to the main 
  279. menu.
  280.  
  281.         3.7 Mode Menu
  282.     The mode menu has the following choices:
  283. 0=exit, 1=set, 2=save
  284.  
  285.         3.7.1 Set
  286.     This option is to set a monitor display mode. You must set
  287. a suitable mode for your monitor before you plot, otherwise you will 
  288. get ERROR when you plot. The default value is 1.
  289.  
  290.  
  291.     Table 2         Monitor Display Mode
  292. ----------------------------------------------------------
  293. Mode    Monitor                         Resolution
  294.  
  295. 0       text
  296. 1       CGA, EGA, VGA, MCGA             320x200x16
  297. 2       as 1                            640x200x4
  298. 3       Hercules                        720x348x1
  299. 4       PC-M24, M240, M28, M280,        640x400
  300.     M380, M380/c/t, PC6300          
  301. 7       EGA, VGA                        320x200x16
  302. 8       EGA, VGA                        640x200x16
  303. 9       EGA, VGA                        640x350x64
  304. 10      Monochrome, EGA, VGA            640x350x1
  305. 11      MCGA, VGA                       640x480x256
  306. 12      VGA                             640x480x256
  307. 13      VGA                             320x200x256
  308. ------------------------------------------------------------
  309.  
  310. Note that if your monitor is Hercules, you must load the MSHERC.COM
  311. program as a TRS program before you run PlotData, otherwise you will 
  312. get ERROR when you plot.
  313.  
  314.         3.7.2 Save
  315.     This option saves your choice of the monitor display mode into
  316. the PlotData.Ini file. When you run the program next time, it will 
  317. automatically load the choice from the PlotData.Ini file.
  318.  
  319.  
  320.         3.8 Help
  321.     The on-line help displays one screen page each time. Hit any 
  322. key to display the next page, except for <Ctrl>C which interrupts the 
  323. help.
  324.         
  325.  
  326.         4. Print
  327.     Press the <Print Screen> key to print the graph on a printer.
  328.  
  329.  
  330.         5. Interface
  331.     PlotData can be interfaced with many software, e.g. SymbMath,
  332. CurFit, etc.
  333.  
  334.         5.1  With SymbMath
  335.     The SymbMath software is a symbolic calculator.
  336.  
  337. ---------------------------------------------------------------------
  338. # The plot function package plot.sm
  339. # plot(x^2, x)        # plot the function of x^2
  340. # plot(x^2, x,-6,6)    # plot the function of x^2 from x=-6 to x=6
  341. # end
  342.  
  343. output=off
  344. plot(y_,x_,x1_,x2_,dx_) := block(openfile('symbmath.out'),
  345.     table(y,x,x1,x2,dx),
  346.     closefile('symbmath.out'),
  347.     system(plotdata))
  348. plot(y_,x_,x1_,x2_) := plot(y,x,x1,x2,(x2-x1)*0.5)
  349. plot(y_,x_) := plot(y,x,-5,5,0.5)
  350. output=on
  351. end
  352. ----------------------------------------------------------------------
  353.  
  354.     If SymbMath is interfaced with the software PlotData, SymbMath 
  355. produces the data table of functions, and PlotData plots from the 
  356. table. So SymbMath seems to plot the function. This interface can be 
  357. used to solve equations graphically.
  358.     In the plot package 'plot.sm' the funcion
  359.         plot(y, x, x1, x2, dx)
  360. first open a file 'SymbMath.Out' for writing, then write the data table 
  361. of the function y into the file 'SymbMath.out', then close the file, 
  362. and finally automatically call the software PlotData to plot. After it 
  363. exits from PlotData, it automatically return to SymbMath.
  364.     The functions
  365.         plot(y, x)
  366.         plot(y, x from xmin to xmax)
  367. call the function plot(y,x,x1,x2,dx)
  368.     e.g. plot x^2.
  369.     Input:
  370. plot(x^2, x)
  371. end
  372.  
  373. in the software PlotData, just select the option to read the file 
  374. 'SymbMath.out' and to plot. PlotData read the data in the SymbMath 
  375. format without any modification (and in many data format). 
  376.     In PlotData, 
  377. in the main menu:
  378. 1 <Enter>
  379. in the read menu:
  380. 2 <Enter>
  381. <Enter>
  382. in the main menu:
  383. 2 <Enter>
  384. in the graph menu:
  385. 1 <Enter>
  386.  
  387. where <Enter> is the <Enter> key.
  388. Refer to PlotData for detail.
  389.     Note that if your monitor is Hercules, you must load the 
  390. MSHERC.COM program as a TRS program before you run PlotData. 
  391. Otherwise you will get Error when you plot.
  392.  
  393.         5.2 With CurFit
  394.     The CurFit software is to separate overlapping peaks into
  395. individual peaks. If PlotData is interfaced with the CurFit software,
  396. it can display overlapping and individual peaks.
  397.  
  398.  
  399.         6. References
  400. [1] Huang, W., Proceedings of the workshop on symbolic and numeric 
  401.     computation, Helsinki University, Finland, 1991, p 185-186.
  402. [2] Huang, W., Int. J. Math. Educ. Sci. Tech., 1992, 23(1), 160-165.
  403. [3] Microbit, IEEE Micro, 1992, 12(1), 76.
  404. [4] Microbit, IEEE Micro, 1992, 12(3), 80.
  405. [5] Huang, W., Abs. Amer. Math. Soc., 1992, 13(3), 343-344.
  406. [6] Huang, W., Abs. Amer. Math. Soc., 1992, 13(5), in press.
  407. [7] Huang, W., Abs. Amer. Math. Soc., 1992, 13(6), in press.
  408. [8] Huang, W., SIGSMALL/PC Notes, 1992, 18(1&2), 63-64.
  409. [9] Long, G., Australian PC World, 1992, June, 117-119.
  410.