Skip to contents

List the ERA5 variables a backend and product can return

Source: R/pressurepath_variable.R
pressurepath_variable_available.Rd

The variables available to pressurepath_create() depend on both the backend and the ERA5 product, and the sets genuinely differ. GeoPressureAPI serves whatever bands the underlying Earth Engine collection carries: 292 for ERA5 single levels against 70 for ERA5-Land, with only 44 in common. era5_dataset = "both" mosaics ERA5-Land on top of ERA5 but returns ERA5's band namespace, so its set equals "single-levels" and ERA5-Land-only bands are dropped. The ARCO backend reads ECMWF's zarr stores directly and currently maps only surface pressure and 2 m temperature, so it can return "surface_pressure" and the derived "altitude".

Usage

pressurepath_variable_available(
  source = c("api", "arco"),
  era5_dataset = c("single-levels", "land", "both")
)

Arguments

source

Backend: "api" or "arco".

era5_dataset

ERA5 product: "single-levels", "land", or "both".

Value

A character vector of variable names accepted by variable, including "altitude".

Details

Requesting a variable the chosen product does not have used to fail silently: GeoPressureAPI returned 200 success with every array empty — not just the missing one — which arrived as a pressurepath whose ERA5 columns were all NA. pressurepath_create() now validates the request up front with this list.

See also

Other pressurepath: geopressure_timeseries(), plot_pressurepath(), pressurepath_create()

Examples

length(pressurepath_variable_available("api", "single-levels"))
#> [1] 293
length(pressurepath_variable_available("api", "land"))
#> [1] 71
pressurepath_variable_available("arco", "land")
#>  [1] "altitude"                            "dewpoint_temperature_2m"            
#>  [3] "soil_temperature_level_1"            "soil_temperature_level_2"           
#>  [5] "soil_temperature_level_3"            "soil_temperature_level_4"           
#>  [7] "surface_pressure"                    "surface_solar_radiation_downwards"  
#>  [9] "surface_thermal_radiation_downwards" "temperature_2m"                     
#> [11] "total_precipitation"                 "u_component_of_wind_10m"            
#> [13] "v_component_of_wind_10m"             "volumetric_soil_water_layer_1"      
#> [15] "volumetric_soil_water_layer_2"       "volumetric_soil_water_layer_3"      
#> [17] "volumetric_soil_water_layer_4"