Release

aedfion.analytics versioning.

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

  • Air cooler
  • Air heater
  • Compression chiller
  • Cooling circuit
  • Electricity meter
  • Gas meter
  • Heat transfer unit
  • Heating circuit
  • Recooling plant
  • Thermal energy storage
  • Water meter

• 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
    • Operating Cycle Analysis
    • Room Air Quality Analysis
    • Schedule Analysis
    • Thermal Comfort Analysis

• 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 Heat 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 utiltzation 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
  • Fan Speed Analysis
  • Filter Servicing Analysis
  • Humidity Conditioning Analysis
• 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
  • Alarm State Analysis
  • Dew Point Alert Analysis
  • Sensor Outage Analysis
  • Thermal Comfort Analysis
• 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 Heat 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 datapoints, 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 datapoints 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 Heat Meter Analysis
• Weather Station Analysis

Component models

• Boiler
• Combined heat and power
• Fan
• Heat meter
• Heat pump
• Room
• Thermal control loop
• Weather station

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.