Skip to contents

NetCDF Reformatter

Source: R/02_csv_conversion.R
netcdf_df_formatter.Rd

Reformats ERA5-Land .nc data into a data frame.

Usage

netcdf_df_formatter(nc_file_path = NULL, site_lat = NULL, site_lon = NULL)

Arguments

nc_file_path

(character) File path to ERA5-Land netCDF file.

site_lat

(numeric) Latitude coordinate of site in decimal degrees.

site_lon

(numeric) Longitude coordinate of site in decimal degrees.

Value

(data.frame) Data frame of the following characteristics:

  • Datetime stamp column named "time".

  • UTC timezones converted to local time.

  • Time column formatted as yyyyMMddHHmm, time zone determined using coordinates.

  • Variables names from ERA5-Land dataset maintained.

  • ERA5-Land units converted to AmeriFlux units:

    • Solar radiation (ssrd) from Jm-2 to Wm-2.

    • Air Temperature (t2m) from Kelvin to Celsius.

    • Total precipitation (tp) from meters to millimeters.

Examples

# Point to a netCDF file
nc_file_path <- system.file("extdata", "example_path_to_ERA5_download_folder",
                            "ERA5-US-GL2-2025-1.nc", package = "ERA5Flux")

# Specify the site latitude and longitude coordinates
site_lat <- 46.7167
site_lon <- -87.4

# Reformat the netCDF
result <- netcdf_df_formatter(nc_file_path, site_lat, site_lon)
head(result)
#>           time   ssrd
#> 1 202412311900 670.36
#> 2 202412312000   0.00
#> 3 202412312100   0.00
#> 4 202412312200   0.00
#> 5 202412312300   0.00
#> 6 202501010000   0.00