The Phylogenetic Ornstein-Uhlenbeck Mixed Model (POUMM) allows to estimate the phylogenetic heritability of a continuous trait, to test hypotheses of neutral evolution versus stabilizing selection, to quantify the strength of stabilizing selection, to estimate measurement error and to make predictions about the evolution of a phenotype and phenotypic variation in a population. The POUMM package provides an easy and efficient way to perform this variety of analyses on large macro-evolutionary or epidemic trees. It implements a fast-likelihood calculation algorithm enabling MCMC-sampling with millions of iterations within minutes on contemporary multiple core processors. The package provides functions for configuring the fit of the model and a number of standard generic functions such as logLik, plot, summary, allowing a visual and a statistical assessment of the goodness of fit. This is an important step before using the model fit to answer relevant biological questions.

Here is a quick example on how to use the package on a simulated tree and trait data:

```
# number of tips
<- 500
N
# phylogeny
<- ape::rtree(N)
tr
# for the example, simulate trait values on the tree according to a POUMM model.
<- rVNodesGivenTreePOUMM(
z tree = tr,
z0 = 0, # fixed value at the root
alpha = 2, # selection strength of the OU process
theta = 3, # long term mean of the OU process
sigma = 1, # unit-time standard deviation of the OU process
sigmae = 1 # standard deviation of the non-heritable component
1:N] # only the values at the N tips will be available in reality
)[
# A combined ML and MCMC fit of the model with default parameter settings.
<- POUMM(z, tr)
fit
plot(fit)
summary(fit)
AIC(fit)
BIC(fit)
coef(fit)
logLik(fit)
fitted(fit)
plot(resid(fit))
abline(h=0)
# fit PMM to the same data and do a likelihood ratio test
<- POUMM(z, tr)
fitPMM ::lrtest(fitPMM, fit) lmtest
```

For an introduction to the model parameters and the package, read the
User
guide. More advanced topics, such as parametrizations and
interpretations of the model fit are covered in the other package vignettes
and in the package help-pages, e.g. `?POUMM`

,
`?specifyPOUMM`

, `?summary.POUMM`

,
`?plot.POUMM`

.

Read the section Installing the POUMM R-package in Get started.

The package source-code is available on github.

Copyright 2015-2020 Venelin Mitov

Source code to POUMM is made available under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. POUMM is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for details.

Check-out the package web-page for the latest news and further documentation.