The hardware and bandwidth for this mirror is donated by METANET, the Webhosting and Full Service-Cloud Provider.
If you wish to report a bug, or if you are interested in having us mirror your free-software or open-source project, please feel free to contact us at mirror[@]metanet.ch.

Getting Started with SHELF

Introduction

We illustrate the process of fitting a probabilty distribution to an expert’s judgements, and obtaining feedback.

Various elicitation methods are suggested in SHELF, but they all involve either asking for probability or quantile judgements: the expert is either asked questions of the form, ‘What is your probability \(P(X\le10)\)?’ or, ‘Provide a value \(x\) such that you think \(P(X\le x)=0.5.\)’’ Either way, we think of the expert as providing points on his/her cumulative distribution function (CDF).

As an example, suppose the uncertain quantity is the percentage \(X\) of voters who will vote for a particular candidate in an upcoming leadership election.

Eliciting individual distributions from multiple experts

Suppose we have two experts, who first consider their judgements independently. Expert A states \[P(X\le25)=0.25, P(X\le30)=0.5, P(X\le35)=0.75,\] and Expert B states \[P(X\le30)=0.25, P(X\le35)=0.5, P(X<50)=0.75.\]

The values of the quantiles are arranged in a matrix, with one column per expert

v <- matrix(c(25, 30, 35, 30, 35, 50), nrow = 3, ncol = 2)
#>      [,1] [,2]
#> [1,]   25   30
#> [2,]   30   35
#> [3,]   35   50

The probabilities should be arranged in matrix if they are different for the two experts (for example, if one expert had specified tertiles instead of lower and upper quartiles), otherwise they are stored in a vector

p <- c(0.25, 0.5, 0.75)

We now fit probability distributions to these judgements with the fitdist command. Without specifying any limits (lower and upper), only normal and Student-\(t\) distributions (with 3 degrees of freedom used as a default) will be fitted. Including a lower limit will result in log-normal, log Student-\(t\) and gamma distributions also being fitted, and including both a lower and upper limit will result in a beta distribution fit, scaled to the interval [lower, upper].

library(SHELF)
myfit <- fitdist(vals = v, probs = p, lower = 0, upper = 100)

The object myfit includes parameters of the fitted distributions for each expert, sums of squared errors (elicited - fitted probabilities) for each distribution and expert, and the original elicited judgements:

names(myfit)
#>  [1] "Normal"          "Student.t"       "Skewnormal"      "Gamma"          
#>  [5] "Log.normal"      "Log.Student.t"   "Beta"            "mirrorgamma"    
#>  [9] "mirrorlognormal" "mirrorlogt"      "ssq"             "best.fitting"   
#> [13] "vals"            "probs"           "limits"          "notes"

For example, the parameters of the fitted beta distributions are

myfit$Beta
#>            shape1    shape2
#> expert.A 11.58800 26.711428
#> expert.B  3.76511  6.000839

Inspecting myfit$ssq (sum of squared differences between elicited and fitted probabilities), we see that the normal distribution fits best for Expert 1, and the log Student-\(t_3\) distribution fits best for Expert 2 (although the fit would probably be judged adequate for any the distributions, in this case). These best-fitting distributions are used as defaults in the plotfit function, and the feedback function when used with multiple experts

myfit$ssq
#>                normal            t   skewnormal       gamma    lognormal
#> expert.A 1.109336e-31 5.564207e-12 8.936315e-32 0.000126733 0.0002833689
#> expert.B 9.495880e-03 9.351947e-03 5.872292e-03 0.007194602 0.0061172216
#>                  logt         beta  mirrorgamma mirrorlognormal   mirrorlogt
#> expert.A 0.0002740339 4.194213e-05 2.301408e-05    5.172505e-05 4.999188e-05
#> expert.B 0.0059898413 8.591167e-03 1.096068e-02    1.169358e-02 1.155278e-02

We plot the fitted distributions, including a linear pool.

plotfit(myfit, lp = TRUE)
The two fitted distributions and an equal-weighted linear pool.

The two fitted distributions and an equal-weighted linear pool.

Eliciting a single distribution from an individual or a group of experts

Now we elicit a single a single ‘consensus’ distribution from the two experts. Suppose they agree \[P(X\le 25)=0.25, P(X\le30)=0.5, P(X\le40)=0.75.\] We fit a single set of distributions to these judgements.

v <-c(25, 30, 40)
p <-c(0.25, 0.5, 0.75)
consensus <- fitdist(vals = v, probs = p, lower = 0, upper = 100)

The best fitting distribution is the log Student-\(t_3\) distribution, but the (scaled) beta distribution would likely be adequate at this stage, and we may choose to use the beta instead, given it has the appropriate bounds.

We plot the fitted density, and mark the fitted 5th and 95th percentiles

plotfit(consensus, ql = 0.05, qu = 0.95, d = "beta")
The fitted consensus distribution, with the lower and upper 5\% tail areas shown as feedback.

The fitted consensus distribution, with the lower and upper 5% tail areas shown as feedback.

We can obtain values of fitted percentiles and probabilities with the feedback function. This will show fitted values for all the fitted distributions

feedback(consensus, quantiles = c(0.05, 0.95))
#> $fitted.quantiles
#>      normal     t skewnormal gamma lognormal logt beta hist mirrorgamma
#> 0.05   12.5  7.49       20.0  16.2      17.3 14.8 15.2    5        10.5
#> 0.95   50.4 55.10       53.5  53.2      55.3 64.1 51.2   88        49.1
#>      mirrorlognormal mirrorlogt
#> 0.05            9.18       2.08
#> 0.95           48.60      52.10
#> 
#> $fitted.probabilities
#>    elicited normal     t skewnormal gamma lognormal  logt  beta hist
#> 25     0.25  0.288 0.289      0.268 0.279     0.274 0.275 0.283 0.25
#> 30     0.50  0.451 0.453      0.469 0.461     0.466 0.469 0.456 0.50
#> 40     0.75  0.772 0.774      0.767 0.769     0.767 0.768 0.770 0.75
#>    mirrorgamma mirrorlognormal mirrorlogt
#> 25       0.292           0.295      0.296
#> 30       0.446           0.444      0.447
#> 40       0.772           0.773      0.775

For the fitted beta distribution, we have \(P(X<15.2)=0.05\), and we can also compare, for example, the fitted probability \(P(X<25)=0.283\) with elicited probability \(P(X<25)=0.25\).

These binaries (installable software) and packages are in development.
They may not be fully stable and should be used with caution. We make no claims about them.