Changelog
Changelog
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
[0.4.0] — 2026-03-08
Added
Equipment Sizing Module (
hvacpy.equipment) — ASHRAE HSE 2020SplitSystem— residential and light-commercial split system sizingPackagedRTU— packaged rooftop unit with economiser and gas heat optionsFanCoilUnit— fan coil unit with chilled water flow rate calculationChiller— air-cooled and water-cooled chiller with N+1 redundancyAirSourceHeatPump— dual-mode sizing with COP correction curves and supplemental heatDuctSizer— three methods: equal friction, velocity reduction, static regain (ASHRAE HOF 2021 Ch.21)VentilationCheck— ASHRAE 62.1-2022 Table 6-1 single-zone compliance checksupply_airflow_cooling,supply_airflow_heating,airflow_from_cooling_loadpure functionssize_cooling_equipment,size_heat_pumpconvenience functionsEquipmentSizingError,AirflowCalculationError,DuctSizingErrorexceptions65 new tests (185 total), 92% coverage on equipment module
Changed
scipy(already a dependency) is now actively used in_duct.pyfor Colebrook-White and static regain root-finding
[0.3.0] — 2026-03-02
Added
Heat Load Calculations — ASHRAE CLTD/CLF cooling load method (1997 HOF Ch.28)
Heating Loads — ASHRAE steady-state heat loss method (2021 HOF Ch.18)
CoolingLoad— 24-hour peak cooling load with component breakdownHeatingLoad— steady-state heating for equipment sizingRoomandZonedataclasses for space modellingWallComponent,WindowComponent,InternalGaindata containersOrientationenum (N, NE, E, SE, S, SW, W, NW, Horizontal)CLTD Group D lookup table (24h × 9 orientations) with group multipliers A–G
CLF solar gain table with linear interpolation
Design conditions database for 10 cities worldwide
LoadCalculationErrorandDesignConditionsNotFoundErrorexceptionsscipy>=1.10dependency (for future infiltration crack method)56 new tests (120 total), 97% coverage on loads module
[0.2.0] — 2026-03-01
Added
Psychrometrics Module — ASHRAE HOF 2021 moist air calculations
AirState— compute all psychrometric properties from any two known valuesAirProcess— model mixing, heating, cooling, humidification processesPsychChart— matplotlib psychrometric chart plottingConvenience functions:
dry_bulb_from_wet_bulb,humidity_ratio_from_rh,dew_point_from_humidity_ratio
[0.1.0] — 2026-02-28
Added
Assembly Module — layered building envelope U-value/R-value calculations
Materials Database — 15+ common construction materials with thermal properties
Assemblyclass withadd_layer(),u_value,r_value,breakdown()MaterialandMaterialsDBclassesUnit system (
Q_,ureg) powered by pint64 unit tests