honeybee_radiance_postprocess.en17037 module

Functions for EN 17037 post-processing.

honeybee_radiance_postprocess.en17037.en17037_to_files(array: ndarray, metrics_folder: Path, grid_info: dict) → list[source]

Compute annual EN 17037 metrics for a NumPy array and write the results to a folder.

This function generates 6 different files for daylight autonomy based on the varying level of recommendation in EN 17037.

Parameters

  • array – A 2D NumPy array.

  • metrics_folder – An output folder where the results will be written to. The folder will be created if it does not exist.

  • grid_info – A grid information dictionary.

Returns

tuple – Tuple of lists of paths for da, sda, and compliance folders.

honeybee_radiance_postprocess.en17037.en17037_to_folder(results: Union[str, AnnualDaylight], schedule: list, states: Optional[DynamicSchedule] = None, grids_filter: str = '*', sub_folder: str = 'en17037') → Path[source]

Compute annual EN 17037 metrics in a folder and write them in a subfolder.

The results is an output folder of annual daylight recipe.

Parameters

  • results – Results folder.

  • schedule – An annual schedule for 8760 hours of the year as a list of values. This should be a daylight hours schedule.

  • grids_filter – A pattern to filter the grids. By default all the grids will be processed.

  • states – A dictionary of states. Defaults to None.

  • sub_folder – An optional relative path for subfolder to copy results files. Default: en17037.

Returns

str – Path to results folder.