~ubuntu-branches/ubuntu/karmic/scilab/karmic

« back to all changes in this revision

Viewing changes to man/dcd/cdfnbn.man

  • Committer: Bazaar Package Importer
  • Author(s): Torsten Werner
  • Date: 2002-03-21 16:57:43 UTC
  • Revision ID: james.westby@ubuntu.com-20020321165743-e9mv12c1tb1plztg
Tags: upstream-2.6
ImportĀ upstreamĀ versionĀ 2.6

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.TH cdfnbn 1 "Dec 1997" "Scilab Group" "Scilab Function"
 
2
.so ../sci.an
 
3
.SH NAME
 
4
cdfnbn - cumulative distribution function  negative binomial distribution 
 
5
.SH CALLING SEQUENCE
 
6
.nf
 
7
[P,Q]=cdfnbn("PQ",S,Xn,Pr,Ompr)
 
8
[S]=cdfnbn("S",Xn,Pr,Ompr,P,Q)
 
9
[Xn]=cdfnbn("Xn",Pr,Ompr,P,Q,S)
 
10
[Pr,Ompr]=cdfnbn("PrOmpr",P,Q,S,Xn)
 
11
.fi 
 
12
.SH PARAMETERS
 
13
.TP 10
 
14
P,Q,S,Xn,Pr,Ompr
 
15
: six real vectors of the same size.
 
16
.TP
 
17
P,Q (Q=1-P)
 
18
: The cumulation from 0 to S of the  negative
 
19
binomial distribution.
 
20
Input range: [0,1].
 
21
.TP
 
22
 
23
: The upper limit of cumulation of the binomial distribution.
 
24
There are F or fewer failures before the XNth success.
 
25
Input range: [0, +infinity).
 
26
Search range: [0, 1E300]
 
27
.TP
 
28
Xn
 
29
:   The number of successes.
 
30
Input range: [0, +infinity).
 
31
Search range: [0, 1E300]
 
32
.TP
 
33
Pr
 
34
:   The probability of success in each binomial trial.
 
35
Input range: [0,1].
 
36
Search range: [0,1].
 
37
.TP
 
38
Ompr
 
39
:   1-PR
 
40
Input range: [0,1].
 
41
Search range: [0,1]
 
42
PR + OMPR = 1.0 
 
43
.SH DESCRIPTION
 
44
Calculates any one parameter of the negative binomial
 
45
distribution given values for the others.
 
46
.LP
 
47
The  cumulative  negative   binomial  distribution  returns  the
 
48
probability that there  will be  F or fewer failures before  the
 
49
XNth success in binomial trials each of which has probability of
 
50
success PR.
 
51
.LP
 
52
The individual term of the negative binomial is the probability of
 
53
S failures before XN successes and is
 
54
Choose( S, XN+S-1 ) * PR^(XN) * (1-PR)^S
 
55
.LP
 
56
Formula   26.5.26   of   Abramowitz  and  Stegun,  Handbook   of
 
57
Mathematical Functions (1966) is used  to  reduce calculation of
 
58
the cumulative distribution  function to that of  an  incomplete
 
59
beta.
 
60
.LP
 
61
Computation of other parameters involve a seach for a value that
 
62
produces  the desired  value  of P.   The search relies  on  the
 
63
monotinicity of P with the other parameter.
 
64
.LP
 
65
From DCDFLIB: Library of Fortran Routines for Cumulative Distribution
 
66
Functions, Inverses, and Other Parameters (February, 1994)
 
67
Barry W. Brown, James Lovato and Kathy Russell. The University of
 
68
Texas.