ladybug_comfort.map.irr module

Methods for resolving MRT from Radiance and EnergyPlus output files.

ladybug_comfort.map.irr.irradiance_contrib_map(sql, direct_specular, indirect_specular, ref_specular, indirect_diffuse, ref_diffuse, sun_up_hours, aperture_id=None)[source]

Get matrices of irradiance contribution for a given dynamic aperture.

Parameters

  • result_sql – Path to an SQLite file that was generated by EnergyPlus. This file must contain results for window transmittance.

  • direct_specular – Path to an .ill file output by Radiance containing direct irradiance for the specular version of the aperture group.

  • indirect_specular – Path to an .ill file output by Radiance containing the indirect irradiance for the specular version of the aperture group.

  • ref_specular – Path to an .ill file output by Radiance containing ground-reflected irradiance for the specular version of the aperture group.

  • indirect_diffuse – Path to an .ill file output by Radiance containing the indirect irradiance for the diffuse version of the aperture group.

  • ref_diffuse – Path to an .ill file output by Radiance containing ground-reflected irradiance for the diffuse version of the aperture group.

  • sun_up_hours – Path to a sun-up-hours.txt file output by an annual irradiance simulation.

  • aperture_id – Text string for the identifier of the aperture associated with the irradiance. If unspecified, it will the first aperture found in the result-sql, essentially assuming there is only one dynamic group in the file.

Returns

A tuple fo three values.

  • direct_mtx – A matrix with the direct irradiance contribution.

  • indirect_mtx – A matrix with the indirect irradiance contribution.

  • ref_mtx - A matrix with the ground-reflected irradiance contribution.