Skip to content

bluegreen-labs/phenocamr

Repository files navigation

phenocamr

R-CMD-check codecov CRAN_Status_Badge CRAN_Downloads

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 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:

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

development release

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

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:

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:

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, 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. 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.