303 add asce 2023 inspire workshop material

CHANGELOG.md

@@ -5,6 +5,11 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
 
+## [Unreleased]
+
+### Added
+- Add ASCE 2023 INSPIRE workshop material [#303](https://github.com/IN-CORE/incore-docs/issues/303)
+
 ## [4.7.0] - 2023-11-08
 
 ### Added

manual_jb/content/_toc.yml

@@ -90,6 +90,14 @@ chapters:
         - file: workshops/20220131/session2/session2-hazard.ipynb
         - file: workshops/20220131/session3/session3-building_damage_analysis.ipynb
         - file: workshops/20220131/session4/session4-damage-analyses-lifelines.ipynb
+    - file: workshops/20231115/agenda
+      sections:
+        - file: workshops/20231115/session1/session1-jupyter-intro.ipynb
+        - file: workshops/20231115/session2/session2-remote-and-local-hazards.ipynb
+        - file: workshops/20231115/session2/session2-assignment.ipynb
+        - file: workshops/20231115/session2/session2-assignment-answers.ipynb
+        - file: workshops/20231115/session3/session3-bldg-dmg-recv.ipynb
+        - file: workshops/20231115/session4/session4-building-damage-recovery-local-data.ipynb
 - file: notebooks
   sections:
     - file: notebooks/Galveston_testbed/Galveston_testbed.ipynb

manual_jb/content/workshops.md

@@ -23,4 +23,16 @@ Download the full directory of the files:
 
 Download the full directory of the files:
 
-[workshop_2022-01-31.zip](https://github.com/IN-CORE/incore-docs/blob/main/workshops/20220131/workshop_2022-01-31.zip)
+[workshop_2022-01-31.zip](https://github.com/IN-CORE/incore-docs/blob/main/workshops/20220131/workshop_2022-01-31.zip)
+
+## 2023-11-15 INSPIRE workshop
+
+[Agenda](workshops/20231115/agenda.md)
+* Session 1 Overview of IN-CORE & User Workshop Objectives
+* Session 2 **[Working with Remote and Local Hazards (Tornado and Earthquake)](workshops/20231115/session2/session2-remote-and-local-hazards.ipynb)**, [Assignments](workshops/20231115/session2/session2-assignment.ipynb), [Answers](workshops/20231115/session2/session2-assignment-answers.ipynb)
+* Session 3 **[Building Damage and Recovery Analyses with IN-CORE Web Services](workshops/20231115/session3/session3-bldg-dmg-recv.ipynb)**
+* Session 4 **[Building Damage and Recovery Analyses with Local Data](workshops/20231115/session4/session4-building-dmg-recovery-local-data.ipynb)**
+
+* Download the full directory of the files above:
+
+[workshop_2023-11-15.zip](https://github.com/IN-CORE/incore-docs/blob/main/workshops/20231115/workshop_2023-11-15.zip)

manual_jb/content/workshops/20210526/agenda.md

@@ -38,8 +38,8 @@
     * [Session 4 assignment](session4/session4-assignment.ipynb)
     * [Session 4 assignment answers](session4/session4-assignment-answer.ipynb)
 5. Use Case - How to do research with IN-CORE
-    * Yousef Darestani Yousef Darestani *Galveston Island Socio-Physical Damage Analysis* (presentation starts at 3:33:45 of [Recording_1948x1096.mp4](http://resilience.colostate.edu/files/IN-CORE/GMT20210526-170314_Recording_1948x1096.mp4)
-    * Dylan Sanderson *A Spatially Explicit Decision Support Framework for Parcel- and Community-Level Resilience Assessment using Bayesian Networks* ([pdf](https://github.com/IN-CORE/incore-docs/blob/main/workshops/20210526/20210526_Sanderson_shareable.pdf
+    * Yousef Darestani **Galveston Island Socio-Physical Damage Analysis** (presentation starts at 3:33:45 of [Recording_1948x1096.mp4](http://resilience.colostate.edu/files/IN-CORE/GMT20210526-170314_Recording_1948x1096.mp4))
+    * Dylan Sanderson **A Spatially Explicit Decision Support Framework for Parcel- and Community-Level Resilience Assessment using Bayesian Networks** ([pdf](https://github.com/IN-CORE/incore-docs/blob/main/workshops/20210526/20210526_Sanderson_shareable.pdf))
 
 Download the full directory of the files above:
 

manual_jb/content/workshops/20220131/agenda.md

@@ -7,7 +7,7 @@
     * Introduction to IN-CORE Lab and Jupyter Notebook ([pdf](https://github.com/IN-CORE/incore-docs/blob/main/workshops/20220131/session1_intro.pdf))
     * Platform introduction ([pdf](https://github.com/IN-CORE/incore-docs/blob/main/workshops/20220131/intro_platform.pdf))
     * [Session 1 - Jupyter introduction](session1/session1-jupyter-intro.ipynb)
-3. Working with Hazards (Tornado and Earthquake
+3. Working with Hazards (Tornado and Earthquake)
     * [Session 2 - Working with Hazards (Tornado and Earthquake)](session2/session2-hazard.ipynb)
 4. Building Damage Analysis
     * [Session 3 - Building Damage Analysis](session3/session3-building_damage_analysis.ipynb)

manual_jb/content/workshops/20231115/agenda.md

@@ -0,0 +1,19 @@
+# INSPIRE workshop November 15, 2023
+
+## Sessions
+
+1. Introduction
+    * Introduction to IN-CORE Lab and Jupyter Notebook ([pdf](https://github.com/IN-CORE/incore-docs/blob/main/workshops/20231115/session1/session1-intro.pdf))
+    * [Session 1: Introduction to Jupyter Notebook](session1/session1-jupyter-intro.ipynb)
+2. Working with Remote and Local Hazards (Tornado and Earthquake)
+    * [Session 2: How to Work with Remote and Local Hazards](session2/session2-remote-and-local-hazards.ipynb)
+    * [Session 2: Assignment](session2/session2-assignment.ipynb)
+    * [Session 2: Assignment answers](session2/session2-assignment-answers.ipynb)
+3. Building Damage and Recovery Analyses with IN-CORE Web Services
+    * [Session 3: Building Damage and Recovery Analyses with IN-CORE Web Services](session3/session3-bldg-dmg-recv.ipynb)
+4. Building Damage and Recovery Analyses with Local Data
+    * [Session 4: Building Damage and Recovery Analyses with Local Data](session4/session4-building-dmg-recovery-local-data.ipynb)
+
+Download the full directory of the files above:
+
+[workshop_2023-11-15.zip](https://github.com/IN-CORE/incore-docs/blob/main/workshops/20231115/workshop_2023-11-15.zip)

manual_jb/content/workshops/20231115/session1/session1-jupyter-intro.ipynb

@@ -0,0 +1,198 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "2e1c6693",
+   "metadata": {},
+   "source": [
+    "# Session 1: Introduction to Jupyter Notebook\n",
+    "\n",
+    "Perform the following Jupyter notebook operations:\n",
+    "\n",
+    "- Run notebook\n",
+    "- Change a cell and re-run the cell\n",
+    "- Add a new line/cell to a notebook\n",
+    "- Download the workshop material with code cell\n",
+    "- Unzip the downloaded zip file with code cell\n",
+    "\n",
+    "Please follow the instruction at each cell.\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "d383d41e",
+   "metadata": {},
+   "source": [
+    "## 1. Run notebook\n",
+    "\n",
+    "Please run the code cell below.\n",
+    "\n",
+    "You can hit (Ctrl + Enter) to run current cell or (Shift + Enter) to run current cell and go to next cell.\n",
+    "Alternatively, you can click run cell in the toolbar above.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "f670ab37",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "message = \"Hello World\"\n",
+    "print(message)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "6882dfb8",
+   "metadata": {},
+   "source": [
+    "## 2. Change cell and re-run the notebook\n",
+    "\n",
+    "Modify the message of the print statement below to say **\"Hello IN-CORE\"** and run the current cell.\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "533d3de0",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "message = \"Hello World\"\n",
+    "print(message)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "4b9aacb0",
+   "metadata": {},
+   "source": [
+    "## 3. Add a new line and execute it\n",
+    "\n",
+    "Add a new cell below to this notebook. On the new line, modify the **message** variable to print your name.\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "1789602d-bef0-4777-a6ac-b5aecfefcc90",
+   "metadata": {
+    "tags": []
+   },
+   "source": [
+    "## 4. Download a zip file of the workshop material\n",
+    "\n",
+    "URL: https://go.ncsa.illinois.edu/workshop-zip\n",
+    "\n",
+    "Please run the following code to download a zip file. Please make sure that it appears in your file browser (left panel)\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "c64fa4e1-ddef-4bb1-ac56-1c9f409952d3",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# import requests module\n",
+    "import requests"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "0fe9db06-e80c-4bcc-9d1e-448044367e4c",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# set URL and get file contents\n",
+    "url = \"https://go.ncsa.illinois.edu/workshop-zip\"\n",
+    "filename = \"incore-workshop.zip\"\n",
+    "headers = {\"user-agent\": \"Wget/1.16 (linux-gnu)\"}\n",
+    "r = requests.get(url, allow_redirects=True, stream=True, headers=headers)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "e4f1e3b8-7e53-4dd8-bb58-f09660a81e97",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# write the contents to a file\n",
+    "open(filename, \"wb\").write(r.content)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "9eadca4b-69d3-461f-a4d8-d51dde8168d7",
+   "metadata": {
+    "tags": []
+   },
+   "source": [
+    "## 5. Unzip the downloaded zip file\n",
+    "\n",
+    "Please run the following code to unzip the downloaded zip file. Please make sure that all the workshop materials appear in your file browser (left panel)\n",
+    "**NEED TO INSERT the screenshot**\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "c2f4aad6-d99c-46c8-b165-f043ee273f99",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# import zipfile module\n",
+    "import zipfile"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "d05564b7-e13f-49da-acc5-80bc3bfecb78",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# extract the zipfile\n",
+    "with zipfile.ZipFile(filename, \"r\") as zip_ref:\n",
+    "    zip_ref.extractall()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "7390470e-6a85-49cb-b54d-cef005dc9591",
+   "metadata": {},
+   "source": []
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "8d9eeb0b-d255-46e8-a27b-a9104c30382b",
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.13"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

manual_jb/content/workshops/20231115/session2/data/hazard/earthquake/eq-dataset.json

@@ -0,0 +1,31 @@
+{
+  "name": "Example - Memphis Deterministic EQ",
+  "description": "Memphis dataset based deterministic hazard - Pytest",
+  "eqType": "dataset",
+  "hazardDatasets": [
+    {
+      "hazardType": "deterministic",
+      "demandType": "SA",
+      "demandUnits": "g",
+      "period": "0.2",
+      "eqParameters": {
+        "srcLatitude": "35.927",
+        "srcLongitude": "-89.919",
+        "magnitude": "7.9",
+        "depth": "10.0"
+      }
+    },
+    {
+      "hazardType": "deterministic",
+      "demandType": "PGA",
+      "demandUnits": "g",
+      "period": "0.0",
+      "eqParameters": {
+        "srcLatitude": "35.927",
+        "srcLongitude": "-89.919",
+        "magnitude": "7.9",
+        "depth": "10.0"
+      }
+    }
+  ]
+}

manual_jb/content/workshops/20231115/session2/data/hazard/flood/flood-dataset.json

@@ -0,0 +1,23 @@
+{
+  "name": "Example - Lumberton Deterministic Flood - riverine flooding",
+  "description": "Lumberton dataset based deterministic hazard - 2 datasets",
+  "floodType": "dataset",
+  "hazardDatasets": [
+    {
+      "hazardType": "deterministic",
+      "demandType": "inundationDepth",
+      "demandUnits": "ft",
+      "floodParameters": {
+        "model": "riverine flooding"
+      }
+    },
+    {
+      "hazardType": "deterministic",
+      "demandType": "waterSurfaceElevation",
+      "demandUnits": "ft",
+      "floodParameters": {
+        "model": "riverine flooding"
+      }
+    }
+  ]
+}

manual_jb/content/workshops/20231115/session2/data/hazard/hurricane/hurricane-dataset.json

@@ -0,0 +1,31 @@
+{
+  "name": "pytest - Galveston Deterministic Hurricane - Kriging ",
+  "description": "Galveston dataset based deterministic hazard - 3 datasets",
+  "hurricaneType": "dataset",
+  "hazardDatasets": [
+    {
+      "hazardType": "deterministic",
+      "demandType": "waveHeight",
+      "demandUnits": "m",
+      "hurricaneParameters": {
+        "model": "Kriging"
+      }
+    },
+    {
+      "hazardType": "deterministic",
+      "demandType": "surgeLevel",
+      "demandUnits": "m",
+      "hurricaneParameters": {
+        "model": "Kriging"
+      }
+    },
+    {
+      "hazardType": "deterministic",
+      "demandType": "inundationDuration",
+      "demandUnits": "hr",
+      "hurricaneParameters": {
+        "model": "Kriging"
+      }
+    }
+  ]
+}

manual_jb/content/workshops/20231115/session2/data/hazard/tornado/joplin_path_wgs84.prj

@@ -0,0 +1 @@
+GEOGCS["GCS_WGS_1984", DATUM["D_WGS_1984", SPHEROID["WGS_1984", 6378137.0, 298.257223563]], PRIMEM["Greenwich", 0.0], UNIT["degree", 0.017453292519943295], AXIS["Longitude", EAST], AXIS["Latitude", NORTH]]

manual_jb/content/workshops/20231115/session2/data/hazard/tornado/tornado_dataset.json

@@ -0,0 +1,7 @@
+{
+  "name": "Example - Joplin Tornado",
+  "description": "Joplin tornado hazard",
+  "tornadoType": "dataset",
+  "threshold": null,
+  "thresholdUnit": "mph"
+}