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.
INSTALL
To install MARSS from CRAN:
install.packages("MARSS")
library(MARSS)
The latest release on GitHub may be ahead of the CRAN release. To install the latest release on GitHub:
install.packages("devtools") # if needed
devtools::install_github("atsa-es/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:
install_github("atsa-es/MARSS")
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
Sys.setenv(R_REMOTES_NO_ERRORS_FROM_WARNINGS=TRUE)
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 may need to install Rtools. In more recent versions of R, it seems like the Rtools dependency for Windows users has been removed, so try installing. If you get an error about no gcc installation, it means you need Rtools. On a Mac, installation should work fine; you do not 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. Select the Lectures tab to find the lecture material and videos of lectures.
- Wiki - The MARSS wiki has misc and random projects and code.
ISSUES and BUG REPORTS
Issues? https://github.com/atsa-es/MARSS/issues
CITATION
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 and user guide:
Elizabeth E. Holmes, Eric J. Ward, Mark D. Scheuerell and Kellie Wills (2020). MARSS: Multivariate Autoregressive State-Space Modeling. R package version 3.11.4.
Holmes, E. E., M. D. Scheuerell, and E. J. Ward (“, year, “) Analysis of multivariate time-series using the MARSS package. Version “, meta$Version, “. NOAA Fisheries, Northwest Fisheries Science Center, 2725 Montlake Blvd E., Seattle, WA 98112, DOI: 10.5281/zenodo.5781847
Type citation("MARSS") at the command line to get the most up to data citations.
PUBLICATIONS
To see our publications using MARSS models, see the Applied Time Series Analysis website.
NOAA Disclaimer
This repository is a scientific product and is not official communication of the National Oceanic and Atmospheric Administration, or the United States Department of Commerce. All NOAA GitHub project code is provided on an ‘as is’ basis and the user assumes responsibility for its use. Any claims against the Department of Commerce or Department of Commerce bureaus stemming from the use of this GitHub project will be governed by all applicable Federal law. Any reference to specific commercial products, processes, or services by service mark, trademark, manufacturer, or otherwise, does not constitute or imply their endorsement, recommendation or favoring by the Department of Commerce. The Department of Commerce seal and logo, or the seal and logo of a DOC bureau, shall not be used in any manner to imply endorsement of any commercial product or activity by DOC or the United States Government.