npn_get_custom_agdd_raster: Get Custom AGDD Raster Map

In rnpn: Interface to the National 'Phenology' Network 'API'

Get Custom AGDD Raster Map

Description

This function takes a series of variables used in calculating AGDD and returns a raster of the continental USA with each pixel representing the calculated AGDD value based on start and end date. This function leverages the USA-NPN geo web services.

Usage

npn_get_custom_agdd_raster(
  method,
  climate_data_source,
  temp_unit,
  start_date,
  end_date,
  base_temp,
  upper_threshold = NULL
)

Arguments

method	Takes "simple" or "double-sine" as input. This is the AGDD calculation method to use for each data point. Simple refers to simple averaging.
climate_data_source	Specified the climate data set to use. Takes either "PRISM" or "NCEP" as input.
temp_unit	The unit of temperature to use in the calculation. Takes either "Fahrenheit" or "Celsius" as input.
start_date	Date at which to begin the AGDD calculations.
end_date	Date at which to end the AGDD calculations.
base_temp	This is the lowest temperature for each day for it to be considered in the calculation.
upper_threshold	This parameter is only applicable for the double-sine method. This sets the highest temperature to be considered in any given day's AGDD calculation.

Value

A terra::SpatRaster object of each calculated AGDD numeric values based on specified time period/method/base temp/data source.

Examples

## Not run: 
res <- npn_get_custom_agdd_raster(
  method = "simple",
  climate_data_source = "NCEP",
  temp_unit = "Fahrenheit",
  start_date = "2020-01-01",
  end_date = "2020-01-15",
  base_temp = 32
)

## End(Not run)

rnpn documentation built on Aug. 25, 2025, 9:52 a.m.