Merge pull request #96 from Deltares/review/fiat_and_vulnerability

Updating the fiat_integrator branch with the latest changes from review/fiat_and_vulnerability

.gitignore

@@ -117,3 +117,4 @@ venv.bak/
 # dask
 /local_test_database
 
+/examples/data/miami_dade_landuse.gpkg

docs/data/national_structure_inventory.rst

@@ -0,0 +1,31 @@
+National Structure Inventory (USA)
+==================================
+
+For projects in the United States, users of **HydroMT-FIAT** can directly and easily make use 
+of the `National Structure Inventory <https://www.hec.usace.army.mil/confluence/nsi>` (NSI). The 
+user can access the data through providing 'NSI' in the configuration file as such::
+
+    [setup_exposure_vector]
+    asset_locations = NSI
+    occupancy_type = NSI
+    max_potential_damage = NSI
+
+The following attributes for Delft-FIAT (left-hand side) will be filled with data from the 
+corresponding NSI fields (right-hand side).
+
+    "Object ID": "fd_id",
+    "Object Name": "fd_id",
+    "Primary Object Type": "st_damcat",
+    "Secondary Object Type": "occtype",
+    "Max Potential Damage: Structure": "val_struct",
+    "Max Potential Damage: Content": "val_cont",
+    "Ground Elevation": "ground_el",
+    "X Coordinate": "x",
+    "Y Coordinate": "y",
+    "Aggregation Label: Census Block": "cbfips"
+
+HydroMT-FIAT obtains the NSI data of the area of interest through the `NSI API 
+<https://www.hec.usace.army.mil/confluence/nsi/technicalreferences/latest/api-reference-guide>`.
+
+For more information about this data we refer to their online `Technical Documentation 
+<https://www.hec.usace.army.mil/confluence/nsi/technicalreferences/latest/technical-documentation>`.

hydromt_fiat/data/attribute_linking/NSI_attributes_to_FIAT.json

@@ -0,0 +1,12 @@
+{
+    "Object ID": "fd_id",
+    "Object Name": "fd_id",
+    "Primary Object Type": "st_damcat",
+    "Secondary Object Type": "occtype",
+    "Max Potential Damage: Structure": "val_struct",
+    "Max Potential Damage: Content": "val_cont",
+    "Ground Elevation": "ground_elv",
+    "X Coordinate": "x",
+    "Y Coordinate": "y",
+    "Aggregation Label: Census Block": "cbfips"
+}