rGEDI (version 0.6.0)

getGEDITrack: Extract a GEDI reference ground track

Description

Standardizes footprint coordinates, acquisition order, and beam identifiers from any open point-level GEDI product or an extracted footprint table. The result can be plotted directly or passed to plot_gedi_orbit_animation().

Usage

getGEDITrack(
  x,
  lon = NULL,
  lat = NULL,
  time = NULL,
  track = NULL,
  beams = NULL,
  every = 1L,
  segment_gaps = TRUE
)

Value

A data.table::data.table with longitude, latitude, sequence, track, and available time and shot identifiers.

Arguments

x

A data frame, data.table, sf or SpatVector containing GEDI footprint coordinates; an open gedi.level1b, gedi.level2a, gedi.level2b, or gedi.level4a object; or a list of these objects from consecutive production granules in one orbit.

lon, lat

Names of longitude and latitude columns. When NULL, common GEDI coordinate names are detected automatically.

time

Optional name of a column used to order footprints within each track. GEDI delta_time and shot_number columns are detected by default.

track

Optional name of a beam or track column. Separate tracks are colored independently.

beams

Optional beam names to read from an open GEDI object.

every

Keep every nth footprint after ordering. This is useful when plotting a complete orbit.

segment_gaps

Append segment numbers to track names when unusually large spatial gaps occur. Animation keeps this disabled so consecutive GEDI production granules remain one beam for a complete orbit.

Examples

shots <- data.frame(
  lon_lowestmode = seq(-44.2, -44.1, length.out = 10),
  lat_lowestmode = seq(-13.8, -13.7, length.out = 10),
  delta_time = seq_len(10), beam = "BEAM0000"
)
getGEDITrack(shots, every = 2)