mirror of
https://git.undefined-dev.fr/Blendman974/faceclaw.git
synced 2026-11-19 21:03:09 +00:00
Add a prototype nightscout "missed bolus" detector
This commit is contained in:
1 parent
f6201d8e41
commit
00c36602d6
13 files changed
+997
-61
No files matched your search
@@ -0,0 +1,157 @@
|
||||
#!/usr/bin/env node
|
||||
// Replays the missed-bolus detector (app/apps/nightscout/missed-bolus-detector.ts)
|
||||
// over recorded Nightscout history, as if it had run after every CGM reading
|
||||
// with the app's cooldown, and lists where it would have alerted next to the
|
||||
// meal boluses around them. For tuning the detector without the glasses.
|
||||
//
|
||||
// node scripts/nightscout-missed-bolus-replay.cjs --site https://x.herokuapp.com --token TOKEN --days 14
|
||||
// node scripts/nightscout-missed-bolus-replay.cjs --site ... --token ... --days 30 --save /tmp/ns
|
||||
// node scripts/nightscout-missed-bolus-replay.cjs --load /tmp/ns --set minRiseMgdl=50 --set minRateMgdlPerMin=2
|
||||
//
|
||||
// --site/--token default to $NIGHTSCOUT_URL/$NIGHTSCOUT_TOKEN. --save writes
|
||||
// the fetched entries.json/treatments.json to a directory; --load replays a
|
||||
// saved directory instead of fetching. --set overrides one detector option
|
||||
// (see MissedBolusOptions); --cooldown-min sets the alert cooldown (default
|
||||
// 120, the app's default); --verbose also prints every classification change.
|
||||
|
||||
const fs = require('node:fs');
|
||||
const path = require('node:path');
|
||||
const vm = require('node:vm');
|
||||
const ts = require('typescript');
|
||||
|
||||
const DETECTOR = path.join(__dirname, '../app/apps/nightscout/missed-bolus-detector.ts');
|
||||
// Matches the bridge's history window: the detector looks back 90 min, plus slack.
|
||||
const HISTORY_WINDOW_MS = 3 * 60 * 60_000;
|
||||
// The app sees a reading at the next minutely sync after its upload.
|
||||
const SYNC_LAG_MS = 60_000;
|
||||
// A meal bolus this soon after an alert counts as the alert being answered.
|
||||
const ANSWER_WINDOW_MS = 3 * 60 * 60_000;
|
||||
|
||||
function loadDetector() {
|
||||
const source = ts.transpileModule(fs.readFileSync(DETECTOR, 'utf8'), {
|
||||
compilerOptions: { module: ts.ModuleKind.CommonJS, target: ts.ScriptTarget.ES2020 },
|
||||
}).outputText;
|
||||
const exports = {};
|
||||
vm.runInNewContext(source, { exports }, { filename: DETECTOR });
|
||||
return exports;
|
||||
}
|
||||
|
||||
function parseArgs(argv) {
|
||||
const args = { site: process.env.NIGHTSCOUT_URL ?? '', token: process.env.NIGHTSCOUT_TOKEN ?? '', days: 14, cooldownMin: 120, set: {}, verbose: false };
|
||||
for (let i = 0; i < argv.length; i++) {
|
||||
const flag = argv[i];
|
||||
const value = () => {
|
||||
if (i + 1 >= argv.length) throw new Error(`${flag} needs a value`);
|
||||
return argv[++i];
|
||||
};
|
||||
if (flag === '--site') args.site = value().replace(/\/+$/, '');
|
||||
else if (flag === '--token') args.token = value();
|
||||
else if (flag === '--days') args.days = Number(value());
|
||||
else if (flag === '--save') args.save = value();
|
||||
else if (flag === '--load') args.load = value();
|
||||
else if (flag === '--cooldown-min') args.cooldownMin = Number(value());
|
||||
else if (flag === '--verbose') args.verbose = true;
|
||||
else if (flag === '--set') {
|
||||
const [key, raw] = value().split('=');
|
||||
args.set[key] = raw === 'true' ? true : raw === 'false' ? false : Number(raw);
|
||||
} else throw new Error(`unknown argument ${flag}`);
|
||||
}
|
||||
return args;
|
||||
}
|
||||
|
||||
async function fetchJson(url) {
|
||||
const response = await fetch(url);
|
||||
if (!response.ok) throw new Error(`HTTP ${response.status} for ${url.replace(/token=[^&]*/, 'token=...')}`);
|
||||
return response.json();
|
||||
}
|
||||
|
||||
async function loadHistory(args) {
|
||||
if (args.load) {
|
||||
return {
|
||||
entries: JSON.parse(fs.readFileSync(path.join(args.load, 'entries.json'), 'utf8')),
|
||||
treatments: JSON.parse(fs.readFileSync(path.join(args.load, 'treatments.json'), 'utf8')),
|
||||
};
|
||||
}
|
||||
if (!args.site || !args.token) throw new Error('need --site and --token (or $NIGHTSCOUT_URL/$NIGHTSCOUT_TOKEN), or --load');
|
||||
const startMs = Date.now() - args.days * 86_400_000;
|
||||
const token = `token=${encodeURIComponent(args.token)}`;
|
||||
// Room for 1-minute CGMs; Nightscout otherwise caps a query at 10 results.
|
||||
const count = Math.ceil(args.days * 1440 * 1.1);
|
||||
const [entries, treatments] = await Promise.all([
|
||||
fetchJson(`${args.site}/api/v1/entries/sgv.json?find%5Bdate%5D%5B%24gte%5D=${startMs}&count=${count}&${token}`),
|
||||
fetchJson(`${args.site}/api/v1/treatments.json?find%5Bcreated_at%5D%5B%24gte%5D=${encodeURIComponent(new Date(startMs).toISOString())}&count=${count}&${token}`),
|
||||
]);
|
||||
if (args.save) {
|
||||
fs.mkdirSync(args.save, { recursive: true });
|
||||
fs.writeFileSync(path.join(args.save, 'entries.json'), JSON.stringify(entries));
|
||||
fs.writeFileSync(path.join(args.save, 'treatments.json'), JSON.stringify(treatments));
|
||||
}
|
||||
return { entries, treatments };
|
||||
}
|
||||
|
||||
function formatTime(ms) {
|
||||
const date = new Date(ms);
|
||||
const pad = (n) => String(n).padStart(2, '0');
|
||||
return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}`;
|
||||
}
|
||||
|
||||
function minutes(ms) {
|
||||
return `${Math.round(ms / 60_000)} min`;
|
||||
}
|
||||
|
||||
async function main() {
|
||||
const args = parseArgs(process.argv.slice(2));
|
||||
const detector = loadDetector();
|
||||
for (const key of Object.keys(args.set)) {
|
||||
if (!(key in detector.DEFAULT_MISSED_BOLUS_OPTIONS)) throw new Error(`unknown detector option ${key}`);
|
||||
}
|
||||
const { entries, treatments } = await loadHistory(args);
|
||||
const glucose = detector.normalizeNightscoutEntries(entries);
|
||||
const { boluses, carbs } = detector.normalizeNightscoutTreatments(treatments);
|
||||
const mealBoluses = boluses.filter((bolus) => bolus.kind === 'meal');
|
||||
if (!glucose.length) throw new Error('no glucose entries');
|
||||
|
||||
const cooldownMs = args.cooldownMin * 60_000;
|
||||
const alerts = [];
|
||||
let lastAlertMs = -Infinity;
|
||||
let lastSummary = '';
|
||||
let first = 0;
|
||||
for (const reading of glucose) {
|
||||
const nowMs = reading.timeMs + SYNC_LAG_MS;
|
||||
while (glucose[first].timeMs < nowMs - HISTORY_WINDOW_MS) first++;
|
||||
const inWindow = (event) => event.timeMs >= nowMs - HISTORY_WINDOW_MS && event.timeMs <= nowMs;
|
||||
const result = detector.detectMissedBolus({
|
||||
nowMs,
|
||||
glucose: glucose.slice(first).filter((r) => r.timeMs <= nowMs),
|
||||
boluses: boluses.filter(inWindow),
|
||||
carbs: carbs.filter(inWindow),
|
||||
}, args.set);
|
||||
const summary = `${result.classification}: ${result.reason}`;
|
||||
if (args.verbose && summary !== lastSummary) console.log(` ${formatTime(nowMs)} ${reading.mgdl} ${summary}`);
|
||||
lastSummary = summary;
|
||||
if (result.classification !== 'missed-bolus' || nowMs - lastAlertMs < cooldownMs) continue;
|
||||
lastAlertMs = nowMs;
|
||||
alerts.push({ nowMs, result });
|
||||
}
|
||||
|
||||
const spanDays = (glucose[glucose.length - 1].timeMs - glucose[0].timeMs) / 86_400_000;
|
||||
console.log(`${glucose.length} readings over ${spanDays.toFixed(1)} days; ${mealBoluses.length} meal boluses; ${boluses.filter((b) => b.kind === 'ambiguous').length} unmarked boluses (max ${Math.max(0, ...boluses.filter((b) => b.kind === 'ambiguous').map((b) => b.units))} U)`);
|
||||
console.log(`options: ${JSON.stringify({ ...detector.DEFAULT_MISSED_BOLUS_OPTIONS, ...args.set })}`);
|
||||
console.log(`\n${alerts.length} alerts (${(alerts.length / Math.max(spanDays, 1 / 24)).toFixed(2)}/day, cooldown ${args.cooldownMin} min):`);
|
||||
for (const { nowMs, result } of alerts) {
|
||||
const answer = mealBoluses.find((bolus) => bolus.timeMs > nowMs && bolus.timeMs - nowMs <= ANSWER_WINDOW_MS);
|
||||
const note = answer ? `meal bolus ${answer.units} U ${minutes(answer.timeMs - nowMs)} later` : 'no meal bolus within 3 h';
|
||||
console.log(` ${formatTime(nowMs)} ${result.rise.latestMgdl} mg/dL ${result.reason} [${note}]`);
|
||||
}
|
||||
console.log('\nmeal boluses:');
|
||||
for (const bolus of mealBoluses) {
|
||||
const alert = alerts.find(({ nowMs }) => nowMs < bolus.timeMs && bolus.timeMs - nowMs <= ANSWER_WINDOW_MS);
|
||||
const meal = carbs.find((entry) => entry.timeMs === bolus.timeMs);
|
||||
console.log(` ${formatTime(bolus.timeMs)} ${bolus.units} U${meal ? ` ${meal.grams} g` : ''}${alert ? ` [alerted ${minutes(bolus.timeMs - alert.nowMs)} before]` : ''}`);
|
||||
}
|
||||
}
|
||||
|
||||
main().catch((error) => {
|
||||
console.error(error.message ?? error);
|
||||
process.exit(1);
|
||||
});
|
||||
Reference in new issue
Block a user