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 6 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,508
Total Committers: 41
Avg Commits per committer: 158.732
Development Distribution Score (DDS): 0.251

Commits in past year: 265
Committers in past year: 11
Avg Commits per committer in past year: 24.091
Development Distribution Score (DDS) in past year: 0.468

Name Email Commits
Steffen Vogel p****t@s****e 4876
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 154
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
Umar Farooq u****q@e****e 15
Jitpanu Maneeratpongsuk j****k@r****e 15
Hatim Kanchwala h****m@h****e 9
github-actions[bot] 4****] 8
Juan Pablo Noreña j****m@u****o 6
Marija Stevic m****c@e****e 6
Manuel p****t@c****e 6
Iris Marie Köster i****r@e****e 5
Calvin Katt c****t@r****e 5
Divya Laxetti d****i@r****e 5
Divya Rajashekhar Laxetti l****a@g****m 3
Felix Wege f****e@e****e 3
Daniel S. Katz d****z@i****g 3
Divya Laxetti d****i@1****e 2
Matthias Marcus Nowak m****k@r****e 2
Markus Mirz m****z@e****e 2
and 11 more...

Committer domains:


Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 707
Total pull requests: 472
Average time to close issues: almost 3 years
Average time to close pull requests: 19 days
Total issue authors: 14
Total pull request authors: 24
Average comments per issue: 3.33
Average comments per pull request: 1.42
Merged pull request: 370
Bot issues: 0
Bot pull requests: 8

Past year issues: 14
Past year pull requests: 81
Past year average time to close issues: about 2 months
Past year average time to close pull requests: 13 days
Past year issue authors: 6
Past year pull request authors: 14
Past year average comments per issue: 0.5
Past year average comments per pull request: 1.22
Past year merged pull request: 61
Past year bot issues: 0
Past year bot pull requests: 8

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

Top Issue Authors

  • stv0g (663)
  • pjungkamp (10)
  • al3xa23 (10)
  • n-eiling (4)
  • Puneetha-Ramachandra (4)
  • IgnoreWarnings (3)
  • michmx (3)
  • leonardocarreras (3)
  • bekiralti (2)
  • edoardo-dedin (1)
  • windrad6 (1)
  • morje-datta (1)
  • anarayan131 (1)
  • iripiri (1)

Top Pull Request Authors

  • stv0g (195)
  • pjungkamp (56)
  • n-eiling (52)
  • IgnoreWarnings (49)
  • al3xa23 (20)
  • leonardocarreras (18)
  • KeVteL (18)
  • JitpanuM (10)
  • windrad6 (9)
  • riteshk001 (9)
  • github-actions[bot] (8)
  • steffen-vogel-opalrt (5)
  • Hobbbbes (4)
  • pipeacosta (2)
  • SystemsPurge (2)

Top Issue Labels

  • gitlab merge request (304)
  • enhancement (62)
  • bug (46)
  • maintenance (19)
  • good first issue (18)
  • optimization (8)
  • node::websocket (7)
  • node::rtp (7)
  • node::mqtt (7)
  • node::webrtc (7)
  • node::socket (6)
  • tests (6)
  • node::iec61850 (6)
  • invalid (5)
  • node (5)
  • ci (5)
  • api (4)
  • stage:development (4)
  • node::amqp (4)
  • hooks (4)
  • priority::high (4)
  • stage::testing (4)
  • node::shmem (4)
  • wontfix (4)
  • refactor (4)
  • node::file (4)
  • node::modbus (3)
  • help wanted (3)
  • formats (3)
  • difficult (3)

Top Pull Request Labels

  • enhancement (26)
  • ci (16)
  • bug (13)
  • maintenance (12)
  • packaging (10)
  • node::fpga (9)
  • documentation (7)
  • autorelease: tagged (6)
  • node (6)
  • build-system (6)
  • node::iec61850 (6)
  • node::webrtc (5)
  • api (3)
  • refactor (3)
  • python (3)
  • hooks (3)
  • node::api (3)
  • node::opal (3)
  • nix (2)
  • node::internal-loopback (2)
  • formats (2)
  • node::mqtt (2)
  • node::file (2)
  • node::exec (2)
  • node::c37_118 (1)
  • node::c37-118 (1)
  • node::shmem (1)
  • tests (1)
  • node::kafka (1)
  • optimization (1)

Package metadata

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

  • Homepage:
  • Documentation: https://pkg.go.dev/github.com/villasframework/node#section-documentation
  • Licenses: apache-2.0
  • Latest release: v1.3.2 (published about 1 month ago)
  • Last Synced: 2026-10-20T23:04:44.283Z (1 day ago)
  • Versions: 38
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Rankings:
    • Dependent packages count: 5.395%
    • Average: 5.576%
    • Dependent repos count: 5.758%
proxy.golang.org: github.com/VILLASframework/node

  • Homepage:
  • Documentation: https://pkg.go.dev/github.com/VILLASframework/node#section-documentation
  • Licenses: apache-2.0
  • Latest release: v1.3.2 (published about 1 month ago)
  • Last Synced: 2026-10-20T23:05:18.817Z (1 day ago)
  • Versions: 38
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Rankings:
    • Dependent packages count: 5.395%
    • Average: 5.576%
    • Dependent repos count: 5.758%
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 11 months ago)
  • Last Synced: 2026-10-20T23:04:45.104Z (1 day ago)
  • Versions: 10
  • Dependent Packages: 0
  • Dependent Repositories: 3
  • Downloads: 108 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
.github/workflows/ci.yaml actions
.github/workflows/cleanup.yaml actions
  • dataaxiom/ghcr-cleanup-action v1 composite
.github/workflows/nix.yaml actions
  • actions/checkout v7 composite
  • cachix/install-nix-action v31 composite
  • ryanccn/attic-action v0 composite
.github/workflows/packaging-container.yaml actions
  • actions/checkout v7 composite
  • docker/build-push-action v7 composite
  • docker/login-action v4 composite
  • docker/setup-buildx-action v4 composite
.github/workflows/deploy-nix.yaml actions
  • actions/download-artifact v7 composite
  • docker/login-action v4 composite
  • docker/setup-buildx-action v4 composite
.github/workflows/build.yaml actions
  • actions/cache v6 composite
  • actions/checkout v7 composite
  • actions/upload-artifact v7 composite
.github/workflows/packaging-nix.yaml actions
  • actions/checkout v7 composite
  • actions/upload-artifact v7 composite
  • cachix/install-nix-action v31 composite
  • ryanccn/attic-action v0 composite
.github/workflows/checks.yaml actions
  • actions/checkout v7 composite
  • actions/upload-artifact v7 composite
  • fsfe/reuse-action v6 composite
.github/workflows/compliance.yaml actions
  • actions/checkout v7 composite
  • wagoid/commitlint-github-action v6 composite
.github/workflows/test.yaml actions
  • actions/cache/restore v6 composite
  • actions/checkout v7 composite
  • actions/download-artifact v7 composite
  • actions/upload-artifact v7 composite
  • redis 6.2 docker
  • rwthacs/rabbitmq * docker
.github/workflows/deploy.yaml actions
  • docker/login-action v4 composite
  • docker/setup-buildx-action v4 composite
.github/workflows/release-please.yaml actions
  • googleapis/release-please-action v4 composite
.github/workflows/prepare.yaml actions
  • actions/checkout v7 composite
  • docker/build-push-action v7 composite
  • docker/login-action v4 composite
  • docker/setup-buildx-action v4 composite
flake.nix nix
  • nixpkgs nixpkgs-unstable
packaging/archlinux/PKGBUILD alpm
  • libconfig * build
  • curl *
  • jansson *
  • libnl *
  • libpgm *
  • libwebsockets *
  • libxil *
  • nanomsg *
  • openssl *
  • protobuf *
  • zeromq *
flake.lock nix
  • nixpkgs 38a4887
python/pyproject.toml pypi
  • libconf ==2.0.1
  • linuxfd ==1.5; platform_system=="Linux"
  • protobuf ==6.32.1
.github/workflows/paper.yaml actions
  • actions/checkout v4 composite
  • actions/upload-artifact v4 composite
  • openjournals/openjournals-draft-action v1.0 composite

Score: 13.003647406699343