LIBRARY

HVACComponents

A Dyad-native component library for HVAC vapor compression cycles integrated with fast and accurate spline-based refrigerant and moist-air property models. Seamless environment for steady-state or transient analyses from a single model definition, coupling with DyadModelOptimizer for calibration to data, DyadModelDiscovery and DyadSurrogates for scientific machine learning workflows, DyadControlSystems for linear analysis, PID or Model-Predictive Control, or DyadFMUGeneration for interoperatibility with Functional Mockup Units.

Features

Pre-built components

Drop-in components covering the full vapor-compression stack:

• Heat exchangers — Tube-fin, plate, and crossflow heat exchangers with refrigerant-side discretisation and moist-air sides supporting condensation.

• Compressors — positive-displacement compressor with map-driven volumetric efficiency and electrical power.

• Valves — linear electronic expansion valves (LEV) with smooth, differentiable opening curves.

• Fans — air-side momentum sources for forced-convection circuits.

• Conditioned spaces — lumped thermal-mass / humidity volumes for closing the air loop on a building or cabin model.

• Pipes — distributed-volume straight pipes with staggered-grid momentum balance for two-phase refrigerant transport.

Thermodynamic property models

Property-evaluation backends pluggable into any component through the medium_data parameter:

• Refrigerants — spline-based property models for R32, R1234YF, R290, R152a, R134a, R410A, R717.

• Air — dry-air and moist-air properties

• Generic media — abstract refrigerant / dry-air / moist-air medium types let you bring your own property backend.

Getting started

• Steady-state and dynamic simulation with one model — a complete vapor-compression cycle (compressor + condenser + LEV + evaporator) wired up in Dyad, then run both as a transient with Rodas5P and as a steady-state solve — from the same component definition.

API reference

The remainder of this site is automatically generated from .dyad docstrings and is organised into the navigation sidebar:

• Types — abstract medium types, partial base classes, and enumerated configuration types.

• Connectors — FluidPort, MoistAirFluidPort, TwoComponentFluidPort.

• Components — every concrete component shipped with the library.

Types

• Components.Partial.PartialDistributedFlow — Partial base class for a steady-state distributed momentum balance over m cells.

• Components.Partial.PartialDistributedVolume — Partial base class for an N-cell 1-D distributed-volume refrigerant model.

• Components.Partial.PartialHEXCrossflow — Partial base class for a moist-air cross-flow heat-exchanger element.

• Components.Partial.PartialStraightPipe — Partial base class for a 1-D staggered-grid straight-pipe refrigerant model.

• FiniteVolumeInitializationMode

• FlowModelMode

• HeatTransfer.PartialTwoPhaseHeatTransfer — Partial base class for an N-cell two-phase convective heat-transfer model.

• MediaModels.AbstractDryAirMedium

• MediaModels.AbstractMoistAirMedium

• MediaModels.AbstractRefrigerantMedium

• ModelStructure

• ph_Distribution

Connectors

• FluidPort

• MoistAirFluidPort

• TwoComponentFluidPort

Components

• Components.AirSplitterMerger — Symmetric n-way splitter/merger for a moist-air MoistAirFluidPort.

• Components.Compressor — Positive-displacement compressor with no mass or energy storage.

• Components.LEV — Linear Electronic Expansion Valve (LEV).

• Components.OneTempWall1D — Discretised one-temperature wall for tube-fin heat exchangers.

• Components.Partial.HEXCrossflow — Moist-air cross-flow heat exchanger element with condensation.

• Components.Partial.SimpleStaggeredFlowModel — Staggered-grid momentum flow model used inside the StraightPipe family.

• Components.RefrigerantSplitterMerger — Symmetric n-way splitter/merger for a single-phase refrigerant FluidPort.

• Components.Sources.Boundary_pTPhi — Moist-air boundary condition fixing pressure, temperature, and relative humidity.

• Components.Sources.Boundary_ph — Refrigerant boundary fixing pressure and specific enthalpy.

• Components.Sources.MassFlowSource_TPhi — Moist-air mass flow source with prescribed temperature and relative humidity.

• Components.Sources.MassFlowSource_h — Refrigerant mass flow source with prescribed specific enthalpy.

• Components.Sources.PrescribedTemperature — Constant-temperature boundary for an array of HeatPorts.

• Components.StraightPipe — Distributed-volume straight pipe with circular cross-section.

• Components.TubeFinHEX — Tube-fin heat exchanger with refrigerant side and moist-air side.

• HeatTransfer.ConstantPhasic — Phase-resolved heat-transfer model with constant coefficients per regime.

• MediaModels.BaseProperties_DryAir — Dry-air property model using (p, T) as independent states.

• MediaModels.BaseProperties_MoistAir — Moist-air (dry air + water vapor) property model using (p, T, Xi) as states.

• MediaModels.BaseProperties_Refrigerant — Refrigerant property model using (p, h) as independent states.

• MediaModels.ThermodynamicState_pT — Thermodynamic-state record parametrised by (p, T) for ideal-gas media (dry air).

• MediaModels.ThermodynamicState_pTXi — Thermodynamic-state record parametrised by (p, T, Xi) for moist-air media.

• MediaModels.ThermodynamicState_ph — Thermodynamic-state record parametrised by (p, h) for refrigerant media.