supy.util.gen_epw

Contents

Tip

  1. Need help? Please let us know in the UMEP Community.

  2. Please report issues with the manual on GitHub Issues (or use Report Issue for This Page for page-specific feedback).

  3. Please cite SUEWS with proper information from our Zenodo page.

6.3.2.1. supy.util.gen_epw#

supy.util.gen_epw(df_output: DataFrame, lat, lon, tz=0, path_epw=PosixPath('uTMY.epw')) → Tuple[DataFrame, str, Path][source]#

Generate an epw file of uTMY (urbanised Typical Meteorological Year) using SUEWS simulation results

Parameters:

  • df_output (pandas.DataFrame) – SUEWS simulation results.

  • lat (float) – Latitude of the site, used for calculating solar angle.

  • lon (float) – Longitude of the site, used for calculating solar angle.

  • tz (float, optional) – time zone represented by time difference from UTC+0 (e.g., 8 for UTC+8), by default 0 (i.e., UTC+0)

  • path_epw (pathlib.Path, optional) – Path to store generated epw file, by default Path(‘./uTMY.epw’).

Returns:

  • df_epw: pandas.DataFrame - uTMY result

  • text_meta: str - meta-info text

  • path_epw: pathlib.Path - path to generated epw file

Return type:

tuple

Raises:

ImportError – If pvlib is not installed. Install with: pip install pvlib

Notes

This function requires pvlib for solar position and irradiance calculations. pvlib is not included as a required dependency due to its h5py requirement which can cause build issues on some platforms.

Contents