archetypal.dataportal.download_bld_window

archetypal.dataportal.download_bld_window(u_factor, shgc, vis_trans, oauth_key, tolerance=0.05, extension='idf', output_folder=None)[source]

Find window constructions corresponding to a combination of a u_factor, shgc and visible transmittance and download their idf file to disk. it is necessary to have an authentication key (see Info below).

Parameters

  • u_factor (float or tuple) – The center of glass u-factor. Pass a range of values by passing a tuple (from, to). If a tuple is passed, tolerance is ignored.

  • shgc (float or tuple) – The Solar Heat Gain Coefficient. Pass a range of values by passing a tuple (from, to). If a tuple is passed, tolerance is ignored.

  • vis_trans (float or tuple) – The Visible Transmittance. Pass a range of values by passing a tuple (from, to). If a tuple is passed, tolerance is ignored.

  • oauth_key (str) – the Building_Component_Library authentication key.

  • tolerance (float) – relative tolerance for the input values. Default is 0.05 (5%).

  • extension (str) – specify the extension of the file to download. (default: ‘idf’)

  • output_folder (str, optional) – specify folder to save response data to. Defaults to settings.data_folder.

Returns

a list of IDF files containing window objects

matching the parameters.

Return type

(list of archetypal.IDF)

Note

An authentication key from NREL is required to download building components. Register at Building_Component_Library