VILLASnode

Used in distributed- and co-simulation scenarios and developed for the field of power grid simulation at the EON Energy Research Center in Aachen.
https://github.com/villasframework/node

Category: Energy Systems
Sub Category: Grid Management and Microgrid

Keywords

co-simulation real-time simulation villas

Keywords from Contributors

dynamic-phasors electromagnetic-transient emt power-systems powerflow quasi-stationary operating-system maintained fiware-quantum-leap fiware-orion

Last synced: about 7 hours ago
JSON representation

Repository metadata

Open-Source Real-time Multi-protocol Gateway

README.md

VILLASnode

build status
status

This is VILLASnode, a gateway for processing and forwarding simulation data between real-time simulators.
VILLASnode is a client/server application to connect simulation equipment and software such as:

  • OPAL-RT RT-LAB,
  • RTDS GTFPGA cards,
  • RTDS GTWIF cards,
  • Simulink,
  • LabView,
  • and FPGA models

by using protocols such as:

  • IEEE 802.2 Ethernet / IP / UDP,
  • ZeroMQ & nanomsg,
  • MQTT & AMQP
  • WebSockets
  • Shared Memory
  • Files
  • IEC 61850 Sampled Values / GOOSE
  • Analog/Digital IO via Comedi drivers
  • Infiniband (ibverbs)

It's designed with a focus on very low latency to achieve real-time exchange of simulation data.
VILLASnode is used in distributed- and co-simulation scenarios and developed for the field of power grid simulation at the EON Energy Research Center in Aachen, Germany.

Documentation

User documentation is available here: https://villas.fein-aachen.org/docs/

Contributing

All contributions are welcome!
If you want to contribute to VILLASnode, please visit the contribution guidelines in our documentation.

License

VILLASnode is licensed on a per-file basis under multiple open-source licenses.
Each source file contains an SPDX license identifier and copyright attribution in accordance with the REUSE Software guidelines.
For attribution, please refer to the SPDX headers in each file.
The Apache 2.0 license covers most of the codebase and is preferred for new contributions.
License compliance is automatically checked in CI, including validation of licenses in the LICENSES/ directory.

We kindly ask all academic publications employing components of VILLASframework to cite the following paper:

  • S. Vogel, N. Eiling, M. Pitz, A. Bach, M. Stevic, and P. A. Monti, “VILLASnode: An Open-Source Real-time Multi-protocol Gateway,” Journal of Open Source Software, vol. 10, no. 112, p. 8401, Aug. 2025, doi: 10.21105/joss.08401.

More publications using, or about VILLASnode can be found in the documentation.

For other licensing options please consult Prof. Antonello Monti.

  • SPDX-FileCopyrightText: 2014-2025 The VILLASframework Authors
  • SPDX-License-Identifier: Apache-2.0

Contact

EONERC ACS Logo

Institute for Automation of Complex Power Systems (ACS)
EON Energy Research Center (EONERC)
RWTH University Aachen, Germany

Citation (CITATION.cff)

# SPDX-FileCopyrightText: 2025 OPAL-RT Germany GmbH
# SPDX-License-Identifier: Apache-2.0
cff-version: "1.2.0"
authors:
- family-names: Vogel
  given-names: Steffen
  orcid: "https://orcid.org/0000-0003-3384-6750"
- family-names: Eiling
  given-names: Niklas
  orcid: "https://orcid.org/0000-0002-7011-9846"
- family-names: Pitz
  given-names: Manuel
  orcid: "https://orcid.org/0000-0002-6252-2029"
- family-names: Bach
  given-names: Alexandra
  orcid: "https://orcid.org/0009-0005-7385-4642"
- family-names: Stevic
  given-names: Marija
- family-names: Monti
  given-names: Prof. Antonello
  orcid: "https://orcid.org/0000-0003-1914-9801"
doi: 10.5281/zenodo.16917994
message: If you use this software, please cite our article in the
  Journal of Open Source Software.
preferred-citation:
  authors:
  - family-names: Vogel
    given-names: Steffen
    orcid: "https://orcid.org/0000-0003-3384-6750"
  - family-names: Eiling
    given-names: Niklas
    orcid: "https://orcid.org/0000-0002-7011-9846"
  - family-names: Pitz
    given-names: Manuel
    orcid: "https://orcid.org/0000-0002-6252-2029"
  - family-names: Bach
    given-names: Alexandra
    orcid: "https://orcid.org/0009-0005-7385-4642"
  - family-names: Stevic
    given-names: Marija
  - family-names: Monti
    given-names: Prof. Antonello
    orcid: "https://orcid.org/0000-0003-1914-9801"
  date-published: 2025-08-29
  doi: 10.21105/joss.08401
  issn: 2475-9066
  issue: 112
  journal: Journal of Open Source Software
  publisher:
    name: Open Journals
  start: 8401
  title: "VILLASnode: An Open-Source Real-time Multi-protocol Gateway"
  type: article
  url: "https://joss.theoj.org/papers/10.21105/joss.08401"
  volume: 10
title: "VILLASnode: An Open-Source Real-time Multi-protocol Gateway"

Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 1 day ago

Total Commits: 6,423
Total Committers: 40
Avg Commits per committer: 160.575
Development Distribution Score (DDS): 0.248

Commits in past year: 253
Committers in past year: 11
Avg Commits per committer in past year: 23.0
Development Distribution Score (DDS) in past year: 0.502

Name Email Commits
Steffen Vogel p****t@s****e 4828
Niklas Eiling n****g@e****e 304
Manuel Pitz m****z@e****e 242
Daniel Krebs g****b@d****t 223
Dennis Potter d****s@d****u 169
Philipp Jungkamp p****p@r****e 129
Philipp Jungkamp P****p@o****m 109
Pascal Bauer p****r@r****e 107
Georg Reinke g****e@r****e 72
Sonja Happ s****p@e****e 48
Marvin Klimke m****e@r****e 30
Alexandra a****h@e****e 25
Leonardo Carreras l****s@e****e 22
Sonja Kolen s****n@e****e 18
Jitpanu Maneeratpongsuk j****k@r****e 15
Umar Farooq u****q@e****e 15
Hatim Kanchwala h****m@h****e 9
Juan Pablo Noreña-Monsalve j****m@u****o 6
Marija Stevic m****c@e****e 6
Iris Köster i****r@e****e 5
Divya Laxetti d****i@r****e 5
Calvin Katt c****t@r****e 5
Daniel S. Katz d****z@i****g 3
Felix Wege f****e@e****e 3
Divya Laxetti l****a@g****m 3
Divya Laxetti d****i@1****e 2
Matthias Marcus Nowak m****k@r****e 2
github-actions[bot] 4****] 2
Markus Mirz m****z@e****e 2
Calvin Katt k****n@g****m 2
and 10 more...

Committer domains:


Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 159
Total pull requests: 344
Average time to close issues: over 5 years
Average time to close pull requests: 20 days
Total issue authors: 12
Total pull request authors: 23
Average comments per issue: 3.86
Average comments per pull request: 1.57
Merged pull request: 237
Bot issues: 0
Bot pull requests: 2

Past year issues: 8
Past year pull requests: 51
Past year average time to close issues: 2 months
Past year average time to close pull requests: 20 days
Past year issue authors: 6
Past year pull request authors: 15
Past year average comments per issue: 0.63
Past year average comments per pull request: 2.06
Past year merged pull request: 25
Past year bot issues: 0
Past year bot pull requests: 2

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/villasframework/node

Top Issue Authors

  • stv0g (129)
  • al3xa23 (8)
  • n-eiling (4)
  • Puneetha-Ramachandra (4)
  • IgnoreWarnings (3)
  • michmx (3)
  • PJungkamp (2)
  • leonardocarreras (2)
  • morje-datta (1)
  • anarayan131 (1)
  • pjungkamp (1)
  • bekiralti (1)

Top Pull Request Authors

  • stv0g (126)
  • IgnoreWarnings (49)
  • n-eiling (49)
  • al3xa23 (20)
  • pjungkamp (20)
  • KeVteL (18)
  • leonardocarreras (14)
  • JitpanuM (10)
  • RiteshKarki27 (6)
  • steffen-vogel-opalrt (5)
  • riteshk001 (4)
  • PJungkamp (4)
  • windrad6 (3)
  • Hobbbbes (2)
  • pipeacosta (2)

Top Issue Labels

  • enhancement (34)
  • gitlab merge request (17)
  • bug (16)
  • maintenance (6)
  • node::websocket (6)
  • stage::testing (4)
  • stage:development (4)
  • good first issue (4)
  • node::file (4)
  • invalid (3)
  • refactor (3)
  • ci (3)
  • help wanted (3)
  • node::socket (3)
  • node::shmem (3)
  • stage::demo-integration (2)
  • tests (2)
  • node (2)
  • demo-webrtc (1)
  • node::stats (1)
  • documentation (1)
  • node::zeromq (1)
  • node::iec61850 (1)
  • reproducible (1)
  • node::redis (1)
  • formats (1)
  • node:ngsi (1)
  • python (1)
  • node::amqp (1)
  • hooks (1)

Top Pull Request Labels

  • enhancement (21)
  • maintenance (12)
  • ci (11)
  • bug (9)
  • packaging (9)
  • node::fpga (8)
  • build-system (6)
  • node::webrtc (4)
  • node (4)
  • documentation (4)
  • python (3)
  • node::iec61850 (3)
  • refactor (3)
  • formats (2)
  • node::api (2)
  • hooks (2)
  • node::opal (2)
  • api (2)
  • node::mqtt (2)
  • node::internal-loopback (2)
  • autorelease: tagged (2)
  • node::kafka (1)
  • node::exec (1)
  • node::test-rtt (1)
  • node::c37-118 (1)
  • node::file (1)
  • node::c37_118 (1)
  • node::fmi (1)
  • nix (1)
  • optimization (1)

Package metadata

proxy.golang.org: github.com/villasframework/node

proxy.golang.org: github.com/VILLASframework/node

pypi.org: villas-node

Python support for the VILLASnode simulation-data gateway

  • Homepage: https://villas.fein-aachen.org
  • Documentation: https://villas-node.readthedocs.io/
  • Licenses: apache-2.0
  • Latest release: 1.1.0 (published 8 months ago)
  • Last Synced: 2026-08-13T13:41:09.598Z (1 day ago)
  • Versions: 10
  • Dependent Packages: 0
  • Dependent Repositories: 3
  • Downloads: 738 Last month
  • Rankings:
    • Dependent repos count: 8.98%
    • Dependent packages count: 10.052%
    • Average: 15.277%
    • Downloads: 26.801%
  • Maintainers (3)

Dependencies

doc/package-lock.json npm
  • @redocly/ajv 8.6.4
  • @redocly/openapi-cli 1.0.0-beta.69
  • @redocly/openapi-core 1.0.0-beta.69
  • @types/glob 7.2.0
  • @types/minimatch 3.0.5
  • @types/node 14.17.33
  • ansi-regex 5.0.1
  • ansi-styles 4.3.0
  • anymatch 3.1.2
  • argparse 2.0.1
  • assert-node-version 1.0.3
  • async 2.6.3
  • balanced-match 1.0.2
  • binary-extensions 2.2.0
  • brace-expansion 1.1.11
  • braces 3.0.2
  • chokidar 3.5.2
  • cliui 7.0.4
  • color-convert 2.0.1
  • color-name 1.1.4
  • colorette 1.4.0
  • concat-map 0.0.1
  • debug 3.2.7
  • debug 4.3.2
  • emoji-regex 8.0.0
  • escalade 3.1.1
  • expected-node-version 1.0.2
  • fast-deep-equal 3.1.3
  • fill-range 7.0.1
  • fs.realpath 1.0.0
  • fsevents 2.3.2
  • get-caller-file 2.0.5
  • glob 7.2.0
  • glob-parent 5.1.2
  • glob-promise 3.4.0
  • handlebars 4.7.7
  • inflight 1.0.6
  • inherits 2.0.4
  • is-binary-path 2.1.0
  • is-extglob 2.1.1
  • is-fullwidth-code-point 3.0.0
  • is-glob 4.0.3
  • is-number 7.0.0
  • js-levenshtein 1.1.6
  • js-yaml 4.1.0
  • json-schema-traverse 1.0.0
  • lodash 4.17.21
  • lodash.isequal 4.5.0
  • minimatch 3.0.4
  • minimist 1.2.5
  • mkdirp 0.5.5
  • ms 2.1.2
  • ms 2.1.3
  • neo-async 2.6.2
  • node-fetch 2.6.6
  • normalize-path 3.0.0
  • once 1.4.0
  • path-is-absolute 1.0.1
  • picomatch 2.3.0
  • pluralize 8.0.0
  • portfinder 1.0.28
  • punycode 2.1.1
  • queue-microtask 1.2.3
  • randombytes 2.1.0
  • readable-stream 3.6.0
  • readdirp 3.6.0
  • require-directory 2.1.1
  • require-from-string 2.0.2
  • safe-buffer 5.2.1
  • semver 5.7.1
  • simple-websocket 9.1.0
  • source-map 0.6.1
  • string-width 4.2.3
  • string_decoder 1.3.0
  • strip-ansi 6.0.1
  • to-regex-range 5.0.1
  • tr46 0.0.3
  • uglify-js 3.14.3
  • uri-js 4.4.1
  • util-deprecate 1.0.2
  • webidl-conversions 3.0.1
  • whatwg-url 5.0.0
  • wordwrap 1.0.0
  • wrap-ansi 7.0.0
  • wrappy 1.0.2
  • ws 7.5.5
  • y18n 5.0.8
  • yaml-ast-parser 0.0.43
  • yargs 17.0.1
  • yargs-parser 20.2.9
doc/package.json npm
  • @redocly/openapi-cli ^1.0.0-beta.69
python/pyproject.toml pypi
  • libconf ==2.0.1
  • linuxfd ==1.5; platform_system=="Linux"
  • protobuf ==6.32.1
.github/workflows/mirror.yaml actions
  • actions/checkout v4 composite
  • yesolutions/mirror-action master composite
.github/workflows/paper.yaml actions
  • actions/checkout v4 composite
  • actions/upload-artifact v4 composite
  • openjournals/openjournals-draft-action v1.0 composite

Score: 14.833519982100285