Release

aedifion.analytics versioning.

1.19.1¶

Release date: 2024-06-06

What's new in v1.19.1?

Extended and updated analysis
- Temperature adjustment savings, fix attribute for specific heat consumption

1.19.0¶

Release date: 2024-06-03

What's new in v1.19.0?

Add support for newest aedifion labels 1.6.0

1.18.0¶

Release date: 2024-05-17

What's new in v1.18.0?

Analysis function library

Extended and updated analysis
- Temperature adjustment savings, add new analysis to calculate savings from temperature adjustment
- Room air quality, revised calculation of air quality

Component models

Extended component models with further pins

Air handling unit
- Attributes: ARA .controls algorithm - Return air temperature setpoint
Boiler
- Attributes: Heating curve - base points
Building
- Attributes: CO2 emission factor cold, CO2 emission factor electricity, CO2 emission factor heat, Cold price, Cooling limit temperature, Heat price, Investment - CO2 emission price, Investment - CO2 emission price change rate, Investment - depreciation period new energy system, Investment - efficiency current heat source, Investment - electricity price change rate heat pump, Investment - specific energy price change rate current heat source, Optimum room temperature, Reference cooling limit temperature, Reference specific heat consumption, Reference heating limit temperature, Reference optimum room temperature, Reference room temperature, Room temperature
Combined heat and power
- Attributes: Heating curve - base points
Cooling circuit
- Attributes: Heating curve - base points, Nominal power, Nominal volume flow
Heat pump
- Attributes: Heating curve - base points
Heat transfer unit
- Attributes: Heating curve - base points
Heating circuit
- Attributes: Heating curve - base points, Nominal power, Nominal volume flow
Hybrid circuit
- Attributes: Heating curve - base points, Nominal cooling power, Nominal cooling volume flow, Nominal heating power, Nominal heating volume flow
Room
- Attributes: CO2 curve - lower point 2 CO2, CO2 curve - lower point 2 percent, CO2 curve - upper point 1 CO2, CO2 curve - upper point 1 percent, Room air quality red limit, Room air quality yellow limit, percentage time for room air quality calculation
Weather station
- Attributes: analytics basis

Renamed pins and attributes

Air handling unit

Return air side
- AHU+EXH_T_AIR: Return air temperature / Ablufttemperatur
- AHU+EXH_T_AIR_SP: Return air temperature setpoint / Ablufttemperatur-Sollwert
- AHU+ETA_T_AIR_SP_MIN: Return air temperature setpoint minimum / Ablufttemperatur-Sollwert Minimum
- AHU+ETA_T_AIR_SP_MAX: Return air temperature setpoint maximum / Ablufttemperatur-Sollwert Maximum
Supply air side
- AHU+T_AIR_ODA_AHU: Fresh air temperature / Außenlufttemperatur (RLT-Anlage)
Return air fan
- AHU+FAN.EXH+MSG_OPR: Return air fan - operating message / Abluftventilator Betriebsmeldung
- AHU+FAN.EXH+SPE: Return air fan - speed / Abluftventilator-Geschwindigkeit
- AHU+FAN.EXH+VF: Return air fan - volume flow / Abluftventilator-Volumenstrom
- AHU+FAN.EXH+P_DIF: Return air fan - pressure difference / Abluftventilator Druckdifferenz
- AHU+FAN.EXH+P_DIF_SP: Return air fan - pressure difference setpoint / Abluftventilator Druckdifferenz-Sollwert
- AHU+FAN.EXH+POW_EL: Return air fan - electrical power / Abluftventilator elektrische Leistung
- AHU+FAN.EXH+NOM_VF: Return air fan - nominal volume flow / Abluftventilator Nennvolumenstrom
- AHU+FAN.EXH+POW_NOM_CONSUM: Return air fan - nominal power / Abluftventilator Nennleistung
- AHU+FAN.EXH+SPFI_POW_FAN: Return air fan - specific fan power / Abluftventilator spezifische Ventilatorleistung
- AHU+FAN.EXH+SPE_DFLT: Return air fan - Default speed / Abluftventilator Standardgeschwindigkeit
- AHU+FAN.EXH+SPE_STD_THLD: Return air fan - fan speed standard deviation threshold / Abluftventilator Ventilatorgeschwindigkeit Standardabweichung Grenzwert
Supply air fan
- AHU+FAN.SUP+MSG_OPR: Supply air fan - operating message / Zuluftventilator Betriebsmeldung
- AHU+FAN.SUP+SPE: Supply air fan - speed / Zuluftventilator-Geschwindigkeit
- AHU+FAN.SUP+VF: Supply air fan - volume flow / Zuluftventilator-Volumenstrom
- AHU+FAN.SUP+P_DIF: Supply air fan - pressure difference / Zuluftventilator Druckdifferenz
- AHU+FAN.SUP+P_DIF_SP: Supply air fan - pressure difference setpoint / Zuluftventilator Druckdifferenz-Sollwert
- AHU+FAN.SUP+POW_EL: Supply air fan - electrical power / Zuluftventilator elektrische Leistung
- AHU+FAN.SUP+T_DIF: Supply air fan temperature increase / Zuluftventilator Temperaturerhöhung
- AHU+FAN.SUP+NOM_VF: Supply air fan - nominal volume flow / Zuluftventilator Nennvolumenstrom
- AHU+FAN.SUP+POW_NOM_CONSUM: Supply air fan - nominal power / Zuluftventilator Nennleistung
- AHU+FAN.SUP+SPFI_POW_FAN: Supply air fan - specific fan power / Zuluftventilator spezifische Ventilatorleistung
- AHU+FAN.SUP+SPE_DFLT: Supply air fan - Default speed / Zuluftventilator Standardgeschwindigkeit
- AHU+FAN.SUP+SPE_STD_THLD: Supply air fan - fan speed standard deviation threshold / Zuluftventilator Ventilatorgeschwindigkeit Standardabweichung Grenzwert

Room

ROOM+HUM_REL: Relative room air humidity / Relative Raumluftfeuchte
ROOM+T_AIR: Room air temperature / Raumlufttemperatur
ROOM+T_AIR_SP: Room air temperature setpoint (calculated) / Raumtemperatur Sollwert (berechnet)
ROOM+T_AIR_SP_BASE: Room temperature base setpoint / Raumtemperatur Basis-Sollwert

Weather station

WST+T_AIR_ODA: Outside air temperature / Außenlufttemperatur
WST+REFE_T_AIR_ODA: Reference outside air temperature / Referenz-Außenlufttemperatur
WST+HUM_REL_AIR_ODA: Outside air relative humidity / Relative Außenluftfeuchte
WST+REFE_HUM_REL_AIR_ODA: Reference outside air relative humidity / Referenz relative Außenluftfeuchte

1.17.0¶

Release date: 2024-05-16

What's new in v1.17.0?

Add support for newest aedifion labels 1.5.0

1.16.4¶

Release date: 2024-03-07

What's new in v1.16.4?

Analysis function library

Extended and updated analysis
- Thermal comfort, update error message for outside air temperature missing
- Setpoint plausability, correct typing errors in messages

1.16.3¶

Release date: 2024-03-07

What's new in v1.16.3?

Analysis function library

Extended and updated analysis
- Temperature spread, only evaluate prevailing operating mode

1.16.2¶

Release date: 2024-02-09

What's new in v1.16.2?

Analysis function library

Extended and updated analysis
- Wellbeing, filter unreasonable high or low PMV values and add an artificial cap at [-8, +8]

1.16.1¶

Release date: 2024-01-22

What's new in v1.16.1?

Analysis function library

Extended and updated analysis
- Dynamic control, add a filter for fan speed values and limit them from 0 to 100 %
- Schedule, add a filter for fan speed values and limit them from 0 to 100 %

1.16.0¶

Release date: 2024-01-16

What's new in v1.16.0?

Analysis function library

Extended and updated analysis
- Heat pump investment, added new KPIs
- Alarm state, add support for alarm pins of air handling unit
- Setpoint deviation, assume an always off operating message when no pin is connected to the air handling unit

1.15.2¶

Release date: 2024-01-04

What's new in v1.15.2?

Analysis function library

Extended and updated analysis
- Setpoint deviation, fix operating time calculation for air handling units when a fan operating message is set

1.15.1¶

Release date: 2023-12-06

What's new in v1.15.1?

Analysis function library

Extended and updated analysis
- Temperature spread, update handling of pump control datapoints as well change the order of operating message selection

1.15.0¶

Release date: 2023-11-28

What's new in v1.15.0? - Update .analytics to work with python version 3.9

1.14.0¶

Release date: 2023-11-12

What's new in v1.14.0?

We introduce an all new temperature spread analysis and an easier definition for thermal comfort.

Analysis function library

Extended and updated analysis
- Temperature spread, return all KPIs with seperate output for heating and cooling
- Schedule, optimized determination of signal color
- Temperature efficiency, add support for exhaust air pin and remove support for heat transfer station
- Heat demand, corrected handling of baseload
Introduce a unified operating message calculation for the AHU component for the following analysis functions:

Component models

Extended component models with further pins
- Air cooler
  - Attributes: Design return temperature, Design supply temperature, Minimal temperature spread
- Air handling unit
  - Pins: Extract air temperature setpoint maximum, Extract air temperature setpoint minimum
- Air heater
  - Attributes: Design return temperature, Design supply temperature, Minimal temperature spread
- Boiler
  - Pins: Main switching command
  - Attributes: Design return temperature, Design supply temperature, Main switching command - off, Main switching command - on, Minimal temperature spread
- Combined heat and power
  - Attributes: Design return temperature, Design supply temperature, Minimal temperature spread
- Compression chiller
  - Attributes
    - Condenser - design return temperature
    - Condenser - design supply temperature
    - Condenser - minimal temperature spread
    - Evaporator - design return temperature
    - Evaporator - design supply temperature
    - Evaporator - minimal temperature spread
- Cooling circuit
  - Pins: Supply temperature setpoint maximum, Supply temperature setpoint minimum
  - Attributes: Design return temperature, Design supply temperature, Minimal temperature spread
- Heat pump
  - Pins: Main switching command
  - Attributes
    - Condenser cooling - design return temperature
    - Condenser cooling - design supply temperature
    - Condenser cooling - minimal temperature spread
    - Condenser heating - design return temperature
    - Condenser heating - design supply temperature
    - Condenser heating - minimal temperature spread
    - Evaporator cooling - design return temperature
    - Evaporator cooling - design supply temperature
    - Evaporator cooling - minimal temperature spread
    - Evaporator heating - design return temperature
    - Evaporator heating - design supply temperature
    - Evaporator heating - minimal temperature spread
    - Main switching command - off
    - Main switching command - on
    - Overall operating mode
- Heat transfer unit
  - Attributes
    - Overall operating mode
    - Primary cooling - design return temperature
    - Primary cooling - design supply temperature
    - Primary cooling - minimal temperature spread
    - Primary heating - design return temperature
    - Primary heating - design supply temperature
    - Primary heating - minimal temperature spread
    - Secondary cooling - design return temperature
    - Secondary cooling - design supply temperature
    - Secondary cooling - minimal temperature spread
    - Secondary heating - design return temperature
    - Secondary heating - design supply temperature
    - Secondary heating - minimal temperature spread
- Heating circuit
  - Pins: Supply temperature setpoint maximum, Supply temperature setpoint minimum
  - Attributes: Design return temperature, Design supply temperature, Minimal temperature spread
- Hybrid circuit
  - Pins: Cooling supply temperature setpoint maximum, Cooling supply temperature setpoint minimum
  - Attributes: Schedule, Schedule timezone
- Recooling plant
  - Attributes
    - Cooling - design return temperature
    - Cooling - design supply temperature
    - Cooling - minimal temperature spread
    - Heating - design return temperature
    - Heating - design supply temperature
    - Heating - minimal temperature spread
- Room
  - Pins: Comfort temperature, Main switching command
  - Attributes
    - Comfort temperature curve - lower point 1 Room temperature
    - Comfort temperature curve - lower point 1 outside air temperature
    - Comfort temperature curve - upper point 2 Room temperature
    - Comfort temperature curve - upper point 2 outside air temperature
    - Lower limit for room temperature
    - Main switching command - off
    - Main switching command - on
    - Thermal comfort evaluation threshold in hours per week
    - Thermal comfort red limit
    - Thermal comfort yellow limit
    - Upper limit for room temperature
New component models
- Waste meter

1.13.0¶

Release date: 2023-09-05

What's new in v1.13.0?

Introduce automatic execution to all analysis functions.

1.12.0¶

Release date: 2023-08-16

What's new in v1.12.0?

We introduce a new analysis to calculate retrofit heat pump installations.

Analysis function library

New analysis
- Heat pump investment, evaluates if a heat pump retrofit is economically feasible for a building

Component models

Extended component models with further pins
- Air handling unit
  - Pins: Exhaust air temperature
- Boiler
  - Pins: Outdoor air temperature
- Building
  - Attributes
    - Investment - CO2 emission factor current energy system
    - Investment - CO2 emission factor new energy system
    - Investment - Heat pump type
    - Investment - depreciation period new energy system
    - Investment - design temperature heating system
    - Investment - electricity price heat pump
    - Investment - interest rate
    - Investment - specific energy price current heating system
    - Investment - specific installation price new energy system
Rename
- Air handling unit
  - Pins
    - AHU+EXH_T_AIR: Extract air temperature
    - AHU+EXH_T_AIR_SP: Extract air temperature setpoint
- Room
  - Pins: ROOM+T_AIR_SP_BASE: Temperature base setpoint

1.11.0¶

Release date: 2023-07-20

What's new in v1.11.0?

Add support for newest aedifion labels.

1.10.0¶

Release date: 2023-07-05

What's new in v1.10.0?

We introduce a new analysis to compare the energy consumption of buildings and offer a new view on the efficiency of the heat recovery of air handling units.

Analysis function library

New analysis
- Heat demand, compare heat energy consumption of the building between reference period and analysis period
- Temperature efficiency, evaluate the efficiency of a heat exchanger
Extended and updated analysis
- Dynamic control, add attribute fan speed standard deviation threshold to allow user control over threshold
- Virtual meter, rewrite analysis function to support output kpis for frontend meter view and acknowledge datapoint unit tags in calculations
- Sensor functionality, add support for new room pins
- Setpoint plausibility, add support for new room pins
- Reduced load, add support for automatic calculation of temperature setpoint
- Setpoint deviation, update order of operating time candidates for air handling unit

Component models

Extended component models with further pins
- Room
  - Pins: Temperature setpoint cooling and Temperature setpoint heating
- Air handling unit
  - Attributes
    - Exhaust fan - fan speed standard deviation threshold
    - Heat recovery system leakage
    - Supply fan - fan speed standard deviation threshold
    - Temperature efficiency red limit
    - Temperature efficiency yellow limit
- Building
  - Attributes
    - Heating limit temperature upper limit
    - Lower limit total heat power
    - Reference period end
    - Reference period start
    - Thermal base load
- Fan
  - Attributes: Fan speed standard deviation threshold
Rename
- Air handling unit
  - Pins
    - AHU+FAN.EXH+POW_NOM_CONSUM: Exhaust fan - nominal power
    - AHU+FAN.SUP+POW_NOM_CONSUM: Supply fan - nominal power
Removed
- Air handling unit
- Pins: AHU+EF_HRCS due to duplication with AHU+HRCS+EF

1.9.0¶

Release date: 2023-04-21

What's new in v1.9.0?

We introducte an updated calculation of the savings potential for the schedule analysis.
Calculation of room temperature setpoints is more convenient with the pins Temperature basis setpoint and Temperature adjustment.
Deprecation: Schedule calculations no longer support the following attributes: Custom day schedules, Custom holiday, Pre-conditioning period, Regional key and Shutdown flexibility. All or some attributes may be added again in the future when the schedule is redeveloped.

Analysis function library

Extended and updated analysis
- Control Loop Oscillation, enabled for pin supply air temperature of air handling unit
- CO₂ emissions, enabled dynamic energy prices and CO₂ emission factors
- Dynamic control, added support for supply fan and exhaust fan of air handling unit
- Energy consumption, enabled dynamic energy prices and CO₂ emission factors
- Energy cost, enabled dynamic energy prices and CO₂ emission factors
- Operating cycles, added support for supply fan and exhaust fan of air handling unit
- Sensor Functionality, updated limits for temperature pins of heating and cooling circuit
- Setpoint Deviation, changed calculation for Maximum and Average as well as added new KPIs
- Schedule, run the schedule analysis on air handling units with additional savings calculation
- Weather station, removed dependency on weather data API, only the new aedifion weather service should be used as reference pins

Component models

Extended component models with further pins
- Air handling unit
  - Pins
    - Exhaust duct pressure
    - Exhaust duct pressure setpoint
    - Exhaust fan - electrical power
    - Exhaust fan - pressure difference
    - Exhaust fan - pressure difference setpoint
    - Main switching command
    - Outside air temperature (AHU)
    - Supply air temperature after heat recovery system
    - Supply duct pressure
    - Supply duct pressure setpoint
    - Supply fan - electrical power
    - Supply fan - pressure difference
    - Supply fan - pressure difference setpoint
    - Total cooling energy
    - Total cooling power
    - Total electrical energy
    - Total electrical power
    - Total heating energy
    - Total heating power
    - aedifion .controls active
  - Attributes
    - Air cooler - design with heat recovery system
    - Air cooler - nominal thermal power
    - Air heater - design with heat recovery system
    - Air heater - nominal thermal power
    - CO₂ emission factor cold
    - CO₂ emission factor electricity
    - CO₂ emission factor heat
    - Cold price
    - Design outside air temperature for cooling
    - Design outside air temperature for heating
    - Efficiency level of heat recovery
    - Electricity price
    - Empirical design factor cold
    - Empirical design factor heat
    - Exhaust fan - Default speed
    - Exhaust fan - nominal power consumption
    - Exhaust fan - nominal volume flow
    - Exhaust fan - specific fan power
    - Exhaust temperature summer case
    - Exhaust temperature winter case
    - Heat price
    - Heat recovery system active during cooling
    - Heat recovery system active during heating
    - Outside air temperature limit for cooling
    - Outside air temperature limit for heating
    - Pressure difference setpoint deviation tolerance
    - Room temperature during cooling
    - Room temperature during heating
    - Schedule
    - Schedule timezone
    - Supply fan - Default speed
    - Supply fan - nominal power consumption
    - Supply fan - nominal volume flow
    - Supply fan - specific fan power
    - Supply temperature summer case
    - Supply temperature winter case
- Cold meter
  - Pins: CO₂ emission factor and Cold price
- Electricity meter
  - Pins: CO₂ emission factor and Electricity price
- Fan
  - Pins: Volume flow, aedifion .controls active
- Gas meter
  - Pins: CO₂ emission factor and Fuel price
- Heat meter
  - Pins: CO₂ emission factor and Heat price
- Room
  - Pins: Temperature basis setpoint, aedifion .controls active

1.8.0¶

Release date: 2022-09-20

What's new in v1.8.0?

The unit-system and currency of .analytics KPIs can now be adjusted. This enables user to flexibly work in their favorite unit-system and easily handle ESG KPIs from a global portfolio.
It will take a while until all energy meters will be digitized. So .analytics from now on supports manually entered meter data by tolerating and compensating uncertainty of input periods.
Deprecation: Timeseries results are no longer integral part of the .analytics result, but are saved as virtual data point.

Analysis function library

New analysis
- Energy consumption
Extended and updated analysis
- CO₂ emissions, enabled manual entered meter data
- Energy cost, enabled manual entered meter data

Component models

Extended component models with further pins and attributes
- Building
  - Attributes: Air handling units, Asset owner, Asset manager, BREEAM, Building management system brand, Building automation brand, Building automation constructor, Building automation protocol, Car park capacity, CO2 price, Cooling system, DGNB, Energy consumption limit red, Energy consumption limit yellow, Efficiency zones, EnergyStar, Facility manager, ICT contact person, GRESB, Heating system, LEED, Location of building, Mean gross floor area, Number of datapoints, Meters, Occupancy capacity, Property management, Targeted CO2 emissions, Targeted electricity consumption max, Targeted energy generation max, Targeted heat consumption max, Targeted water consumption, Type, Year of construction, Year of last renovation and WiredScore
- Cold meter
  - Attributes: Data source and Meter number
- Electricity meter
  - Attributes: Data source and Meter number
- Gas meter
  - Attributes: Calorific value of natural gas, Data source, Meter number and Pressure compensation factor of natural gas
- Heat meter
  - Attributes: Data source and Meter number
- Water meter
  - Attributes: Data source and Meter number

1.7.0¶

Release date: 2022-03-22

What's new in v1.7.0?

aedifion delivers data and analyses for ESG reporting tools .analytics has new algorithms to determine KPIs for reporting on environmental, social and governance aspects. Including CO₂ and energy cost controlling, as well as user wellbeing.
Meta analysis for the project:
- Introducing the component building
- Introducing a new kind of attributes enabling multi-hierarchical component modeling
Extended .analytics results by plots and summary KPIs
Timeseries results from .analytics are saved as virtual data points, thus becoming unique data points

Deprecation note!

With the upcoming release of version v1.8.0 of .analytics, timeseries will no longer be integral response of the API endpoint GET instance results. aedifion is in contact with any API users to make this change beneficial for everybody who is impacted.

Analysis function library

New analysis
Extended and updated analysis
- Sensor Functionality
  - Adjusted and applied to new components Cold meter and Humidifier
- Setpoint Deviation
  - New pin Pump control is a low priority operating message candidate
- System Control
  - New pin Pump control is a low priority operating message candidate
- Temperature Spread
  - New pin Pump control is a low priority operating message candidate

Component models

New component models
- Building
- Cold meter
- Elevator
- Humidifier
- System
Extended component models with further pins and attributes
- Air cooler
  - Pins: Pump control and Volume flow - ventilation side
  - Attributes: Nominal cooling power, Nominal volume flow - ventilation side and Nominal volume flow - water side
- Air heater
  - Pins: Pump control and Volume flow - ventilation side
  - Attributes: Nominal heating power, Nominal volume flow - ventilation side and Nominal volume flow - water side
- Boiler
  - Pins: Pump control
- Combined heat and power
  - Pins: Pump control
- Compression chiller
  - Pins: Pump control - condenser and Pump control - evaporator
- Cooling circuit
  - Pins: Pump control
- Electricity meter
  - Attributes: Electricity price, Cost measurement device and CO2 emission factor
- Gas meter
  - Attributes: Fuel price, Cost measurement device and CO2 emission factor
- Heat meter
  - Attributes: Heat price, Cost measurement device and CO2 emission factor
- Heat pump
  - Pins: Pump control - condenser*and *Pump control - evaporator
- Heat transfer unit
  - Pins: Pump control - secondary
- Heating circuit
  - Pins: Pump control
- Room
  - Pins: Outside air relative humidity*and *Position sunlight protection
  - Attributes: Area and Calculation of user satisfaction
- Thermal control loop
  - Pins: Pump control

1.6.0¶

Release date: 2021-11-04

What's new in v1.6.0?

First signal color decision on simulated savings of the recommended optimization measures
First inheritance of attributes between project and components reduces analysis configuration
Increased usability via updated signal colors, recommendations, and analysis function names

Analysis function library

Extended and updated analysis
- Renaming of analysis function names
  - Note: alphanumeric_ids of the analysis functions remain unchanged
  - The word "analysis" was removed from all analysis function names
  - Some functions were renamed
    - Energy Conversion Analysis renamed to Energy Efficiency
    - Fan Speed Analysis renamed to Dynamic Control
    - Sensor Outage Analysis renamed to Sensor Functionality
    - Sequence Analysis renamed to Control Sequence
    - Synchronized Operation Analysis renamed to System Control
- Dynamic Control
  - The operation of the component is now determined by the degree of utilization. Thus, the analysis will not consider the pin operating message
- Reduced Load
  - Inherit project location to determine the attribute timezone and use default timezone "Europe/Berlin" if attribute is not set
  - Increased sensitivity for detecting a reduced load for the component Room
- Room air quality
  - Inherit project location to determine the attribute timezone and use default timezone "Europe/Berlin" if attribute is not set
- Schedule
  - The signal color can be determined based on the simulated savings (see economic KPIs for more information). Available for Schedule on the component Fan
  - Inherit project location to determine the attribute timezone and use default timezone "Europe/Berlin" if attribute is not set
- Setpoint Deviation
  - Updated operating message candidates for the components Air handling unit, Compression chiller, Heat pump, and Room
  - Applied to exhaust temperature of the component Air handling unit
- Thermal Comfort
  - The mapping of indoor humidity is now optional. If not mapped, the analysis considers a constant default value (50 %) for indoor air humidity
  - Inherit project location to determine the attribute timezone and use default timezone "Europe/Berlin" if attribute is not set
- Weather Station
  - Uses the project location as the default location for the analysis
- Updated the spectrum of signal colors of all analysis functions to better reflect the impact and average savings of a detected fault. Introduced signal color grey for nonexistent results
- Updated recommendation texts, now including a category of the optimization measure and more pointed guidance

Component models

Extended component models with further pins
- Air handling unit
  - Pins: Exhaust air temperature, Exhaust air temperature setpoint
  - Attributes: Exhaust air temperature setpoint deviation tolerance
- Fan
  - Attributes: Nominal volume flow, Specific fan power
- Room
  - Pins: Lighting operating message, Temperature setpoint adjustment, Valve position - cooling, Valve position - heating, Volume flow controller position - exhaust air, Volume flow controller position - supply air, Window opening

1.5.0¶

Release date: 2021-08-09

What's new in v1.5.0?

Analysis function library

New analysis function
- Sequence Analysis
Extended analysis
- Alarm State Analysis
  - Applied to components Air cooler, Air heater, Compression chiller, Cooling circuit, Heat transfer unit, Heating circuit, and Recooling plant
- Operating Cycle Analysis
  - Adjusted and applied to new component Compression chiller
- Reduced Load Analysis
  - Improved interpretations and recommendations to better describe identified problems and potential solutions
  - Applied to components Combined heat and power and Heating circuit
- Setpoint Deviation Analysis
  - Improved recommendations to include detected causes of the setpoint deviation for the components Cooling circuit and Heating circuit
  - Applied to component Air handling unit
- Virtual Meter Analysis
  - Renamed display name of analysis from Virtual heat meter analysis to Virtual meter analysis, without renaming its alphanumeric_id
  - Adjusted and applied to new components Electricity meter, Gas meter and Water meter
- Improved Sensor Outage Analysis
  - Adjusted high limit thresholds for plausibility checks of Air heater, Heating circuit, and Heat transfer unit
  - Valve positions are now checked for still-stands
  - Applied to new component Air handling unit
- Improved Temperature Spread Analysis
  - Adjusted notification limits for Heat transfer unit

Component models

New component models
- Air handling unit
Further pins were added
- Air cooler: Alarm message
- Air heater: Alarm message
- Cooling circuit: Alarm message, Cold water temperature
- Heat transfer unit: Alarm message
- Heating circuit: Alarm message, Hot water temperature
- Recooling plant: Alarm message

1.4.0¶

Release date: 2021-03-25

What's new in v1.4.0?

Analysis function library

Extended analysis
- Control Loop Oscillation Analysis
  - Adjusted and applied to new components Cooling circuit, Heating circuit, and Heat transfer unit
- Sensor Outage Analysis
  - Adjusted and applied to new components Air cooler, Air heater, Compression chiller, Cooling circuit, Electricity meter, Gas meter, Heat transfer unit, Heating circuit, Recooling plant, Thermal energy storage, and Water meter
- Setpoint Deviation Analysis
  - Setpoint deviation of pressure difference control of Fans
  - Included setpoint deviation of valve control for components Air cooler, Air heater, Cooling circuit, Thermal control loop, Heating circuit, and Heat transfer unit
  - Adjusted and applied temperature setpoint deviation to new components Compression chiller, Cooling circuit, Heat transfer unit, and Heating circuit
- Synchronized Operation Analysis
  - Adjusted and applied to new components Air cooler, Air heater, Compression chiller, and Heat transfer unit
- Temperature Spread Analysis
  - Adjusted and applied to new components Air cooler, Air heater, Compression chiller, Cooling circuit, Heat transfer unit, Heating circuit, and Recooling plant
- Improved Weather Station Analysis
  - Minimum analysis period was set to one week improving statistical reliability
  - Interpretation and recommendation texts indicate insufficient analysis duration if the minimum duration is not reached

Component models

Extended component models with further pins and attributes
- Fan
  - Pins: Pressure difference, Pressure difference setpoint
  - Attribute: Pressure difference setpoint deviation tolerance
New component models
Renaming of display names
- Note: alphanumeric_ids are not affected by this adjustment
- Pins Heat/Heat flow to Heating energy/Heating power for components Boiler, Combined heat and power, Heat meter, and Heat pump
- Pins Inlet/Outlet temperature to Supply/Return temperature for components Boiler, Combined heat and power, and Heat meter
- Pins Valve position setpoint to Valve control signal for component Thermal control loop

1.3.0¶

Release date: 2020-12-07

What's new in v1.3.0?

Analytics framework

Extended API functionality
- Added key enabled to analytics instances
- Added alphanumeric_id to component models, pins, attributes, and analysis functions enabling deployment independent and downward compatible addressing of regarding resource

Analysis function library

New feature: Economic KPIs
- Saving potentials of the given recommendation as KPIs in analysis results
- Costs of observed operational state as KPIs in analysis results
- Saving and cost determination in different accuracy levels depending on mapping
- Available for analytics functions
New analysis functions
- Energy Conversion Analysis
- Setpoint Plausibility Analysis
Extended analysis functions
- Setpoint Deviation Analysis
  - Added upstream temperature check as setpoint deviation cause
  - Setpoint deviation tolerance customizable via attribute
- Synchronized Operation Analysis
  - Added synchronization checkup for component operation and circulating pumps for Boiler, Combined heat and power, and Heat pump
  - Added 3-way valve and circulating pump synchronization check
- Temperature Spread Analysis
  - Added heating and cooling mode awareness, determining the mode from measured temperature spread
- Virtual Meter Analysis
  - Analysis independent of operating message of component
  - Added attribute to set unit of heat and heat flow

Component models

Extended component models with further pins and attributes
- Boiler
  - Pins: Pump operating message, Rate of fuel consumption
  - Attributes: Efficiency, Fuel price, Heat flow unit, Heat unit, Nominal heat production, Start-up costs, Temperature setpoint deviation tolerance
- Combined heat and power
  - Pins: Pump operating message, Rate of fuel consumption
  - Attributes: Electricity price, Fuel price, Fuel utilization factor, Heat flow unit, Heat price, Heat unit, Nominal heat production, Start-up costs, Temperature setpoint deviation tolerance, Thermal efficiency
- Fan
  - Pin: Electrical power
  - Attributes: Electricity price, Nominal power consumption
- Heat meter
  - Attributes: Heat flow unit, Heat unit
- Heat pump
  - Pins: Condenser pump operating message, Electrical power, Evaporator pump operating message
  - Attributes: Coefficient of performance, Condenser outlet temperature setpoint deviation tolerance, Electricity price, Evaporator outlet temperature setpoint deviation tolerance, Heat flow unit, Heat unit, Nominal heat production
- Room
  - Pin: CO2 setpoint
  - Attributes: Average salary, CO2 setpoint deviation tolerance, Shutdown flexibility, Maximum occupation of the room, People in the room, Temperature setpoint deviation tolerance, Type of the room
- Thermal control loop
  - Pin: Pump operating message
  - Attributes: Outlet temperature setpoint deviation tolerance, Valve type, Valve threshold

1.2.0¶

Release date: 2020-07-23

What's new in v1.2.0?

Analysis function library

New analysis functions
Extended Weather Station Analysis
- Added offset analysis of humidity sensor

Component models

New component models
- Filter
- Humidity conditioner
Further pins were added to component models to enable new analysis
- Fan: speed
- Weather station: relative humidity, reference relative humidity

1.1.0¶

Release date: 2020-06-02

What's new in v1.1.0?

Analytics framework

Analytics API endpoints were simplified and are henceforth downward compatible
- Response model of API endpoint GET /v2/analytics/instance/{instance_id}/result/{result_id} was simplified
- POST /v2/analytics/instance and PUT /v2/analytics/instance/{instance_id} were updated to enforce a one-to-one linking between componentInProject and analysisfunctions
Analytics endpoint GET /v2/analytics/functions was extended by accepting component_id as a query parameter to query available functions

Analysis function library

New analysis functions
Extended Reduced Load Analysis
- Added schedule analysis of load reduction
- Refinement of temperature level shift of load reduction, limiting load reduction analysis to the pin temperature setpoint for higher accuracy
Extended Virtual Meter Analysis
- Added comparison of heat meter to virtually determined heat

Component models

Further pins were added to component models to enable new analysis
- Boiler: alarm message, heat and heat flow
- Combined heat and power: alarm message, heat and heat flow
- Fan: alarm message
- Heat meter: heat and heat flow
- Heat pump: alarm message, condenser heat, condenser heat flow, evaporator heat, and evaporator heat flow
- Room: dew point alarm, humidity and outside air temperature
- Thermal control loop: alarm message

1.0.1¶

Release date: 2020-05-08

What's new in v1.0.1?

Fixed Setpoint Deviation Analysis sensibility to operating message
More tolerant signal color thresholds for Temperature Spread Analysis on CHPs
Added KPI co2.minimum to Room Air Quality Analysis
Renamed pin of Thermal Control Loop: return temperature to inlet temperature recirculation, the component therefore approaches 3-way valves in its definition

1.0.0¶

Release date: 2020-03-20

Analytics framework

Abstract component models
- aedifion provides a library of curated component models that abstractly model the functioning of various physical or virtual technical equipment such as boilers, heat pumps, control loops, rooms, etc.
- Each abstract component model has a set of pins that are placeholders for a real component's data points, e.g., the component model heat pump has pins for its condenser supply and return temperature.
- Each abstract component model has a set of attributes that are placeholders for a real component's metadata such as installation parameters, nominal performance data, operation parameters, etc. E.g., the component model weather station has attributes for the longitude and latitude of its installation.
- Instancing an abstract component model to a project and mapping of its pins and attributes creates a digital twin of physical or virtual technical equipment. Mapping is the process of attaching data points and attributes to a component data model instanced for a project.
Analysis functions
- aedifion provides a library of algorithm functions to analyze building performance.
- Each analysis function can be applied to one or more components. E.g., an analysis of the room air quality might apply only to the component room, while an analysis of duty cycles might apply to any physical, active component.
Analysis configuration
- Configuration of which analysis functions shall be applied to which mapped component, stored as analysis instance.
- Analysis instances can be executed on arbitrary time ranges, e.g., days, weeks, months, or whole years.
Analysis result
- Each execution of an instance on a time range provides a result.
- Results include signal colors, interpretations, recommendations, key performance indicators, and time series and are utilized individually for each analysis. Signal colors provide a visual evaluation of the analyzed operational conditions. Interpretations provide a textual summary of the analyzed operational condition. Recommendations provide a textual measure to further investigate or fix the cause of suboptimal operational performance. Key performance indicators and time series create transparency of the operational conditions analyzed.
- Analysis results are stored in an aedifion database for later queries.
Utilize analytics framework
- Analytics framework utilizable to the full extent via API. Comprehensive guides and tutorials are available.
- The aedifion.io frontend displays the signal colors, interpretations, recommendations, and key performance indicators of the most recent analysis results for each analysis instance, including instancing and mapping of component models.

Analysis functions library

Component models

Serviced analytics

Serviced analytics is an optionally bookable add-on to the .analytics basic license.
Minimal service level:
- Component mapping as a service
- Analysis configuration as a service
- Monthly curated analysis results as a service
The service is provided by aedifion professionals.