WildfireOccurrenceDatabase/FODMET_config.ini at main · ScionResearch/WildfireOccurrenceDatabase · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
[API Credentials]
# API related information is defind here. You need a username and password to access the weather stations data
#######################################
# API URL + user name + password
fwsys_url = https://mintaka.niwa.co.nz/rest/api/V1.1
fwsys_username =
fwsys_password =
#######################################


[Log]
# Define the log directory here.
##############################################################################
# When getting neighbours for each weather station (currently there are 479 stations), we hope to record the log
weather_station_neighbours_log_path= FODMET_Log/weather_station_neighbours.log

# When this weather station don't have data of key metrics (air temperature, wind speed, fwi noon), we need to find the data from its neighbours. We will try every single neighbour. The shorter the distance is, the higher priority it has. The suitable weather station data is saved in the log file. We will extract data from it later.
suitable_weather_station_log_path = FODMET_Log/suitable_weather_stations/suitable_weather_station.log

# When we begin to retrieve weather metrics from NIWA FWSYS, we record the log. The weather metrics data is saved in the log file. We will extract data from it later.
weather_metric_log_path = FODMET_Log/weather_metrics/weather_metric.log
soi_metric_log_path = FODMET_Log/weather_metrics/soi_metric.log

##############################################################################


[FOD]
# Define data directory here as well as other easily-changed variable about the fires.
##############################################################################
# Step1 csv file has all fire event information
fenz_dataset_path = ../data/FODENV_data_[DATE].csv

# Step1 shapefile is necessary for fire scientists to check the fires on a map
fenz_point_shp_path = ../data/FODENV_data_shp/points_[DATE].shp
fenz_polygon_shp_path = ../data/FODENV_data_shp/polygons_[DATE].shp


##############################################################################


[Data]
# Define the data directory here.
##############################################################################
# Used for SOI and ENSO
soi_file_path = ../data/FODMET/soi_monthly.csv

# We can convert land cover to fuel type, which is more concise
fuel_file_path = ../data/FODMET/landcover_to_fdc.xlsx
fuel_sheet_name = Sheet1

# There is a weather zone shapefile to determine which weather station a fire belongs to. We cannot simply use nearest weather station for this fire.
weather_shapefile_path = ../data/FODMET/FWSYS_Areas_v2.05_A/FWSYS_Areas_v2.05_A.shp

# When we cannot get key metrics from the fire's own station, then we try to get data from its neighbour station. It is a good idea to save the neighbour list in advance.
weather_station_neighbours_path = ../data/FODMET/weather_station_neighbours.json
# Currently if two weather stations' distance is <=50km, we would add it to the neighbour list. If the distance >50km, then we should ignore this neighbour. This value is most likely  to change in the future.
maximum_weather_zone_station_distance = 50
# When we cannot get key metrics from weather station, we will try its neighbour. But the maximum try is specified.
maximum_neighbour_to_try=10

# CSV file to save suitable weather stations
suitable_weather_station_file_path = ../data/FODMET/suitable_weather_stations.csv

# CSV file to save weather metrics
weather_metric_file_path = ../data/FODMET/weather_metrics.csv
soi_metric_file_path = ../data/FODMET/soi_metrics.csv

# the final data (merge FENZ data and weather data)
FOD_csv_file_path = ../data/FODMET_data_new.csv
FOD_shp_path = ../data/FODMET_data_shp/FODMET_new.shp
##############################################################################


[Temp]
# It is a network-based program. Errors may occur during the program running, which lead to missing observations. We will save these missing observations and re-run the program later.
##############################################################################
# Errors may occur when we get suitable weather station for each fire
suitable_weather_station_missing_obs_path = ../FODMET_Temp/suitable_weather_station_missing_obs.csv

# Errors may occur when we get weather metrics for each fire
weather_metric_missing_obs_path = ../FODMET_Temp/weather_metric_missing_obs.csv
##############################################################################


[RUN]
# When we run the program, we need some parameters
##############################################################################
# control API flow.
# currently there is 2 API request per second limit.
number_of_api_per_second = 2
# to control API flow, we need to know how long an API consumes.
time_consumption_of_one_api = 0.35

# when download data, we do not download all data because it may take many days. We will specify a date range
date_range=1900-01-01~2022-12-31
##############################################################################