home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 200-299 / ff290.lzh / DPlot / ReadMe < prev    next >
Text File  |  1989-12-11  |  7KB  |  143 lines
  1.  
  2.     Some years ago I made an attempt to divert Amiga's
  3. graphics-support to a signal-processing environment. My first objective
  4. was a simple display for experimental data satisfying the following:
  5.  
  6.     (i) "Paging" through lots of data
  7.     (ii) Comfortable scaling and presentation.
  8.  
  9. This piece of code represents an improvement of the program on disk 243.
  10. It is considered to be Freeware in the usual sense.
  11. This revision includes:
  12.  
  13.     - A better filerequester (not 100% yet)
  14.     - A rastportdump
  15.     - Vertical "soft" scroll
  16.     - Gadgets in double menu requester
  17.     - "Soft" compress and expand of the data
  18.     - Customisation of the datawindow
  19.  
  20. This version is intended to become the basis for further developments
  21. using the complex plane, FFT, filtering and systemdynamics. It has been
  22. developed under WB1.3 on an A2000. It should work with all Amiga-
  23. models. If certain routines are not 100% compatible with older WB-versions,
  24. they surely will constitute minor deficiencies with respect to the overall
  25. behaviour of the program since the standard libraries have been used.
  26.  
  27.  
  28.   Any suggestions or information about scientific software on the Amiga
  29. is appreciated. I am particularly interested in a comfortable and
  30. interactive display of theoretical concepts and of experimental data.
  31. What can we learn from the "crash-boom-beng" people in order
  32. to visualize or animate our physical data in a time or configurational
  33. domain.
  34.  
  35.   If you find this program useful and are interested in signalprocessing,
  36. chaos or stochastic processes, send $10 (Europe $8) to:
  37.  
  38.             A.A.Walma
  39.             Ziegelmattenstrasse 5
  40.             7800 FREIBURG
  41.             W-Germany
  42.  
  43. You'll become a registered user and I'll support the use by answering
  44. questions and send you notice of other versions (In Germany you can contact
  45. me under 0761-64832). Bugreports are welcome.
  46.  
  47.     --------------------------------------------------------------------
  48.  
  49.                                DPLOT 2.0
  50.  
  51.                           (c) 1989 Alle Anne Walma
  52.  
  53.  
  54.     The program is started either from CLI by invoking "DPLOT <cr>"
  55. or from the Workbench, where the icons are selfexplanatory. Double
  56. klicking in the main window allows you to change the screen to PAL height.
  57.  
  58.     DPLOT works within an integer-range of 0-10000. This
  59. suffices for the usual 8-Bit and 12-Bit AD converters.
  60. Negative values are accepted (-127/128 for instance) and shown at
  61. a different color in the plotwindow (vertical scale).
  62. Two examples of experimental data are included:
  63.  
  64.     - sound  = A soundtrack from an 8-Bit digitizer as the binary
  65.                    example (100000 data with a sampling rate of ca 28 kHz)
  66.     - eeg    = A sample of a 12-Bit brainwave digitalisation (10500
  67.                    data at a sampling rate of 250 Hz)
  68.  
  69.     The filerequester asks you for the total number of data to be read in.
  70. With "starting index" is meant the first datum in the display (default
  71. is one). If you have lots of data and not so much RAM, you may want to start
  72. at 78000 for instance and put in 90000 for the "total number". RAM is only
  73. needed for 12000 then.
  74. With "redundancy" is meant the number of points you wish to ignore in case
  75. of a very high sampling rate. Two points means that every third point is
  76. taken into account.
  77.  
  78.     NOK (="Not OK") brings you back to the main menu and with OK the first
  79. datasamples are being displayed. The display is "pixeloriented". In
  80. other words, each horizontal pixel represents a sampled value and each
  81. vertical pixel an amplitude-unit. Reading in "eeg" shows what this
  82. means since this signal varies in real amplitude from ca 2000-7000, whereas
  83. the displayheight amounts to 200. You can measure this by rightklicking
  84. the mouse if the cursor is in the displayfield ("klick and move").
  85.  
  86.  
  87. The displayed number, in the title bar left, indicates the degree
  88. of horizontal expansion. One stands for one horizontal pixel per datapoint.
  89. The triangular gadgets at the right of it allow a modification of the
  90. number of pixels per point.
  91.  
  92. With the horizontal arrows you can "page" through the data. A leftklick
  93. on the next gadget changes the window allowing a faster "paging". More
  94. to that, see below. RST means a reset of the data. If they disappear,
  95. the horizontal and even more so the vertical potentiometer may bring
  96. them back. Keeping the left-mouse button pressed and moving the
  97. slider or just  single klicks in the proportional gadgets will make this
  98. clear to you.
  99.  
  100. Other gadgets appear by clicking twice the right mousebutton.
  101. The first two (triangular) gadgets can be used to compress the amplitude
  102. of the data. This  maybe useful for very large amplitudes. More useful
  103. is the next gadget. The data are now centered according to the largest
  104. and smallest available amplitude. All these actions are taken into
  105. account by the value in the titlebar ("klick left on OK and klick
  106. right in the window") indicating the vertical amplitude.
  107.  
  108. With PRT a rastportdump can be made if a printer is connected.
  109. A small requester is fired up. For printers with 8 needles
  110. RDC reduces the picture in size by about a half. NOK allows
  111. a retreat without action.
  112.  
  113. There are a number of ways to reduce the size of the printout.
  114. In the first place there is RDC of course. Going back to the main
  115. window, however, the size of the window can be custimized by
  116. doubleklicking the right mousebutton and changing the windowsize
  117. in the appearing requester. Finally, you may wish to use
  118. preferences (WorkBench 1.3).
  119.  
  120. With MNU you leave the plotwindow and return to the main window.
  121. OK lets the requester disappear.
  122.  
  123. The inactivated gadgets are used in the expanded window where a fast
  124. "paging" becomes possible. To that purpose the two horizontal
  125. bars in the titlebar are klicked with the left mouse-button. De
  126. abovementioned gadgets are now activated and using them, more data
  127. will be  displayed. The more data,the larger the "page" and the faster
  128. you will get an overall picture by means of the horizontal arrows in the
  129. titlebar. If you have 4 fields of data in the window for instance, one klick
  130. shows the next 4*600=2400 data. This can be checked by removing the
  131. gadget (klick on OK) and klicking once with the right mouse-button somewhere
  132. in the display field ("klick and move"). The display in the titlebar
  133. shows you where you are.
  134.  
  135. You can freeze the vertical line somewhere by klicking the
  136. right button one more time. Going back to the plotwindow (activate
  137. horizontal bars in titlebar) shows that the plotted data start at this
  138. chosen position. For an accurate datacut the freezing should be carried out
  139. carefully (no fast moving around and keep the button pressed for a second).
  140.  
  141.  
  142.     --------------------------------------------------------------------
  143.