Form AF8 – Requirements

This user manual is created based on the 2021 standard submission. The processor should check the most current Report of Activity (ROA) for changes. All the file names/paths/settings are based on the 2021 standard submission, which should be updated based on the current standard.

Form AF-8 provides an illustration of the distribution of flood losses and illustrates that appropriate calculations were used to produce both expected annual flood losses and flood probable maximum loss levels. Form AF-8 uses the standard modeler defined exposure file generated by the modeler-defined-exposure-dataset-2023.ipynb notebook. Form AF-8 contains two parts: Part A and Part B. Form AF-8 Part BA is used to present the return period, estimated loss level and uncertainty interval of Annual Aggregate. Form AF-8 Part B is used to present the return period, estimated loss level and uncertainty interval of Annual Occurrence.

Steps to run the program:

Create an empty working directory and copy the flood ILM code env to it.
Update config.ini in your running env with the parameters that suit the run. As an example of a setup file, here is the one used for the Jan 2024 submission (only the relevant sections are shown):

servers = fabian-a,fabian-b,fabian-c,fabian-d,ivan-a,ivan-b,ivan-c,ivan-d,gaston-a,gaston-b,jeanne-a,jeanne-b,jeanne-c,jeanne-d,frances-a,frances-b,frances-c,earl-a,earl-b,earl-c,earl-d,agnes-a,agnes-b,agnes-c,agnes-d,alex-a,alex-b,alex-c,alex-d

[choice]

# Set to True if you want to reuse the ILM result. otherwise False

use_old_ILM = False

# Set to True if re-use the existing merged hazard files, otherwise False

use_old_mergedhazard = True

# Based on the form to be generated, set this option to 1 or 2 or 3 or 4 or 5 or 6 or 7 or 8 or 9 or 10

option = 2

# Path of your working environment

working_env = /home/wilma/FPHLM/Tianyi/flood/running_envs/20231206

# Path of user’s home directory

home_dir = /home/bear-b/users/wtian002

# Set to True if generating the submission forms otherwise, False

generate_forms = False

[common_configs]

# Contains configs which are common to all the forms

POLICY_PATH = /home/mitch-a/dmis-projects/fphlm/flood_proc/2017_standards_v1.0/data/modeler_defined_exp_data/env_02102023/out/augmented_nfip/new_lonlat_ffe_dem/ffeUpdate/all_pr_0deduc_gemid.csv

VUL = /home/mitch-a/dmis-projects/fphlm/flood_proc/2017_standards_v1.0/data/vul/pr/v1.5/pr.csv

DSF = /home/wilma/FPHLM/Tianyi/flood/ds_factor/stochastic/output/

INLAND_REF = ground

COASTAL_REF = standard

PRD = False

# Whether to check vulnerability descriptor. True or False

CHECK_VUL = False

#Number of years in the stochastic set

SIMULATION_YEAR = 73200

#Last storm id (numerical part without leading zeros) in the stochastic set

LAST_STORM_ID = 155399

# Complete path (including file name) to the floating FFE value vulnerability file is located

FLOATVUL=/home/wilma/FPHLM/Tianyi/flood/vul/pr_exp.csv

[2]

Name=FORM_AF8

HAZARD_COASTAL = /home/wilma/FPHLM/Tianyi/flood/surge/surge-interpolation-pyspark-master/test/out/

HAZARD_WAVE = /home/wilma/FPHLM/Tianyi/flood/wave/output/20231122_modeler_defined_exp/results_S/

HAZARD_INLAND = /home/wilma/FPHLM/Tianyi/flood/inland/20231204/inland_merged_sort/

MERGED_STORMS_PATH = /home/wilma/FPHLM/Tianyi/flood/running_envs/20231206/output/20231206_stdsf4/MERGED_STORMS/

STORM_FILES = /home/wilma/FPHLM/Tianyi/flood/running_envs/20231206/output/20231213_af8/STORM_FILES/

STORM_OUTPUT = /home/wilma/FPHLM/Tianyi/flood/running_envs/20231206/output/20231213_af8/STORM_OUTPUT/

# Path to event_losses input file

EVENT_LOSSES = /home/wilma/FPHLM/Tianyi/flood/running_envs/20231206/output/20231213_af8/EVENT_LOSSES/event_losses.csv

TRACK_FILE = /home/mitch-a/dmis-projects/fphlm/flood_proc/2017_standards_v1.0/met/extended_tracks_HU20220419.txt

# Path where form will be stored after generating

FORM_OUTPUT_FOLDER = /home/wilma/FPHLM/Tianyi/flood/running_envs/20231206/output/20231213_af8/FORM_OUTPUT_FOLDER/

OUTPUT = /home/wilma/FPHLM/Tianyi/flood/running_envs/20231206/output/20231213_af8/OUTPUT_ILM/

SIMULATION_YEAR = 73200

STORMLEVEL_MERGE = /home/wilma/FPHLM/Tianyi/flood/running_envs/20231206/output/20231213_af8/STORMLEVEL_MERGE/stormlevel_merge.csv

POLICYLEVEL_MERGE = /home/wilma/FPHLM/Tianyi/flood/running_envs/20231206/output/20231213_af8/POLICYLEVEL_MERGE/policylevel_merge.csv

3. Start the model run with $nohup Python floodILM.py &

4. Create another model run env by repeating steps 1 through 3 using the non-tropical hazard input by setting the correct path in “HAZARD_INLAND” and leaving HAZARD_COASTAL and HAZARD_WAVE empty. Set the SIMULATION_YEAR for non-tropical events (value 76 was used for the 2021 standard ROA submission).

5. Merge the policy_level_merge.csv file in each subdirectory in the POLICYLEVEL_MERGE directory generated from steps 1-3 and 4 by adding the AalWaterA, AalWaterB, AalWaterC, and Total columns (add the original results and non-tropical results)

6. Set the “use_old_ILM” and “generate_forms” to True and re-run the floodILM.py script to produce the final forms.

7. The required output will be stored in the FORM_OUTPUT_FOLDER directory when the run is finished:

- csv
- csv

Results

Send prototype of the form and maps to the verifier.
Verifier sends prototype of form and maps to team leader.
Team leader sends prototype of form and maps to expert.

Test Report

Notes

The ILM running environment for the results submitted in Jan 2024 are here:
/home/wilma/FPHLM/Tianyi/flood/running_envs/20231206/output/20231213_af8/
All the files and configurations in this document are specific to this example run and submission. The processor should update the parameters required by the submission and/or version.