home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 1 / GoldFishApril1994_CD1.img / d1xx / d199 / snipdemo / readme < prev    next >
Text File  |  1989-03-31  |  6KB  |  157 lines
  1.  
  2.  ************************************************************
  3.  **                                                        **
  4.  **                   S N I P  -  D E M O                  **
  5.  **                                                        **
  6.  ************************************************************
  7.  
  8.         Version 1.23 - demo release, April 1988
  9.      © John A. Hodgson, 1986 all rights reserved.
  10.    This Demo version may be freely distributed.
  11.  
  12.       For Technical support and information, contact:-
  13.  
  14.                    John A. Hodgson,
  15.                    739, Navy Street,
  16.                    Santa Monica,
  17.                    California  90405.
  18.  
  19.                    Tel 213-396-9771
  20.  
  21.  
  22.  To run Snip, boot your Amiga with a 1.2 or later Version of
  23.  Workbench, insert the Snip Disk in your external drive, and
  24.  open the disk Icon.
  25.  
  26.  There are two ways to run Snip:-
  27.  
  28.  1) Click on the Snip Icon
  29.  
  30.  2) From the CLI, type <Snip> followed by a carriage return.
  31.  
  32.  KNOWN BUGS
  33.  
  34.       CONSTANT GADGET
  35.     The Constant Gadget doesn't allow you to edit the value it
  36.  displays. You must completely remove the characters in the
  37.  before entering a new value. ( Use rt-Amiga-X, Delete or
  38.  backspace ).
  39.  
  40.       CONCATENATE AND NORMALIZE
  41.     These routines will `hang' if the result of either operation
  42.  is a channel with more than 16000 data points (I used a SHORT!)
  43.  The problem is fixed in the release version and should work
  44.  with about 1,500,000 points although it would take about 2
  45.  minutes to plot the data.
  46.  
  47.     The Demo version is a few generations old now, mostly due
  48.  to bug fixes and minor changes. One major addition allows you
  49.  to `mark' points indicated by the cursor and save the list of
  50.  marks into an ASCII file. I use it frequently to generate
  51.  spreadsheets using Maxi Plan.
  52.  
  53.     The Demo gives you two `channels' of data to play with.
  54.  Ramps are a very useful way of generating signals (The F1 key
  55.  explains this).
  56.     Use the HELP key and function keys for online help. (There
  57.  is a substantial manual with the complete program).
  58.  
  59.     Many processes are not available in the original display
  60.  window. You must first `capture' a piece of the signal in a
  61.  window of its own. The easiest way to do this is to depress
  62.  the left mouse button over a piece of the signal (ramp) then
  63.  draw the mouse across the signal you wish to captute and
  64.  release the button. The black square highlights the portion
  65.  of data you wish to capture. Click in the square to put the
  66.  data in a window. This operation is basic to SNIP and is
  67.  available in ever]y window. These `Detail Windows' identify
  68.  pieces of the signal which you wish to process. To modify the
  69.  signal, first identify the detail window displaying the
  70.  section of interest then select the process you wish to use
  71.  (eg Sine from the MATH menu). 
  72.  
  73.     'Normalize' a Detail window to several thousand points if
  74.  you want a larger dataset to play with.
  75.  
  76.     Snip can be used for almost any data that can be graphed -
  77.  sound signals, financial data, scientific instrumentation
  78.  signals. It uses the fast floating point arithmetic which
  79.  has an accuracy of approximately 20 bits. Our current efforts
  80.  are directed towards integrating digitizing hardware into
  81.  the program and several vendors are now making progress along
  82.  these paths.
  83.     Upgrades to the program in the forseeable future will
  84.  most likely be through `Custom modules' which we would like
  85.  to call `Snippets' unless anyone has objections. These will
  86.  be programs designed to communicate with Snip and complement
  87.  the built in functions. They will probably not have any
  88.  stand-alone function.
  89.  
  90.     The custom interface is fully documented and users are
  91.  encouraged to develop Snippets for their own use or for
  92.  general distribution.   
  93.  
  94.  Snippets already available and distributed with Snip are:-
  95.  
  96.    An FFT module which accepts any number of data points,
  97.  displays the power spectrum of the signal with an option to
  98.  transfer it into SNIP and also provides a capability to set
  99.  coefficients and perform an Inverse Transform for Fourier
  100.  based filtering. It does 1000 points in about 6 seconds. It
  101.  has been tested from 20 to 10,000 points.
  102.  
  103.    psoundread reads 8 bit binary sound files (dump format).
  104.  This module has been used to read ECG signals digitized from
  105.  PerfectSound. The input capacitors were shorted to get the
  106.  low frequencies. This will of course void any warranty and
  107.  you must watch input levels which may destroy the A/D
  108.  converter. I believe the acceptable levels are 0 - 3volts.
  109.  (many thanks to the folks at Sunrize Industries for help in
  110.  setting this up).
  111.  
  112.    psoundwrite writes binary sound files (dump format)
  113.  
  114.    A third party is writing a sound sampler/replay module. It
  115.  works but GURUS frequently.
  116.  
  117.    Also available as Snippets
  118.  
  119.    ACDA Sampler - uses the ACDA Proto-40K board for data
  120.    acquisition. Samples 1 to 16 channels with 12 bit accuracy
  121.    at maximum rates of 10KHz for 1 channel, 1KHz for 16 channels.
  122.    software selectable gain. Simulates free running oscilloscope
  123.    until sampling requested. Tested up to 100,000 points per
  124.    channel.
  125.  
  126.    SBX311 Sampler - as ACDA Sampler but uses ASDG Twin-X board
  127.    and SBX311 sampler module - 16 channels, 12 bits.
  128.  
  129.  
  130.     If you encounter bugs or have suggestions for improvements,
  131.  please contact me, preferably by completing a report form
  132.  included with your manual. There is an ASCII file in the root
  133.  directory containing a copy of the report form which you can
  134.  print out ( <type > prt: df1:Report> ). Type out both pages,
  135.  leave them attached and when you have completed the form,
  136.  simply fold them together with the printing facing outwards
  137.  fold into 3 with the address on the outside and fasten with a
  138.  piece of adhesive tape. Don't forget to add a stamp - we
  139.  haven't figured how to print them on the Amiga yet!!
  140.  
  141.     Please try to report as much detail as you can about the
  142.  program features you were using when a problem arises. this
  143.  should help to track down bugs.
  144.  
  145.     Also, please feel free to make suggestions for improvements.
  146.  The program was originally developed for a specific application
  147.  but evolved into one which can easily be tailored to many
  148.  applications.
  149.  
  150.    Reading IBM Binary files
  151.  
  152.     The Tools drawer contains a program to read 12 and 16 bit
  153.  binary files in MSDos format. They were written to convert
  154.  files created with the RC Electronics Computerscope and the
  155.  WatSmart systems. The tools drawer has a file which explains
  156.  its use.
  157.