Skip to main content

PHX (Passive House Exchange):

The Passive House Exchange (PHX) package enables users to move building model data into and out of the Passive House energy modeling software platforms (PHPP or WUFI-Passive).

PHX converts live Honeybee models carrying honeybee-ph data into 'PH-Style' objects and then manages data input to proprietary PH calculators such as PHPP and WUFI-Passive. File-oriented workflows may first read a HBJSON file into that Honeybee model.

PHX itself does not have serialization / deserialization, and is not intended to be stored or written directly: it is an in-memory-only model which is created as a middle-step when moving the building data from the source (usually a HBJSON file) to the destination (PHPP, WUFI-Passive).

This library is designed to be used as part of the Honeybee-PH plugin workflow, or other similar tools which require interfacing with the Passive House modeling platforms.

from PHX.conversion import from_honeybee

phx_project = from_honeybee(hb_model)
Screen Shot 2023-10-28 at 11 53 01 AM

Packages:

  • conversion: Public live Honeybee / honeybee-ph Model → transient PhxProject API.

  • from_HBJSON: Honeybee conversion implementation and HBJSON file-reading helpers retained for existing workflows.

  • from_WUFI_XML: Modules used to create a new PHX model from an existing WUFI-Passive XML file.

  • from_PHPP: Modules used to create a new PHX model from an existing PHPP file.'

  • model: The PHX model classes and structures. These objects are designed to be built by one of the 'from_*' libraries above.

  • to_PHPP: Libraries to allow for the export of PHX data to a PHPP Microsoft Excel spreadsheet.

  • to_WUFI_XML: Libraries to allow for the export of a WUFI-Passive XML file with all of the PHX model data. This XML file can then be opened from within the WUFI-Passive application.

  • to_PPP / to_METr_JSON: Additional exporters for the PPP and METr-JSON target formats.

Development:

  • Python: 3.10+ (CPython). Runs as a library/CLI, not inside Rhino (except the PHX/run.py Grasshopper shim).
  • Tests: python -m pytest tests/.
  • Commits: conventional commits (feat(scope): / fix(scope):) drive semantic-release auto-publishing to PyPI.
  • Agent/contributor orientation: CLAUDE.md, the context/ folder, and the deep architecture docs under docs/dev/ and docs/reference/.

More Information:

For more information on the use of these tools, check out the the Passive House Tools website: https://passivehousetools.com/

Tests versions

Metadata

Release files for PHX 1.57.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for PHX 1.57.2
File Size Uploaded Provenance
phx-1.57.2.tar.gz 387.9 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for PHX 1.57.2
File Interpreter ABI Platform
phx-1.57.2-py3-none-any.whl Python 3 none any Details

Total release size: 858.3 kB

Release files / phx-1.57.2.tar.gz

Download URL phx-1.57.2.tar.gz
Size 387.9 kB
Tags Source
SHA-256 checksum
How to use checksums
db8e08bdf3cb52867eb9574e66b34a233d234c3d863b04ec2e24a598289b45c5
BLAKE2b-256 checksum
How to use checksums
4f67f8f9db973b2ef2f7ec19076de9e36afacbc6f15ca02d6aa231578af3f89d
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 log

Release files / phx-1.57.2-py3-none-any.whl

Download URL phx-1.57.2-py3-none-any.whl
Size 470.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ac4f73a3b31411695a604177682658bc25bd57bb3df188a96cef8917102497e6
BLAKE2b-256 checksum
How to use checksums
82d47153e105a6bd1de98b9e5d2c4f1209e48c02aa41081473593b7ae150921f
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 log

Security for PHX 1.57.2

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.

Select from 2 files

Attestation for phx-1.57.2.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 log

A 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.

Release history Release notifications | RSS feed

This release

1.57.2 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page