-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
36 additions
and
8 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -3,27 +3,55 @@ | |
|
||
Honeybee-REVIVE is a free plugin for [Ladybug Tools](https://www.ladybug.tools/) which enables users to add detailed [Phius-REVIVE](https://www.phius.org/phius-revive-2024) style attributes to their models alongside the normal Honeybee inputs. | ||
|
||
This plugin is designed as a plugin for Honeybee v1.8. It can also be utilized by the Ladybug toolkit for building up models within [Rhino 3D v8+](https://www.rhino3d.com/) and Grasshopper using the [honeybee_grasshopper_revive](https://github.com/PH-Tools/honeybee_grasshopper_REVIVE) tools. This extension relies on the [PH-ADORB](https://github.com/PH-Tools/PH_ADORB) calculation library to execute the actual carbon-cost values. | ||
This plugin is designed as a plugin for Honeybee v1.8. It can also be utilized by the Ladybug toolkit for building up models within [Rhino 3D v8+](https://www.rhino3d.com/) and Grasshopper using the [honeybee_grasshopper_revive](https://github.com/PH-Tools/honeybee_grasshopper_REVIVE) tools. This extension relies on the [PH-ADORB](https://github.com/PH-Tools/PH_ADORB) library to execute the actual carbon-cost calculations. | ||
|
||
|
||
## Note: | ||
*PH-Tools and the Honeybee-REVIVE plugin is in no way affiliated with Phius, and the library here is neither reviewed, nor approved by Phius for use in complying with the REVIVE program.* | ||
#### *Note: PH-Tools and this PH-ADORB library is in no way affiliated with Phius, and the library here is neither reviewed, nor approved by Phius for use in complying with the REVIVE program.* | ||
|
||
## Packages: | ||
# Packages Included: | ||
- **honeybee_revive:** Extend the basic Honeybee extension package with new Phius-REVIVE specific model elements. | ||
|
||
- **honeybee_energy_revive:** Extend the Honeybee-Energy package with new Phius-REVIVE style attributes for elements such as windows, hvac and construction assemblies. | ||
|
||
- **honeybee_revive_standards:** Helpful new standards for programs and assemblies which are especially relevant to Passive House practitioners. | ||
|
||
|
||
## More Information: | ||
# Installation: | ||
This package is [hosted on PyPi](https://pypi.org/project/honeybee-REVIVE/). To install the latests version of the package: | ||
|
||
```python | ||
>>> pip install honeybee-revive | ||
``` | ||
|
||
# Development: | ||
|
||
### Development [Local]: | ||
PH-ADORB is free and open-source. We welcome any and all thoughts, opinions, and contributions! To get setup for local development: | ||
1. **Fork** this GitHub repository to your own GitHub account. | ||
1. **Clone** the repository-fork onto your computer. | ||
1. Setup a **virtual environment**. | ||
1. Install the required **dependencies**. | ||
1. Make your edits or changes. | ||
1. Add tests to cover your changes. | ||
1. Submit a **Pull-Request** to merge your changes into the main branch. | ||
|
||
### Development [Tests]: | ||
Note that Honeybee-REVIVE uses [`pytest`](https://docs.pytest.org/en/stable/#) to run all of the automated testing. Please be sure to include tests for any contributions or edits. | ||
|
||
### Development [Deployment]: | ||
This package is [published on PyPi](https://pypi.org/project/honeybee-REVIVE/). To deploy a new version: | ||
1. Update the [pyproject.toml version number](https://github.com/PH-Tools/honeybee_REVIVE/blob/04039ea13f699cd81a76f036c44af628b9dba946/pyproject.toml#L3) | ||
1. Publish a new release through the GitHub repository page: | ||
![Screenshot 2024-09-26 at 10 05 14 AM](https://github.com/user-attachments/assets/8e831f39-03ee-4704-8a78-f3353960b3ea) | ||
1. This is will trigger the [ci.yaml](https://github.com/PH-Tools/honeybee_REVIVE/blob/main/.github/workflows/ci.yaml) GitHub Action, build, and deploy the package. | ||
|
||
|
||
# More Information: | ||
For more information on the use of these tools, check out the the Passive House Tools website: | ||
[https://www.PassiveHouseTools.com](https://www.PassiveHouseTools.com) | ||
|
||
|
||
## Contact: | ||
For questions about Honeybee-REVIVE, feel free to reach out at: [email protected] | ||
### Contact: | ||
For questions about Honeybee-REVIVE, feel free to reach out at: [email protected] | ||
|
||
You can also post questions or comment to the Ladybug-Tools use forum at: [https://discourse.ladybug.tools/](https://discourse.ladybug.tools/) | ||
|
||
|