knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  fig.path = "README-"
)

MATSSforecasting

Build Status Codecov test coverage

Overview

MATSSforecasting is a research compendium for investigationg different approaches to forecasting ecological time series.

It implements multiple methods for forecasting single time series, as well as metrics of time series complexity, with the goal of synthesizing the results to provide guidance on forecasting methods.

Running the code

This project is set up as an R package compendium. What this means is much of the core functionality is bundled into functions that are documented and assembled into an R package, while components of the analysis are stored in a separate folder. This allows the core functions to be installed as an R package, while using a relatively lightweight script and report for the sceintific analysis, which can then be more easily adapted, extended, or changed.

The recommended way to run the analysis, and/or contribute to the analyses is as follows:

Installation

There are two main ways to install the package. You can install it using the automated tools in remotes:

# install.packages("remotes")
remotes::install_github("weecology/MATSS-forecasting")

This will automatically install any dependencies, so is a good way to get started.

Cloning the repo

However, you will also want the analysis scripts, which are included in this github repo, but are not part of the package. You will want to clone this repo using Git. Here are some instructions if you are unfamiliar.

This will then enable you to get the most recent version of the code, by using the git pull command from a command-line terminal, or by using RStudio's Git functionality (on the Git pane, use the "Pull" button).

Since this project is under active development, the codebase is likely to change frequently, and with new dependencies. Be aware that re-installing from github regularly may be the easiest way to keep up to date on dependencies.

Re-building the package

With changes to the package components, you will want to re-build and install the latest copy. You can do this following the instructions above using devtools. Or if you already have an updated copy within RStudio, use "Install and Restart" from the "Build" pane.

Analysis Code

The main control of analysis scripts can be found in analysis/main.R.

Reports

Summarized reports generated via Rmarkdown are visible in the reports folder. Any files with a .md extension should be viewable from within GitHub.



weecology/MATSS-forecasting documentation built on Nov. 28, 2020, 10:19 a.m.