pvlib.modelchain.ModelChain.complete_irradiance

ModelChain.complete_irradiance(weather, times=None)[source]

Determine the missing irradiation columns. Only two of the following data columns (dni, ghi, dhi) are needed to calculate the missing data.

This function is not safe at the moment. Results can be too high or negative. Please contribute and help to improve this function on https://github.com/pvlib/pvlib-python

Parameters:
  • weather (DataFrame) – Column names must be 'dni', 'ghi', 'dhi', 'wind_speed', 'temp_air'. All irradiance components are required. Air temperature of 20 C and wind speed of 0 m/s will be added to the DataFrame if not provided.
  • times (None, deprecated) – Deprecated argument included for API compatibility, but not used internally. The index of the weather DataFrame is used for times.
Returns:

self

Notes

Assigns attributes: weather

Examples

This example does not work until the parameters my_system, my_location, my_datetime and my_weather are not defined properly but shows the basic idea how this method can be used.

>>> from pvlib.modelchain import ModelChain

>>> # my_weather containing 'dhi' and 'ghi'.
>>> mc = ModelChain(my_system, my_location)  # doctest: +SKIP
>>> mc.complete_irradiance(my_weather)  # doctest: +SKIP
>>> mc.run_model(mc.weather)  # doctest: +SKIP

>>> # my_weather containing 'dhi', 'ghi' and 'dni'.
>>> mc = ModelChain(my_system, my_location)  # doctest: +SKIP
>>> mc.run_model(my_weather)  # doctest: +SKIP