MARSS stands for Multivariate Auto-Regressive(1) State-Space. The MARSS package is an R package for estimating the parameters of linear MARSS models with Gaussian errors. This class of model is extremely important in the study of linear stochastic dynamical systems, and these models are important in many different fields, including economics, engineering, genetics, physics and ecology. The model class has different names in different fields, for example in some fields they are termed dynamic linear models (DLMs) or vector autoregressive (VAR) state-space models. The MARSS package allows you to easily fit time-varying constrained and unconstrained MARSS models with or without covariates to multivariate time-series data via maximum-likelihood using primarily an EM algorithm.
To install MARSS from CRAN:
The latest release on GitHub may be ahead of the CRAN release. To install the latest release on GitHub:
install.packages("devtools") library(devtools) install_github("nwfsc-timeseries/MARSS@*release") library(MARSS)
The master branch on GitHub has work leading up to a GitHub release. The code here may be broken though usually prelim work is done on a development branch before merging. To install the master branch:
If you are on a Windows machine and get an error saying ‘loading failed for i386’ or similar, then try
options(devtools.install.args = "--no-multiarch")
If R asks you to update packages, and then proceeds to fail at installation because of a warning that a package was built under a later R version than you have on your computer, use
To install an R package from GitHub, you need to be able to build an R package on your machine. If you are on Windows, that means you will need to install Rtools. On a Mac, installation should work fine; you don’t need to install anything.
DOCUMENTATION and TUTORIALS
- Quick Start Guide.
- User Manual - The extensive user manual included in the package has many examples of how to fit MARSS models to a variety of data sets.
- ATSA lab book - Many applications are also covered in our Applied Time Series Analysis book developed from the labs in our course.
- ATSA course website - We have lectures and all material from our course on our course website.
- Wiki - The MARSS wiki has misc and random projects and code.
ISSUES and BUG REPORTS
If you use MARSS results in publications, please cite the primary citation:
Holmes, E. E., Ward, E. J. and Wills, K. (2012) MARSS: Multivariate Autoregressive State-space Models for Analyzing Time-series Data. The R Journal. 4(1):11-19
You can also cite the package as you would other R packages:
Elizabeth Holmes, Eric Ward, Mark Scheuerell, and Kellie Wills (2019). MARSS: Multivariate Autoregressive State-Space Modeling. R package version 3.10.13.
Update the version number and year if you use a more recent version on GitHub.
To see our publications using MARSS models, see the Applied Time Series Analysis website.
MARSS was developed by US federal government employees as part of their official duties. As such, it is not subject to copyright protection and is considered “public domain” (see 17 USC § 105). Public domain software can be used by anyone for any purpose, and cannot be released under a copyright license.