IRIS Toolbox Reference Manual

## plotpp

Plot prior and/or posterior distributions and/or posterior mode

#### Syntax

    [PrG,PoG,H] = grfun.plotpp(E,[],[],...)
    [PrG,PoG,H] = grfun.plotpp(E,Est,[],...)
    [PrG,PoG,H] = grfun.plotpp(E,[],Theta,...)
    [PrG,PoG,H] = grfun.plotpp(E,[],Stats,...)
    [PrG,PoG,H] = grfun.plotpp(E,Est,Theta,...)
    [PrG,PoG,H] = grfun.plotpp(E,Est,Stats,...)

#### Input arguments

- `E` [ struct ] - Estimation input struct, see `estimate`, with prior function handles from the logdist package.

- `Est` [ struct | empty ] - Output struct returned by the `model/estimate` function; `Est` will be used to plot the maximised posterior modes.

- `Theta` [ numeric | empty ] - Array with the chain of draws from the posterior simulator `arwm`.

- `Stats` [ struct | empty ] - Output struct returned by the posterior simulator statistics function `stats`.

#### Output arguments

- `PrG` [ struct ] - Struct with x- and y-axis coordinates to plot the prior distribution for each parameter.

- `PoG` [ struct ] - Struct with x- and y-axis coordinates to plot the posterior distribution for each parameter.

- `H` [ struct ] - Struct with handles to the graphics objects plotted by `plotpp`; the struct has the following fields with vectors of handles: `figure`, `axes`, `prior`, `poster`, `bounds`, `init`, `mode`, `title`.

#### Options

- `'caption='` [ empty | cellstr ] - User-supplied graph titles; if empty, default captions will be automatically created.

- `'describe='` [ 'auto' | true | false ] - Include information on prior distributions, starting values, and maximised posterior modes in the graph titles; `'auto'` means the descriptions will be shown only if `'plotPrior='` is true.

- `'ksdensity='` [ numeric | empty ] - Number of points over which the density will be calculated; if empty, default number will be used depending on the backend function available.

- `'plotInit='` [ `true` | `false` | cell ] - Plot starting values (initial consition used in posterior mode maximisation) as vertical stems.

- `'plotPrior='` [ `true` | `false` | cell ] - Plot prior distributions.

- `'plotMode='` [ `true` | `false` | cell ] - Plot maximised posterior modes as vertical stems; the modes are taken from `Est` (and not from `Stats` or `Theta`).

- `'plotPoster='` [ `true` | `false` | cell ] - Plot posterior distributions.

- `'plotBounds='` [ `true` | `false` | cell ] - Plot lower and/or upper bounds as vertical lines; if `false`, the bounds will be plotted only added if within the graph x-limits.

- `'sigma='` [ numeric | 3 ] - Number of std devs from the mean or the mode (whichever covers a larger area) to the left and to right that will be plotted unless running out of bounds.

- `'tight='` [ `true` | `false` ] - Make graph axes tight.

- `'title=`' [ `true` | `false` | cell ] - Display graph titles, and specify graphics options for the titles.

- `'xLims='` [ struct | empty ] - Control the x-limits of the prior and posterior graphs.

#### Description

The options that control what will be plotted in the graphs (i.e. `'plotInit='`, `'plotPrior='`, `'plotMode='`, `'plotPoster='`, `'plotBounds='`,`'title='`) can be set to one of the following three values:

- `true`,
- `false`,
- a cell array with sub-options to control the appearance of the respetive line; these will be passed into the respective plotting function.

#### Example

IRIS Toolbox. Copyright © 2007—2013 Jaromir Benes.