Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/bluegreen-labs/phenocamr

An R Interface and Post-Processing Framework for PhenoCam Web Services
https://github.com/bluegreen-labs/phenocamr

phenocam phenocam-data phenology-modelling remote-sensing

Last synced: 3 months ago
JSON representation

An R Interface and Post-Processing Framework for PhenoCam Web Services

Awesome Lists containing this project

README

        

# phenocamr

[![R-CMD-check](https://github.com/bluegreen-labs/phenocamr/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/bluegreen-labs/phenocamr/actions/workflows/R-CMD-check.yaml)
[![codecov](https://codecov.io/gh/bluegreen-labs/phenocamr/branch/master/graph/badge.svg)](https://codecov.io/gh/bluegreen-labs/phenocamr)
[![CRAN\_Status\_Badge](https://www.r-pkg.org/badges/version/phenocamr)](https://cran.r-project.org/package=phenocamr)
![CRAN\_Downloads](https://cranlogs.r-pkg.org/badges/grand-total/phenocamr)

Facilitates the retrieval and post-processing of PhenoCam time series. The post-processing of PhenoCam data includes outlier removal and the generation of data products such as phenological transition dates. If requested complementary [Daymet climate data](https://daymet.ornl.gov/) will be downloaded and merged with the PhenoCam data for modelling purposes. For a detailed overview of the assumptions made during post-processing I refer publications by Hufkens et al. (2018) and Richardson et al. (2018).

## How to cite this package

> Hufkens K., Basler J. D., Milliman T. Melaas E., Richardson A.D. 2018
> An integrated phenology modelling framework in R: Phenology modelling
> with phenor. Methods in Ecology &
> Evolution, 9: 1-10. https://doi.org/10.1111/2041-210X.12970

## Installation

### stable release

To install the current stable release use a CRAN repository:

```R
install.packages("phenocamr")
library(phenocamr)
```

### development release

To install the development releases of the package run the following commands:

```R
if(!require(devtools)){install.package(devtools)}
devtools::install_github("bluegreen-labs/phenocamr")
library(phenocamr)
```

Vignettes are not rendered by default, if you want to include additional documentation please use:

```R
if(!require(devtools)){install.package("devtools")}
devtools::install_github("bluegreen-labs/phenocamr", build_vignettes = TRUE)
library(phenocamr)
```

## Use

To download data for a single deciduous broadleaf forest site (harvard) use the following syntax:

```R
download_phenocam(site = "harvard",
veg_type = "DB",
frequency = 3,
phenophase = TRUE,
out_dir = "~")
```

This will download all deciduous broadleaf (DB) PhenoCam time series for the "harvard" site at a 3-day time step into your home directory. In addition, the data is processed to estimate phenological transition dates (phenophases) and written to file. For detailed overview of all functions and worked example we reference to the R help documentation and the manuscripts below.

## References

Hufkens K., Basler J. D., Milliman T. Melaas E., Richardson A.D. 2018 [An integrated phenology modelling framework in R: Phenology modelling with phenor. Methods in Ecology & Evolution](https://onlinelibrary.wiley.com/doi/10.1111/2041-210X.12970/full), 9: 1-10.

Richardson, A.D., Hufkens, K., Milliman, T., Aubrecht, D.M., Chen, M., Gray, J.M., Johnston, M.R., Keenan, T.F., Klosterman, S.T., Kosmala, M., Melaas, E.K., Friedl, M.A., Frolking, S. 2017. [Tracking vegetation phenology across diverse North American biomes using PhenoCam imagery](https://www.nature.com/articles/sdata201828). Scientific Data, 5, 180028.

## Acknowledgements

This project was is supported by the National Science Foundation’s Macro-system Biology Program (awards EF-1065029 and EF-1702697). Logo design elements are taken from the FontAwesome library according to [these terms](https://fontawesome.com/license).