Release
aedifion.analytics versioning.
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
-
Extended and updated analysis
- CO2 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
- Building
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 CO2 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
- Sensor Functionality
Component models
-
New component models
-
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
- Air cooler
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
- Renaming of analysis function names
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
- Air handling unit
1.5.0¶
Release date: 2021-08-09
What's new in v1.5.0?
Analysis function library
-
New analysis function
-
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
- Alarm State Analysis
Component models
-
New component models
-
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 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
- Control Loop Oscillation Analysis
Component models
-
Extended component models with further pins and attributes
- Fan
- Pins: Pressure difference, Pressure difference setpoint
- Attribute: Pressure difference setpoint deviation tolerance
- Fan
-
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
-
Extended analysis functions
-
- 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
-
- Added heating and cooling mode awareness, determining the mode from measured temperature spread
-
- 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
- Boiler
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
- 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
- Control Loop Oscillation Analysis
- Operating Cycle Analysis
- Reduced Load Analysis
- Room Air Quality Analysis
- Schedule Analysis
- Setpoint Deviation Analysis
- Synchronized Operation Analysis
- Temperature Spread Analysis
- Virtual Meter Analysis
- Weather Station Analysis
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.