Result in house air quality graphs:
Flows creating SVGs:
Homey script creating SVG (largely generated by AI in Dutch):
/**
* Homey Script voor het ophalen van Insights data en het genereren van een dynamische SVG-lijngrafiek.
* Controleert de 6 configuratieparameters en toont bij een fout een SVG-foutmelding in plaats van defaults.
*
* Nieuw: de grafieklijn kan worden afgevlakt met een voortschrijdend gemiddelde.
* Stel de sterkte van de afvlakking in met de constante 'afvlakkingVenster' (sectie 2).
*/
// ==========================================
// 1. INPUT VERWERKING & PARAMETER CONTROLE
// ==========================================
// De invoer komt binnen als eerste argument van de flow (JSON-object of JSON-tekst)
let dataInput = args[0];
// Als de invoer een tekst is, proberen we deze om te zetten naar een object
if (typeof dataInput === 'string') {
try {
// Enkele aanhalingstekens vervangen door dubbele, zodat de tekst geldige JSON wordt
let gefixteJson = dataInput.replace(/'/g, '"');
dataInput = JSON.parse(gefixteJson);
// Tijdelijke variabele direct vrijgeven voor de Garbage Collector
gefixteJson = null;
} catch (fout) {
console.error('Fout bij het parsen van input JSON:', fout);
return genereerSvgFoutmelding('Fout bij parsen van input JSON.');
}
}
// Validatie of dataInput een geldig object is (geen null, geen array, geen tekst)
if (!dataInput || typeof dataInput !== 'object' || Array.isArray(dataInput)) {
console.error('Ongeldige input: args[0] moet een JSON-object zijn.');
return genereerSvgFoutmelding('Ongeldige input: Geen geldig JSON-object ontvangen.');
}
// Uitlezen van de 6 verplichte configuratieparameters
let grafiekTitel = dataInput.grafiekTitel;
let yAsTitel = dataInput.yAsTitel;
let xAsTitel = dataInput.xAsTitel;
let apparaatId = dataInput.apparaatId;
let capabilityNaam = dataInput.capabilityNaam;
let inzichtenResolutie = dataInput.inzichtenResolutie;
// Strenge controle of alle 6 parameters aanwezig en niet leeg/ongeldig zijn
if (!grafiekTitel || typeof grafiekTitel !== 'string' || grafiekTitel.trim() === '') {
return genereerSvgFoutmelding('Configuratiefout: \'grafiekTitel\' ontbreekt of is leeg.');
}
if (!yAsTitel || typeof yAsTitel !== 'string' || yAsTitel.trim() === '') {
return genereerSvgFoutmelding('Configuratiefout: \'yAsTitel\' ontbreekt of is leeg.');
}
if (!xAsTitel || typeof xAsTitel !== 'string' || xAsTitel.trim() === '') {
return genereerSvgFoutmelding('Configuratiefout: \'xAsTitel\' ontbreekt of is leeg.');
}
if (!apparaatId || typeof apparaatId !== 'string' || apparaatId.trim() === '') {
return genereerSvgFoutmelding('Configuratiefout: \'apparaatId\' ontbreekt of is leeg.');
}
if (!capabilityNaam || typeof capabilityNaam !== 'string' || capabilityNaam.trim() === '') {
return genereerSvgFoutmelding('Configuratiefout: \'capabilityNaam\' ontbreekt of is leeg.');
}
if (!inzichtenResolutie || typeof inzichtenResolutie !== 'string' || inzichtenResolutie.trim() === '') {
return genereerSvgFoutmelding('Configuratiefout: \'inzichtenResolutie\' ontbreekt of is leeg.');
}
// ==========================================
// 2. OVERIGE CONFIGURATIE & VARIABELEN
// ==========================================
// Lettergrootte instellingen (pt)
const fontGrootteTitel = 23;
const fontGrootteLabels = 18;
const fontGrootteTitelsAssen = 18;
// Kleurinstellingen (CSS / Hex)
const kleurLijn = '#80B3FF';
const kleurVulling = '#1D4ED8';
const transparantieVulling = 0.25;
const kleurAssen = '#FFFFFF';
const kleurGridLijnen = '#ffffff44';
// Canvas afmetingen en marges
const canvasBreedte = 900;
const canvasHoogte = 340;
const margeLinks = 95;
const margeRechts = 20;
const margeBoven = 25;
const margeOnder = 60;
// Marge boven en onder de data, als fractie van het databereik (0.05 = 5%)
const margeFractieData = 0.05;
// Y-as intervallen instellingen
const streefAantalYStappen = 5;
const minimaalAantalYStappen = 3;
const maximaalAantalYStappen = 8;
const strafPerAfwijkendeStap = 0.04;
// Afvlakking van de grafieklijn: aantal meetpunten waarover een voortschrijdend
// gemiddelde wordt genomen. Gebruik bij voorkeur een oneven getal.
// 1 = geen afvlakking (ruwe data)
// 5 = licht afgevlakt
// 9 = gemiddeld afgevlakt
// 15 = sterk afgevlakt
// 25 = zeer sterk afgevlakt (alleen de hoofdlijn blijft over)
// Een even getal werkt als het volgende oneven getal (8 geeft hetzelfde als 9).
const afvlakkingVenster = 9;
// ==========================================
// 3. OPHALEN VAN INSIGHTS DATA
// ==========================================
// Tijdelijke variabelen voor het ophalen van de data
let logboeken = null;
let doelLog = null;
let inzichtenData = null;
// Hulparray met per meetpunt: l = x-aslabel (uurnummer of null), v = gemeten waarde
let meetResultatenLijst = [];
try {
// Stap 1: Haal alle beschikbare Insights logboeken op
logboeken = await Homey.insights.getLogs();
// Converteer naar een array (de API geeft soms een object terug)
const logsArray = Array.isArray(logboeken) ? logboeken : Object.values(logboeken || {});
// Stap 2: Zoek het juiste logboek op basis van de device ID en capability
doelLog = logsArray.find(log =>
log && log.uri && log.uri.includes(apparaatId) && log.uri.includes(capabilityNaam)
);
if (doelLog) {
// Stap 3: Haal alle datapunten op basis van de resolutie
inzichtenData = await Homey.insights.getLogEntries({
id: doelLog.id,
uri: doelLog.uri,
resolution: inzichtenResolutie
});
if (inzichtenData && inzichtenData.values && inzichtenData.values.length > 0) {
// Onthoudt het vorige uurnummer, zodat een label alleen bij een uurwisseling komt
let vorigUur = null;
// Stap 4: Loop door alle metingen heen
for (const punt of inzichtenData.values) {
const datum = new Date(punt.t);
// Formatteer naar Nederlandse tijd om het juiste uurnummer te krijgen
const nlTijdString = new Intl.DateTimeFormat('nl-NL', {
timeZone: 'Europe/Amsterdam',
hour: 'numeric',
hour12: false
}).format(datum);
const huidigUurNummer = Number(nlTijdString);
// Alleen bij een nieuw uur krijgt het punt een x-aslabel
let tijdVeld = null;
if (huidigUurNummer !== vorigUur) {
tijdVeld = String(huidigUurNummer);
vorigUur = huidigUurNummer;
}
// Rond de waarde af op 1 decimaal
const afgerondeWaarde = Number(punt.v.toFixed(1));
// Voeg toe aan de hulparray
meetResultatenLijst.push({
l: tijdVeld,
v: afgerondeWaarde
});
}
} else {
return genereerSvgFoutmelding('Geen datapunten gevonden in de opgegeven periode.');
}
} else {
return genereerSvgFoutmelding('Het gevraagde Inzicht logboek kon niet worden gevonden.');
}
} catch (fout) {
return genereerSvgFoutmelding('Fout bij ophalen van inzichten: ' + fout.message);
} finally {
// Geheugen vrijmaken voor de Garbage Collector
logboeken = null;
doelLog = null;
inzichtenData = null;
}
// Zonder meetpunten kan er geen grafiek getekend worden
if (meetResultatenLijst.length === 0) {
return genereerSvgFoutmelding('Geen meetpunten beschikbaar voor de grafiek.');
}
// ==========================================
// 3B. AFVLAKKEN VAN DE METINGEN
// ==========================================
// Elk meetpunt wordt vervangen door het gemiddelde van zichzelf en zijn buren.
// Het gemiddelde wordt snel berekend met een cumulatieve som (geen dubbele lus).
// De afvlakking gebeurt VOOR de y-as berekening, zodat de schaal meebeweegt.
if (afvlakkingVenster > 1 && meetResultatenLijst.length > 2) {
let aantalMeetpunten = meetResultatenLijst.length;
// Aantal punten links en rechts van het huidige punt dat meedoet in het gemiddelde
let halfVenster = Math.floor(afvlakkingVenster / 2);
// Cumulatieve som: cumulatieveSom[n] = som van de eerste n waarden
let cumulatieveSom = new Array(aantalMeetpunten + 1);
cumulatieveSom[0] = 0;
for (let meetpuntIndex = 0; meetpuntIndex < aantalMeetpunten; meetpuntIndex++) {
cumulatieveSom[meetpuntIndex + 1] = cumulatieveSom[meetpuntIndex] + meetResultatenLijst[meetpuntIndex].v;
}
// Per punt het gemiddelde over het venster berekenen.
// Aan het begin en einde van de reeks wordt het venster automatisch smaller.
let afgevlakteWaarden = new Array(aantalMeetpunten);
for (let meetpuntIndex = 0; meetpuntIndex < aantalMeetpunten; meetpuntIndex++) {
let beginIndex = Math.max(0, meetpuntIndex - halfVenster);
let eindIndex = Math.min(aantalMeetpunten - 1, meetpuntIndex + halfVenster);
let aantalInVenster = eindIndex - beginIndex + 1;
let somInVenster = cumulatieveSom[eindIndex + 1] - cumulatieveSom[beginIndex];
afgevlakteWaarden[meetpuntIndex] = somInVenster / aantalInVenster;
}
// Afgevlakte waarden terugschrijven (de x-aslabels 'l' blijven ongewijzigd)
for (let meetpuntIndex = 0; meetpuntIndex < aantalMeetpunten; meetpuntIndex++) {
meetResultatenLijst[meetpuntIndex].v = afgevlakteWaarden[meetpuntIndex];
}
// Geheugen vrijmaken voor de Garbage Collector
cumulatieveSom = null;
afgevlakteWaarden = null;
}
// ==========================================
// 4. BEREKENINGEN & GELIJKE Y-INTERVALLEN
// ==========================================
// Beschikbare ruimte voor de grafiek zelf (canvas min de marges)
let tekenBreedte = canvasBreedte - margeLinks - margeRechts;
let tekenHoogte = canvasHoogte - margeBoven - margeOnder;
// Alle Y-waarden uit de dataset halen (nu dus de afgevlakte waarden)
let yWaarden = meetResultatenLijst.map(function(meetpunt) {
return meetpunt.v;
});
let yMinAbsoluut = Math.min.apply(null, yWaarden);
let yMaxAbsoluut = Math.max.apply(null, yWaarden);
// Totale spreiding van de data
let bereikY = yMaxAbsoluut - yMinAbsoluut;
// Bepaal de minimale y-as waarde: 10% van het bereik (of van de waarde zelf als bereik 0 is)
// lager dan de laagste datawaarde, maar nooit < 0 (tenzij data zelf negatief is)
let toegestaneOnderkant = yMinAbsoluut >= 0 ? 0 : yMinAbsoluut - (Math.abs(yMinAbsoluut) * 0.1);
let yMinRauw = yMinAbsoluut - (bereikY > 0 ? bereikY * 0.1 : Math.max(Math.abs(yMinAbsoluut) * 0.1, 1));
if (yMinRauw < toegestaneOnderkant && yMinAbsoluut >= 0) {
yMinRauw = 0;
}
// Marge boven de hoogste datawaarde
let yMargeStap = bereikY * margeFractieData;
let yMaxRauw = yMaxAbsoluut + yMargeStap;
// Vangnet voor een vlakke lijn (alle waarden gelijk)
if (yMaxRauw - yMinRauw <= 0) {
yMinRauw = yMinAbsoluut - 0.5;
if (yMinAbsoluut >= 0 && yMinRauw < 0) yMinRauw = 0;
yMaxRauw = yMaxAbsoluut + 0.5;
}
let yTotaalBereikRauw = yMaxRauw - yMinRauw;
// Kandidaat-stapgroottes: 1, 2 en 5 keer een macht van tien ("mooie" getallen)
let mooieVermenigvuldigers = [1, 2, 5];
let startExponent = Math.floor(Math.log10(yTotaalBereikRauw / maximaalAantalYStappen)) - 1;
// Beste combinatie tot nu toe (begint met een simpele schatting)
let gekozenStap = yTotaalBereikRauw / streefAantalYStappen;
let aantalYStappen = streefAantalYStappen;
let yMin = yMinRauw;
let besteScore = Infinity;
// Probeer alle kandidaten en kies de combinatie met de laagste score
for (let exponentTeller = 0; exponentTeller < 8; exponentTeller++) {
let macht = Math.pow(10, startExponent + exponentTeller);
for (let vermenigvuldigerIndex = 0; vermenigvuldigerIndex < mooieVermenigvuldigers.length; vermenigvuldigerIndex++) {
let kandidaatStap = mooieVermenigvuldigers[vermenigvuldigerIndex] * macht;
let kandidaatMin = Math.floor((yMinRauw / kandidaatStap) + 1e-9) * kandidaatStap;
// Zorg dat kandidaatMin nooit onder 0 komt als de dataset niet negatief is
if (yMinAbsoluut >= 0 && kandidaatMin < 0) {
kandidaatMin = 0;
}
let kandidaatAantalStappen = Math.ceil(((yMaxRauw - kandidaatMin) / kandidaatStap) - 1e-9);
// Te veel stappen: kandidaat overslaan
if (kandidaatAantalStappen > maximaalAantalYStappen) {
continue;
}
// Te weinig stappen: opvullen tot het minimum
if (kandidaatAantalStappen < minimaalAantalYStappen) {
kandidaatAantalStappen = minimaalAantalYStappen;
}
// Score = overschot aan ongebruikte ruimte + straf voor afwijking van het streefaantal
let kandidaatTotaalBereik = kandidaatAantalStappen * kandidaatStap;
let kandidaatOverschot = (kandidaatTotaalBereik - yTotaalBereikRauw) / yTotaalBereikRauw;
let kandidaatStrafStappen = Math.abs(kandidaatAantalStappen - streefAantalYStappen) * strafPerAfwijkendeStap;
let kandidaatScore = kandidaatOverschot + kandidaatStrafStappen;
if (kandidaatScore < besteScore - 1e-9) {
besteScore = kandidaatScore;
gekozenStap = kandidaatStap;
aantalYStappen = kandidaatAantalStappen;
yMin = kandidaatMin;
}
}
}
// Bovenkant van de y-as volgt uit de onderkant plus alle stappen
let yMax = yMin + (gekozenStap * aantalYStappen);
// Afrondingsfouten van floating point getallen wegwerken
yMin = Number(yMin.toFixed(10));
yMax = Number(yMax.toFixed(10));
// Aantal decimalen voor de y-aslabels, afgeleid van de stapgrootte
let yDecimalen = Math.max(0, -Math.floor(Math.log10(gekozenStap) + 1e-9));
let yTotaalBereik = yMax - yMin;
// ==========================================
// 5. SVG OPBOUWEN VIA ARRAYS
// ==========================================
// Alle SVG-regels worden eerst in een array verzameld (push) en daarna met join samengevoegd.
// Dat is geheugenefficienter dan steeds een lange tekst aan elkaar plakken.
let svgOnderdelen = [];
svgOnderdelen.push('<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ' + canvasBreedte + ' ' + canvasHoogte + '" width="100%" height="100%" style="background: transparent;">');
svgOnderdelen.push(' <defs>');
svgOnderdelen.push(' <style>');
svgOnderdelen.push(' @import url(\'https://fonts.googleapis.com/css2?family=Exo+2:wght@200;400&display=swap\');');
svgOnderdelen.push(' text { font-family: \'Exo 2\', sans-serif; }');
svgOnderdelen.push(' </style>');
svgOnderdelen.push(' </defs>');
// Hoofdtitel bovenaan, gecentreerd
if (grafiekTitel && grafiekTitel.length > 0) {
svgOnderdelen.push(' <text x="' + (canvasBreedte / 2) + '" y="24" fill="' + kleurAssen + '" font-size="' + fontGrootteTitel + 'pt" font-weight="400" text-anchor="middle">' + grafiekTitel + '</text>');
}
// Horizontale gridlijnen, streepjes en Y-as labels
for (let gridIndex = 0; gridIndex <= aantalYStappen; gridIndex++) {
let verhouding = gridIndex / aantalYStappen;
let yPositie = margeBoven + (tekenHoogte * (1 - verhouding));
let yWaardeLabel = (yMin + (gridIndex * gekozenStap)).toFixed(yDecimalen);
// Gridlijn over de volle breedte van de grafiek
svgOnderdelen.push(' <line x1="' + margeLinks + '" y1="' + yPositie + '" x2="' + (canvasBreedte - margeRechts) + '" y2="' + yPositie + '" stroke="' + kleurGridLijnen + '" stroke-width="0.5" />');
// Klein streepje links van de y-as
svgOnderdelen.push(' <line x1="' + (margeLinks - 5) + '" y1="' + yPositie + '" x2="' + margeLinks + '" y2="' + yPositie + '" stroke="' + kleurAssen + '" stroke-width="1" />');
// Waardelabel naast het streepje
svgOnderdelen.push(' <text x="' + (margeLinks - 10) + '" y="' + (yPositie + 4) + '" fill="' + kleurAssen + '" font-size="' + fontGrootteLabels + 'pt" text-anchor="end">' + yWaardeLabel + '</text>');
}
// Datapunten en X-as elementen berekenen
let aantalPunten = meetResultatenLijst.length;
// Horizontale afstand tussen twee opeenvolgende punten
let xStap = tekenBreedte / (aantalPunten > 1 ? aantalPunten - 1 : 1);
// Punten voor de lijn en voor de gevulde oppervlakte eronder
let grafiekPunten = [];
let oppervlaktePunten = [];
// Oppervlakte begint linksonder op de x-as
oppervlaktePunten.push(margeLinks + ',' + (margeBoven + tekenHoogte));
for (let puntIndex = 0; puntIndex < aantalPunten; puntIndex++) {
// x-positie volgt uit de volgorde, y-positie uit de (afgevlakte) waarde
let xPositie = margeLinks + (puntIndex * xStap);
let yGenormaliseerd = yTotaalBereik !== 0 ? (meetResultatenLijst[puntIndex].v - yMin) / yTotaalBereik : 0.5;
let yPositiePunt = margeBoven + (tekenHoogte * (1 - yGenormaliseerd));
// Punt toevoegen aan zowel de lijn als de oppervlakte
let puntString = xPositie.toFixed(2) + ',' + yPositiePunt.toFixed(2);
grafiekPunten.push(puntString);
oppervlaktePunten.push(puntString);
// X-aslabel (uurnummer) ophalen, indien aanwezig voor dit punt
let xAsLabel = meetResultatenLijst[puntIndex].l ? String(meetResultatenLijst[puntIndex].l).trim() : '';
// Meest linker label op de x-as overslaan (puntIndex === 0)
if (xAsLabel.length > 0 && puntIndex > 0) {
let xLabelPositie = xPositie.toFixed(2);
// Klein streepje onder de x-as
svgOnderdelen.push(' <line x1="' + xLabelPositie + '" y1="' + (margeBoven + tekenHoogte) + '" x2="' + xLabelPositie + '" y2="' + (margeBoven + tekenHoogte + 5) + '" stroke="' + kleurAssen + '" stroke-width="1" />');
// Uurlabel onder het streepje
svgOnderdelen.push(' <text x="' + xLabelPositie + '" y="' + (margeBoven + tekenHoogte + 25) + '" fill="' + kleurAssen + '" font-size="' + fontGrootteLabels + 'pt" text-anchor="middle">' + xAsLabel + '</text>');
}
}
// Oppervlakte sluit rechtsonder op de x-as
oppervlaktePunten.push((margeLinks + tekenBreedte) + ',' + (margeBoven + tekenHoogte));
// Vulling en grafieklijn tekenen
svgOnderdelen.push(' <polygon points="' + oppervlaktePunten.join(' ') + '" fill="' + kleurVulling + '" fill-opacity="' + transparantieVulling + '" />');
svgOnderdelen.push(' <polyline points="' + grafiekPunten.join(' ') + '" fill="none" stroke="' + kleurLijn + '" stroke-width="2.5" stroke-linejoin="round" stroke-linecap="round" />');
// Hoofdassen tekenen (y-as links, x-as onder)
svgOnderdelen.push(' <line x1="' + margeLinks + '" y1="' + margeBoven + '" x2="' + margeLinks + '" y2="' + (margeBoven + tekenHoogte) + '" stroke="' + kleurAssen + '" stroke-width="1" />');
svgOnderdelen.push(' <line x1="' + margeLinks + '" y1="' + (margeBoven + tekenHoogte) + '" x2="' + (canvasBreedte - margeRechts) + '" y2="' + (margeBoven + tekenHoogte) + '" stroke="' + kleurAssen + '" stroke-width="1" />');
// Titel van de x-as, onderaan gecentreerd
if (xAsTitel && xAsTitel.length > 0) {
let xTitelPositie = margeLinks + (tekenBreedte / 2);
let yTitelPositie = canvasHoogte - 8;
svgOnderdelen.push(' <text x="' + xTitelPositie + '" y="' + yTitelPositie + '" fill="' + kleurAssen + '" font-size="' + fontGrootteTitelsAssen + 'pt" font-weight="400" text-anchor="middle">' + xAsTitel + '</text>');
}
// Titel van de y-as, links en 90 graden gedraaid
if (yAsTitel && yAsTitel.length > 0) {
let xYTitelPositie = 18;
let yYTitelPositie = margeBoven + (tekenHoogte / 2);
svgOnderdelen.push(' <text x="' + xYTitelPositie + '" y="' + yYTitelPositie + '" fill="' + kleurAssen + '" font-size="' + fontGrootteTitelsAssen + 'pt" font-weight="400" text-anchor="middle" transform="rotate(-90 ' + xYTitelPositie + ' ' + yYTitelPositie + ')">' + yAsTitel + '</text>');
}
svgOnderdelen.push('</svg>');
// Alle regels samenvoegen tot een enkele SVG-tekst
let svgResultaat = svgOnderdelen.join('\n');
// ==========================================
// 6. EINDRESULTAAT & GEHEUGEN OPTIMALISATIE
// ==========================================
// Resultaat als object met titel en SVG, zoals de flow verwacht
let eindResultaat = {
titel: grafiekTitel,
svg: svgResultaat
};
let jsonString = JSON.stringify(eindResultaat);
// Expliciet geheugen vrijmaken voor de Garbage Collector
dataInput = null;
meetResultatenLijst = null;
yWaarden = null;
svgOnderdelen = null;
svgResultaat = null;
grafiekPunten = null;
oppervlaktePunten = null;
mooieVermenigvuldigers = null;
eindResultaat = null;
return jsonString;
// ==========================================
// HULPFUNCTIE VOOR SVG FOUTMELDING
// ==========================================
// Bouwt een SVG met een rode titel en de foutmelding, zodat de fout op het dashboard zichtbaar is.
function genereerSvgFoutmelding(foutmelding) {
console.error(foutmelding);
let foutSvgOnderdelen = [];
foutSvgOnderdelen.push('<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 900 340" width="100%" height="100%" style="background: transparent;">');
foutSvgOnderdelen.push(' <defs>');
foutSvgOnderdelen.push(' <style>');
foutSvgOnderdelen.push(' @import url(\'https://fonts.googleapis.com/css2?family=Exo+2:wght@400;600&display=swap\');');
foutSvgOnderdelen.push(' text { font-family: \'Exo 2\', sans-serif; }');
foutSvgOnderdelen.push(' </style>');
foutSvgOnderdelen.push(' </defs>');
foutSvgOnderdelen.push(' <rect width="900" height="340" fill="#1E1E1E" rx="10" />');
foutSvgOnderdelen.push(' <text x="450" y="140" fill="#FF5252" font-size="22pt" font-weight="400" text-anchor="middle">Configuratiefout</text>');
foutSvgOnderdelen.push(' <text x="450" y="190" fill="#FFFFFF" font-size="16pt" font-weight="400" text-anchor="middle">' + foutmelding + '</text>');
foutSvgOnderdelen.push('</svg>');
let foutResultaat = {
titel: 'Foutmelding',
svg: foutSvgOnderdelen.join('\n')
};
// Verzamelarray vrijgeven voor de Garbage Collector
foutSvgOnderdelen = null;
return JSON.stringify(foutResultaat);
}