Skip to content

Commit a893ce5

Browse files
jvh-vcgijvh-vcgi
committed
Initial upload of Disaster Declarations Explorer docs
- Minor updates to COP docs - First upload of Disaster Decs
1 parent 0d8419b commit a893ce5

43 files changed

Lines changed: 1133 additions & 66 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

esri/exb/cop/MkDocs-Installation-Guide.md renamed to MkDocs-Installation-Guide.md

File renamed without changes.

‎esri/dashboards/.gitignore‎

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
# MkDocs generated site
2+
site/
3+
4+
# Python
5+
__pycache__/
6+
*.py[cod]
7+
*$py.class
8+
*.so
9+
.Python
10+
11+
# Virtual environments
12+
venv/
13+
env/
14+
.venv/
15+
ENV/
16+
env.bak/
17+
venv.bak/
18+
19+
# IDEs
20+
.vscode/
21+
.idea/
22+
*.swp
23+
*.swo
24+
*~
25+
26+
# OS files
27+
.DS_Store
28+
.DS_Store?
29+
._*
30+
.Spotlight-V100
31+
.Trashes
32+
ehthumbs.db
33+
Thumbs.db
34+
35+
# MkDocs
36+
.cache/

‎esri/dashboards/README.md‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
# VEM ArcGIS Dashboards Documentation
2+
3+
This repository contains comprehensive documentation for dashboards created to support Vermont Emergency Management.
4+
5+
6+
7+
## Contact
8+
9+
VCGI Lead
10+
John Van Hoesen: john.vanhoesen@vermont.gov

‎esri/dashboards/docs/fema-decs/index.md‎

Lines changed: 250 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,250 @@
1+
# Overview
2+
3+
This dashboard was developed to provide public access to historical FEMA disaster declarations. The primary objective of this dashboard is to facilitate the development of [Local Hazard Mitigation Plans](https://vem.vermont.gov/plans/LHMP), with specific emphasis on the second bullet in bold below.
4+
5+
VEM provides a comprehensive plain-language checklist of FEMA LHMP requirements [here](https://vem.vermont.gov/sites/demhs/files/documents/Vermont%20LHMP%20Review%20Tool%20Guide%20Checklist%202025%20to%20share.pdf). Basic requirements of the LHMP are:
6+
7+
- The plan documents engagement of the whole community, including historically and currently underrepresented or disadvantaged community members. The planning process must also include community decision-makers, such as the selectboard and zoning administrator.
8+
- The plan assesses all hazards that may occur in the planning area and their community-specific impacts on assets, including people.
9+
- The plan considers future conditions in determining vulnerabilities, including climate change, land use/development changes, and changes in population and/or demographics.
10+
- The plan includes mitigation/adaptation actions to address each hazard assessed and provides implementation timelines, assigns responsibility for implementation, and identified potential funding sources. Mitigation actions must include consideration of education and outreach to the community, natural or nature-based strategies, structural projects, and planning and policy improvements.
11+
- The plan identifies other planning mechanisms to integrate the resilience plan with, such as conservation plans, capital improvement plans, stormwater management plans, Town/Municipal Plans, compact settlement, and housing development.
12+
13+
## Declarations Explorer Layout
14+
15+
!!! info "Dashboard Platform Clarification"
16+
This dashboard was actually built in Experience Builder so that specific chart types could be added to the interface, but is otherwise designed similar to an ArcGIS Dashboard.
17+
18+
**Key Features:**
19+
20+
- Interactive Web Map
21+
- Filter Widgets
22+
- Indicator Text Widgets
23+
- Dynamic Chart Widgets
24+
- Dynamic Table Widget
25+
26+
### Indicator Section
27+
The indicator section contains three Text Widgets that summarize:
28+
29+
- Total Number of Disaster Declarations
30+
- Damage Totals (in U.S. $)
31+
- FEMA Obligations (in U.S. $)
32+
33+
??? info "Click For More Info"
34+
35+
![Disaster Declaration Indicators Screenshot](../images/fema-decs/dec-explorer-indicators.jpg)
36+
37+
- **Disaster Declarations Indicator Widget**: Provides a dynamic count of total disaster declarations. When the user applies a filter this indicator updates using this expression COUNT(`ObjectID`). The indicator icon is available [here](../images/fema-decs/dec-explorer-declarations-icon.png)
38+
39+
- **Damage Totals Indicator Widget**: Provides a dynamic sum of damage totals in U.S dollars. When the user applies a filter this indicator updates using this expression SUM(`Total_Cost`). The indicator icon is available [here](../images/fema-decs/dec-explorer-damages-icon.png.png)
40+
41+
- **FEMA Obligations Indicator Widget**: Provides a dynamic count of total disaster declarations. When the user applies a filter this indicator updates using this expression SUM(`FEMA_Obligated`). The indicator icon is available [here](../images/fema-decs/dec-explorer-obligations-icon.png.png)
42+
43+
### Web Map Contents
44+
45+
The dashboard contains a web map named Vermont FEMA Declaration Explorer, which is accessible [here](https://vtem.maps.arcgis.com/apps/mapviewer/index.html?webmap=99eb7c25be674280b9e201197709f880). The web map contains two feature layers; there are no filteres applied to the data, and no Arcade used for symbology.
46+
47+
![FEMA Declaration Dashboard Screenshot](../images/fema-decs/fema-decs-layout.jpg)
48+
49+
#### Active Layers
50+
51+
<div class="no-datatable" markdown="1">
52+
53+
| Group | Layer Name | Type | Source |
54+
|-------|------------|------|--------|
55+
| | FEMA Disaster Declarations By County | ESRI Basic Polygon | [VEM](https://services9.arcgis.com/cb6eDXWVgAvVXeIK/arcgis/rest/services/VT_FEMA_Disaster_Events_by_County_20250801_152948/FeatureServer) Python Notebook |
56+
| Boundaries | Vermont Towns | ESRI Basic Polygon | [VCGI](https://services1.arcgis.com/BkFxaEFNwHqX3tAw/arcgis/rest/services/FS_VCGI_OPENDATA_Boundary_BNDHASH_poly_towns_SP_v1/FeatureServer/0) |
57+
58+
</div>
59+
60+
!!! info ":material-home-flood: VT Disaster Declarations Extraction Notebook"
61+
Extracts and Summarizes FEMA disaster declarations in Vermont. <br>This notebook is manually executed after a new declaration has been announced.<br>You can view the full, documented code in the VCGI repository below:
62+
63+
[ :material-github: **VCGI / vem-gis-tools / Disaster Declarations** ](https://github.com/VCGI/vem-gis-tools/blob/main/etl/VT-Disaster-Declarations-Extraction.ipynb){ .md-button .vt-green-btn }
64+
![](https://img.shields.io/badge/Language-Python-blue)
65+
![](https://img.shields.io/badge/Status-Active-success)
66+
![](https://img.shields.io/badge/Data%20Source-FEMA-red)
67+
68+
### Filter Widgets
69+
There are two Filter widgets available for the user to refine the visualization. When a filter is applied or removed, the indicator widgets update, the map zooms to the area of interest, the charts display relevant data, and the table displays relevant records.
70+
71+
??? info "Click For More Info"
72+
73+
- **Federal Declarations Only**: This filter is turned on by default to filter out emergency declarations. See [here](https://www.fema.gov/node/how-emergency-declaration-different-presidential-declaration) for more information on the distinction.
74+
75+
![Federal Declaration Filter Screenshot](../images/fema-decs/dec-category-selector.jpg)
76+
77+
- **FEMA Disaster Declarations By County**: This filter allows the user to select a county of interest, a disaster type of interest, and a declaration number if known.
78+
79+
![County Filter Screenshot](../images/fema-decs/county-category-selector.jpg)<br><br>
80+
81+
- **Filter Options**: The tables below summarizes the available attributes for each filter:
82+
83+
<div class="table-grid-container">
84+
85+
<div class="table-column">
86+
87+
| Counties |
88+
| :--- |
89+
| Addison |
90+
| Bennington |
91+
| Caledonia |
92+
| Chittenden |
93+
| Essex |
94+
| Franklin |
95+
| Grand Isle |
96+
| Lamoille |
97+
| Orange |
98+
| Orleans |
99+
| Rutland |
100+
| Washington |
101+
| Windham |
102+
| Windsor |
103+
104+
</div>
105+
106+
<div class="table-column">
107+
108+
| Disaster Types |
109+
| :--- |
110+
| Biological |
111+
| Flood |
112+
| Hurricane |
113+
| Severe Ice Storm |
114+
| Severe Storm |
115+
116+
</div>
117+
118+
<div class="table-column">
119+
120+
| FEMA Declaration #s |
121+
| :--- |
122+
| [DR-277-VT](https://www.fema.gov/disaster/277) |
123+
| [DR-397-VT](https://www.fema.gov/disaster/397) |
124+
| [DR-518-VT](https://www.fema.gov/disaster/518) |
125+
| [DR-712-VT](https://www.fema.gov/disaster/712) |
126+
| [DR-840-VT](https://www.fema.gov/disaster/840) |
127+
| [DR-875-VT](https://www.fema.gov/disaster/875) |
128+
| [DR-938-VT](https://www.fema.gov/disaster/938) |
129+
| [DR-990-VT](https://www.fema.gov/disaster/990) |
130+
| [DR-1063-VT](https://www.fema.gov/disaster/1063) |
131+
| [DR-1101-VT](https://www.fema.gov/disaster/1101) |
132+
| [DR-1124-VT](https://www.fema.gov/disaster/1124) |
133+
| [DR-1184-VT](https://www.fema.gov/disaster/1184) |
134+
| [DR-1201-VT](https://www.fema.gov/disaster/1201) |
135+
| [DR-1228-VT](https://www.fema.gov/disaster/1228) |
136+
| [DR-1307-VT](https://www.fema.gov/disaster/1307) |
137+
| [DR-1336-VT](https://www.fema.gov/disaster/1336) |
138+
| [DR-1358-VT](https://www.fema.gov/disaster/1358) |
139+
| [DR-1428-VT](https://www.fema.gov/disaster/1428) |
140+
| [DR-1488-VT](https://www.fema.gov/disaster/1488) |
141+
| [DR-1559-VT](https://www.fema.gov/disaster/1559) |
142+
| [DR-1698-VT](https://www.fema.gov/disaster/1698) |
143+
| [DR-1715-VT](https://www.fema.gov/disaster/1715) |
144+
| [DR-1778-VT](https://www.fema.gov/disaster/1778) |
145+
| [DR-1784-VT](https://www.fema.gov/disaster/1784) |
146+
| [DR-1790-VT](https://www.fema.gov/disaster/1790) |
147+
| [DR-1951-VT](https://www.fema.gov/disaster/1951) |
148+
| [DR-1995-VT](https://www.fema.gov/disaster/1995) |
149+
| [DR-4001-VT](https://www.fema.gov/disaster/4001) |
150+
| [DR-4022-VT](https://www.fema.gov/disaster/4022) |
151+
| [DR-4043-VT](https://www.fema.gov/disaster/4043) |
152+
| [DR-4066-VT](https://www.fema.gov/disaster/4066) |
153+
| [DR-4120-VT](https://www.fema.gov/disaster/4120) |
154+
| [DR-4140-VT](https://www.fema.gov/disaster/4140) |
155+
| [DR-4163-VT](https://www.fema.gov/disaster/4163) |
156+
| [DR-4178-VT](https://www.fema.gov/disaster/4178) |
157+
| [DR-4207-VT](https://www.fema.gov/disaster/4207) |
158+
| [DR-4232-VT](https://www.fema.gov/disaster/4232) |
159+
| [DR-4330-VT](https://www.fema.gov/disaster/4330) |
160+
| [DR-4356-VT](https://www.fema.gov/disaster/4356) |
161+
| [DR-4380-VT](https://www.fema.gov/disaster/4380) |
162+
| [DR-4445-VT](https://www.fema.gov/disaster/4445) |
163+
| [DR-4474-VT](https://www.fema.gov/disaster/4474) |
164+
| [DR-4532-VT](https://www.fema.gov/disaster/4532) |
165+
| [DR-4621-VT](https://www.fema.gov/disaster/4621) |
166+
| [DR-4695-VT](https://www.fema.gov/disaster/4695) |
167+
| [DR-4720-VT](https://www.fema.gov/disaster/4720) |
168+
| [DR-4744-VT](https://www.fema.gov/disaster/4744) |
169+
| [DR-4762-VT](https://www.fema.gov/disaster/4762) |
170+
| [DR-4770-VT](https://www.fema.gov/disaster/4770) |
171+
| [DR-4810-VT](https://www.fema.gov/disaster/4810) |
172+
| [DR-4816-VT](https://www.fema.gov/disaster/4816) |
173+
| [DR-4826-VT](https://www.fema.gov/disaster/4826) |
174+
175+
</div>
176+
177+
</div>
178+
179+
- **Filter Trigger**: When the user selects a county of interest, the map zooms to the county. This is accomplished by applying an action to the filter:
180+
![Reset Filter Screenshot](../images/fema-decs/county-filter-action.jpg)
181+
182+
- **Reset Filters**: The user can reset all filters and refresh the dashboard view by clicking the Refresh Filters icon:
183+
![Reset Filter Screenshot](../images/fema-decs/county-filter-reset.jpg)
184+
185+
186+
187+
### Interactive Charts
188+
The dashboard contains three column charts that dynamically updated based on selections made using the Category Selector Filters. All of the charts pull data from the FEMA Disaster Declarations by County feature layer.
189+
190+
#### Disaster By Category
191+
192+
??? info "Click For More Info"
193+
This column chart displays a count of `DisasterType` grouped by `CNTYNAME` from the FEMA Disaster Declarations by County feature layer.
194+
195+
![Disaster Category Chart Screenshot](../images/fema-decs/disaster-by-category-chart.jpg)
196+
197+
The chart was set up using the following settings:<br><br>
198+
![Disaster Category Chart Settings Screenshot](../images/fema-decs/disaster-by-category-chart-settings.jpg)
199+
200+
#### Disaster Type By Year
201+
202+
??? info "Click For More Info"
203+
This column chart displays a stacked count of `DisasterType` grouped by `Year` from the FEMA Disaster Declarations by County feature layer.
204+
205+
![Disaster Year Chart Screenshot](../images/fema-decs/disaster-by-year-chart.jpg)
206+
207+
The chart was set up using the following settings:<br><br>
208+
![Disaster Year Chart Settings Screenshot](../images/fema-decs/disaster-by-year-chart-settings.jpg)
209+
210+
#### Disaster Type By Decade
211+
212+
??? info "Click For More Info"
213+
This column chart displays a stacked count of `DisasterType` grouped by `IndcidentDate` from the FEMA Disaster Declarations by County feature layer. The time interval was set to 10 years to reflect disaster type by decade.
214+
215+
![Disaster Decade Chart Screenshot](../images/fema-decs/disaster-by-decade-chart.jpg)
216+
217+
The chart was set up using the following settings:<br><br>
218+
![Disaster Decade Chart Settings Screenshot](../images/fema-decs/disaster-by-decade-chart-settings.jpg)
219+
220+
### Dynamic Table
221+
The dashboard contains a dynamic table that allows users to review information related to specific counties, disaster types, and declarations. Users can also export a CSV file of the table for use in other applications.
222+
223+
??? info "Click For More Info"
224+
When the user applies a filter, the table dynamically relevant records with the following attributes:
225+
226+
**Table Attributes:**
227+
228+
- `FEMA_Declaration`: Complete FEMA disaster declaration identification number
229+
- `DisasterID`: FEMA disaster declaration identification number
230+
- `IncidentDate`: The date the disaster event actually occurred, derived from FEMA's `incidentBeginDate`.
231+
- `Year`: The four-digit year (e.g., 2023) the disaster took place, extracted directly from the start date of the incident.
232+
- `County`: Designated county name
233+
- `DisasterType`: The general category of the incident (mapped from FEMA's `incidentType`). Common examples in Vermont include "Flood", "Severe Storm", "Winter Storm", or "Biological" (like COVID-19).
234+
- `Total_Cost`: The aggregate sum of the `projectAmount` from FEMA's Public Assistance data, grouped by disaster and county. This represents the total estimated or actual cost of all eligible recovery and repair projects for that specific disaster in that specific county.
235+
- `FEMA_Obligated`: The aggregate sum of the `federalShareObligated` field from the Public Assistance data. This represents the actual dollar amount that FEMA approved and committed to pay toward the Total_Cost of those projects.
236+
- `Link`: A dynamically generated URL (e.g., https://www.fema.gov/disaster/4720) that acts as a direct link to the official FEMA webpage for that specific disaster declaration, where users can find more detailed summaries and news.
237+
- `StartDate`: A text-formatted version (MM/DD/YYYY) of the `incidentBeginDate`.
238+
- `EndDate`: A text-formatted version (MM/DD/YYYY) of the `incidentEndDate`.
239+
240+
241+
![Disaster Declaration Table Screenshot](../images/fema-decs/dec-explorer-table.jpg)
242+
243+
**CSV Export:**
244+
Users can export a CSV or filtered or unfiltered records from the table using the Actions pane, which can be accessing by clicking this icon ![Export CSV Table Screenshot](../images/fema-decs/dec-explorer-table-actions.jpg). Within the Actions pane, users can select Export > Export to CSV.<br><br>
245+
![Export CSV Table Screenshot](../images/fema-decs/dec-explorer-export-csv.jpg)
246+
247+
---
248+
## Feedback
249+
250+
If you have suggestions for improving this page or need additional functionality, contact [John Van Hoesen](mailto:john.vanhoesen@vermont.gov).

‎esri/dashboards/docs/images/fema-decs/county-category-selector.jpg‎

13 KB
Loading

‎esri/dashboards/docs/images/fema-decs/county-filter-action.jpg‎

13.9 KB
Loading

‎esri/dashboards/docs/images/fema-decs/county-filter-reset.jpg‎

1.28 KB
Loading

‎esri/dashboards/docs/images/fema-decs/dec-category-selector.jpg‎

4.28 KB
Loading

‎esri/dashboards/docs/images/fema-decs/dec-explorer-damages-icon.png.png‎

23.1 KB
Loading

‎esri/dashboards/docs/images/fema-decs/dec-explorer-declarations-icon.png‎

18.8 KB
Loading

0 commit comments

Comments
 (0)