Skip to content

Commit 05c9949

Browse files
spec: add psychrometric-basic specification (#4606)
## New Specification: `psychrometric-basic` Related to #4583 --- ### specification.md # psychrometric-basic: Psychrometric Chart for HVAC ## Description A psychrometric chart plots dry-bulb temperature against humidity ratio, overlaid with curves for relative humidity, wet-bulb temperature, enthalpy, and specific volume. It is the fundamental tool for HVAC system design and air conditioning process analysis. The chart reveals the thermodynamic properties of moist air at a glance, enabling engineers to trace heating, cooling, humidification, and dehumidification processes as paths on the diagram. ## Applications - HVAC engineering: designing and analyzing air conditioning systems by tracing process paths (heating, cooling, mixing) on the chart - Building science: evaluating indoor thermal comfort zones and identifying condensation risks - Industrial process engineering: optimizing drying operations and clean room environmental control ## Data - `dry_bulb_temp` (float) - Dry-bulb air temperature in degrees Celsius, x-axis primary variable - `humidity_ratio` (float) - Mass of water vapor per mass of dry air in g/kg, y-axis primary variable - `relative_humidity` (float[]) - Constant relative humidity curves from 10% to 100% in 10% increments - `wet_bulb_temp` (float[]) - Diagonal lines of constant wet-bulb temperature - `enthalpy` (float[]) - Oblique lines of constant enthalpy in kJ/kg - `specific_volume` (float[]) - Lines of constant specific volume in m3/kg - Size: derived from psychrometric equations over a dry-bulb range of -10 to 50 degrees Celsius - Example: standard atmosphere (101.325 kPa) psychrometric properties computed from ASHRAE formulas ## Notes - The saturation curve (100% RH) forms the upper boundary of the chart and should be visually prominent - Relative humidity curves (10%-100%) should be drawn as smooth curves between the saturation line and x-axis - Wet-bulb and enthalpy lines run diagonally from upper-left to lower-right - Specific volume lines run at a slightly different diagonal angle - Include at least one example HVAC process path (e.g., cooling and dehumidification) shown as an arrow or highlighted line segment between two state points - A comfort zone region (approximately 20-26 C, 30-60% RH) should be highlighted as a shaded rectangle or polygon - All property lines should be labeled directly on the chart, not just in a legend - Use standard sea-level atmospheric pressure (101.325 kPa) for calculations --- **Next:** Add `approved` label to the issue to merge this PR. --- :robot: *[spec-create workflow](https://github.com/MarkusNeusinger/pyplots/actions/runs/22779536724)* Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
1 parent 79283f1 commit 05c9949

2 files changed

Lines changed: 61 additions & 0 deletions

File tree

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
# psychrometric-basic: Psychrometric Chart for HVAC
2+
3+
## Description
4+
5+
A psychrometric chart plots dry-bulb temperature against humidity ratio, overlaid with curves for relative humidity, wet-bulb temperature, enthalpy, and specific volume. It is the fundamental tool for HVAC system design and air conditioning process analysis. The chart reveals the thermodynamic properties of moist air at a glance, enabling engineers to trace heating, cooling, humidification, and dehumidification processes as paths on the diagram.
6+
7+
## Applications
8+
9+
- HVAC engineering: designing and analyzing air conditioning systems by tracing process paths (heating, cooling, mixing) on the chart
10+
- Building science: evaluating indoor thermal comfort zones and identifying condensation risks
11+
- Industrial process engineering: optimizing drying operations and clean room environmental control
12+
13+
## Data
14+
15+
- `dry_bulb_temp` (float) - Dry-bulb air temperature in degrees Celsius, x-axis primary variable
16+
- `humidity_ratio` (float) - Mass of water vapor per mass of dry air in g/kg, y-axis primary variable
17+
- `relative_humidity` (float[]) - Constant relative humidity curves from 10% to 100% in 10% increments
18+
- `wet_bulb_temp` (float[]) - Diagonal lines of constant wet-bulb temperature
19+
- `enthalpy` (float[]) - Oblique lines of constant enthalpy in kJ/kg
20+
- `specific_volume` (float[]) - Lines of constant specific volume in m3/kg
21+
- Size: derived from psychrometric equations over a dry-bulb range of -10 to 50 degrees Celsius
22+
- Example: standard atmosphere (101.325 kPa) psychrometric properties computed from ASHRAE formulas
23+
24+
## Notes
25+
26+
- The saturation curve (100% RH) forms the upper boundary of the chart and should be visually prominent
27+
- Relative humidity curves (10%-100%) should be drawn as smooth curves between the saturation line and x-axis
28+
- Wet-bulb and enthalpy lines run diagonally from upper-left to lower-right
29+
- Specific volume lines run at a slightly different diagonal angle
30+
- Include at least one example HVAC process path (e.g., cooling and dehumidification) shown as an arrow or highlighted line segment between two state points
31+
- A comfort zone region (approximately 20-26 C, 30-60% RH) should be highlighted as a shaded rectangle or polygon
32+
- All property lines should be labeled directly on the chart, not just in a legend
33+
- Use standard sea-level atmospheric pressure (101.325 kPa) for calculations
Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
# Specification-level metadata for psychrometric-basic
2+
# Auto-synced to PostgreSQL on push to main
3+
4+
spec_id: psychrometric-basic
5+
title: Psychrometric Chart for HVAC
6+
7+
# Specification tracking
8+
created: "2026-03-06T19:54:00Z"
9+
updated: null
10+
issue: 4583
11+
suggested: MarkusNeusinger
12+
13+
# Classification tags (applies to all library implementations)
14+
# See docs/reference/tagging-system.md for detailed guidelines
15+
tags:
16+
plot_type:
17+
- line
18+
- contour
19+
data_type:
20+
- numeric
21+
- continuous
22+
domain:
23+
- engineering
24+
- energy
25+
features:
26+
- advanced
27+
- annotated
28+
- multi

0 commit comments

Comments
 (0)