In klvoje/evoTS: Analyses of Evolutionary Time-Series

```r knitr::opts_chunk$set( collapse = TRUE, comment = "#>", fig.path = "man/figures/README-", out.width = "100%" )

# evoTS - analysis of evolutionary sequences of phenotypic change

<!-- badges: start -->
  <!-- badges: end -->

  The `evoTS` package facilitates univariate and multivariate analysis of evolutionary sequences of phenotypic change. The goal of the `evoTS` package is to offer a large range of evolutionary models to enable more detailed studies of evolutionary changes within lineages.

The `evoTS` package extends the modeling framework available in the <a https://CRAN.R-project.org/package=paleoTS"> `paleoTS` package</a>. evoTS` has been developed to mirror the user experience from `paleoTS` as much as possible. All univariate models implemented in `evoTS` can be fitted to a `paleoTS` object, i.e. the data format used in `paleoTS`. The fit of all univariate models available in `paleoTS` and `evoTS` are directly comparable using the reported AICc. 

`evoTS` contains a range of multivariate models, including different versions of multivariate unbiased random walks and Ornstein-Uhlenbeck processes. Together, these models allow the user to test various hypotheses of trait evolution, e.g.  whether traits change in a correlated or uncorrelated manner, whether one trait/variable affects the optimum of a second trait (Granger causality), whether adaptation in different traits happen independently toward fixed optima etc. 

`evoTS` also contains functions for calculating the topology of the likelihood surfaces of fitted models, a useful feature to investigate the range of parameter values with approximately equal likelihood as the best parameter estimates.


## Installation

The evoTS package is available on GitHub and can be installed using devtools: 

``` r
install.packages("devtools")
devtools::install_github("klvoje/evoTS")