honeybee_plus.radiance.recipe.radiation.gridbased module

Radiation analysis based on Daylight Coefficient Grid-Based Analysis Recipe.

This is a slightly faster implementation for annual radiation analysis using daylight coefficient based method. This recipe genrates -s sky and add it up with analemma.

See: https://github.com/ladybug-tools/honeybee/issues/167#issue-245745189

class honeybee_plus.radiance.recipe.radiation.gridbased.GridBased(sky_mtx, analysis_grids, radiance_parameters=None, reuse_daylight_mtx=True, hb_objects=None, sub_folder='gridbased_radiation')[source]

Bases: honeybee_plus.radiance.recipe.daylightcoeff.gridbased.DaylightCoeffGridBased

Grid based daylight coefficient analysis recipe.

sky_mtx

A radiance SkyMatrix or SkyVector. For an SkyMatrix the analysis will be ran for the analysis period.

analysis_grids

A list of Honeybee analysis grids. Daylight metrics will be calculated for each analysisGrid separately.

radiance_parameters

Radiance parameters for this analysis. Parameters should be an instance of RfluxmtxParameters.

hb_objects

An optional list of Honeybee surfaces or zones (Default: None).

sub_folder

Analysis subfolder for this recipe. (Default: “daylightcoeff”).

classmethod from_json(rec_json)[source]

Create radiation recipe from JSON file { “id”: “radiation”, “type”: “gridbased”, “sky_mtx”: {}, // sky matrix json file “analysis_grids”: [], // list of analysis grids “surfaces”: [], // list of honeybee surfaces “rad_parameters”: {} // radiance gridbased parameters json file }

classmethod from_points_file(epw_file, points_file, sky_density=1, radiance_parameters=None, reuse_daylight_mtx=True, hb_objects=None, sub_folder='gridbased_radiation')[source]

Create grid based daylight coefficient recipe from points file.

classmethod from_weather_file_points_and_vectors(epw_file, point_groups, vector_groups=None, sky_density=1, radiance_parameters=None, reuse_daylight_mtx=True, hb_objects=None, sub_folder='gridbased_radiation')[source]

Create grid based daylight coefficient from weather file, points and vectors.

Parameters
  • epw_file – An EnergyPlus weather file.

  • point_groups – A list of (x, y, z) test points or lists of (x, y, z) test points. Each list of test points will be converted to a TestPointGroup. If testPts is a single flattened list only one TestPointGroup will be created.

  • vector_groups – An optional list of (x, y, z) vectors. Each vector represents direction of corresponding point in testPts. If the vector is not provided (0, 0, 1) will be assigned.

  • sky_density – A positive intger for sky density. 1: Tregenza Sky, 2: Reinhart Sky, etc. (Default: 1)

  • hb_objects – An optional list of Honeybee surfaces or zones (Default: None).

  • sub_folder – Analysis subfolder for this recipe. (Default: “sunlighthours”)

to_json()[source]

Create radiation recipe JSON file { “id”: “radiation”, “type”: “gridbased”, “sky_mtx”: {}, // sky matrix json file “analysis_grids”: [], // list of analysis grids “surfaces”: [], // list of honeybee surfaces “simulation_type”: int // value between 0-2 “rad_parameters”: {} // radiance gridbased parameters json file }

write(target_folder, project_name='untitled', header=True, transpose=False, simplified=False)[source]

Write analysis files to target folder.

Parameters
  • target_folder – Path to parent folder. Files will be created under target_folder/gridbased. use self.sub_folder to change subfolder name.

  • project_name – Name of this project as a string.

  • header – A boolean to include the header lines in commands.bat. header includes PATH and cd toFolder

Returns

Full path to command.bat