home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / utilities / utilsm / numbergen / !NumberGen / !Help < prev    next >
Text File  |  1995-08-16  |  10KB  |  219 lines
  1.  
  2.  ABOUT THIS PROGRAM
  3.  ---------------------------------------------------------------------------
  4.  Name    : NumberGen
  5.  Version : 1.01 (06 Aug 1995)
  6.  Purpose : Generate random numbers
  7.  Author  : Andrew Berry
  8.  Licence : Freeware. Please see conditions at the end of this file.
  9.  
  10.  
  11.  PURPOSE
  12.  ---------------------------------------------------------------------------
  13.  This program can be used to generate lists of random numbers, either for
  14.  general or statistical use (e.g. random sampling). Although random integers
  15.  can be generated using
  16.  
  17.          FOR loop%=1 T0 10
  18.          PRINT RND(20)
  19.          NEXT loop%
  20.      
  21.  this program offers full control over the range of numbers, the accuracy
  22.  (i.e. the number of decimal places) and the output type.
  23.  
  24.           
  25.  USING THE PROGRAM
  26.  ---------------------------------------------------------------------------
  27.  The main window contains various options which will affect which numbers
  28.  are selected, and also the way in which they will be saved. It is opened by
  29.  clicking on the icon bar icon.
  30.  
  31.  
  32.  SETTING THE RANGE
  33.  ---------------------------------------------------------------------------
  34.  'Number of values' determines the number of random numbers which will be
  35.  generated (sample size). The lower and upper limits are inclusive and are
  36.  used to specify the range within which the numbers will be generated.
  37.  Values can be typed into the first three boxes, or the up/down icons can be
  38.  used to increase or decrease the value in the box by one.
  39.  
  40.      
  41.  GENERAL OPTIONS
  42.  ---------------------------------------------------------------------------
  43.  There are two accuracy settings. Selecting 'Integers only' will only allow
  44.  whole numbers to be generated. Selecting the second option causes numbers
  45.  to be generated to the number of decimal places shown. This can be altered
  46.  using the up/down icons.
  47.  
  48.  'Show percentage hourglass' shows how far the operation has progressed and
  49.  'Display numbers during creation' prints the numbers on screen as they are
  50.  generated. Both these options slow down the creation of the file, the
  51.  second more considerably than the first.
  52.  
  53.  
  54.  OUTPUT TYPE
  55.  ---------------------------------------------------------------------------
  56.  The final option in the main window is used to select the output type. The
  57.  formats are as     follows:
  58.  
  59.     Text : Number followed by a newline character (ASCII 10). This is the
  60.            default format and should be used if you only need to display the
  61.            numbers and not reload them into another program.
  62.  
  63.     Data : As described below. Use this format if you will be loading the
  64.            numbers into a BASIC (or other) program. You will not be able to 
  65.            display the numbers directly on the screen from a data file.
  66.  
  67.     CSV  : Number in quotes followed by CR (&0A). You should be able to load
  68.            this into most databases and other programs to analyse the
  69.            numbers.
  70.  
  71.  
  72.  FILETYPE-SPECIFIC OPTIONS
  73.  ---------------------------------------------------------------------------
  74.  Clicking on 'Create list' or pressing Return in the 'Upper limit' icon will
  75.  open the save window for the save type selected (text, data or CSV). Text
  76.  and CSV have no options, and the file can be saved immediately in the
  77.  normal way.
  78.  
  79.  There are two options which are for data output only. The data can either
  80.  be saved as numbers or strings. If 'Numbers' is selected then all the
  81.  numbers are saved as floating point numbers. Each number is saved using the
  82.  BASIC command PRINT#, and so to display the contents of the file from BASIC
  83.  the following could be used:
  84.  
  85.                 REM open file with handle file%
  86.                 REPEAT
  87.                 INPUT#file%,a
  88.                 PRINT a
  89.                 UNTIL EOF#file%
  90.                 REM close file
  91.  
  92.  You must ensure that floating point variables are used when re-loading data
  93.  files, as any decimal places will be lost if integer variables are used.
  94.  
  95.  If 'Strings' is selected then each number will be converted to a string and
  96.  saved, again using PRINT#. This option is only really suitable if the data
  97.  is to be read into another program for display only. If the numbers will
  98.  be needed in any calculations then the 'Numbers' options should be used.
  99.  The following should be used to display the contents of data files if
  100.  the numbers have been saved as strings:
  101.  
  102.                 REM open file with handle file%
  103.                 REPEAT
  104.                 INPUT#file%,a$
  105.                 PRINT a$
  106.                 UNTIL EOF#file%
  107.                 REM close file
  108.  
  109.  The second option for data output determines whether the number of values
  110.  should be inserted at the start of the file before any data. If this is
  111.  selected then an integer will be inserted as the first data item. This
  112.  should be read so that you know how many values to load.
  113.  
  114.          REM open file with handle file%
  115.          INPUT#file%,values%            _
  116.          DIM a(values%)                  \ 
  117.          FOR loop%=1 TO values%           >  or a$ if using strings
  118.          INPUT#file%,a(loop%)           _/ 
  119.          NEXT loop%
  120.          REM close file
  121.  
  122.  When the data options have been selected the file can be saved in the
  123.  normal way.
  124.  
  125.  
  126.  ESTIMATED SIZE OF OUTPUT FILE
  127.  ---------------------------------------------------------------------------
  128.  Each save window has an icon which shows the maximum size which the file
  129.  will be when created. This is updated when any options are altered.
  130.  
  131.  
  132.  RANDOM NUMBER TABLES
  133.  ---------------------------------------------------------------------------
  134.  Clicking on 'Number tables...' in the main window will bring up a new
  135.  window which is used to create random number tables. These are tables of
  136.  random digits which can be use in statistics. The table is made up of
  137.  a number of ROWS of digits, each consisting of GROUPS of a certain WIDTH.
  138.  These three parameters may be altered in the window by using the arrows
  139.  or entering the values directly into the icon.
  140.  
  141.  
  142.  HISTORY
  143.  ---------------------------------------------------------------------------
  144.  1.00 (14 Jun 1995) : • The first version, fully working. Output as text,
  145.              data or CSV. Integers and 1-9 dp supported.
  146.  ---------------------------------------------------------------------------
  147.  1.01 (06 Aug 1995) : • Moved filetype-specific options into separate save
  148.                         box for each output type
  149.                       • Added routine to create random number tables
  150.                       • Added options to show numbers during creation
  151.                       • Removed 'line terminator' option from text output
  152.  
  153.      
  154.  THINGS TO DO
  155.  ---------------------------------------------------------------------------
  156.  • Add accuracy option for significant figures as well as decimal places
  157.  • Add 'test' routine which will take a large sample of numbers and compare
  158.    the mean with the expected value. This should show up any errors in my
  159.    random number generator!
  160.  
  161.  
  162.  LEGAL BIT
  163.  ---------------------------------------------------------------------------
  164.  This program is Freeware, NOT public domain. This means that I retain the
  165.  copyright but give everyone the right to distribute it by any means,
  166.  anywhere, as long as all files are supplied and I am fully credited.
  167.  
  168.  Although this program has been fully tested, I (the author) cannot be held
  169.  responsible for any loss or damage caused by the use or misuse of this
  170.  program. It is used entirely at your own risk.
  171.  
  172.  
  173.  CONTACT
  174.  ---------------------------------------------------------------------------
  175.  Please feel free to write to me at the address below. Let me know if you
  176.  can think of any ways to improve the program, or if you find any bugs. Any
  177.  donations will be greatly appreciated, and you can obtain the latest
  178.  versions of all my programs by sending either:
  179.  
  180.     a) A cheque for £1.00
  181.  or b) A disc, a first class stamp and a suitable method of returning your
  182.        disc. (If you send me the disc in a Jiffy bag then I can re-use it to
  183.        send the disc back).
  184.  
  185. Currently (13/8/1995) my other programs are as follows:
  186.  
  187.    - DirOpen   1.01 (04 Feb 1995) : Drag directories and apps to icon bar to
  188.                                     open them. Reopen last dir from icon bar
  189.    - DiscComp  1.07 (03 Jun