Skip to content

Commit 80eb0c6

Browse files
committed
fix: pinelli/3usecase cleanup
Similar to cleanup done in #255.
1 parent 0d26325 commit 80eb0c6

File tree

1 file changed

+24
-18
lines changed

1 file changed

+24
-18
lines changed

user-guide/usecases/pinelli/3usecase.md

Lines changed: 24 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,7 @@
22

33
**Bakhshandeh, M. – Florida Institute of Technology**<br>
44
**Pinelli, J-P. – Professor - Florida Institute of Technology**<br>
5-
**Cocke, Steven – Professor - Florida State University**<br>
6-
5+
**Cocke, Steven – Professor - Florida State University**<br>
76

87
**Keywords:** hurricane, wind field, interpolation, conversion, exposure correction, Jupyter Notebook, DesignSafe, Florida
98

@@ -15,18 +14,19 @@ Since 2017, Applied Research Associates (ARA), under contract with the National
1514

1615
The workflow reads the wind-field data, performs interpolation to estimate winds at each property coordinate, and applies terrain adjustments to compute actual terrain-level wind speeds. For instance, given any hurricane dataset (e.g., Hurricane Michael), the notebook interpolates ARA’s 10-m open-terrain winds to specific property locations and modifies them based on local roughness and coastal proximity. The result is a spatially resolved dataset of adjusted 10-m wind speeds suitable for exposure modeling and vulnerability assessment.
1716

18-
**Key steps:**
17+
**Key steps:**
1918

20-
- **Interpolation:** Derives property-level wind speeds from gridded ARA/NIST hurricane data.
21-
- **Conversion:** Transforms wind speeds between averaging times (3-sec gusts, 1-min sustained) and exposure categories (marine, open, urban).
22-
- **Terrain Adjustment:** Applies roughness-based corrections and coastal modifiers using GeoTIFF rasters.
19+
- **Interpolation:** Derives property-level wind speeds from gridded ARA/NIST hurricane data.
20+
- **Conversion:** Transforms wind speeds between averaging times (3-sec gusts, 1-min sustained) and exposure categories (marine, open, urban).
21+
- **Terrain Adjustment:** Applies roughness-based corrections and coastal modifiers using GeoTIFF rasters.
2322
- **Visualization:** Generates interactive Folium-based maps and static Matplotlib plots for analysis and validation.
2423

2524
### Resources
2625

2726
#### Jupyter Notebooks
2827

29-
The following Jupyter notebooks are available to facilitate the analysis of each case.
28+
The following Jupyter notebooks are available to facilitate the analysis of each case.
29+
3030
You can access and run them directly on **DesignSafe** by clicking the link below:
3131

3232
| **Scope** | **Notebook** |
@@ -38,16 +38,16 @@ You can access and run them directly on **DesignSafe** by clicking the link belo
3838

3939
The following DesignSafe resources were used in developing this Use Case:
4040

41-
- [Jupyter notebook on DesignSafe JupyterHub](https://www.designsafe-ci.org/rw/workspace/jupyter/)
42-
- [DesignSafe Publication: Wind Speed Estimation and Conversion (DOI: 10.17603/ds2-kcxr-2683)](https://doi.org/10.17603/ds2-kcxr-2683)
41+
- [Jupyter notebook on DesignSafe JupyterHub](https://www.designsafe-ci.org/rw/workspace/jupyter/)
42+
- [DesignSafe Publication: Wind Speed Estimation and Conversion (DOI: 10.17603/ds2-kcxr-2683)](https://doi.org/10.17603/ds2-kcxr-2683)
4343
- [ARA / NIST Hurricane Wind Field Datasets]
44-
44+
4545
### Implementation
4646

4747
#### System Requirements
4848

49-
- **Python 3.8+**
50-
- **Jupyter Notebook environment** (DesignSafe JupyterHub or local)
49+
- **Python 3.8+**
50+
- **Jupyter Notebook environment** (DesignSafe JupyterHub or local)
5151

5252
#### Dependencies
5353

@@ -65,18 +65,19 @@ Before running the notebook, make sure the following Python libraries are instal
6565
| | `contextily` | Static basemaps (tile layers for Matplotlib) |
6666
| | `matplotlib` | Static plotting and visualization |
6767

68-
6968
#### Steps to Run
70-
1. Download or clone the repository:
69+
70+
1. Download or clone the repository:
7171
```bash
7272
git clone https://github.com/mbakhshandeh2023/WindSpeed-Estimation-UseCase.git
7373
```
74-
2. Open the Jupyter notebook (`Wind_Speed_Estimation.ipynb`).
75-
3. Update file paths in `config1.txt` as needed.
76-
4. Run all notebook cells sequentially to perform interpolation, conversion, and mapping.
74+
2. Open the Jupyter notebook (`Wind_Speed_Estimation.ipynb`).
75+
3. Update file paths in `config1.txt` as needed.
76+
4. Run all notebook cells sequentially to perform interpolation, conversion, and mapping.
7777
5. Outputs (CSV files and HTML maps) will appear in the `Interpolation&ConversionOutput/` directory.
7878

7979
### Maping and Visulization
80+
8081
This usecase presents two complementary approaches to visualize estimated actual wind speed data, each with distinct strengths and suited for different purposes:
8182

8283
#### I. Static Geospatial Map with Matplotlib and Contextily
@@ -93,21 +94,26 @@ This method creates an interactive web map that can be embedded in Jupyter noteb
9394
</figure>
9495

9596
### Background
97+
9698
This use case was developed to support advanced hurricane wind hazard and vulnerability modeling in Florida. It integrates validated wind engineering relationships, spatial interpolation methods, and terrain adjustment techniques within a reproducible Jupyter-based computational framework.
9799

98100
The use case is based on the Jupyter notebook published in the DesignSafe-CI Data Depot — “Wind Speed Estimation and Conversion” (DOI: 10.17603/ds2-kcxr-2683
99101
) — and extends that work by providing a structured example for researchers and practitioners to reproduce, adapt, and integrate into broader catastrophe modeling workflows.
100102

101103
### Citation and Licensing
104+
102105
If you use this repository, please cite:
103106

104107
> Bakhshandeh, M., Pinelli, J.-P., & Cocke, S. (2025). *Wind Speed Estimation and Conversion.* DesignSafe-CI. DOI: [10.17603/ds2-kcxr-2683](https://doi.org/10.17603/ds2-kcxr-2683)
105108
106-
**License:** BSD 3-Clause License
109+
**License:** BSD 3-Clause License
107110

108111
### Data Sources and Confidentiality:
112+
109113
The Jupyter notebook also requires input files containing the latitude and longitude of the analyzed properties. These data can be obtained either from insurance claim records or from publicly available reconnaissance datasets (such as those hosted on the DesignSafe Reconnaissance Portal).
114+
110115
For insurance-related data, confidentiality restrictions may apply. Users are responsible for ensuring that any proprietary or sensitive information is handled in compliance with data privacy agreements and institutional policies. The dataset used in this notebook does not contain any company identifiers or personally identifiable information, ensuring confidentiality is maintained.
111116

112117
### Acknowledgment:
118+
113119
This research was supported by the **National Science Foundation (NSF)** under **Award No. 2022469**, through the **NHERI DesignSafe Cyberinfrastructure**. The opinions and conclusions expressed are those of the authors and do not necessarily reflect the views of the NSF.

0 commit comments

Comments
 (0)