honeybee
A Python library to create, run and visualize the results of daylight (RADIANCE) and energy analysis (EnergyPlus/OpenStudio).
https://github.com/ladybug-tools/honeybee
Category: Renewable Energy
Sub Category: Photovoltaics and Solar Energy
Keywords from Contributors
ladybug weather-data openstudio energyplus epw grasshopper-plugin ladybug-grasshopper tmy measurements pypi
Last synced: about 2 hours ago
JSON representation
Repository metadata
:honeybee: A python library to create, run and visualize radiance studies. Core library of Honeybee[+].
- Host: GitHub
- URL: https://github.com/ladybug-tools/honeybee
- Owner: ladybug-tools
- License: gpl-3.0
- Created: 2015-12-24T23:43:38.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2022-12-27T16:02:40.000Z (over 2 years ago)
- Last Synced: 2025-04-09T22:43:18.977Z (18 days ago)
- Language: Python
- Homepage: http://ladybug-tools.github.io/honeybee/docs
- Size: 11.8 MB
- Stars: 93
- Watchers: 30
- Forks: 25
- Open Issues: 38
- Releases: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
README.md
honeybee
Honeybee is a Python library to create, run and visualize the results of daylight (RADIANCE) and energy analysis (EnergyPlus/OpenStudio). The current version supports only Radiance integration. For energy simulation you may use the legacy honeybee for Grasshopper.
This repository includes the core library which is the base for Honeybee plugins. For plugin-specific questions and comments refer to honeybee-grasshopper or honeybee-dynamo repositories.
Check this repository for the legacy honeybee plugin for Grasshopper.
Installation
pip install lbt-honeybee==0.1.16
Tentative road map
- Basic Radiance Integration.
- Support annual daylight simulation - daylight coefficient method [Nov 2016].
- Support three-phase daylight simulation [Dec 2016].
- Support five-phase daylight simulation [Aug 2017].
- Fix PEP 8 issues [Dec 2017].
- Code documentation [Dec 2017].
- Provide cloud service support for daylight simulation [Under progress]
- Basic EnergyPlus integration [Nov 2019]
- Support basic HVAC modeling.
- Full OpenStudio integration.
API Documentation
Citing honeybee
For the daylighting library cite this presentation:
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
`
Examples
Here is a Python example that shows how to put a grid-based analysis together. For more examples check one of the plugins repository.
from honeybee_plus.room import Room
from honeybee_plus.radiance.material.glass import Glass
from honeybee_plus.radiance.sky.certainIlluminance import CertainIlluminanceLevel
from honeybee_plus.radiance.recipe.pointintime.gridbased import GridBased
# create a test room
room = Room(origin=(0, 0, 3.2), width=4.2, depth=6, height=3.2,
rotation_angle=45)
# add fenestration
# # add a window to the back wall
room.add_fenestration_surface(wall_name='back', width=2, height=2, sill_height=0.7)
# add another window with custom material. This time to the right wall
glass_60 = Glass.by_single_trans_value('tvis_0.6', 0.6)
room.add_fenestration_surface('right', 4, 1.5, 1.2, radiance_material=glass_60)
# run a grid-based analysis for this room
# generate the sky
sky = CertainIlluminanceLevel(illuminance_value=2000)
# generate grid of test points
analysis_grid = room.generate_test_points(grid_size=0.5, height=0.75)
# put the recipe together
rp = GridBased(sky=sky, analysis_grids=(analysis_grid,), simulation_type=0,
hb_objects=(room,))
# write simulation to folder
batch_file = rp.write(target_folder='.', project_name='room')
# run the simulation
rp.run(batch_file, debug=False)
# results - in this case it will be an analysis grid
result = rp.results()[0]
# print the values for each point
for value in result.combined_value_by_id():
print('illuminance value: %d lux' % value[0])
Owner metadata
- Name: Ladybug Tools
- Login: ladybug-tools
- Email: [email protected]
- Kind: organization
- Description: Ladybug Tools is a collection of free computer applications that support environmentally-conscious design and simulation.
- Website: ladybug.tools
- Location: Worldwide
- Twitter: ladybug_tools
- Company:
- Icon url: https://avatars.githubusercontent.com/u/14942270?v=4
- Repositories: 89
- Last ynced at: 2023-04-03T22:11:19.043Z
- Profile URL: https://github.com/ladybug-tools
GitHub Events
Total
- Watch event: 1
Last Year
- Watch event: 1
Committers metadata
Last synced: 6 days ago
Total Commits: 657
Total Committers: 12
Avg Commits per committer: 54.75
Development Distribution Score (DDS): 0.451
Commits in past year: 0
Committers in past year: 0
Avg Commits per committer in past year: 0.0
Development Distribution Score (DDS) in past year: 0.0
| Name | Commits | |
|---|---|---|
| LAPTOP-MB0HU4QI\Mostapha | s****r@g****m | 361 |
| dependabot-preview[bot] | 2****] | 177 |
| Sarith | s****h@s****n | 79 |
| AntoineDao | a****o@b****m | 12 |
| AntoineDao | a****1@g****m | 10 |
| semantic-release | s****e | 5 |
| AntoineDao | a****e@m****m | 4 |
| Saeran Vasanthakumar | s****v@g****m | 4 |
| Chris | c****s@l****s | 2 |
| Mohammad Hamza | m****a@t****m | 1 |
| Abbaad Haider | a****d@a****m | 1 |
| Theo Armour | t****r | 1 |
Committer domains:
- algebraaec.com: 1
- transsolar.com: 1
- ladybug.tools: 1
- mallzee.com: 1
- burohappold.com: 1
- sarith.in: 1
Issue and Pull Request metadata
Last synced: 1 day ago
Total issues: 207
Total pull requests: 284
Average time to close issues: 3 months
Average time to close pull requests: about 23 hours
Total issue authors: 31
Total pull request authors: 11
Average comments per issue: 2.69
Average comments per pull request: 1.09
Merged pull request: 264
Bot issues: 1
Bot pull requests: 190
Past year issues: 0
Past year pull requests: 0
Past year average time to close issues: N/A
Past year average time to close pull requests: N/A
Past year issue authors: 0
Past year pull request authors: 0
Past year average comments per issue: 0
Past year average comments per pull request: 0
Past year merged pull request: 0
Past year bot issues: 0
Past year bot pull requests: 0
Top Issue Authors
- mostaphaRoudsari (110)
- sariths (52)
- AntoineDao (7)
- MingboPeng (5)
- maurodeluca (2)
- BingWangUS (2)
- TheodoreGalanos (2)
- abbaad (2)
- chriswmackey (2)
- hallvard-spacemaker (2)
- jasbour (1)
- Sinasta (1)
- dependabot-preview[bot] (1)
- antonszilasi (1)
- RMistrick (1)
Top Pull Request Authors
- dependabot-preview[bot] (188)
- sariths (38)
- mostaphaRoudsari (36)
- AntoineDao (12)
- dependabot[bot] (2)
- chriswmackey (2)
- abbaad (2)
- Parikshit-Hooda (1)
- saeranv (1)
- greyhatlinux (1)
- HMZgm86 (1)
Top Issue Labels
- radiance (101)
- enhancement (67)
- critical (65)
- new development (51)
- honeybee (40)
- bug (37)
- backlog (30)
- discussion (22)
- question (19)
- done (6)
- not critical (6)
- hacktoberfest (5)
- released (5)
- [+] (4)
- wish (3)
- triage (3)
- good first issue (2)
- core (2)
- wontfix (2)
- help wanted (1)
- radiance-pmap (1)
- py3 (1)
Top Pull Request Labels
- dependencies (191)
- released (78)
- enhancement (8)
- honeybee (8)
- core (8)
- done (8)
- radiance (7)
- new development (5)
- critical (3)
- bug (2)
- py3 (2)
- invalid (2)
- radiance-pmap (1)
- hacktoberfest (1)
Dependencies
- Sphinx ==1.8.5 development
- Sphinx ==4.1.1 development
- coverage ==5.5 development
- coveralls ==1.7.0 development
- coveralls ==3.2.0 development
- pytest ==4.6.9 development
- pytest ==6.2.4 development
- pytest-cov ==2.12.1 development
- setuptools ==44.1.0 development
- setuptools ==57.4.0 development
- sphinx-bootstrap-theme ==0.7.1 development
- sphinxcontrib-fulltoc ==1.2.0 development
- sphinxcontrib-websupport ==1.1.2 development
- sphinxcontrib-websupport ==1.2.4 development
- twine ==1.13.0 development
- twine ==3.4.2 development
- wheel ==0.36.2 development
- lbt-ladybug ==0.25.78
- ladybugtools/ladybug latest build
Score: 7.360103972989151