home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Science / Science.zip / biprob.zip / probabil.hlp (.txt) < prev    next >
OS/2 Help File  |  1993-10-31  |  21KB  |  514 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Introduction ΓòÉΓòÉΓòÉ
  3.  
  4. This program is a calculator to compute the binomial function as applied to 
  5. probability computations. Binomial calculations are useful in situations where 
  6. there are a number of trials or events with some lesser number of successes. 
  7.  
  8.    Help is available for the following topics... 
  9.  
  10. o Normal calculations. The overall probability of m events being true given n 
  11.      tials, each having a single event probability of p. 
  12. o Inverse calculations. The single event probability given an overall 
  13.      probability of p  with m events being true in  n trials. 
  14.  
  15. General help for operating and installing the Binomial Probabilty calculator is 
  16. available for the following topics. 
  17.  
  18. o General operation 
  19. o Command line options 
  20. o Main program window 
  21. o Menus 
  22. o Key pad 
  23. o Pushbutton controls 
  24. o Installation 
  25. o Misc. and history 
  26.  
  27.  
  28. ΓòÉΓòÉΓòÉ 1.1. Normal calculations. ΓòÉΓòÉΓòÉ
  29.  
  30. When started, the calculator is able to compute several probability values 
  31. based on a number of successes, m , occuring within n attempts or trials, with 
  32. each single event having a probability p of being successful. 
  33.  
  34. Data input for the binomial calculations is by use of 3 data entry boxes near 
  35. the top of the main window. These data input controls are: 
  36.  
  37. Single probability - Input of the individual probability of success, p, 
  38.           expected for each event. 
  39.  
  40.  Sample size-events - Input of the total number of events, n, to be used in the 
  41.           calculation. 
  42.  
  43.  Numb. of successes - Input of the number of successes, m, to be used in the 
  44.           calculation. Note that this number must be less than the sample size. 
  45.  
  46.  The computed probabilities are shown in three output data boxes located under 
  47.  the heading Probability (Answers). The computed outputs are: 
  48.  
  49.  == successes - The probability that exactly m successes were obtained in n 
  50.           attempts. 
  51.  
  52.  <= successes - The probability that m or fewer successes were obtained in n 
  53.           attempts. 
  54.  
  55.  >= successes - The probability that m or more successes were obtained in n 
  56.           attempts. 
  57.  
  58.  When the calculator is operating in its normal mode, the  window's title says: 
  59.  Binomial probability calculator. See calculator operation for further 
  60.  information regarding the operation of the calculator. 
  61.  
  62.  Computation Mathematics 
  63.  
  64.  The basic equation being solved in the program computes the probability of 
  65.  exactly m successes in n trials. This equation is: 
  66.  
  67.  Where 
  68.  
  69.    n = The number of trials or attempts. 
  70.  
  71.    m = The number of sucesses. 
  72.  
  73.    p = The single event probability. 
  74.  
  75.    pm = The probability that exactly m successes will be achieved in n trials. 
  76.  
  77.  This equation is calculated repeatedly to solve the other probabilities 
  78.  presented in the windows, i.e. <= successes and >= successes. 
  79.  
  80.  
  81. ΓòÉΓòÉΓòÉ 1.2. Inverse calculations ΓòÉΓòÉΓòÉ
  82.  
  83. Inverse operation of the calculator is started by either selecting the Mode 
  84. toggle item from the menu or using the Mode toggle push button. When the 
  85. calculator is in inverse operation, the window's title is changed to Inverse 
  86. Binomial Probability, in additon to some other changes in appearance. In 
  87. inverse mode, the calculator takes an overall final probability, p, the sample 
  88. size,  n, and the number of successes, m, to find a single event probability. 
  89.  
  90. The inverse computation is done on one of the following basis: 
  91.  
  92.   1. The number of successes is equal to or less than, <=, the number shown. 
  93.  
  94.   2. The number of successes is equal to or greater than, >=, the number shown. 
  95.  
  96.  Selection of the computation basis is performed by the radio control buttons 
  97.  located to the left of the calculator's key pad. Note that these buttons are 
  98.  shown only when the calculator is operating in the inverse mode. The buttons 
  99.  are labeled <= and >= respectively. 
  100.  
  101.  Data input for the inverse binomial calculations is by use of 3 data entry 
  102.  boxes near the top of the main window. These data input controls are: 
  103.  
  104.  Overall probability - Input of the overall probability of success, p, 
  105.           expected. 
  106.  
  107.  Sample size-events - Input of the total number of events, n, to be used in the 
  108.           calculation. 
  109.  
  110.  Numb. of successes - Input of the number of successes, m, to be used in the 
  111.           calculation. Note that this number must be less than the sample size. 
  112.  
  113.  The result, the single event probability required to fulfill the input 
  114.  conditions, is displayed in single data box in the middle of the calcuator. 
  115.  The label on this control is Single probability. 
  116.  
  117.  See calculator operation for further information regarding the operation of 
  118.  the calculator. 
  119.  
  120.  Computation Mathematics 
  121.  
  122.  The basic equation being solved in the program computes the probability of 
  123.  exactly m successes in n trials. This equation is: 
  124.  
  125.  Where 
  126.  
  127.    n = The number of trials or attempts. 
  128.  
  129.    m = The number of sucesses. 
  130.  
  131.    p = The single event probability. 
  132.  
  133.    pm = The probability that exactly m successes will be achieved in n trials. 
  134.  
  135.  This equation is solved repeatedly to find the single event probability. 
  136.  
  137.  
  138. ΓòÉΓòÉΓòÉ 2. General operation ΓòÉΓòÉΓòÉ
  139.  
  140. Operation of the calculator requires 2 steps: 
  141.  
  142.  o Data entry. Data entry is performed using the 3 data entry controls on the 
  143.           top half of the calculator. Data can be entered from the computer 
  144.           keyboard, the calculator's key pad, or pasting from the clipboard. 
  145.  o Result calculation.  Results are calculated when the Enter pushbutton on the 
  146.           calculator's key pad is selected. 
  147.  
  148.  Other information available on the calculator's operation are: 
  149.  
  150.  o Change character size 
  151.  o Copy data to the clipboard 
  152.  o Paste data from the clipboard 
  153.  
  154.  
  155. ΓòÉΓòÉΓòÉ 2.1. Command line options ΓòÉΓòÉΓòÉ
  156.  
  157. The starting character size of the calculator can be forced to be smaller by 
  158. using a /s or /S on the command line used to start the calculator. 
  159.  
  160. When operating the calculator's character size can be changed by using the 
  161. Options/Font size menu item. 
  162.  
  163.  
  164. ΓòÉΓòÉΓòÉ 2.2. Data entry ΓòÉΓòÉΓòÉ
  165.  
  166. Data entry is performed using the 3 data entry controls on the top half of the 
  167. calculator. The topmost control is used for entry of probability data. The 
  168. second control from the top is used to enter the sample size  data. The third 
  169. control, the last one in the data entry area, is used to enter the number of 
  170. successes. 
  171.  
  172. Selection of the active data entry control can be performed by using one of the 
  173. following methods: 
  174.  
  175.   1. Clicking on the desired data entry control with the left mouse button. 
  176.   2. Using pushbuttons on the calculator's key pad. These buttons are labeled 
  177.           Probability, Events, and Successes. 
  178.   3. Use the Tab or Enter keys on the keyboard to move to the next data entry 
  179.           control. 
  180.  
  181.  The current active data entry control is highlighted by a different (white) 
  182.  background color on the control's label. 
  183.  
  184.  Once the desired active control has been selected, actual data entry can be 
  185.  performed by: 
  186.  
  187.   1. Typing the data from the keyboard. When typing information from the 
  188.           keyboard, the program allows only numeric data to be  entered. 
  189.   2. Using the numeric keys on the calculator's key pad. When using the key 
  190.           pad's keys, any text information that has been selected, shown by 
  191.           reverse video, is deleted before the before the new character is 
  192.           inserted. 
  193.   3. Pasting data from the clipboard. Selecting the Paste option from either 
  194.           the menus or the Paste control button will replace all data in the 
  195.           active data entry window with data currently stored in the clipboard. 
  196.  
  197.  Data limits 
  198.  
  199.  The calculator tests all input data for acceptability before performing any 
  200.  results calculations. If the data is not acceptable, a message box is 
  201.  displayed indicating the type of error that has been found. The data limits 
  202.  for the various inputs are: 
  203.  
  204.  o Probabilities.  All input probabilities must be between the value of 0.0 and 
  205.           1.0. Values equal to 0 or 1 are not acceptable. 
  206.  o Sample size (events). The sample size is an integer value that is greater 
  207.           than 1. The program has a maximum sample size limit of 1,750 to avoid 
  208.           overflow errors. Be aware however, that sample sizes over a few 
  209.           hundred can slow down result calculations. 
  210.  o Successes.  As a general rule, the number of successes must be an integer 
  211.           value greater than 0 and less than the value used for the sample 
  212.           size. Error trapping for this parameter however, is set at less than 
  213.           0 and greater than the sample size. 
  214.  
  215.  
  216. ΓòÉΓòÉΓòÉ 2.3. Result calculation ΓòÉΓòÉΓòÉ
  217.  
  218. The results are calculated by selecting the Enter push button on the 
  219. calculator's key pad. Before performing computations, the calculator tests all 
  220. the input data for acceptability. 
  221.  
  222. If any data entry errors are found, an appropriate error message box is 
  223. displayed, giving the reason for the error. See Data entry for further 
  224. information on the program's data checking capabilities and limits. 
  225.  
  226.  
  227. ΓòÉΓòÉΓòÉ 2.4. Copying data to clipboard ΓòÉΓòÉΓòÉ
  228.  
  229. To copy data to the OS/2 clipboard, perform the following operations: 
  230.  
  231.   1. Select the data entry/display control you wish to copy from by clicking it 
  232.           with the left mouse button. Note the this applies to the controls 
  233.           used for data output in addition to the controls that actually 
  234.           require input data. 
  235.   2. Select the Copy menu item  or the Copy push button to move the data from 
  236.           the selected control to the OS/2 clipboard. 
  237.  
  238.  
  239. ΓòÉΓòÉΓòÉ 2.5. Pasting data from clipboard ΓòÉΓòÉΓòÉ
  240.  
  241. To paste data from the OS/2 clipboard to one of the data entry controls, 
  242. perform the following steps: 
  243.  
  244.   1. Select the input data entry control you wish to paste data to by clicking 
  245.           it with the left mouse button, using a key on the calculators key 
  246.           pad, or using the Enter or Tab key on the computer keyboard. 
  247.   2. Select the Paste menu item  or the Paste push button to move the data from 
  248.           the OS/2 clipboard to the active data entry control. 
  249.  
  250.  Note that when pasting data from the clipboard to a data entry control, ALL of 
  251.  the data in the control is replaced. 
  252.  
  253.  
  254. ΓòÉΓòÉΓòÉ 3. Main program window ΓòÉΓòÉΓòÉ
  255.  
  256. The calculator's main window consists of: 
  257.  
  258.  o Menu bar 
  259.  o Data input area 
  260.  o Data output area 
  261.  o Key pad 
  262.  o Control pushbuttons 
  263.  
  264.  
  265. ΓòÉΓòÉΓòÉ 3.1. Program menus ΓòÉΓòÉΓòÉ
  266.  
  267. The program's menu bar contains the following groupings and items: 
  268.  
  269.  o Edit 
  270.  
  271.     - Copy 
  272.     - Paste 
  273.     - Exit 
  274.  
  275.  o Options 
  276.  
  277.     - Mode toggle 
  278.     - Font size 
  279.  
  280.  o Help 
  281.  
  282.     - Help 
  283.     - About 
  284.  
  285.  
  286. ΓòÉΓòÉΓòÉ 3.1.1. Copy menu item ΓòÉΓòÉΓòÉ
  287.  
  288. Selecting the Copy menu item copies the data contained in the active data entry 
  289. control into the OS/2 system clipboard. 
  290.  
  291. This function is also replicated by the  Copy control push button. For further 
  292. information on copying data to the clipboard, see: 
  293.  
  294.  o Copying data 
  295.  
  296.  
  297. ΓòÉΓòÉΓòÉ 3.1.2. Paste menu item ΓòÉΓòÉΓòÉ
  298.  
  299. Selecting the Paste menu item pastes information from the OS/2 clipboard into 
  300. the currently active data entry control. 
  301.  
  302. This function is replicated by the  Paste control push button. For further 
  303. information on pasting data from the clipboard, see: 
  304.  
  305.  o Pasting data 
  306.  
  307.  
  308. ΓòÉΓòÉΓòÉ 3.1.3. Mode toggle menu item ΓòÉΓòÉΓòÉ
  309.  
  310. Selecting this menu item switches the operating mode of the calculator between 
  311. normal and inverse. The Mode toggle menu item also replicates the  Mode toggle 
  312. push button. 
  313.  
  314.  
  315. ΓòÉΓòÉΓòÉ 3.1.4. Font size menu item ΓòÉΓòÉΓòÉ
  316.  
  317. Selecting this menu item switches the size of the characters used for display 
  318. of information on the calculator's face. The calculator's normal default 
  319. condition is large characters. When the calculator is used on system's that 
  320. make use of a 1024x768 display resolution with large size system fonts, the 
  321. text display must make use of a smaller font to properly display the 
  322. information. 
  323.  
  324. The calculator's start-up character size can be forced to the smaller size by 
  325. using a /s or /S parameter on the command line used to start the calculator. 
  326.  
  327.  
  328. ΓòÉΓòÉΓòÉ 3.1.5. Exit menu item ΓòÉΓòÉΓòÉ
  329.  
  330. Selecting the Exit menu item terminates execution of the program. 
  331.  
  332.  
  333. ΓòÉΓòÉΓòÉ 3.1.6. Help menu item ΓòÉΓòÉΓòÉ
  334.  
  335. Selecting the Help menu item displays user information for using the calculator 
  336. program. The program's help conventions are standard with those generally used 
  337. with OS/2 application programs. 
  338.  
  339.  
  340. ΓòÉΓòÉΓòÉ 3.1.7. About menu item ΓòÉΓòÉΓòÉ
  341.  
  342. Selecting the About menu item displays information about the program, including 
  343. the version number and date. 
  344.  
  345.  
  346. ΓòÉΓòÉΓòÉ 3.2. Data input area ΓòÉΓòÉΓòÉ
  347.  
  348. The program's data input area consists of the 3 topmost data entry controls on 
  349. the main program window and their labels. The label for the currently active 
  350. data input control is highlighted with a different color (white) background. 
  351. The data entry windows are: 
  352.  
  353. Probability. This control control is used to enter the base probability 
  354.           information required by the program. This is the single event 
  355.           probability when the calculator is operating in normal mode and the 
  356.           overall probability when the calculator is operating in its inverse 
  357.           mode. Note that the label for this control also changes with the 
  358.           operating mode. 
  359.  
  360.  Sample size(events). This control is used to enter the total sample size to 
  361.           considered in the calculations. 
  362.  
  363.  Numb. of successes. This control is used to enter the number of successes to 
  364.           be used in the calculations. 
  365.  
  366.  The program does testing on the values to determine the potential correctness 
  367.  of the data that has been entered. See the  data entry section for further 
  368.  information about the data validity tests as well as entry of data itself. 
  369.  
  370.  
  371. ΓòÉΓòÉΓòÉ 3.3. Data output area ΓòÉΓòÉΓòÉ
  372.  
  373. The program's data output area is located near the center of the calculator's 
  374. main program window. When the calculator is operating in its normal mode, 3 
  375. output data controls and their labels are shown. The number of output data 
  376. controls reduces to 1 when the calculator is operating in its  inverse mode. 
  377. Labeling of the ourput controls also changes with the calculator's operating 
  378. mode. 
  379.  
  380. Although the output controls can receive the program's focus by clicking  on 
  381. them with the left mouse button, the controls cannot receive any input. The 
  382. ability to receive the program's current focus is necessary to allow data to be 
  383. copied from the control to the OS/2 clipboard. See copying data for further 
  384. information. 
  385.  
  386.  
  387. ΓòÉΓòÉΓòÉ 3.4. Calculator Keypad ΓòÉΓòÉΓòÉ
  388.  
  389. The calculator's key pad is located on the bottom, right side of the main 
  390. program window, and consists of multiple push button type controls which may be 
  391. selected with the left button of the mouse. The keys and their functions are: 
  392.  
  393. Numeric keys 0-9. Selection of any one of these controls will add that number 
  394.           to the end of the data shown in the currently active data input 
  395.           window. Note that if the currently active data input control has 
  396.           selected text, shown by reverse video, the selected text is deleted 
  397.           and the new number added to the end of the remaining data. 
  398.  
  399.  Enter.   Selection of the Enter button forces an immediate calculation of 
  400.           results. It is necessary to make this selection after data has been 
  401.           entered or changed to have the output data be correct. 
  402.  
  403.  Ce. (Clear entry) Selection of this key clears all of the data currently 
  404.           contained in the active data input entry control. Note that if the 
  405.           active control is for probability, the control is initialized with 0. 
  406.           characters. 
  407.  
  408.  <-. (Clear last character) Selection of this button erases the last character 
  409.           displayed in the active data input entry control. 
  410.  
  411.  Prob.    Selection of this button forces the current active data input control 
  412.           to be probability data entry. Numbers to the right of the decimal 
  413.           point in the probability control are also selected for possible 
  414.           deletion when this button is depressed. 
  415.  
  416.  Events.  Selection of this button forces the current active data input control 
  417.           to be Sample size(events) data entry. Data currently in the control 
  418.           is selected for possible deletion when this button is depressed. 
  419.  
  420.  Successes. Selection of this button forces the current active data input 
  421.           control to be Numb. of successes data entry. Data currently in the 
  422.           control is selected for possible deletion when this button is 
  423.           depressed. 
  424.  
  425.  
  426. ΓòÉΓòÉΓòÉ 3.5. Control pushbuttons ΓòÉΓòÉΓòÉ
  427.  
  428. The calculator has several control push buttons available. These buttons are: 
  429.  
  430. The Copy button. This button copies data from the curent active input or output 
  431. control to the OS/2 clipboard. The pushbutton also replicates the Copy menu 
  432. item function. For further instructions on copying data to the clipboard, see: 
  433. Copying data. 
  434.  
  435. The Paste button. This button pastes data from the OS/2 clipboard to the 
  436. current active data entry control. The pushbutton also replicates the Paste 
  437. menu item function. For further instructions on pasting data from the 
  438. clipboard, see: Pasting data. 
  439.  
  440. The Mode toggle button. This push button toggles the operating mode of the 
  441. calculator between normal and inverse. The pushbutton also replicates the Mode 
  442. toggle menu item. 
  443.  
  444. When the calculator is running in inverse mode, there are 2 radio buttons to 
  445. the left of the keypad. These buttons are labeled <= and >=, and control the 
  446. basis upon which the calculator decides the meaning of the overall probability 
  447. data. For further information on this aspect of the calculator's operation, see 
  448. Inverse calculations. 
  449.  
  450.  
  451. ΓòÉΓòÉΓòÉ 4. Installation ΓòÉΓòÉΓòÉ
  452.  
  453. As distributed, the program consists of 2 files plus a README file. The files 
  454. are: 
  455.  
  456.  PROBABIL.EXE - The executable program. 
  457.  PROBABIL.HLP - The program's Help file. 
  458.  
  459.  The suggested program installation consists of copying both files to the same 
  460.  directory. Copy a program object from the Templates folder on your desktop to 
  461.  the desired folder for execution, then insert the proper drive and directory 
  462.  information into the object's setup notebook. Note that both the Path and file 
  463.  name and Working directory entries on the notebook have to be set to the same 
  464.  drive and directory for the program to find the help directory. 
  465.  
  466.  This program makes no entries in the OS/2 .INI files. 
  467.  
  468.  
  469. ΓòÉΓòÉΓòÉ 5. Misc. Information ΓòÉΓòÉΓòÉ
  470.  
  471. The following misc. information is available: 
  472.  
  473.  o License 
  474.  o Warranty 
  475.  o Support 
  476.  o Program history 
  477.  
  478.  
  479. ΓòÉΓòÉΓòÉ 5.1. License ΓòÉΓòÉΓòÉ
  480.  
  481. This program has been placed into the public domain by the author, and may be 
  482. freely distributed and copied, provided no charge is made. It maybe included in 
  483. collections of software etc. in which the distributor makes a nominal charge 
  484. for the media it is distributed on. 
  485.  
  486.  
  487. ΓòÉΓòÉΓòÉ 5.2. Warranty ΓòÉΓòÉΓòÉ
  488.  
  489. There is no warranty of any kind, either expressed or implied, associated with 
  490. this program. Use of the program is at the sole risk of the user. 
  491.  
  492.  
  493. ΓòÉΓòÉΓòÉ 5.3. Support ΓòÉΓòÉΓòÉ
  494.  
  495. I am interested in learning about bugs, enhancement suggestions etc. that you 
  496. may have. Please remember that all support is strictly subject to the 
  497. availability of my time etc. The program was originally written in support of 
  498. my normal job, for which ver. 1.00 was fully adequate. 
  499.  
  500. Address all questions etc. via Internet e-mail to: 
  501.  
  502.   nelson@radar.nrl.navy.mil 
  503.  
  504.  
  505. ΓòÉΓòÉΓòÉ 5.4. Program history ΓòÉΓòÉΓòÉ
  506.  
  507. Version 1.10 - 10/31/93. Added the ability to change the character size used by 
  508.        the calculator. This was done to correct a problem with the standard 
  509.        text being to large when the program was run on systems using 1024x768 
  510.        resolution with large system character fonts. The character size can be 
  511.        forced to small characters by using a /s argument on the command line or 
  512.        from the new Options/ Font size menu item. 
  513.  
  514.        Version 1.01 - 10/16/93. First public release of the program.