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

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.3
File Size Uploaded Provenance
phx-1.57.3.tar.gz 388.1 kB With provenance Details

Built distribution (wheel)

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

Total release size: 858.5 kB

Release files / phx-1.57.3.tar.gz

Download URL phx-1.57.3.tar.gz
Size 388.1 kB
Tags Source
SHA-256 checksum
How to use checksums
44928b3b16c27db6571ac79e8a08c2dffe5825581a234a5ccd6066c5bb24f3f5
BLAKE2b-256 checksum
How to use checksums
fb0ae4b9869651e1d09c02391b4292ee1cb34d1e9108d10345c417df5e0700cb
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.3-py3-none-any.whl

Download URL phx-1.57.3-py3-none-any.whl
Size 470.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
49b3cb4f8636ccbc38764126da23da09d17baeaad8ab0f5974c7d345e8ec39b6
BLAKE2b-256 checksum
How to use checksums
94899ed105ba3d83f439db38e9677621714257d415e8731edd0f164d1689ef0c
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.3

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