Allow Exposures.from_raster to set Exposure metadata (#1091)

* Allow metadata values to be set when reading Exposures from raster

* Fix linting

* Fix linting

* Update CHANGELOG.md

* Don't restrict Exposures.from_raster attrs parameter to metadata

Previously we only let the attrs parameter set Exposures metadata
attributes. We remove this restriction so that it can specify any
parameter in the Exposures.__init__ method.

---------

Co-authored-by: emanuel-schmid <[email protected]>

Author: ChrisFairless

CHANGELOG.md

@@ -30,6 +30,7 @@ Removed:
 - Added instructions to install Climada petals on Euler cluster in `doc.guide.Guide_Euler.ipynb` [#1029](https://github.com/CLIMADA-project/climada_python/pull/1029)
 - Added util methods to handle crs coordinates consistently: `is_geo_coords`, `check_if_geo_coords`, `get_crs_unit`, `estimate_matching_threshold`, `degree_to_km`, and `km_to_degree` [#1080](https://github.com/CLIMADA-project/climada_python/pull/1080)
 - `ImpactFunc` and `ImpactFuncSet` now support equality comparisons via `==` [#1027](https://github.com/CLIMADA-project/climada_python/pull/1027)
+- Added optional `attrs` parameter to `Exposures.from_raster` method to set additional object properties through the method's `Exposures.__init__` call.
 
 ### Changed
 

climada/entity/exposures/base.py

@@ -723,6 +723,7 @@ def from_raster(
         width=None,
         height=None,
         resampling=Resampling.nearest,
+        attrs=None,
     ):
         """Read raster data and set latitude, longitude, value and meta
 
@@ -750,11 +751,15 @@ def from_raster(
         resampling : rasterio.warp,.Resampling optional
             resampling
             function used for reprojection to dst_crs
+        attrs : dict
+            dictionary of kwargs passed to the resulting Exposures.__init__
 
         returns
         --------
         Exposures
         """
+        attrs = attrs or {}
+
         meta, value = u_coord.read_raster(
             file_name,
             [band],
@@ -781,6 +786,7 @@ def from_raster(
             },
             meta=meta,
             crs=meta["crs"],
+            **attrs,
         )
 
     def plot_scatter(

climada/entity/exposures/test/test_base.py

@@ -181,7 +181,9 @@ def test__init__mda_in_kwargs(self):
 
     def test_read_raster_pass(self):
         """from_raster"""
-        exp = Exposures.from_raster(HAZ_DEMO_FL, window=Window(10, 20, 50, 60))
+        exp = Exposures.from_raster(
+            HAZ_DEMO_FL, window=Window(10, 20, 50, 60), attrs={"value_unit": "USD"}
+        )
         exp.check()
         self.assertTrue(u_coord.equal_crs(exp.crs, DEF_CRS))
         self.assertAlmostEqual(
@@ -202,6 +204,7 @@ def test_read_raster_pass(self):
         self.assertAlmostEqual(
             exp.gdf["value"].values.reshape((60, 50))[25, 12], 0.056825936
         )
+        self.assertEqual(exp.value_unit, "USD")
 
     def test_assign_raster_pass(self):
         """Test assign_centroids with raster hazard"""