Getting started

David Nortes Martínez, Frédéric Grelot

The library at a glance

floodam.cba is designed to carry out economic assessments of flood management projects. Based on an approach known as extended cost-benefit analysis, it enables the estimation of traditional cost-benefit analysis (CBA) measures, supplemented by additional indicators relating to aspects not necessarily included in the monetisation of project benefits or costs.

The impacts of projects on flooding are assessed according to the avoided damage principle, whereby avoided damage is defined as the difference between the impacts in the baseline scenario (without the project under assessment) and the impacts in the project scenario. It therefore enables the estimation of the benefits or costs of improvements or deteriorations in a territory’s exposure to flooding using different flood scenarios in both the baseline and project scenarios.

Other project impacts not directly attributable to a change in the area’s flood exposure are also considered. These impacts are analysed using a framework of actions, the implementation of which entails ‘one-off’ impacts during the implementation period and ‘deferred’ impacts that take effect once the action is completed and persist over time. The ‘one-off’ impacts include various investment costs (works, studies, easements, etc.). The ‘deferred’ impacts include maintenance costs, environmental impacts and any co-benefits expected from the project.

floodam.cba is particularly well-suited to applying the French government’s recommended method for the economic assessment of flood management projects. Its application in other contexts does not require significant adaptation.

This vignette provides a high-level description of the overall workflow you will use with floodam.cba. The specifics of some of the steps in this workflow are covered in separate vignettes.

Basic workflow

The process starts by providing the necessary input data on the situation before and after the project you want to analyse (i.e. the baseline and project scenarios, or hereafter cases for short). To make things easier and help you to learn how to use the library, floodam.cba is shipped with illustrative cases. The cases are available in your library’s installation folder, so just ask R to locate them:

input_path = system.file(file.path("extdata", "case"), package = "floodam.cba")

Now let us load one of the cases available:

library(floodam.cba)
case = import_case(file.path(input_path, "complete.ods"))
#> import Case from /tmp/RtmpIBjXHd/Rinst10db52229e795/floodam.cba/extdata/case/complete.ods
#>  ... done

The import_case() function returns a S4 object of a new Case class defined by the library.

To process the case object and obtain a synthesis of indicators, we use the compute_synthesis() function, specifying the type of case:

case_ind = compute_synthesis(case)

The compute_synthesis() function returns a matrix where rows represent the different indicators calculated by floodam.cba while columns represent the different projects proposed:

complete reinforcement
npv 1728.3950023 3987.8061188
bcr 1.2129645 3.2590387
h_min 31.0000000 12.0000000
cost_hab Inf -Inf
cost_emp Inf -Inf
aad_pos 279.3611356 74.3467025
aad_neg -141.8787984 -18.5866756
dam_eff 0.1050065 0.0425885
hab_eff NA NA
emp_eff NA NA
aadd 163.5421950 62.7122250
aad_ori 1309.2750000 1309.2750000
aad_fin 1145.7328050 1246.5627750
aadd_eff 0.1249105 0.0478984
aah_ori NA NA
aah_fin NA NA
aadh_eff NA NA
aae_ori NA NA
aae_fin NA NA
aade_eff NA NA