{"id":50810570,"url":"https://github.com/fair-acc/gremlin","last_synced_at":"2026-06-13T04:07:39.054Z","repository":{"id":362204455,"uuid":"1242295332","full_name":"fair-acc/gremlin","owner":"fair-acc","description":"GREMLIN — GReen Energy Monitoring for Large INfrastructures","archived":false,"fork":false,"pushed_at":"2026-06-03T06:20:59.000Z","size":6969,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-03T06:22:41.362Z","etag":null,"topics":["anomaly-detection","emi","energy-monitoring","nilm","non-intrusive-load-monitoring","power-disaggregation","predictive-maintenance","rf-fingerprinting"],"latest_commit_sha":null,"homepage":"https://fair-acc.github.io/gremlin","language":"HTML","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fair-acc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":".zenodo.json","notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-18T09:47:58.000Z","updated_at":"2026-06-03T06:21:02.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/fair-acc/gremlin","commit_stats":null,"previous_names":["fair-acc/gremlin"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/fair-acc/gremlin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fair-acc%2Fgremlin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fair-acc%2Fgremlin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fair-acc%2Fgremlin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fair-acc%2Fgremlin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fair-acc","download_url":"https://codeload.github.com/fair-acc/gremlin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fair-acc%2Fgremlin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34271568,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-13T02:00:06.617Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["anomaly-detection","emi","energy-monitoring","nilm","non-intrusive-load-monitoring","power-disaggregation","predictive-maintenance","rf-fingerprinting"],"created_at":"2026-06-13T04:07:38.133Z","updated_at":"2026-06-13T04:07:39.049Z","avatar_url":"https://github.com/fair-acc.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"## GREMLIN\u003cbr\u003e— GReen Energy Monitoring for Large INfrastructure\n\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.20520246.svg)](https://doi.org/10.5281/zenodo.20520246)\n[![Code: LGPL-3.0+linking-exception](https://img.shields.io/badge/code-LGPL--3.0%2Blinking--exception-blue.svg)](LICENSES/LGPL-3.0-or-later.txt)\n[![Docs: CC-BY-SA-4.0](https://img.shields.io/badge/docs-CC--BY--SA--4.0-lightgrey.svg)](LICENSES/CC-BY-SA-4.0.txt)\n[![EU Horizon Europe — iRIS 101275935](https://img.shields.io/badge/EU%20Horizon%20Europe-iRIS%20101275935-003399.svg)](https://ec.europa.eu/info/funding-tenders/opportunities/portal/screen/opportunities/projects-details/43108390/101275935/HORIZON)\n[![Pages](https://github.com/fair-acc/gremlin/actions/workflows/pages.yml/badge.svg)](https://github.com/fair-acc/gremlin/actions/workflows/pages.yml)\n\nA non-intrusive, facility-scale diagnostic layer that turns the electromagnetic noise every electrical device emits into actionable\ninformation — where energy is used, and which equipment is degrading — from a single or few high-bandwidth measurement points instead \nof per-device instrumentation.\n\n\u003cdiv align=\"center\"\u003e\n\u003cpicture\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"docs/img/GREMLIN_dark.png\"\u003e\n  \u003cimg src=\"docs/img/GREMLIN.png\" alt=\"GREMLIN — GReen Energy Monitoring for Large INfrastructure\" width=\"75%\"\u003e\n\u003c/picture\u003e\n\u003c/div\u003e\n\n## Motivation\n\nAny modern accelerator or large scale infrastructure complex contains tens of thousands of individually-powered devices \n— magnet power converters, RF amplifiers, cryogenic plant, water cooling, beam diagnostics, IT infrastructure, and \nconventional facility loads — each with its own electrical signature and drift toward end-of-life. Instrumenting every \ndevice is neither economical nor sustainable, leaving both the operational energy footprint and the early signs of \nimpending equipment failure largely invisible.\n\nGREMLIN tackles both — per-device energy accounting *and* the small *gremlins* (drifts, harmonics, switching anomalies that precede hard\nfaults, enabling preventative maintenance scheduling) — through a single technical approach: software-defined-radio-grade signal\nprocessing on the open-source [GNU Radio 4.0](https://github.com/fair-acc/gnuradio4) platform, applied to non-intrusive load monitoring.\nThe approach is sized for the operational energy footprint, availability, and life-cycle sustainability of FAIR- and FCC-scale infrastructure.\n\n## How it works\n\nAny switching electrical device emits a characteristic electromagnetic-interference (EMI) signature — switching frequencies, harmonics and transients that depend on the device type and its operating state.\nConducted EMI travels along the facility's mains wiring with low attenuation (a few dB per hundred metres), so a single high-bandwidth sensor at an upstream feed point sees many devices' signatures superimposed; because each is distinct, the superposition can be *disaggregated*.\n\nGREMLIN couples this single-point sensing with non-intrusive load monitoring (NILM) and a learned classifier, *benchmarked against classical methods* on controlled ground truth — so results are cross-checked, not taken on trust.\nIt is a *diagnostic layer, not an energy controller*: it surfaces where action is warranted; operators and existing control systems decide and act.\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg width=\"75%\" src=\"docs/photos/gremlin_pulsedpower_spectrogram.png\" alt=\"PulsedPowerDemo current-spectrum spectrogram\"\u003e\n\u003c/div\u003e\n\nFor full documentation see: [https://fair-acc.github.io/gremlin/](https://fair-acc.github.io/gremlin/)\n\n## What it provides\n\n - **Energy footprint** — disaggregate consumption to show where power actually goes, including non-essential loads and efficiency drift in ageing converters.\n - **Availability** — catch device degradation early for proactive, grouped maintenance instead of reactive, single-point-failure response.\n - **Unaccounted-for loads** — power drawn on the network that matches no known device signature.\n - **Grid / regulatory compliance** — stay within the network operator's emission and power tolerances.\n\n\u003e Quantified energy and cost benefits are an iRIS deliverable set by detection performance — projected mechanisms, **not yet measured values**.\n\n## Ecosystem \u0026 Reproducibility\n\nGREMLIN is developed as free / open hardware and software by GSI/FAIR; reproducibility and industrial or private applicability are explicit project goals. \nIt builds on the FAIR-ACC open stack, with models exchanged in the portable **ONNX** format.\n\n| Repository | Purpose |\n| --- | --- |\n| **gremlin** (this repo) | GREMLIN documentation, models, demonstrations |\n| [pulsed-power-ml](https://github.com/fair-acc/pulsed-power-ml) | Pulsed-power PoC and electrical-network-compliance work |\n| [gnuradio4](https://github.com/fair-acc/gnuradio4) | GNU Radio 4 signal-processing runtime (GR4) |\n| [gr-digitizers](https://github.com/fair-acc/gr-digitizers) | DAQ / digitiser integration |\n| [opendigitizer](https://github.com/fair-acc/opendigitizer) | UI / UX |\n\n## License and Copyright\n\nUnless otherwise noted:\u003cbr\u003e\n`SPDX-License-Identifier: LGPL-3.0-or-later WITH LGPL-3.0-linking-exception` \u0026\u003cbr\u003e\n`SPDX-License-Identifier: CC-BY-SA-4.0`\n\nCopyright © GSI Helmholtz Centre for Heavy Ion Research, Darmstadt, Germany\u003cbr\u003e\nCopyright © FAIR — Facility for Antiproton and Ion Research in Europe, Darmstadt, Germany\n\n## Funding \u0026 Acknowledgements\n\n\u003ctable class=\"eu-funding\" border=\"1\" cellpadding=\"12\" cellspacing=\"0\" style=\"background-color: #ffffff; color: #1a1a1a; border-color: #cccccc;\"\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\" valign=\"middle\" width=\"120\" bgcolor=\"#ffffff\" style=\"background-color: #ffffff;\"\u003e\n      \u003cimg src=\"docs/img/Flag_of_Europe.svg\" alt=\"European Union flag\" width=\"96\"\u003e\n    \u003c/td\u003e\n    \u003ctd valign=\"middle\" bgcolor=\"#ffffff\" style=\"background-color: #ffffff; color: #1a1a1a;\"\u003e\n      This project has received funding from the European Union's Horizon\n      Europe research and innovation programme under grant agreement\n      No. \u003ca href=\"https://ec.europa.eu/info/funding-tenders/opportunities/portal/screen/opportunities/projects-details/43108390/101275935/HORIZON\" target=\"_blank\" style=\"color: #003399;\"\u003e101275935\u003c/a\u003e\u003cbr\u003e(\u003ca href=\"https://zenodo.org/communities/101275935/\" target=\"_blank\" style=\"color: #003399;\"\u003eiRIS – Intelligent Research Infrastructure\n      Sustainability\u003c/a\u003e).\u003cbr\u003e\u003cspan style=\"font-size: 8pt;\"\u003eViews and opinions expressed are however those of the author(s) only and do not necessarily reflect those of the European Union or the granting authority. Neither the European Union nor the granting authority can be held responsible for them.\u003c/span\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\nGREMLIN is developed at **GSI and FAIR**, Darmstadt, with contributions from iRIS partners. \nIt builds on the [GNU Radio 4.0](https://github.com/fair-acc/gnuradio4) streaming signal-processing framework and reuses domain knowledge from [`fair-acc/pulsed-power-ml`](https://github.com/fair-acc/pulsed-power-ml).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffair-acc%2Fgremlin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffair-acc%2Fgremlin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffair-acc%2Fgremlin/lists"}