RadianceObj.readWeatherFile(weatherFile=None, starttime=None, endtime=None, label=None, source=None, coerce_year=None, tz_convert_val=None)[source]

Read either a EPW or a TMY file, calls the functions readTMY or readEPW according to the weatherfile extention.

  • weatherFile (str) – File containing the weather information. EPW, TMY or solargis accepted.

  • starttime (str) – Limited start time option in ‘YYYY-mm-dd_HHMM’ or ‘mm_dd_HH’ format

  • endtime (str) – Limited end time option in ‘YYYY-mm-dd_HHMM’ or ‘mm_dd_HH’ format

  • daydate (str DEPRECATED) – For single day in ‘MM/DD’ or MM_DD format. Now use starttime and endtime set to the same date.

  • label (str) – ‘left’, ‘right’, or ‘center’. For data that is averaged, defines if the timestamp refers to the left edge, the right edge, or the center of the averaging interval, for purposes of calculating sunposition. For example, TMY3 data is right-labeled, so 11 AM data represents data from 10 to 11, and sun position is calculated at 10:30 AM. Currently SAM and PVSyst use left-labeled interval data and NSRDB uses centered.

  • source (str) – To help identify different types of .csv files. If None, it assumes it is a TMY3-style formated data. Current options: ‘TMY3’, ‘solargis’, ‘EPW’

  • coerce_year (int) – Year to coerce weather data to in YYYY format, ie 2021. If more than one year of data in the weather file, year is NOT coerced.

  • tz_convert_val (int) – Convert timezone to this fixed value, following ISO standard (negative values indicating West of UTC.)