home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 24 / CD_ASCQ_24_0995.iso / dos / educ / cf515 / cf515hlp.hlp (.txt) < prev    next >
Borland Turbo Vision Help  |  1995-07-07  |  12KB  |  198 lines

  1.   Help
  2. Pressing F1 anywhere in the application will bring up the help screen. ESC will exit the help screen. 
  3. Note : Press TAB to highlight(dark blue background) the next help topic(the yellow text below). Then press enter to view it. Or just click on a desired topic with the mouse. 
  4.  INDEX OF TOPICS:
  5.  Creating
  6.  Loading
  7.  Modifying
  8.  Printing
  9. Plots
  10. Printing
  11. Fitted
  12.  Viewing
  13. Plots
  14.  OTHER TOPICS:
  15.  CurveFits
  16. Menus
  17.  Data
  18. reduction
  19.  Importing
  20. Files
  21.  About
  22. CurveFits
  23.   File
  24. Create
  25. Use this option to begin entering data for a NEW data file.  You will first be asked for the name of the data file you wish to create. If a file with that name exists, you will be then notified and asked if you wish to overwrite it or not. 
  26.   File
  27. Use this option to load a pre-existing Curvefits data file. 
  28.   File
  29. Use this option to either: a
  30.  a) Save your newly created data file using File|New
  31.  b) Save your modified Curvefits data file.
  32.   File
  33. Load&Fit
  34. This is an 'express' option. It will load a pre-existing curve fits file, run it through the curve fitting process and then take you to the fit selection dialog. 
  35.   File
  36. Change Directory
  37. Use this to change the current directory of Curvefits 
  38.   File
  39. View Text
  40. Use this option to use the internal file viewer to examine text files.  Useful for examining text data files that you want to import.  Note that the viewer will only display the first 64K of the file. 
  41.   File
  42. Set Printer
  43. This option allows you to choose your printer (either Epson or Laserjet & compatibles) and select the port to print to (LPT1 - LPT9) 
  44.   File
  45. Dos Shell
  46. This option will shell you to the DOS command line. 
  47.   Data
  48. Add Pair
  49. This option allows you to add a data pair to the currently loaded data file. 
  50.   Data
  51. Delete Pair
  52. This option allows you to delete the highlighted data pair from the currently loaded data file. 
  53.   Data
  54. Modify Pair
  55. This option allows you to modify the values of the highlighted data pair 
  56.   Data
  57. Add Loop
  58. This allows the addition of multiple data points to data file.  The program will loop through the data pair addition process until either the Cancel button is selected or the Esc key is pressed. 
  59.   Data
  60. Reduce
  61. This allows you to multiply all the data pairs in a data file by two constants. One for the X value and another for the Y value. This is good for reducing the magnitude of data files that have large values, which tend to overflow the exponential functions. 
  62.   Data
  63. Import Text
  64. You will be asked for the name of the data file you wish to convert, and a formating string for the text file data. 
  65. For numbers you wish to use you will specify the code '%Le' in the format while numbers that are to be ignored will be specified with '%*Le'.  The format string will tell the program what each line in your text file looks like, and therefore how it should be processed. U
  66.  For example, if your text file looks like this :
  67.  1.01232 12.8373
  68.  2.98210 4.87371
  69.  You would use this format string :
  70.  %Le %Le
  71. If there are more than two numbers per line, you can specify which numbers you want to use (realizing of course that CurveFits can only use TWO data points). )
  72.  For a text file that looks like this :
  73.  16.9872E+02  16020202020.2  -1928.34E-02
  74.  123.32323   1.32233  22332.2
  75.  If you wanted to use columns one and three
  76.  use the following format string :
  77.  %Le %*Le %Le
  78.  or if your data appears like this :
  79.  1.4, 2.11
  80.  6.1, 12.32
  81.  use this format string :
  82.   %Le, %Le
  83.  compare this with the previous :
  84.  1.22982 ,    12121
  85.  corresponding format string :
  86.  %Le , %Le
  87. Any amount of consecutive spaces can be reduced to one space but any spacing between commas, numbers etc MUST be noted. You must also use an %Le or %*Le for EVERY number appearing on a line.  
  88. One last more complex example: 
  89.  text file:
  90.  time = 1, velocity = 3, acceleration =  6.82287
  91.  time = 2, velocity = 4, acceleration =  5.28701
  92.  appropriate format string is :
  93.  time = %Le, velocity = %*Le, acceleration = %Le
  94. Also keep in mind that the format string IS case sensitive! 
  95.   Data
  96. Output Text
  97. This will convert the currently loaded data file to a text file. 
  98.   Fits
  99. Perform Fits
  100. This will perform the curve fits on the currently loaded data file. The length of this process depends on the size of the data files. On a PC with an 80386/20Mhz CPU plus an 80387 math coprocessor,  a data file with 100,000 points will take about 17.5 minutes, 1000 points about 8 seconds. 
  101.   Fits
  102. Best Correlation
  103. This will display, in sorted order, the available fits by best correlation. 
  104.   Fits
  105. Best Std Err
  106. This will display, in sorted order, the available fits by standard error. 
  107.   Fits
  108. View Fits
  109. This will bring up the fit selection menu. 
  110.   Fits
  111. Desktop Colors
  112. This allows you to change the default colors of the desktop. 
  113.   Fits
  114. Graph Colors
  115. This allows you to change the default colors in graphics mode. 
  116.   Window
  117. This will move focus to the next window on the desktop. 
  118.   Window
  119. Previous
  120. This will move focus to the previously focused window on the desktop. 
  121.   Window
  122. Close
  123. This will close the currently focused window on the desktop. 
  124.   Exit
  125. Exit the program and return to DOS 
  126.   CurveFits 4.27 Main Menu
  127.    Option:                 CF515 equivalent keystrokes:
  128.  (1) CREATE DATA FILE      Alt-F1
  129.  (2) LOAD/ERASE DATA FILE  F2  ( erasing no longer supported )
  130.  (3) EDIT DATA FILE        F2
  131.  (4) CURVE FIT MENU        F4 Alt-V
  132.  (5) EXIT PROGRAM          Alt-X
  133.   Best Window 
  134. The 'Best' window (either Best Correlation or Best Standard Error) displays the list of available fits in sorted order.  Pressing enter will display the plot of the hilighted fit.  Clicking on a fit will display it also. 
  135. Press enter for more
  136. Help. 
  137.   Data Window 
  138. Press enter for more
  139. Help. M
  140. This is a display of all the data points in the currently loaded data file. 1
  141. The data file can be modified from this window. 
  142.  Enter  - Will allow you to change the values
  143.           of the currently highlighted data
  144.           pair. (Also can be accomplished
  145.           by clicking on a pair with the
  146.           mouse).
  147.  Delete - Will delete the currently highlighted
  148.           data pair.
  149.  Insert - Allows addition of a data pair to
  150.           the file.
  151.   Fit Selection Box
  152. The Fit preceded by the 'R' has the best correlation coefficient while the fit preceded by the '
  153. ' has the best standard error.  Fits that are unavailable will be marked with 'N/A' (Not Available).  This can happen for three reasons: 
  154.  (1) Data has values which would cause
  155.      calculations to have undefined
  156.      results (division by zero,
  157.      logarithms of zero and below etc.)
  158.  (2) Data has caused FPU registers to
  159.      overflow/underflow during the
  160.      calculation of equation coefficients.
  161.  (3) Polynomial fit cannot be used on file
  162.      with less than 4 data points.
  163.      (Use quadratic or linear fit)
  164.   CurveFits v5.15
  165. Curvefits is protected under the copyright laws of the United States. The program is Copyright, 1995 by the author John P. Arkins All rights reserved. D
  166. Curvefits is a curve fitting program written in Borland Pascal 7.0 9
  167. Borland Pascal is a Trademark of Borland International. F
  168.                  SHAREWARE NOTICE
  169.                  -----------------
  170. CurveFits is not in the public domain, it is shareware. If you find this program useful, please register it by sending the $25 registration fee to the below address.  Any comments or suggestions are also welcome.  Thank you very much. m
  171.  Registration : John P. Arkins
  172.                 54 Pearl Street
  173.                 New Hyde Park, NY 11040-3814
  174.  Comments Only:
  175.    Compuserve : 73633,3417
  176.    Internet   : 73633.3417@compuserve.com
  177.   Creating at data file
  178. In order to create a data file, press ALT-F1. You will then be asked for the name of the data file you wish to create. If you specify the name of an existing file you will asked whether you wish to overwrite it or not.  The program will then loop through the data entry process. Enter an X value, press either tab OR enter, enter a Y value and then press enter again as the OK button is now hilighted and will be activated. If a blank or invalid data field is entered the pair will not appear in the data window.  The data entry loop will continue until either ESC is pressed or the Cancel button is selected. 
  179.   Loading the data file
  180. To load an existing CurveFits data file press F2. Enter the name of the data file you wish to load.  The file will now be loaded and a data
  181. window will appear on the desktop.  From here you can either modify
  182. file or run the data through the curve-fitting process by pressing F4. 
  183.   Hard Copy 
  184. Plots can be sent to the printer from the graph screen.  What is currently displayed on the screen is what will be printed. Therefore you should zoom and move about, select the data marking options etc that you desire. Q
  185.  To send the printout to the printer , press E
  186.  while viewing the graph screen.
  187. If you desire a text file listing of the original data along with the fitted values for it, press P when the graph is displayed. This will create a text file with the name '*.prn' where * is a number, 1 or greater.  If 1.prn exists a file 2.prn will be created, and so forth. This can then be printed from the DOS command line by typing a line like: 
  188. C:\>copy 1.prn prn E
  189. For listing of graph screen options press F1 from the graph screen. 
  190.   Viewing data plots 
  191. In order to view a plot of the currently loaded data file, you must perform the curve fitting calculations on the data by pressing F4 or by selecting Perform Fits from the menu bar. After this you can see the fits in either two ways : #
  192. 1) Press Alt-V and bring up the fit selection box. 2) Select 'Fits' from the top menu bar and then either best correlation or best standard error. This will list the fits in appropriate order. Then highlight the fit you wish to see and press enter. You can also click on it with the mouse. 
  193. In order to Import Text files into the program, the companion program CONVERT.EXE must reside in the same directory as CF515.EXE. 
  194. This computer has failed a simple division test known to be performed incorrectly by PC's powered by Intel Pentium chips.  Since this program performs many floatinmg point calculations with the notorious FDIV instruction, the data produced may be suspect. 
  195.   File
  196. Clear Desktop
  197.  Closes all files, windows etc.  Returns program to it's initial state.
  198.