Welcome to HVACLogic: Open Engineering Roadmap, Architecture & Contributor Call

[miadsaadidi]

Welcome to the official discussions space for HVACLogic!

HVACLogic was created to bridge the gap between empirical HVAC "rules of thumb" and deterministic thermodynamic physics. We develop open-access, zero-telemetry calculation tools powered by pure client-side TypeScript engines to support mechanical engineers, field technicians, researchers, and CTE/higher-ed students.

---

Architecture & Current Baseline

All solvers in this repository adhere to three strict architectural constraints:

1. 100% Client-Side Computation: All mathematical solvers execute entirely in the browser runtime. Zero user inputs, design calculations, or airflow dimensions are sent to a remote database.
2. Deterministic Physics over Empirical Approximations: Where industry tools rely on static tabular approximations, our algorithms implement fundamental governing equations (Darcy-Weisbach with Colebrook-White Newton-Raphson iteration, Hyland-Wexler psychrometric formulations, and NIST REFPROP-aligned refrigerant curves).
3. Open Educational Access: All formulas, source code, and worked numerical examples are transparently documented and indexed for curriculum integration.

Currently, 21 specialized engineering calculators and an Engineering Guides Hub are operational in production:

• 🌐 Platform Homepage: https://hvaclogic.org
• 📚 Engineering Guides Hub: https://hvaclogic.org/guides
• 💨 Digital Ductulator & Sizer: https://hvaclogic.org/calculators/ductulator
• ❄️ Zeotropic Low-GWP PT Chart: https://hvaclogic.org/calculators/pt-chart
• 🔥 Heat Pump Balance Point Sizer: https://hvaclogic.org/calculators/heat-pump-size-calculator
• 🏠 Whole-Home Heat Loss Engine: https://hvaclogic.org/calculators/heat-loss-calculator

---

Active Engineering Roadmap

We are actively developing and refining the following technical areas:

1. Low-GWP A2L Refrigerant Expansion
   • Incorporating expanded thermodynamic property matrices and temperature glide correction for R-454B, R-32, and emerging low-GWP refrigerants under AHRI 210/240 standards.
2. Hydronic Distribution & Viscosity Modeling
   • Expanding hydronic pipe sizing engines to account for temperature-dependent kinematic viscosity in propylene and ethylene glycol mixtures under closed-loop operating pressures.
3. Multi-Stage Psychrometric Process Chaining
   • Developing state-point chaining tools to model complete air handling processes (sensible cooling, latent dehumidification, reheat, and adiabatic mixing) along real-time psychrometric charts.
4. Empirical Standard Benchmarking
   • Continually benchmarking solver outputs against ACCA Manuals J/S/D, ASHRAE Fundamentals, and SMACNA Duct Construction Standards.

---

How You Can Contribute & Participate

This Discussions category is dedicated to technical exchange, peer review, and community feedback:

• Mathematical Peer Review: If you spot an edge case or potential refinement in any equation located in src/lib/math/, open a discussion topic or pull request.
• Field Anomaly Reports: Have field measurements that diverge from theoretical calculations? Share your setup, flow rates, and static pressure readings so we can investigate boundary condition anomalies.
• Curriculum & Tool Requests: If you are a trade instructor, professor, or technical director, let us know which sizing tools or visualizers would best serve your students and apprentices.

Thank you for being part of the HVACLogic open-source community!

• Miad S. and the HVACLogic Project