# PH-ADORB (WIP):
#### *NOTE: This package is for research and testing purposes only.*
### A Python Package for calculating building 'ADORB' costs:
> A.D.O.R.B. cost: Annualized De-carbonization Of Retrofitted Buildings cost - a “full-cost-accounted”
annualized life-cycle cost metric for building projects. It includes the (annualized) direct costs of
retrofit and maintenance, direct energy costs, a carbon cost for both operating and embodied/upfront
greenhouse gas emissions, and a renewable-energy system-transition cost based on the required
electrical service capacity.
[[Phius Revive 2024 Retrofit Standard for Buildings v24.1.00]](https://www.phius.org/phius-revive-2024-standard-document)
- - -
The **ADORB** cost is used as part of the [Phius-REVIVE](https://www.phius.org/phius-revive-2024) building retrofit program. The [Phius Research Committee](https://github.com/Phius-ResearchComittee) has an example implementation of the **ADORB** calculation which can be found on the [Phius GitHub repository](https://github.com/Phius-ResearchComittee/REVIVE/tree/main/REVIVE2024).
This new PH-ADORB library is an adaptation of Phius's original code into an object-oriented version. This library is a work-in-progress and should NOT be used for any actual Phius compliance analysis or reporting.
#### *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.*
<details>
<summary><strong>Installation</strong></summary>
This package is [hosted on PyPi](https://pypi.org/project/PH-ADORB/). To install the latests version of the package:
```python
>>> pip install ph-adorb
```
</details>
<details>
<summary><strong>Development</strong></summary>
### 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 new repository-fork onto your own computer.
![Screenshot 2024-10-01 at 3 48 51 PM](https://github.com/user-attachments/assets/6b7e0853-4b90-4b05-9344-8ced9ff04de9)
1. Setup a **virtual environment** on your own computer.
1. Install the required **dependencies**: `>>> pip install '.[dev]'`
1. *Recommended* Create a new **Branch** for all your changes.
1. Make the changes to the code.
1. Add tests to cover your new changes.
1. Submit a **Pull-Request** to merge your new Branch and its changes into the main branch.
### Development [Tests]:
Note that PH-ADORB 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/PH-ADORB/). To deploy a new version:
1. Update the [pyproject.toml version number](https://github.com/PH-Tools/PH_ADORB/blob/f3bbed034b91088bd240a36227ffb841afd51859/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/PH_ADORB/blob/main/.github/workflows/ci.yaml) GitHub Action, build, and deploy the package.
</details>
<details>
<summary><strong>More Information</strong></summary>
For more information on the use of these tools, check out the the [Passive House Tools website](https://www.PassiveHouseTools.com).
### Contact:
For questions about PH-ADORB or any of the Passive House Tools, feel free to reach out to us at: PHTools@bldgtyp.com
</details>
![Tests](https://github.com/PH-Tools/ph_adorb/actions/workflows/ci.yaml/badge.svg)
Raw data
{
"_id": null,
"home_page": null,
"name": "PH-ADORB",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "Ed May <phtools@bldgtyp.com>",
"keywords": "Honeybee, Honeybee-Energy, Passive House, Building Retrofit, Architecture, Energy Modeling, PHIUS, ADORB, Carbon Emissions, Embodied Carbon, Embodied CO2",
"author": null,
"author_email": "Ed May <phtools@bldgtyp.com>",
"download_url": "https://files.pythonhosted.org/packages/24/a6/0e290f33df1f5569560364ec51c852c90e410fe8714036b2898eb747b725/ph_adorb-0.0.7.tar.gz",
"platform": null,
"description": "# PH-ADORB (WIP):\n#### *NOTE: This package is for research and testing purposes only.*\n### A Python Package for calculating building 'ADORB' costs:\n\n\n> A.D.O.R.B. cost: Annualized De-carbonization Of Retrofitted Buildings cost - a \u201cfull-cost-accounted\u201d \nannualized life-cycle cost metric for building projects. It includes the (annualized) direct costs of \nretrofit and maintenance, direct energy costs, a carbon cost for both operating and embodied/upfront \ngreenhouse gas emissions, and a renewable-energy system-transition cost based on the required \nelectrical service capacity.\n[[Phius Revive 2024 Retrofit Standard for Buildings v24.1.00]](https://www.phius.org/phius-revive-2024-standard-document)\n\n- - - \nThe **ADORB** cost is used as part of the [Phius-REVIVE](https://www.phius.org/phius-revive-2024) building retrofit program. The [Phius Research Committee](https://github.com/Phius-ResearchComittee) has an example implementation of the **ADORB** calculation which can be found on the [Phius GitHub repository](https://github.com/Phius-ResearchComittee/REVIVE/tree/main/REVIVE2024).\n\n\nThis new PH-ADORB library is an adaptation of Phius's original code into an object-oriented version. This library is a work-in-progress and should NOT be used for any actual Phius compliance analysis or reporting. \n\n#### *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.*\n\n\n<details>\n<summary><strong>Installation</strong></summary>\n\nThis package is [hosted on PyPi](https://pypi.org/project/PH-ADORB/). To install the latests version of the package:\n\n```python\n>>> pip install ph-adorb\n```\n</details>\n\n<details>\n<summary><strong>Development</strong></summary>\n\n### Development [Local]:\nPH-ADORB is free and open-source. We welcome any and all thoughts, opinions, and contributions! To get setup for local development:\n1. **Fork** this GitHub repository to your own GitHub account.\n1. **Clone** the new repository-fork onto your own computer.\n![Screenshot 2024-10-01 at 3 48 51\u202fPM](https://github.com/user-attachments/assets/6b7e0853-4b90-4b05-9344-8ced9ff04de9)\n1. Setup a **virtual environment** on your own computer.\n1. Install the required **dependencies**: `>>> pip install '.[dev]'`\n1. *Recommended* Create a new **Branch** for all your changes.\n1. Make the changes to the code.\n1. Add tests to cover your new changes.\n1. Submit a **Pull-Request** to merge your new Branch and its changes into the main branch.\n\n### Development [Tests]:\nNote that PH-ADORB 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.\n\n### Development [Deployment]:\nThis package is [published on PyPi](https://pypi.org/project/PH-ADORB/). To deploy a new version:\n1. Update the [pyproject.toml version number](https://github.com/PH-Tools/PH_ADORB/blob/f3bbed034b91088bd240a36227ffb841afd51859/pyproject.toml#L3)\n1. Publish a new release through the GitHub repository page:\n![Screenshot 2024-09-26 at 10 05 14\u202fAM](https://github.com/user-attachments/assets/8e831f39-03ee-4704-8a78-f3353960b3ea)\n1. This is will trigger the [ci.yaml](https://github.com/PH-Tools/PH_ADORB/blob/main/.github/workflows/ci.yaml) GitHub Action, build, and deploy the package.\n</details>\n\n\n<details>\n<summary><strong>More Information</strong></summary>\n\nFor more information on the use of these tools, check out the the [Passive House Tools website](https://www.PassiveHouseTools.com).\n\n### Contact:\nFor questions about PH-ADORB or any of the Passive House Tools, feel free to reach out to us at: PHTools@bldgtyp.com\n</details>\n\n\n![Tests](https://github.com/PH-Tools/ph_adorb/actions/workflows/ci.yaml/badge.svg)\n",
"bugtrack_url": null,
"license": "GNU",
"summary": "Calculate the ADORB cost for a Passive House building.",
"version": "0.0.7",
"project_urls": {
"homepage": "https://www.passivehousetools.com/",
"repository": "https://github.com/PH-Tools/PH_ADORB/tree/main"
},
"split_keywords": [
"honeybee",
" honeybee-energy",
" passive house",
" building retrofit",
" architecture",
" energy modeling",
" phius",
" adorb",
" carbon emissions",
" embodied carbon",
" embodied co2"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3207bf88d7cd3c59d38fabd42d6afc3539f103111853df04afa0696e48a54691",
"md5": "0e8c8b457f6f220669f5417cc6066f4b",
"sha256": "34af703d9788607f63518a207ffd37cbd6e86c128a88b8ce8759352563940154"
},
"downloads": -1,
"filename": "PH_ADORB-0.0.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0e8c8b457f6f220669f5417cc6066f4b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 28339,
"upload_time": "2024-11-16T23:51:14",
"upload_time_iso_8601": "2024-11-16T23:51:14.202044Z",
"url": "https://files.pythonhosted.org/packages/32/07/bf88d7cd3c59d38fabd42d6afc3539f103111853df04afa0696e48a54691/PH_ADORB-0.0.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "24a60e290f33df1f5569560364ec51c852c90e410fe8714036b2898eb747b725",
"md5": "a7ddd648c3a34b62a91203fe68b3794f",
"sha256": "df153b148936a9ba0e507d0a0c759684d0b05af5d80e554d5981eddb0026e6cc"
},
"downloads": -1,
"filename": "ph_adorb-0.0.7.tar.gz",
"has_sig": false,
"md5_digest": "a7ddd648c3a34b62a91203fe68b3794f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 21739,
"upload_time": "2024-11-16T23:51:16",
"upload_time_iso_8601": "2024-11-16T23:51:16.000908Z",
"url": "https://files.pythonhosted.org/packages/24/a6/0e290f33df1f5569560364ec51c852c90e410fe8714036b2898eb747b725/ph_adorb-0.0.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-16 23:51:16",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "PH-Tools",
"github_project": "PH_ADORB",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "ph-adorb"
}