Open-Meteo Wind Resource

CHANGELOG.md

@@ -20,6 +20,7 @@
 - Added `ProFastNPV`, a finance model using ProFAST to calculate NPV of the commodity
 - Moved `compute()` from `ProFastBase` to `ProFastLCO`.
 - Added `NumpyFinancialNPV`, a finance model that uses NumPy Financial npv to calculate the npv from the cash flows
+- Added wind resource model for API calls to Open-Meteo archive
 - Added `load_yaml()` function and flexibility to input a config dictionary to H2IntegrateModel rather than a filepath
 
 ## 0.4.0 [October 1, 2025]

docs/_toc.yml

@@ -44,6 +44,7 @@ parts:
     sections:
       - file: resource/wind_index
       - file: resource/wind_toolkit_v2_api
+      - file: resource/openmeteo_wind_archive
       - file: resource/solar_index
       - file: resource/goes_solar_v4_api
 

docs/resource/openmeteo_wind_archive.md

@@ -0,0 +1,40 @@
+(wind_resource:openmeteo_archive)=
+# Open-Meteo Wind
+
+This resource class downloads wind resource data from the [OpenMeteo Archive API](https://open-meteo.com/en/docs/historical-weather-api)
+
+This dataset allows for resource data to be downloaded for:
+- **resource years** from 1940 to year before the current calendar year.
+- **locations** across the globe.
+- **resource heights** from 10 and 100 meters.
+- **time intervals** of 60 minutes.
+
+## Available Data
+
+| Resource Data     | Resource Heights (m)  |
+| :---------------- | :---------------: |
+| `wind_speed`  | 10, 100 |
+| `wind_direction`  | 10, 100 |
+| `temperature`  | 2 |
+| `pressure`  | 0 |
+| `relative_humidity`  | 2 |
+| `precipitation_rate`  | 0 |
+
+| Additional Data     | Included  |
+| :---------------- | :---------------: |
+| `site_id`      | X  |
+| `site_lat`      | X |
+| `site_lon`      | X |
+| `elevation`      |  -- |
+| `site_tz`      |  *see note  |
+| `data_tz`      | X |
+| `filepath`      | X |
+| `year`      | X |
+| `month`      | X |
+| `day`      | X |
+| `hour`      | X |
+| `minute`      | X |
+
+```{note}
+`site_tz` (the site timezone) is not output explicitly from this model, but `data_tz` would equal the site timezone (specified in plant_config["plant"]["simulation"]["timezone"]) is set as a non-zero value. Otherwise, the resource data is pulled with timestamps given in UTC (this is the default behavior)
+```

docs/resource/wind_index.md

@@ -2,6 +2,7 @@
 # Wind Resource: Model Overview
 
 - [**"wind_toolkit_v2_api"**](wind_resource:wtk_v2_api): this requires an API key for the NREL developer network
+- [**"openmeteo_wind_api"**](wind_resource:openmeteo_archive)
 
 
 ```{note}

h2integrate/core/supported_models.py

@@ -19,6 +19,7 @@
 from h2integrate.converters.iron.iron_wrapper import IronComponent
 from h2integrate.converters.solar.solar_pysam import PYSAMSolarPlantPerformanceModel
 from h2integrate.finances.numpy_financial_npv import NumpyFinancialNPV
+from h2integrate.resource.wind.openmeteo_wind import OpenMeteoHistoricalWindResource
 from h2integrate.storage.generic_storage_cost import GenericStorageCostModel
 from h2integrate.storage.hydrogen.eco_storage import H2Storage
 from h2integrate.converters.wind.atb_wind_cost import ATBWindPlantCostModel
@@ -123,6 +124,7 @@
     # Resources
     "river_resource": RiverResource,
     "wind_toolkit_v2_api": WTKNRELDeveloperAPIWindResource,
+    "openmeteo_wind_api": OpenMeteoHistoricalWindResource,
     "goes_aggregated_solar_v4_api": GOESAggregatedSolarAPI,
     "goes_conus_solar_v4_api": GOESConusSolarAPI,
     "goes_fulldisc_solar_v4_api": GOESFullDiscSolarAPI,
@@ -210,4 +212,5 @@
     "NumpyFinancialNPV": NumpyFinancialNPV,
 }
 
+
 electricity_producing_techs = ["wind", "solar", "pv", "river", "hopp", "natural_gas_plant"]

h2integrate/resource/wind/nrel_developer_wtk_api.py

@@ -173,6 +173,8 @@ def load_data(self, fpath):
             k: v.replace("%", "percent").replace("degrees", "deg").replace("hour", "h")
             for k, v in data_units.items()
         }
+        data_units_temp = {k: "degC" for k, v in data_units.items() if v == "C"}
+        data_units.update(data_units_temp)
         # convert data to standardized units
         data, data_units = self.compare_units_and_correct(data, data_units)