Release

aedfion.analytics versioning.

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 Heat Meter
  - 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
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 heat meter
- 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

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.

Last update: 2020-12-04