Component List for water side HVAC system definition

Pump

Component to define pump equipment for water circuits.

This equipment can be used for one or more HVAC systems.

Parameters

All mathematical expressions can include the following independent variable.

Example:


...

pump = osm.components.Pump("pump", project)
param = {
        "nominal_water_flow": 0.002,
        "nominal_pressure": 30000,
        "nominal_power": 100
}
pump.set_parameters(param)

Chiller_heat_pump

Component to define chiller and/or heat pump water equipment for cooling and/or heating.

This equipment can be used for one or more HVAC systems.

Parameters

All mathematical expressions can include the following independent variables.

cooling_power_expression, EER_expression, heating_power_exporession and COP_expression may also include the variable F_load, which represents the partial load state of the equipment, calculated as the thermal capacity supplied at a given instant divided by the full load capacity at the current operation conditions.

Example:


...

chiller = osm.components.Chiller_heat_pump("chiller", project)
param = {
        "chiller_type": "CHILLER",
        "condensation_type": "AIR_CONDENSED",
        "nominal_water_flow": 0.003,
        "nominal_cooling_capacity": 63000,
        "nominal_cooling_power": 21000,
        "nominal_cooling_conditions": [35, 12, 7],
        "cooling_capacity_expression": "1",
        "EER_expression": "1 + 0.02 * (35 - T_ci) - 0.03 * (T_wo - 7) + 0.2 * F_load - 0.2 * F_load**2"
}
chiller.set_parameters(param)

Boiler

Component to define a boiler: hot water equipment for heating that burns a fuel (or uses electricity). Like Chiller_heat_pump it holds the manufacturer's data and is not simulated by itself: the water generator that uses it asks for the heat it can give and the fuel it uses.

Capacities, fuel power and efficiencies are on the lower heating value (LHV) of the fuel. The efficiency is the nominal one multiplied by efficiency_expression, which may depend on the part load and on the water temperatures: a condensing boiler condenses the water vapour of the flue gases, and is more efficient, when the return water is cold, below about 55 °C for natural gas.

This equipment can be used for one or more HVAC systems.

Parameters

The efficiency expression can include the following independent variables.

Example: a condensing boiler, 88 % efficient with a return at 55 °C or more, up to 96 % with a return at 30 °C.


...

boiler = osm.components.Boiler("boiler", project)
param = {
        "fuel": "NATURAL_GAS",
        "nominal_heating_capacity": 24000,
        "nominal_efficiency": 0.88,
        "nominal_water_flow": 0.3,
        "efficiency_expression": "1 + 0.0035 * max(55 - T_wi, 0)",
        "auxiliary_power": 50
}
boiler.set_parameters(param)

HVAC_water_generator

A generator of hot or chilled water of an HVAC_water_system: an equipment component, a "Chiller_heat_pump" (heating and/or cooling, electric) or a "Boiler" (heating, fuel), with its own primary pump. The water system decides the load it gives in each time step; the generator turns it into the load, part load, power and efficiency of its equipment, and stores them. The water flow through it is the nominal water flow of its equipment.

A Boiler only heats; a Chiller_heat_pump heats, cools or both according to its chiller_type.

A generator may have several identical units of its equipment in parallel (number_of_units): its capacity and water flow are those of one unit times the number of units, and the units share the load with the sequencing of the water system: with "PRIORITY" one after the other (the next one starts when the previous is at full load), with "EQUAL_LOAD" all at the same part load. The power of each unit is calculated with its own part load.

Parameters

Example:


...

generator = osm.components.HVAC_water_generator("generator", project)
param = {
        "equipment": "heat_pump",
        "pump": "pump"
}
generator.set_parameters(param)

Variables

After the simulation we will have the following variables of this component:

HVAC_water_system

Component for the simulation of a water plant that supplies chilled and/or hot water to one or more coils (used by the air side HVAC systems, HVAC_SZW_system and HVAC_MZW_system) from its generators ("HVAC_water_generator").

The coils of the air systems connected to it (parameters water_source, cooling_water_system, heating_water_system and, for the reheat coils of HVAC_MZW_system, reheat_water_source and reheat_water_system) take from it their inlet water temperature and add their load and water flow to it in each iteration. They can also hang from an HVAC_water_circuit fed by the plant, which for the plant is one more coil.

The water of the plant (total_water_volume) is considered as one volume at one temperature: the heat of the generators, the coils, the process load, the losses and the pumps changes it. In heating only the generators able to heat run (boilers and heat pumps), in cooling only those able to cool, and they share the load with the sequencing: "PRIORITY" in the order of the generators list, the next one when the previous is at full load (e.g. a heat pump first and a boiler as backup), or "EQUAL_LOAD", all of them at the same part load.

Without secondary pumps (pumps empty, the default) the generators are in series with the coils, in parallel among them: the water flow is the sum of the water flows of the generators available (their system_on_off), each one moved by its own pump; a generator that is not available lets no water through.

With secondary pumps the plant has a header (a hydraulic decoupler, or a buffer tank) between the primary circuit of the generators and the secondary one of the coils:

Changed in version 0.10: generators replaces water_thermal_generator; the pumps are those of the generators (pump of HVAC_water_generator) and, with a header, the secondary pumps; the water flow is the nominal one of the equipment (design_water_flow is gone). The variables have new names (T_supply, T_return, T_generators_out, T_generators_in, Q_generators...); the efficiency and part load of each generator are in its own variables.

Parameters

Example:


...

water_system = osm.components.HVAC_water_system("water_system", project)
param = {
        "generators": ["generator"],
        "heating_water_setpoint": "50",
        "cooling_water_setpoint": "7",
        "total_water_volume": 100,
        "pump_operation": "ON_LOAD",
        "system_control": "SCHEDULE_CONTROL",
        "input_variables": ["f = mode_schedule.values", "g = on_schedule.values"],
        "system_mode": "f",
        "system_on_off": "g"
}
water_system.set_parameters(param)

Variables

After the simulation we will have the following variables of this component:

HVAC_water_circuit

A secondary water circuit fed by an HVAC_water_system (the plant). The coils of the air systems (HVAC_SZW_system, HVAC_MZW_system) can hang from a circuit instead of from the plant: in their parameters heating_water_system, cooling_water_system and reheat_water_system they refer to the circuit. A plant can feed several circuits, each with its own pumps, its own availability and, with a mixing valve, its own supply temperature: e.g. the fan coils at 40 °C and the coils of an air handling unit at 60 °C from the same boiler.

Towards the coils the circuit offers what a plant offers: the inlet water temperature and the place to add their load. Towards the plant it is one more coil: it takes water from it and gives it back its load, that of its coils plus its losses, the heat of its pumps and, with a water volume, the change of the energy stored in its water. The mode, heating or cooling, is that of the plant.

The pumps of the circuit move their nominal water flow while it is on. The mixing valve mixes the water of the plant with the return of the circuit, so that the supply is never above heating_supply_setpoint nor below cooling_supply_setpoint; without them (the default, empty) the supply is the water of the plant. The water taken from the plant (plant_flow) is then the part of the flow of the circuit that the mixing needs.

Parameters

Example:


...

floor_circuit = osm.components.HVAC_water_circuit("floor_circuit", project)
param = {
        "water_system": "hot_water",
        "pumps": ["floor_pump"],
        "heating_supply_setpoint": "35",
        "water_volume": 300
}
floor_circuit.set_parameters(param)

Variables

After the simulation we will have the following variables of this component: