honeybee-radiance-postprocess 0.4.226__py2.py3-none-any.whl → 0.4.228__py2.py3-none-any.whl

honeybee_radiance_postprocess/cli/postprocess.py

@@ -697,6 +697,7 @@ def annual_metrics_file(
 @click.option(
     '--grids-info', '-gi', help='An optional JSON file with grid information. '
     'If no file is provided the command will look for a file in the folder.',
+    default=None, show_default=True,
     type=click.Path(exists=True, file_okay=True, dir_okay=False, resolve_path=True)
 )
 @click.option(
@@ -726,27 +727,88 @@ def grid_summary_metric(
         if grids_info:
             with open(grids_info) as gi:
                 grids_info = json.load(gi)
-        else:
-            gi_file = folder.joinpath('grids_info.json')
-            with open(gi_file) as gi:
-                grids_info = json.load(gi)
 
         # get grid metrics
         if grid_metrics:
             with open(grid_metrics) as gm:
                 grid_metrics = json.load(gm)
+
+        # check to see if there is a HBJSON with sensor grid meshes for areas
+        if model:
+            grid_areas = model_grid_areas(model, grids_info)
         else:
-            gi_file = folder.joinpath('grids_info.json')
-            with open(gi_file) as gi:
+            grid_areas = None
+
+        grid_summary(folder, extension, grid_areas, grids_info, name, grid_metrics)
+
+    except Exception:
+        _logger.exception('Failed to calculate grid summary.')
+        sys.exit(1)
+    else:
+        sys.exit(0)
+
+
+@post_process.command('grid-summary-annual-daylight')
+@click.argument(
+    'folder',
+    type=click.Path(exists=True, file_okay=False, dir_okay=True, resolve_path=True)
+)
+@click.option(
+    '--model', '-m', help='An optional HBJSON model file. This will be used to '
+    'find the area of the grids. The area is used when calculating percentages '
+    'of floor area.',
+    type=click.Path(exists=True, file_okay=True, dir_okay=False, resolve_path=True)
+)
+@click.option(
+    '--grids-info', '-gi', help='An optional JSON file with grid information. '
+    'If no file is provided the command will look for a file in the folder.',
+    default=None, show_default=True,
+    type=click.Path(exists=True, file_okay=True, dir_okay=False, resolve_path=True)
+)
+@click.option(
+    '--name', '-n', help='Optional filename of grid summary.',
+    type=str, default='grid_summary', show_default=True
+)
+@click.option(
+    '--grid-metrics', '-gm', help='An optional JSON file with additional '
+    'custom metrics to calculate.', default=None,
+    type=click.Path(exists=True, file_okay=True, dir_okay=False, resolve_path=True)
+)
+def grid_summary_annual_daylight_metric(
+    folder, model, grids_info, name, grid_metrics
+):
+    """Calculate a grid summary.
+
+    \b
+    Args:
+        folder: A folder with annual daylight metrics.
+    """
+    try:
+        # create Path object
+        folder = Path(folder)
+
+        # get grids information
+        if grids_info:
+            with open(grids_info) as gi:
                 grids_info = json.load(gi)
 
+        # get grid metrics
+        if grid_metrics:
+            with open(grid_metrics) as gm:
+                grid_metrics = json.load(gm)
+
         # check to see if there is a HBJSON with sensor grid meshes for areas
         if model:
             grid_areas = model_grid_areas(model, grids_info)
         else:
-            grid_areas = [None] * len(grids_info)
+            grid_areas = None
 
-        grid_summary(folder, extension, grids_info, grid_areas, name, grid_metrics)
+        for metric in ['da', 'cda', 'udi', 'udi_lower', 'udi_upper']:
+            metric_folder = folder.joinpath(metric)
+            extension = metric.split('_')[0]
+            grid_summary(
+                metric_folder, extension, grids_info, grid_areas, name,
+                grid_metrics)
 
     except Exception:
         _logger.exception('Failed to calculate grid summary.')

honeybee_radiance_postprocess/cli/translate.py

@@ -1,9 +1,11 @@
 """Commands to translate objects."""
 import sys
 import logging
+from pathlib import Path
+import shutil
 import numpy as np
 import click
-from pathlib import Path
+import json
 
 from ..reader import binary_to_array
 
@@ -129,3 +131,70 @@ def binary_to_npy(mtx_file, conversion, name, output_folder):
         sys.exit(1)
     else:
         sys.exit(0)
+
+
+@translate.command('annual-daylight-npy-to-ill')
+@click.argument(
+    'folder',
+    type=click.Path(exists=True, file_okay=False, dir_okay=True, resolve_path=True)
+)
+@click.option(
+    '--output-folder', '-of', help='Output folder. If not provided the output '
+    'folder will be created in the same directory as the results folder. The '
+    'new folder will be called results_ill.', default=None,
+    type=click.Path(exists=False, file_okay=False, dir_okay=True, resolve_path=True)
+)
+def annual_daylight_npy_to_ill(folder, output_folder):
+    """Convert an annual daylight results folder to older version.
+
+    This command reads an annual daylight results folder with results saved as
+    npy files (NumPy), and converts the npy files to text files in the old
+    results folder format.
+
+    \b
+    Args:
+        folder: Results folder. This folder is an output folder of annual
+            daylight recipe. Folder should include grids_info.json and
+            sun-up-hours.txt.
+    """
+    try:
+        folder = Path(folder)
+        static_ill_folder = folder.joinpath('__static_apertures__/default/total')
+        if not static_ill_folder.exists():
+            raise FileNotFoundError(
+                'No results were found for static apertures in the results '
+                'folder.')
+        grids_info_file = folder.joinpath('grids_info.json')
+        if not grids_info_file.exists():
+            raise FileNotFoundError(
+                'The file grids_info.json was not found in the results folder.')
+        sun_up_hours_file = folder.joinpath('sun-up-hours.txt')
+        if not sun_up_hours_file.exists():
+            raise FileNotFoundError(
+                'The file sun-up-hours.txt was not found in the results folder.')
+
+        if output_folder is None:
+            output_folder = folder.parent.joinpath('results_ill')
+        else:
+            output_folder = Path(output_folder)
+        output_folder.mkdir(parents=True, exist_ok=True)
+
+        with open(grids_info_file) as json_file:
+            grids_info = json.load(json_file)
+
+        for grid_info in grids_info:
+            full_id = grid_info['full_id']
+            npy_file = static_ill_folder.joinpath(f'{full_id}.npy')
+
+            array = np.load(npy_file)
+            output = Path(output_folder, full_id + '.ill')
+            np.savetxt(output, array, fmt='%.7e', delimiter='\t')
+
+        # copy grids_info and sun-up-hours
+        shutil.copy(grids_info_file, output_folder.joinpath('grids_info.json'))
+        shutil.copy(sun_up_hours_file, output_folder.joinpath('sun-up-hours.txt'))
+    except Exception:
+        _logger.exception('Converting annual daylight results folder failed.')
+        sys.exit(1)
+    else:
+        sys.exit(0)

honeybee_radiance_postprocess/helper.py

@@ -1,4 +1,5 @@
 """Helper functions."""
+import json
 import numpy as np
 
 from honeybee.model import Model
@@ -25,7 +26,7 @@ def model_grid_areas(model, grids_info):
 
 
 def grid_summary(
-        folder, extension, grids_info, grid_areas, name='grid_summary',
+        folder, extension, grid_areas=None, grids_info=None, name='grid_summary',
         grid_metrics=None
     ):
     """Calculate a grid summary for a single metric.
@@ -33,11 +34,22 @@ def grid_summary(
     Args:
         folder: A folder with results.
         extension: Extension of the files to collect data from.
+        grid_areas: A list of area of each sensor.
         grids_info: Grid information as a dictionary.
-        grid_areas:
         name: Optional filename of grid summary.
         grid_metrics: Additional customized metrics to calculate.
     """
+    if grids_info is None:
+        gi_file = folder.joinpath('grids_info.json')
+        if not gi_file.exists():
+            raise FileNotFoundError(
+                f'The file grids_info.json was not found in the folder: {folder}.')
+        with open(gi_file) as gi:
+            grids_info = json.load(gi)
+
+    if grid_areas is None:
+        grid_areas = [None] * len(grids_info)
+
     # set up the default data types
     dtype = [
         ('Sensor Grid', 'O'),
@@ -67,58 +79,11 @@ def grid_summary(
 
         data = [full_id, _mean, _min, _max, _uniformity_ratio]
 
-        grid_metrics_data = []
         if grid_metrics is not None:
-            for gr_metric in grid_metrics:
-                if len(gr_metric) == 1:
-                    for k, v in gr_metric.items():
-                        if k == 'anyOff' or k == 'allOff':
-                            gr_metric_arrays = []
-                            for vv in v:
-                                for kk, threshold in vv.items():
-                                    if kk == 'minimum':
-                                        gr_metric_arrays.append(array > threshold)
-                                    elif kk == 'exclusiveMinimum':
-                                        gr_metric_arrays.append(array >= threshold)
-                                    elif kk == 'maximum':
-                                        gr_metric_arrays.append(array < threshold)
-                                    elif kk == 'exclusiveMaximum':
-                                        gr_metric_arrays.append(array <= threshold)
-                            if k == 'anyOff':
-                                gr_metric_bool = np.any(gr_metric_arrays, axis=0)
-                            else:
-                                gr_metric_bool = np.all(gr_metric_arrays, axis=0)
-                            gr_metric_pct = \
-                                _calculate_percentage(gr_metric_bool, grid_info, grid_area)
-                        else:
-                            threshold = v
-                            if k == 'minimum':
-                                gr_metric_bool = array > threshold
-                            elif k == 'exclusiveMinimum':
-                                gr_metric_bool = array >= threshold
-                            elif k == 'maximum':
-                                gr_metric_bool = array < threshold
-                            elif k == 'exclusiveMaximum':
-                                gr_metric_bool = array <= threshold
-                            gr_metric_pct = \
-                                _calculate_percentage(gr_metric_bool, grid_info, grid_area)
-                elif len(gr_metric) == 2:
-                    gr_metric_arrays = []
-                    for k, threshold in gr_metric.items():
-                        if k == 'minimum':
-                            gr_metric_arrays.append(array > threshold)
-                        elif k == 'exclusiveMinimum':
-                            gr_metric_arrays.append(array >= threshold)
-                        elif k == 'maximum':
-                            gr_metric_arrays.append(array < threshold)
-                        elif k == 'exclusiveMaximum':
-                            gr_metric_arrays.append(array <= threshold)
-                    gr_metric_bool = np.all(gr_metric_arrays, axis=0)
-                    gr_metric_pct = \
-                        _calculate_percentage(gr_metric_bool, grid_info, grid_area)
-                grid_metrics_data.append(gr_metric_pct)
-
-        data.extend(grid_metrics_data)
+            # get grid metrics
+            grid_metrics_data = \
+                _get_grid_metrics(array, grid_metrics, grid_info, grid_area)
+            data.extend(grid_metrics_data)
 
         arrays.append(tuple(data))
 
@@ -126,17 +91,17 @@ def grid_summary(
     struct_array = np.array(arrays, dtype=dtype)
 
     # write header to file
-    with open(folder.joinpath(f'{name}.csv'), 'w') as file:
-        file.write(','.join(header))
-    # write structured array to file
+    with open(folder.joinpath(f'{name}.csv'), 'w') as grid_summary_file:
+        grid_summary_file.write(','.join(header))
+    # write structured array to grid_summary_file
     fmt = ['%s' , '%.2f', '%.2f', '%.2f', '%.2f']
     if grid_metrics is not None:
-        fmt.extend(['%.2f' for d in grid_metrics])
-    with open(folder.joinpath(f'{name}.csv'), 'a') as file:
-        file.write('\n')
-        np.savetxt(file, struct_array, delimiter=',', fmt=fmt)
+        fmt.extend(['%.2f' for _gr_m in grid_metrics])
+    with open(folder.joinpath(f'{name}.csv'), 'a') as grid_summary_file:
+        grid_summary_file.write('\n')
+        np.savetxt(grid_summary_file, struct_array, delimiter=',', fmt=fmt)
 
-    return file
+    return grid_summary_file
 
 
 def _calculate_percentage(gr_metric_bool, grid_info, grid_area=None):
@@ -157,3 +122,56 @@ def _calculate_percentage(gr_metric_bool, grid_info, grid_area=None):
         gr_metric_pct = \
             gr_metric_bool.sum() / grid_info['count'] * 100
     return gr_metric_pct
+
+
+def _numeric_type(array, gr_metric):
+    if 'minimum' in gr_metric:
+        gr_metric_bool = array > gr_metric['minimum']
+    elif 'exclusiveMinimum' in gr_metric:
+        gr_metric_bool = array >= gr_metric['minimum']
+    elif 'maximum' in gr_metric:
+        gr_metric_bool = array < gr_metric['maximum']
+    elif 'exclusiveMaximum' in gr_metric:
+        gr_metric_bool = array <= gr_metric['exclusiveMaximum']
+    return gr_metric_bool
+
+
+def _grid_summary_all_any(array, gr_metric, grid_info, grid_area, keyword):
+    gr_metric_arrays = []
+    for gr_m in gr_metric[keyword]:
+        assert len(gr_m) == 1
+        gr_metric_arrays.append(_numeric_type(array, gr_m))
+    if keyword == 'allOf':
+        gr_metric_bool = np.all(gr_metric_arrays, axis=0)
+    else:
+        gr_metric_bool = np.any(gr_metric_arrays, axis=0)
+    gr_metric_pct = \
+        _calculate_percentage(gr_metric_bool, grid_info, grid_area)
+    return gr_metric_pct
+
+
+def _get_grid_metrics(array, grid_metrics, grid_info, grid_area):
+    grid_metrics_data = []
+    for gr_metric in grid_metrics:
+        if len(gr_metric) == 1:
+            if 'allOf' in gr_metric:
+                gr_metric_pct = \
+                    _grid_summary_all_any(
+                        array, gr_metric, grid_info, grid_area, 'allOf')
+            elif 'anyOf' in gr_metric:
+                gr_metric_pct = \
+                    _grid_summary_all_any(
+                        array, gr_metric, grid_info, grid_area, 'anyOf')
+            else:
+                gr_metric_bool = _numeric_type(array, gr_metric)
+                gr_metric_pct = \
+                    _calculate_percentage(gr_metric_bool, grid_info, grid_area)
+        elif len(gr_metric) == 2:
+            gr_metric_arrays = []
+            for k, threshold in gr_metric.items():
+                gr_metric_arrays.append(_numeric_type(array, {k: threshold}))
+            gr_metric_bool = np.all(gr_metric_arrays, axis=0)
+            gr_metric_pct = \
+                _calculate_percentage(gr_metric_bool, grid_info, grid_area)
+        grid_metrics_data.append(gr_metric_pct)
+    return grid_metrics_data

{honeybee_radiance_postprocess-0.4.226.dist-info → honeybee_radiance_postprocess-0.4.228.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: honeybee-radiance-postprocess
-Version: 0.4.226
+Version: 0.4.228
 Summary: Postprocessing of Radiance results and matrices
 Home-page: https://github.com/ladybug-tools/honeybee-radiance-postprocess
 Author: Ladybug Tools

{honeybee_radiance_postprocess-0.4.226.dist-info → honeybee_radiance_postprocess-0.4.228.dist-info}/RECORD

@@ -5,7 +5,7 @@ honeybee_radiance_postprocess/annualdaylight.py,sha256=uC1CeIL3oBdkLTxaAUGB022RD
 honeybee_radiance_postprocess/dynamic.py,sha256=YpUxFB1IQgwvJleg1pez3JGpacGZymCBomnAiOTquks,7982
 honeybee_radiance_postprocess/electriclight.py,sha256=E7uhq7-YtZ02F9a1FbEdrXnxmYJNOFnfLF0Yw3JLQ-g,732
 honeybee_radiance_postprocess/en17037.py,sha256=tFoEOhJ4GgB45E6PmTrV1uMAS9e8QQo8eoDkX7Wb2S8,10731
-honeybee_radiance_postprocess/helper.py,sha256=fO1fCns096us0WmxNEx3Xh_gjrIGhPiIZzSaumIlLGM,6259
+honeybee_radiance_postprocess/helper.py,sha256=syaxOjymkSRb69NH5EjD2gplp6idwSZsH0R6yYQAcvc,6140
 honeybee_radiance_postprocess/leed.py,sha256=FPCD5Eg-hBzA2PK2yxHqi9RUEGQhprGLhajgH_Sy00A,26042
 honeybee_radiance_postprocess/metrics.py,sha256=TVChEPtyYrn9MjTRtDL77B3-QZL3J4nP9zrWJDNwC40,13511
 honeybee_radiance_postprocess/reader.py,sha256=6myKzfGC1pO8zPixg1kKrKjPihHabTKUh2t5BlJvij0,2367
@@ -16,14 +16,14 @@ honeybee_radiance_postprocess/cli/__init__.py,sha256=4RkpR91GPXWatDE4I_27ce-N4Fw
 honeybee_radiance_postprocess/cli/grid.py,sha256=qpugRC4kWdJd3N8AubeLstcm0D5bW3CjTopsdwXHlPE,8957
 honeybee_radiance_postprocess/cli/leed.py,sha256=o10tYnp_eRLEX7QV6jHj6cVRQA_6zYg_v9bZGbHo3eo,3082
 honeybee_radiance_postprocess/cli/mtxop.py,sha256=UZJnjNpPjDmShy1-Mxos4H2vTUqk_yP3ZyaC1_LLFeI,5015
-honeybee_radiance_postprocess/cli/postprocess.py,sha256=EL1ujHitShsD79xHIfDVIZqjW6oy9lseu7yc2zkVuuo,27022
+honeybee_radiance_postprocess/cli/postprocess.py,sha256=GUANSqugbvalcBcvNwsASS6yyVBPlxsDMnjwpVrXpSU,29042
 honeybee_radiance_postprocess/cli/schedule.py,sha256=OokuuH9_pdgkt2zFgfjBvrV2Fj1Ow1WtiGRPvpyHfNk,3884
-honeybee_radiance_postprocess/cli/translate.py,sha256=tMyFcT80_NXhNIMH1Nn-10dRrk534NRl-_L-mK-0sHQ,4031
+honeybee_radiance_postprocess/cli/translate.py,sha256=18zkcGeRZALJ5Z82NEB3XZ-iEX2cHyneobGWV-IXWE0,6789
 honeybee_radiance_postprocess/cli/two_phase.py,sha256=O0ugIQh0MOAEl3Q8IsZU4IQ8jNPPOOfeqs5ccwlix6Q,4559
 honeybee_radiance_postprocess/cli/util.py,sha256=Be9cGmYhcV2W37ma6SgQPCWCpWLLLlroxRYN_l58kY0,4077
-honeybee_radiance_postprocess-0.4.226.dist-info/LICENSE,sha256=hIahDEOTzuHCU5J2nd07LWwkLW7Hko4UFO__ffsvB-8,34523
-honeybee_radiance_postprocess-0.4.226.dist-info/METADATA,sha256=1wNmIjNStnjoQZT3xl2R0e8sR8AY5VJoiSyadZuCrj4,2227
-honeybee_radiance_postprocess-0.4.226.dist-info/WHEEL,sha256=unfA4MOaH0icIyIA5oH6E2sn2Hq5zKtLlHsWapZGwes,110
-honeybee_radiance_postprocess-0.4.226.dist-info/entry_points.txt,sha256=gFtVPx6UItXt27GfEZZO00eOZChJJEL6JwGSAB_O3rs,96
-honeybee_radiance_postprocess-0.4.226.dist-info/top_level.txt,sha256=4-sFbzy7ewP2EDqJV3jeFlAFx7SuxtoBBELWaKAnLdA,30
-honeybee_radiance_postprocess-0.4.226.dist-info/RECORD,,
+honeybee_radiance_postprocess-0.4.228.dist-info/LICENSE,sha256=hIahDEOTzuHCU5J2nd07LWwkLW7Hko4UFO__ffsvB-8,34523
+honeybee_radiance_postprocess-0.4.228.dist-info/METADATA,sha256=xh7iMof6MgmWgHextLuhQKO4tD1Q5LnKydLwVAdVjrQ,2227
+honeybee_radiance_postprocess-0.4.228.dist-info/WHEEL,sha256=unfA4MOaH0icIyIA5oH6E2sn2Hq5zKtLlHsWapZGwes,110
+honeybee_radiance_postprocess-0.4.228.dist-info/entry_points.txt,sha256=gFtVPx6UItXt27GfEZZO00eOZChJJEL6JwGSAB_O3rs,96
+honeybee_radiance_postprocess-0.4.228.dist-info/top_level.txt,sha256=4-sFbzy7ewP2EDqJV3jeFlAFx7SuxtoBBELWaKAnLdA,30
+honeybee_radiance_postprocess-0.4.228.dist-info/RECORD,,