gedifinder: GEDI finder

In carlos-alberto-silva/rGEDI: NASA's Global Ecosystem Dynamics Investigation (GEDI) Data Visualization and Processing

GEDI finder

Description

This function finds the exact granule(s) that contain GEDI data for a given region of interest and date range

Usage

gedifinder(
  product,
  ul_lat,
  ul_lon,
  lr_lat,
  lr_lon,
  version = "002",
  daterange = NULL
)

Arguments

product	GEDI data level; Options: "GEDI01_B", "GEDI02_A", "GEDI02_B", "GEDI03", "GEDI04_A", "GEDI04_A", "GEDI04_B"
ul_lat	Numeric. Upper left (ul) corner coordinates, in lat (decimal degrees) for the bounding box of the area of interest.
ul_lon	Numeric. Upper left (ul) corner coordinates, in lon (decimal degrees) for the bounding box of the area of interest.
lr_lat	Numeric. Lower right (ul) corner coordinates, in lat (decimal degrees) for the bounding box of the area of interest.
lr_lon	Numeric. Lower right (ul) corner coordinates, in lon (decimal degrees) for the bounding box of the area of interest.
version	Character. The version of the GEDI product files to be returned. Default "002".
daterange	Vector. Date range. Specify your start and end dates using ISO 8601 [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss]Z. Ex.: c("2019-07-01T00:00:00Z","2020-05-22T23:59:59Z"). If NULL (default), the date range filter will be not applied.

Value

Return a vector object pointing out the path saving the downloaded GEDI data within the boundary box coordinates provided

See Also

bbox: Defined by the upper left and lower right corner coordinates, in lat,lon ordering, for the bounding box of the area of interest (e.g. [ul_lat,ul_lon,lr_lat,lr_lon]).

This function relies on the existing CMR tool: https://cmr.earthdata.nasa.gov/search/site/docs/search/api.html

Examples

# gedifinder is a web service provided by NASA
# usually the request takes more than 5 seconds

# Specifying bounding box coordinates
ul_lat <- 42.0
ul_lon <- -100
lr_lat <- 40.0
lr_lon <- -96.0

# Specifying the date range
daterange <- c("2019-07-01", "2020-05-22")

# Extracting the path to GEDI data for the specified boundary box coordinates
gedi02b_list <- gedifinder(
  product = "GEDI02_B",
  ul_lat,
  ul_lon,
  lr_lat,
  lr_lon,
  version = "002",
  daterange = daterange
)

carlos-alberto-silva/rGEDI documentation built on Oct. 18, 2024, 4:46 a.m.