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]
The ADORB cost is used as part of the Phius-REVIVE building retrofit program. The Phius Research Committee has an example implementation of the ADORB calculation which can be found on the Phius GitHub repository.
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.
Installation
This package is hosted on PyPi. To install the latests version of the package:
>>> pip install ph-adorb
Development
Development [Orientation]:
For contributor/agent orientation, see CLAUDE.md and the context/ folder. PH-ADORB is a CPython numeric library (pandas/plotly) — it is not IronPython and is called from Grasshopper via subprocess. Correctness is anchored to the Phius reference method in _reference/.
Development [Local]:
PH-ADORB is free and open-source. We welcome any and all thoughts, opinions, and contributions! To get setup for local development:
- Fork this GitHub repository to your own GitHub account.
- Clone the new repository-fork onto your own computer.
- Setup a virtual environment on your own computer.
- Install the required dependencies:
>>> pip install '.[dev]' - Recommended Create a new Branch for all your changes.
- Make the changes to the code.
- Add tests to cover your new changes.
- Submit a Pull-Request to merge your new Branch and its changes into the main branch.
Development [Tests]:
Note that PH-ADORB uses pytest 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. To deploy a new version:
- Update the pyproject.toml version number
- Publish a new release through the GitHub repository page:
- This is will trigger the 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.
Contact:
For questions about PH-ADORB or any of the Passive House Tools, feel free to reach out to us at: PHTools@bldgtyp.com
1 maintainer
Metadata
1 maintainer
Release files for PH-ADORB 0.0.13
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| ph_adorb-0.0.13.tar.gz | 31.7 kB | With provenance | Details for ph_adorb-0.0.13.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| ph_adorb-0.0.13-py3-none-any.whl | Python 3 | none | any | Details for ph_adorb-0.0.13-py3-none-any.whl |
Total release size: 64.8 kB
Release files / ph_adorb-0.0.13.tar.gz
| Download URL | ph_adorb-0.0.13.tar.gz |
|---|---|
| Size | 31.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7d6c287297e4d251d5590bd5d248cfabc04b0543edfa8813758c63555e3453bf
|
|
BLAKE2b-256 checksum How to use checksums |
cee09fe51f787762d7516e89ce264a62bce01ec6d96e66dac3ec3f2adf29cdb2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.
Transparency logRelease files / ph_adorb-0.0.13-py3-none-any.whl
| Download URL | ph_adorb-0.0.13-py3-none-any.whl |
|---|---|
| Size | 33.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d82bbb277d520742181bf378726e057cbe9433ac06e51166653cd5452c035783
|
|
BLAKE2b-256 checksum How to use checksums |
fad9c403d318870b68dcf06451058a1e30778b133b872afad72f14804e727f57
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.
Transparency logSecurity for PH-ADORB 0.0.13
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for ph_adorb-0.0.13.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
