{"id":13719090,"url":"https://github.com/ladybug-tools/honeybee","last_synced_at":"2025-09-08T22:06:42.481Z","repository":{"id":46910823,"uuid":"48559615","full_name":"ladybug-tools/honeybee","owner":"ladybug-tools","description":":honeybee: A python library to create, run and visualize radiance studies. Core library of Honeybee[+].","archived":false,"fork":false,"pushed_at":"2022-12-27T16:02:40.000Z","size":12400,"stargazers_count":95,"open_issues_count":39,"forks_count":26,"subscribers_count":30,"default_branch":"master","last_synced_at":"2025-08-25T17:02:40.784Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://ladybug-tools.github.io/honeybee/docs","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ladybug-tools.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-12-24T23:43:38.000Z","updated_at":"2025-08-13T08:27:04.000Z","dependencies_parsed_at":"2023-01-31T04:45:51.477Z","dependency_job_id":null,"html_url":"https://github.com/ladybug-tools/honeybee","commit_stats":null,"previous_names":[],"tags_count":23,"template":false,"template_full_name":null,"purl":"pkg:github/ladybug-tools/honeybee","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ladybug-tools%2Fhoneybee","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ladybug-tools%2Fhoneybee/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ladybug-tools%2Fhoneybee/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ladybug-tools%2Fhoneybee/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ladybug-tools","download_url":"https://codeload.github.com/ladybug-tools/honeybee/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ladybug-tools%2Fhoneybee/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272240947,"owners_count":24898205,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-26T02:00:07.904Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-03T01:00:42.323Z","updated_at":"2025-09-08T22:06:42.458Z","avatar_url":"https://github.com/ladybug-tools.png","language":"Python","readme":"![Honeybee](http://www.ladybug.tools/assets/img/honeybee.png)\n\n[![Build Status](https://travis-ci.org/ladybug-tools/honeybee.svg?branch=master)](https://travis-ci.org/ladybug-tools/honeybee)\n[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)\n[![Coverage Status](https://coveralls.io/repos/github/ladybug-tools/honeybee/badge.svg)](https://coveralls.io/github/ladybug-tools/honeybee)\n\n[![Python 2.7](https://img.shields.io/badge/python-2.7-green.svg)](https://www.python.org/downloads/release/python-270/) [![IronPython](https://img.shields.io/badge/ironpython-2.7-red.svg)](https://github.com/IronLanguages/ironpython2/releases/tag/ipy-2.7.8/)\n\n# honeybee\n\nHoneybee is a Python library to create, run and visualize the results of daylight ([RADIANCE](https://radiance-online.org//)) and energy analysis ([EnergyPlus](https://energyplus.net/)/[OpenStudio](https://www.openstudio.net/)). The current version supports only Radiance integration. For energy simulation you may use the [legacy honeybee for Grasshopper](https://github.com/mostaphaRoudsari/honeybee).\n\nThis repository includes the core library which is the base for Honeybee plugins. For plugin-specific questions and comments refer to [honeybee-grasshopper](https://github.com/ladybug-tools/honeybee-grasshopper) or [honeybee-dynamo](https://github.com/ladybug-tools/honeybee-dynamo) repositories.\n\nCheck [this repository](https://github.com/mostaphaRoudsari/honeybee) for the legacy honeybee plugin for Grasshopper.\n\n## Installation\n\n```\npip install lbt-honeybee==0.1.16\n```\n\n## Tentative road map\n- [x] Basic Radiance Integration.\n- [x] Support annual daylight simulation - daylight coefficient method [Nov 2016].\n- [x] Support three-phase daylight simulation [Dec 2016].\n- [x] Support five-phase daylight simulation [Aug 2017].\n- [x] Fix PEP 8 issues [Dec 2017].\n- [x] Code documentation [Dec 2017].\n- [ ] Provide cloud service support for daylight simulation [Under progress]\n- [x] Basic EnergyPlus integration [Nov 2019]\n- [ ] Support basic HVAC modeling.\n- [ ] Full OpenStudio integration.\n\n\n## [API Documentation](http://ladybug-tools.github.io/apidoc/honeybee)\n\n## Citing honeybee\n\nFor the daylighting library cite this presentation:\n\n*Sadeghipour Roudsari, Mostapha. Subramaniam, Sarith. 2016. Automating Radiance workflows with Python. The 15th Annual Radiance Workshop. Padua, Italy. Available at: https://www.radiance-online.org/community/workshops/2016-padua/presentations/213-SadeghipourSubramaniam-AutomatingWorkflows.pdf*\n`\n\n## Examples\nHere is a Python example that shows how to put a grid-based analysis together. For more examples check one of the plugins repository.\n\n```python\nfrom honeybee_plus.room import Room\nfrom honeybee_plus.radiance.material.glass import Glass\nfrom honeybee_plus.radiance.sky.certainIlluminance import CertainIlluminanceLevel\nfrom honeybee_plus.radiance.recipe.pointintime.gridbased import GridBased\n\n# create a test room\nroom = Room(origin=(0, 0, 3.2), width=4.2, depth=6, height=3.2,\n            rotation_angle=45)\n\n# add fenestration\n#  # add a window to the back wall\nroom.add_fenestration_surface(wall_name='back', width=2, height=2, sill_height=0.7)\n\n# add another window with custom material. This time to the right wall\nglass_60 = Glass.by_single_trans_value('tvis_0.6', 0.6)\nroom.add_fenestration_surface('right', 4, 1.5, 1.2, radiance_material=glass_60)\n\n# run a grid-based analysis for this room\n# generate the sky\nsky = CertainIlluminanceLevel(illuminance_value=2000)\n\n# generate grid of test points\nanalysis_grid = room.generate_test_points(grid_size=0.5, height=0.75)\n\n# put the recipe together\nrp = GridBased(sky=sky, analysis_grids=(analysis_grid,), simulation_type=0,\n               hb_objects=(room,))\n\n# write simulation to folder\nbatch_file = rp.write(target_folder='.', project_name='room')\n\n# run the simulation\nrp.run(batch_file, debug=False)\n\n# results - in this case it will be an analysis grid\nresult = rp.results()[0]\n\n# print the values for each point\nfor value in result.combined_value_by_id():\n    print('illuminance value: %d lux' % value[0])\n```\n","funding_links":[],"categories":["Renewable Energy"],"sub_categories":["Photovoltaics and Solar Energy"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fladybug-tools%2Fhoneybee","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fladybug-tools%2Fhoneybee","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fladybug-tools%2Fhoneybee/lists"}