Get fuel mix for one or more countries or regions

get_fuel_mix(
  region_name,
  collapse_renewables = TRUE,
  quiet = FALSE,
  region_code = NULL
)

Arguments

region_name

A character vector with the names of one or more countries or regions to look up

collapse_renewables

Combine hydroelectricity and other renewables into a single category.

quiet

Suppress warnings if there is no data for that country or region.

region_code

Optional three-letter country or region codes to look up instead of the region_name

Value

A tibble of fuel mix for the countries or regions specified. That is, the number of quads of each fuel and the fraction of total primary energy coming from that fuel for each country or region:

region

The name of the country or region

year

The year reported

fuel

The name of the fuel

quads

The number of quads per year the country or region consumes

frac

The fraction of the country's energy that comes from that fuel

Note

In the latest data from the Energy Institute, there are small discrepancies between the sums of energy for each fuel and the totals, in both quads and frac, for Hong Kong and Sri Lanka, as described in the documentation for fuel_mix.

See also

Examples

get_fuel_mix("United States")
#> # A tibble: 5 × 5
#>   region         year fuel        quads   frac
#>   <chr>         <int> <ord>       <dbl>  <dbl>
#> 1 United States  2023 Oil         34.0  0.380 
#> 2 United States  2023 Natural Gas 30.2  0.338 
#> 3 United States  2023 Coal         7.77 0.0869
#> 4 United States  2023 Nuclear      6.94 0.0777
#> 5 United States  2023 Renewables  10.4  0.117 
get_fuel_mix("World", collapse_renewables = FALSE)
#> # A tibble: 6 × 6
#>   region  year fuel        quads   frac `"region"`
#>   <chr>  <int> <ord>       <dbl>  <dbl> <chr>     
#> 1 World   2023 Oil         186.  0.317  region    
#> 2 World   2023 Natural Gas 137.  0.233  region    
#> 3 World   2023 Coal        155.  0.265  region    
#> 4 World   2023 Nuclear      23.3 0.0396 region    
#> 5 World   2023 Hydro        37.6 0.0640 region    
#> 6 World   2023 Renewables   47.9 0.0816 region    
get_fuel_mix(region_code = "LCN")
#> # A tibble: 5 × 5
#>   region                       year fuel         quads    frac
#>   <chr>                       <int> <ord>        <dbl>   <dbl>
#> 1 Latin America and Caribbean  2023 Coal         1.35  0.0360 
#> 2 Latin America and Caribbean  2023 Renewables  11.2   0.297  
#> 3 Latin America and Caribbean  2023 Natural Gas  8.85  0.235  
#> 4 Latin America and Caribbean  2023 Nuclear      0.305 0.00810
#> 5 Latin America and Caribbean  2023 Oil         16.0   0.424