-
Notifications
You must be signed in to change notification settings - Fork 8
/
README.Rmd
108 lines (75 loc) · 5.46 KB
/
README.Rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
---
output: github_document
---
<!-- README.md is generated from README.Rmd. Please edit that file -->
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```
# MATSS
<!-- badges: start -->
[![Build Status](https://travis-ci.org/weecology/MATSS.svg?branch=master)](https://travis-ci.org/weecology/MATSS)
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/weecology/MATSS/master/LICENSE)
[![Coverage
status](https://codecov.io/gh/weecology/MATSS/branch/master/graph/badge.svg)](https://codecov.io/github/weecology/MATSS?branch=master)
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.3333008.svg)](https://doi.org/10.5281/zenodo.3333008)
<!-- badges: end -->
## Overview
**`MATSS`** is a package for conducting Macroecological Analyses of Time Series Structure. We designed it to help researchers quickly get started in analyses of ecological time series, and to reinforce and spread good practices in computational analyses.
We provide functionality to:
- obtain time series data from ecological communities, processed into a common [data format](weecology.github.io/articles/data-formats.html)
- perform basic processing and summaries of those datasets; see [data processing](weecology.github.io/articles/data-processing.html)
- build an analysis pipeline for macroecological analyses, using the workflow framework of the `drake` package
- package the above data analytical work in a reproducible way in a [research compendium](https://weecology.github.io/MATSS/articles/MATSS.html#template-research-compendium)
## Contributing
For more information about contributing code, datasets, or analyses, please check out the [Contributing Guide](CONTRIBUTING.md).
## Installation
You can install **`MATSS`** from github with:
```{r, eval = FALSE}
# install.packages("remotes")
remotes::install_github("weecology/MATSS", build_opts = c("--no-resave-data", "--no-manual"))
```
**`MATSS`** also uses the **`rdataretriever`** package to download additional datasets. To get this package and its dependencies wokring, we recommend following the online [installation instructions](https://docs.ropensci.org/rdataretriever/).
## Datasets
```{r setup packages, include = FALSE}
library(MATSS)
library(drake)
```
```{r compute info on datasets, include = FALSE}
datasets <- build_datasets_plan(include_retriever_data = TRUE,
include_bbs_data = TRUE,
include_gpdd_data = TRUE,
include_biotime_data = TRUE)
count_ts <- function(data) {NCOL(data$abundance)}
analyses <- drake_plan(num_ts = target(count_ts(data),
transform = map(data = !!rlang::syms(datasets$target))),
total = target(sum(num_ts),
transform = combine(num_ts)))
plan <- bind_plans(datasets, analyses)
make(plan)
```
**`MATSS`** pulls data from a variety of sources, including:
* `r NROW(build_datasets_plan(include_retriever_data = TRUE))` individual datasets that we've added,
* the North American Breeding Bird Survey database (spanning `r NROW(build_bbs_datasets_plan())` separate datasets),
* the Global Population Dynamics Database (spanning `r NROW(build_gpdd_datasets_plan())` separate datasets),
* and the BioTime database (spanning `r NROW(build_biotime_datasets_plan())` separate datasets).
Combined, there are **`r readd(total)`** individual time series across all of these data sources.
## Getting Started
We recommend you take a look at our vignette on [Getting Started](https://weecology.github.io/MATSS/articles/MATSS.html) for more details about how to begin using **`MATSS`**.
If you have the package installed, you can also view the vignette from within R:
```{r, eval = FALSE}
vignette("MATSS")
```
## Example Use Cases
Here are some examples of analyses built on **`MATSS`**:
* [MATSS-LDATS](https://github.com/weecology/MATSS-LDATS) applies the [**`LDATS`**](https://github.com/weecology/LDATS) package to investigate changepoints in community dynamics across the datasets in **`MATSS`**
* [MATSS-Forecasting](https://github.com/weecology/MATSS-forecasting) investigates which properties are associated with the predictability of population time series across the datasets in **`MATSS`**
## Acknowledgments
We thank Erica Christensen and Joan Meiners for their contributions and input on early prototypes of this project. This project would not be possible without the support of Henry Senyondo and the [retriever](https://www.data-retriever.org/) team. Finally, we thank Will Landau and the [drake](https://ropensci.github.io/drake/) team for their input and responsiveness to feedback.
Package development is supported through various funding sources: including the [Gordon and Betty Moore Foundation’s Data-Driven Discovery Initiative](http://www.moore.org/programs/science/data-driven-discovery), [Grant GBMF4563](http://www.moore.org/grants/list/GBMF4563) to E. P. White (supporting also the time of J. Simonis and H. Ye), the [National Science Foundation](http://nsf.gov/), [Grant DEB-1622425](https://www.nsf.gov/awardsearch/showAward?AWD_ID=1622425) to S. K. M. Ernest, and a [National Science Foundation Graduate Research Fellowship](https://www.nsfgrfp.org/)
(No. [DGE-1315138](https://www.nsf.gov/awardsearch/showAward?AWD_ID=1315138)
and [DGE-1842473](https://www.nsf.gov/awardsearch/showAward?AWD_ID=1842473)) to R. Diaz.