# An introduction to the caliver package

#### 2021-02-18

NOTE: This vignette is an updated and extended version of (Vitolo, Di Giuseppe, and D’Andrea 2018), since the publication of this PlosONE paper some functionalities have changed or have been deprecated.

# Abstract

The name caliver stands for CALIbration and VERification of (forest fire) gridded model outputs. This is a package developed for the R programming language and available under an APACHE-2 license from a public repository.

The caliver package was initially designed for the post-processing, calibration and validation/verification of Forest Fire Danger Forecasting models but as development progressed, it became clear that it could have a much wider applicability. The goal of this vignette is to describe the functionalities of the package, examples are given with regards to outputs of the following forest fire models: GEFF and RISICO.

# Introduction

Forecasting wildfires is a complex task, theoretically challenging and computationally demanding. From a theoretical point of view, fires are difficult to predict as they depend on a stochastic (unpredictable) component: the ignition. The trigger can be natural in origin like lightning and self-combustion. But it can also be due to human behavior as intentional act of arson or unintentional act of negligence. Quite commonly human-caused ignition is performed to encourage regeneration and biodiversity in the forest ecosystem or replace forest vegetation with agricultural crops (Vélez 2002, @McFarlane_etal_2002).

Once a fire is ignited, its spread, sustainability, and difficulty of control is almost exclusively determined by weather conditions (Flannigan et al. 2009). Flames tend to rage out of control if certain soil and atmospheric conditions are met. As the ignition is casual and very difficult to predict, fire prediction systems, used in forest management, are design to highlight these favorable weather conditions which would allow sustained fire activity and not actual fire activities. On these premises is based one of the most widespread fire danger rating system, the Canadian forest service’s Fire Weather Index (FWI) (Van Wagner and others 1974, 1333:@van1987development) which is selected here to showcase the capability of the proposed package.

The FWI is a measure of fire potential and is expressed as a numeric rating. Rating rises as fire weather becomes more severe. By construction, the relationship between the FWI numerical values and the fuel status, such as the humidity content retained in the live or dead vegetation, is weak. This implies that the same FWI values can correspond to different danger levels depending on the ecosystem. To become a meaningful tool in fire management, the FWI requires the definition of danger levels that should be site specific (we call this post-processing task ‘calibration’ hereafter). Indeed the warning levels suggested for the original FWI were derived to describe fires in a standard jack pine stand, typical of the Canadian forests. Therefore the applicability of the FWI to other parts of the planet, with vegetation characteristics dissimilar from those of the Boreal forests, requires the user to understand the fire occurrence pattern in relation to the site specific conditions. Moreover, before transferring a fire danger system from one area to another, an extensive validation/verification (the terms validation and verification are used as synonyms in this work) against forecasted and observed fire events is required to build operational confidence. In practical terms, the calibration task implies the analysis of the soil and weather conditions as synthesized by the FWI for a long period in the past, while the verification consists of the analysis of the performance of the system and danger levels applied to observed events.

From a computational point of view tailoring fire danger levels to a given area and validating the performances of an early warning system is a demanding task as it requires handling large datasets. The typical user of fire forecasting systems might not necessarily have access to powerful supercomputers or large data storages. There is a need, therefore, to design and implement post-processing algorithms in such a way that processing time and memory resources are kept to the minimum while relying on accessible hardware.

In the light of these requirements, we have developed an open-source tool called caliver that contains reproducible algorithms for the calibration and verification of the FWI danger levels. This is developed in the R statistical language (RCore 2016), it is available from a public repository and distributed under an open license.

The calibration and verification methodologies implemented in caliver rely on the availability of long term datasets of predicted and observed fire events. In the present work we test the algorithms using the FWI predictions that the European Centre for Medium-range Weather Forecasts (ECMWF) provides to the European Forest Fire Information System (EFFIS). The modeling component of EFFIS is referred to as the Global ECMWF Fire Forecast system (GEFF, (Di Giuseppe et al. 2016)). Observed fires are provided by the the Global Fire Assimilation System, which is part of the Copernicus Atmospheric Management Service. Both datasets are publicly available under open licenses.

In the following sections we present the caliver R package, illustrate the main functionalities and show the results of our experiments focused on calculating and validating fire danger thresholds for various areas in Europe. Europe is taken as an example study area but the methods are applicable worldwide. This work stems from the user-driven Copernicus EU Programme which aims at developing freely and openly accessible information services based on satellite Earth Observation and in situ data. We believe that developing transparent and reproducible analysis workflows, even more if implemented within open-source initiatives is a necessary step towards the implementation of reliable modelling tools. This is because reproducible workflows aim to streamline the processing tasks as they present ready-made solutions to efficiently manipulate complex and heterogeneous datasets. Also, opening the code to the scrutiny of other experts increases the chances to implement more robust solutions and avoids duplication of efforts.

# Package installation and dependencies

The caliver package is implemented in the R statistical language. Here we describe version 1.7.0, the latest stable release at the time of this writing. The package does not require compilation but depends on the following external libraries: the Geospatial Data Abstraction Library (Warmerdam 2008), a translator library for raster and vector geospatial data formats, and the NetCDF4 library (Rew and Davis 1990). A Dockefile is provided with the source code and docker image (ecmwf/caliver) is available from docker hub.

The caliver package is available on CRAN, therefore once all the dependencies are available, the package can be installed and loaded as follows:

install.packages("caliver")
library("caliver")

Please note that in the code snippets, we mention functions belonging to packages other than caliver and base, using the convention package_name::function_name.

## Source code availability

Our work stands for the highest standards of scientific reproducibility from the computational point of view (Añel 2011, @anel2017comment). Hence, caliver’s source code is hosted on a public repository, maintained using the git version control system and distributed under an open license: APACHE-2. Users can suggest changes and report bugs using the dedicated issue tracking system.

## Continuous integration and unit tests

In order to have a reliable development process, system dependencies, installation and basic functionalities are tested using GitHub Actions for continuous integration on windows and unix-based systems. Unit tests for the main functions are developed using the testthat framework (Wickham 2011). Software metrics, in terms of code coverage status, are tracked using the codecov platform. The current release has a code coverage of 95%.

# Datasets for testing

In this work, the functionalities implemented in the caliver package are tested using the data products from the Global ECMWF Fire Forecast (GEFF) system as well as external data sources (see below).

## Get data from the fourth-generation Global Fire Emissions Database (GFED4)

### Burned areas deprecated

Observed burned areas around the world are collected by the 4th generation Global Fire Emissions Database (Giglio, Randerson, and Werf 2013) in hdf format. This information is very important as it represents the ground truth for fire models, it is needed to make comparisons with reanalysis and forecast models and estimate their reliability. In (Vitolo, Di Giuseppe, and D’Andrea 2018), the function get_gfed4() was used to retrieve observed burned areas from GFED4. Over time the service has changed and this function has proven to be difficult to maintain.

In the current version of caliver, the funcionalities to retrieve and manipulate GFED4 burned areas have been deprecated (along with some utility functions). Please, download daily burned area maps for 2003-01-01 to 2015-12-31 manually from https://www.globalfiredata.org/data.html.

## Areas of interest

For the purpose of this vignette, we will demostrate the caliver functionalities on specific areas: Europe and Italy.

### Basis regions

GFED4 also provides, as ancillary data, a map of 14 basis regions used to evaluate regional annual emission estimates. Within the caliver package, a cached version of this map (called GFED4_BasisRegions) remains available in the ‘inst/extdata’ folder. This map can be retrieved as SpatialPolygonsDataFrame (a spatial class defined in the sp package) as follows.

library("sp")

# Get all the GFED4 basis regions
BasisRegions <- readRDS(system.file("extdata", "GFED4_BasisRegions.rds",
package = "caliver"))
plot(BasisRegions)

Europe can be subsetted from GFED4 basis regions and plotted as follows:

Europe <- BasisRegions[BasisRegions$Region == "EURO",] plot(Europe) ### Administrative boundaries Countries administrative boundaries can be obtained from the GADM dataset using the function getdata() from the raster package. As an example, below we show how to obtain Italian administrative boundaries. library("raster") # Italy Italy <- raster::getData(name = "GADM", country = "Italy", level = 0) ## The EFFIS datasets: GEFF-reanalysis and GEFF-realtime In the last three years fire danger forecasts have been developed at ECMWF as a part of the Copernicus Emergency Management Services under the guidance of the Joint Research Centre (JRC). A subset of GEFF data is feeding the EFFIS and GWIS web portals; operational platforms to access timely information for fire danger at European and Global scale, respectively. 38 local and national authorities across Europe are part of the EFFIS network and have been relying on the GEFF outputs for an early identification of regions which might experience fire events due to the establishment of persistent drought conditions. Two datasets are available: the GEFF-reanalysis and the GEFF-realtime. GEFF-reanalysis provides historical records of global fire danger conditions from 1980 to date. The historic record is not static but it is updated regularly following the availability of the atmospheric reanalysis datasets. Reanalysis datasets are used to define warning levels on the base of past events, therefore levels derived from them should not be considered static as changes in climatic conditions can alter them. There are currently 2 GEFF-reanalysis datasets, the first one (used mainly for educational purposes) is based on the atmospheric reanalysis dataset ERA-Interim (Dee et al. 2011). The second dataset is based on the most recent atmospheric reanalysis ERA5 (Hersbach et al. 2020). GEFF-realtime provides real time deterministic high resolution and probabilistic fire danger forecasts up to 10 days ahead using weather forcings from the latest model cycle of the ECMWF weather forecast system. The real-time dataset is updated every day with a new set of forecasts. This dataset is used for operational monitoring of danger conditions. Real-time data can be obtain making a data request to the JRC. In this vignette, the Fire Weather Index (from the homonymous Canadian system) ERA-Interim based reanalysis dataset is used to asses fire danger. This dataset has daily temporal resolution, global coverage (0.7 degrees, ~80 Km, with longitudes ranging between -180 to +180 in geographic coordinate systems) and spans from 1980-01-01 to 2018-12-31. It was computed by the European Centre for Medium-range Weather Forecast (ECMWF) and made available on Zenodo, for more details see (Vitolo et al. 2019). Newer and more detailed fire danger reanalysis data are available from the Copernicus Climate Data Store (CDS), for more details see (Vitolo et al. 2020). We assume the ERA-Interim based GEFF-reanalysis data have already been downloaded from Zenodo and locally available. Data are aggregated into one NetCDF file and can be loaded as RasterBrick. # Assuming the FWI reanalysis (GEFF reanalysis v3.0, 7.5GB) dataset is downloaded fwi <- raster::brick("~/repos/caliver_extras/data/fwi.nc") ## Masking data using land cover maps Vegetation is the fuel for fire. In order to carry out an accurate estimation of fire danger worldwide it is important to use an homogeneous classification of land use and vegetation. The Global Wildfire Information System (GWIS) uses the Global Land Cover 2000 database and regional products for Africa, Asia, and Europe [JRC2003]. This map is publicly available and can be downloaded from https://forobs.jrc.ec.europa.eu/products/glc2000/glc2000.php. Another example of such a map was compiled by the European Space Agency (ESA): the Climate Change Initiative (CCI) Land Cover Maps. Other land cover maps exist and the reader is invited to download and use the one more suitable for the problem at hand. The example below shows how to mask fire danger indices using the Global Land Cover 2000 map. # Global Land Cover 2000 # Documentation # https://forobs.jrc.ec.europa.eu/data/products/glc2000/GLC2000_EUR_20849EN.pdf # Get map # system("wget https://forobs.jrc.ec.europa.eu/data/products/glc2000/glc2000_v1_1_Grid.zip") # Unzip the folder in the working directory # Load map fuel <- raster::raster("~/repos/caliver_extras/data/Grid/glc2000_v1_1/w001001.adf") # Save legend in data.frame df <- as.data.frame(levels(fuel)) # If fuel and fwi have different extent and/or number of rows/cols, you will need to resample fuel <- raster::resample(fuel, fwi, method = "ngb", progress = "text") # Remove Bare Areas (19), Water Bodies (20), Snow and Ice (21), Artificial surfaces and associated areas (22), No data (23). codes_to_exclude <- 19:23 fuel[fuel %in% codes_to_exclude] <- NA levels(fuel) <- df[1:18,] # Finaly, mask the first layer in fwi fwi_masked <- raster::mask(fwi[[1]], fuel) plot(fwi_masked, col = terrain.colors(120)) # Package functionalities The primary goal of the caliver package is to streamline the post-processing of GEFF model outputs and make the scientific workflow easily reproducible. For this reason, this section provides example applications in the form of short workflows. These are ordered chronologically, based on the sequential steps a modeller would perform to visually explore information, calibrate fire danger levels and validate them. This often results in an increasing level of complexity. To provide a concise description, each workflow is not a stand alone exercise but the result of one workflow is often used as input in the following ones. ## Mask, crop and subset GEFF fire danger indices are characterized by three dimensions (latitude, longitude and time) and a variable for each index of interest. These can be masked and cropped to match a user-defined extent, this can be a geographical bounding box or a spatial polygon such as a given administrative boundary. The indices can also be subsetted over the layer index or the time dimension (e.g. to take into account only fire seasons). The function mask_crop_subset() wraps the functions raster::mask(), raster::crop() and raster::subset() and converts the result into a RasterLayer (single layer) or RasterBrick (multiple layers). The example below shows how to mask and crop the fwi brick over Italy, selecting only the reference period 1981-2010. # Get indices for climatological reference period 1981-2010 idx <- which(substr(x = names(fwi), start = 2, stop = 5) %in% 1981:2010) # Mask, crop and subset fwi_Italy <- mask_crop_subset(r = fwi, p = Italy, idx = idx, progress = "text") ## Generate daily climatology In order to understand how the fire index on a given day compares with climatological values (distribution of values during the same period in the past years, typical reference period is 1981-2010) we build a daily climatology for each day of interest. This can be done with the function daily_clima(). The function takes as input r (a RasterBrick/Stack with daily fire indices over a number of years, e.g. fwi_Italy defined in previous examples) and a sequence of dates, it then extracts from r the period that spans 4 days before and after the given date in dates (total of 9 days) for all the years available in r. The result is a list of stacks (one stack per day of interest). If dates are undefined, the function will assume all the days in a leap year are needed. # Calculate the daily climatology for the period 10-20 August clima_Italy <- daily_clima(r = fwi_Italy, dates = seq.Date(from = as.Date("2020-08-10"), to = as.Date("2020-08-20"), by = "day")) Please note that in dates the year is ignored! ## Generate maps of percentiles For each index, calculating relevant quantiles cell by cell (over time) gives an indication of the local distribution of fire danger values. There are two common approaches to derive percentile maps for fire indices: * Approach A - the percentile is calculated over the full record available over a number of years, or during the fire season over a number of years. * Approach B - the percentile is calculated on the daily climatology. In both cases such a map can be generated using the function get_percentile_map(). ### Approach A: percentile over full record The example below uses the fwi_Italy (generated in a previous section) to produce three maps, corresponding to the 50th, 75th and 90th percentile respectively. mapsA <- get_percentile_map(r = fwi_Italy, probs = c(0.50, 0.75, 0.90)) With this approach, the object mapsA is a RasterLayer (for one probability) or a RasterBrick (for more than one probability). ### Approach B: percentile over daily climatology The example below uses the clima_Italy (generated in a previous section) to produce three maps, corresponding to the 50th, 75th and 90th percentile respectively. mapsB <- get_percentile_map(r = clima_Italy, probs = c(0.50, 0.75, 0.90)) With this approach, the object mapsB is a list of RasterLayers (for one probability) or a RasterBricks (for more than one probability). The elements of the lists are named after the related date. ## Plot percentile maps Once percentile maps are generated, these can be conviniently plotted with the raster/caliver packages. The raster package provides convenient methods to plot many types of GIS layers. The caliver package builds upon these functionalities to generate pre-styled plots. The previously generated percentile maps could be visualised using the raster::plot method but the map would need to be further manipulated to overlay a background map and set the color scale to the same range so that multiple maps become comparable. The caliver function plot_percentile_map() performs these manipulations behind the scenes, incorporating a background map and placing multiple plots in a grid-like layout with the same color scale. In the example below we compare direct outputs using raster::plot() (top) versus plot_percentile_map() (bottom). # Use the raster plot method raster::plot(mapsA, main = c("FWI 50th perc.", "FWI 75th perc.", "FWI 90th perc.")) # Use the caliver plot_percentile_map function plot_percentile_map(maps = mapsA, main = c("FWI 50th perc.", "FWI 75th perc.", "FWI 90th perc.")) ## Classify fire danger indices Given a raster containing a fire danger index, e.g. fwi, this can be transformed from a continuous rating to a categorical raster using classify_index() (which is a wrapper around raster::cut() with some default settings). fwi_class <- classify_index(fwi_masked, index = "fwi", thresholds = NULL, labels = NULL) rasterVis::levelplot(fwi_class, col.regions = caliver:::effis_palette, att = "Class") The categories of GEFF’s indices are pre-defined but can be overwritten by explicitly defining the input parameters thresholds and labels. The effis_palette is pre-defined in caliver, however, any custom palette can be used. ## Fire danger levels. Raw values of fire indices are expressed as a continuous rating (e.g. FWI values are in the range [0, +Inf[, although very rarely above 100). In order to aid decision makers raw values are routinely converted into danger classes, based on predefined thresholds. The European Forest Fire Information System (EFFIS) provides a set of fire danger thresholds/classes harmonized across Europe (https://effis.jrc.ec.europa.eu/about-effis/technical-background/fire-danger-forecast). For instance, the FWI ranges are (upper bound excluded): * Very low = 0 - 5.2 * Low = 5.2 - 11.2 * Moderate = 11.2 - 21.3 * High = 21.3 - 38.0 * Very high = 38.0 - 50.0 * Extreme > 50.0 In our experience, the above thresholds are particularly suited to assess fire danger in southern Europe, e.g. in the Mediterranean Region. Some countries, tend to calibrate these thresholds depending on local vegetation characteristics and fire regimes. This require local knowledge and/or experimentation. The caliver package provides some useful functionalities for this type of tasks. The fire season is the period of the year during which 80% of wildfires have occurred. For historical analysis, this is defined a posteriori and changes year-on-year. However, a more simplistic approach assumes that the fire season is the period of the year in which wildfires are more likely to occur (this is also the assumption made by EFFIS). Therefore it often coincides with the dry season, a period in which there is a reduced soil moisture and precipitation. In this work we adopt a convention: the fire season falls between 1st April and 31st October in the northern hemisphere, and between 1st October and 30th April in the southern hemisphere. This convention is coded in the function get_fire_season(), which accepts at least two arguments: dates (the sequence of daily dates for which reanalysis data is available) and zone (which can be either ‘north’ or ‘south’ hemisphere). There are also two optional arguments that allow to define an ad-hoc fire season: fss (which stands for Fire Season Start) and fse (which stands for Fire Season End). In order to calculate the danger classes, the FWI brick should be loaded and the indices corresponding to the local fire season should be identified. In the example below the fire season is assumed constant across Europe (and Italy in particular), starting in April and ending in October each year. dataDates <- as.Date(substr(names(fwi), 2, 11), format = "%Y.%m.%d") # Define a function to extract fire seasons in Europe seasons <- get_fire_season(dates = dataDates, zone = "north") # Create an index of fire season dates fireSeasonIndex <- which(seasons == TRUE) Threshold for every area of interest are calculate on the subset of the FWI brick related to the fire season only and cropped over the area of interest. Below are examples calculated for various countries in Europe. (Vitolo, Di Giuseppe, and D’Andrea 2018) show that fire danger classes is generally correlated to the local climate and spatial variability appears to be meaningful up to regional level. # Mask/Crop/Subset FWI over Europe fwi_euro <- mask_crop_subset(r = fwi, p = Europe, idx = fireSeasonIndex) # Calculate homogenised fire danger levels (or thresholds) for Europe EuropeThr <- get_fire_danger_levels(fire_index = fwi_euro) EuropeThr Please note the differences between these danger levels and those recommended by EFFIS, caliver danger levels are generally lower than EFFIS ones. Fire danger levels are more useful when calculated at country level. Below is shown how to execute the same steps above recursively for most countries in Europe and bind the results together in a summary table. # Country level: use a loop to calculate levels for three sample countries. # Please note that in the original paper many more countries were used, here we process # only three to reduce the processing time but the procedure is exactly the same. EUcountries <- c("Spain", "GBR", "Italy") for (country in EUcountries){ print(country) country_poly <- raster::getData(name = "GADM", country = country, level = 0) # Mask/Crop/Subset FWI and generate thresholds for country country_fwi <- mask_crop_subset(r = fwi_euro, p = country_poly) country_thrs <- get_fire_danger_levels(fire_index = country_fwi) # Append values to data.frame if (country == "Spain") { df <- data.frame(matrix(country_thrs, nrow = 1)) }else{ df <- rbind(df, country_thrs) } print(df) } df_thr <- data.frame(cbind(EUcountries, df, stringsAsFactors=FALSE)) names(df_thr) <- c("Country", "Low", "Moderate", "High", "VeryHigh", "Extreme") Assessing the danger levels at regional and province level (using the ERA-Interim based dataset) is rather difficult because some areas are too small compared to the raster resolution. For assessing fire danger in small regions we suggest to use the ERA5-based fire indices (Vitolo et al. 2020). ### Plot density with thresholds The thresholds are different from the percentiles, the PDF below shows a comparison for Italy (the last country in the above loop). countryPDF <- plot_pdf(fire_index = country_fwi, thresholds = country_thrs, upper_limit = 60) ### Validate danger levels Test whether large fires correspond to FWI above high danger. library("pROC") # Assuming burned areas was downloaded and combined in a grid file, # this can be loaded as a brick: BurnedAreas <- raster::brick("GFED4_BurnedAreas/BurnedArea.grd") # Mask and crop burned areas over Europe BA <- mask_crop_subset(r = BurnedAreas, p = Europe) # If observations layers have no date, assign it! dataDates <- seq.Date(from = as.Date("2003-01-01"), to = as.Date("2015-12-31"), by = "day") names(BA) <- dataDates EuroThrHigh <- as.numeric(df_thr[df_thr$Country == "Europe", 4])

# The above can be saved and re-loaded as follows:
raster::writeRaster(BA, filename="BurnedAreaEurope.grd",
bandorder='BIL', overwrite=TRUE, progress = 'text')
BurnedAreaEurope <- raster::brick("BurnedAreaEurope.grd")

# For the validation we do not want to subset over the fire season, subset to match days in BurnedAreaEurope
FWIEURO <- mask_crop_subset(r = FWI, p = Europe, idx = which(names(FWI) %in% names(BurnedAreaEurope)))
# The above can be saved and re-loaded as follows:
raster::writeRaster(FWIEURO, filename="FWIEURO.grd", bandorder='BIL', overwrite=TRUE, progress = 'text')
FWIEURO <- raster::brick("FWIEURO.grd")

# Contingency table for JRC - Europe as a whole
x1 <- validate_fire_danger_levels(fire_index = FWIEURO, observation = BurnedAreaEurope,
fire_threshold = 21.3, obs_threshold = 50)
tab_x <- table(pred = x1$pred, obs = x1$obs)
hits <- tab_x[2,2]
misses <- tab_x[1,2]
correct_negatives <- tab_x[1,1]
false_alarms <- tab_x[2,1]
# POD 47%
round(hits/(hits+misses),2)*100
roc1 <- pROC::roc(response = x1$obs, predictor = x1$pred)
pROC::plot.roc(roc1, print.auc = pROC::auc(roc1), print.auc.x = 0, print.auc.y = 0.9)

# Contingency table for caliver - Europe as a whole
x2 <- validate_fire_danger_levels(fire_index = FWIEURO, observation = BurnedAreaEurope,
fire_threshold = EuroThrHigh, obs_threshold = 50)
tab_x <- table(pred = x2$pred, obs = x2$obs)
hits <- tab_x[2,2]
misses <- tab_x[1,2]
# POD 65%
round(hits/(hits+misses),2)*100
roc2 <- pROC::roc(response = x2$obs, predictor = x2$pred)
pROC::plot.roc(roc2, col = "red", add = TRUE,
print.auc = pROC::auc(roc2), print.auc.x = 0, print.auc.y = 0.95,
print.auc.col = "red")

# Loop throught the countries
for (country in df_thr[,"Country"]){

print(country)

countryPoly <- raster::getData(name = "GADM", country = country, level = 0)
countryThr <- as.numeric(df_thr[df_thr$Country == country, 4]) # Crop RasterBricks over country of interest BA_country <- mask_crop_subset(r = BurnedAreaEurope, p = countryPoly) FWI_country <- mask_crop_subset(r = FWIEURO, p = countryPoly) JRC <- validate_fire_danger_levels(fire_index = FWI_country, observation = BA_country, fire_threshold = 21.3, obs_threshold = 50) tab_JRC <- data.frame(table(JRC$pred, JRC$obs)) caliver1 <- validate_fire_danger_levels(fire_index = FWI_country, observation = BA_country, fire_threshold = EuroThrHigh, obs_threshold = 50) tab_caliver1 <- data.frame(table(caliver1$pred, caliver1$obs)) caliver2 <- validate_fire_danger_levels(fire_index = FWI_country, observation = BA_country, fire_threshold = countryThr, obs_threshold = 50) tab_caliver2 <- data.frame(table(caliver2$pred, caliver2$obs)) if (country == "Spain") { df_caliver1 <- df_caliver2 <- df_effis <- data.frame("pred" = tab_caliver1$pred, "obs" = tab_caliver1$obs) i <- 3 } df_caliver1 <- cbind(df_caliver1, tab_caliver1$Freq)
names(df_caliver1)[i] <- country
df_caliver2 <- cbind(df_caliver2, tab_caliver2$Freq) names(df_caliver2)[i] <- country df_effis <- cbind(df_effis, tab_JRC$Freq)
names(df_effis)[i] <- country
i <- i + 1

rm(countryPoly, countryThr, BA_country, FWI_country)

}

# Save contingency tables
saveRDS(df_caliver1, "df_caliver1.rds")
saveRDS(df_caliver2, "df_caliver2.rds")
saveRDS(df_effis, "df_effis.rds")

# Europe (EFFIS danger levels)
sum(df_effis[4,3:27]) # hits
sum(df_effis[3,3:27]) # misses
# Europe (averaged danger levels)
sum(df_caliver1[4,3:27]) # hits
sum(df_caliver1[3,3:27]) # misses
# Europe (country-specific danger levels)
sum(df_caliver2[4,3:27]) # hits
sum(df_caliver2[3,3:27]) # misses

# UK (EFFIS danger levels)
df_effis[4, which(names(df_caliver2) == "United Kingdom")] # hits
df_effis[3, which(names(df_caliver2) == "United Kingdom")] # misses
# UK (EU averaged danger levels)
df_caliver1[4, which(names(df_caliver2) == "United Kingdom")] # hits
df_caliver1[3, which(names(df_caliver2) == "United Kingdom")] # misses
# UK (country-specific danger levels)
df_caliver2[4, which(names(df_caliver2) == "United Kingdom")] # hits
df_caliver2[3, which(names(df_caliver2) == "United Kingdom")] # misses

# Spain (EFFIS danger levels)
df_effis[4, which(names(df_caliver2) == "Spain")] # hits
df_effis[3, which(names(df_caliver2) == "Spain")] # misses
# Spain (EU averaged danger levels)
df_caliver1[4, which(names(df_caliver2) == "Spain")] # hits
df_caliver1[3, which(names(df_caliver2) == "Spain")] # misses
# Spain (country-specific danger levels)
df_caliver2[4, which(names(df_caliver2) == "Spain")] # hits
df_caliver2[3, which(names(df_caliver2) == "Spain")] # misses

# Italy (EFFIS danger levels)
df_effis[4, which(names(df_caliver2) == "Italy")] # hits
df_effis[3, which(names(df_caliver2) == "Italy")] # misses
# Italy (EU averaged danger levels)
df_caliver1[4, which(names(df_caliver2) == "Italy")] # hits
df_caliver1[3, which(names(df_caliver2) == "Italy")] # misses
# Italy (country-specific danger levels)
df_caliver2[4, which(names(df_caliver2) == "Italy")] # hits
df_caliver2[3, which(names(df_caliver2) == "Italy")] # misses

## References

Añel, Juan A. 2011. “The Importance of Reviewing the Code.” Communications of the ACM 54 (5): 40–41.

———. 2017. “Comment on ‘Most Computational Hydrology Is Not Reproducible, so Is It Really Science?’ By Christopher Hutton et Al.” Water Resources Research 53 (3): 2572–4.

Dee, Dick P, S Mꎬ Uppala, AJ Simmons, Paul Berrisford, P Poli, S Kobayashi, U Andrae, et al. 2011. “The Era-Interim Reanalysis: Configuration and Performance of the Data Assimilation System.” Quarterly Journal of the Royal Meteorological Society 137 (656): 553–97.

Di Giuseppe, Francesca, Florian Pappenberger, Fredrik Wetterhall, Blazej Krzeminski, Andrea Camia, Giorgio Libertá, and Jesus San Miguel. 2016. “The Potential Predictability of Fire Danger Provided by Numerical Weather Prediction.” Journal of Applied Meteorology and Climatology 55 (11): 2469–91.

Flannigan, Mike D, Meg A Krawchuk, William J de Groot, B Mike Wotton, and Lynn M Gowman. 2009. “Implications of Changing Climate for Global Wildland Fire.” International Journal of Wildland Fire 18 (5): 483–507.

Giglio, Louis, James T Randerson, and Guido R Werf. 2013. “Analysis of Daily, Monthly, and Annual Burned Area Using the Fourth-Generation Global Fire Emissions Database (Gfed4).” Journal of Geophysical Research: Biogeosciences 118 (1): 317–28.

Hersbach, Hans, Bill Bell, Paul Berrisford, Shoji Hirahara, András Horányi, Joaquı́n Muñoz-Sabater, Julien Nicolas, et al. 2020. “The Era5 Global Reanalysis.” Quarterly Journal of the Royal Meteorological Society 146 (730): 1999–2049.

McFarlane, Paul, H. Pearce, and John Moore. 2002. “Introduction: Forestry and Risk Management - New Zealand in a Global Context.” In, 5–19.

RCore, TEAM. 2016. “R: A Language and Environment for Statistical Computing. R Foundation for Statistical Computing, Vienna, Austria.”

Rew, Russ, and Glenn Davis. 1990. “NetCDF: An Interface for Scientific Data Access.” IEEE Computer Graphics and Applications 10 (4): 76–82.

Van Wagner, CE, Petawawa Forest, and others. 1987. “Development and Structure of the Canadian Forest Fireweather Index System.” In Can. For. Serv., Forestry Tech. Rep. Citeseer.

Van Wagner, Charles Edward, and others. 1974. Structure of the Canadian Forest Fire Weather Index. Vol. 1333. Citeseer.

Vélez, R. 2002. “Causes of Forest Fires in the Mediterranean Basin.” EFI Proceedings, no. No.45: 35–42.

Vitolo, Claudia, Francesca Di Giuseppe, Christopher Barnard, Ruth Coughlan, Jesus San-Miguel-Ayanz, Giorgio Libertá, and Blazej Krzeminski. 2020. “ERA5-Based Global Meteorological Wildfire Danger Maps.” Scientific Data 7 (1): 216. https://doi.org/10.1038/s41597-020-0554-z.

Vitolo, Claudia, Francesca Di Giuseppe, and Mirko D’Andrea. 2018. “Caliver: An R Package for Calibration and Verification of Forest Fire Gridded Model Outputs.” PLOS ONE 13 (1): 1–18. https://doi.org/10.1371/journal.pone.0189419.

Vitolo, Claudia, Francesca Di Giuseppe, Blazej Krzeminski, and Jesus San-Miguel-Ayanz. 2019. “A 1980–2018 Global Fire Danger Re-Analysis Dataset for the Canadian Fire Weather Indices.” Scientific Data 6 (1): 190032. https://doi.org/10.1038/sdata.2019.32.

Warmerdam, Frank. 2008. “The Geospatial Data Abstraction Library.” In Open Source Approaches in Spatial Data Handling, 87–104. Springer.

Wickham, Hadley. 2011. “Testthat: Get Started with Testing.” The R Journal 3: 5–10. https://journal.r-project.org/archive/2011-1/RJournal_2011-1_Wickham.pdf.