Analystranslatorer

En analystranslator följer en enhet över tid och rapporterar något om dess beteende snarare än dess senaste avläsning: hur snabbt ett värde rör sig, hur stor del av dygnet något var i bruk, hur illa radiolänken presterar, eller hur långt en sensor har driftat från sin sanna nollpunkt.

Liksom de övriga logiska translatorerna är de kedjade och körs ovanpå enhetens hårdvarutranslator.

Varför använda en analystranslator

Skillnaden mot en beräkningstranslator är historik. En beräkning härleder sitt svar ur avläsningen framför sig: Celsius till Fahrenheit behöver inget annat. En analystranslator kan inte svara utifrån en enda avläsning alls. "Stiger det här för snabbt?" och "hur stor del av dagen var den här lampan tänd?" betyder bara något över en serie upplänkar.

Så de här translatorerna håller tillstånd på enheten mellan rapporter, och varje ny upplänk uppdaterar bilden. Det är arbete du annars skulle göra genom att exportera historik och analysera den någon annanstans, i efterhand. Här är svaret ett levande fält på enheten, vilket betyder att det kan visas på en dashboard, filtreras i en vy, och övervakas av en larmtranslator som vilket annat värde som helst.

Translatorerna

Translator	Vad den rapporterar	Fält som skapas
analytics-change-rate	Hur snabbt en avläsning förändras, per timme. Positiv när den stiger, negativ när den faller, nära noll när den ligger stilla. Fångar en temperatur som stiger snabbare än den borde, vilket ofta betyder ett fel snarare än en varm dag	changeRate
analytics-utilization-rates	Hur mycket något faktiskt används över tid. Byggd för en kund som misstänkte att inomhusbelysning lämnades tänd, och ville se hur länge den gick svagt tänd kontra starkt tänd	utilization, utilizationDaily, utilizationHigh, utilizationLow
analytics-frame-loss-rate	Hur många upplänkar en enhet tappar, genom att bevaka hur dess frame-räknare hoppar. Frames numrerade 10 och sedan 13 betyder att två försvann. Ett direkt mått på radiotäckningens kvalitet, och indata till set-alarm-frame-loss-rate	frameLossRate
analytics-building-energy-efficiency	Jämför en byggnads energieffektivitet och pekar ut nästa besparing. Rapporterar både en temperaturnormaliserad effektivitetssiffra och energyIntensity, den standardiserade energianvändningen per kvadratmeter, med vecko-, månads-, kvartals- och årsmedelvärden	energyEfficiency, energyIntensity, energyEfficiencyRolling, energyEfficiencyWeekly, energyEfficiencyMonthly, energyEfficiencyQuarterly, energyEfficiencyYearly, deltaTemperature
analytics-abc-calibration	Korrigerar en sensor vars nollpunkt driftar. Automatic Baseline Calibration antar att de återkommande låga avläsningarna representerar den sanna baslinjen, lär sig den ur dagliga minimivärden över ett fönster, och drar bort driften. Klassikern är en CO2-sensor som borde återgå till utomhusnivåer under natten	calibratedValue, calibrationOffset
analytics-abc-calibration-adaptive	Samma idé, men som följer baslinjen adaptivt över en driftperiod i stället för ett fast kalenderfönster. För sensorer som inte återgår till baslinjen i en prydlig daglig rytm	calibratedValue, calibrationOffset
analytics-suspected-activity-during-time-window	Flaggar för personer som är på en plats som borde vara tom, som lokaler på kvällen och natten. En ljudsensor lyssnar efter ljud som håller sig förhöjt tillräckligt länge för att vara en person snarare än en förbipasserande smäll, men bara under bevakningstimmarna	suspectedActivity, activitySince

Parametrar

Samma konvention som på andra ställen: de flesta parametrar är valfria och bär ett standardvärde, men vissa är obligatoriska, och inputField pekar translatorn mot ett specifikt källfält när det automatiska valet blir fel.

Parameter	Används av	Syfte
inputField	de flesta	Fältet som ska analyseras
timeZone	de periodmedvetna	Lokal tidszon som avgör när ett dygn växlar
sampleSize, changeRateSampleSize, efficiencySampleSize	förändringstakt, paketförlust, energieffektivitet	Hur många avläsningar som ska jämnas ut, så att en enstaka udda upplänk inte kastar resultatet
calibrationWindowDays, baselinePercentile, calibrationFloor, adaptiveDriftDays	ABC-paret	Hur baslinjen lärs in och hur långt den får röra sig
buildingArea, energyThreshold	energieffektivitet	Golvyta för intensitetssiffran, och en gräns under vilken en lugn period bortses från i stället för att smickra resultatet
averageThreshold, peakThreshold, activityDurationMins, maxGapMins, watchStartHour, watchEndHour	misstänkt aktivitet	Vad som räknas som ljud, hur länge det måste hålla i sig, och när bevakningen ska ske

Kedjning

Två kedjor värda att känna till, båda avslutade med ett larm så att resultatet når någon:

• Täckningsövervakning. Enhet → analytics-frame-loss-rate → set-alarm-frame-loss-rate. Analystranslatorn mäter förlustgraden, larmet går när en enhets täckning försämras bortom vad du accepterar, och det är så du hittar ett gatewayproblem innan användarna rapporterar det.
• Detektering av skenande värden. Sensor → analytics-change-rate → set-alarm-change-rate. Förändringstakt först, sedan ett tröskelvärde på takten snarare än på värdet, så att en frys som havererar snabbt fångas långt innan den är varm.

För larmen, se Larmtranslatorer. För det fullständiga A–Ö-registret över alla translatorer, se översikten över translatorer.