honeybee-grasshopper-radiance 1.35.4__tar.gz → 1.36.0__tar.gz

{honeybee_grasshopper_radiance-1.35.4 → honeybee_grasshopper_radiance-1.36.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: honeybee-grasshopper-radiance
-Version: 1.35.4
+Version: 1.36.0
 Summary: Honeybee Radiance plugin for Grasshopper.
 Home-page: https://github.com/ladybug-tools/honeybee-grasshopper-radiance
 Author: Ladybug Tools

{honeybee_grasshopper_radiance-1.35.4 → honeybee_grasshopper_radiance-1.36.0}/honeybee_grasshopper_radiance/src/HB Annual Average Values.py

@@ -46,7 +46,7 @@ hour/timestep of the simulation.
 
 ghenv.Component.Name = 'HB Annual Average Values'
 ghenv.Component.NickName = 'AvgValues'
-ghenv.Component.Message = '1.9.1'
+ghenv.Component.Message = '1.9.2'
 ghenv.Component.Category = 'HB-Radiance'
 ghenv.Component.SubCategory = '4 :: Results'
 ghenv.Component.AdditionalHelpFromDocStrings = '2'

{honeybee_grasshopper_radiance-1.35.4 → honeybee_grasshopper_radiance-1.36.0}/honeybee_grasshopper_radiance/src/HB Annual Cumulative Values.py

@@ -44,7 +44,7 @@ hour/timestep of the simulation.
 
 ghenv.Component.Name = 'HB Annual Cumulative Values'
 ghenv.Component.NickName = 'CumulValues'
-ghenv.Component.Message = '1.9.1'
+ghenv.Component.Message = '1.9.2'
 ghenv.Component.Category = 'HB-Radiance'
 ghenv.Component.SubCategory = '4 :: Results'
 ghenv.Component.AdditionalHelpFromDocStrings = '2'
@@ -152,8 +152,8 @@ if all_required_inputs(ghenv.Component):
             cmds, cwd=res_folder, shell=use_shell, env=custom_env,
             stdout=subprocess.PIPE, stderr=subprocess.PIPE)
         stdout, stderr = process.communicate()  # wait for the process to finish
+        print(stderr)
         if process.returncode != 0:
-            print(stderr)
             raise ValueError('Failed to compute cumulative values.')
         avg_dir = os.path.join(res_folder, 'metrics', 'cumulative_values')
         if os.path.isdir(avg_dir):

{honeybee_grasshopper_radiance-1.35.4 → honeybee_grasshopper_radiance-1.36.0}/honeybee_grasshopper_radiance/src/HB Annual Daylight Metrics.py

@@ -65,7 +65,7 @@ Calculate Annual Daylight Metrics from a result (.ill) files.
 
 ghenv.Component.Name = "HB Annual Daylight Metrics"
 ghenv.Component.NickName = 'DaylightMetrics'
-ghenv.Component.Message = '1.9.1'
+ghenv.Component.Message = '1.9.2'
 ghenv.Component.Category = 'HB-Radiance'
 ghenv.Component.SubCategory = '4 :: Results'
 ghenv.Component.AdditionalHelpFromDocStrings = '1'
@@ -185,8 +185,8 @@ if all_required_inputs(ghenv.Component):
             cmds, cwd=res_folder, shell=use_shell, env=custom_env,
             stdout=subprocess.PIPE, stderr=subprocess.PIPE)
         stdout, stderr = process.communicate()  # wait for the process to finish
+        print(stderr)
         if process.returncode != 0:
-            print(stderr)
             raise ValueError('Failed to compute annual daylight metrics.')
         metric_dir = os.path.join(res_folder, 'metrics')
         DA = list_to_data_tree(read_da_from_folder(os.path.join(metric_dir, 'da')))

{honeybee_grasshopper_radiance-1.35.4 → honeybee_grasshopper_radiance-1.36.0}/honeybee_grasshopper_radiance/src/HB Annual Peak Values.py

@@ -50,7 +50,7 @@ hour/timestep of the simulation.
 
 ghenv.Component.Name = 'HB Annual Peak Values'
 ghenv.Component.NickName = 'PeakValues'
-ghenv.Component.Message = '1.9.1'
+ghenv.Component.Message = '1.9.2'
 ghenv.Component.Category = 'HB-Radiance'
 ghenv.Component.SubCategory = '4 :: Results'
 ghenv.Component.AdditionalHelpFromDocStrings = '2'
@@ -174,8 +174,8 @@ if all_required_inputs(ghenv.Component):
             cmds, cwd=res_folder, shell=use_shell, env=custom_env,
             stdout=subprocess.PIPE, stderr=subprocess.PIPE)
         stdout, stderr = process.communicate()  # wait for the process to finish
+        print(stderr)
         if process.returncode != 0:
-            print(stderr)
             raise ValueError('Failed to compute peak values.')
         avg_dir = os.path.join(res_folder, 'metrics', 'peak_values')
         if os.path.isdir(avg_dir):

{honeybee_grasshopper_radiance-1.35.4 → honeybee_grasshopper_radiance-1.36.0}/honeybee_grasshopper_radiance/src/HB Annual Results to Data.py

@@ -45,7 +45,7 @@ deconstructed for detailed analysis with native Grasshopper math components.
 
 ghenv.Component.Name = 'HB Annual Results to Data'
 ghenv.Component.NickName = 'AnnualToData'
-ghenv.Component.Message = '1.9.1'
+ghenv.Component.Message = '1.9.2'
 ghenv.Component.Category = 'HB-Radiance'
 ghenv.Component.SubCategory = '4 :: Results'
 ghenv.Component.AdditionalHelpFromDocStrings = '2'
@@ -196,8 +196,8 @@ if all_required_inputs(ghenv.Component):
             cmds, cwd=res_folder, shell=use_shell, env=custom_env,
             stdout=subprocess.PIPE, stderr=subprocess.PIPE)
         stdout, stderr = process.communicate()  # wait for the process to finish
+        print(stderr)
         if process.returncode != 0:
-            print(stderr)
             raise ValueError('Failed to compute data collections.')
         data_dicts = json.loads(stdout)
         data = [[HourlyContinuousCollection.from_dict(d) for d in data]

{honeybee_grasshopper_radiance-1.35.4 → honeybee_grasshopper_radiance-1.36.0}/honeybee_grasshopper_radiance/src/HB Annual Statistics.py

@@ -56,7 +56,7 @@ Statistics can either be computed per sensor or per timestep.
 
 ghenv.Component.Name = "HB Annual Statistics"
 ghenv.Component.NickName = 'AnnualStatistics'
-ghenv.Component.Message = '1.9.1'
+ghenv.Component.Message = '1.9.2'
 ghenv.Component.Category = 'HB-Radiance'
 ghenv.Component.SubCategory = '4 :: Results'
 ghenv.Component.AdditionalHelpFromDocStrings = '2'
@@ -134,8 +134,8 @@ if all_required_inputs(ghenv.Component):
             cmds, cwd=res_folder, shell=use_shell, env=custom_env,
             stdout=subprocess.PIPE, stderr=subprocess.PIPE)
         stdout, stderr = process.communicate()  # wait for the process to finish
+        print(stderr)
         if process.returncode != 0:
-            print(stderr)
             raise ValueError('Failed to compute annual statistics values.')
         
         res_dir = os.path.join(res_folder, 'statistics')

{honeybee_grasshopper_radiance-1.35.4 → honeybee_grasshopper_radiance-1.36.0}/honeybee_grasshopper_radiance/src/HB Annual Sunlight Exposure.py

@@ -43,7 +43,7 @@ results with operable shading devices, then this output is NOT LEED compliant.
 
 ghenv.Component.Name = "HB Annual Sunlight Exposure"
 ghenv.Component.NickName = 'ASE'
-ghenv.Component.Message = '1.9.1'
+ghenv.Component.Message = '1.9.2'
 ghenv.Component.Category = 'HB-Radiance'
 ghenv.Component.SubCategory = '4 :: Results'
 ghenv.Component.AdditionalHelpFromDocStrings = '1'
@@ -134,8 +134,8 @@ if all_required_inputs(ghenv.Component):
             cmds, cwd=res_folder, shell=use_shell, env=custom_env,
             stdout=subprocess.PIPE, stderr=subprocess.PIPE)
         stdout, stderr = process.communicate()  # wait for the process to finish
+        print(stderr)
         if process.returncode != 0:
-            print(stderr)
             raise ValueError('Failed to compute annual sunlight exposure.')
         metric_dir = os.path.join(res_folder, 'metrics')
         ASE = read_ase_from_folder(os.path.join(metric_dir, 'ase'))

honeybee_grasshopper_radiance-1.36.0/honeybee_grasshopper_radiance/src/HB Assign Luminaires.py

@@ -0,0 +1,52 @@
+# Honeybee: A Plugin for Environmental Analysis (GPL)
+# This file is part of Honeybee.
+#
+# Copyright (c) 2025, Ladybug Tools.
+# You should have received a copy of the GNU Affero General Public License
+# along with Honeybee; If not, see <http://www.gnu.org/licenses/>.
+# 
+# @license AGPL-3.0-or-later <https://spdx.org/licenses/AGPL-3.0-or-later>
+
+"""
+Add Radiance Luminaires to a Honeybee Model.
+_
+This assignment is necessary for any Radiance study, though whether a grid or a
+view is required for a particular type of study is depenednet upon the recipe
+used.
+_
+Multiple copies of this component can be used in series and each will add the
+luminaires to any that already exist.
+
+-
+    Args:
+        _model: A Honeybee Model to which the input _luminaires will be assigned.
+        _luminaires: A list of Honeybee-Radiance Luminaires, which will be assigned to
+            the input _model.
+
+    Returns:
+        model: The input Honeybee Model with the luminaires assigned to it.
+"""
+
+ghenv.Component.Name = 'HB Assign Luminaires'
+ghenv.Component.NickName = 'AssignLuminaires'
+ghenv.Component.Message = '1.9.0'
+ghenv.Component.Category = 'HB-Radiance'
+ghenv.Component.SubCategory = '0 :: Basic Properties'
+ghenv.Component.AdditionalHelpFromDocStrings = '6'
+
+try:  # import core honeybee dependencies
+    from honeybee.model import Model
+except ImportError as e:
+    raise ImportError('\nFailed to import honeybee:\n\t{}'.format(e))
+
+try:  # import ladybug_rhino dependencies
+    from ladybug_rhino.grasshopper import all_required_inputs
+except ImportError as e:
+    raise ImportError('\nFailed to import ladybug_rhino:\n\t{}'.format(e))
+
+
+if all_required_inputs(ghenv.Component):
+    assert isinstance(_model, Model), \
+        'Expected Honeybee Model. Got {}.'.format(type(_model))
+    model = _model.duplicate()  # duplicate to avoid editing the input
+    model.properties.radiance.add_luminaires(_luminaires)

honeybee_grasshopper_radiance-1.36.0/honeybee_grasshopper_radiance/src/HB Custom Lamp.py

@@ -0,0 +1,133 @@
+# Honeybee: A Plugin for Environmental Analysis (GPL)
+# This file is part of Honeybee.
+#
+# Copyright (c) 2025, Ladybug Tools.
+# You should have received a copy of the GNU Affero General Public License
+# along with Honeybee; If not, see <http://www.gnu.org/licenses/>.
+# 
+# @license AGPL-3.0-or-later <https://spdx.org/licenses/AGPL-3.0-or-later>
+
+"""
+Create a Honeybee CustomLamp.
+_
+The CustomLamp can be used to set custom chromaticity, color or color temperature.
+If only the _name is set a default CustomLamp of 3200K is created, unless the name
+is a predefined lamp name.
+-
+The priority of input is from the top. This means that if, e.g., both color_temp_
+and xy_cor_ are set by the user, the color temperature have priority and the CustomLamp
+will be created from the color temperature.
+
+-
+    Args:
+        _name: Set the name of the custom lamp. If the name is among the predefined
+            list of lamp names, the lamp name will override any values in the other
+            inputs.
+            _
+            The following lamp names are predefined. The values in parenthesis are
+            the x, y 1931 chromaticity coordinates and lumen depreciation values:
+                clear metal halide    (0.396, 0.39, 0.8)
+                cool white            (0.376, 0.368, 0.85)
+                cool white deluxe     (0.376, 0.368, 0.85)
+                deluxe cool white     (0.376, 0.368, 0.85)
+                deluxe warm white     (0.44, 0.403, 0.85)
+                fluorescent           (0.376, 0.368, 0.85)
+                halogen               (0.4234, 0.399, 1)
+                incandescent          (0.453, 0.405, 0.95)
+                mercury               (0.373, 0.415, 0.8)
+                metal halide          (0.396, 0.39, 0.8)
+                quartz                (0.424, 0.399, 1)
+                sodium                (0.569, 0.421, 0.93)
+                warm white            (0.44, 0.403, 0.85)
+                warm white deluxe     (0.44, 0.403, 0.85)
+                xenon                 (0.324, 0.324, 1)
+        color_temp_: Set the color temperature in Kelvin for the lamp. This is used to
+            calculate the chromaticity coordinates on the CIE 1931 xy diagram. Valid
+            color temperature values are from 1000 to 25000. Will be ignored if the
+            lamp name matches a predefined value.
+        xy_cor_: Chromaticity coordinates for the lamp. This input must be a list
+            of two values [x, y]. Will be ignored if color_temp_ is supplied. Or if
+            the lamp name matches a predefined value.
+        _color_space_: Color space for the chromaticity coordinates. The values and
+            their corresponding color spaces are
+             0 - CIE 1931 Color Space (default)
+             1 - CIE 1960 Color Space
+             2 - CIE 1976 Color Space
+        rgb_color_: Specifiy the RGB color for the lamp. This can be a color from the
+            "Colour Swatch" component or a text panel. Any alpha value of the color
+            will be multiplied with the depreciation factor. Will be ignored if
+            color_temp_ or xy_cor_ are supplied. Or if the lamp name matches a
+            predefined value.
+        _depr_fac_: A scalar multiplier applied to account for lamp lumen
+            depreciation. Must be greater than 0. Default: 1.
+
+    Returns:
+        report: Reports, errors, warnings, etc.
+        custom_lamp: A CustomLamp that can be plugged into a Luminaire.
+"""
+
+ghenv.Component.Name = 'HB Custom Lamp'
+ghenv.Component.NickName = 'CustomLamp'
+ghenv.Component.Message = '1.9.0'
+ghenv.Component.Category = 'HB-Radiance'
+ghenv.Component.SubCategory = '2 :: Light Sources'
+ghenv.Component.AdditionalHelpFromDocStrings = '4'
+
+try:
+    from honeybee_radiance.luminaire import Luminaire, LuminaireZone, CustomLamp, LAMPNAMES
+except ImportError as e:
+    raise ImportError('\nFailed to import honeybee_radiance:\n\t{}'.format(e))
+
+try:  # import ladybug_rhino dependencies
+    from ladybug_rhino.grasshopper import all_required_inputs
+except ImportError as e:
+    raise ImportError('\nFailed to import ladybug_rhino:\n\t{}'.format(e))
+
+
+if all_required_inputs(ghenv.Component):
+    # set defaults
+    color_temp = color_temp_ or None
+    x_cor, y_cor = xy_cor_ or (None, None)
+    color_space = 0 if _color_space_ is None else _color_space_
+    rgb_color = rgb_color_ or None
+    depr_factor = 1 if _depr_fac_ is None else _depr_fac_
+    
+    # record inputs set by user; used for printing message
+    inputs = {'_color_temp_': color_temp_, '_xy_cor_': xy_cor_, '_color_space_': _color_space_, '_rgb_color_': rgb_color_, '_depr_fac_': _depr_fac_}
+    user_inputs = {k for k in inputs if inputs[k]}
+    
+    if _name in LAMPNAMES:
+        custom_lamp = CustomLamp.from_lamp_name(_name, depreciation_factor=depr_factor)
+        print('Custom lamp is a predefined lamp named "{}" with x, y chromaticity coordianes and depreciation factor: {}.'.format(_name, LAMPNAMES[_name]))
+        if user_inputs:
+            print('The input for _name will override the following inputs: {}.'.format(', '.join(user_inputs)))
+    elif color_temp:
+        custom_lamp = CustomLamp.from_color_temperature(_name, color_temp, depreciation_factor=depr_factor)
+        print('Custom lamp will be defined as per the color temperature of: {}.'.format(color_temp))
+        user_inputs.remove('_color_temp_')
+        user_inputs.remove('_depr_fac_') if '_depr_fac_' in user_inputs else None
+        if user_inputs:
+            print('The input for _color_temp_ will override the following inputs: {}.'.format(', '.join(user_inputs)))
+    elif x_cor and y_cor:
+        custom_lamp = CustomLamp.from_xy_coordinates(_name, x_cor, y_cor, depreciation_factor=depr_factor, color_space=color_space)
+        x, y, year = 'x', 'y', 1931
+        if color_space == 1:
+            x, y, year = 'u', 'v', 1960
+        elif color_space == 2:
+            x, y, year = "u'", "v'", 1976
+        print('Custom lamp will be defined as per the following chromaticity coordinates : ({}, {}) = ({}, {}) for the {} CIE Color Space.'.format(x, y, x_cor, y_cor , year))
+        user_inputs.remove('_xy_cor_')
+        user_inputs.remove('_color_space_') if '_color_space_' in user_inputs else None
+        user_inputs.remove('_depr_fac_') if '_depr_fac_' in user_inputs else None
+        if user_inputs:
+            print('The input for _xy_cor_ will override the following inputs: {}.'.format(', '.join(user_inputs)))
+    elif rgb_color:
+        custom_lamp = CustomLamp.from_rgb_colors(_name, rgb_color, depreciation_factor=depr_factor)
+        print('Custom lamp will be defined as per the RGB color: {}.'.format(rgb_color))
+        user_inputs.remove('_rgb_color_')
+        user_inputs.remove('_depr_fac_') if '_depr_fac_' in user_inputs else None
+        if user_inputs:
+            print('The input for _rgb_color_ will override the following inputs: {}.'.format(', '.join(user_inputs)))
+    else:
+        custom_lamp = CustomLamp.from_default_white(_name, depreciation_factor=depr_factor)
+        print('Custom lamp is a default lamp with color temperature of 3200K.')

honeybee_grasshopper_radiance-1.36.0/honeybee_grasshopper_radiance/src/HB Get Luminaires.py

@@ -0,0 +1,50 @@
+# Honeybee: A Plugin for Environmental Analysis (GPL)
+# This file is part of Honeybee.
+#
+# Copyright (c) 2025, Ladybug Tools.
+# You should have received a copy of the GNU Affero General Public License
+# along with Honeybee; If not, see <http://www.gnu.org/licenses/>.
+# 
+# @license AGPL-3.0-or-later <https://spdx.org/licenses/AGPL-3.0-or-later>
+
+"""
+Get Radiance Luminaires from a Honeybee Model.
+-
+    Args:
+        _model: A Honeybee Model for which luminaires will be output.
+
+    Returns:
+        luminaires: A list of Honeybee-Radiance Luminaires that are assigned to the
+            input _model.
+"""
+
+ghenv.Component.Name = 'HB Get Luminaires'
+ghenv.Component.NickName = 'GetLuminaires'
+ghenv.Component.Message = '1.9.0'
+ghenv.Component.Category = 'HB-Radiance'
+ghenv.Component.SubCategory = '0 :: Basic Properties'
+ghenv.Component.AdditionalHelpFromDocStrings = '6'
+
+try:  # import core honeybee dependencies
+    from honeybee.model import Model
+except ImportError as e:
+    raise ImportError('\nFailed to import honeybee:\n\t{}'.format(e))
+
+try:  # import honeybee_radiance dependencies
+    from honeybee_radiance.writer import _filter_by_pattern
+except ImportError as e:
+    raise ImportError('\nFailed to import honeybee_radiance:\n\t{}'.format(e))
+
+try:  # import ladybug_rhino dependencies
+    from ladybug_rhino.grasshopper import all_required_inputs
+except ImportError as e:
+    raise ImportError('\nFailed to import ladybug_rhino:\n\t{}'.format(e))
+
+
+if all_required_inputs(ghenv.Component):
+    assert isinstance(_model, Model), \
+        'Expected Honeybee Model. Got {}.'.format(type(_model))
+    # get the honeybee-radiance objects
+    luminaires = _model.properties.radiance.luminaires
+    if luminaire_filter_ is not None:
+        luminaires = _filter_by_pattern(luminaires, luminaire_filter_)

honeybee_grasshopper_radiance-1.36.0/honeybee_grasshopper_radiance/src/HB Luminaire Zone.py

@@ -0,0 +1,81 @@
+# Honeybee: A Plugin for Environmental Analysis (GPL)
+# This file is part of Honeybee.
+#
+# Copyright (c) 2025, Ladybug Tools.
+# You should have received a copy of the GNU Affero General Public License
+# along with Honeybee; If not, see <http://www.gnu.org/licenses/>.
+# 
+# @license AGPL-3.0-or-later <https://spdx.org/licenses/AGPL-3.0-or-later>
+
+"""
+Create a Honeybee LuminaireZone of LuminaireInstances.
+_
+It is recommended to apply the rotation in the following order: spin, tilt, rotation.
+If an aiming point is added it will override any spin, tilt, and rotation values.
+-
+    Args:
+        _points: A point or list of points that will be used to position the luminaires.
+        _spin_: Rotation about the local vertical axis (degrees), This axis is
+            also called the G0 axis. Default: 0.
+        _tilt_: Tilt angle around the Y axis (degrees). Default: 0.
+        _rotation_: Rotation angle around the Z axis (degrees). Default: 0.
+        aiming_point: A point representing the location at which the photometric
+            axis of the luminaires should be aimed. This can also be a list of
+            points that matches the length of _points.
+
+    Returns:
+        report: Reports, errors, warnings, etc.
+        luminaire_zone: A LuminaireZone that can be plugged into a Luminaire.
+"""
+
+ghenv.Component.Name = 'HB Luminaire Zone'
+ghenv.Component.NickName = 'LuminaireZone'
+ghenv.Component.Message = '1.9.0'
+ghenv.Component.Category = 'HB-Radiance'
+ghenv.Component.SubCategory = '2 :: Light Sources'
+ghenv.Component.AdditionalHelpFromDocStrings = '4'
+
+try:
+    from ladybug_rhino.togeometry import to_point3d
+    from ladybug_rhino.grasshopper import all_required_inputs
+except ImportError as e:
+    raise ImportError('\nFailed to import ladybug_rhino:\n\t{}'.format(e))
+
+try:
+    from honeybee_radiance.luminaire import LuminaireZone, LuminaireInstance
+except ImportError as e:
+    raise ImportError('\nFailed to import honeybee_radiance:\n\t{}'.format(e))
+
+try:  # import ladybug_rhino dependencies
+    from ladybug_rhino.grasshopper import all_required_inputs
+except ImportError as e:
+    raise ImportError('\nFailed to import ladybug_rhino:\n\t{}'.format(e))
+
+
+if all_required_inputs(ghenv.Component):
+    # set defaults
+    points = [to_point3d(pt) for pt in _points]
+    _spin = [0]*len(points) if not _spin_ else _spin_
+    _tilt = [0]*len(points) if not _tilt_ else _tilt_
+    _rotation = [0]*len(points) if not _rotation_ else _rotation_
+    _aiming_point = aiming_point_ or None
+
+    if _aiming_point:
+        if len(_aiming_point) == 1:  # all instances point to same aiming point
+            _aiming_point = _aiming_point * len(points)
+
+    lum_instances = []
+    for idx, point in enumerate(points):
+        spin = _spin[idx]
+        tilt = _tilt[idx]
+        rotation = _rotation[idx]
+    
+        if _aiming_point:
+            aiming_point = _aiming_point[idx]
+            lum_instance = LuminaireInstance.from_aiming_point(point, aiming_point, spin=spin, tilt=tilt, rotation=rotation)
+        else:
+            lum_instance = LuminaireInstance(point, spin, tilt, rotation)
+    
+        lum_instances.append(lum_instance)
+    
+    luminaire_zone = LuminaireZone(lum_instances)

honeybee_grasshopper_radiance-1.36.0/honeybee_grasshopper_radiance/src/HB Luminaire.py

@@ -0,0 +1,71 @@
+# Honeybee: A Plugin for Environmental Analysis (GPL)
+# This file is part of Honeybee.
+#
+# Copyright (c) 2025, Ladybug Tools.
+# You should have received a copy of the GNU Affero General Public License
+# along with Honeybee; If not, see <http://www.gnu.org/licenses/>.
+# 
+# @license AGPL-3.0-or-later <https://spdx.org/licenses/AGPL-3.0-or-later>
+
+"""
+Create a Honeybee Luminaire.
+_
+The Luminaire object stores the photometric data of a light fixture and
+provides methods to:
+    - Parse IES LM-63 photometric data
+    - Generate Radiance geometry via ies2rad
+    - Generate photometric web geometry
+    - Place and orient luminaire instances in space via a LuminaireZone
+_
+The Luminaire must be added to the Honeybee Model. The translation through ies2rad
+happens in the recipe.
+-
+    Args:
+        _ies: Path to an IES LM-63 photometric file or a string of the file contents.
+        _name_: Optional name of the luminaire. If None the IES file is used as
+            the luminaire name. If the Honeybee Model includes multiple luminaires,
+            each luminaire must have an unique name.
+        _luminaire_zone: A Honeybee LuminaireZone. The LuminaireZone specifices
+            the location and rotation of the luminaire instances.
+        custom_lamp_: A Honeybee CustomLamp. This can be used to specify custom
+            chromaticity, color or color temperature.
+        _loss_fac_:  A scalar multiplier applied to account for lamp lumen
+            depreciation, dirt depreciation, or other system losses. Must be
+            greater than 0 (default: 1).
+        _cand_mult_: Additional scalar multiplier applied to candela values
+            after parsing the IES file. Must be greater than 0 (default: 1).
+
+    Returns:
+        report: Reports, errors, warnings, etc.
+        luminaire: A Honeybee Luminaire that can be used in a recipe.
+"""
+
+ghenv.Component.Name = 'HB Luminaire'
+ghenv.Component.NickName = 'Luminaire'
+ghenv.Component.Message = '1.9.0'
+ghenv.Component.Category = 'HB-Radiance'
+ghenv.Component.SubCategory = '2 :: Light Sources'
+ghenv.Component.AdditionalHelpFromDocStrings = '4'
+
+try:
+    from honeybee_radiance.luminaire import Luminaire, LuminaireZone
+except ImportError as e:
+    raise ImportError('\nFailed to import honeybee_radiance:\n\t{}'.format(e))
+
+try:  # import ladybug_rhino dependencies
+    from ladybug_rhino.grasshopper import all_required_inputs
+except ImportError as e:
+    raise ImportError('\nFailed to import ladybug_rhino:\n\t{}'.format(e))
+
+
+if all_required_inputs(ghenv.Component):
+    # set defaults
+    name = _name_ or None
+    light_loss_factor = 1 if _loss_fac_ is None else _loss_fac_
+    candela_multiplier = 1 if _cand_mult_ is None else _cand_mult_
+    custom_lamp = custom_lamp_ or None
+
+    # create luminaire
+    luminaire = Luminaire(
+        _ies, identifier=name, luminaire_zone=_luminaire_zone, custom_lamp=custom_lamp,
+        light_loss_factor=light_loss_factor,candela_multiplier=candela_multiplier)

honeybee_grasshopper_radiance-1.36.0/honeybee_grasshopper_radiance/src/HB Visualize Luminaire.py

@@ -0,0 +1,53 @@
+# Honeybee: A Plugin for Environmental Analysis (GPL)
+# This file is part of Honeybee.
+#
+# Copyright (c) 2025, Ladybug Tools.
+# You should have received a copy of the GNU Affero General Public License
+# along with Honeybee; If not, see <http://www.gnu.org/licenses/>.
+# 
+# @license AGPL-3.0-or-later <https://spdx.org/licenses/AGPL-3.0-or-later>
+
+"""
+Visualize a Luminaire.
+_
+This is useful to check if the the spin, tilt, and rotation is applied correctly.
+
+-
+    Args:
+        _luminaire: A Honeybee Luminaire.
+        _scale_: A scalar value to scale the geometry. By default the geometry
+            is normalized to Rhino model units as a base scale. The scalar value
+            is multiplied with this base scale.
+
+    Returns:
+        report: Reports, errors, warnings, etc.
+        lum_poly: Geometric representation of the luminous opening.
+        lum_web: Geometric representation of the candela distribution of the luminaire.
+        lum_axes: Line representation of the C0-G0 axes of the luminaire.
+"""
+
+ghenv.Component.Name = 'HB Visualize Luminaire'
+ghenv.Component.NickName = 'VizLuminaire'
+ghenv.Component.Message = '1.9.0'
+ghenv.Component.Category = 'HB-Radiance'
+ghenv.Component.SubCategory = '2 :: Light Sources'
+ghenv.Component.AdditionalHelpFromDocStrings = '4'
+
+try:
+    from ladybug_rhino.config import conversion_to_meters
+    from ladybug_rhino.fromobjects import luminaire_objects
+    from ladybug_rhino.grasshopper import all_required_inputs, list_to_data_tree,   \
+        give_warning
+except ImportError as e:
+    raise ImportError('\nFailed to import ladybug_rhino:\n\t{}'.format(e))
+
+
+if all_required_inputs(ghenv.Component):
+    base_scale = 1 / conversion_to_meters()
+    scale = base_scale if _scale_ is None else base_scale * _scale_
+    
+    luminaire_web, luminaire_poly, luminaire_axes = luminaire_objects(_luminaire, scale)
+    
+    lum_web = list_to_data_tree(luminaire_web)
+    lum_poly = list_to_data_tree(luminaire_poly)
+    lum_axes = list_to_data_tree(luminaire_axes)

{honeybee_grasshopper_radiance-1.35.4 → honeybee_grasshopper_radiance-1.36.0}/honeybee_grasshopper_radiance.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: honeybee-grasshopper-radiance
-Version: 1.35.4
+Version: 1.36.0
 Summary: Honeybee Radiance plugin for Grasshopper.
 Home-page: https://github.com/ladybug-tools/honeybee-grasshopper-radiance
 Author: Ladybug Tools