<?xml-stylesheet type="text/xsl" href="../styles/pmathml.xsl"?>
<!-- saved from url=(0014)about:internet -->
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:dsi="http://www.w3.org/1999/xlink" xmlns:m="http://www.w3.org/1998/Math/MathML" xml:space="preserve"><head><meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"/><title>G07AAF : NAG Library, Mark 22</title><link rel="stylesheet" href="../styles/libdoc.css" type="text/css"/><script type="text/javascript">
   function showLevel(_levelId){
    var thisLevel = document.getElementById(_levelId);
    var thisplus = document.getElementById( _levelId.concat('plus'));
    var thisminus = document.getElementById( _levelId.concat('minus'));
    if(thisLevel.style.display != "block"){
     thisLevel.style.display = "block";
     thisplus.style.display = "none";
     thisminus.style.display = "inline";
     }
    else{
     thisLevel.style.display = "none";
     thisminus.style.display = "none";
     thisplus.style.display = "inline";
     }
    }
  </script></head><body><hr/><div><a class="rout" href="../../pdf/G07/g07aaf.pdf">G07AAF (PDF version)</a></div><div><a class="chap" href="g07conts.xml">G07 Chapter Contents</a></div><div><a class="chapint" href="g07intro.xml">G07 Chapter Introduction</a></div>
<div><a class="htmltoc" href="../FRONTMATTER/manconts.xml">NAG Library Manual</a></div><hr/><h1 class="libdoc">NAG Library Routine Document<br/><br/>G07AAF</h1><div class="paramtext"><div class="header"><b>Note:</b>&#160; before using this routine, please read the Users' Note for your implementation to check the interpretation of <span class="bitalic">bold italicised</span> terms and other implementation-dependent details.</div></div> 
<div class="htmltoc">
<h2 class="htmltoc"><span class="htmltochead" onclick="showLevel('htmltoc');"><span class="htmltocplus" id="htmltocplus">+</span><span class="htmltocminus" id="htmltocminus">&#8722;</span></span>&#160;Contents</h2>
<div class="htmltocitem" id="htmltoc">
<div class="htmltoc">
<span class="htmltocplus">&#160;&#160;&#160;</span>
<a class="htmltoc" href="#purpose">1&#160;&#160;<b>Purpose</b></a>
</div><div class="htmltoc">
<span class="htmltocplus">&#160;&#160;&#160;</span>
<a class="htmltoc" href="#specification">2&#160;&#160;<b>Specification</b></a>
</div><div class="htmltoc">
<span class="htmltocplus">&#160;&#160;&#160;</span>
<a class="htmltoc" href="#description">3&#160;&#160;<b>Description</b></a>
</div><div class="htmltoc">
<span class="htmltocplus">&#160;&#160;&#160;</span>
<a class="htmltoc" href="#references">4&#160;&#160;<b>References</b></a>
</div><div class="htmltoc">
<span class="htmltocplus">&#160;&#160;&#160;</span>
<a class="htmltoc" href="#parameters">5&#160;&#160;<b>Parameters</b></a>
</div><div class="htmltoc">
<span class="htmltocplus">&#160;&#160;&#160;</span>
<a class="htmltoc" href="#errors">6&#160;&#160;<b>Error Indicators and Warnings</b></a>
</div><div class="htmltoc">
<span class="htmltocplus">&#160;&#160;&#160;</span>
<a class="htmltoc" href="#accuracy">7&#160;&#160;<b>Accuracy</b></a>
</div><div class="htmltoc">
<span class="htmltocplus">&#160;&#160;&#160;</span>
<a class="htmltoc" href="#fcomments">8&#160;&#160;<b>Further Comments</b></a>
</div><div class="htmltoc">
<span class="htmltoc" onclick="showLevel('tocexample');"><span class="htmltocplus" id="tocexampleplus">+</span><span class="htmltocminus" id="tocexampleminus">&#8722;</span></span>
<a class="htmltoc" href="#example">9&#160;&#160;<b>Example</b></a>
<div class="htmltocitem" id="tocexample">
<div class="htmltoc">
<span class="htmltocplus">&#160;&#160;&#160;</span>
<a class="htmltoc" href="#examtext">9.1&#160;&#160;<b>Program Text</b></a>
</div><div class="htmltoc">
<span class="htmltocplus">&#160;&#160;&#160;</span>
<a class="htmltoc" href="#examdata">9.2&#160;&#160;<b>Program Data</b></a>
</div><div class="htmltoc">
<span class="htmltocplus">&#160;&#160;&#160;</span>
<a class="htmltoc" href="#examresults">9.3&#160;&#160;<b>Program Results</b></a>
</div>
</div>
</div>
</div>
</div><h2 class="standard"><a class="sec" name="purpose" id="purpose"/>1&#160;&#160;Purpose</h2>
<div class="paramtext">G07AAF computes a confidence interval for the parameter <m:math><m:mi>p</m:mi></m:math>&#160;(the probability of a success) of a binomial distribution.</div><h2 class="standard"><a class="sec" name="specification" id="specification"/>2&#160;&#160;Specification</h2>
<table class="fspec"><tr><td class="tdfspec1">SUBROUTINE&#160;G07AAF&#160;(</td><td class="tdfspec2"><a class="arg" href="#N">N</a>, <a class="arg" href="#K">K</a>, <a class="arg" href="#CLEVEL">CLEVEL</a>, <a class="arg" href="#PL">PL</a>, <a class="arg" href="#PU">PU</a>, <a class="arg" href="#IFAIL">IFAIL</a>)</td></tr><tr><td class="tdfspec1">INTEGER</td><td class="tdfspec2">N, K, IFAIL</td></tr><tr><td class="tdfspec1"><b><i>double&#160;precision</i></b></td><td class="tdfspec2">CLEVEL, PL, PU</td></tr></table><h2 class="standard"><a class="sec" name="description" id="description"/>3&#160;&#160;Description</h2>
<div class="paramtext">Given the number of trials, <m:math><m:mi>n</m:mi></m:math>, and the number of successes, <m:math><m:mi>k</m:mi></m:math>, this routine computes a <m:math><m:mn>100</m:mn><m:mfenced separators=""><m:mn>1</m:mn><m:mo>-</m:mo><m:mi>&#945;</m:mi></m:mfenced><m:mo>%</m:mo></m:math>&#160;confidence interval for <m:math><m:mi>p</m:mi></m:math>, the probability parameter of a binomial distribution with probability function,

<div class="formula"><table class="formula"><tr><td class="formula"><m:math display="block">
<m:mi>f</m:mi><m:mfenced separators=""><m:mi>x</m:mi></m:mfenced><m:mo>=</m:mo><m:mfenced><m:mtable>
  <m:mtr>
   <m:mtd><m:mi>n</m:mi></m:mtd>
  </m:mtr><m:mtr>
   <m:mtd><m:mi>x</m:mi></m:mtd>
  </m:mtr>
 </m:mtable></m:mfenced>
<m:msup><m:mi>p</m:mi><m:mi>x</m:mi></m:msup><m:msup><m:mfenced separators=""><m:mn>1</m:mn><m:mo>-</m:mo><m:mi>p</m:mi></m:mfenced><m:mrow><m:mi>n</m:mi><m:mo>-</m:mo><m:mi>x</m:mi></m:mrow></m:msup><m:mtext>, &#8195;</m:mtext><m:mi>x</m:mi><m:mo>=</m:mo><m:mn>0</m:mn><m:mo>,</m:mo><m:mn>1</m:mn><m:mo>,</m:mo><m:mo>&#8230;</m:mo><m:mo>,</m:mo><m:mi>n</m:mi><m:mtext>,</m:mtext>
</m:math></td><td class="formula2"/></tr></table></div>

where <m:math><m:mi>&#945;</m:mi></m:math>&#160;is in the interval <m:math><m:mfenced separators=""><m:mn>0</m:mn><m:mo>,</m:mo><m:mn>1</m:mn></m:mfenced></m:math>.</div><div class="paramtext">Let the confidence interval be denoted by [<m:math><m:msub><m:mi>p</m:mi><m:mi>l</m:mi></m:msub><m:mo>,</m:mo><m:msub><m:mi>p</m:mi><m:mi>u</m:mi></m:msub></m:math>].</div><div class="paramtext">The point estimate for <m:math><m:mi>p</m:mi></m:math>&#160;is <m:math><m:mover><m:mi>p</m:mi><m:mo>^</m:mo></m:mover><m:mo>=</m:mo><m:mi>k</m:mi><m:mo>/</m:mo><m:mi>n</m:mi></m:math>.</div><div class="paramtext">The lower and upper confidence limits <m:math><m:msub><m:mi>p</m:mi><m:mi>l</m:mi></m:msub></m:math>&#160;and <m:math><m:msub><m:mi>p</m:mi><m:mi>u</m:mi></m:msub></m:math>&#160;are estimated by the solutions to the equations;

<div class="formula"><table class="formula"><tr><td class="formula"><m:math display="block">
<m:munderover><m:mo>&#8721;</m:mo><m:mrow><m:mi>x</m:mi><m:mo>=</m:mo><m:mi>k</m:mi></m:mrow><m:mi>n</m:mi></m:munderover>
<m:mfenced><m:mtable>
  <m:mtr>
   <m:mtd><m:mi>n</m:mi></m:mtd>
  </m:mtr><m:mtr>
   <m:mtd><m:mi>x</m:mi></m:mtd>
  </m:mtr>
 </m:mtable></m:mfenced>
<m:msup><m:msub><m:mi>p</m:mi><m:mi>l</m:mi></m:msub><m:mi>x</m:mi></m:msup><m:msup><m:mfenced separators=""><m:mn>1</m:mn><m:mo>-</m:mo><m:msub><m:mi>p</m:mi><m:mi>l</m:mi></m:msub></m:mfenced><m:mrow><m:mi>n</m:mi><m:mo>-</m:mo><m:mi>x</m:mi></m:mrow></m:msup><m:mo>=</m:mo><m:mi>&#945;</m:mi><m:mo>/</m:mo><m:mn>2</m:mn><m:mtext>,</m:mtext>
</m:math></td><td class="formula2"/></tr></table></div><div class="formula"><table class="formula"><tr><td class="formula"><m:math display="block">
<m:munderover><m:mo>&#8721;</m:mo><m:mrow><m:mi>x</m:mi><m:mo>=</m:mo> <m:mn>0</m:mn></m:mrow><m:mi>k</m:mi></m:munderover>
<m:mfenced><m:mtable>
  <m:mtr>
   <m:mtd><m:mi>n</m:mi></m:mtd>
  </m:mtr><m:mtr>
   <m:mtd><m:mi>x</m:mi></m:mtd>
  </m:mtr>
 </m:mtable></m:mfenced>
<m:msup><m:msub><m:mi>p</m:mi><m:mi>u</m:mi></m:msub><m:mi>x</m:mi></m:msup><m:msup><m:mfenced separators=""><m:mn>1</m:mn><m:mo>-</m:mo><m:msub><m:mi>p</m:mi><m:mi>u</m:mi></m:msub></m:mfenced><m:mrow><m:mi>n</m:mi><m:mo>-</m:mo><m:mi>x</m:mi></m:mrow></m:msup><m:mo>=</m:mo><m:mi>&#945;</m:mi> <m:mo>/</m:mo><m:mn>2</m:mn><m:mtext>.</m:mtext>
</m:math></td><td class="formula2"/></tr></table></div>

Three different methods are used depending on the number of trials, <m:math><m:mi>n</m:mi></m:math>, and the number of successes, <m:math><m:mi>k</m:mi></m:math>.
<ol class="listnumber"><li class="listnumber">If <m:math><m:mrow><m:mi>max</m:mi><m:mspace width="0.125em"/><m:mfenced separators=""><m:mi>k</m:mi><m:mo>,</m:mo><m:mrow><m:mi>n</m:mi><m:mo>-</m:mo><m:mi>k</m:mi></m:mrow></m:mfenced></m:mrow><m:mo>&lt;</m:mo><m:msup><m:mn>10</m:mn><m:mn>6</m:mn></m:msup></m:math>.
 <div class="paramtext">The relationship between the beta and binomial distributions (see page 38 of <a class="ref" href="#ref125">Hastings and Peacock (1975)</a>) is used to derive the equivalent equations,

<div class="formula"><table class="formula"><tr><td class="formula"><m:math display="block">
<m:mtable columnalign="left center left">
 <m:mtr>
  <m:mtd><m:msub><m:mi>p</m:mi><m:mi>l</m:mi></m:msub></m:mtd>
  <m:mtd><m:mo>=</m:mo></m:mtd>
  <m:mtd><m:msub><m:mi>&#946;</m:mi><m:mrow><m:mi>k</m:mi><m:mo>,</m:mo><m:mi>n</m:mi><m:mo>-</m:mo><m:mi>k</m:mi><m:mo>+</m:mo><m:mn>1</m:mn><m:mo>,</m:mo><m:mi>&#945;</m:mi><m:mo>/</m:mo><m:mn>2</m:mn></m:mrow></m:msub><m:mtext>,</m:mtext></m:mtd>
 </m:mtr><m:mtr>
  <m:mtd/>
  <m:mtd/>
  <m:mtd/>
 </m:mtr><m:mtr>
  <m:mtd><m:msub><m:mi>p</m:mi><m:mi>u</m:mi></m:msub></m:mtd>
  <m:mtd><m:mo>=</m:mo></m:mtd>
  <m:mtd><m:msub><m:mi>&#946;</m:mi><m:mrow><m:mi>k</m:mi><m:mo>+</m:mo><m:mn>1</m:mn><m:mo>,</m:mo><m:mi>n</m:mi><m:mo>-</m:mo><m:mi>k</m:mi><m:mo>,</m:mo><m:mn>1</m:mn><m:mo>-</m:mo><m:mi>&#945;</m:mi><m:mo>/</m:mo><m:mn>2</m:mn></m:mrow></m:msub><m:mtext>,</m:mtext></m:mtd>
 </m:mtr>
</m:mtable>
</m:math></td><td class="formula2"/></tr></table></div>

where <m:math><m:msub><m:mi>&#946;</m:mi><m:mrow><m:mi>a</m:mi><m:mo>,</m:mo><m:mi>b</m:mi><m:mo>,</m:mo><m:mi>&#948;</m:mi></m:mrow></m:msub></m:math>&#160;is the deviate associated with the lower tail probability, <m:math><m:mi>&#948;</m:mi></m:math>, of the beta distribution with parameters <m:math><m:mi>a</m:mi></m:math>&#160;and <m:math><m:mi>b</m:mi></m:math>.  These beta deviates are computed using <a class="rout" href="../G01/g01fef.xml">G01FEF</a>.</div></li><li class="listnumber">If <m:math><m:mrow><m:mi>max</m:mi><m:mspace width="0.125em"/><m:mfenced separators=""><m:mi>k</m:mi><m:mo>,</m:mo><m:mrow><m:mi>n</m:mi><m:mo>-</m:mo><m:mi>k</m:mi></m:mrow></m:mfenced></m:mrow><m:mo>&#8805;</m:mo><m:msup><m:mn>10</m:mn><m:mn>6</m:mn></m:msup></m:math>&#160;and <m:math>
 <m:mrow><m:mi>min</m:mi><m:mspace width="0.125em"/><m:mfenced separators=""><m:mi>k</m:mi><m:mo>,</m:mo><m:mrow><m:mi>n</m:mi><m:mo>-</m:mo><m:mi>k</m:mi></m:mrow></m:mfenced></m:mrow>
 <m:mo>&#8804;</m:mo>
 <m:mn>1000</m:mn>
</m:math>.
 <div class="paramtext">The binomial variate with parameters <m:math><m:mi>n</m:mi></m:math>&#160;and <m:math><m:mi>p</m:mi></m:math>&#160;is approximated by a Poisson variate with mean <m:math><m:mi>n</m:mi><m:mi>p</m:mi></m:math>, see page 38 of <a class="ref" href="#ref125">Hastings and Peacock (1975)</a>.</div><div class="paramtext">The relationship between the Poisson and <m:math><m:msup><m:mi>&#967;</m:mi><m:mn>2</m:mn></m:msup></m:math>-distributions (see page 112 of <a class="ref" href="#ref125">Hastings and Peacock (1975)</a>) is used to derive the following equations;

<div class="formula"><table class="formula"><tr><td class="formula"><m:math display="block">
<m:mtable columnalign="left center left">
 <m:mtr>
  <m:mtd><m:msub><m:mi>p</m:mi><m:mi>l</m:mi></m:msub></m:mtd>
  <m:mtd><m:mo>=</m:mo></m:mtd>
  <m:mtd><m:mfrac other="display">
  <m:mn>1</m:mn><m:mrow><m:mn>2</m:mn><m:mi>n</m:mi></m:mrow>
 </m:mfrac><m:msubsup><m:mi>&#967;</m:mi><m:mrow><m:mn>2</m:mn><m:mi>k</m:mi><m:mo>,</m:mo><m:mi>&#945;</m:mi><m:mo>/</m:mo><m:mn>2</m:mn></m:mrow><m:mn>2</m:mn></m:msubsup><m:mtext>,</m:mtext></m:mtd>
 </m:mtr><m:mtr>
  <m:mtd/>
  <m:mtd/>
  <m:mtd/>
 </m:mtr><m:mtr>
  <m:mtd><m:msub><m:mi>p</m:mi><m:mi>u</m:mi></m:msub></m:mtd>
  <m:mtd><m:mo>=</m:mo></m:mtd>
  <m:mtd><m:mfrac other="display">
  <m:mn>1</m:mn><m:mrow><m:mn>2</m:mn><m:mi>n</m:mi></m:mrow>
 </m:mfrac><m:msubsup><m:mi>&#967;</m:mi><m:mrow><m:mn>2</m:mn><m:mi>k</m:mi><m:mo>+</m:mo><m:mn>2</m:mn><m:mo>,</m:mo><m:mn>1</m:mn><m:mo>-</m:mo><m:mi>&#945;</m:mi><m:mo>/</m:mo><m:mn>2</m:mn></m:mrow><m:mn>2</m:mn></m:msubsup><m:mtext>,</m:mtext></m:mtd>
 </m:mtr>
</m:mtable>
</m:math></td><td class="formula2"/></tr></table></div>

where <m:math><m:msubsup><m:mi>&#967;</m:mi><m:mrow><m:mi>&#948;</m:mi><m:mo>,</m:mo><m:mi>&#957;</m:mi></m:mrow><m:mn>2</m:mn></m:msubsup></m:math>&#160;is the deviate associated with the lower tail probability, <m:math><m:mi>&#948;</m:mi></m:math>, of the <m:math><m:msup><m:mi>&#967;</m:mi><m:mn>2</m:mn></m:msup></m:math>-distribution with <m:math><m:mi>&#957;</m:mi></m:math>&#160;degrees of freedom.</div>
 <div class="paramtext">In turn the relationship between the <m:math><m:msup><m:mi>&#967;</m:mi><m:mn>2</m:mn></m:msup></m:math>-distribution and the gamma distribution (see page 70 of <a class="ref" href="#ref125">Hastings and Peacock (1975)</a>) yields the following equivalent equations;

<div class="formula"><table class="formula"><tr><td class="formula"><m:math display="block">
<m:mtable columnalign="left center left">
 <m:mtr>
  <m:mtd><m:msub><m:mi>p</m:mi><m:mi>l</m:mi></m:msub></m:mtd>
  <m:mtd><m:mo>=</m:mo></m:mtd>
  <m:mtd><m:mfrac other="display">
  <m:mn>1</m:mn><m:mrow><m:mn>2</m:mn><m:mi>n</m:mi></m:mrow>
 </m:mfrac><m:msub><m:mi>&#947;</m:mi><m:mrow><m:mi>k</m:mi><m:mo>,</m:mo><m:mn>2</m:mn><m:mtext>;</m:mtext><m:mi>&#945;</m:mi><m:mo>/</m:mo><m:mn>2</m:mn></m:mrow></m:msub><m:mtext>,</m:mtext></m:mtd>
 </m:mtr><m:mtr>
  <m:mtd/>
  <m:mtd/>
  <m:mtd/>
 </m:mtr><m:mtr>
  <m:mtd><m:msub><m:mi>p</m:mi><m:mi>u</m:mi></m:msub></m:mtd>
  <m:mtd><m:mo>=</m:mo></m:mtd>
  <m:mtd><m:mfrac other="display">
  <m:mn>1</m:mn><m:mrow><m:mn>2</m:mn><m:mi>n</m:mi></m:mrow>
 </m:mfrac><m:msub><m:mi>&#947;</m:mi><m:mrow><m:mi>k</m:mi><m:mo>+</m:mo><m:mn>1</m:mn><m:mo>,</m:mo><m:mn>2</m:mn><m:mtext>;</m:mtext><m:mn>1</m:mn><m:mo>-</m:mo><m:mi>&#945;</m:mi><m:mo>/</m:mo><m:mn>2</m:mn></m:mrow></m:msub><m:mtext>,</m:mtext></m:mtd>
 </m:mtr>
</m:mtable>
</m:math></td><td class="formula2"/></tr></table></div>

where <m:math><m:msub><m:mi>&#947;</m:mi><m:mrow><m:mi>&#945;</m:mi><m:mo>,</m:mo><m:mi>&#946;</m:mi><m:mtext>;</m:mtext><m:mi>&#948;</m:mi></m:mrow></m:msub></m:math>&#160;is the deviate associated with the lower tail probability, <m:math><m:mi>&#948;</m:mi></m:math>, of the gamma distribution with shape parameter <m:math><m:mi>&#945;</m:mi></m:math>&#160;and scale parameter <m:math><m:mi>&#946;</m:mi></m:math>.  These deviates are computed using <a class="rout" href="../G01/g01fff.xml">G01FFF</a>.</div></li><li class="listnumber">If <m:math><m:mrow><m:mi>max</m:mi><m:mspace width="0.125em"/><m:mfenced separators=""><m:mi>k</m:mi><m:mo>,</m:mo><m:mrow><m:mi>n</m:mi><m:mo>-</m:mo><m:mi>k</m:mi></m:mrow></m:mfenced></m:mrow><m:mo>&gt;</m:mo><m:msup><m:mn>10</m:mn><m:mn>6</m:mn></m:msup></m:math>&#160;and <m:math>
 <m:mrow><m:mi>min</m:mi><m:mspace width="0.125em"/><m:mfenced separators=""><m:mi>k</m:mi><m:mo>,</m:mo><m:mrow><m:mi>n</m:mi><m:mo>-</m:mo><m:mi>k</m:mi></m:mrow></m:mfenced></m:mrow>
 <m:mo>&gt;</m:mo>
 <m:mn>1000</m:mn>
</m:math>.
 <div class="paramtext">The binomial variate with parameters <m:math><m:mi>n</m:mi></m:math>&#160;and <m:math><m:mi>p</m:mi></m:math>&#160;is approximated by a Normal variate with mean <m:math><m:mi>n</m:mi><m:mi>p</m:mi></m:math>&#160;and variance <m:math><m:mi>n</m:mi><m:mi>p</m:mi><m:mfenced separators=""><m:mn>1</m:mn><m:mo>-</m:mo><m:mi>p</m:mi></m:mfenced></m:math>, see page 38 of <a class="ref" href="#ref125">Hastings and Peacock (1975)</a>.</div>
 <div class="paramtext">The approximate lower and upper confidence limits <m:math><m:msub><m:mi>p</m:mi><m:mi>l</m:mi></m:msub></m:math>&#160;and <m:math><m:msub><m:mi>p</m:mi><m:mi>u</m:mi></m:msub></m:math>&#160;are the solutions to the equations;

<div class="formula"><table class="formula"><tr><td class="formula"><m:math display="block">
<m:mtable columnalign="left center left">
 <m:mtr>
  <m:mtd><m:mfrac other="display">
  <m:mrow><m:mi>k</m:mi><m:mo>-</m:mo><m:mi>n</m:mi><m:msub><m:mi>p</m:mi><m:mi>l</m:mi></m:msub></m:mrow>
  <m:msqrt><m:mi>n</m:mi><m:msub><m:mi>p</m:mi><m:mi>l</m:mi></m:msub><m:mfenced separators=""><m:mn>1</m:mn><m:mo>-</m:mo><m:msub><m:mi>p</m:mi><m:mi>l</m:mi></m:msub></m:mfenced></m:msqrt>
 </m:mfrac></m:mtd>
  <m:mtd><m:mo>=</m:mo></m:mtd>
  <m:mtd><m:msub><m:mi>z</m:mi><m:mrow><m:mn>1</m:mn><m:mo>-</m:mo><m:mi>&#945;</m:mi><m:mo>/</m:mo><m:mn>2</m:mn></m:mrow></m:msub><m:mtext>,</m:mtext></m:mtd>
 </m:mtr><m:mtr>
  <m:mtd/>
  <m:mtd/>
  <m:mtd/></m:mtr><m:mtr>
  <m:mtd/>
  <m:mtd/>
  <m:mtd/></m:mtr><m:mtr>
  <m:mtd><m:mfrac other="display">
  <m:mrow><m:mi>k</m:mi><m:mo>-</m:mo><m:mi>n</m:mi><m:msub><m:mi>p</m:mi><m:mi>u</m:mi></m:msub></m:mrow>
  <m:msqrt><m:mi>n</m:mi><m:msub><m:mi>p</m:mi><m:mi>u</m:mi></m:msub><m:mfenced separators=""><m:mn>1</m:mn><m:mo>-</m:mo><m:msub><m:mi>p</m:mi><m:mi>u</m:mi></m:msub></m:mfenced></m:msqrt>
 </m:mfrac></m:mtd>
  <m:mtd><m:mo>=</m:mo></m:mtd>
  <m:mtd><m:msub><m:mi>z</m:mi><m:mrow><m:mi>&#945;</m:mi><m:mo>/</m:mo><m:mn>2</m:mn></m:mrow></m:msub><m:mtext>,</m:mtext></m:mtd>
 </m:mtr>
</m:mtable>
</m:math></td><td class="formula2"/></tr></table></div>

where <m:math><m:msub><m:mi>z</m:mi><m:mi>&#948;</m:mi></m:msub></m:math>&#160;is the deviate associated with the lower tail probability, <m:math><m:mi>&#948;</m:mi></m:math>, of the standard Normal distribution.  These equations are solved using a quadratic equation solver
(<a class="rout" href="../C02/c02ajf.xml">C02AJF</a>).
 </div></li></ol>
</div><h2 class="standard"><a class="sec" name="references" id="references"/>4&#160;&#160;References</h2><div class="paramtext"><a name="ref125" id="ref125"/>Hastings N A J and Peacock J B (1975)  <i>Statistical Distributions</i> Butterworth </div>
<div class="paramtext"><a name="ref409" id="ref409"/>Snedecor G W and Cochran W G (1967)  <i>Statistical Methods</i> Iowa State University Press </div><h2 class="standard"><a class="sec" name="parameters" id="parameters"/>5&#160;&#160;Parameters</h2>
<dl><dt class="paramhead"><a name="N" id="N"/>1: &#160;&#160;&#8194; N &#8211; INTEGER<span class="pclass">Input</span></dt><dd><div class="paramtext"><i>On entry</i>: <m:math><m:mi>n</m:mi></m:math>, the number of trials.</div><div class="paramtext"><i>Constraint</i>:
  <m:math><m:maction actiontype="link" dsi:type="simple" dsi:href="#N"><m:mi mathcolor="#EE0000" mathvariant="bold">N</m:mi></m:maction><m:mo>&#8805;</m:mo><m:mn>1</m:mn></m:math>.
</div></dd><dt class="paramhead"><a name="K" id="K"/>2: &#160;&#160;&#8194; K &#8211; INTEGER<span class="pclass">Input</span></dt><dd><div class="paramtext"><i>On entry</i>: <m:math><m:mi>k</m:mi></m:math>, the number of successes.</div><div class="paramtext"><i>Constraint</i>:
  <m:math><m:mn>0</m:mn><m:mo>&#8804;</m:mo><m:maction actiontype="link" dsi:type="simple" dsi:href="#K"><m:mi mathcolor="#EE0000" mathvariant="bold">K</m:mi></m:maction><m:mo>&#8804;</m:mo><m:maction actiontype="link" dsi:type="simple" dsi:href="#N"><m:mi mathcolor="#EE0000" mathvariant="bold">N</m:mi></m:maction></m:math>.
</div></dd><dt class="paramhead"><a name="CLEVEL" id="CLEVEL"/>3: &#160;&#160;&#8194; CLEVEL &#8211; <span class="bitalic">double precision</span><span class="pclass">Input</span></dt><dd><div class="paramtext"><i>On entry</i>: the confidence level, <m:math><m:mfenced separators=""><m:mn>1</m:mn><m:mo>-</m:mo><m:mi>&#945;</m:mi></m:mfenced></m:math>, for two-sided interval estimate. For example <m:math><m:maction actiontype="link" dsi:type="simple" dsi:href="#CLEVEL"><m:mi mathcolor="#EE0000" mathvariant="bold">CLEVEL</m:mi></m:maction><m:mo>=</m:mo><m:mn>0.95</m:mn></m:math>&#160;will give a <m:math><m:mn>95</m:mn><m:mo>%</m:mo></m:math>&#160;confidence interval.</div><div class="paramtext"><i>Constraint</i>:
  <m:math><m:mn>0.0</m:mn><m:mo>&lt;</m:mo><m:maction actiontype="link" dsi:type="simple" dsi:href="#CLEVEL"><m:mi mathcolor="#EE0000" mathvariant="bold">CLEVEL</m:mi></m:maction><m:mo>&lt;</m:mo><m:mn>1.0</m:mn></m:math>.
</div></dd><dt class="paramhead"><a name="PL" id="PL"/>4: &#160;&#160;&#8194; PL &#8211; <span class="bitalic">double precision</span><span class="pclass">Output</span></dt><dd><div class="paramtext"><i>On exit</i>: the lower limit, <m:math><m:msub><m:mi>p</m:mi><m:mi>l</m:mi></m:msub></m:math>, of the confidence interval.</div></dd><dt class="paramhead"><a name="PU" id="PU"/>5: &#160;&#160;&#8194; PU &#8211; <span class="bitalic">double precision</span><span class="pclass">Output</span></dt><dd><div class="paramtext"><i>On exit</i>: the upper limit, <m:math><m:msub><m:mi>p</m:mi><m:mi>u</m:mi></m:msub></m:math>, of the confidence interval.</div></dd><dt class="paramhead"><a name="IFAIL" id="IFAIL"/>6: &#160;&#160;&#8194; IFAIL &#8211; INTEGER<span class="pclass">Input/Output</span></dt><dd>
<div class="paramtext"><i>On entry</i>: <a class="arg" href="#IFAIL">IFAIL</a> must be set to <m:math><m:mn>0</m:mn></m:math>, <m:math><m:mrow><m:mo>-</m:mo><m:mn>1</m:mn></m:mrow><m:mtext>&#8203; or &#8203;</m:mtext><m:mn>1</m:mn></m:math>. If you are unfamiliar with this parameter you should refer to <a class="sec" href="../GENINT/essint.xml#library3">Section 3.3</a> in  the Essential Introduction for details.</div>
<div class="paramtext"><i>On exit</i>: <m:math><m:maction actiontype="link" dsi:type="simple" dsi:href="#IFAIL"><m:mi mathcolor="#EE0000" mathvariant="bold">IFAIL</m:mi></m:maction><m:mo>=</m:mo><m:maction actiontype="link" dsi:type="simple" dsi:href="#errors"><m:mn mathcolor="#003399" mathvariant="bold">0</m:mn></m:maction></m:math>&#160;unless the routine detects an error (see <a class="sec" href="#errors">Section 6</a>). <div class="paramtext">For environments where it might be inappropriate to halt program execution when an error is detected, the value <m:math><m:mrow><m:mo>-</m:mo><m:mn>1</m:mn></m:mrow><m:mtext>&#8203; or &#8203;</m:mtext><m:mn>1</m:mn></m:math>&#160;is recommended.  If the output of error messages is undesirable, then the value <m:math><m:mn>1</m:mn></m:math>&#160;is recommended.  Otherwise, if you are not familiar with this parameter, the recommended value is <m:math><m:mn>0</m:mn></m:math>.  <b>When the value <m:math><m:mrow><m:mo>-</m:mo><m:mn mathvariant="bold">1</m:mn></m:mrow><m:mtext>&#8203; or &#8203;</m:mtext><m:mn mathvariant="bold">1</m:mn></m:math>&#160;is used it is essential to test the value of <a class="arg" href="#IFAIL">IFAIL</a> on exit.</b></div></div></dd></dl><h2 class="standard"><a class="sec" name="errors" id="errors"/>6&#160;&#160;Error Indicators and Warnings</h2>
<div class="paramtext">If on entry <m:math><m:maction actiontype="link" dsi:type="simple" dsi:href="#IFAIL"><m:mi mathcolor="#EE0000" mathvariant="bold">IFAIL</m:mi></m:maction><m:mo>=</m:mo><m:maction actiontype="link" dsi:type="simple" dsi:href="#errors"><m:mn mathcolor="#003399" mathvariant="bold">0</m:mn></m:maction></m:math>&#160;or <m:math><m:maction actiontype="link" dsi:type="simple" dsi:href="#errors"><m:mn mathcolor="#003399" mathvariant="bold">-1</m:mn></m:maction></m:math>, explanatory error messages are output on the current error message unit (as defined by <a class="rout" href="../X04/x04aaf.xml">X04AAF</a>).</div><div class="paramtext">Errors or warnings detected by the routine:</div>
<dl class="ifail">
<dt class="errorhead"><a name="IFeq1" id="IFeq1"/><m:math><m:maction actiontype="link" dsi:type="simple" dsi:href="#IFAIL"><m:mi mathcolor="#EE0000" mathvariant="bold">IFAIL</m:mi></m:maction><m:mo>=</m:mo><m:mn>1</m:mn></m:math></dt>
<dd>
<table class="ifail"><tr><td class="ifail1">On&#160;entry,</td><td class="ifail2-90"><m:math><m:maction actiontype="link" dsi:type="simple" dsi:href="#N"><m:mi mathcolor="#EE0000" mathvariant="bold">N</m:mi></m:maction><m:mo>&lt;</m:mo><m:mn>1</m:mn></m:math>,</td></tr><tr><td class="ifail1">or</td><td class="ifail2-90"><m:math><m:maction actiontype="link" dsi:type="simple" dsi:href="#K"><m:mi mathcolor="#EE0000" mathvariant="bold">K</m:mi></m:maction><m:mo>&lt;</m:mo><m:mn>0</m:mn></m:math>,</td></tr><tr><td class="ifail1">or</td><td class="ifail2-90"><m:math><m:maction actiontype="link" dsi:type="simple" dsi:href="#N"><m:mi mathcolor="#EE0000" mathvariant="bold">N</m:mi></m:maction><m:mo>&lt;</m:mo><m:maction actiontype="link" dsi:type="simple" dsi:href="#K"><m:mi mathcolor="#EE0000" mathvariant="bold">K</m:mi></m:maction></m:math>,</td></tr><tr><td class="ifail1">or</td><td class="ifail2-90"><m:math><m:maction actiontype="link" dsi:type="simple" dsi:href="#CLEVEL"><m:mi mathcolor="#EE0000" mathvariant="bold">CLEVEL</m:mi></m:maction><m:mo>&#8804;</m:mo><m:mn>0.0</m:mn></m:math>,</td></tr><tr><td class="ifail1">or</td><td class="ifail2-90"><m:math><m:maction actiontype="link" dsi:type="simple" dsi:href="#CLEVEL"><m:mi mathcolor="#EE0000" mathvariant="bold">CLEVEL</m:mi></m:maction><m:mo>&#8805;</m:mo><m:mn>1.0</m:mn></m:math>.</td></tr></table>
</dd>
</dl><dl class="ifail">
<dt class="errorhead"><a name="IFeq2" id="IFeq2"/><m:math><m:maction actiontype="link" dsi:type="simple" dsi:href="#IFAIL"><m:mi mathcolor="#EE0000" mathvariant="bold">IFAIL</m:mi></m:maction><m:mo>=</m:mo><m:mn>2</m:mn></m:math></dt>
<dd>
<div class="paramtext">When using the relationship with the gamma distribution to calculate one of the confidence limits, the series to calculate the gamma probabilities has failed to converge.  Both <a class="arg" href="#PL">PL</a> and <a class="arg" href="#PU">PU</a> are set to zero.  This is a very unlikely error exit and if it occurs please contact <a class="url" href="http://www.nag.co.uk">NAG</a>.</div>
</dd>
</dl><h2 class="standard"><a class="sec" name="accuracy" id="accuracy"/>7&#160;&#160;Accuracy</h2>
<div class="paramtext">For most cases using the beta deviates the results should have a relative accuracy of <m:math><m:mrow><m:mi>max</m:mi><m:mspace width="0.125em"/><m:mfenced separators=""><m:mrow><m:mn>0.5</m:mn><m:mi>E</m:mi><m:mo>-</m:mo><m:mn>12</m:mn></m:mrow><m:mo>,</m:mo><m:mrow><m:mn>50.0</m:mn><m:mo>&#215;</m:mo><m:mi>&#949;</m:mi></m:mrow></m:mfenced></m:mrow></m:math>&#160;where <m:math><m:mi>&#949;</m:mi></m:math>&#160;is the <span class="bitalic">machine precision</span> (see <a class="rout" href="../X02/x02ajf.xml">X02AJF</a>).  Thus on machines with sufficiently high precision the results should be accurate to <m:math><m:mn>12</m:mn></m:math>&#160;significant figures.  Some accuracy may be lost when <m:math><m:mi>&#945;</m:mi><m:mo>/</m:mo><m:mn>2</m:mn></m:math>&#160;or <m:math><m:mn>1</m:mn><m:mo>-</m:mo><m:mi>&#945;</m:mi><m:mo>/</m:mo><m:mn>2</m:mn></m:math>&#160;is very close to <m:math><m:mn>0.0</m:mn></m:math>, which will occur if <a class="arg" href="#CLEVEL">CLEVEL</a> is very close to <m:math><m:mn>1.0</m:mn></m:math>.  This should not affect the usual confidence levels used.</div><div class="paramtext">The approximations used when <m:math><m:mi>n</m:mi></m:math>&#160;is large are accurate to at least <m:math><m:mn>3</m:mn></m:math>&#160;significant digits but usually to more.</div><h2 class="standard"><a class="sec" name="fcomments" id="fcomments"/>8&#160;&#160;Further Comments</h2>
<div class="paramtext">None.</div><h2 class="standard"><a class="sec" name="example" id="example"/>9&#160;&#160;Example</h2>
<div class="paramtext">The following example program reads in the number of deaths recorded among male recipients of war pensions in a six year period following an initial questionnaire in 1956.  We consider two classes, non-smokers and those who reported that they smoked pipes only.  The total number of males in each class is also read in.  The data is taken from page 216 of <a class="ref" href="#ref409">Snedecor and Cochran (1967)</a>.  An estimate of the probability of a death in the six year period in each class is computed together with 95% confidence intervals for these estimates.</div><h3 class="standard"><a class="sec" name="examtext" id="examtext"/>9.1&#160;&#160;Program Text</h3>
<p><a class="verbatimref" href="../../examples/source/g07aafe.f">Program Text (g07aafe.f)</a></p><h3 class="standard"><a class="sec" name="examdata" id="examdata"/>9.2&#160;&#160;Program Data</h3>
<p><a class="verbatimref" href="../../examples/data/g07aafe.d">Program&#160;Data (g07aafe.d)</a></p><h3 class="standard"><a class="sec" name="examresults" id="examresults"/>9.3&#160;&#160;Program Results</h3>
<p><a class="verbatimref" href="../../examples/baseresults/g07aafe.r">Program Results (g07aafe.r)</a></p>
<hr/><div><a class="rout" href="../../pdf/G07/g07aaf.pdf">G07AAF (PDF version)</a></div><div><a class="chap" href="g07conts.xml">G07 Chapter Contents</a></div><div><a class="chapint" href="g07intro.xml">G07 Chapter Introduction</a></div>
<div><a class="htmltoc" href="../FRONTMATTER/manconts.xml">NAG Library Manual</a></div>
<div><hr/><a class="genint" href="../FRONTMATTER/copyright.xml">&#169; The Numerical Algorithms Group Ltd, Oxford, UK. 2009</a></div></body></html>
