
[](https://github.com/ladybug-tools/honeybee-energy/actions)
[](https://coveralls.io/github/ladybug-tools/honeybee-energy)
[](https://www.python.org/downloads/release/python-3100/) [](https://www.python.org/downloads/release/python-370/) [](https://github.com/IronLanguages/ironpython2/releases/tag/ipy-2.7.8/)
# honeybee-energy
Honeybee extension for energy simulation.
Honeybee-energy leverages the [EnergyPlus](https://github.com/NREL/EnergyPlus)
simulation engine and the [OpenStudio](https://github.com/NREL/OpenStudio)
SDK in order to add energy simulation properties and capabilities to
[honeybee-core](https://github.com/ladybug-tools/honeybee-core). The package can also
use the [honeybee-openstudio](https://github.com/ladybug-tools/honeybee-openstudio)
Python package to translate honeybee Models to OpenStudio format.
All of these dependencies are contained within the [honeybee-energy Docker image](https://hub.docker.com/r/ladybugtools/honeybee-energy)
Honeybee-energy is also used by other honeybee extensions that translate honeybee
models to building energy simulation engines, including
[honeybee-doe2](https://github.com/ladybug-tools/honeybee-doe2) and
[honeybee_ph](https://github.com/PH-Tools/honeybee_ph).
## Installation
`pip install -U honeybee-energy`
If you want to also include the standards library of typical ProgramTypes and
ConstructionSets use:
`pip install -U honeybee-energy[standards]`
If you want to also include the honeybee-openstudio library to perform translations
to OpenStudio use:
`pip install -U honeybee-energy[openstudio]`
To check if the command line interface is installed correctly use `honeybee-energy --help`.
## [API Documentation](http://ladybug-tools.github.io/honeybee-energy/docs)
## Local Development
1. Clone this repo locally
```console
git clone git@github.com:ladybug-tools/honeybee-energy
# or
git clone https://github.com/ladybug-tools/honeybee-energy
```
2. Install dependencies:
```console
cd honeybee-energy
pip install -r dev-requirements.txt
pip install -r requirements.txt
```
3. Run Tests:
```console
python -m pytest tests/
```
4. Generate Documentation:
```console
sphinx-apidoc -f -e -d 4 -o ./docs ./honeybee_energy
sphinx-build -b html ./docs ./docs/_build/docs
```
Raw data
{
"_id": null,
"home_page": "https://github.com/ladybug-tools/honeybee-energy",
"name": "honeybee-energy",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "Ladybug Tools",
"author_email": "info@ladybug.tools",
"download_url": "https://files.pythonhosted.org/packages/58/32/86b3af1e40eeff522ac680ec9d74aff14d9bb1b395f6ea6de4c363d34c73/honeybee_energy-1.116.52.tar.gz",
"platform": null,
"description": "\n\n[](https://github.com/ladybug-tools/honeybee-energy/actions)\n[](https://coveralls.io/github/ladybug-tools/honeybee-energy)\n\n[](https://www.python.org/downloads/release/python-3100/) [](https://www.python.org/downloads/release/python-370/) [](https://github.com/IronLanguages/ironpython2/releases/tag/ipy-2.7.8/)\n\n# honeybee-energy\n\nHoneybee extension for energy simulation.\n\nHoneybee-energy leverages the [EnergyPlus](https://github.com/NREL/EnergyPlus)\nsimulation engine and the [OpenStudio](https://github.com/NREL/OpenStudio)\nSDK in order to add energy simulation properties and capabilities to\n[honeybee-core](https://github.com/ladybug-tools/honeybee-core). The package can also\nuse the [honeybee-openstudio](https://github.com/ladybug-tools/honeybee-openstudio)\nPython package to translate honeybee Models to OpenStudio format.\n\nAll of these dependencies are contained within the [honeybee-energy Docker image](https://hub.docker.com/r/ladybugtools/honeybee-energy)\n\nHoneybee-energy is also used by other honeybee extensions that translate honeybee\nmodels to building energy simulation engines, including\n[honeybee-doe2](https://github.com/ladybug-tools/honeybee-doe2) and\n[honeybee_ph](https://github.com/PH-Tools/honeybee_ph).\n\n## Installation\n\n`pip install -U honeybee-energy`\n\nIf you want to also include the standards library of typical ProgramTypes and\nConstructionSets use:\n\n`pip install -U honeybee-energy[standards]`\n\nIf you want to also include the honeybee-openstudio library to perform translations\nto OpenStudio use:\n\n`pip install -U honeybee-energy[openstudio]`\n\nTo check if the command line interface is installed correctly use `honeybee-energy --help`.\n\n## [API Documentation](http://ladybug-tools.github.io/honeybee-energy/docs)\n\n## Local Development\n\n1. Clone this repo locally\n```console\ngit clone git@github.com:ladybug-tools/honeybee-energy\n\n# or\n\ngit clone https://github.com/ladybug-tools/honeybee-energy\n```\n2. Install dependencies:\n```console\ncd honeybee-energy\npip install -r dev-requirements.txt\npip install -r requirements.txt\n```\n\n3. Run Tests:\n```console\npython -m pytest tests/\n```\n\n4. Generate Documentation:\n```console\nsphinx-apidoc -f -e -d 4 -o ./docs ./honeybee_energy\nsphinx-build -b html ./docs ./docs/_build/docs\n```\n",
"bugtrack_url": null,
"license": "AGPL-3.0",
"summary": "Energy simulation library for honeybee.",
"version": "1.116.52",
"project_urls": {
"Homepage": "https://github.com/ladybug-tools/honeybee-energy"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "7c2d07b23e90900929ff1cbf982f7af8f3a3b1d0ea0685e8fbd2ec411b32c98e",
"md5": "58fcda88e517a84ea5f6e0a460605f20",
"sha256": "63b84054c92b841c0f28096d588a22d4442114f75944de2b5ad9a6dc22ab072f"
},
"downloads": -1,
"filename": "honeybee_energy-1.116.52-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "58fcda88e517a84ea5f6e0a460605f20",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 553438,
"upload_time": "2025-07-11T22:40:03",
"upload_time_iso_8601": "2025-07-11T22:40:03.402677Z",
"url": "https://files.pythonhosted.org/packages/7c/2d/07b23e90900929ff1cbf982f7af8f3a3b1d0ea0685e8fbd2ec411b32c98e/honeybee_energy-1.116.52-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "583286b3af1e40eeff522ac680ec9d74aff14d9bb1b395f6ea6de4c363d34c73",
"md5": "2692bddd66afb26bd707a77a75f92b09",
"sha256": "a416b3f8464f9306688417476ce6818bc2fdb827cd42964fdfa1b7288a59cba3"
},
"downloads": -1,
"filename": "honeybee_energy-1.116.52.tar.gz",
"has_sig": false,
"md5_digest": "2692bddd66afb26bd707a77a75f92b09",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 423835,
"upload_time": "2025-07-11T22:40:06",
"upload_time_iso_8601": "2025-07-11T22:40:06.408054Z",
"url": "https://files.pythonhosted.org/packages/58/32/86b3af1e40eeff522ac680ec9d74aff14d9bb1b395f6ea6de4c363d34c73/honeybee_energy-1.116.52.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-11 22:40:06",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ladybug-tools",
"github_project": "honeybee-energy",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "honeybee-core",
"specs": [
[
"==",
"1.61.30"
]
]
},
{
"name": "honeybee-standards",
"specs": [
[
"==",
"2.0.7"
]
]
}
],
"lcname": "honeybee-energy"
}