Add iotools functions for Meteonorm (#2499)

* Create meteonorm.py

* Add get_meteonorm_tmy

* Add private shared parse function

* Apply suggestions from code review

Co-authored-by: Ioannis Sifnaios <[email protected]>

* Apply suggestions from code review

Co-authored-by: Ioannis Sifnaios <[email protected]>

* Improve docstring

* Improve functions

* Add first round of tests

* Update tests

* Full test coverage

* Fix linter

* Fix tests

* Increase test coverage

* Implement feedback from Meteonorm review

* Implement feedback from code review from kandersolar

* basic endpoint only support '1h', rename terrain_situation

* Split get_meteonorm into forecast and observation

* Fix linter

* Split observation/forecast into four functions

* Fix linter

* Implement changes from review from kandersolar

* Set index to be the middle of the period

* Extend test coverage

---------

Co-authored-by: Ioannis Sifnaios <[email protected]>

Author: AdamRJensen

docs/sphinx/source/reference/iotools.rst

@@ -92,6 +92,19 @@ Commercial datasets
 Accessing these APIs typically requires payment.
 Datasets provide near-global coverage.
 
+Meteonorm
+*********
+
+.. autosummary::
+   :toctree: generated/
+
+   iotools.get_meteonorm_forecast_basic
+   iotools.get_meteonorm_forecast_precision
+   iotools.get_meteonorm_observation_training
+   iotools.get_meteonorm_observation_realtime
+   iotools.get_meteonorm_tmy
+
+
 SolarAnywhere
 *************
 

docs/sphinx/source/whatsnew/v0.13.1.rst

@@ -20,6 +20,11 @@ Bug fixes
 
 Enhancements
 ~~~~~~~~~~~~
+* Add iotools functions to retrieve irradiance and weather data from Meteonorm:
+  :py:func:`~pvlib.iotools.get_meteonorm_forecast_basic`, :py:func:`~pvlib.iotools.get_meteonorm_forecast_precision`,
+  :py:func:`~pvlib.iotools.get_meteonorm_observation_realtime`, :py:func:`~pvlib.iotools.get_meteonorm_observation_training`,
+  and :py:func:`~pvlib.iotools.get_meteonorm_tmy`.
+  (:pull:`2499`)
 * Add :py:func:`pvlib.iotools.get_nasa_power` to retrieve data from NASA POWER free API.
   (:pull:`2500`)
 * :py:func:`pvlib.spectrum.spectral_factor_firstsolar` no longer emits warnings

pvlib/iotools/__init__.py

@@ -39,4 +39,9 @@
 from pvlib.iotools.solcast import get_solcast_historic  # noqa: F401
 from pvlib.iotools.solcast import get_solcast_tmy  # noqa: F401
 from pvlib.iotools.solargis import get_solargis  # noqa: F401
+from pvlib.iotools.meteonorm import get_meteonorm_forecast_basic  # noqa: F401
+from pvlib.iotools.meteonorm import get_meteonorm_forecast_precision  # noqa: F401, E501
+from pvlib.iotools.meteonorm import get_meteonorm_observation_realtime  # noqa: F401, E501
+from pvlib.iotools.meteonorm import get_meteonorm_observation_training  # noqa: F401, E501
+from pvlib.iotools.meteonorm import get_meteonorm_tmy  # noqa: F401
 from pvlib.iotools.nasa_power import get_nasa_power  # noqa: F401