<!-- Generated by pkgdown: do not edit by hand -->
<!DOCTYPE html>
<html lang="en">
  <head>
  <meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">

<title>Info-Rank Plot — info.rank.bcea • BCEA</title>

<!-- favicons -->
<link rel="icon" type="image/png" sizes="16x16" href="../favicon-16x16.png">
<link rel="icon" type="image/png" sizes="32x32" href="../favicon-32x32.png">
<link rel="apple-touch-icon" type="image/png" sizes="180x180" href="../apple-touch-icon.png" />
<link rel="apple-touch-icon" type="image/png" sizes="120x120" href="../apple-touch-icon-120x120.png" />
<link rel="apple-touch-icon" type="image/png" sizes="76x76" href="../apple-touch-icon-76x76.png" />
<link rel="apple-touch-icon" type="image/png" sizes="60x60" href="../apple-touch-icon-60x60.png" />

<!-- jquery -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.4.1/jquery.min.js" integrity="sha256-CSXorXvZcTkaix6Yvo6HppcZGetbYMGWSFlBw8HfCJo=" crossorigin="anonymous"></script>
<!-- Bootstrap -->

<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.4.1/css/bootstrap.min.css" integrity="sha256-bZLfwXAP04zRMK2BjiO8iu9pf4FbLqX6zitd+tIvLhE=" crossorigin="anonymous" />

<script src="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.4.1/js/bootstrap.min.js" integrity="sha256-nuL8/2cJ5NDSSwnKD8VqreErSWHtnEP9E7AySL+1ev4=" crossorigin="anonymous"></script>

<!-- bootstrap-toc -->
<link rel="stylesheet" href="../bootstrap-toc.css">
<script src="../bootstrap-toc.js"></script>

<!-- Font Awesome icons -->
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/all.min.css" integrity="sha256-mmgLkCYLUQbXn0B1SRqzHar6dCnv9oZFPEC1g1cwlkk=" crossorigin="anonymous" />
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.12.1/css/v4-shims.min.css" integrity="sha256-wZjR52fzng1pJHwx4aV2AO3yyTOXrcDW7jBpJtTwVxw=" crossorigin="anonymous" />

<!-- clipboard.js -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/2.0.6/clipboard.min.js" integrity="sha256-inc5kl9MA1hkeYUt+EC3BhlIgyp/2jDIyBLS6k3UxPI=" crossorigin="anonymous"></script>

<!-- headroom.js -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/headroom.min.js" integrity="sha256-AsUX4SJE1+yuDu5+mAVzJbuYNPHj/WroHuZ8Ir/CkE0=" crossorigin="anonymous"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/headroom/0.11.0/jQuery.headroom.min.js" integrity="sha256-ZX/yNShbjqsohH1k95liqY9Gd8uOiE1S4vZc+9KQ1K4=" crossorigin="anonymous"></script>

<!-- pkgdown -->
<link href="../pkgdown.css" rel="stylesheet">
<script src="../pkgdown.js"></script>




<meta property="og:title" content="Info-Rank Plot — info.rank.bcea" />
<meta property="og:description" content="Produces a plot similar to a Tornado-plot, but based on the analysis of the
EVPPI. For each parameter and value of the willingness-to-pay threshold, a
barchart is plotted to describe the ratio of EVPPI (specific to that
parameter) to EVPI. This represents the relative 'importance' of each
parameter in terms of the expected value of information." />
<meta property="og:image" content="/logo.png" />




<!-- mathjax -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/MathJax.js" integrity="sha256-nvJJv9wWKEm88qvoQl9ekL2J+k/RWIsaSScxxlsrv8k=" crossorigin="anonymous"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/config/TeX-AMS-MML_HTMLorMML.js" integrity="sha256-84DKXVJXs0/F8OTMzX4UR909+jtl4G7SPypPavF+GfA=" crossorigin="anonymous"></script>

<!--[if lt IE 9]>
<script src="https://oss.maxcdn.com/html5shiv/3.7.3/html5shiv.min.js"></script>
<script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
<![endif]-->



  </head>

  <body data-spy="scroll" data-target="#toc">
    <div class="container template-reference-topic">
      <header>
      <div class="navbar navbar-default navbar-fixed-top" role="navigation">
  <div class="container">
    <div class="navbar-header">
      <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false">
        <span class="sr-only">Toggle navigation</span>
        <span class="icon-bar"></span>
        <span class="icon-bar"></span>
        <span class="icon-bar"></span>
      </button>
      <span class="navbar-brand">
        <a class="navbar-link" href="../index.html">BCEA</a>
        <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="Released version">2.4</span>
      </span>
    </div>

    <div id="navbar" class="navbar-collapse collapse">
      <ul class="nav navbar-nav">
        <li>
  <a href="../index.html">
    <span class="fas fa fas fa-home fa-lg"></span>
     
  </a>
</li>
<li>
  <a href="../reference/index.html">Reference</a>
</li>
<li class="dropdown">
  <a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-expanded="false">
    Articles
     
    <span class="caret"></span>
  </a>
  <ul class="dropdown-menu" role="menu">
    <li>
      <a href="../articles/ceac.html">Cost-effectiveness acceptability curve plots</a>
    </li>
    <li class="divider"></li>
    <li>
      <a href="../articles/index.html">More...</a>
    </li>
  </ul>
</li>
<li>
  <a href="../news/index.html">Changelog</a>
</li>
      </ul>
      <ul class="nav navbar-nav navbar-right">
        <li>
  <a href="https://github.com/giabaio/BCEA/">
    <span class="fab fa fab fa-github fa-lg"></span>
     
  </a>
</li>
      </ul>
      
    </div><!--/.nav-collapse -->
  </div><!--/.container -->
</div><!--/.navbar -->

      

      </header>

<div class="row">
  <div class="col-md-9 contents">
    <div class="page-header">
    <h1>Info-Rank Plot</h1>
    <small class="dont-index">Source: <a href='https://github.com/giabaio/BCEA/blob/master/R/info.rank.R'><code>R/info.rank.R</code></a></small>
    <div class="hidden name"><code>info.rank.bcea.Rd</code></div>
    </div>

    <div class="ref-description">
    <p>Produces a plot similar to a Tornado-plot, but based on the analysis of the
EVPPI. For each parameter and value of the willingness-to-pay threshold, a
barchart is plotted to describe the ratio of EVPPI (specific to that
parameter) to EVPI. This represents the relative 'importance' of each
parameter in terms of the expected value of information.</p>
    </div>

    <pre class="usage"><span class='co'># S3 method for bcea</span>
<span class='fu'>info.rank</span>(
  <span class='no'>he</span>,
  <span class='no'>parameter</span>,
  <span class='no'>input</span>,
  <span class='kw'>wtp</span> <span class='kw'>=</span> <span class='no'>he</span>$<span class='no'>k</span>[<span class='fu'><a href='https://rdrr.io/r/base/Extremes.html'>min</a></span>(<span class='fu'><a href='https://rdrr.io/r/base/which.html'>which</a></span>(<span class='no'>he</span>$<span class='no'>k</span> <span class='kw'>&gt;=</span> <span class='no'>he</span>$<span class='no'>ICER</span>))],
  <span class='kw'>howManyPars</span> <span class='kw'>=</span> <span class='kw'>NULL</span>,
  <span class='kw'>graph</span> <span class='kw'>=</span> <span class='fu'><a href='Vaccine.html'>c</a></span>(<span class='st'>"base"</span>, <span class='st'>"plotly"</span>),
  <span class='no'>...</span>
)</pre>

    <h2 class="hasAnchor" id="arguments"><a class="anchor" href="#arguments"></a>Arguments</h2>
    <table class="ref-arguments">
    <colgroup><col class="name" /><col class="desc" /></colgroup>
    <tr>
      <th>he</th>
      <td><p>A <code>bcea</code> object containing the results of the Bayesian
modelling and the economic evaluation.</p></td>
    </tr>
    <tr>
      <th>parameter</th>
      <td><p>A vector of parameters for which the individual EVPPI
should be calculated. This can be given as a string (or vector of strings)
of names or a numeric vector, corresponding to the column numbers of
important parameters.</p></td>
    </tr>
    <tr>
      <th>input</th>
      <td><p>A matrix containing the simulations for all the parameters
monitored by the call to JAGS or BUGS. The matrix should have column names
matching the names of the parameters and the values in the vector parameter
should match at least one of those values.</p></td>
    </tr>
    <tr>
      <th>wtp</th>
      <td><p>A value of the wtp for which the analysis should be performed. If
not specified then the break-even point for the current model will be used.</p></td>
    </tr>
    <tr>
      <th>howManyPars</th>
      <td><p>Optional maximum number of parameters to be included in the bar plot. 
Includes all parameters by default.</p></td>
    </tr>
    <tr>
      <th>graph</th>
      <td><p>A string used to select the graphical enging to use for plotting.
Should (partial-)match one of the two options "base" or "plotly". Default value is "base"</p></td>
    </tr>
    <tr>
      <th>...</th>
      <td><p>Additional options. These include graphical parameters that the
user can specify:</p><ul>
<li><p><code>xlim</code> = limits of the x-axis; ca = font size for the axis
label (default = 0.7 of full size).</p></li>
<li><p><code>cn</code> = font size for the parameter names
vector (default = 0.7 of full size) - base graphics only.</p></li>
<li><p><code>mai</code> = margins of the graph (default = c(1.36,1.5,1,1)) - base graphics only.</p></li>
<li><p><code>rel</code> = logical argument that specifies whether the ratio of
EVPPI to EVPI (<code>rel=TRUE</code>, default) or the absolute value of the EVPPI
should be used for the analysis.</p></li>
</ul></td>
    </tr>
    </table>

    <h2 class="hasAnchor" id="value"><a class="anchor" href="#value"></a>Value</h2>

    

<dt>res</dt><dd><p>With base graphics: A data.frame containing the ranking of the parameters
  with the value of the selected summary, for the chosen wtp; with plotly: a plotly object, 
  incorporating in the $rank element the data.frame as above.</p></dd>
  The function produces a 'Info-rank' plot. This is an extension of standard 'Tornado
  plots' and presents a ranking of the model parameters in terms of their
  impact on the expected value of information. For each parameter, the
  specific individual EVPPI is computed and used to measure the impact of
  uncertainty in that parameter over the decision-making process, in terms of
  how large the expected value of gaining more information is.

    <h2 class="hasAnchor" id="references"><a class="anchor" href="#references"></a>References</h2>

    <p>Baio, G., Dawid, A. P. (2011). Probabilistic Sensitivity
Analysis in Health Economics.  Statistical Methods in Medical Research
doi:10.1177/0962280211419832.</p>
<p>Baio G. (2012). Bayesian Methods in Health Economics. CRC/Chapman Hall, London</p>
    <h2 class="hasAnchor" id="see-also"><a class="anchor" href="#see-also"></a>See also</h2>

    <div class='dont-index'><p><code><a href='bcea.html'>bcea</a></code>, <code><a href='evppi.html'>evppi</a></code></p></div>

  </div>
  <div class="col-md-3 hidden-xs hidden-sm" id="pkgdown-sidebar">
    <nav id="toc" data-toggle="toc" class="sticky-top">
      <h2 data-toc-skip>Contents</h2>
    </nav>
  </div>
</div>


      <footer>
      <div class="copyright">
  <p>Developed by Gianluca Baio, Andrea Berardi, Anna Heath, Nathan Green.</p>
</div>

<div class="pkgdown">
  <p>Site built with <a href="https://pkgdown.r-lib.org/">pkgdown</a> 1.5.1.</p>
</div>

      </footer>
   </div>

  


  </body>
</html>


