From 6e993f306247db8af566d2589b756b5b6f22ae0f Mon Sep 17 00:00:00 2001
From: piconem <piconem@users.noreply.github.com>
Date: Fri, 9 Feb 2024 12:03:22 +0000
Subject: [PATCH] deploy: ab5a164de259055162e9420d8cb56c2b1562dee9

---
 404.html                                      |   2 +-
 blog/example-post/index.html                  |   2 +-
 blog/index.html                               |   2 +-
 blog/sitemap.xml                              |   2 +-
 categories/index.html                         |   2 +-
 contributors/index.html                       |   2 +-
 docs/adapters/http-digital-adapter/index.html |  71 +++++
 docs/adapters/index.html                      |  11 +
 docs/adapters/index.xml                       |   2 +
 docs/adapters/mqtt-digital-adapter/index.html |  59 ++++
 .../adapters/mqtt-physical-adapter/index.html |  82 ++++++
 docs/adapters/page/1/index.html               |   1 +
 docs/adapters/sitemap.xml                     |   1 +
 docs/change-logs/change-log-0.3.0/index.html  | 239 +++++++++++++++
 docs/{reference => change-logs}/index.html    |  12 +-
 docs/change-logs/index.xml                    |   1 +
 docs/change-logs/page/1/index.html            |   1 +
 docs/{reference => change-logs}/sitemap.xml   |   2 +-
 docs/guides/configurable-adapters/index.html  | 237 +++++++++++++++
 docs/guides/digital-actions/index.html        |  75 +++++
 docs/guides/digital-adapter/index.html        | 193 ++++++++++++
 docs/guides/dt-engine-dt-instance/index.html  |  91 ++++++
 docs/guides/example-guide/index.html          |  11 -
 docs/guides/index.html                        |  12 +-
 docs/guides/index.xml                         |   2 +-
 docs/guides/physical-adapter/index.html       | 261 +++++++++++++++++
 docs/guides/shadowing-function/index.html     | 277 ++++++++++++++++++
 docs/guides/sitemap.xml                       |   2 +-
 docs/index.html                               |  12 +-
 docs/introduction/dt-life-cycle/index.html    |  46 +++
 docs/introduction/dt-model/index.html         |  47 +++
 docs/introduction/index.html                  |  11 +
 docs/introduction/index.xml                   |   1 +
 .../index.html                                |  82 ++++++
 docs/introduction/page/1/index.html           |   1 +
 docs/introduction/sitemap.xml                 |   1 +
 docs/reference/example-reference/index.html   |  11 -
 docs/reference/index.xml                      |   1 -
 docs/reference/page/1/index.html              |   1 -
 docs/sitemap.xml                              |   2 +-
 en/sitemap.xml                                |   2 +-
 index.html                                    |   4 +-
 index.xml                                     |   3 +-
 logo.png                                      | Bin 120563 -> 51934 bytes
 ...e3bb6524ba2_120563_1024x0_resize_box_3.png | Bin 92114 -> 0 bytes
 ...ba2_120563_1024x0_resize_q75_h2_box_3.webp | Bin 34900 -> 0 bytes
 ...e3bb6524ba2_120563_1061x0_resize_box_3.png | Bin 95399 -> 0 bytes
 ...ba2_120563_1061x0_resize_q75_h2_box_3.webp | Bin 36950 -> 0 bytes
 ...4e3bb6524ba2_120563_480x0_resize_box_3.png | Bin 40103 -> 0 bytes
 ...4ba2_120563_480x0_resize_q75_h2_box_3.webp | Bin 16524 -> 0 bytes
 ...4e3bb6524ba2_120563_640x0_resize_box_3.png | Bin 55205 -> 0 bytes
 ...4ba2_120563_640x0_resize_q75_h2_box_3.webp | Bin 21434 -> 0 bytes
 ...4e3bb6524ba2_120563_768x0_resize_box_3.png | Bin 68180 -> 0 bytes
 ...4ba2_120563_768x0_resize_q75_h2_box_3.webp | Bin 26088 -> 0 bytes
 ...2cdcbc39c3706ed41ad7f1a620b9281013866c.css |   2 +-
 page/2/index.html                             |   7 +
 privacy/index.html                            |   2 +-
 search-index.json                             |   2 +-
 sitemap.xml                                   |   2 +-
 tags/index.html                               |   2 +-
 60 files changed, 1839 insertions(+), 58 deletions(-)
 create mode 100644 docs/adapters/http-digital-adapter/index.html
 create mode 100644 docs/adapters/index.html
 create mode 100644 docs/adapters/index.xml
 create mode 100644 docs/adapters/mqtt-digital-adapter/index.html
 create mode 100644 docs/adapters/mqtt-physical-adapter/index.html
 create mode 100644 docs/adapters/page/1/index.html
 create mode 100644 docs/adapters/sitemap.xml
 create mode 100644 docs/change-logs/change-log-0.3.0/index.html
 rename docs/{reference => change-logs}/index.html (51%)
 create mode 100644 docs/change-logs/index.xml
 create mode 100644 docs/change-logs/page/1/index.html
 rename docs/{reference => change-logs}/sitemap.xml (55%)
 create mode 100644 docs/guides/configurable-adapters/index.html
 create mode 100644 docs/guides/digital-actions/index.html
 create mode 100644 docs/guides/digital-adapter/index.html
 create mode 100644 docs/guides/dt-engine-dt-instance/index.html
 delete mode 100644 docs/guides/example-guide/index.html
 create mode 100644 docs/guides/physical-adapter/index.html
 create mode 100644 docs/guides/shadowing-function/index.html
 create mode 100644 docs/introduction/dt-life-cycle/index.html
 create mode 100644 docs/introduction/dt-model/index.html
 create mode 100644 docs/introduction/index.html
 create mode 100644 docs/introduction/index.xml
 create mode 100644 docs/introduction/library-structure-basic-concepts/index.html
 create mode 100644 docs/introduction/page/1/index.html
 create mode 100644 docs/introduction/sitemap.xml
 delete mode 100644 docs/reference/example-reference/index.html
 delete mode 100644 docs/reference/index.xml
 delete mode 100644 docs/reference/page/1/index.html
 delete mode 100644 logo_hu30be7725a70675d228614e3bb6524ba2_120563_1024x0_resize_box_3.png
 delete mode 100644 logo_hu30be7725a70675d228614e3bb6524ba2_120563_1024x0_resize_q75_h2_box_3.webp
 delete mode 100644 logo_hu30be7725a70675d228614e3bb6524ba2_120563_1061x0_resize_box_3.png
 delete mode 100644 logo_hu30be7725a70675d228614e3bb6524ba2_120563_1061x0_resize_q75_h2_box_3.webp
 delete mode 100644 logo_hu30be7725a70675d228614e3bb6524ba2_120563_480x0_resize_box_3.png
 delete mode 100644 logo_hu30be7725a70675d228614e3bb6524ba2_120563_480x0_resize_q75_h2_box_3.webp
 delete mode 100644 logo_hu30be7725a70675d228614e3bb6524ba2_120563_640x0_resize_box_3.png
 delete mode 100644 logo_hu30be7725a70675d228614e3bb6524ba2_120563_640x0_resize_q75_h2_box_3.webp
 delete mode 100644 logo_hu30be7725a70675d228614e3bb6524ba2_120563_768x0_resize_box_3.png
 delete mode 100644 logo_hu30be7725a70675d228614e3bb6524ba2_120563_768x0_resize_q75_h2_box_3.webp
 rename main.5d6e5440c13f1c45183e82bbb906165564d1edfd71498c4a2c38775086796022bfab9cfb137199a537d8e42c2fb6ce2ab74b69461aed15b7389bd0e12ec63b19.css => main.5fb433a44687c98f7ae7b3d0137c762777049ba27235e1f08c279c03c8533a7a9a1e3b0ef5b125a31b6bb63a362cdcbc39c3706ed41ad7f1a620b9281013866c.css (93%)
 create mode 100644 page/2/index.html

diff --git a/404.html b/404.html
index 48fa9df..cb90024 100644
--- a/404.html
+++ b/404.html
@@ -1,5 +1,5 @@
 <!doctype html><html lang=en data-bs-theme=auto><head><meta charset=utf-8><meta http-equiv=x-ua-compatible content="ie=edge"><meta name=viewport content="width=device-width,initial-scale=1"><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-regular.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-500.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-700.woff2 type=font/woff2 crossorigin><script src=https://wldt.github.io/js/color-mode.86a91f050a481d0a3f0c72ac26543cb6228c770875981c58dcbc008fd3f875c8.js integrity="sha256-hqkfBQpIHQo/DHKsJlQ8tiKMdwh1mBxY3LwAj9P4dcg="></script>
-<link rel=stylesheet href=https://wldt.github.io/main.5d6e5440c13f1c45183e82bbb906165564d1edfd71498c4a2c38775086796022bfab9cfb137199a537d8e42c2fb6ce2ab74b69461aed15b7389bd0e12ec63b19.css integrity="sha512-XW5UQME/HEUYPoK7uQYWVWTR7f1xSYxKLDh3UIZ5YCK/q5z7E3GZpTfY5Cwvts4qt0tpRhrtFbc4m9DhLsY7GQ==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>404 Page not found | WLDT</title><meta property="canonical" content="https://wldt.github.io/404.html"><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/404.html"><meta property="og:title" content="404 Page not found"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:see_also" content="https://wldt.github.io/privacy/"><meta name=twitter:card content="summary"><meta name=twitter:title content="404 Page not found"><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","name":"404 Page not found","position":2}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="single error404" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
+<link rel=stylesheet href=https://wldt.github.io/main.5fb433a44687c98f7ae7b3d0137c762777049ba27235e1f08c279c03c8533a7a9a1e3b0ef5b125a31b6bb63a362cdcbc39c3706ed41ad7f1a620b9281013866c.css integrity="sha512-X7QzpEaHyY9657PQE3x2J3cEm6JyNeHwjCecA8hTOnqaHjsO9bEloxtrtjo2LNy8OcNwbtQa1/GmILkoEBOGbA==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>404 Page not found | WLDT</title><meta property="canonical" content="https://wldt.github.io/404.html"><meta property="next" content="https://wldt.github.io/404.html/page/2/"><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/404.html"><meta property="og:title" content="404 Page not found"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:see_also" content="https://wldt.github.io/privacy/"><meta name=twitter:card content="summary"><meta name=twitter:title content="404 Page not found"><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","name":"404 Page not found","position":2}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="single error404" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
 <button type=button id=searchToggleMobile class="btn btn-link nav-link mx-2 d-lg-none" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
 <button class="btn btn-link nav-link mx-2 order-3 d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavMain aria-controls=offcanvasNavMain aria-label="Open main navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-menu" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><line x1="4" y1="8" x2="20" y2="8"/><line x1="4" y1="16" x2="20" y2="16"/></svg></button><div class="offcanvas offcanvas-end h-auto" tabindex=-1 id=offcanvasNavMain aria-labelledby=offcanvasNavMainLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavMainLabel>WLDT</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class="offcanvas-body d-flex flex-column flex-lg-row justify-content-between"><ul class="navbar-nav flex-grow-1"><li class=nav-item><a class=nav-link href=https://wldt.github.io/docs/guides/example-guide/>Documentation</a></li><li class=nav-item><a class=nav-link href=https://wldt.github.io/blog/>Blog</a></li></ul><button type=button id=searchToggleDesktop class="btn btn-link nav-link p-2 d-none d-lg-block" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
 <button id=buttonColorMode class="btn btn-link mx-auto nav-link p-0 ms-lg-2 me-lg-1" type=button aria-label="Toggle theme"><svg data-bs-theme-value="dark" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-moon" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 3c.132.0.263.0.393.0a7.5 7.5.0 007.92 12.446A9 9 0 1112 2.992z"/></svg><svg data-bs-theme-value="light" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-sun" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-4 0a4 4 0 108 0 4 4 0 10-8 0m-5 0h1m8-9v1m8 8h1m-9 8v1M5.6 5.6l.7.7m12.1-.7-.7.7m0 11.4.7.7m-12.1-.7-.7.7"/></svg></button><ul id=socialMenu class="nav mx-auto flex-row order-lg-4"><li class=nav-item><a class="nav-link social-link" href=https://github.com/wldt><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-brand-github" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 19c-4.3 1.4-4.3-2.5-6-3m12 5v-3.5c0-1 .1-1.4-.5-2 2.8-.3 5.5-1.4 5.5-6a4.6 4.6.0 00-1.3-3.2 4.2 4.2.0 00-.1-3.2s-1.1-.3-3.5 1.3a12.3 12.3.0 00-6.2.0C6.5 2.8 5.4 3.1 5.4 3.1a4.2 4.2.0 00-.1 3.2A4.6 4.6.0 004 9.5c0 4.6 2.7 5.7 5.5 6-.6.6-.6 1.2-.5 2V21"/></svg><small class="ms-2 visually-hidden">GitHub</small></a></li></ul></div></div></div></header></div><div class=modal id=searchModal tabindex=-1 aria-labelledby=searchModalLabel aria-hidden=true><div class="modal-dialog modal-dialog-scrollable modal-fullscreen-md-down"><div class=modal-content><div class=modal-header><h1 class="modal-title fs-5 visually-hidden" id=searchModalLabel>Search</h1><button type=button class="btn-close visually-hidden" data-bs-dismiss=modal aria-label=Close></button><div class="search-input flex-grow-1 d-none"><form id=search-form class=search-form action=# method=post accept-charset=utf-8 role=search><label for=query class=visually-hidden>Search</label><div class=d-flex><input type=search id=query name=query class="search-text form-control form-control-lg" placeholder=Search aria-label=Search maxlength=128 autocomplete=off>
diff --git a/blog/example-post/index.html b/blog/example-post/index.html
index ece2abd..a8e39ad 100644
--- a/blog/example-post/index.html
+++ b/blog/example-post/index.html
@@ -1,5 +1,5 @@
 <!doctype html><html lang=en data-bs-theme=auto><head><meta charset=utf-8><meta http-equiv=x-ua-compatible content="ie=edge"><meta name=viewport content="width=device-width,initial-scale=1"><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-regular.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-500.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-700.woff2 type=font/woff2 crossorigin><script src=https://wldt.github.io/js/color-mode.86a91f050a481d0a3f0c72ac26543cb6228c770875981c58dcbc008fd3f875c8.js integrity="sha256-hqkfBQpIHQo/DHKsJlQ8tiKMdwh1mBxY3LwAj9P4dcg="></script>
-<link rel=stylesheet href=https://wldt.github.io/main.5d6e5440c13f1c45183e82bbb906165564d1edfd71498c4a2c38775086796022bfab9cfb137199a537d8e42c2fb6ce2ab74b69461aed15b7389bd0e12ec63b19.css integrity="sha512-XW5UQME/HEUYPoK7uQYWVWTR7f1xSYxKLDh3UIZ5YCK/q5z7E3GZpTfY5Cwvts4qt0tpRhrtFbc4m9DhLsY7GQ==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>Example Post | WLDT</title><meta property="canonical" content="https://wldt.github.io/blog/example-post/"><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/blog/example-post/"><meta property="og:title" content="Example Post"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="article"><meta property="og:section" content="blog"><meta property="og:see_also" content="https://wldt.github.io/blog/example-post/"><meta property="article:section" content="blog"><meta property="article:published_time" content="2024-02-09T09:54:12+01:00"><meta property="article:modified_time" content="2024-02-09T09:54:12+01:00"><meta name=twitter:card content="summary"><meta name=twitter:title content="Example Post"><script type=application/ld+json>{"@context":"https://schema.org","@type":"BlogPosting","article_body":"","date_modified":"2024-02-09T09:54:12+01:00","date_published":"2023-09-07T16:27:22+02:00","description":null,"headline":"Example Post","url":"https://wldt.github.io/blog/example-post/"}</script><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","item":"https://wldt.github.io/blog/","name":"Blog","position":2},{"@type":"ListItem","name":"Example Post","position":3}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="single section blog" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
+<link rel=stylesheet href=https://wldt.github.io/main.5fb433a44687c98f7ae7b3d0137c762777049ba27235e1f08c279c03c8533a7a9a1e3b0ef5b125a31b6bb63a362cdcbc39c3706ed41ad7f1a620b9281013866c.css integrity="sha512-X7QzpEaHyY9657PQE3x2J3cEm6JyNeHwjCecA8hTOnqaHjsO9bEloxtrtjo2LNy8OcNwbtQa1/GmILkoEBOGbA==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>Example Post | WLDT</title><meta property="canonical" content="https://wldt.github.io/blog/example-post/"><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/blog/example-post/"><meta property="og:title" content="Example Post"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="article"><meta property="og:section" content="blog"><meta property="og:see_also" content="https://wldt.github.io/blog/example-post/"><meta property="article:section" content="blog"><meta property="article:published_time" content="2024-02-09T13:02:54+01:00"><meta property="article:modified_time" content="2024-02-09T13:02:54+01:00"><meta name=twitter:card content="summary"><meta name=twitter:title content="Example Post"><script type=application/ld+json>{"@context":"https://schema.org","@type":"BlogPosting","article_body":"","date_modified":"2024-02-09T13:02:54+01:00","date_published":"2023-09-07T16:27:22+02:00","description":null,"headline":"Example Post","url":"https://wldt.github.io/blog/example-post/"}</script><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","item":"https://wldt.github.io/blog/","name":"Blog","position":2},{"@type":"ListItem","name":"Example Post","position":3}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="single section blog" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
 <button type=button id=searchToggleMobile class="btn btn-link nav-link mx-2 d-lg-none" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
 <button class="btn btn-link nav-link mx-2 order-3 d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavMain aria-controls=offcanvasNavMain aria-label="Open main navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-menu" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><line x1="4" y1="8" x2="20" y2="8"/><line x1="4" y1="16" x2="20" y2="16"/></svg></button><div class="offcanvas offcanvas-end h-auto" tabindex=-1 id=offcanvasNavMain aria-labelledby=offcanvasNavMainLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavMainLabel>WLDT</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class="offcanvas-body d-flex flex-column flex-lg-row justify-content-between"><ul class="navbar-nav flex-grow-1"><li class=nav-item><a class=nav-link href=https://wldt.github.io/docs/guides/example-guide/>Documentation</a></li><li class=nav-item><a class="nav-link active" href=https://wldt.github.io/blog/ aria-current=true>Blog</a></li></ul><button type=button id=searchToggleDesktop class="btn btn-link nav-link p-2 d-none d-lg-block" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
 <button id=buttonColorMode class="btn btn-link mx-auto nav-link p-0 ms-lg-2 me-lg-1" type=button aria-label="Toggle theme"><svg data-bs-theme-value="dark" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-moon" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 3c.132.0.263.0.393.0a7.5 7.5.0 007.92 12.446A9 9 0 1112 2.992z"/></svg><svg data-bs-theme-value="light" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-sun" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-4 0a4 4 0 108 0 4 4 0 10-8 0m-5 0h1m8-9v1m8 8h1m-9 8v1M5.6 5.6l.7.7m12.1-.7-.7.7m0 11.4.7.7m-12.1-.7-.7.7"/></svg></button><ul id=socialMenu class="nav mx-auto flex-row order-lg-4"><li class=nav-item><a class="nav-link social-link" href=https://github.com/wldt><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-brand-github" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 19c-4.3 1.4-4.3-2.5-6-3m12 5v-3.5c0-1 .1-1.4-.5-2 2.8-.3 5.5-1.4 5.5-6a4.6 4.6.0 00-1.3-3.2 4.2 4.2.0 00-.1-3.2s-1.1-.3-3.5 1.3a12.3 12.3.0 00-6.2.0C6.5 2.8 5.4 3.1 5.4 3.1a4.2 4.2.0 00-.1 3.2A4.6 4.6.0 004 9.5c0 4.6 2.7 5.7 5.5 6-.6.6-.6 1.2-.5 2V21"/></svg><small class="ms-2 visually-hidden">GitHub</small></a></li></ul></div></div></div></header></div><div class=modal id=searchModal tabindex=-1 aria-labelledby=searchModalLabel aria-hidden=true><div class="modal-dialog modal-dialog-scrollable modal-fullscreen-md-down"><div class=modal-content><div class=modal-header><h1 class="modal-title fs-5 visually-hidden" id=searchModalLabel>Search</h1><button type=button class="btn-close visually-hidden" data-bs-dismiss=modal aria-label=Close></button><div class="search-input flex-grow-1 d-none"><form id=search-form class=search-form action=# method=post accept-charset=utf-8 role=search><label for=query class=visually-hidden>Search</label><div class=d-flex><input type=search id=query name=query class="search-text form-control form-control-lg" placeholder=Search aria-label=Search maxlength=128 autocomplete=off>
diff --git a/blog/index.html b/blog/index.html
index 66ec5b2..5baee6c 100644
--- a/blog/index.html
+++ b/blog/index.html
@@ -1,5 +1,5 @@
 <!doctype html><html lang=en data-bs-theme=auto><head><meta charset=utf-8><meta http-equiv=x-ua-compatible content="ie=edge"><meta name=viewport content="width=device-width,initial-scale=1"><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-regular.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-500.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-700.woff2 type=font/woff2 crossorigin><script src=https://wldt.github.io/js/color-mode.86a91f050a481d0a3f0c72ac26543cb6228c770875981c58dcbc008fd3f875c8.js integrity="sha256-hqkfBQpIHQo/DHKsJlQ8tiKMdwh1mBxY3LwAj9P4dcg="></script>
-<link rel=stylesheet href=https://wldt.github.io/main.5d6e5440c13f1c45183e82bbb906165564d1edfd71498c4a2c38775086796022bfab9cfb137199a537d8e42c2fb6ce2ab74b69461aed15b7389bd0e12ec63b19.css integrity="sha512-XW5UQME/HEUYPoK7uQYWVWTR7f1xSYxKLDh3UIZ5YCK/q5z7E3GZpTfY5Cwvts4qt0tpRhrtFbc4m9DhLsY7GQ==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>Blog | WLDT</title><meta property="canonical" content="https://wldt.github.io/blog/"><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/blog/"><meta property="og:title" content="Blog"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="article"><meta property="og:section" content="blog"><meta property="og:see_also" content="https://wldt.github.io/blog/example-post/"><meta name=twitter:card content="summary"><meta name=twitter:title content="Blog"><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","name":"Blog","position":2}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="list section blog" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
+<link rel=stylesheet href=https://wldt.github.io/main.5fb433a44687c98f7ae7b3d0137c762777049ba27235e1f08c279c03c8533a7a9a1e3b0ef5b125a31b6bb63a362cdcbc39c3706ed41ad7f1a620b9281013866c.css integrity="sha512-X7QzpEaHyY9657PQE3x2J3cEm6JyNeHwjCecA8hTOnqaHjsO9bEloxtrtjo2LNy8OcNwbtQa1/GmILkoEBOGbA==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>Blog | WLDT</title><meta property="canonical" content="https://wldt.github.io/blog/"><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/blog/"><meta property="og:title" content="Blog"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="article"><meta property="og:section" content="blog"><meta property="og:see_also" content="https://wldt.github.io/blog/example-post/"><meta name=twitter:card content="summary"><meta name=twitter:title content="Blog"><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","name":"Blog","position":2}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="list section blog" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
 <button type=button id=searchToggleMobile class="btn btn-link nav-link mx-2 d-lg-none" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
 <button class="btn btn-link nav-link mx-2 order-3 d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavMain aria-controls=offcanvasNavMain aria-label="Open main navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-menu" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><line x1="4" y1="8" x2="20" y2="8"/><line x1="4" y1="16" x2="20" y2="16"/></svg></button><div class="offcanvas offcanvas-end h-auto" tabindex=-1 id=offcanvasNavMain aria-labelledby=offcanvasNavMainLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavMainLabel>WLDT</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class="offcanvas-body d-flex flex-column flex-lg-row justify-content-between"><ul class="navbar-nav flex-grow-1"><li class=nav-item><a class=nav-link href=https://wldt.github.io/docs/guides/example-guide/>Documentation</a></li><li class=nav-item><a class="nav-link active" href=https://wldt.github.io/blog/ aria-current=true>Blog</a></li></ul><button type=button id=searchToggleDesktop class="btn btn-link nav-link p-2 d-none d-lg-block" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
 <button id=buttonColorMode class="btn btn-link mx-auto nav-link p-0 ms-lg-2 me-lg-1" type=button aria-label="Toggle theme"><svg data-bs-theme-value="dark" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-moon" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 3c.132.0.263.0.393.0a7.5 7.5.0 007.92 12.446A9 9 0 1112 2.992z"/></svg><svg data-bs-theme-value="light" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-sun" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-4 0a4 4 0 108 0 4 4 0 10-8 0m-5 0h1m8-9v1m8 8h1m-9 8v1M5.6 5.6l.7.7m12.1-.7-.7.7m0 11.4.7.7m-12.1-.7-.7.7"/></svg></button><ul id=socialMenu class="nav mx-auto flex-row order-lg-4"><li class=nav-item><a class="nav-link social-link" href=https://github.com/wldt><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-brand-github" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 19c-4.3 1.4-4.3-2.5-6-3m12 5v-3.5c0-1 .1-1.4-.5-2 2.8-.3 5.5-1.4 5.5-6a4.6 4.6.0 00-1.3-3.2 4.2 4.2.0 00-.1-3.2s-1.1-.3-3.5 1.3a12.3 12.3.0 00-6.2.0C6.5 2.8 5.4 3.1 5.4 3.1a4.2 4.2.0 00-.1 3.2A4.6 4.6.0 004 9.5c0 4.6 2.7 5.7 5.5 6-.6.6-.6 1.2-.5 2V21"/></svg><small class="ms-2 visually-hidden">GitHub</small></a></li></ul></div></div></div></header></div><div class=modal id=searchModal tabindex=-1 aria-labelledby=searchModalLabel aria-hidden=true><div class="modal-dialog modal-dialog-scrollable modal-fullscreen-md-down"><div class=modal-content><div class=modal-header><h1 class="modal-title fs-5 visually-hidden" id=searchModalLabel>Search</h1><button type=button class="btn-close visually-hidden" data-bs-dismiss=modal aria-label=Close></button><div class="search-input flex-grow-1 d-none"><form id=search-form class=search-form action=# method=post accept-charset=utf-8 role=search><label for=query class=visually-hidden>Search</label><div class=d-flex><input type=search id=query name=query class="search-text form-control form-control-lg" placeholder=Search aria-label=Search maxlength=128 autocomplete=off>
diff --git a/blog/sitemap.xml b/blog/sitemap.xml
index 0cd0bc5..9691b26 100644
--- a/blog/sitemap.xml
+++ b/blog/sitemap.xml
@@ -1 +1 @@
-<?xml version="1.0" encoding="utf-8" standalone="yes"?><urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml"><url><loc>https://wldt.github.io/blog/example-post/</loc><lastmod>2024-02-09T09:54:12+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url></urlset>
\ No newline at end of file
+<?xml version="1.0" encoding="utf-8" standalone="yes"?><urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml"><url><loc>https://wldt.github.io/blog/example-post/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url></urlset>
\ No newline at end of file
diff --git a/categories/index.html b/categories/index.html
index d645a84..d81866c 100644
--- a/categories/index.html
+++ b/categories/index.html
@@ -1,5 +1,5 @@
 <!doctype html><html lang=en data-bs-theme=auto><head><meta charset=utf-8><meta http-equiv=x-ua-compatible content="ie=edge"><meta name=viewport content="width=device-width,initial-scale=1"><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-regular.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-500.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-700.woff2 type=font/woff2 crossorigin><script src=https://wldt.github.io/js/color-mode.86a91f050a481d0a3f0c72ac26543cb6228c770875981c58dcbc008fd3f875c8.js integrity="sha256-hqkfBQpIHQo/DHKsJlQ8tiKMdwh1mBxY3LwAj9P4dcg="></script>
-<link rel=stylesheet href=https://wldt.github.io/main.5d6e5440c13f1c45183e82bbb906165564d1edfd71498c4a2c38775086796022bfab9cfb137199a537d8e42c2fb6ce2ab74b69461aed15b7389bd0e12ec63b19.css integrity="sha512-XW5UQME/HEUYPoK7uQYWVWTR7f1xSYxKLDh3UIZ5YCK/q5z7E3GZpTfY5Cwvts4qt0tpRhrtFbc4m9DhLsY7GQ==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>Categories | WLDT</title><meta property="canonical" content="https://wldt.github.io/categories/"><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/categories/"><meta property="og:title" content="Categories"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:section" content="categories"><meta name=twitter:card content="summary"><meta name=twitter:title content="Categories"><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","name":"Categories","position":2}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="list taxonomy categories" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
+<link rel=stylesheet href=https://wldt.github.io/main.5fb433a44687c98f7ae7b3d0137c762777049ba27235e1f08c279c03c8533a7a9a1e3b0ef5b125a31b6bb63a362cdcbc39c3706ed41ad7f1a620b9281013866c.css integrity="sha512-X7QzpEaHyY9657PQE3x2J3cEm6JyNeHwjCecA8hTOnqaHjsO9bEloxtrtjo2LNy8OcNwbtQa1/GmILkoEBOGbA==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>Categories | WLDT</title><meta property="canonical" content="https://wldt.github.io/categories/"><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/categories/"><meta property="og:title" content="Categories"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:section" content="categories"><meta name=twitter:card content="summary"><meta name=twitter:title content="Categories"><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","name":"Categories","position":2}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="list taxonomy categories" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
 <button type=button id=searchToggleMobile class="btn btn-link nav-link mx-2 d-lg-none" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
 <button class="btn btn-link nav-link mx-2 order-3 d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavMain aria-controls=offcanvasNavMain aria-label="Open main navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-menu" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><line x1="4" y1="8" x2="20" y2="8"/><line x1="4" y1="16" x2="20" y2="16"/></svg></button><div class="offcanvas offcanvas-end h-auto" tabindex=-1 id=offcanvasNavMain aria-labelledby=offcanvasNavMainLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavMainLabel>WLDT</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class="offcanvas-body d-flex flex-column flex-lg-row justify-content-between"><ul class="navbar-nav flex-grow-1"><li class=nav-item><a class=nav-link href=https://wldt.github.io/docs/guides/example-guide/>Documentation</a></li><li class=nav-item><a class=nav-link href=https://wldt.github.io/blog/>Blog</a></li></ul><button type=button id=searchToggleDesktop class="btn btn-link nav-link p-2 d-none d-lg-block" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
 <button id=buttonColorMode class="btn btn-link mx-auto nav-link p-0 ms-lg-2 me-lg-1" type=button aria-label="Toggle theme"><svg data-bs-theme-value="dark" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-moon" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 3c.132.0.263.0.393.0a7.5 7.5.0 007.92 12.446A9 9 0 1112 2.992z"/></svg><svg data-bs-theme-value="light" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-sun" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-4 0a4 4 0 108 0 4 4 0 10-8 0m-5 0h1m8-9v1m8 8h1m-9 8v1M5.6 5.6l.7.7m12.1-.7-.7.7m0 11.4.7.7m-12.1-.7-.7.7"/></svg></button><ul id=socialMenu class="nav mx-auto flex-row order-lg-4"><li class=nav-item><a class="nav-link social-link" href=https://github.com/wldt><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-brand-github" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 19c-4.3 1.4-4.3-2.5-6-3m12 5v-3.5c0-1 .1-1.4-.5-2 2.8-.3 5.5-1.4 5.5-6a4.6 4.6.0 00-1.3-3.2 4.2 4.2.0 00-.1-3.2s-1.1-.3-3.5 1.3a12.3 12.3.0 00-6.2.0C6.5 2.8 5.4 3.1 5.4 3.1a4.2 4.2.0 00-.1 3.2A4.6 4.6.0 004 9.5c0 4.6 2.7 5.7 5.5 6-.6.6-.6 1.2-.5 2V21"/></svg><small class="ms-2 visually-hidden">GitHub</small></a></li></ul></div></div></div></header></div><div class=modal id=searchModal tabindex=-1 aria-labelledby=searchModalLabel aria-hidden=true><div class="modal-dialog modal-dialog-scrollable modal-fullscreen-md-down"><div class=modal-content><div class=modal-header><h1 class="modal-title fs-5 visually-hidden" id=searchModalLabel>Search</h1><button type=button class="btn-close visually-hidden" data-bs-dismiss=modal aria-label=Close></button><div class="search-input flex-grow-1 d-none"><form id=search-form class=search-form action=# method=post accept-charset=utf-8 role=search><label for=query class=visually-hidden>Search</label><div class=d-flex><input type=search id=query name=query class="search-text form-control form-control-lg" placeholder=Search aria-label=Search maxlength=128 autocomplete=off>
diff --git a/contributors/index.html b/contributors/index.html
index 83b8263..a527dd1 100644
--- a/contributors/index.html
+++ b/contributors/index.html
@@ -1,5 +1,5 @@
 <!doctype html><html lang=en data-bs-theme=auto><head><meta charset=utf-8><meta http-equiv=x-ua-compatible content="ie=edge"><meta name=viewport content="width=device-width,initial-scale=1"><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-regular.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-500.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-700.woff2 type=font/woff2 crossorigin><script src=https://wldt.github.io/js/color-mode.86a91f050a481d0a3f0c72ac26543cb6228c770875981c58dcbc008fd3f875c8.js integrity="sha256-hqkfBQpIHQo/DHKsJlQ8tiKMdwh1mBxY3LwAj9P4dcg="></script>
-<link rel=stylesheet href=https://wldt.github.io/main.5d6e5440c13f1c45183e82bbb906165564d1edfd71498c4a2c38775086796022bfab9cfb137199a537d8e42c2fb6ce2ab74b69461aed15b7389bd0e12ec63b19.css integrity="sha512-XW5UQME/HEUYPoK7uQYWVWTR7f1xSYxKLDh3UIZ5YCK/q5z7E3GZpTfY5Cwvts4qt0tpRhrtFbc4m9DhLsY7GQ==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>Contributors | WLDT</title><meta property="canonical" content="https://wldt.github.io/contributors/"><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/contributors/"><meta property="og:title" content="Contributors"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:section" content="contributors"><meta name=twitter:card content="summary"><meta name=twitter:title content="Contributors"><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","name":"Contributors","position":2}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="list taxonomy contributors" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
+<link rel=stylesheet href=https://wldt.github.io/main.5fb433a44687c98f7ae7b3d0137c762777049ba27235e1f08c279c03c8533a7a9a1e3b0ef5b125a31b6bb63a362cdcbc39c3706ed41ad7f1a620b9281013866c.css integrity="sha512-X7QzpEaHyY9657PQE3x2J3cEm6JyNeHwjCecA8hTOnqaHjsO9bEloxtrtjo2LNy8OcNwbtQa1/GmILkoEBOGbA==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>Contributors | WLDT</title><meta property="canonical" content="https://wldt.github.io/contributors/"><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/contributors/"><meta property="og:title" content="Contributors"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:section" content="contributors"><meta name=twitter:card content="summary"><meta name=twitter:title content="Contributors"><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","name":"Contributors","position":2}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="list taxonomy contributors" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
 <button type=button id=searchToggleMobile class="btn btn-link nav-link mx-2 d-lg-none" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
 <button class="btn btn-link nav-link mx-2 order-3 d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavMain aria-controls=offcanvasNavMain aria-label="Open main navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-menu" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><line x1="4" y1="8" x2="20" y2="8"/><line x1="4" y1="16" x2="20" y2="16"/></svg></button><div class="offcanvas offcanvas-end h-auto" tabindex=-1 id=offcanvasNavMain aria-labelledby=offcanvasNavMainLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavMainLabel>WLDT</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class="offcanvas-body d-flex flex-column flex-lg-row justify-content-between"><ul class="navbar-nav flex-grow-1"><li class=nav-item><a class=nav-link href=https://wldt.github.io/docs/guides/example-guide/>Documentation</a></li><li class=nav-item><a class=nav-link href=https://wldt.github.io/blog/>Blog</a></li></ul><button type=button id=searchToggleDesktop class="btn btn-link nav-link p-2 d-none d-lg-block" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
 <button id=buttonColorMode class="btn btn-link mx-auto nav-link p-0 ms-lg-2 me-lg-1" type=button aria-label="Toggle theme"><svg data-bs-theme-value="dark" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-moon" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 3c.132.0.263.0.393.0a7.5 7.5.0 007.92 12.446A9 9 0 1112 2.992z"/></svg><svg data-bs-theme-value="light" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-sun" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-4 0a4 4 0 108 0 4 4 0 10-8 0m-5 0h1m8-9v1m8 8h1m-9 8v1M5.6 5.6l.7.7m12.1-.7-.7.7m0 11.4.7.7m-12.1-.7-.7.7"/></svg></button><ul id=socialMenu class="nav mx-auto flex-row order-lg-4"><li class=nav-item><a class="nav-link social-link" href=https://github.com/wldt><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-brand-github" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 19c-4.3 1.4-4.3-2.5-6-3m12 5v-3.5c0-1 .1-1.4-.5-2 2.8-.3 5.5-1.4 5.5-6a4.6 4.6.0 00-1.3-3.2 4.2 4.2.0 00-.1-3.2s-1.1-.3-3.5 1.3a12.3 12.3.0 00-6.2.0C6.5 2.8 5.4 3.1 5.4 3.1a4.2 4.2.0 00-.1 3.2A4.6 4.6.0 004 9.5c0 4.6 2.7 5.7 5.5 6-.6.6-.6 1.2-.5 2V21"/></svg><small class="ms-2 visually-hidden">GitHub</small></a></li></ul></div></div></div></header></div><div class=modal id=searchModal tabindex=-1 aria-labelledby=searchModalLabel aria-hidden=true><div class="modal-dialog modal-dialog-scrollable modal-fullscreen-md-down"><div class=modal-content><div class=modal-header><h1 class="modal-title fs-5 visually-hidden" id=searchModalLabel>Search</h1><button type=button class="btn-close visually-hidden" data-bs-dismiss=modal aria-label=Close></button><div class="search-input flex-grow-1 d-none"><form id=search-form class=search-form action=# method=post accept-charset=utf-8 role=search><label for=query class=visually-hidden>Search</label><div class=d-flex><input type=search id=query name=query class="search-text form-control form-control-lg" placeholder=Search aria-label=Search maxlength=128 autocomplete=off>
diff --git a/docs/adapters/http-digital-adapter/index.html b/docs/adapters/http-digital-adapter/index.html
new file mode 100644
index 0000000..cba0e61
--- /dev/null
+++ b/docs/adapters/http-digital-adapter/index.html
@@ -0,0 +1,71 @@
+<!doctype html><html lang=en data-bs-theme=auto><head><meta charset=utf-8><meta http-equiv=x-ua-compatible content="ie=edge"><meta name=viewport content="width=device-width,initial-scale=1"><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-regular.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-500.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-700.woff2 type=font/woff2 crossorigin><script src=https://wldt.github.io/js/color-mode.86a91f050a481d0a3f0c72ac26543cb6228c770875981c58dcbc008fd3f875c8.js integrity="sha256-hqkfBQpIHQo/DHKsJlQ8tiKMdwh1mBxY3LwAj9P4dcg="></script>
+<link rel=stylesheet href=https://wldt.github.io/main.5fb433a44687c98f7ae7b3d0137c762777049ba27235e1f08c279c03c8533a7a9a1e3b0ef5b125a31b6bb63a362cdcbc39c3706ed41ad7f1a620b9281013866c.css integrity="sha512-X7QzpEaHyY9657PQE3x2J3cEm6JyNeHwjCecA8hTOnqaHjsO9bEloxtrtjo2LNy8OcNwbtQa1/GmILkoEBOGbA==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>HTTP Digital Adapter | WLDT</title><meta property="canonical" content="https://wldt.github.io/docs/adapters/http-digital-adapter/"><meta name=description content="The HttpDigitalAdapter is a powerful component designed to facilitate the integration of Digital Twins into HTTP-based systems. It serves as a bridge between a Digital Twin and HTTP-based applications, allowing developers to easily expose and interact with Digital Twin data and functionalities over HTTP."><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/docs/adapters/http-digital-adapter/"><meta property="og:title" content="HTTP Digital Adapter"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:section" content="docs"><meta property="og:description" content="The HttpDigitalAdapter is a powerful component designed to facilitate the integration of Digital Twins into HTTP-based systems. It serves as a bridge between a Digital Twin and HTTP-based applications, allowing developers to easily expose and interact with Digital Twin data and functionalities over HTTP."><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-model/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-life-cycle/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/library-structure-basic-concepts/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/physical-adapter/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/shadowing-function/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/digital-adapter/"><meta name=twitter:card content="summary"><meta name=twitter:title content="HTTP Digital Adapter"><meta name=twitter:description content="The HttpDigitalAdapter is a powerful component designed to facilitate the integration of Digital Twins into HTTP-based systems. It serves as a bridge between a Digital Twin and HTTP-based applications, allowing developers to easily expose and interact with Digital Twin data and functionalities over HTTP."><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","item":"https://wldt.github.io/docs/","name":"Docs","position":2},{"@type":"ListItem","item":"https://wldt.github.io/docs/adapters/","name":"Adapters","position":3},{"@type":"ListItem","name":"HTTP Digital Adapter","position":4}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="single section docs" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
+<button type=button id=searchToggleMobile class="btn btn-link nav-link mx-2 d-lg-none" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button class="btn btn-link d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavSection aria-controls=offcanvasNavSection aria-label="Open section navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-dots-vertical" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 19m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 5m-1 0a1 1 0 102 0 1 1 0 10-2 0"/></svg></button><div class="offcanvas offcanvas-start d-lg-none" tabindex=-1 id=offcanvasNavSection aria-labelledby=offcanvasNavSectionLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavSectionLabel>Docs</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class=offcanvas-body><aside class="doks-sidebar mt-n3"><nav id=doks-docs-nav aria-label="Tertiary navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-0b79795d3efc95b9976c7c5b933afce2 aria-expanded=false>
+Introduction</button><div class=collapse id=section-0b79795d3efc95b9976c7c5b933afce2><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-model/>DT Model</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-life-cycle/>DT Life Cycle</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/>Library Structure & Basic Concepts</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-3978929206deee2c125a1d732aae5545 aria-expanded=false>
+Change Logs</button><div class=collapse id=section-3978929206deee2c125a1d732aae5545><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/>Change Log 0.3.0</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-89413bd312d0909efb85e6693f36cb89 aria-expanded=true>
+Adapters</button><div class="collapse show" id=section-89413bd312d0909efb85e6693f36cb89><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/>MQTT Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/>MQTT Digital Adapter</a></li><li><a class="docs-link rounded active" href=https://wldt.github.io/docs/adapters/http-digital-adapter/>HTTP Digital Adapter</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-bf647454e36069fd16f1a7a35cf6a865 aria-expanded=false>
+Getting Started</button><div class=collapse id=section-bf647454e36069fd16f1a7a35cf6a865><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/physical-adapter/>Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/shadowing-function/>Shadowing Function</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-adapter/>Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/>DT Engine & DT Instance</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-actions/>Digital Actions</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/configurable-adapters/>Configurable Adapters</a></li></ul></div></li></ul></nav></aside></div></div><button class="btn btn-link nav-link mx-2 order-3 d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavMain aria-controls=offcanvasNavMain aria-label="Open main navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-menu" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><line x1="4" y1="8" x2="20" y2="8"/><line x1="4" y1="16" x2="20" y2="16"/></svg></button><div class="offcanvas offcanvas-end h-auto" tabindex=-1 id=offcanvasNavMain aria-labelledby=offcanvasNavMainLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavMainLabel>WLDT</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class="offcanvas-body d-flex flex-column flex-lg-row justify-content-between"><ul class="navbar-nav flex-grow-1"><li class=nav-item><a class=nav-link href=https://wldt.github.io/docs/guides/example-guide/>Documentation</a></li><li class=nav-item><a class=nav-link href=https://wldt.github.io/blog/>Blog</a></li></ul><button type=button id=searchToggleDesktop class="btn btn-link nav-link p-2 d-none d-lg-block" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button id=buttonColorMode class="btn btn-link mx-auto nav-link p-0 ms-lg-2 me-lg-1" type=button aria-label="Toggle theme"><svg data-bs-theme-value="dark" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-moon" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 3c.132.0.263.0.393.0a7.5 7.5.0 007.92 12.446A9 9 0 1112 2.992z"/></svg><svg data-bs-theme-value="light" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-sun" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-4 0a4 4 0 108 0 4 4 0 10-8 0m-5 0h1m8-9v1m8 8h1m-9 8v1M5.6 5.6l.7.7m12.1-.7-.7.7m0 11.4.7.7m-12.1-.7-.7.7"/></svg></button><ul id=socialMenu class="nav mx-auto flex-row order-lg-4"><li class=nav-item><a class="nav-link social-link" href=https://github.com/wldt><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-brand-github" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 19c-4.3 1.4-4.3-2.5-6-3m12 5v-3.5c0-1 .1-1.4-.5-2 2.8-.3 5.5-1.4 5.5-6a4.6 4.6.0 00-1.3-3.2 4.2 4.2.0 00-.1-3.2s-1.1-.3-3.5 1.3a12.3 12.3.0 00-6.2.0C6.5 2.8 5.4 3.1 5.4 3.1a4.2 4.2.0 00-.1 3.2A4.6 4.6.0 004 9.5c0 4.6 2.7 5.7 5.5 6-.6.6-.6 1.2-.5 2V21"/></svg><small class="ms-2 visually-hidden">GitHub</small></a></li></ul></div></div></div></header></div><div class=modal id=searchModal tabindex=-1 aria-labelledby=searchModalLabel aria-hidden=true><div class="modal-dialog modal-dialog-scrollable modal-fullscreen-md-down"><div class=modal-content><div class=modal-header><h1 class="modal-title fs-5 visually-hidden" id=searchModalLabel>Search</h1><button type=button class="btn-close visually-hidden" data-bs-dismiss=modal aria-label=Close></button><div class="search-input flex-grow-1 d-none"><form id=search-form class=search-form action=# method=post accept-charset=utf-8 role=search><label for=query class=visually-hidden>Search</label><div class=d-flex><input type=search id=query name=query class="search-text form-control form-control-lg" placeholder=Search aria-label=Search maxlength=128 autocomplete=off>
+<button type=button class="btn btn-link text-decoration-none px-0 ms-3 d-md-none" data-bs-dismiss=modal aria-label=Close>Cancel</button></div></form></div></div><div class=modal-body><p class="search-loading status message d-none mt-3 text-center">Loading search index…</p><p class="search-no-recent message d-none mt-3 text-center">No recent searches</p><p class="search-no-results message d-none mt-3 text-center">No results for "<strong><span class=query-no-results>Query here</span></strong>"</p><div id=searchResults class=search-results></div><template><article class="search-result list-view"><div class="card my-3"><div class=card-body><header><h2 class="h5 title title-submitted mb-0"><a class="stretched-link text-decoration-none text-reset" href=#>Title here</a></h2><div class="submitted d-none"><time class=created-date>Date here</time></div></header><div class=content>Summary here</div></div></div></article></template></div><div class=modal-footer><ul class="list-inline me-auto d-none d-md-block"><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Enter key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M12 3.53088v3c0 1-1 2-2 2H4m3 3-3-3 3-3"/></g></svg></kbd><span class=DocSearch-Label>to select</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Arrow down" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 3.5v8m3-3-3 3-3-3"/></g></svg></kbd><kbd class=me-2><svg width="15" height="15" aria-label="Arrow up" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 11.5v-8m3 3-3-3-3 3"/></g></svg></kbd><span class=DocSearch-Label>to navigate</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Escape key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M13.6167 8.936c-.1065.3583-.6883.962-1.4875.962-.7993.0-1.653-.9165-1.653-2.1258v-.5678c0-1.2548.7896-2.1016 1.653-2.1016s1.3601.4778 1.4875 1.0724M9 6c-.1352-.4735-.7506-.9219-1.46-.8972-.7092.0246-1.344.57-1.344 1.2166s.4198.8812 1.3445.9805C8.465 7.3992 8.968 7.9337 9 8.5s-.454 1.398-1.4595 1.398C6.6593 9.898 6 9 5.963 8.4851m-1.4748.5368c-.2635.5941-.8099.876-1.5443.876s-1.7073-.6248-1.7073-2.204v-.4603c0-1.0416.721-2.131 1.7073-2.131.9864.0 1.6425 1.031 1.5443 2.2492h-2.956"/></g></svg></kbd><span class=DocSearch-Label>to close</span></li></ul><p class=d-md-none>Search by <a class=text-decoration-none href=https://github.com/nextapps-de/flexsearch>FlexSearch</a></p></div></div></div></div><div class="wrap container-lg" role=document><div class=content><div class="row flex-xl-nowrap"><div class="col-lg-5 col-xl-4 docs-sidebar d-none d-lg-block"><nav class=docs-links aria-label="Main navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-0b79795d3efc95b9976c7c5b933afce2 aria-expanded=false>
+Introduction</button><div class=collapse id=section-0b79795d3efc95b9976c7c5b933afce2><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-model/>DT Model</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-life-cycle/>DT Life Cycle</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/>Library Structure & Basic Concepts</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-3978929206deee2c125a1d732aae5545 aria-expanded=false>
+Change Logs</button><div class=collapse id=section-3978929206deee2c125a1d732aae5545><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/>Change Log 0.3.0</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-89413bd312d0909efb85e6693f36cb89 aria-expanded=true>
+Adapters</button><div class="collapse show" id=section-89413bd312d0909efb85e6693f36cb89><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/>MQTT Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/>MQTT Digital Adapter</a></li><li><a class="docs-link rounded active" href=https://wldt.github.io/docs/adapters/http-digital-adapter/>HTTP Digital Adapter</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-bf647454e36069fd16f1a7a35cf6a865 aria-expanded=false>
+Getting Started</button><div class=collapse id=section-bf647454e36069fd16f1a7a35cf6a865><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/physical-adapter/>Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/shadowing-function/>Shadowing Function</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-adapter/>Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/>DT Engine & DT Instance</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-actions/>Digital Actions</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/configurable-adapters/>Configurable Adapters</a></li></ul></div></li></ul></nav></div><nav class="docs-toc d-none d-xl-block col-xl-3" aria-label="Secondary navigation"><div class=page-links><h3>Example Guide</h3><nav id=toc><ul><li><a href=#wldt-core-version-compatibility>WLDT-Core Version Compatibility</a></li><li><a href=#installation>Installation</a><ul><li><a href=#maven>Maven</a></li><li><a href=#gradle>Gradle</a></li></ul></li><li><a href=#class-structure--functionalities>Class Structure & Functionalities</a><ul><li><a href=#httpdigitaladapterconfiguration>HttpDigitalAdapterConfiguration</a></li><li><a href=#httpdigitaladapter>HttpDigitalAdapter</a></li></ul></li><li><a href=#http-restful-api>HTTP RESTful API</a></li></ul></nav></div></nav><main class="docs-content col-lg-11 col-xl-9"><nav aria-label=breadcrumb><ol class=breadcrumb><li class=breadcrumb-item><a href=https://wldt.github.io/>Home</a></li><li class=breadcrumb-item><a href=https://wldt.github.io/docs/>Docs</a></li><li class=breadcrumb-item><a href=https://wldt.github.io/docs/adapters/>Adapters</a></li><li class="breadcrumb-item active" aria-current=page>HTTP Digital Adapter</li></ol></nav><h1>HTTP Digital Adapter</h1><nav class="toc-mobile d-xl-none" aria-label="Quaternary navigation"><details><summary>On this page</summary><div class=page-links><nav id=TableOfContents><ul><li><a href=#wldt-core-version-compatibility>WLDT-Core Version Compatibility</a></li><li><a href=#installation>Installation</a><ul><li><a href=#maven>Maven</a></li><li><a href=#gradle>Gradle</a></li></ul></li><li><a href=#class-structure--functionalities>Class Structure & Functionalities</a><ul><li><a href=#httpdigitaladapterconfiguration>HttpDigitalAdapterConfiguration</a></li><li><a href=#httpdigitaladapter>HttpDigitalAdapter</a></li></ul></li><li><a href=#http-restful-api>HTTP RESTful API</a></li></ul></nav></div></details></nav><p>The <code>HttpDigitalAdapter</code> is a powerful component designed to facilitate the integration of Digital Twins into HTTP-based systems.
+It serves as a bridge between a Digital Twin and HTTP-based applications, allowing developers to easily expose and interact with
+Digital Twin data and functionalities over HTTP.</p><p>Key Features:</p><ul><li><strong>HTTP Integration:</strong> Seamlessly integrates Digital Twins into HTTP environments, enabling communication with web applications and services.</li><li><strong>Dynamic Configuration:</strong> Offers a flexible configuration mechanism through the HttpDigitalAdapterConfiguration, allowing developers to customize the adapter&rsquo;s behavior based on specific requirements.</li><li><strong>State Monitoring:</strong> Monitors changes in the Digital Twin state and provides HTTP endpoints to query the state of the Digital Twin (properties, events, actions and relationships).</li><li><strong>Event Notifications:</strong> Allows developers to retrieve event notifications triggered by changes in the Digital Twin state.</li></ul><div align=center><img class=center src=images/adapter_schema.jpg width=100%></div><p>A complete example is provided in the <code>test</code> folder with a complete DT Creation in the <code>TestMain</code> class together with a demo DT with and emulated Physical Adapter and the HTTP Digital Adapter.</p><h2 id=wldt-core-version-compatibility>WLDT-Core Version Compatibility<a href=#wldt-core-version-compatibility class=anchor aria-hidden=true>#</a></h2><p>The correct mapping and compatibility between versions is reported in the following table</p><table><thead><tr><th style=text-align:center><strong>http-digital-adapter</strong></th><th style=text-align:center>wldt-core 0.2.1</th><th style=text-align:center>wldt-core 0.3.0</th></tr></thead><tbody><tr><td style=text-align:center>0.1.1</td><td style=text-align:center>❌</td><td style=text-align:center>✅</td></tr></tbody></table><h2 id=installation>Installation<a href=#installation class=anchor aria-hidden=true>#</a></h2><p>To use HttpDigitalAdapter in your Java project, you can include it as a dependency using Maven or Gradle.</p><h3 id=maven>Maven<a href=#maven class=anchor aria-hidden=true>#</a></h3><div class=highlight><pre tabindex=0 class=chroma><code class=language-xml data-lang=xml><span class=line><span class=cl><span class=nt>&lt;dependency&gt;</span>
+</span></span><span class=line><span class=cl>    <span class=nt>&lt;groupId&gt;</span>io.github.wldt<span class=nt>&lt;/groupId&gt;</span>
+</span></span><span class=line><span class=cl>    <span class=nt>&lt;artifactId&gt;</span>http-digital-adapter<span class=nt>&lt;/artifactId&gt;</span>
+</span></span><span class=line><span class=cl>    <span class=nt>&lt;version&gt;</span>0.1.1<span class=nt>&lt;/version&gt;</span>
+</span></span><span class=line><span class=cl><span class=nt>&lt;/dependency&gt;</span>
+</span></span></code></pre></div><h3 id=gradle>Gradle<a href=#gradle class=anchor aria-hidden=true>#</a></h3><div class=highlight><pre tabindex=0 class=chroma><code class=language-groovy data-lang=groovy><span class=line><span class=cl><span class=n>implementation</span> <span class=s1>&#39;io.github.wldt:http-digital-adapter:0.1.1&#39;</span>
+</span></span></code></pre></div><h2 id=class-structure--functionalities>Class Structure & Functionalities<a href=#class-structure--functionalities class=anchor aria-hidden=true>#</a></h2><h3 id=httpdigitaladapterconfiguration>HttpDigitalAdapterConfiguration<a href=#httpdigitaladapterconfiguration class=anchor aria-hidden=true>#</a></h3><p>The <code>HttpDigitalAdapterConfiguration</code> is a crucial part of the HttpDigitalAdapter, providing the necessary settings to
+tailor the adapter&rsquo;s behavior to meet specific needs.</p><p>Represents the configuration for an HTTP Digital Adapter, specifying the host, port,
+and filters for properties, actions, events, and relationships.</p><p>The filters are used to selectively include or exclude specific properties, actions,
+events, and relationships when interacting with the HTTP Digital Adapter.
+Filters are meant to be white list filters, if they are empty, it means that ALL fields are considered</p><p>This class provides methods to add filters for each type and getters to retrieve the configured values.</p><p>Key functionalities and exposed capabilities:</p><ul><li><strong>Basic Configuration</strong><ul><li><strong>Adapter ID:</strong> A unique identifier for the HttpDigitalAdapter instance.</li><li><strong>Host:</strong> The hostname or IP address on which the adapter will listen for incoming HTTP requests.</li><li><strong>Port:</strong> The port number on which the adapter will listen for incoming HTTP requests.</li></ul></li><li><strong>Filters (Optional)</strong><ul><li><code>addPropertyFilter(String propertyKey)</code>: Adds a single property key to the property filter.</li><li><code>addPropertiesFilter(Collection&lt;String> propertiesKey)</code>: Adds a collection of property keys to the property filter.</li><li><code>addActionFilter(String actionKey)</code>: Adds a single action key to the action filter.</li><li><code>addActionsFilter(Collection&lt;String> actionsKey)</code>: Adds a collection of action keys to the action filter.</li><li><code>addEventFilter(String eventKey)</code>: Adds a single event key to the event filter.</li><li><code>addEventsFilter(Collection&lt;String> eventsKey)</code>: Adds a collection of event keys to the event filter.</li><li><code>addRelationshipFilter(String relationshipName)</code>: Adds a single relationship name to the relationship filter.</li><li><code>addRelationshipsFilter(Collection&lt;String> relationshipNames)</code>: Adds a collection of relationship names to the relationship filter.</li><li>Configured Filter can be accessed using:<ul><li><code>getPropertyFilter()</code></li><li><code>getActionFilter()</code></li><li><code>getEventFilter()</code></li><li><code>getRelationshipFilter()</code></li></ul></li></ul></li></ul><p>A basic example without any filter that accesses and uses the entire DT State is:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=n>HttpDigitalAdapterConfiguration</span> <span class=n>config</span> <span class=o>=</span> <span class=k>new</span> <span class=n>HttpDigitalAdapterConfiguration</span><span class=o>(</span><span class=s>&#34;my-http-adapter&#34;</span><span class=o>,</span> <span class=s>&#34;localhost&#34;</span><span class=o>,</span> <span class=mi>8080</span><span class=o>);</span>
+</span></span></code></pre></div><p>An example of using filter to select specific field of interest can be structured ad follows:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=n>HttpDigitalAdapterConfiguration</span> <span class=n>config</span> <span class=o>=</span> <span class=k>new</span> <span class=n>HttpDigitalAdapterConfiguration</span><span class=o>(</span><span class=s>&#34;my-http-adapter&#34;</span><span class=o>,</span> <span class=s>&#34;localhost&#34;</span><span class=o>,</span> <span class=mi>8080</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=c1>// Add property filter
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>config</span><span class=o>.</span><span class=na>addPropertyFilter</span><span class=o>(</span><span class=s>&#34;temperature&#34;</span><span class=o>);</span>
+</span></span><span class=line><span class=cl><span class=n>config</span><span class=o>.</span><span class=na>addPropertiesFilter</span><span class=o>(</span><span class=n>Arrays</span><span class=o>.</span><span class=na>asList</span><span class=o>(</span><span class=s>&#34;humidity&#34;</span><span class=o>,</span> <span class=s>&#34;pressure&#34;</span><span class=o>));</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=c1>// Add action filter
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>config</span><span class=o>.</span><span class=na>addActionFilter</span><span class=o>(</span><span class=s>&#34;start&#34;</span><span class=o>);</span>
+</span></span><span class=line><span class=cl><span class=n>config</span><span class=o>.</span><span class=na>addActionsFilter</span><span class=o>(</span><span class=n>Arrays</span><span class=o>.</span><span class=na>asList</span><span class=o>(</span><span class=s>&#34;stop&#34;</span><span class=o>,</span> <span class=s>&#34;reset&#34;</span><span class=o>));</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=c1>// Add event filter
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>config</span><span class=o>.</span><span class=na>addEventFilter</span><span class=o>(</span><span class=s>&#34;temperatureChange&#34;</span><span class=o>);</span>
+</span></span><span class=line><span class=cl><span class=n>config</span><span class=o>.</span><span class=na>addEventsFilter</span><span class=o>(</span><span class=n>Collections</span><span class=o>.</span><span class=na>singletonList</span><span class=o>(</span><span class=s>&#34;pressureChange&#34;</span><span class=o>));</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=c1>// Add relationship filter
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>config</span><span class=o>.</span><span class=na>addRelationshipFilter</span><span class=o>(</span><span class=s>&#34;connectedTo&#34;</span><span class=o>);</span>
+</span></span><span class=line><span class=cl><span class=n>config</span><span class=o>.</span><span class=na>addRelationshipsFilter</span><span class=o>(</span><span class=n>Arrays</span><span class=o>.</span><span class=na>asList</span><span class=o>(</span><span class=s>&#34;parentOf&#34;</span><span class=o>,</span> <span class=s>&#34;siblingOf&#34;</span><span class=o>));</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=c1>// Retrieve and display filters
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>List</span><span class=o>&lt;</span><span class=n>String</span><span class=o>&gt;</span> <span class=n>propertyFilter</span> <span class=o>=</span> <span class=n>config</span><span class=o>.</span><span class=na>getPropertyFilter</span><span class=o>();</span>
+</span></span><span class=line><span class=cl><span class=n>List</span><span class=o>&lt;</span><span class=n>String</span><span class=o>&gt;</span> <span class=n>actionFilter</span> <span class=o>=</span> <span class=n>config</span><span class=o>.</span><span class=na>getActionFilter</span><span class=o>();</span>
+</span></span><span class=line><span class=cl><span class=n>List</span><span class=o>&lt;</span><span class=n>String</span><span class=o>&gt;</span> <span class=n>eventFilter</span> <span class=o>=</span> <span class=n>config</span><span class=o>.</span><span class=na>getEventFilter</span><span class=o>();</span>
+</span></span><span class=line><span class=cl><span class=n>List</span><span class=o>&lt;</span><span class=n>String</span><span class=o>&gt;</span> <span class=n>relationshipFilter</span> <span class=o>=</span> <span class=n>config</span><span class=o>.</span><span class=na>getRelationshipFilter</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=n>System</span><span class=o>.</span><span class=na>out</span><span class=o>.</span><span class=na>println</span><span class=o>(</span><span class=s>&#34;Property Filter: &#34;</span> <span class=o>+</span> <span class=n>propertyFilter</span><span class=o>);</span>
+</span></span><span class=line><span class=cl><span class=n>System</span><span class=o>.</span><span class=na>out</span><span class=o>.</span><span class=na>println</span><span class=o>(</span><span class=s>&#34;Action Filter: &#34;</span> <span class=o>+</span> <span class=n>actionFilter</span><span class=o>);</span>
+</span></span><span class=line><span class=cl><span class=n>System</span><span class=o>.</span><span class=na>out</span><span class=o>.</span><span class=na>println</span><span class=o>(</span><span class=s>&#34;Event Filter: &#34;</span> <span class=o>+</span> <span class=n>eventFilter</span><span class=o>);</span>
+</span></span><span class=line><span class=cl><span class=n>System</span><span class=o>.</span><span class=na>out</span><span class=o>.</span><span class=na>println</span><span class=o>(</span><span class=s>&#34;Relationship Filter: &#34;</span> <span class=o>+</span> <span class=n>relationshipFilter</span><span class=o>);</span>
+</span></span></code></pre></div><h3 id=httpdigitaladapter>HttpDigitalAdapter<a href=#httpdigitaladapter class=anchor aria-hidden=true>#</a></h3><p>The <code>HttpDigitalAdapter</code> itself is the core component responsible for handling HTTP requests and
+interacting with the underlying Digital Twin. It extends the capabilities of the base DigitalAdapter
+to specifically cater to HTTP-based scenarios.</p><p>Key Functionalities:</p><ul><li>RESTful Endpoints: Provides RESTful endpoints for reading properties, invoking actions, querying events, and managing relationships.</li><li>State Updates: Automatically reflects changes in the Digital Twin state to the HTTP endpoints, ensuring real-time information.</li><li>Event Handling: Listens for Digital Twin events and provides events notifications to HTTP clients.</li></ul><p>Here&rsquo;s a basic example illustrating how to use MqttDigitalAdapter:</p><h4 id=getting-started>Getting Started:<a href=#getting-started class=anchor aria-hidden=true>#</a></h4><p>Create HttpDigitalAdapterConfiguration:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=n>HttpDigitalAdapterConfiguration</span> <span class=n>config</span> <span class=o>=</span> <span class=k>new</span> <span class=n>HttpDigitalAdapterConfiguration</span><span class=o>(</span><span class=s>&#34;my-http-adapter&#34;</span><span class=o>,</span> <span class=s>&#34;localhost&#34;</span><span class=o>,</span> <span class=mi>8080</span><span class=o>);</span>
+</span></span></code></pre></div><p>Instantiate HttpDigitalAdapter:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=n>DigitalTwin</span> <span class=n>digitalTwin</span> <span class=o>=</span> <span class=k>new</span> <span class=n>DigitalTwin</span><span class=o>(</span><span class=s>&#34;my-digital-twin&#34;</span><span class=o>,</span> <span class=k>new</span> <span class=n>DefaultShadowingFunction</span><span class=o>());</span>
+</span></span><span class=line><span class=cl><span class=n>HttpDigitalAdapter</span> <span class=n>httpDigitalAdapter</span> <span class=o>=</span> <span class=k>new</span> <span class=n>HttpDigitalAdapter</span><span class=o>(</span><span class=n>config</span><span class=o>,</span> <span class=n>digitalTwin</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=c1>// Add a Physical Adapter to the DT
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=o>[...]</span>
+</span></span></code></pre></div><p>Add HttpDigitalAdapter to DigitalTwin:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=n>digitalTwin</span><span class=o>.</span><span class=na>addDigitalAdapter</span><span class=o>(</span><span class=n>httpDigitalAdapter</span><span class=o>);</span>
+</span></span></code></pre></div><p>Start the Digital Twin Engine:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=n>DigitalTwinEngine</span> <span class=n>digitalTwinEngine</span> <span class=o>=</span> <span class=k>new</span> <span class=n>DigitalTwinEngine</span><span class=o>();</span>
+</span></span><span class=line><span class=cl><span class=n>digitalTwinEngine</span><span class=o>.</span><span class=na>addDigitalTwin</span><span class=o>(</span><span class=n>digitalTwin</span><span class=o>);</span>
+</span></span><span class=line><span class=cl><span class=n>digitalTwinEngine</span><span class=o>.</span><span class=na>startAll</span><span class=o>();</span>
+</span></span></code></pre></div><h2 id=http-restful-api>HTTP RESTful API<a href=#http-restful-api class=anchor aria-hidden=true>#</a></h2><p>This section of the documentation provides detailed information about the RESTful API exposed by the WLDT - HTTP Digital Adapter.
+The API allows you to interact with the Digital Twin (DT) instance, retrieve its state, read properties, actions, event and relationships description,
+and trigger actions.</p><p>Available endpoints with the associated methods are:</p><ul><li><code>GET</code> <code>/instance</code>: Retrieves information about the Digital Twin instance.</li><li><code>GET</code> <code>/state</code>: Retrieves the current state of the Digital Twin.</li><li><code>GET</code> <code>/state/changes</code>: Retrieves the list of state changes in the Digital Twin.</li><li><code>GET</code> <code>/state/previous</code>: Retrieves the previous state of the Digital Twin.</li><li><code>GET</code> <code>/state/properties</code>: Retrieves the list of properties in the Digital Twin state.</li><li><code>GET</code> <code>/properties/{propertyKey}</code>: Retrieves the value of a specific property (e.g., /properties/color) from the Digital Twin state.</li><li><code>GET</code> <code>/state/events</code>: Retrieves the list of events in the Digital Twin state.</li><li><code>GET</code> <code>/state/actions</code>: Retrieves the list of actions in the Digital Twin state.</li><li><code>POST</code> <code>/state/actions/{actionKey}</code>: Triggers the specified action (e.g., /state/actions/switch_on) in the Digital Twin state. The raw body contains the action request payload.</li><li><code>GET</code> <code>/state/relationships</code>: Retrieves the list of relationships in the Digital Twin state.</li><li><code>GET</code> <code>/state/relationships/{relationshipName}/instances</code>: Retrieves the instances of the specified relationship (e.g., /state/relationships/insideIn/instances) in the Digital Twin state.</li></ul><p>Note: Replace {propertyKey}, {actionKey}, and {relationshipName} with the actual values you want to retrieve or trigger.
+Make sure to use the appropriate HTTP method (GET, POST) and include any required parameters or payload as described in each endpoint&rsquo;s description. For more detailed information, refer to the Postman Collection for this API available in the folder <code>api</code>: <a href=api%2Fhttp_adapter_api_postman.json>http_adapter_api_postman.json</a>`</p><div class="page-footer-meta d-flex flex-column flex-md-row justify-content-between"><div class=last-modified><a href=https://github.com/wldt/wldt.github.io/commit/ab5a164de259055162e9420d8cb56c2b1562dee9><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-calendar"><rect x="3" y="4" width="18" height="18" rx="2" ry="2"/><line x1="16" y1="2" x2="16" y2="6"/><line x1="8" y1="2" x2="8" y2="6"/><line x1="3" y1="10" x2="21" y2="10"/></svg>Last updated on February 9, 2024</a></div><div class=edit-page><a href=https://github.com/wldt/wldt.github.io/blob/main/content//docs/adapters/http_digital.md><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-edit-2"><path d="M17 3a2.828 2.828.0 114 4L7.5 20.5 2 22l1.5-5.5L17 3z"/></svg>Edit this page on GitHub</a></div></div><div class="page-nav d-flex flex-column flex-sm-row"><div class="card w-100"><div class="card-body d-flex"><div class="d-flex flex-column justify-content-center"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-arrow-left" width="20" height="20" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 12h14"/><path d="M5 12l6 6"/><path d="M5 12l6-6"/></svg></div><div class="d-flex flex-column"><div class=text-body-secondary>Prev</div><a href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/ class="stretched-link text-reset text-decoration-none">Change Log 0.3.0</a></div></div></div><div class=m-2></div><div class="card text-end w-100"><div class="card-body d-flex justify-content-end"><div class="d-flex flex-column"><div class=text-body-secondary>Next</div><a href=https://wldt.github.io/docs/introduction/dt-model/ class="stretched-link text-reset text-decoration-none">DT Model</a></div><div class="d-flex flex-column justify-content-center"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-arrow-right" width="20" height="20" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 12h14"/><path d="M13 18l6-6"/><path d="M13 6l6 6"/></svg></div></div></div></div></main></div></div></div><footer class="footer text-muted"><div class=container-lg><div class=row><div class="col-lg-8 text-center text-lg-start"><ul class=list-inline><li class=list-inline-item><a class=text-muted href=https://wldt.github.io/privacy/>Privacy Policy</a></li></ul></div><div class="col-lg-8 text-center text-lg-end"><ul class=list-inline><li class=list-inline-item>Brought to you by <a class=text-muted href=https://gethyas.com/>Hyas</a></li></ul></div></div></div></footer><script async src=https://wldt.github.io/js/app.1e84dcdaa5ccef6fe83f6d88ac1e444a1f237111cfa2a7a97427f758e9c27ef4.js integrity="sha256-HoTc2qXM72/oP22IrB5ESh8jcRHPoqepdCf3WOnCfvQ="></script>
+<script async src=https://wldt.github.io/js/flexsearch.dc00caef2c3490dbab3c345ed0d4133b0aafb803efeb21c3df80776d6d3ea821.js integrity="sha256-3ADK7yw0kNurPDRe0NQTOwqvuAPv6yHD34B3bW0+qCE="></script><script async src=https://wldt.github.io/js/search-modal.c4c023efcdee308e4b5f1110afe1db6b1656f217e67aa7efe54e2f4bf2feccf8.js integrity="sha256-xMAj783uMI5LXxEQr+HbaxZW8hfmeqfv5U4vS/L+zPg="></script><div class="d-inline-flex fixed-bottom-right pb-4 pe-4"><button id=toTop type=button class="btn btn-primary rounded-circle ms-auto p-2"><span class=visually-hidden>Top</span><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-chevron-up" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M6 15l6-6 6 6"/></svg></button></div></body></html>
\ No newline at end of file
diff --git a/docs/adapters/index.html b/docs/adapters/index.html
new file mode 100644
index 0000000..ebb4f11
--- /dev/null
+++ b/docs/adapters/index.html
@@ -0,0 +1,11 @@
+<!doctype html><html lang=en data-bs-theme=auto><head><meta charset=utf-8><meta http-equiv=x-ua-compatible content="ie=edge"><meta name=viewport content="width=device-width,initial-scale=1"><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-regular.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-500.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-700.woff2 type=font/woff2 crossorigin><script src=https://wldt.github.io/js/color-mode.86a91f050a481d0a3f0c72ac26543cb6228c770875981c58dcbc008fd3f875c8.js integrity="sha256-hqkfBQpIHQo/DHKsJlQ8tiKMdwh1mBxY3LwAj9P4dcg="></script>
+<link rel=stylesheet href=https://wldt.github.io/main.5fb433a44687c98f7ae7b3d0137c762777049ba27235e1f08c279c03c8533a7a9a1e3b0ef5b125a31b6bb63a362cdcbc39c3706ed41ad7f1a620b9281013866c.css integrity="sha512-X7QzpEaHyY9657PQE3x2J3cEm6JyNeHwjCecA8hTOnqaHjsO9bEloxtrtjo2LNy8OcNwbtQa1/GmILkoEBOGbA==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>Adapters | WLDT</title><meta property="canonical" content="https://wldt.github.io/docs/adapters/"><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/docs/adapters/"><meta property="og:title" content="Adapters"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:section" content="docs"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-model/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-life-cycle/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/library-structure-basic-concepts/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/physical-adapter/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/shadowing-function/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/digital-adapter/"><meta name=twitter:card content="summary"><meta name=twitter:title content="Adapters"><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","item":"https://wldt.github.io/docs/","name":"Docs","position":2},{"@type":"ListItem","name":"Adapters","position":3}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="list section docs" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
+<button type=button id=searchToggleMobile class="btn btn-link nav-link mx-2 d-lg-none" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button class="btn btn-link d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavSection aria-controls=offcanvasNavSection aria-label="Open section navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-dots-vertical" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 19m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 5m-1 0a1 1 0 102 0 1 1 0 10-2 0"/></svg></button><div class="offcanvas offcanvas-start d-lg-none" tabindex=-1 id=offcanvasNavSection aria-labelledby=offcanvasNavSectionLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavSectionLabel>Docs</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class=offcanvas-body><aside class="doks-sidebar mt-n3"><nav id=doks-docs-nav aria-label="Tertiary navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-0b79795d3efc95b9976c7c5b933afce2 aria-expanded=false>
+Introduction</button><div class=collapse id=section-0b79795d3efc95b9976c7c5b933afce2><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-model/>DT Model</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-life-cycle/>DT Life Cycle</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/>Library Structure & Basic Concepts</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-3978929206deee2c125a1d732aae5545 aria-expanded=false>
+Change Logs</button><div class=collapse id=section-3978929206deee2c125a1d732aae5545><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/>Change Log 0.3.0</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-89413bd312d0909efb85e6693f36cb89 aria-expanded=true>
+Adapters</button><div class="collapse show" id=section-89413bd312d0909efb85e6693f36cb89><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/>MQTT Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/>MQTT Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/http-digital-adapter/>HTTP Digital Adapter</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-bf647454e36069fd16f1a7a35cf6a865 aria-expanded=false>
+Getting Started</button><div class=collapse id=section-bf647454e36069fd16f1a7a35cf6a865><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/physical-adapter/>Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/shadowing-function/>Shadowing Function</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-adapter/>Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/>DT Engine & DT Instance</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-actions/>Digital Actions</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/configurable-adapters/>Configurable Adapters</a></li></ul></div></li></ul></nav></aside></div></div><button class="btn btn-link nav-link mx-2 order-3 d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavMain aria-controls=offcanvasNavMain aria-label="Open main navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-menu" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><line x1="4" y1="8" x2="20" y2="8"/><line x1="4" y1="16" x2="20" y2="16"/></svg></button><div class="offcanvas offcanvas-end h-auto" tabindex=-1 id=offcanvasNavMain aria-labelledby=offcanvasNavMainLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavMainLabel>WLDT</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class="offcanvas-body d-flex flex-column flex-lg-row justify-content-between"><ul class="navbar-nav flex-grow-1"><li class=nav-item><a class=nav-link href=https://wldt.github.io/docs/guides/example-guide/>Documentation</a></li><li class=nav-item><a class=nav-link href=https://wldt.github.io/blog/>Blog</a></li></ul><button type=button id=searchToggleDesktop class="btn btn-link nav-link p-2 d-none d-lg-block" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button id=buttonColorMode class="btn btn-link mx-auto nav-link p-0 ms-lg-2 me-lg-1" type=button aria-label="Toggle theme"><svg data-bs-theme-value="dark" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-moon" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 3c.132.0.263.0.393.0a7.5 7.5.0 007.92 12.446A9 9 0 1112 2.992z"/></svg><svg data-bs-theme-value="light" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-sun" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-4 0a4 4 0 108 0 4 4 0 10-8 0m-5 0h1m8-9v1m8 8h1m-9 8v1M5.6 5.6l.7.7m12.1-.7-.7.7m0 11.4.7.7m-12.1-.7-.7.7"/></svg></button><ul id=socialMenu class="nav mx-auto flex-row order-lg-4"><li class=nav-item><a class="nav-link social-link" href=https://github.com/wldt><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-brand-github" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 19c-4.3 1.4-4.3-2.5-6-3m12 5v-3.5c0-1 .1-1.4-.5-2 2.8-.3 5.5-1.4 5.5-6a4.6 4.6.0 00-1.3-3.2 4.2 4.2.0 00-.1-3.2s-1.1-.3-3.5 1.3a12.3 12.3.0 00-6.2.0C6.5 2.8 5.4 3.1 5.4 3.1a4.2 4.2.0 00-.1 3.2A4.6 4.6.0 004 9.5c0 4.6 2.7 5.7 5.5 6-.6.6-.6 1.2-.5 2V21"/></svg><small class="ms-2 visually-hidden">GitHub</small></a></li></ul></div></div></div></header></div><div class=modal id=searchModal tabindex=-1 aria-labelledby=searchModalLabel aria-hidden=true><div class="modal-dialog modal-dialog-scrollable modal-fullscreen-md-down"><div class=modal-content><div class=modal-header><h1 class="modal-title fs-5 visually-hidden" id=searchModalLabel>Search</h1><button type=button class="btn-close visually-hidden" data-bs-dismiss=modal aria-label=Close></button><div class="search-input flex-grow-1 d-none"><form id=search-form class=search-form action=# method=post accept-charset=utf-8 role=search><label for=query class=visually-hidden>Search</label><div class=d-flex><input type=search id=query name=query class="search-text form-control form-control-lg" placeholder=Search aria-label=Search maxlength=128 autocomplete=off>
+<button type=button class="btn btn-link text-decoration-none px-0 ms-3 d-md-none" data-bs-dismiss=modal aria-label=Close>Cancel</button></div></form></div></div><div class=modal-body><p class="search-loading status message d-none mt-3 text-center">Loading search index…</p><p class="search-no-recent message d-none mt-3 text-center">No recent searches</p><p class="search-no-results message d-none mt-3 text-center">No results for "<strong><span class=query-no-results>Query here</span></strong>"</p><div id=searchResults class=search-results></div><template><article class="search-result list-view"><div class="card my-3"><div class=card-body><header><h2 class="h5 title title-submitted mb-0"><a class="stretched-link text-decoration-none text-reset" href=#>Title here</a></h2><div class="submitted d-none"><time class=created-date>Date here</time></div></header><div class=content>Summary here</div></div></div></article></template></div><div class=modal-footer><ul class="list-inline me-auto d-none d-md-block"><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Enter key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M12 3.53088v3c0 1-1 2-2 2H4m3 3-3-3 3-3"/></g></svg></kbd><span class=DocSearch-Label>to select</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Arrow down" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 3.5v8m3-3-3 3-3-3"/></g></svg></kbd><kbd class=me-2><svg width="15" height="15" aria-label="Arrow up" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 11.5v-8m3 3-3-3-3 3"/></g></svg></kbd><span class=DocSearch-Label>to navigate</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Escape key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M13.6167 8.936c-.1065.3583-.6883.962-1.4875.962-.7993.0-1.653-.9165-1.653-2.1258v-.5678c0-1.2548.7896-2.1016 1.653-2.1016s1.3601.4778 1.4875 1.0724M9 6c-.1352-.4735-.7506-.9219-1.46-.8972-.7092.0246-1.344.57-1.344 1.2166s.4198.8812 1.3445.9805C8.465 7.3992 8.968 7.9337 9 8.5s-.454 1.398-1.4595 1.398C6.6593 9.898 6 9 5.963 8.4851m-1.4748.5368c-.2635.5941-.8099.876-1.5443.876s-1.7073-.6248-1.7073-2.204v-.4603c0-1.0416.721-2.131 1.7073-2.131.9864.0 1.6425 1.031 1.5443 2.2492h-2.956"/></g></svg></kbd><span class=DocSearch-Label>to close</span></li></ul><p class=d-md-none>Search by <a class=text-decoration-none href=https://github.com/nextapps-de/flexsearch>FlexSearch</a></p></div></div></div></div><div class="wrap container-lg" role=document><div class=content><div class="row justify-content-center"><div class="col-md-12 col-lg-10 col-xl-8"><article><h1 class=text-center>Adapters</h1><div class=card-list><div class="card my-3"><div class=card-body><a class=stretched-link href=https://wldt.github.io/docs/adapters/http-digital-adapter/>HTTP Digital Adapter &rarr;</a></div></div><div class="card my-3"><div class=card-body><a class=stretched-link href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/>MQTT Digital Adapter &rarr;</a></div></div><div class="card my-3"><div class=card-body><a class=stretched-link href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/>MQTT Physical Adapter &rarr;</a></div></div></div></article></div></div></div></div><footer class="footer text-muted"><div class=container-lg><div class=row><div class="col-lg-8 text-center text-lg-start"><ul class=list-inline><li class=list-inline-item><a class=text-muted href=https://wldt.github.io/privacy/>Privacy Policy</a></li></ul></div><div class="col-lg-8 text-center text-lg-end"><ul class=list-inline><li class=list-inline-item>Brought to you by <a class=text-muted href=https://gethyas.com/>Hyas</a></li></ul></div></div></div></footer><script async src=https://wldt.github.io/js/app.1e84dcdaa5ccef6fe83f6d88ac1e444a1f237111cfa2a7a97427f758e9c27ef4.js integrity="sha256-HoTc2qXM72/oP22IrB5ESh8jcRHPoqepdCf3WOnCfvQ="></script>
+<script async src=https://wldt.github.io/js/flexsearch.dc00caef2c3490dbab3c345ed0d4133b0aafb803efeb21c3df80776d6d3ea821.js integrity="sha256-3ADK7yw0kNurPDRe0NQTOwqvuAPv6yHD34B3bW0+qCE="></script><script async src=https://wldt.github.io/js/search-modal.c4c023efcdee308e4b5f1110afe1db6b1656f217e67aa7efe54e2f4bf2feccf8.js integrity="sha256-xMAj783uMI5LXxEQr+HbaxZW8hfmeqfv5U4vS/L+zPg="></script><div class="d-inline-flex fixed-bottom-right pb-4 pe-4"><button id=toTop type=button class="btn btn-primary rounded-circle ms-auto p-2"><span class=visually-hidden>Top</span><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-chevron-up" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M6 15l6-6 6 6"/></svg></button></div></body></html>
\ No newline at end of file
diff --git a/docs/adapters/index.xml b/docs/adapters/index.xml
new file mode 100644
index 0000000..420bbd6
--- /dev/null
+++ b/docs/adapters/index.xml
@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Adapters on WLDT</title><link>https://wldt.github.io/docs/adapters/</link><description>Recent content in Adapters on WLDT</description><generator>Hugo -- gohugo.io</generator><language>en</language><copyright>Copyright (c) 2023 Hyas</copyright><lastBuildDate>Fri, 09 Feb 2024 12:55:37 +0100</lastBuildDate><atom:link href="https://wldt.github.io/docs/adapters/index.xml" rel="self" type="application/rss+xml"/><item><title>MQTT Physical Adapter</title><link>https://wldt.github.io/docs/adapters/mqtt-physical-adapter/</link><pubDate>Fri, 09 Feb 2024 12:55:52 +0100</pubDate><guid>https://wldt.github.io/docs/adapters/mqtt-physical-adapter/</guid><description>The MqttPhysicalAdapter library provides a streamlined solution for efficiently managing physical assets through the MQTT protocol. It offers a range of features, including a versatile builder for effortless configuration of MQTT connections, dedicated classes for handling both incoming and outgoing topics, and a specialized adapter designed for seamless integration with diverse physical assets.</description></item><item><title>MQTT Digital Adapter</title><link>https://wldt.github.io/docs/adapters/mqtt-digital-adapter/</link><pubDate>Fri, 09 Feb 2024 12:58:14 +0100</pubDate><guid>https://wldt.github.io/docs/adapters/mqtt-digital-adapter/</guid><description>The MqttDigitalAdapter,
+MqttDigitalAdapterConfiguration, and MqttDigitalAdapterConfigurationBuilder classes and guides you through using these classes to set up an MQTT Digital Adapter within WLDT.</description></item><item><title>HTTP Digital Adapter</title><link>https://wldt.github.io/docs/adapters/http-digital-adapter/</link><pubDate>Fri, 09 Feb 2024 13:00:26 +0100</pubDate><guid>https://wldt.github.io/docs/adapters/http-digital-adapter/</guid><description>The HttpDigitalAdapter is a powerful component designed to facilitate the integration of Digital Twins into HTTP-based systems. It serves as a bridge between a Digital Twin and HTTP-based applications, allowing developers to easily expose and interact with Digital Twin data and functionalities over HTTP.</description></item></channel></rss>
\ No newline at end of file
diff --git a/docs/adapters/mqtt-digital-adapter/index.html b/docs/adapters/mqtt-digital-adapter/index.html
new file mode 100644
index 0000000..e2c3579
--- /dev/null
+++ b/docs/adapters/mqtt-digital-adapter/index.html
@@ -0,0 +1,59 @@
+<!doctype html><html lang=en data-bs-theme=auto><head><meta charset=utf-8><meta http-equiv=x-ua-compatible content="ie=edge"><meta name=viewport content="width=device-width,initial-scale=1"><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-regular.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-500.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-700.woff2 type=font/woff2 crossorigin><script src=https://wldt.github.io/js/color-mode.86a91f050a481d0a3f0c72ac26543cb6228c770875981c58dcbc008fd3f875c8.js integrity="sha256-hqkfBQpIHQo/DHKsJlQ8tiKMdwh1mBxY3LwAj9P4dcg="></script>
+<link rel=stylesheet href=https://wldt.github.io/main.5fb433a44687c98f7ae7b3d0137c762777049ba27235e1f08c279c03c8533a7a9a1e3b0ef5b125a31b6bb63a362cdcbc39c3706ed41ad7f1a620b9281013866c.css integrity="sha512-X7QzpEaHyY9657PQE3x2J3cEm6JyNeHwjCecA8hTOnqaHjsO9bEloxtrtjo2LNy8OcNwbtQa1/GmILkoEBOGbA==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>MQTT Digital Adapter | WLDT</title><meta property="canonical" content="https://wldt.github.io/docs/adapters/mqtt-digital-adapter/"><meta name=description content="The MqttDigitalAdapter,
+MqttDigitalAdapterConfiguration, and MqttDigitalAdapterConfigurationBuilder classes and guides you through using these classes to set up an MQTT Digital Adapter within WLDT."><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/docs/adapters/mqtt-digital-adapter/"><meta property="og:title" content="MQTT Digital Adapter"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:section" content="docs"><meta property="og:description" content="The MqttDigitalAdapter,
+MqttDigitalAdapterConfiguration, and MqttDigitalAdapterConfigurationBuilder classes and guides you through using these classes to set up an MQTT Digital Adapter within WLDT."><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-model/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-life-cycle/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/library-structure-basic-concepts/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/physical-adapter/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/shadowing-function/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/digital-adapter/"><meta name=twitter:card content="summary"><meta name=twitter:title content="MQTT Digital Adapter"><meta name=twitter:description content="The MqttDigitalAdapter,
+MqttDigitalAdapterConfiguration, and MqttDigitalAdapterConfigurationBuilder classes and guides you through using these classes to set up an MQTT Digital Adapter within WLDT."><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","item":"https://wldt.github.io/docs/","name":"Docs","position":2},{"@type":"ListItem","item":"https://wldt.github.io/docs/adapters/","name":"Adapters","position":3},{"@type":"ListItem","name":"MQTT Digital Adapter","position":4}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="single section docs" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
+<button type=button id=searchToggleMobile class="btn btn-link nav-link mx-2 d-lg-none" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button class="btn btn-link d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavSection aria-controls=offcanvasNavSection aria-label="Open section navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-dots-vertical" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 19m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 5m-1 0a1 1 0 102 0 1 1 0 10-2 0"/></svg></button><div class="offcanvas offcanvas-start d-lg-none" tabindex=-1 id=offcanvasNavSection aria-labelledby=offcanvasNavSectionLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavSectionLabel>Docs</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class=offcanvas-body><aside class="doks-sidebar mt-n3"><nav id=doks-docs-nav aria-label="Tertiary navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-0b79795d3efc95b9976c7c5b933afce2 aria-expanded=false>
+Introduction</button><div class=collapse id=section-0b79795d3efc95b9976c7c5b933afce2><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-model/>DT Model</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-life-cycle/>DT Life Cycle</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/>Library Structure & Basic Concepts</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-3978929206deee2c125a1d732aae5545 aria-expanded=false>
+Change Logs</button><div class=collapse id=section-3978929206deee2c125a1d732aae5545><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/>Change Log 0.3.0</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-89413bd312d0909efb85e6693f36cb89 aria-expanded=true>
+Adapters</button><div class="collapse show" id=section-89413bd312d0909efb85e6693f36cb89><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/>MQTT Physical Adapter</a></li><li><a class="docs-link rounded active" href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/>MQTT Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/http-digital-adapter/>HTTP Digital Adapter</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-bf647454e36069fd16f1a7a35cf6a865 aria-expanded=false>
+Getting Started</button><div class=collapse id=section-bf647454e36069fd16f1a7a35cf6a865><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/physical-adapter/>Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/shadowing-function/>Shadowing Function</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-adapter/>Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/>DT Engine & DT Instance</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-actions/>Digital Actions</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/configurable-adapters/>Configurable Adapters</a></li></ul></div></li></ul></nav></aside></div></div><button class="btn btn-link nav-link mx-2 order-3 d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavMain aria-controls=offcanvasNavMain aria-label="Open main navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-menu" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><line x1="4" y1="8" x2="20" y2="8"/><line x1="4" y1="16" x2="20" y2="16"/></svg></button><div class="offcanvas offcanvas-end h-auto" tabindex=-1 id=offcanvasNavMain aria-labelledby=offcanvasNavMainLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavMainLabel>WLDT</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class="offcanvas-body d-flex flex-column flex-lg-row justify-content-between"><ul class="navbar-nav flex-grow-1"><li class=nav-item><a class=nav-link href=https://wldt.github.io/docs/guides/example-guide/>Documentation</a></li><li class=nav-item><a class=nav-link href=https://wldt.github.io/blog/>Blog</a></li></ul><button type=button id=searchToggleDesktop class="btn btn-link nav-link p-2 d-none d-lg-block" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button id=buttonColorMode class="btn btn-link mx-auto nav-link p-0 ms-lg-2 me-lg-1" type=button aria-label="Toggle theme"><svg data-bs-theme-value="dark" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-moon" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 3c.132.0.263.0.393.0a7.5 7.5.0 007.92 12.446A9 9 0 1112 2.992z"/></svg><svg data-bs-theme-value="light" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-sun" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-4 0a4 4 0 108 0 4 4 0 10-8 0m-5 0h1m8-9v1m8 8h1m-9 8v1M5.6 5.6l.7.7m12.1-.7-.7.7m0 11.4.7.7m-12.1-.7-.7.7"/></svg></button><ul id=socialMenu class="nav mx-auto flex-row order-lg-4"><li class=nav-item><a class="nav-link social-link" href=https://github.com/wldt><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-brand-github" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 19c-4.3 1.4-4.3-2.5-6-3m12 5v-3.5c0-1 .1-1.4-.5-2 2.8-.3 5.5-1.4 5.5-6a4.6 4.6.0 00-1.3-3.2 4.2 4.2.0 00-.1-3.2s-1.1-.3-3.5 1.3a12.3 12.3.0 00-6.2.0C6.5 2.8 5.4 3.1 5.4 3.1a4.2 4.2.0 00-.1 3.2A4.6 4.6.0 004 9.5c0 4.6 2.7 5.7 5.5 6-.6.6-.6 1.2-.5 2V21"/></svg><small class="ms-2 visually-hidden">GitHub</small></a></li></ul></div></div></div></header></div><div class=modal id=searchModal tabindex=-1 aria-labelledby=searchModalLabel aria-hidden=true><div class="modal-dialog modal-dialog-scrollable modal-fullscreen-md-down"><div class=modal-content><div class=modal-header><h1 class="modal-title fs-5 visually-hidden" id=searchModalLabel>Search</h1><button type=button class="btn-close visually-hidden" data-bs-dismiss=modal aria-label=Close></button><div class="search-input flex-grow-1 d-none"><form id=search-form class=search-form action=# method=post accept-charset=utf-8 role=search><label for=query class=visually-hidden>Search</label><div class=d-flex><input type=search id=query name=query class="search-text form-control form-control-lg" placeholder=Search aria-label=Search maxlength=128 autocomplete=off>
+<button type=button class="btn btn-link text-decoration-none px-0 ms-3 d-md-none" data-bs-dismiss=modal aria-label=Close>Cancel</button></div></form></div></div><div class=modal-body><p class="search-loading status message d-none mt-3 text-center">Loading search index…</p><p class="search-no-recent message d-none mt-3 text-center">No recent searches</p><p class="search-no-results message d-none mt-3 text-center">No results for "<strong><span class=query-no-results>Query here</span></strong>"</p><div id=searchResults class=search-results></div><template><article class="search-result list-view"><div class="card my-3"><div class=card-body><header><h2 class="h5 title title-submitted mb-0"><a class="stretched-link text-decoration-none text-reset" href=#>Title here</a></h2><div class="submitted d-none"><time class=created-date>Date here</time></div></header><div class=content>Summary here</div></div></div></article></template></div><div class=modal-footer><ul class="list-inline me-auto d-none d-md-block"><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Enter key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M12 3.53088v3c0 1-1 2-2 2H4m3 3-3-3 3-3"/></g></svg></kbd><span class=DocSearch-Label>to select</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Arrow down" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 3.5v8m3-3-3 3-3-3"/></g></svg></kbd><kbd class=me-2><svg width="15" height="15" aria-label="Arrow up" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 11.5v-8m3 3-3-3-3 3"/></g></svg></kbd><span class=DocSearch-Label>to navigate</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Escape key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M13.6167 8.936c-.1065.3583-.6883.962-1.4875.962-.7993.0-1.653-.9165-1.653-2.1258v-.5678c0-1.2548.7896-2.1016 1.653-2.1016s1.3601.4778 1.4875 1.0724M9 6c-.1352-.4735-.7506-.9219-1.46-.8972-.7092.0246-1.344.57-1.344 1.2166s.4198.8812 1.3445.9805C8.465 7.3992 8.968 7.9337 9 8.5s-.454 1.398-1.4595 1.398C6.6593 9.898 6 9 5.963 8.4851m-1.4748.5368c-.2635.5941-.8099.876-1.5443.876s-1.7073-.6248-1.7073-2.204v-.4603c0-1.0416.721-2.131 1.7073-2.131.9864.0 1.6425 1.031 1.5443 2.2492h-2.956"/></g></svg></kbd><span class=DocSearch-Label>to close</span></li></ul><p class=d-md-none>Search by <a class=text-decoration-none href=https://github.com/nextapps-de/flexsearch>FlexSearch</a></p></div></div></div></div><div class="wrap container-lg" role=document><div class=content><div class="row flex-xl-nowrap"><div class="col-lg-5 col-xl-4 docs-sidebar d-none d-lg-block"><nav class=docs-links aria-label="Main navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-0b79795d3efc95b9976c7c5b933afce2 aria-expanded=false>
+Introduction</button><div class=collapse id=section-0b79795d3efc95b9976c7c5b933afce2><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-model/>DT Model</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-life-cycle/>DT Life Cycle</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/>Library Structure & Basic Concepts</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-3978929206deee2c125a1d732aae5545 aria-expanded=false>
+Change Logs</button><div class=collapse id=section-3978929206deee2c125a1d732aae5545><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/>Change Log 0.3.0</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-89413bd312d0909efb85e6693f36cb89 aria-expanded=true>
+Adapters</button><div class="collapse show" id=section-89413bd312d0909efb85e6693f36cb89><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/>MQTT Physical Adapter</a></li><li><a class="docs-link rounded active" href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/>MQTT Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/http-digital-adapter/>HTTP Digital Adapter</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-bf647454e36069fd16f1a7a35cf6a865 aria-expanded=false>
+Getting Started</button><div class=collapse id=section-bf647454e36069fd16f1a7a35cf6a865><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/physical-adapter/>Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/shadowing-function/>Shadowing Function</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-adapter/>Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/>DT Engine & DT Instance</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-actions/>Digital Actions</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/configurable-adapters/>Configurable Adapters</a></li></ul></div></li></ul></nav></div><nav class="docs-toc d-none d-xl-block col-xl-3" aria-label="Secondary navigation"><div class=page-links><h3>Example Guide</h3><nav id=toc><ul><li><a href=#wldt-core-version-compatibility>WLDT-Core Version Compatibility</a></li><li><a href=#installation>Installation</a><ul><li><a href=#maven>Maven</a></li><li><a href=#gradle>Gradle</a></li></ul></li><li><a href=#class-structure--functionalities>Class Structure & Functionalities</a><ul><li><a href=#mqttdigitaladapterconfiguration>MqttDigitalAdapterConfiguration</a></li><li><a href=#mqttdigitaladapterconfigurationbuilder>MqttDigitalAdapterConfigurationBuilder</a></li><li><a href=#mqttdigitaladapter>MqttDigitalAdapter</a></li></ul></li></ul></nav></div></nav><main class="docs-content col-lg-11 col-xl-9"><nav aria-label=breadcrumb><ol class=breadcrumb><li class=breadcrumb-item><a href=https://wldt.github.io/>Home</a></li><li class=breadcrumb-item><a href=https://wldt.github.io/docs/>Docs</a></li><li class=breadcrumb-item><a href=https://wldt.github.io/docs/adapters/>Adapters</a></li><li class="breadcrumb-item active" aria-current=page>MQTT Digital Adapter</li></ol></nav><h1>MQTT Digital Adapter</h1><nav class="toc-mobile d-xl-none" aria-label="Quaternary navigation"><details><summary>On this page</summary><div class=page-links><nav id=TableOfContents><ul><li><a href=#wldt-core-version-compatibility>WLDT-Core Version Compatibility</a></li><li><a href=#installation>Installation</a><ul><li><a href=#maven>Maven</a></li><li><a href=#gradle>Gradle</a></li></ul></li><li><a href=#class-structure--functionalities>Class Structure & Functionalities</a><ul><li><a href=#mqttdigitaladapterconfiguration>MqttDigitalAdapterConfiguration</a></li><li><a href=#mqttdigitaladapterconfigurationbuilder>MqttDigitalAdapterConfigurationBuilder</a></li><li><a href=#mqttdigitaladapter>MqttDigitalAdapter</a></li></ul></li></ul></nav></div></details></nav><p>The <code>MqttDigitalAdapter</code>,<br><code>MqttDigitalAdapterConfiguration</code>, and <code>MqttDigitalAdapterConfigurationBuilder</code> classes and guides you through using these classes to set up an MQTT Digital Adapter within WLDT.</p><p>Requires an external MQTT broker to send messages.</p><p>Main functionalities are:</p><ul><li>Manages the interaction between the Digital Twin and external systems.</li><li>Handles state updates, events, and property changes.</li><li>Dynamic configuration of the MqttDigitalAdapter with broker details, topics, and other settings.</li><li>Allows customization of data and payload management associated to MQTT topics for properties, events, and actions.</li></ul><div align=center><img class=center src=images/adapter_schema.jpg width=100%></div><p>Prerequisites:</p><ul><li><strong>External MQTT Broker:</strong> The MqttDigitalAdapter library requires an external MQTT broker for optimal functionality and communication.</li><li>Users must have access to a reliable MQTT broker to which the adapter can subscribe and publish.</li><li>This external broker serves as the central communication hub, facilitating the exchange of messages between the adapter and digital applications</li></ul><p>A complete example is provided in the <code>test</code> folder with a complete DT Creation in the <code>TestMain</code> class together with MQTT IoT demo device and
+a test MQTT consumer.</p><h2 id=wldt-core-version-compatibility>WLDT-Core Version Compatibility<a href=#wldt-core-version-compatibility class=anchor aria-hidden=true>#</a></h2><p>The correct mapping and compatibility between versions is reported in the following table</p><table><thead><tr><th style=text-align:center><strong>mqtt-digital-adapter</strong></th><th style=text-align:center>wldt-core 0.2.1</th><th style=text-align:center>wldt-core 0.3.0</th></tr></thead><tbody><tr><td style=text-align:center>0.1.0</td><td style=text-align:center>✅</td><td style=text-align:center>❌</td></tr><tr><td style=text-align:center>0.1.1</td><td style=text-align:center>❌</td><td style=text-align:center>✅</td></tr></tbody></table><h2 id=installation>Installation<a href=#installation class=anchor aria-hidden=true>#</a></h2><p>To use MqttDigitalAdapter in your Java project, you can include it as a dependency using Maven or Gradle.</p><h3 id=maven>Maven<a href=#maven class=anchor aria-hidden=true>#</a></h3><div class=highlight><pre tabindex=0 class=chroma><code class=language-xml data-lang=xml><span class=line><span class=cl><span class=nt>&lt;dependency&gt;</span>
+</span></span><span class=line><span class=cl>    <span class=nt>&lt;groupId&gt;</span>io.github.wldt<span class=nt>&lt;/groupId&gt;</span>
+</span></span><span class=line><span class=cl>    <span class=nt>&lt;artifactId&gt;</span>mqtt-digital-adapter<span class=nt>&lt;/artifactId&gt;</span>
+</span></span><span class=line><span class=cl>    <span class=nt>&lt;version&gt;</span>0.1.1<span class=nt>&lt;/version&gt;</span>
+</span></span><span class=line><span class=cl><span class=nt>&lt;/dependency&gt;</span>
+</span></span></code></pre></div><h3 id=gradle>Gradle<a href=#gradle class=anchor aria-hidden=true>#</a></h3><div class=highlight><pre tabindex=0 class=chroma><code class=language-groovy data-lang=groovy><span class=line><span class=cl><span class=n>implementation</span> <span class=s1>&#39;io.github.wldt:mqtt-digital-adapter:0.1.1&#39;</span>
+</span></span></code></pre></div><h2 id=class-structure--functionalities>Class Structure & Functionalities<a href=#class-structure--functionalities class=anchor aria-hidden=true>#</a></h2><h3 id=mqttdigitaladapterconfiguration>MqttDigitalAdapterConfiguration<a href=#mqttdigitaladapterconfiguration class=anchor aria-hidden=true>#</a></h3><p><code>MqttDigitalAdapterConfiguration</code> is a crucial class in the Digital Twin library, allowing developers to configure the behavior of the MQTT Digital Adapter.
+It provides a flexible and customizable way to set up MQTT communication parameters, topics for properties, events, and actions.</p><p>Key functionalities and exposed capabilities:</p><ul><li><strong>Broker Configuration</strong><ul><li><code>brokerAddress</code> and <code>brokerPort</code>: Set the MQTT broker&rsquo;s address and port.</li><li><code>username</code> and <code>password</code>: Set optional credentials for connecting to the broker.</li></ul></li><li><strong>Client Configuration</strong><ul><li><code>clientId</code>: Unique identifier for the MQTT client.</li><li><code>cleanSessionFlag</code>: Flag indicating whether the client starts with a clean session.</li><li><code>connectionTimeout</code>: Maximum time to wait for the connection to the MQTT broker.</li></ul></li><li><strong>MQTT Client Persistence</strong><ul><li><code>persistence</code>: Configurable persistence for the MQTT client&rsquo;s data.</li></ul></li><li><strong>Reconnect Configuration</strong>:<ul><li><code>automaticReconnectFlag</code>: Flag enabling or disabling automatic reconnection.</li></ul></li><li><strong>Topic Configuration</strong>:<ul><li><code>propertyUpdateTopics</code>: Map of property update topics.</li><li><code>eventNotificationTopics</code>: Map of event notification topics.</li><li><code>actionIncomingTopics</code>: Map of incoming action topics.</li></ul></li><li><strong>Builder Methods</strong>:<ul><li><code>builder</code>: Static method to start building a new configuration.</li><li><code>addPropertyTopic</code>: Add a property topic with specified parameters.</li><li><code>addEventNotificationTopic</code>: Add an event notification topic.</li><li><code>addActionTopic</code>: Add an action topic.</li><li><code>setConnectionTimeout</code>: Set the connection timeout.</li><li><code>setCleanSessionFlag</code>: Set the clean session flag.</li><li><code>setAutomaticReconnectFlag</code>: Set the automatic reconnect flag.</li><li><code>setMqttClientPersistence</code>: Set the MQTT client persistence.</li><li><code>build</code>: Finalize the configuration and build the instance.</li></ul></li></ul><h3 id=mqttdigitaladapterconfigurationbuilder>MqttDigitalAdapterConfigurationBuilder<a href=#mqttdigitaladapterconfigurationbuilder class=anchor aria-hidden=true>#</a></h3><p>The <code>MqttDigitalAdapterConfigurationBuilder</code> is a powerful tool designed to simplify the process of constructing configurations
+for the MQTT Digital Adapter in the Digital Twin library. It offers a fluent and intuitive interface, allowing developers to define various aspects of MQTT communication seamlessly.</p><h4 id=builder-instantiation>Builder Instantiation<a href=#builder-instantiation class=anchor aria-hidden=true>#</a></h4><p>The builder is instantiated by providing essential parameters like brokerAddress and brokerPort or including an optional clientId</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=n>MqttDigitalAdapterConfigurationBuilder</span> <span class=n>builder</span> <span class=o>=</span> <span class=n>MqttDigitalAdapterConfiguration</span><span class=o>.</span><span class=na>builder</span><span class=o>(</span><span class=s>&#34;127.0.0.1&#34;</span><span class=o>,</span> <span class=mi>1883</span><span class=o>);</span>
+</span></span></code></pre></div><h4 id=adding-property-topics>Adding Property Topics<a href=#adding-property-topics class=anchor aria-hidden=true>#</a></h4><p>Developers can add property topics with specific configurations, such as the key, topic, QoS level, and a function to convert property values to payload.</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=n>builder</span><span class=o>.</span><span class=na>addPropertyTopic</span><span class=o>(</span><span class=s>&#34;energy&#34;</span><span class=o>,</span> <span class=s>&#34;dummy/properties/energy&#34;</span><span class=o>,</span> <span class=n>MqttQosLevel</span><span class=o>.</span><span class=na>MQTT_QOS_0</span><span class=o>,</span> <span class=n>value</span> <span class=o>-&gt;</span> <span class=n>String</span><span class=o>.</span><span class=na>valueOf</span><span class=o>(((</span><span class=n>Double</span><span class=o>)</span><span class=n>value</span><span class=o>).</span><span class=na>intValue</span><span class=o>()));</span>
+</span></span></code></pre></div><h4 id=adding-event-notification-topics>Adding Event Notification Topics<a href=#adding-event-notification-topics class=anchor aria-hidden=true>#</a></h4><p>Event notification topics are easily added, including event keys, topics, QoS levels, and payload conversion functions.</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=n>builder</span><span class=o>.</span><span class=na>addEventNotificationTopic</span><span class=o>(</span><span class=s>&#34;overheating&#34;</span><span class=o>,</span> <span class=s>&#34;dummy/events/overheating/notifications&#34;</span><span class=o>,</span> <span class=n>MqttQosLevel</span><span class=o>.</span><span class=na>MQTT_QOS_0</span><span class=o>,</span> <span class=n>Object</span><span class=o>::</span><span class=n>toString</span><span class=o>);</span>
+</span></span></code></pre></div><h4 id=adding-action-topics>Adding Action Topics<a href=#adding-action-topics class=anchor aria-hidden=true>#</a></h4><p>Developers can include action topics with key, topic, and a function to convert the payload to the desired action.</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=n>builder</span><span class=o>.</span><span class=na>addActionTopic</span><span class=o>(</span><span class=s>&#34;switch_off&#34;</span><span class=o>,</span> <span class=s>&#34;app/actions/switch-off&#34;</span><span class=o>,</span> <span class=n>msg</span> <span class=o>-&gt;</span> <span class=s>&#34;OFF&#34;</span><span class=o>);</span>
+</span></span></code></pre></div><h4 id=connection-options>Connection Options<a href=#connection-options class=anchor aria-hidden=true>#</a></h4><p>Developers can set the connection timeout for the MQTT client.</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=n>builder</span><span class=o>.</span><span class=na>setConnectionTimeout</span><span class=o>(</span><span class=mi>30</span><span class=o>);</span>
+</span></span></code></pre></div><p>The clean session flag can be configured based on the desired behavior.</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=n>builder</span><span class=o>.</span><span class=na>setCleanSessionFlag</span><span class=o>(</span><span class=kc>true</span><span class=o>);</span>
+</span></span></code></pre></div><p>Developers can specify whether the MQTT client should automatically reconnect in case of a connection failure.</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=n>builder</span><span class=o>.</span><span class=na>setAutomaticReconnectFlag</span><span class=o>(</span><span class=kc>true</span><span class=o>);</span>
+</span></span></code></pre></div><p>The builder allows setting a custom MQTT client persistence, such as an in-memory persistence or a file-based one.</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=n>builder</span><span class=o>.</span><span class=na>setMqttClientPersistence</span><span class=o>(</span><span class=k>new</span> <span class=n>MemoryPersistence</span><span class=o>());</span>
+</span></span></code></pre></div><h4 id=building-configuration>Building Configuration<a href=#building-configuration class=anchor aria-hidden=true>#</a></h4><p>The final configuration is built using the build method.</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=n>MqttDigitalAdapterConfiguration</span> <span class=n>configuration</span> <span class=o>=</span> <span class=n>builder</span><span class=o>.</span><span class=na>build</span><span class=o>();</span>
+</span></span></code></pre></div><h3 id=mqttdigitaladapter>MqttDigitalAdapter<a href=#mqttdigitaladapter class=anchor aria-hidden=true>#</a></h3><p><code>MqttDigitalAdapter</code> extends DigitalAdapter and specializes in MQTT communication for Digital Twin instances.
+It handles the publication of state updates, events, and property changes over MQTT.
+This class facilitates seamless integration with MQTT-enabled systems.</p><p>It uses the information defined and provided in the `` to handle the communication both with the DT Core and external
+application interested to interact with the DT through the MQTT protocol.</p><p>Here&rsquo;s a basic example illustrating how to use MqttDigitalAdapter:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=c1>// Create a Digital Twin instance
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>DigitalTwin</span> <span class=n>digitalTwin</span> <span class=o>=</span> <span class=k>new</span> <span class=n>DigitalTwin</span><span class=o>(</span><span class=s>&#34;my-digital-twin&#34;</span><span class=o>,</span> <span class=k>new</span> <span class=n>DefaultShadowingFunction</span><span class=o>());</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=c1>// Add a Physical Adapter to the DT 
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=o>[...]</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=c1>// Build the MQTT Digital Adapter Configuration
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>MqttDigitalAdapterConfiguration</span> <span class=n>configuration</span> <span class=o>=</span> <span class=n>MqttDigitalAdapterConfiguration</span><span class=o>.</span><span class=na>builder</span><span class=o>(</span><span class=s>&#34;127.0.0.1&#34;</span><span class=o>,</span> <span class=mi>1883</span><span class=o>)</span>
+</span></span><span class=line><span class=cl>    <span class=o>.</span><span class=na>addPropertyTopic</span><span class=o>(</span><span class=s>&#34;energy&#34;</span><span class=o>,</span> <span class=s>&#34;dummy/properties/energy&#34;</span><span class=o>,</span> <span class=n>MqttQosLevel</span><span class=o>.</span><span class=na>MQTT_QOS_0</span><span class=o>,</span> <span class=n>value</span> <span class=o>-&gt;</span> <span class=n>String</span><span class=o>.</span><span class=na>valueOf</span><span class=o>(((</span><span class=n>Double</span><span class=o>)</span><span class=n>value</span><span class=o>).</span><span class=na>intValue</span><span class=o>()))</span>
+</span></span><span class=line><span class=cl>    <span class=o>.</span><span class=na>addActionTopic</span><span class=o>(</span><span class=s>&#34;switch_off&#34;</span><span class=o>,</span> <span class=s>&#34;app/actions/switch-off&#34;</span><span class=o>,</span> <span class=n>msg</span> <span class=o>-&gt;</span> <span class=s>&#34;OFF&#34;</span><span class=o>)</span>
+</span></span><span class=line><span class=cl>    <span class=o>.</span><span class=na>build</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=c1>// Add the MQTT Digital Adapter to the Digital Twin
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>digitalTwin</span><span class=o>.</span><span class=na>addDigitalAdapter</span><span class=o>(</span><span class=k>new</span> <span class=n>MqttDigitalAdapter</span><span class=o>(</span><span class=s>&#34;mqtt-da&#34;</span><span class=o>,</span> <span class=n>configuration</span><span class=o>));</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=c1>// Create the Digital Twin Engine and start the simulation
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>DigitalTwinEngine</span> <span class=n>digitalTwinEngine</span> <span class=o>=</span> <span class=k>new</span> <span class=n>DigitalTwinEngine</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=n>digitalTwinEngine</span><span class=o>.</span><span class=na>addDigitalTwin</span><span class=o>(</span><span class=n>digitalTwin</span><span class=o>);</span>
+</span></span><span class=line><span class=cl><span class=n>digitalTwinEngine</span><span class=o>.</span><span class=na>startAll</span><span class=o>();</span>
+</span></span></code></pre></div><div class="page-footer-meta d-flex flex-column flex-md-row justify-content-between"><div class=last-modified><a href=https://github.com/wldt/wldt.github.io/commit/ab5a164de259055162e9420d8cb56c2b1562dee9><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-calendar"><rect x="3" y="4" width="18" height="18" rx="2" ry="2"/><line x1="16" y1="2" x2="16" y2="6"/><line x1="8" y1="2" x2="8" y2="6"/><line x1="3" y1="10" x2="21" y2="10"/></svg>Last updated on February 9, 2024</a></div><div class=edit-page><a href=https://github.com/wldt/wldt.github.io/blob/main/content//docs/adapters/mqtt_digital.md><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-edit-2"><path d="M17 3a2.828 2.828.0 114 4L7.5 20.5 2 22l1.5-5.5L17 3z"/></svg>Edit this page on GitHub</a></div></div><div class="page-nav d-flex flex-column flex-sm-row"><div class="card w-100"><div class="card-body d-flex"><div class="d-flex flex-column justify-content-center"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-arrow-left" width="20" height="20" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 12h14"/><path d="M5 12l6 6"/><path d="M5 12l6-6"/></svg></div><div class="d-flex flex-column"><div class=text-body-secondary>Prev</div><a href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/ class="stretched-link text-reset text-decoration-none">MQTT Physical Adapter</a></div></div></div><div class=m-2></div><div class="card text-end w-100"><div class="card-body d-flex justify-content-end"><div class="d-flex flex-column"><div class=text-body-secondary>Next</div><a href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/ class="stretched-link text-reset text-decoration-none">Change Log 0.3.0</a></div><div class="d-flex flex-column justify-content-center"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-arrow-right" width="20" height="20" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 12h14"/><path d="M13 18l6-6"/><path d="M13 6l6 6"/></svg></div></div></div></div></main></div></div></div><footer class="footer text-muted"><div class=container-lg><div class=row><div class="col-lg-8 text-center text-lg-start"><ul class=list-inline><li class=list-inline-item><a class=text-muted href=https://wldt.github.io/privacy/>Privacy Policy</a></li></ul></div><div class="col-lg-8 text-center text-lg-end"><ul class=list-inline><li class=list-inline-item>Brought to you by <a class=text-muted href=https://gethyas.com/>Hyas</a></li></ul></div></div></div></footer><script async src=https://wldt.github.io/js/app.1e84dcdaa5ccef6fe83f6d88ac1e444a1f237111cfa2a7a97427f758e9c27ef4.js integrity="sha256-HoTc2qXM72/oP22IrB5ESh8jcRHPoqepdCf3WOnCfvQ="></script>
+<script async src=https://wldt.github.io/js/flexsearch.dc00caef2c3490dbab3c345ed0d4133b0aafb803efeb21c3df80776d6d3ea821.js integrity="sha256-3ADK7yw0kNurPDRe0NQTOwqvuAPv6yHD34B3bW0+qCE="></script><script async src=https://wldt.github.io/js/search-modal.c4c023efcdee308e4b5f1110afe1db6b1656f217e67aa7efe54e2f4bf2feccf8.js integrity="sha256-xMAj783uMI5LXxEQr+HbaxZW8hfmeqfv5U4vS/L+zPg="></script><div class="d-inline-flex fixed-bottom-right pb-4 pe-4"><button id=toTop type=button class="btn btn-primary rounded-circle ms-auto p-2"><span class=visually-hidden>Top</span><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-chevron-up" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M6 15l6-6 6 6"/></svg></button></div></body></html>
\ No newline at end of file
diff --git a/docs/adapters/mqtt-physical-adapter/index.html b/docs/adapters/mqtt-physical-adapter/index.html
new file mode 100644
index 0000000..89f2f55
--- /dev/null
+++ b/docs/adapters/mqtt-physical-adapter/index.html
@@ -0,0 +1,82 @@
+<!doctype html><html lang=en data-bs-theme=auto><head><meta charset=utf-8><meta http-equiv=x-ua-compatible content="ie=edge"><meta name=viewport content="width=device-width,initial-scale=1"><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-regular.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-500.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-700.woff2 type=font/woff2 crossorigin><script src=https://wldt.github.io/js/color-mode.86a91f050a481d0a3f0c72ac26543cb6228c770875981c58dcbc008fd3f875c8.js integrity="sha256-hqkfBQpIHQo/DHKsJlQ8tiKMdwh1mBxY3LwAj9P4dcg="></script>
+<link rel=stylesheet href=https://wldt.github.io/main.5fb433a44687c98f7ae7b3d0137c762777049ba27235e1f08c279c03c8533a7a9a1e3b0ef5b125a31b6bb63a362cdcbc39c3706ed41ad7f1a620b9281013866c.css integrity="sha512-X7QzpEaHyY9657PQE3x2J3cEm6JyNeHwjCecA8hTOnqaHjsO9bEloxtrtjo2LNy8OcNwbtQa1/GmILkoEBOGbA==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>MQTT Physical Adapter | WLDT</title><meta property="canonical" content="https://wldt.github.io/docs/adapters/mqtt-physical-adapter/"><meta name=description content="The MqttPhysicalAdapter library provides a streamlined solution for efficiently managing physical assets through the MQTT protocol. It offers a range of features, including a versatile builder for effortless configuration of MQTT connections, dedicated classes for handling both incoming and outgoing topics, and a specialized adapter designed for seamless integration with diverse physical assets."><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/docs/adapters/mqtt-physical-adapter/"><meta property="og:title" content="MQTT Physical Adapter"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:section" content="docs"><meta property="og:description" content="The MqttPhysicalAdapter library provides a streamlined solution for efficiently managing physical assets through the MQTT protocol. It offers a range of features, including a versatile builder for effortless configuration of MQTT connections, dedicated classes for handling both incoming and outgoing topics, and a specialized adapter designed for seamless integration with diverse physical assets."><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-model/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-life-cycle/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/library-structure-basic-concepts/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/physical-adapter/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/shadowing-function/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/digital-adapter/"><meta name=twitter:card content="summary"><meta name=twitter:title content="MQTT Physical Adapter"><meta name=twitter:description content="The MqttPhysicalAdapter library provides a streamlined solution for efficiently managing physical assets through the MQTT protocol. It offers a range of features, including a versatile builder for effortless configuration of MQTT connections, dedicated classes for handling both incoming and outgoing topics, and a specialized adapter designed for seamless integration with diverse physical assets."><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","item":"https://wldt.github.io/docs/","name":"Docs","position":2},{"@type":"ListItem","item":"https://wldt.github.io/docs/adapters/","name":"Adapters","position":3},{"@type":"ListItem","name":"MQTT Physical Adapter","position":4}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="single section docs" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
+<button type=button id=searchToggleMobile class="btn btn-link nav-link mx-2 d-lg-none" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button class="btn btn-link d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavSection aria-controls=offcanvasNavSection aria-label="Open section navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-dots-vertical" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 19m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 5m-1 0a1 1 0 102 0 1 1 0 10-2 0"/></svg></button><div class="offcanvas offcanvas-start d-lg-none" tabindex=-1 id=offcanvasNavSection aria-labelledby=offcanvasNavSectionLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavSectionLabel>Docs</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class=offcanvas-body><aside class="doks-sidebar mt-n3"><nav id=doks-docs-nav aria-label="Tertiary navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-0b79795d3efc95b9976c7c5b933afce2 aria-expanded=false>
+Introduction</button><div class=collapse id=section-0b79795d3efc95b9976c7c5b933afce2><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-model/>DT Model</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-life-cycle/>DT Life Cycle</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/>Library Structure & Basic Concepts</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-3978929206deee2c125a1d732aae5545 aria-expanded=false>
+Change Logs</button><div class=collapse id=section-3978929206deee2c125a1d732aae5545><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/>Change Log 0.3.0</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-89413bd312d0909efb85e6693f36cb89 aria-expanded=true>
+Adapters</button><div class="collapse show" id=section-89413bd312d0909efb85e6693f36cb89><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded active" href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/>MQTT Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/>MQTT Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/http-digital-adapter/>HTTP Digital Adapter</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-bf647454e36069fd16f1a7a35cf6a865 aria-expanded=false>
+Getting Started</button><div class=collapse id=section-bf647454e36069fd16f1a7a35cf6a865><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/physical-adapter/>Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/shadowing-function/>Shadowing Function</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-adapter/>Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/>DT Engine & DT Instance</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-actions/>Digital Actions</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/configurable-adapters/>Configurable Adapters</a></li></ul></div></li></ul></nav></aside></div></div><button class="btn btn-link nav-link mx-2 order-3 d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavMain aria-controls=offcanvasNavMain aria-label="Open main navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-menu" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><line x1="4" y1="8" x2="20" y2="8"/><line x1="4" y1="16" x2="20" y2="16"/></svg></button><div class="offcanvas offcanvas-end h-auto" tabindex=-1 id=offcanvasNavMain aria-labelledby=offcanvasNavMainLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavMainLabel>WLDT</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class="offcanvas-body d-flex flex-column flex-lg-row justify-content-between"><ul class="navbar-nav flex-grow-1"><li class=nav-item><a class=nav-link href=https://wldt.github.io/docs/guides/example-guide/>Documentation</a></li><li class=nav-item><a class=nav-link href=https://wldt.github.io/blog/>Blog</a></li></ul><button type=button id=searchToggleDesktop class="btn btn-link nav-link p-2 d-none d-lg-block" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button id=buttonColorMode class="btn btn-link mx-auto nav-link p-0 ms-lg-2 me-lg-1" type=button aria-label="Toggle theme"><svg data-bs-theme-value="dark" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-moon" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 3c.132.0.263.0.393.0a7.5 7.5.0 007.92 12.446A9 9 0 1112 2.992z"/></svg><svg data-bs-theme-value="light" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-sun" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-4 0a4 4 0 108 0 4 4 0 10-8 0m-5 0h1m8-9v1m8 8h1m-9 8v1M5.6 5.6l.7.7m12.1-.7-.7.7m0 11.4.7.7m-12.1-.7-.7.7"/></svg></button><ul id=socialMenu class="nav mx-auto flex-row order-lg-4"><li class=nav-item><a class="nav-link social-link" href=https://github.com/wldt><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-brand-github" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 19c-4.3 1.4-4.3-2.5-6-3m12 5v-3.5c0-1 .1-1.4-.5-2 2.8-.3 5.5-1.4 5.5-6a4.6 4.6.0 00-1.3-3.2 4.2 4.2.0 00-.1-3.2s-1.1-.3-3.5 1.3a12.3 12.3.0 00-6.2.0C6.5 2.8 5.4 3.1 5.4 3.1a4.2 4.2.0 00-.1 3.2A4.6 4.6.0 004 9.5c0 4.6 2.7 5.7 5.5 6-.6.6-.6 1.2-.5 2V21"/></svg><small class="ms-2 visually-hidden">GitHub</small></a></li></ul></div></div></div></header></div><div class=modal id=searchModal tabindex=-1 aria-labelledby=searchModalLabel aria-hidden=true><div class="modal-dialog modal-dialog-scrollable modal-fullscreen-md-down"><div class=modal-content><div class=modal-header><h1 class="modal-title fs-5 visually-hidden" id=searchModalLabel>Search</h1><button type=button class="btn-close visually-hidden" data-bs-dismiss=modal aria-label=Close></button><div class="search-input flex-grow-1 d-none"><form id=search-form class=search-form action=# method=post accept-charset=utf-8 role=search><label for=query class=visually-hidden>Search</label><div class=d-flex><input type=search id=query name=query class="search-text form-control form-control-lg" placeholder=Search aria-label=Search maxlength=128 autocomplete=off>
+<button type=button class="btn btn-link text-decoration-none px-0 ms-3 d-md-none" data-bs-dismiss=modal aria-label=Close>Cancel</button></div></form></div></div><div class=modal-body><p class="search-loading status message d-none mt-3 text-center">Loading search index…</p><p class="search-no-recent message d-none mt-3 text-center">No recent searches</p><p class="search-no-results message d-none mt-3 text-center">No results for "<strong><span class=query-no-results>Query here</span></strong>"</p><div id=searchResults class=search-results></div><template><article class="search-result list-view"><div class="card my-3"><div class=card-body><header><h2 class="h5 title title-submitted mb-0"><a class="stretched-link text-decoration-none text-reset" href=#>Title here</a></h2><div class="submitted d-none"><time class=created-date>Date here</time></div></header><div class=content>Summary here</div></div></div></article></template></div><div class=modal-footer><ul class="list-inline me-auto d-none d-md-block"><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Enter key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M12 3.53088v3c0 1-1 2-2 2H4m3 3-3-3 3-3"/></g></svg></kbd><span class=DocSearch-Label>to select</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Arrow down" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 3.5v8m3-3-3 3-3-3"/></g></svg></kbd><kbd class=me-2><svg width="15" height="15" aria-label="Arrow up" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 11.5v-8m3 3-3-3-3 3"/></g></svg></kbd><span class=DocSearch-Label>to navigate</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Escape key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M13.6167 8.936c-.1065.3583-.6883.962-1.4875.962-.7993.0-1.653-.9165-1.653-2.1258v-.5678c0-1.2548.7896-2.1016 1.653-2.1016s1.3601.4778 1.4875 1.0724M9 6c-.1352-.4735-.7506-.9219-1.46-.8972-.7092.0246-1.344.57-1.344 1.2166s.4198.8812 1.3445.9805C8.465 7.3992 8.968 7.9337 9 8.5s-.454 1.398-1.4595 1.398C6.6593 9.898 6 9 5.963 8.4851m-1.4748.5368c-.2635.5941-.8099.876-1.5443.876s-1.7073-.6248-1.7073-2.204v-.4603c0-1.0416.721-2.131 1.7073-2.131.9864.0 1.6425 1.031 1.5443 2.2492h-2.956"/></g></svg></kbd><span class=DocSearch-Label>to close</span></li></ul><p class=d-md-none>Search by <a class=text-decoration-none href=https://github.com/nextapps-de/flexsearch>FlexSearch</a></p></div></div></div></div><div class="wrap container-lg" role=document><div class=content><div class="row flex-xl-nowrap"><div class="col-lg-5 col-xl-4 docs-sidebar d-none d-lg-block"><nav class=docs-links aria-label="Main navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-0b79795d3efc95b9976c7c5b933afce2 aria-expanded=false>
+Introduction</button><div class=collapse id=section-0b79795d3efc95b9976c7c5b933afce2><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-model/>DT Model</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-life-cycle/>DT Life Cycle</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/>Library Structure & Basic Concepts</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-3978929206deee2c125a1d732aae5545 aria-expanded=false>
+Change Logs</button><div class=collapse id=section-3978929206deee2c125a1d732aae5545><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/>Change Log 0.3.0</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-89413bd312d0909efb85e6693f36cb89 aria-expanded=true>
+Adapters</button><div class="collapse show" id=section-89413bd312d0909efb85e6693f36cb89><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded active" href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/>MQTT Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/>MQTT Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/http-digital-adapter/>HTTP Digital Adapter</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-bf647454e36069fd16f1a7a35cf6a865 aria-expanded=false>
+Getting Started</button><div class=collapse id=section-bf647454e36069fd16f1a7a35cf6a865><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/physical-adapter/>Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/shadowing-function/>Shadowing Function</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-adapter/>Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/>DT Engine & DT Instance</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-actions/>Digital Actions</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/configurable-adapters/>Configurable Adapters</a></li></ul></div></li></ul></nav></div><nav class="docs-toc d-none d-xl-block col-xl-3" aria-label="Secondary navigation"><div class=page-links><h3>Example Guide</h3><nav id=toc><ul><li><a href=#wldt-core-version-compatibility>WLDT-Core Version Compatibility</a></li><li><a href=#installation>Installation</a><ul><li><a href=#maven>Maven</a></li><li><a href=#gradle>Gradle</a></li></ul></li><li><a href=#class-structure--functionalities>Class Structure & Functionalities</a><ul><li><a href=#mqttphysicaladapterconfigurationbuilder--main-methods>MqttPhysicalAdapterConfigurationBuilder & Main Methods</a></li><li><a href=#addphysicalassetpropertyandtopic>addPhysicalAssetPropertyAndTopic</a></li><li><a href=#addphysicalassetactionandtopic>addPhysicalAssetActionAndTopic</a></li><li><a href=#addphysicalasseteventandtopic>addPhysicalAssetEventAndTopic</a></li><li><a href=#addincomingtopic>addIncomingTopic</a></li><li><a href=#addoutgoingtopic>addOutgoingTopic</a></li><li><a href=#additional-methods>Additional Methods</a></li><li><a href=#mqttphysicaladapter>MqttPhysicalAdapter</a></li><li><a href=#integrated-example>Integrated Example</a></li></ul></li></ul></nav></div></nav><main class="docs-content col-lg-11 col-xl-9"><nav aria-label=breadcrumb><ol class=breadcrumb><li class=breadcrumb-item><a href=https://wldt.github.io/>Home</a></li><li class=breadcrumb-item><a href=https://wldt.github.io/docs/>Docs</a></li><li class=breadcrumb-item><a href=https://wldt.github.io/docs/adapters/>Adapters</a></li><li class="breadcrumb-item active" aria-current=page>MQTT Physical Adapter</li></ol></nav><h1>MQTT Physical Adapter</h1><nav class="toc-mobile d-xl-none" aria-label="Quaternary navigation"><details><summary>On this page</summary><div class=page-links><nav id=TableOfContents><ul><li><a href=#wldt-core-version-compatibility>WLDT-Core Version Compatibility</a></li><li><a href=#installation>Installation</a><ul><li><a href=#maven>Maven</a></li><li><a href=#gradle>Gradle</a></li></ul></li><li><a href=#class-structure--functionalities>Class Structure & Functionalities</a><ul><li><a href=#mqttphysicaladapterconfigurationbuilder--main-methods>MqttPhysicalAdapterConfigurationBuilder & Main Methods</a></li><li><a href=#addphysicalassetpropertyandtopic>addPhysicalAssetPropertyAndTopic</a></li><li><a href=#addphysicalassetactionandtopic>addPhysicalAssetActionAndTopic</a></li><li><a href=#addphysicalasseteventandtopic>addPhysicalAssetEventAndTopic</a></li><li><a href=#addincomingtopic>addIncomingTopic</a></li><li><a href=#addoutgoingtopic>addOutgoingTopic</a></li><li><a href=#additional-methods>Additional Methods</a></li><li><a href=#mqttphysicaladapter>MqttPhysicalAdapter</a></li><li><a href=#integrated-example>Integrated Example</a></li></ul></li></ul></nav></div></details></nav><p>The MqttPhysicalAdapter library provides a streamlined solution for efficiently managing physical assets through the MQTT protocol.
+It offers a range of features, including a versatile builder for effortless configuration of MQTT connections, dedicated classes for
+handling both incoming and outgoing topics, and a specialized adapter designed for seamless integration with diverse physical assets.</p><p>Key Features:</p><ul><li><strong>Builder for MQTT Configuration:</strong> The library incorporates a flexible builder pattern, enabling users to effortlessly configure the essential parameters of the MQTT connection. This includes specifying the MQTT broker&rsquo;s address, port, and other relevant details to establish a reliable and customizable communication link.</li><li><strong>Incoming and Outgoing Topic Handling:</strong> MqttPhysicalAdapter facilitates the handling of incoming and outgoing topics, crucial for communication between the physical assets and the MQTT broker. The library includes dedicated classes for defining and managing topics, allowing users to efficiently subscribe to incoming data and publish outgoing messages.</li><li><strong>Adapter for Physical Asset Integration:</strong> At the core of the library is a robust adapter designed specifically for integrating with various physical assets. This adapter streamlines the process of connecting and interacting with physical devices, ensuring a smooth and standardized approach to managing asset-related data.</li></ul><p>In the WLDT library, Physical Adapters has the responsibility to generate and publish the <code>PhysicalAssetDescription</code> (PAD)
+to describe the capabilities and the characteristics of our object allowing
+the Shadowing Function to decide how to digitalize its physical counterpart.</p><p><strong>In the <code>MqttPhysicalAdapter</code> the generation of the PAD (Physical Asset Description) is automatically and internally executed by the adapter itself accordingly to
+the adapter configuration in terms of MQTT topics and their mapping with DT&rsquo;s properties, events and actions.</strong></p><div align=center><img class=center src=images/adapter_schema.jpg width=100%></div><p>Prerequisites:</p><ul><li><strong>External MQTT Broker:</strong> The MqttPhysicalAdapter library requires an external MQTT broker for optimal functionality.</li><li>Users must have access to a reliable MQTT broker to which the adapter can subscribe.</li><li>This external broker serves as the central communication hub, facilitating the exchange of messages between the adapter and the physical assets.</li></ul><p>A complete example is provided in the <code>test</code> folder with a complete DT Creation in the <code>TestMain</code> class together with MQTT IoT demo device and
+a test MQTT consumer.</p><h2 id=wldt-core-version-compatibility>WLDT-Core Version Compatibility<a href=#wldt-core-version-compatibility class=anchor aria-hidden=true>#</a></h2><p>The correct mapping and compatibility between versions is reported in the following table</p><table><thead><tr><th style=text-align:center><strong>mqtt-physical-adapter</strong></th><th style=text-align:center>wldt-core 0.2.1</th><th style=text-align:center>wldt-core 0.3.0</th></tr></thead><tbody><tr><td style=text-align:center>0.1.0</td><td style=text-align:center>✅</td><td style=text-align:center>❌</td></tr><tr><td style=text-align:center>0.1.1</td><td style=text-align:center>❌</td><td style=text-align:center>✅</td></tr></tbody></table><h2 id=installation>Installation<a href=#installation class=anchor aria-hidden=true>#</a></h2><p>To use MqttPhysicalAdapter in your Java project, you can include it as a dependency using Maven or Gradle.</p><h3 id=maven>Maven<a href=#maven class=anchor aria-hidden=true>#</a></h3><div class=highlight><pre tabindex=0 class=chroma><code class=language-xml data-lang=xml><span class=line><span class=cl><span class=nt>&lt;dependency&gt;</span>
+</span></span><span class=line><span class=cl>    <span class=nt>&lt;groupId&gt;</span>io.github.wldt<span class=nt>&lt;/groupId&gt;</span>
+</span></span><span class=line><span class=cl>    <span class=nt>&lt;artifactId&gt;</span>mqtt-physical-adapter<span class=nt>&lt;/artifactId&gt;</span>
+</span></span><span class=line><span class=cl>    <span class=nt>&lt;version&gt;</span>0.1.1<span class=nt>&lt;/version&gt;</span>
+</span></span><span class=line><span class=cl><span class=nt>&lt;/dependency&gt;</span>
+</span></span></code></pre></div><h3 id=gradle>Gradle<a href=#gradle class=anchor aria-hidden=true>#</a></h3><div class=highlight><pre tabindex=0 class=chroma><code class=language-groovy data-lang=groovy><span class=line><span class=cl><span class=n>implementation</span> <span class=s1>&#39;io.github.wldt:mqtt-physical-adapter:0.1.1&#39;</span>
+</span></span></code></pre></div><h2 id=class-structure--functionalities>Class Structure & Functionalities<a href=#class-structure--functionalities class=anchor aria-hidden=true>#</a></h2><h3 id=mqttphysicaladapterconfigurationbuilder--main-methods>MqttPhysicalAdapterConfigurationBuilder & Main Methods<a href=#mqttphysicaladapterconfigurationbuilder--main-methods class=anchor aria-hidden=true>#</a></h3><p>The <code>MqttPhysicalAdapterConfigurationBuilder</code> is the class used to build the configuration used by the PhysicalAdater
+and described and implemented through the class <code>MqttPhysicalAdapterConfiguration</code>.</p><p>In order to create a configuration builder we can use the static method <code>builder()</code> on the <code>MqttPhysicalAdapterConfiguration</code> class:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=n>MqttPhysicalAdapterConfiguration</span><span class=o>.</span><span class=na>builder</span><span class=o>();</span>
+</span></span></code></pre></div><p>On the builder the available methods that can be used are:</p><h3 id=addphysicalassetpropertyandtopic>addPhysicalAssetPropertyAndTopic<a href=#addphysicalassetpropertyandtopic class=anchor aria-hidden=true>#</a></h3><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=kd>public</span> <span class=o>&lt;</span><span class=n>T</span><span class=o>&gt;</span> <span class=n>MqttPhysicalAdapterConfigurationBuilder</span> <span class=nf>addPhysicalAssetPropertyAndTopic</span><span class=o>(</span><span class=n>String</span> <span class=n>propertyKey</span><span class=o>,</span> <span class=n>T</span> <span class=n>initialValue</span><span class=o>,</span> <span class=n>String</span> <span class=n>topic</span><span class=o>,</span> <span class=n>Function</span><span class=o>&lt;</span><span class=n>String</span><span class=o>,</span> <span class=n>T</span><span class=o>&gt;</span> <span class=n>topicFunction</span><span class=o>)</span> <span class=kd>throws</span> <span class=n>MqttPhysicalAdapterConfigurationException</span> 
+</span></span></code></pre></div><p>Adds a physical asset property and its corresponding MQTT topic to the configuration.</p><ul><li><strong>Type Parameter T:</strong> The type of the property.</li><li><strong>propertyKey:</strong> The key of the property.</li><li><strong>initialValue:</strong> The initial value of the property.</li><li><strong>topic:</strong> The MQTT topic associated with the property.</li><li><strong>topicFunction:</strong> A function to parse the MQTT topic payload into the property type.</li></ul><p><strong>Returns:</strong> The updated MqttPhysicalAdapterConfigurationBuilder.</p><p><strong>Throws:</strong> <code>MqttPhysicalAdapterConfigurationException</code> - If there is a configuration error.</p><h3 id=addphysicalassetactionandtopic>addPhysicalAssetActionAndTopic<a href=#addphysicalassetactionandtopic class=anchor aria-hidden=true>#</a></h3><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=kd>public</span> <span class=o>&lt;</span><span class=n>T</span><span class=o>&gt;</span> <span class=n>MqttPhysicalAdapterConfigurationBuilder</span> <span class=nf>addPhysicalAssetActionAndTopic</span><span class=o>(</span><span class=n>String</span> <span class=n>actionKey</span><span class=o>,</span> <span class=n>String</span> <span class=n>type</span><span class=o>,</span> <span class=n>String</span> <span class=n>contentType</span><span class=o>,</span>
+</span></span><span class=line><span class=cl>                                                   <span class=n>String</span> <span class=n>topic</span><span class=o>,</span> <span class=n>Function</span><span class=o>&lt;</span><span class=n>T</span><span class=o>,</span> <span class=n>String</span><span class=o>&gt;</span> <span class=n>topicFunction</span><span class=o>)</span> <span class=kd>throws</span> <span class=n>MqttPhysicalAdapterConfigurationException</span>
+</span></span></code></pre></div><p>Adds a physical asset action and its corresponding MQTT topic to the configuration.</p><ul><li><strong>Type Parameter T:</strong> The type of the action payload.</li><li><strong>actionKey:</strong> The key of the action.</li><li><strong>type:</strong> The type of the action.</li><li><strong>contentType:</strong> The content type of the action.</li><li><strong>topic:</strong> The MQTT topic associated with the action.</li><li><strong>topicFunction:</strong> A function to convert the action payload into the MQTT topic payload.</li></ul><p><strong>Returns:</strong> The updated MqttPhysicalAdapterConfigurationBuilder.</p><p><strong>Throws:</strong> <code>MqttPhysicalAdapterConfigurationException</code> - If there is a configuration error.</p><h3 id=addphysicalasseteventandtopic>addPhysicalAssetEventAndTopic<a href=#addphysicalasseteventandtopic class=anchor aria-hidden=true>#</a></h3><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=kd>public</span> <span class=o>&lt;</span><span class=n>T</span><span class=o>&gt;</span> <span class=n>MqttPhysicalAdapterConfigurationBuilder</span> <span class=nf>addPhysicalAssetEventAndTopic</span><span class=o>(</span><span class=n>String</span> <span class=n>eventKey</span><span class=o>,</span> <span class=n>String</span> <span class=n>type</span><span class=o>,</span> <span class=n>String</span> <span class=n>topic</span><span class=o>,</span> <span class=n>Function</span><span class=o>&lt;</span><span class=n>String</span><span class=o>,</span> <span class=n>T</span><span class=o>&gt;</span> <span class=n>topicFunction</span><span class=o>)</span> <span class=kd>throws</span> <span class=n>MqttPhysicalAdapterConfigurationException</span>
+</span></span></code></pre></div><p>Adds a physical asset event and its corresponding MQTT topic to the configuration.</p><ul><li><strong>Type Parameter T:</strong> The type of the event payload.</li><li><strong>eventKey:</strong> The key of the event.</li><li><strong>type:</strong> The type of the event.</li><li><strong>topic:</strong> The MQTT topic associated with the event.</li><li><strong>topicFunction:</strong> A function to parse the MQTT topic payload into the event payload type.</li></ul><p><strong>Returns:</strong> The updated MqttPhysicalAdapterConfigurationBuilder.</p><p><strong>Throws:</strong> <code>MqttPhysicalAdapterConfigurationException</code> - If there is a configuration error.</p><h3 id=addincomingtopic>addIncomingTopic<a href=#addincomingtopic class=anchor aria-hidden=true>#</a></h3><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=kd>public</span> <span class=n>MqttPhysicalAdapterConfigurationBuilder</span> <span class=nf>addIncomingTopic</span><span class=o>(</span><span class=n>DigitalTwinIncomingTopic</span> <span class=n>topic</span><span class=o>,</span> <span class=n>List</span><span class=o>&lt;</span><span class=n>PhysicalAssetProperty</span><span class=o>&lt;?&gt;&gt;</span> <span class=n>properties</span><span class=o>,</span> <span class=n>List</span><span class=o>&lt;</span><span class=n>PhysicalAssetEvent</span><span class=o>&gt;</span> <span class=n>events</span><span class=o>)</span> <span class=kd>throws</span> <span class=n>MqttPhysicalAdapterConfigurationException</span>
+</span></span></code></pre></div><p>This method is used when multiple properties or events can be associated to a single MQTT topic on the physical device.
+It adds a <code>DigitalTwinIncomingTopic</code> describing the topic where the DT will receive the data
+along with its related lists of properties and events associated to that topic.</p><ul><li><strong>topic:</strong> The DigitalTwinIncomingTopic to be added.</li><li><strong>properties:</strong> The list of related physical asset properties.</li><li><strong>events:</strong> The list of related physical asset events.</li></ul><p><strong>Returns:</strong> The updated MqttPhysicalAdapterConfigurationBuilder.</p><p><strong>Throws:</strong> <code>MqttPhysicalAdapterConfigurationException</code> - If there is a configuration error.</p><h3 id=addoutgoingtopic>addOutgoingTopic<a href=#addoutgoingtopic class=anchor aria-hidden=true>#</a></h3><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=kd>public</span> <span class=n>MqttPhysicalAdapterConfigurationBuilder</span> <span class=nf>addOutgoingTopic</span><span class=o>(</span><span class=n>String</span> <span class=n>actionKey</span><span class=o>,</span>  <span class=n>String</span> <span class=n>type</span><span class=o>,</span> <span class=n>String</span> <span class=n>contentType</span><span class=o>,</span> <span class=n>DigitalTwinOutgoingTopic</span> <span class=n>topic</span><span class=o>)</span> <span class=kd>throws</span> <span class=n>MqttPhysicalAdapterConfigurationException</span>
+</span></span></code></pre></div><p>Adds a DigitalTwinOutgoingTopic to the configuration.</p><ul><li><strong>actionKey:</strong> The key of the associated action.</li><li><strong>type:</strong> The type of the associated action.</li><li><strong>contentType:</strong> The content type of the associated action.</li><li><strong>topic:</strong> The DigitalTwinOutgoingTopic to be added.</li></ul><p><strong>Returns:</strong> The updated MqttPhysicalAdapterConfigurationBuilder.</p><p><strong>Throws:</strong> <code>MqttPhysicalAdapterConfigurationException</code> - If there is a configuration error.</p><h3 id=additional-methods>Additional Methods<a href=#additional-methods class=anchor aria-hidden=true>#</a></h3><ul><li><code>setConnectionTimeout(Integer connectionTimeout)</code>: Sets the connection timeout for the MQTT client.
+Returns the builder for method chaining. Throws MqttPhysicalAdapterConfigurationException if the provided timeout is invalid.</li><li><code>setCleanSessionFlag(boolean cleanSession)</code>: Sets the clean session flag for the MQTT client.
+Returns the builder for method chaining.</li><li><code>setAutomaticReconnectFlag(boolean automaticReconnect)</code>: Sets the automatic reconnect flag for the MQTT client.
+Returns the builder for method chaining.</li><li><code>setMqttClientPersistence(MqttClientPersistence persistence)</code>: Sets the persistence for the MQTT client.
+Returns the builder for method chaining. Throws MqttPhysicalAdapterConfigurationException if the provided persistence is null.</li><li><code>build()</code>: Builds and returns the finalized <code>MqttPhysicalAdapterConfiguration</code> object.
+Throws MqttPhysicalAdapterConfigurationException if the configuration is incomplete or invalid.</li></ul><h3 id=mqttphysicaladapter>MqttPhysicalAdapter<a href=#mqttphysicaladapter class=anchor aria-hidden=true>#</a></h3><p>The MqttPhysicalAdapter class is the core component for interacting with physical assets. Instantiate it with a unique ID and the configuration.
+It extends the default WLDT Library <code>PhysicalAdapter</code> implementing all the functionalities to automatically interact with an MQTT physical device
+following the specifications and details provided in the <code>MqttPhysicalAdapterConfiguration</code> and built using <code>MqttPhysicalAdapterConfigurationBuilder</code>.</p><p>An example of its creation is:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=n>MqttPhysicalAdapter</span> <span class=n>mqttPhysicalAdapter</span> <span class=o>=</span> <span class=k>new</span> <span class=n>MqttPhysicalAdapter</span><span class=o>(</span><span class=s>&#34;uniqueId&#34;</span><span class=o>,</span> <span class=n>configuration</span><span class=o>);</span>
+</span></span></code></pre></div><h3 id=integrated-example>Integrated Example<a href=#integrated-example class=anchor aria-hidden=true>#</a></h3><p>This example demonstrates the integration of a <code>MqttPhysicalAdapter</code> within a Digital Twin setup, where multiple adapters
+(including a console adapter) are added to a Digital Twin, and the overall system is managed by a <code>DigitalTwinEngine</code>.</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=c1>// Create a Digital Twin with a default shadowing function
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>DigitalTwin</span> <span class=n>digitalTwin</span> <span class=o>=</span> <span class=k>new</span> <span class=n>DigitalTwin</span><span class=o>(</span><span class=s>&#34;mqtt-digital-twin&#34;</span><span class=o>,</span> <span class=k>new</span> <span class=n>DefaultShadowingFunction</span><span class=o>());</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=c1>// Create an instance of ConsoleDigitalAdapter
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>ConsoleDigitalAdapter</span> <span class=n>consoleDigitalAdapter</span> <span class=o>=</span> <span class=k>new</span> <span class=n>ConsoleDigitalAdapter</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=c1>// Create an instance of MqttPhysicalAdapterConfiguration
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>MqttPhysicalAdapterConfiguration</span> <span class=n>config</span> <span class=o>=</span> <span class=n>MqttPhysicalAdapterConfiguration</span><span class=o>.</span><span class=na>builder</span><span class=o>(</span><span class=s>&#34;127.0.0.1&#34;</span><span class=o>,</span> <span class=mi>1883</span><span class=o>)</span>
+</span></span><span class=line><span class=cl>    <span class=o>.</span><span class=na>addPhysicalAssetPropertyAndTopic</span><span class=o>(</span><span class=s>&#34;intensity&#34;</span><span class=o>,</span> <span class=mi>0</span><span class=o>,</span> <span class=s>&#34;sensor/intensity&#34;</span><span class=o>,</span> <span class=n>Integer</span><span class=o>::</span><span class=n>parseInt</span><span class=o>)</span>
+</span></span><span class=line><span class=cl>    <span class=o>.</span><span class=na>addIncomingTopic</span><span class=o>(</span><span class=k>new</span> <span class=n>DigitalTwinIncomingTopic</span><span class=o>(</span><span class=s>&#34;sensor/state&#34;</span><span class=o>,</span> <span class=n>getSensorStateFunction</span><span class=o>()),</span> <span class=n>createIncomingTopicRelatedPropertyList</span><span class=o>(),</span> <span class=k>new</span> <span class=n>ArrayList</span><span class=o>&lt;&gt;())</span>
+</span></span><span class=line><span class=cl>    <span class=o>.</span><span class=na>addPhysicalAssetEventAndTopic</span><span class=o>(</span><span class=s>&#34;overheating&#34;</span><span class=o>,</span> <span class=s>&#34;text/plain&#34;</span><span class=o>,</span> <span class=s>&#34;sensor/overheating&#34;</span><span class=o>,</span> <span class=n>Function</span><span class=o>.</span><span class=na>identity</span><span class=o>())</span>
+</span></span><span class=line><span class=cl>    <span class=o>.</span><span class=na>addPhysicalAssetActionAndTopic</span><span class=o>(</span><span class=s>&#34;switch-off&#34;</span><span class=o>,</span> <span class=s>&#34;sensor.actuation&#34;</span><span class=o>,</span> <span class=s>&#34;text/plain&#34;</span><span class=o>,</span> <span class=s>&#34;sensor/actions/switch&#34;</span><span class=o>,</span> <span class=n>actionBody</span> <span class=o>-&gt;</span> <span class=s>&#34;switch&#34;</span> <span class=o>+</span> <span class=n>actionBody</span><span class=o>)</span>
+</span></span><span class=line><span class=cl>    <span class=o>.</span><span class=na>build</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=c1>// Create an instance of the MQTT Physical Adapter using the defined configuration
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>MqttPhysicalAdapter</span> <span class=n>mqttPhysicalAdapter</span> <span class=o>=</span> <span class=k>new</span> <span class=n>MqttPhysicalAdapter</span><span class=o>(</span><span class=s>&#34;test-mqtt-pa&#34;</span><span class=o>,</span> <span class=n>config</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=c1>// Add both Digital and Physical Adapters to the Digital Twin
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>digitalTwin</span><span class=o>.</span><span class=na>addDigitalAdapter</span><span class=o>(</span><span class=n>consoleDigitalAdapter</span><span class=o>);</span>
+</span></span><span class=line><span class=cl><span class=n>digitalTwin</span><span class=o>.</span><span class=na>addPhysicalAdapter</span><span class=o>(</span><span class=n>mqttPhysicalAdapter</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=c1>// Create the Digital Twin Engine
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>DigitalTwinEngine</span> <span class=n>digitalTwinEngine</span> <span class=o>=</span> <span class=k>new</span> <span class=n>DigitalTwinEngine</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=c1>// Add the Digital Twin to the Engine
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>digitalTwinEngine</span><span class=o>.</span><span class=na>addDigitalTwin</span><span class=o>(</span><span class=n>digitalTwin</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=c1>// Start all the Digital Twins registered on the engine
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>digitalTwinEngine</span><span class=o>.</span><span class=na>startAll</span><span class=o>();</span>
+</span></span></code></pre></div><p>In this example the <code>createIncomingTopicRelatedPropertyList()</code> used to map properties and events associated to a single topic is the following:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl> <span class=kd>private</span> <span class=kd>static</span> <span class=n>List</span><span class=o>&lt;</span><span class=n>PhysicalAssetProperty</span><span class=o>&lt;?&gt;&gt;</span> <span class=n>createIncomingTopicRelatedPropertyList</span><span class=o>(){</span>
+</span></span><span class=line><span class=cl>        <span class=n>List</span><span class=o>&lt;</span><span class=n>PhysicalAssetProperty</span><span class=o>&lt;?&gt;&gt;</span> <span class=n>properties</span> <span class=o>=</span> <span class=k>new</span> <span class=n>ArrayList</span><span class=o>&lt;&gt;();</span>
+</span></span><span class=line><span class=cl>        <span class=n>properties</span><span class=o>.</span><span class=na>add</span><span class=o>(</span><span class=k>new</span> <span class=n>PhysicalAssetProperty</span><span class=o>&lt;&gt;(</span><span class=s>&#34;temperature&#34;</span><span class=o>,</span> <span class=mi>0</span><span class=o>));</span>
+</span></span><span class=line><span class=cl>        <span class=n>properties</span><span class=o>.</span><span class=na>add</span><span class=o>(</span><span class=k>new</span> <span class=n>PhysicalAssetProperty</span><span class=o>&lt;&gt;(</span><span class=s>&#34;humidity&#34;</span><span class=o>,</span> <span class=mi>0</span><span class=o>));</span>
+</span></span><span class=line><span class=cl>        <span class=k>return</span> <span class=n>properties</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span></code></pre></div><p>This information are used by the adapter to build the PAD describe the capabilities and the characteristics of our object allowing
+the Shadowing Function to decide how to digitalize its physical counterpart.</p><div class="page-footer-meta d-flex flex-column flex-md-row justify-content-between"><div class=last-modified><a href=https://github.com/wldt/wldt.github.io/commit/ab5a164de259055162e9420d8cb56c2b1562dee9><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-calendar"><rect x="3" y="4" width="18" height="18" rx="2" ry="2"/><line x1="16" y1="2" x2="16" y2="6"/><line x1="8" y1="2" x2="8" y2="6"/><line x1="3" y1="10" x2="21" y2="10"/></svg>Last updated on February 9, 2024</a></div><div class=edit-page><a href=https://github.com/wldt/wldt.github.io/blob/main/content//docs/adapters/mqtt_physical.md><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-edit-2"><path d="M17 3a2.828 2.828.0 114 4L7.5 20.5 2 22l1.5-5.5L17 3z"/></svg>Edit this page on GitHub</a></div></div><div class="page-nav d-flex flex-column flex-sm-row"><div class="card w-100"><div class="card-body d-flex"><div class="d-flex flex-column justify-content-center"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-arrow-left" width="20" height="20" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 12h14"/><path d="M5 12l6 6"/><path d="M5 12l6-6"/></svg></div><div class="d-flex flex-column"><div class=text-body-secondary>Prev</div><a href=https://wldt.github.io/docs/guides/configurable-adapters/ class="stretched-link text-reset text-decoration-none">Configurable Adapters</a></div></div></div><div class=m-2></div><div class="card text-end w-100"><div class="card-body d-flex justify-content-end"><div class="d-flex flex-column"><div class=text-body-secondary>Next</div><a href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/ class="stretched-link text-reset text-decoration-none">MQTT Digital Adapter</a></div><div class="d-flex flex-column justify-content-center"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-arrow-right" width="20" height="20" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 12h14"/><path d="M13 18l6-6"/><path d="M13 6l6 6"/></svg></div></div></div></div></main></div></div></div><footer class="footer text-muted"><div class=container-lg><div class=row><div class="col-lg-8 text-center text-lg-start"><ul class=list-inline><li class=list-inline-item><a class=text-muted href=https://wldt.github.io/privacy/>Privacy Policy</a></li></ul></div><div class="col-lg-8 text-center text-lg-end"><ul class=list-inline><li class=list-inline-item>Brought to you by <a class=text-muted href=https://gethyas.com/>Hyas</a></li></ul></div></div></div></footer><script async src=https://wldt.github.io/js/app.1e84dcdaa5ccef6fe83f6d88ac1e444a1f237111cfa2a7a97427f758e9c27ef4.js integrity="sha256-HoTc2qXM72/oP22IrB5ESh8jcRHPoqepdCf3WOnCfvQ="></script>
+<script async src=https://wldt.github.io/js/flexsearch.dc00caef2c3490dbab3c345ed0d4133b0aafb803efeb21c3df80776d6d3ea821.js integrity="sha256-3ADK7yw0kNurPDRe0NQTOwqvuAPv6yHD34B3bW0+qCE="></script><script async src=https://wldt.github.io/js/search-modal.c4c023efcdee308e4b5f1110afe1db6b1656f217e67aa7efe54e2f4bf2feccf8.js integrity="sha256-xMAj783uMI5LXxEQr+HbaxZW8hfmeqfv5U4vS/L+zPg="></script><div class="d-inline-flex fixed-bottom-right pb-4 pe-4"><button id=toTop type=button class="btn btn-primary rounded-circle ms-auto p-2"><span class=visually-hidden>Top</span><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-chevron-up" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M6 15l6-6 6 6"/></svg></button></div></body></html>
\ No newline at end of file
diff --git a/docs/adapters/page/1/index.html b/docs/adapters/page/1/index.html
new file mode 100644
index 0000000..2b15412
--- /dev/null
+++ b/docs/adapters/page/1/index.html
@@ -0,0 +1 @@
+<!doctype html><html lang=en><head><title>https://wldt.github.io/docs/adapters/</title><link rel=canonical href=https://wldt.github.io/docs/adapters/><meta name=robots content="noindex"><meta charset=utf-8><meta http-equiv=refresh content="0; url=https://wldt.github.io/docs/adapters/"></head></html>
\ No newline at end of file
diff --git a/docs/adapters/sitemap.xml b/docs/adapters/sitemap.xml
new file mode 100644
index 0000000..bf155e4
--- /dev/null
+++ b/docs/adapters/sitemap.xml
@@ -0,0 +1 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes"?><urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml"><url><loc>https://wldt.github.io/docs/adapters/mqtt-physical-adapter/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/adapters/mqtt-digital-adapter/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/adapters/http-digital-adapter/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url></urlset>
\ No newline at end of file
diff --git a/docs/change-logs/change-log-0.3.0/index.html b/docs/change-logs/change-log-0.3.0/index.html
new file mode 100644
index 0000000..7ddc148
--- /dev/null
+++ b/docs/change-logs/change-log-0.3.0/index.html
@@ -0,0 +1,239 @@
+<!doctype html><html lang=en data-bs-theme=auto><head><meta charset=utf-8><meta http-equiv=x-ua-compatible content="ie=edge"><meta name=viewport content="width=device-width,initial-scale=1"><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-regular.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-500.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-700.woff2 type=font/woff2 crossorigin><script src=https://wldt.github.io/js/color-mode.86a91f050a481d0a3f0c72ac26543cb6228c770875981c58dcbc008fd3f875c8.js integrity="sha256-hqkfBQpIHQo/DHKsJlQ8tiKMdwh1mBxY3LwAj9P4dcg="></script>
+<link rel=stylesheet href=https://wldt.github.io/main.5fb433a44687c98f7ae7b3d0137c762777049ba27235e1f08c279c03c8533a7a9a1e3b0ef5b125a31b6bb63a362cdcbc39c3706ed41ad7f1a620b9281013866c.css integrity="sha512-X7QzpEaHyY9657PQE3x2J3cEm6JyNeHwjCecA8hTOnqaHjsO9bEloxtrtjo2LNy8OcNwbtQa1/GmILkoEBOGbA==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>Change Log 0.3.0 | WLDT</title><meta property="canonical" content="https://wldt.github.io/docs/change-logs/change-log-0.3.0/"><meta name=description content="Digital Adapters The following methods have been discontinued and removed from the DigitalAdapter class: onStateChangePropertyCreated onStateChangePropertyUpdated onStateChangePropertyDeleted onStatePropertyUpdated onStatePropertyDeleted onStateChangeActionEnabled onStateChangeActionUpdated onStateChangeActionDisabled onStateChangeEventRegistered onStateChangeEventRegistrationUpdated onStateChangeEventUnregistered onStateChangeRelationshipInstanceDeleted onStateChangeRelationshipDeleted onStateChangeRelationshipInstanceCreated onStateChangeRelationshipCreated onDigitalTwinStateEventNotificationReceived The Signature of the following methods have been changed: onDigitalTwinSync(IDigitalTwinState currentDigitalTwinState) -> onDigitalTwinSync(DigitalTwinState currentDigitalTwinState) onDigitalTwinUnSync(IDigitalTwinState currentDigitalTwinState) -> onDigitalTwinUnSync(DigitalTwinState currentDigitalTwinState) New methods that have been added are: onStateUpdate(DigitalTwinState newDigitalTwinState, DigitalTwinState previousDigitalTwinState, ArrayList<DigitalTwinStateChange> digitalTwinStateChangeList) onEventNotificationReceived(DigitalTwinStateEventNotification<?"><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/docs/change-logs/change-log-0.3.0/"><meta property="og:title" content="Change Log 0.3.0"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:section" content="docs"><meta property="og:description" content="Digital Adapters The following methods have been discontinued and removed from the DigitalAdapter class: onStateChangePropertyCreated onStateChangePropertyUpdated onStateChangePropertyDeleted onStatePropertyUpdated onStatePropertyDeleted onStateChangeActionEnabled onStateChangeActionUpdated onStateChangeActionDisabled onStateChangeEventRegistered onStateChangeEventRegistrationUpdated onStateChangeEventUnregistered onStateChangeRelationshipInstanceDeleted onStateChangeRelationshipDeleted onStateChangeRelationshipInstanceCreated onStateChangeRelationshipCreated onDigitalTwinStateEventNotificationReceived The Signature of the following methods have been changed: onDigitalTwinSync(IDigitalTwinState currentDigitalTwinState) -> onDigitalTwinSync(DigitalTwinState currentDigitalTwinState) onDigitalTwinUnSync(IDigitalTwinState currentDigitalTwinState) -> onDigitalTwinUnSync(DigitalTwinState currentDigitalTwinState) New methods that have been added are: onStateUpdate(DigitalTwinState newDigitalTwinState, DigitalTwinState previousDigitalTwinState, ArrayList<DigitalTwinStateChange> digitalTwinStateChangeList) onEventNotificationReceived(DigitalTwinStateEventNotification<?"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-model/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-life-cycle/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/library-structure-basic-concepts/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/physical-adapter/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/shadowing-function/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/digital-adapter/"><meta name=twitter:card content="summary"><meta name=twitter:title content="Change Log 0.3.0"><meta name=twitter:description content="Digital Adapters The following methods have been discontinued and removed from the DigitalAdapter class: onStateChangePropertyCreated onStateChangePropertyUpdated onStateChangePropertyDeleted onStatePropertyUpdated onStatePropertyDeleted onStateChangeActionEnabled onStateChangeActionUpdated onStateChangeActionDisabled onStateChangeEventRegistered onStateChangeEventRegistrationUpdated onStateChangeEventUnregistered onStateChangeRelationshipInstanceDeleted onStateChangeRelationshipDeleted onStateChangeRelationshipInstanceCreated onStateChangeRelationshipCreated onDigitalTwinStateEventNotificationReceived The Signature of the following methods have been changed: onDigitalTwinSync(IDigitalTwinState currentDigitalTwinState) -> onDigitalTwinSync(DigitalTwinState currentDigitalTwinState) onDigitalTwinUnSync(IDigitalTwinState currentDigitalTwinState) -> onDigitalTwinUnSync(DigitalTwinState currentDigitalTwinState) New methods that have been added are: onStateUpdate(DigitalTwinState newDigitalTwinState, DigitalTwinState previousDigitalTwinState, ArrayList<DigitalTwinStateChange> digitalTwinStateChangeList) onEventNotificationReceived(DigitalTwinStateEventNotification<?"><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","item":"https://wldt.github.io/docs/","name":"Docs","position":2},{"@type":"ListItem","item":"https://wldt.github.io/docs/change-logs/","name":"Change Logs","position":3},{"@type":"ListItem","name":"Change Log 0.3.0","position":4}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="single section docs" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
+<button type=button id=searchToggleMobile class="btn btn-link nav-link mx-2 d-lg-none" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button class="btn btn-link d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavSection aria-controls=offcanvasNavSection aria-label="Open section navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-dots-vertical" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 19m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 5m-1 0a1 1 0 102 0 1 1 0 10-2 0"/></svg></button><div class="offcanvas offcanvas-start d-lg-none" tabindex=-1 id=offcanvasNavSection aria-labelledby=offcanvasNavSectionLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavSectionLabel>Docs</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class=offcanvas-body><aside class="doks-sidebar mt-n3"><nav id=doks-docs-nav aria-label="Tertiary navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-0b79795d3efc95b9976c7c5b933afce2 aria-expanded=false>
+Introduction</button><div class=collapse id=section-0b79795d3efc95b9976c7c5b933afce2><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-model/>DT Model</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-life-cycle/>DT Life Cycle</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/>Library Structure & Basic Concepts</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-3978929206deee2c125a1d732aae5545 aria-expanded=true>
+Change Logs</button><div class="collapse show" id=section-3978929206deee2c125a1d732aae5545><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded active" href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/>Change Log 0.3.0</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-89413bd312d0909efb85e6693f36cb89 aria-expanded=false>
+Adapters</button><div class=collapse id=section-89413bd312d0909efb85e6693f36cb89><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/>MQTT Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/>MQTT Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/http-digital-adapter/>HTTP Digital Adapter</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-bf647454e36069fd16f1a7a35cf6a865 aria-expanded=false>
+Getting Started</button><div class=collapse id=section-bf647454e36069fd16f1a7a35cf6a865><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/physical-adapter/>Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/shadowing-function/>Shadowing Function</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-adapter/>Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/>DT Engine & DT Instance</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-actions/>Digital Actions</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/configurable-adapters/>Configurable Adapters</a></li></ul></div></li></ul></nav></aside></div></div><button class="btn btn-link nav-link mx-2 order-3 d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavMain aria-controls=offcanvasNavMain aria-label="Open main navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-menu" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><line x1="4" y1="8" x2="20" y2="8"/><line x1="4" y1="16" x2="20" y2="16"/></svg></button><div class="offcanvas offcanvas-end h-auto" tabindex=-1 id=offcanvasNavMain aria-labelledby=offcanvasNavMainLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavMainLabel>WLDT</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class="offcanvas-body d-flex flex-column flex-lg-row justify-content-between"><ul class="navbar-nav flex-grow-1"><li class=nav-item><a class=nav-link href=https://wldt.github.io/docs/guides/example-guide/>Documentation</a></li><li class=nav-item><a class=nav-link href=https://wldt.github.io/blog/>Blog</a></li></ul><button type=button id=searchToggleDesktop class="btn btn-link nav-link p-2 d-none d-lg-block" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button id=buttonColorMode class="btn btn-link mx-auto nav-link p-0 ms-lg-2 me-lg-1" type=button aria-label="Toggle theme"><svg data-bs-theme-value="dark" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-moon" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 3c.132.0.263.0.393.0a7.5 7.5.0 007.92 12.446A9 9 0 1112 2.992z"/></svg><svg data-bs-theme-value="light" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-sun" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-4 0a4 4 0 108 0 4 4 0 10-8 0m-5 0h1m8-9v1m8 8h1m-9 8v1M5.6 5.6l.7.7m12.1-.7-.7.7m0 11.4.7.7m-12.1-.7-.7.7"/></svg></button><ul id=socialMenu class="nav mx-auto flex-row order-lg-4"><li class=nav-item><a class="nav-link social-link" href=https://github.com/wldt><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-brand-github" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 19c-4.3 1.4-4.3-2.5-6-3m12 5v-3.5c0-1 .1-1.4-.5-2 2.8-.3 5.5-1.4 5.5-6a4.6 4.6.0 00-1.3-3.2 4.2 4.2.0 00-.1-3.2s-1.1-.3-3.5 1.3a12.3 12.3.0 00-6.2.0C6.5 2.8 5.4 3.1 5.4 3.1a4.2 4.2.0 00-.1 3.2A4.6 4.6.0 004 9.5c0 4.6 2.7 5.7 5.5 6-.6.6-.6 1.2-.5 2V21"/></svg><small class="ms-2 visually-hidden">GitHub</small></a></li></ul></div></div></div></header></div><div class=modal id=searchModal tabindex=-1 aria-labelledby=searchModalLabel aria-hidden=true><div class="modal-dialog modal-dialog-scrollable modal-fullscreen-md-down"><div class=modal-content><div class=modal-header><h1 class="modal-title fs-5 visually-hidden" id=searchModalLabel>Search</h1><button type=button class="btn-close visually-hidden" data-bs-dismiss=modal aria-label=Close></button><div class="search-input flex-grow-1 d-none"><form id=search-form class=search-form action=# method=post accept-charset=utf-8 role=search><label for=query class=visually-hidden>Search</label><div class=d-flex><input type=search id=query name=query class="search-text form-control form-control-lg" placeholder=Search aria-label=Search maxlength=128 autocomplete=off>
+<button type=button class="btn btn-link text-decoration-none px-0 ms-3 d-md-none" data-bs-dismiss=modal aria-label=Close>Cancel</button></div></form></div></div><div class=modal-body><p class="search-loading status message d-none mt-3 text-center">Loading search index…</p><p class="search-no-recent message d-none mt-3 text-center">No recent searches</p><p class="search-no-results message d-none mt-3 text-center">No results for "<strong><span class=query-no-results>Query here</span></strong>"</p><div id=searchResults class=search-results></div><template><article class="search-result list-view"><div class="card my-3"><div class=card-body><header><h2 class="h5 title title-submitted mb-0"><a class="stretched-link text-decoration-none text-reset" href=#>Title here</a></h2><div class="submitted d-none"><time class=created-date>Date here</time></div></header><div class=content>Summary here</div></div></div></article></template></div><div class=modal-footer><ul class="list-inline me-auto d-none d-md-block"><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Enter key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M12 3.53088v3c0 1-1 2-2 2H4m3 3-3-3 3-3"/></g></svg></kbd><span class=DocSearch-Label>to select</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Arrow down" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 3.5v8m3-3-3 3-3-3"/></g></svg></kbd><kbd class=me-2><svg width="15" height="15" aria-label="Arrow up" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 11.5v-8m3 3-3-3-3 3"/></g></svg></kbd><span class=DocSearch-Label>to navigate</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Escape key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M13.6167 8.936c-.1065.3583-.6883.962-1.4875.962-.7993.0-1.653-.9165-1.653-2.1258v-.5678c0-1.2548.7896-2.1016 1.653-2.1016s1.3601.4778 1.4875 1.0724M9 6c-.1352-.4735-.7506-.9219-1.46-.8972-.7092.0246-1.344.57-1.344 1.2166s.4198.8812 1.3445.9805C8.465 7.3992 8.968 7.9337 9 8.5s-.454 1.398-1.4595 1.398C6.6593 9.898 6 9 5.963 8.4851m-1.4748.5368c-.2635.5941-.8099.876-1.5443.876s-1.7073-.6248-1.7073-2.204v-.4603c0-1.0416.721-2.131 1.7073-2.131.9864.0 1.6425 1.031 1.5443 2.2492h-2.956"/></g></svg></kbd><span class=DocSearch-Label>to close</span></li></ul><p class=d-md-none>Search by <a class=text-decoration-none href=https://github.com/nextapps-de/flexsearch>FlexSearch</a></p></div></div></div></div><div class="wrap container-lg" role=document><div class=content><div class="row flex-xl-nowrap"><div class="col-lg-5 col-xl-4 docs-sidebar d-none d-lg-block"><nav class=docs-links aria-label="Main navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-0b79795d3efc95b9976c7c5b933afce2 aria-expanded=false>
+Introduction</button><div class=collapse id=section-0b79795d3efc95b9976c7c5b933afce2><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-model/>DT Model</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-life-cycle/>DT Life Cycle</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/>Library Structure & Basic Concepts</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-3978929206deee2c125a1d732aae5545 aria-expanded=true>
+Change Logs</button><div class="collapse show" id=section-3978929206deee2c125a1d732aae5545><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded active" href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/>Change Log 0.3.0</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-89413bd312d0909efb85e6693f36cb89 aria-expanded=false>
+Adapters</button><div class=collapse id=section-89413bd312d0909efb85e6693f36cb89><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/>MQTT Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/>MQTT Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/http-digital-adapter/>HTTP Digital Adapter</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-bf647454e36069fd16f1a7a35cf6a865 aria-expanded=false>
+Getting Started</button><div class=collapse id=section-bf647454e36069fd16f1a7a35cf6a865><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/physical-adapter/>Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/shadowing-function/>Shadowing Function</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-adapter/>Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/>DT Engine & DT Instance</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-actions/>Digital Actions</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/configurable-adapters/>Configurable Adapters</a></li></ul></div></li></ul></nav></div><nav class="docs-toc d-none d-xl-block col-xl-3" aria-label="Secondary navigation"><div class=page-links><h3>Example Guide</h3><nav id=toc><ul><li><a href=#digital-adapters>Digital Adapters</a></li><li><a href=#shadowing-function>Shadowing Function</a></li><li><a href=#wldt-engine--dt-creation>WLDT Engine & DT Creation</a></li></ul><ul><li><a href=#features>Features</a></li><li><a href=#usage>Usage</a><ul><li><a href=#exception-handling>Exception Handling</a></li></ul></li><li><a href=#shadowing-function-changes>Shadowing Function Changes</a></li></ul><ul><li><ul><li></li></ul></li></ul></nav></div></nav><main class="docs-content col-lg-11 col-xl-9"><nav aria-label=breadcrumb><ol class=breadcrumb><li class=breadcrumb-item><a href=https://wldt.github.io/>Home</a></li><li class=breadcrumb-item><a href=https://wldt.github.io/docs/>Docs</a></li><li class=breadcrumb-item><a href=https://wldt.github.io/docs/change-logs/>Change Logs</a></li><li class="breadcrumb-item active" aria-current=page>Change Log 0.3.0</li></ol></nav><h1>Change Log 0.3.0</h1><nav class="toc-mobile d-xl-none" aria-label="Quaternary navigation"><details><summary>On this page</summary><div class=page-links><nav id=TableOfContents><ul><li><a href=#digital-adapters>Digital Adapters</a></li><li><a href=#shadowing-function>Shadowing Function</a></li><li><a href=#wldt-engine--dt-creation>WLDT Engine & DT Creation</a></li></ul><ul><li><a href=#features>Features</a></li><li><a href=#usage>Usage</a><ul><li><a href=#exception-handling>Exception Handling</a></li></ul></li><li><a href=#shadowing-function-changes>Shadowing Function Changes</a></li></ul><ul><li><ul><li></li></ul></li></ul></nav></div></details></nav><h2 id=digital-adapters>Digital Adapters<a href=#digital-adapters class=anchor aria-hidden=true>#</a></h2><ul><li>The following methods have been discontinued and removed from the <code>DigitalAdapter</code> class:<ul><li><code>onStateChangePropertyCreated</code></li><li><code>onStateChangePropertyUpdated</code></li><li><code>onStateChangePropertyDeleted</code></li><li><code>onStatePropertyUpdated</code></li><li><code>onStatePropertyDeleted</code></li><li><code>onStateChangeActionEnabled</code></li><li><code>onStateChangeActionUpdated</code></li><li><code>onStateChangeActionDisabled</code></li><li><code>onStateChangeEventRegistered</code></li><li><code>onStateChangeEventRegistrationUpdated</code></li><li><code>onStateChangeEventUnregistered</code></li><li><code>onStateChangeRelationshipInstanceDeleted</code></li><li><code>onStateChangeRelationshipDeleted</code></li><li><code>onStateChangeRelationshipInstanceCreated</code></li><li><code>onStateChangeRelationshipCreated</code></li><li><code>onDigitalTwinStateEventNotificationReceived</code></li></ul></li><li>The Signature of the following methods have been changed:<ul><li><code>onDigitalTwinSync(IDigitalTwinState currentDigitalTwinState)</code> -> <code>onDigitalTwinSync(DigitalTwinState currentDigitalTwinState)</code></li><li><code>onDigitalTwinUnSync(IDigitalTwinState currentDigitalTwinState)</code> -> <code>onDigitalTwinUnSync(DigitalTwinState currentDigitalTwinState)</code></li></ul></li><li>New methods that have been added are:<ul><li><code>onStateUpdate(DigitalTwinState newDigitalTwinState, DigitalTwinState previousDigitalTwinState, ArrayList&lt;DigitalTwinStateChange> digitalTwinStateChangeList)</code></li><li><code>onEventNotificationReceived(DigitalTwinStateEventNotification&lt;?> digitalTwinStateEventNotification)</code></li></ul></li><li>For additional details about Digital Adapters check Sub Section [[Change Log - v.0.3.0#Digital Adapter| Digital Adapters]]</li></ul><h2 id=shadowing-function>Shadowing Function<a href=#shadowing-function class=anchor aria-hidden=true>#</a></h2><ul><li><code>ShadowingModelFunction</code> is now <code>ShadowingFunction</code></li><li><code>this.digitalTwinState</code> is not directly accessible anymore and it is wrapped through the <code>DigitalTwinStateManager</code> using the variable <code>digitalTwinStateManager</code> (see next descriptions and changes)</li><li>The method <code>addRelationshipInstance</code> now take only one parameter that is the <code>DigitalTwinStateRelationshipInstance</code></li><li>The same change for example should be applied in the point of the code where the Shadowing Function receive a variation from the Physical world through a target adapter and the callback method <code>onPhysicalAssetPropertyVariation(...)</code></li><li>When the Shadowing Function has to compute the new DT State it can now work with the following method to handle DT State Transition:<ul><li><code>this.digitalTwinStateManager.startStateTransaction()</code></li><li>DT State variation methods such as:<ul><li><code>digitalTwinStateManager.createProperty()</code></li><li><code>digitalTwinStateManager.updateProperty()</code></li><li><code>digitalTwinStateManager.updatePropertyValue()</code></li><li><code>digitalTwinStateManager.deleteProperty()</code></li><li><code>digitalTwinStateManager.enableAction()</code></li><li><code>digitalTwinStateManager.updateAction()</code></li><li><code>digitalTwinStateManager.disableAction()</code></li><li><code>digitalTwinStateManager.registerEvent()</code></li><li><code>digitalTwinStateManager.updateRegisteredEvent()</code></li><li><code>digitalTwinStateManager.unRegisterEvent()</code></li><li><code>digitalTwinStateManager.createRelationship()</code></li><li><code>digitalTwinStateManager.addRelationshipInstance()</code></li><li><code>digitalTwinStateManager.deleteRelationship()</code></li><li><code>digitalTwinStateManager.deleteRelationshipInstance()</code></li></ul></li><li>At the end the transaction can be committed using the method: <code>digitalTwinStateManager.commitStateTransaction()</code></li></ul></li><li><ul><li>The method <code>notifyDigitalTwinStateEvent</code> is now available through the <code>digitalTwinStateManager</code></li></ul></li><li>Additional Details associated to Shadowing Function Migration can be found in the dedicated section [[Change Log - v.0.3.0#Shadowing Function Changes | Shadowing Function Changes]]</li></ul><h2 id=wldt-engine--dt-creation>WLDT Engine & DT Creation<a href=#wldt-engine--dt-creation class=anchor aria-hidden=true>#</a></h2><ul><li><code>WldtEngine</code> is now <code>DigitalTwin</code> and model and structure a single Digital Twin and takes the following parameters:<ul><li><code>String digitalTwinId</code></li><li><code>ShadowingFunction shadowingFunction</code></li></ul></li><li>The <code>startLifeCycle</code> has been removed from the DigitalTwin (previously WLDT Engine) and now <code>DigitalTwinEngine</code> should be used to start twins</li><li>Once a new Digital Twin has been create it has to be added to the <code>DigitalTwinEngine</code></li><li><code>DigitalTwinEngine</code> has dedicated method to start and stop twins such as:<ul><li><code>startAll()</code></li><li><code>startDigitalTwin(&lt;DIGITAL_TWIN_ID>);</code></li><li><code>stopAll()</code></li><li><code>digitalTwinEngine.stopDigitalTwin(&lt;DIGITAL_TWIN_ID>);</code></li></ul></li></ul><h1 id=digital-twin--digital-twin-engine>Digital Twin & Digital Twin Engine</h1><p>With the following code we now create a new Digital Twin Instance</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=c1>// Create the new Digital Twin with its Shadowing Function  
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>DigitalTwin</span> <span class=n>digitalTwin</span> <span class=o>=</span> <span class=k>new</span> <span class=n>DigitalTwin</span><span class=o>(</span><span class=n>digitalTwinId</span><span class=o>,</span> <span class=k>new</span> <span class=n>DemoShadowingFunction</span><span class=o>());</span>  
+</span></span><span class=line><span class=cl>  
+</span></span><span class=line><span class=cl><span class=c1>// Physical Adapter with Configuration  
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>digitalTwin</span><span class=o>.</span><span class=na>addPhysicalAdapter</span><span class=o>(</span>  
+</span></span><span class=line><span class=cl>        <span class=k>new</span> <span class=n>DemoPhysicalAdapter</span><span class=o>(</span>  
+</span></span><span class=line><span class=cl>                <span class=n>String</span><span class=o>.</span><span class=na>format</span><span class=o>(</span><span class=s>&#34;%s-%s&#34;</span><span class=o>,</span> <span class=n>digitalTwinId</span><span class=o>,</span> <span class=s>&#34;test-physical-adapter&#34;</span><span class=o>),</span>  
+</span></span><span class=line><span class=cl>                <span class=k>new</span> <span class=n>DemoPhysicalAdapterConfiguration</span><span class=o>(),</span>  
+</span></span><span class=line><span class=cl>                <span class=kc>true</span><span class=o>));</span>  
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=c1>// Digital Adapter with Configuration  
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>digitalTwin</span><span class=o>.</span><span class=na>addDigitalAdapter</span><span class=o>(</span>  
+</span></span><span class=line><span class=cl>        <span class=k>new</span> <span class=n>DemoDigitalAdapter</span><span class=o>(</span>  
+</span></span><span class=line><span class=cl>                <span class=n>String</span><span class=o>.</span><span class=na>format</span><span class=o>(</span><span class=s>&#34;%s-%s&#34;</span><span class=o>,</span> <span class=n>digitalTwinId</span><span class=o>,</span> <span class=s>&#34;test-digital-adapter&#34;</span><span class=o>),</span>  
+</span></span><span class=line><span class=cl>                <span class=k>new</span> <span class=n>DemoDigitalAdapterConfiguration</span><span class=o>())</span>  
+</span></span><span class=line><span class=cl><span class=o>);</span>
+</span></span></code></pre></div><p>In the new version the DT cannot be directly run but it should be added to the <code>DigitalTwinEngine</code> in order to be executed through the WLDT Library</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=c1>// Create the Digital Twin Engine
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>DigitalTwinEngine</span> <span class=n>digitalTwinEngine</span> <span class=o>=</span> <span class=k>new</span> <span class=n>DigitalTwinEngine</span><span class=o>();</span>  
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=c1>// Add the Digital Twin to the Engine
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>digitalTwinEngine</span><span class=o>.</span><span class=na>addDigitalTwin</span><span class=o>(</span><span class=n>digitalTwin</span><span class=o>);</span>
+</span></span></code></pre></div><p>In order to start a DT from the Engine you can:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=c1>// Directly start when you add it passing a second boolean value = true
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>digitalTwinEngine</span><span class=o>.</span><span class=na>addDigitalTwin</span><span class=o>(</span><span class=n>digitalTwin</span><span class=o>.</span> <span class=kc>true</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=c1>// Starting the single DT on the engine through its id
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>digitalTwinEngine</span><span class=o>.</span><span class=na>startDigitalTwin</span><span class=o>(</span><span class=n>DIGITAL_TWIN_ID</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=c1>// Start all the DTs registered on the engine
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>digitalTwinEngine</span><span class=o>.</span><span class=na>startAll</span><span class=o>();</span>
+</span></span></code></pre></div><p>To stop a single twin or all the twin registered on the engine:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=c1>// Stop a single DT on the engine through its id
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>digitalTwinEngine</span><span class=o>.</span><span class=na>stopDigitalTwin</span><span class=o>(</span><span class=n>DIGITAL_TWIN_ID</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=c1>// Stop all the DTs registered on the engine
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>digitalTwinEngine</span><span class=o>.</span><span class=na>stopAll</span><span class=o>();</span>
+</span></span></code></pre></div><p>It is also possible to remove a DT from the Engine with a consequent stop if it is active and the deletion of its reference from the engine:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=c1>// Remove a single DT on the engine through its id
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>digitalTwinEngine</span><span class=o>.</span><span class=na>removeDigitalTwin</span><span class=o>(</span><span class=n>DIGITAL_TWIN_ID</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=c1>// Remove all the DTs registered on the engine
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>digitalTwinEngine</span><span class=o>.</span><span class=na>removeAll</span><span class=o>();</span>
+</span></span></code></pre></div><h1 id=digital-twin-state>Digital Twin State</h1><ul><li>DT State now has the reference timestamp representing the evaluation instant of the digital twin state, this timestamp is computed through the <code>DigitalTwinStateManager</code> and cannot manually set by the developer</li><li>The information available on the DT State are:<ul><li><code>properties</code>: List of Properties with their values (if available)</li><li><code>actions</code>: List of Actions that can be called on the DT</li><li><code>events</code>: List of Events that can be generated by the DT</li><li><code>relationships</code>: List of Relationships and their instances (if available)</li><li><code>evaluationInstant</code>: The timestamp representing the evaluation instant of the DT state</li></ul></li><li>Available main methods on that class instance are:<ul><li>Properties:<br>- <code>getProperty(String propertyKey)</code>: Retrieves if present the target DigitalTwinStateProperty by Key<br>- <code>containsProperty(String propertyKey)</code>: Checks if a target Property Key is already available in the current Digital Twin&rsquo;s State<br>- <code>getPropertyList()</code>: Loads the list of available Properties (described by the class DigitalTwinStateProperty) available on the Digital Twin&rsquo;s State<br>- <code>createProperty(DigitalTwinStateProperty&lt;?> dtStateProperty)</code>: Allows the creation of a new Property on the Digital Twin&rsquo;s State through the class DigitalTwinStateProperty<br>- <code>readProperty(String propertyKey)</code>: Retrieves if present the target DigitalTwinStateProperty by Key<br>- <code>updateProperty(DigitalTwinStateProperty&lt;?> dtStateProperty)</code>: Updates the target property using the DigitalTwinStateProperty and the associated Property Key field<br>- <code>deleteProperty(String propertyKey)</code>: Deletes the target property identified by the specified key</li><li>Actions:<br>- <code>containsAction(String actionKey)</code>: Checks if a Digital Twin State Action with the specified key is correctly registered<br>- <code>getAction(String actionKey)</code>: Loads the target DigitalTwinStateAction by key<br>- <code>getActionList()</code>: Gets the list of available Actions registered on the Digital Twin&rsquo;s State<br>- <code>enableAction(DigitalTwinStateAction digitalTwinStateAction)</code>: Enables and registers the target Action described through an instance of the DigitalTwinStateAction class<br>- <code>updateAction(DigitalTwinStateAction digitalTwinStateAction)</code>: Update the already registered target Action described through an instance of the DigitalTwinStateAction class<br>- <code>disableAction(String actionKey)</code>: Disables and unregisters the target Action described through an instance of the DigitalTwinStateAction class</li><li>Events:<br>- <code>containsEvent(String eventKey)</code>: Check if a Digital Twin State Event with the specified key is correctly registered<br>- <code>getEvent(String eventKey)</code>: Return the description of a registered Digital Twin State Event according to its Key<br>- <code>getEventList()</code>: Return the list of existing and registered Digital Twin State Events<br>- <code>registerEvent(DigitalTwinStateEvent digitalTwinStateEvent)</code>: Register a new Digital Twin State Event<br>- <code>updateRegisteredEvent(DigitalTwinStateEvent digitalTwinStateEvent)</code>: Update the registration and signature of an existing Digital Twin State Event<br>- <code>unRegisterEvent(String eventKey)</code>: Un-register a Digital Twin State Event<br>- <code>notifyDigitalTwinStateEvent(DigitalTwinStateEventNotification&lt;?> digitalTwinStateEventNotification)</code>: Method to notify the occurrence of the target Digital Twin State Event</li><li>Relationships:<br>- <code>containsRelationship(String relationshipName)</code>: Checks if a Relationship Name is already available in the current Digital Twin&rsquo;s State<br>- <code>createRelationship(DigitalTwinStateRelationship&lt;?> relationship)</code>: Creates a new Relationships (described by the class DigitalTwinStateRelationship) in the Digital Twin&rsquo;s State<br>- <code>addRelationshipInstance(String name, DigitalTwinStateRelationshipInstance&lt;?> instance)</code>: Adds a new Relationship instance described through the class DigitalTwinStateRelationshipInstance and identified through its name<br>- <code>getRelationshipList()</code>: Loads the list of existing relationships on the Digital Twin&rsquo;s State through a list of DigitalTwinStateRelationship<br>- <code>getRelationship(String name)</code>: Gets a target Relationship identified through its name and described through the class DigitalTwinStateRelationship<br>- <code>deleteRelationship(String name)</code>: Deletes a target Relationship identified through its name<br>- <code>deleteRelationshipInstance(String relationshipName, String instanceKey)</code>: Deletes the target Relationship Instance using relationship name and instance Key</li></ul></li></ul><h1 id=digital-twin-state-manager>Digital Twin State Manager</h1><p>The <code>DigitalTwinStateManager</code> is a Java class that serves as the default implementation of the <code>IDigitalTwinStateManager</code> interface within the White Label Digital Twin Java Framework (whitelabel-digitaltwin). This class allows developers to manage the state of a digital twin, including properties, actions, events, and relationships.</p><h2 id=features>Features<a href=#features class=anchor aria-hidden=true>#</a></h2><ul><li><strong>State Management:</strong> Handles the creation, update, and deletion of properties, actions, events, and relationships associated with the digital twin state.</li><li><strong>Transaction Support:</strong> Allows developers to start, commit, or rollback transactions to manage changes to the digital twin state.</li><li><strong>Event Notification:</strong> Notifies listeners about updates to the digital twin state through the WLDT event bus.</li></ul><p>When the Shadowing Function has to compute the new DT State it can now work with the following method to handle DT State Transition:
+- Start the DT State Transaction: <code>startStateTransaction()</code>
+- DT State variation methods such as:
+- <code>createProperty()</code>
+- <code>updateProperty()</code><br>- <code>updatePropertyValue()</code>
+- <code>deleteProperty()</code>
+- <code>enableAction()</code>
+- <code>updateAction()</code>
+- <code>disableAction()</code>
+- <code>registerEvent()</code>
+- <code>updateRegisteredEvent()</code>
+- <code>unRegisterEvent()</code>
+- <code>createRelationship()</code>
+- <code>addRelationshipInstance()</code>
+- <code>deleteRelationship()</code>
+- <code>deleteRelationshipInstance()</code></p><p>At the end the transaction can be committed using the method: <code>commitStateTransaction()</code></p><h2 id=usage>Usage<a href=#usage class=anchor aria-hidden=true>#</a></h2><p>To use the <code>DigitalTwinStateManager</code> within your digital twin implementation:</p><ol><li><strong>Initialization:</strong> Create an instance of the <code>DigitalTwinStateManager</code>.</li></ol><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=n>DigitalTwinStateManager</span> <span class=n>digitalTwinStateManager</span> <span class=o>=</span> <span class=k>new</span> <span class=n>DigitalTwinStateManager</span><span class=o>();</span>
+</span></span></code></pre></div><ol start=2><li><p><strong>State Transaction:</strong></p><ul><li>Start a new transaction using <code>startStateTransaction()</code> to manage changes.</li><li>Make changes to the digital twin state.</li><li>Commit the transaction using <code>commitStateTransaction()</code> to apply the changes.</li></ul></li></ol><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=n>digitalTwinStateManager</span><span class=o>.</span><span class=na>startStateTransaction</span><span class=o>();</span> 
+</span></span><span class=line><span class=cl><span class=c1>// Make changes to properties, actions, events, or relationships 
+</span></span></span><span class=line><span class=cl><span class=c1>// [...]
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>digitalTwinStateManager</span><span class=o>.</span><span class=na>commitStateTransaction</span><span class=o>();</span>
+</span></span></code></pre></div><ol start=3><li><p><strong>Event Notification:</strong></p><ul><li>DT State Updates after a commit action are automatically notified to Digital Adapter by the Manager</li><li>Once an event incoming from the physical or generated by the DT itself is handled by the Shadowing Function, the developer can use <code>notifyDigitalTwinStateUpdate</code> to notify Digital Adapter listening about events variations.</li></ul></li></ol><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=c1>// Notify a specific event notification 
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>digitalTwinStateManager</span><span class=o>.</span><span class=na>notifyDigitalTwinStateEvent</span><span class=o>(</span><span class=n>digitalTwinStateEventNotification</span><span class=o>);</span>
+</span></span></code></pre></div><ol start=4><li><p><strong>Property, Action, Event, Relationship Management:</strong></p><ul><li>Create, update, or delete properties, actions, events, or relationships as needed.</li></ul></li></ol><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=c1>// Begin Digital Twin State Transaction
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>digitalTwinStateManager</span><span class=o>.</span><span class=na>startStateTransaction</span><span class=o>();</span> 
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=c1>// Create a new property 
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>digitalTwinStateManager</span><span class=o>.</span><span class=na>createProperty</span><span class=o>(</span><span class=n>dtStateProperty</span><span class=o>);</span>  
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=c1>// Update an existing property 
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>digitalTwinStateManager</span><span class=o>.</span><span class=na>updateProperty</span><span class=o>(</span><span class=n>dtStateProperty</span><span class=o>);</span>  
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=c1>// Delete a property 
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>digitalTwinStateManager</span><span class=o>.</span><span class=na>deleteProperty</span><span class=o>(</span><span class=n>propertyKey</span><span class=o>);</span><span class=err>`</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=c1>// Commit DT State Update to apply all the changes and notify the Digital Adapters and other listeners about the variation
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>digitalTwinStateManager</span><span class=o>.</span><span class=na>commitStateTransaction</span><span class=o>();</span>
+</span></span></code></pre></div><h3 id=exception-handling>Exception Handling<a href=#exception-handling class=anchor aria-hidden=true>#</a></h3><ul><li>The class throws <code>WldtDigitalTwinStateException</code> to indicate errors related to digital twin state management.</li><li>Proper exception handling is advised to manage potential errors during state transactions.</li></ul><h2 id=shadowing-function-changes>Shadowing Function Changes<a href=#shadowing-function-changes class=anchor aria-hidden=true>#</a></h2><p>Now that the DT State is managed through the <code>DigitalTwinStateManager</code> class all the changes and variation should be applied on the DT ShadowingFunction using the previously presented transaction management and the correct call of methods <code>startStateTransaction()</code> and <code>commitStateTransaction()</code>.</p><p>Here there is an example of the change with a simple and demo shadowing function on callback <code>onDigitalTwinBound</code>:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=nd>@Override</span>  
+</span></span><span class=line><span class=cl><span class=kd>protected</span> <span class=kt>void</span> <span class=nf>onDigitalTwinBound</span><span class=o>(</span><span class=n>Map</span><span class=o>&lt;</span><span class=n>String</span><span class=o>,</span> <span class=n>PhysicalAssetDescription</span><span class=o>&gt;</span> <span class=n>adaptersPhysicalAssetDescriptionMap</span><span class=o>)</span> <span class=o>{</span>  
+</span></span><span class=line><span class=cl>  
+</span></span><span class=line><span class=cl>    <span class=k>try</span><span class=o>{</span>    
+</span></span><span class=line><span class=cl>  
+</span></span><span class=line><span class=cl>		<span class=c1>// NEW -&gt; Start DT State Change Transaction  
+</span></span></span><span class=line><span class=cl><span class=c1></span>		<span class=k>this</span><span class=o>.</span><span class=na>digitalTwinStateManager</span><span class=o>.</span><span class=na>startStateTransaction</span><span class=o>();</span>  
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>		<span class=k>for</span><span class=o>(</span><span class=n>Map</span><span class=o>.</span><span class=na>Entry</span><span class=o>&lt;</span><span class=n>String</span><span class=o>,</span> <span class=n>PhysicalAssetDescription</span><span class=o>&gt;</span> <span class=n>entry</span> <span class=o>:</span> <span class=n>adaptersPhysicalAssetDescriptionMap</span><span class=o>.</span><span class=na>entrySet</span><span class=o>()){</span>  
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>			<span class=n>String</span> <span class=n>adapterId</span> <span class=o>=</span> <span class=n>entry</span><span class=o>.</span><span class=na>getKey</span><span class=o>();</span>  
+</span></span><span class=line><span class=cl>			<span class=n>PhysicalAssetDescription</span> <span class=n>physicalAssetDescription</span> <span class=o>=</span> <span class=n>entry</span><span class=o>.</span><span class=na>getValue</span><span class=o>();</span>  
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>			<span class=c1>//In that simple case the Digital Twin shadow all the properties and actions available in the physical asset  
+</span></span></span><span class=line><span class=cl><span class=c1></span>			<span class=k>for</span><span class=o>(</span><span class=n>PhysicalAssetProperty</span><span class=o>&lt;?&gt;</span> <span class=n>p</span> <span class=o>:</span> <span class=n>physicalAssetDescription</span><span class=o>.</span><span class=na>getProperties</span><span class=o>())</span>  
+</span></span><span class=line><span class=cl>				<span class=k>this</span><span class=o>.</span><span class=na>digitalTwinStateManager</span><span class=o>.</span><span class=na>createProperty</span><span class=o>(</span><span class=k>new</span> <span class=n>DigitalTwinStateProperty</span><span class=o>&lt;&gt;(</span><span class=n>p</span><span class=o>.</span><span class=na>getKey</span><span class=o>(),</span> <span class=n>p</span><span class=o>.</span><span class=na>getInitialValue</span><span class=o>()));</span>  
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>			<span class=k>for</span><span class=o>(</span><span class=n>PhysicalAssetAction</span> <span class=n>a</span> <span class=o>:</span> <span class=n>physicalAssetDescription</span><span class=o>.</span><span class=na>getActions</span><span class=o>())</span>  
+</span></span><span class=line><span class=cl>				<span class=k>this</span><span class=o>.</span><span class=na>digitalTwinStateManager</span><span class=o>.</span><span class=na>enableAction</span><span class=o>(</span><span class=k>new</span> <span class=n>DigitalTwinStateAction</span><span class=o>(</span><span class=n>a</span><span class=o>.</span><span class=na>getKey</span><span class=o>(),</span>  
+</span></span><span class=line><span class=cl>						<span class=n>a</span><span class=o>.</span><span class=na>getType</span><span class=o>(),</span>  
+</span></span><span class=line><span class=cl>						<span class=n>a</span><span class=o>.</span><span class=na>getContentType</span><span class=o>()));</span>  
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>			<span class=k>for</span><span class=o>(</span><span class=n>PhysicalAssetEvent</span> <span class=n>e</span><span class=o>:</span> <span class=n>physicalAssetDescription</span><span class=o>.</span><span class=na>getEvents</span><span class=o>())</span>  
+</span></span><span class=line><span class=cl>				<span class=k>this</span><span class=o>.</span><span class=na>digitalTwinStateManager</span><span class=o>.</span><span class=na>registerEvent</span><span class=o>(</span><span class=k>new</span> <span class=n>DigitalTwinStateEvent</span><span class=o>(</span><span class=n>e</span><span class=o>.</span><span class=na>getKey</span><span class=o>(),</span> <span class=n>physicalAssetEvent</span><span class=o>.</span><span class=na>getType</span><span class=o>()));</span>  
+</span></span><span class=line><span class=cl>		<span class=o>}</span>  
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>		<span class=c1>// NEW -&gt; Commit DT State Change Transaction to apply the changes on the DT State and notify about the change  
+</span></span></span><span class=line><span class=cl><span class=c1></span>		<span class=k>this</span><span class=o>.</span><span class=na>digitalTwinStateManager</span><span class=o>.</span><span class=na>commitStateTransaction</span><span class=o>();</span>      
+</span></span><span class=line><span class=cl>  
+</span></span><span class=line><span class=cl>        <span class=c1>//Observer Target Physical Properties  
+</span></span></span><span class=line><span class=cl><span class=c1></span>        <span class=k>for</span><span class=o>(</span><span class=n>Map</span><span class=o>.</span><span class=na>Entry</span><span class=o>&lt;</span><span class=n>String</span><span class=o>,</span> <span class=n>PhysicalAssetDescription</span><span class=o>&gt;</span> <span class=n>entry</span> <span class=o>:</span> <span class=n>adaptersPhysicalAssetDescriptionMap</span><span class=o>.</span><span class=na>entrySet</span><span class=o>()){</span>  
+</span></span><span class=line><span class=cl>		  <span class=o>[...]</span>
+</span></span><span class=line><span class=cl>        <span class=o>}</span>  
+</span></span><span class=line><span class=cl>  
+</span></span><span class=line><span class=cl>        <span class=c1>//Observe all the target available Physical Asset Events for each Adapter  
+</span></span></span><span class=line><span class=cl><span class=c1></span>        <span class=k>for</span><span class=o>(</span><span class=n>Map</span><span class=o>.</span><span class=na>Entry</span><span class=o>&lt;</span><span class=n>String</span><span class=o>,</span> <span class=n>PhysicalAssetDescription</span><span class=o>&gt;</span> <span class=n>entry</span> <span class=o>:</span> <span class=n>adaptersPhysicalAssetDescriptionMap</span><span class=o>.</span><span class=na>entrySet</span><span class=o>()){</span>  
+</span></span><span class=line><span class=cl>		  <span class=o>[...]</span>
+</span></span><span class=line><span class=cl>        <span class=o>}</span>  
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>		<span class=c1>// Observer for Incoming Digital Actions
+</span></span></span><span class=line><span class=cl><span class=c1></span>        <span class=n>observeDigitalActionEvents</span><span class=o>();</span>  
+</span></span><span class=line><span class=cl>	    
+</span></span><span class=line><span class=cl>	    <span class=c1>//Notify Shadowing Completed  
+</span></span></span><span class=line><span class=cl><span class=c1></span>		<span class=n>notifyShadowingSync</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>  
+</span></span><span class=line><span class=cl>    <span class=o>}</span><span class=k>catch</span> <span class=o>(</span><span class=n>Exception</span> <span class=n>e</span><span class=o>){</span>  
+</span></span><span class=line><span class=cl>        <span class=n>e</span><span class=o>.</span><span class=na>printStackTrace</span><span class=o>();</span>  
+</span></span><span class=line><span class=cl>    <span class=o>}</span>  
+</span></span><span class=line><span class=cl><span class=o>}</span>
+</span></span></code></pre></div><p>The same change for example should be applied in the point of the code where the Shadowing Function receive a variation from the Physical world through a target adapter and the callback method <code>onPhysicalAssetPropertyVariation(...)</code></p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=nd>@Override</span>  
+</span></span><span class=line><span class=cl><span class=kd>protected</span> <span class=kt>void</span> <span class=nf>onPhysicalAssetPropertyVariation</span><span class=o>(</span><span class=n>PhysicalAssetPropertyWldtEvent</span><span class=o>&lt;?&gt;</span> <span class=n>physicalPropertyEventMessage</span><span class=o>)</span> <span class=o>{</span>  
+</span></span><span class=line><span class=cl>  
+</span></span><span class=line><span class=cl>    <span class=k>try</span> <span class=o>{</span>  
+</span></span><span class=line><span class=cl>    
+</span></span><span class=line><span class=cl>        <span class=k>if</span><span class=o>(</span><span class=n>physicalPropertyEventMessage</span> <span class=o>!=</span> <span class=kc>null</span> <span class=o>&amp;&amp;</span> <span class=n>getPhysicalEventsFilter</span><span class=o>().</span><span class=na>contains</span><span class=o>(</span><span class=n>physicalPropertyEventMessage</span><span class=o>.</span><span class=na>getType</span><span class=o>())){</span>  
+</span></span><span class=line><span class=cl>   
+</span></span><span class=line><span class=cl>            <span class=k>if</span><span class=o>(</span><span class=n>physicalPropertyEventMessage</span><span class=o>.</span><span class=na>getPhysicalPropertyId</span><span class=o>().</span><span class=na>equals</span><span class=o>(</span><span class=n>TestPhysicalAdapter</span><span class=o>.</span><span class=na>SWITCH_PROPERTY_KEY</span><span class=o>)</span>  
+</span></span><span class=line><span class=cl>                    <span class=o>&amp;&amp;</span> <span class=n>physicalPropertyEventMessage</span><span class=o>.</span><span class=na>getBody</span><span class=o>()</span> <span class=k>instanceof</span> <span class=n>String</span><span class=o>){</span>  
+</span></span><span class=line><span class=cl>			  <span class=o>[...]</span>  
+</span></span><span class=line><span class=cl>            <span class=o>}</span>  
+</span></span><span class=line><span class=cl>            <span class=k>else</span><span class=o>{</span>  
+</span></span><span class=line><span class=cl>    
+</span></span><span class=line><span class=cl>                <span class=c1>//Update Digital Twin State  
+</span></span></span><span class=line><span class=cl><span class=c1></span>                <span class=c1>//NEW -&gt; Start State Transaction
+</span></span></span><span class=line><span class=cl><span class=c1></span>                <span class=k>this</span><span class=o>.</span><span class=na>digitalTwinStateManager</span><span class=o>.</span><span class=na>startStateTransaction</span><span class=o>();</span>  
+</span></span><span class=line><span class=cl>                
+</span></span><span class=line><span class=cl>                <span class=c1>// Update State Property Value
+</span></span></span><span class=line><span class=cl><span class=c1></span>                <span class=k>this</span><span class=o>.</span><span class=na>digitalTwinStateManager</span><span class=o>.</span><span class=na>updateProperty</span><span class=o>(</span>  
+</span></span><span class=line><span class=cl>                        <span class=k>new</span> <span class=n>DigitalTwinStateProperty</span><span class=o>&lt;&gt;(</span>  
+</span></span><span class=line><span class=cl>                                <span class=n>physicalPropertyEventMessage</span><span class=o>.</span><span class=na>getPhysicalPropertyId</span><span class=o>(),</span>  
+</span></span><span class=line><span class=cl>                                <span class=n>physicalPropertyEventMessage</span><span class=o>.</span><span class=na>getBody</span><span class=o>()));</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>				<span class=c1>//NEW -&gt; Commit State Transaction
+</span></span></span><span class=line><span class=cl><span class=c1></span>                <span class=k>this</span><span class=o>.</span><span class=na>digitalTwinStateManager</span><span class=o>.</span><span class=na>commitStateTransaction</span><span class=o>();</span>  
+</span></span><span class=line><span class=cl>            <span class=o>}</span>  
+</span></span><span class=line><span class=cl>        <span class=o>}</span>  
+</span></span><span class=line><span class=cl>        <span class=k>else</span>  
+</span></span><span class=line><span class=cl>            <span class=n>logger</span><span class=o>.</span><span class=na>error</span><span class=o>(</span><span class=s>&#34;WRONG Physical Event Message Received !&#34;</span><span class=o>);</span>  
+</span></span><span class=line><span class=cl>  
+</span></span><span class=line><span class=cl>    <span class=o>}</span><span class=k>catch</span> <span class=o>(</span><span class=n>Exception</span> <span class=n>e</span><span class=o>){</span>  
+</span></span><span class=line><span class=cl>        <span class=n>e</span><span class=o>.</span><span class=na>printStackTrace</span><span class=o>();</span>  
+</span></span><span class=line><span class=cl>    <span class=o>}</span>  
+</span></span><span class=line><span class=cl><span class=o>}</span>
+</span></span></code></pre></div><h1 id=digital-adapter>Digital Adapter</h1><p>The Digital Adapter base class has been significantly extended and improved with respect to the previous version.
+In this new Version notifications that are received by the Adapter from the the DT core belongs to the following categories:</p><ul><li><strong>Digital Twin State Update</strong> through the method <code>onStateUpdate(...)</code> providing information about the new state of the Digital Twin, the previous state, and a list of changes that occurred between these two states. In the previous version each variation of a property, relationships, actions or events were notified. In the new version only a committed DT&rsquo;State variation is notified to listeners.</li><li><strong>Event Notifications</strong> through the method <code>onEventNotificationReceived(...)</code> whenever there is a notification about an event related to the Digital Twin&rsquo;s state coming from the physical world, generated by the twin and processed by the Shadowing Function. For example in the DT State we can have the declaration of the <code>over-heating-alert</code> structured and received in the DT State while the effective occurrence of the event and the associated notification is notified through this dedicated callback</li></ul><p>The <code>onStateUpdate</code> method is an abstract method that must be implemented by any class extending the <code>DigitalAdapter</code> class. This method is called whenever there is an update to the Digital Twin&rsquo;s state. It provides information about the new state of the Digital Twin, the previous state, and a list of changes that occurred between these two states.</p><p>Here is an explanation of the parameters:</p><ol><li><p><code>newDigitalTwinState</code>: This parameter represents the updated state of the Digital Twin. It is an instance of the <code>DigitalTwinState</code> class, which encapsulates the current state information.</p></li><li><p><code>previousDigitalTwinState</code>: This parameter represents the state of the Digital Twin before the update. It is also an instance of the <code>DigitalTwinState</code> class.</p></li><li><p><code>digitalTwinStateChangeList</code>: This parameter is an <code>ArrayList</code> containing <code>DigitalTwinStateChange</code> objects. Each <code>DigitalTwinStateChange</code> object encapsulates information about a specific change that occurred between the previous and new states. It includes details such as the property or aspect of the state that changed, the previous value, and the new value.</p></li></ol><p>The DT State is automatically monitored by each Digital Adapter while for the <code>Events</code> potentially generated by the DT can be observed by each adapter using:</p><ul><li><code>observeAllDigitalTwinEventsNotifications</code>: Enable the observation of available Digital Twin State Events Notifications.</li><li><code>unObserveAllDigitalTwinEventsNotifications</code>: Cancel the observation of Digital Twin State Events Notifications</li><li><code>observeDigitalTwinEventsNotifications</code>: Enable the observation of the notification associated to a specific list of Digital Twin State events. With respect to event a notification contains the new associated value</li><li><code>unObserveDigitalTwinEventsNotifications</code>: Cancel the observation of a target list of properties</li><li><code>observeDigitalTwinEventNotification</code>: Enable the observation of the notification associated to a single Digital Twin State event. With respect to event a notification contains the new associated value</li><li><code>unObserveDigitalTwinEventNotification</code>: Cancel the observation of a single target event</li></ul><h4 id=digitaltwinstatechange-class>DigitalTwinStateChange Class<a href=#digitaltwinstatechange-class class=anchor aria-hidden=true>#</a></h4><p><strong>DigitalTwinStateChange Class</strong></p><p>The <code>DigitalTwinStateChange</code> class is a representation of a change that occurred in the state of a Digital Twin. It encapsulates information about the type of operation, the resource type, and the affected resource within the Digital Twin.</p><p><strong>Enums:</strong></p><ul><li><code>Operation</code>: Enumerates different types of operations that can be performed on a Digital Twin state. The possible operations are:<ul><li><code>OPERATION_UPDATE</code>: Represents an update operation on a resource.</li><li><code>OPERATION_UPDATE_VALUE</code>: Represents an update operation specifically on the value of a resource.</li><li><code>OPERATION_ADD</code>: Represents an addition operation of a new resource.</li><li><code>OPERATION_REMOVE</code>: Represents a removal operation of an existing resource.</li></ul></li><li><code>ResourceType</code>: Enumerates different types of resources within a Digital Twin. The possible resource types are:<ul><li><code>PROPERTY</code>: Represents a property of the Digital Twin.</li><li><code>PROPERTY_VALUE</code>: Represents the value of a property within the Digital Twin.</li><li><code>EVENT</code>: Represents an event associated with the Digital Twin.</li><li><code>ACTION</code>: Represents an action that can be performed on the Digital Twin.</li><li><code>RELATIONSHIP</code>: Represents a relationship between different components of the Digital Twin.</li><li><code>RELATIONSHIP_INSTANCE</code>: Represents an instance of a relationship.</li></ul></li></ul><p><strong>Fields:</strong></p><ul><li><code>operation</code>: Indicates the type of operation performed on the Digital Twin state (e.g., update, add, remove).</li><li><code>resourceType</code>: Represents the type of resource affected by the change (e.g., property, event, relationship).</li><li><code>resource</code>: The specific resource that has undergone the change, represented by an instance of the <code>DigitalTwinStateResource</code> class.</li></ul><p>Available type of <code>DigitalTwinStateResource</code> are:</p><ul><li><code>DigitalTwinStateProperty&lt;T></code>: This class define a generic property associated to the Digital Twin State. Each property is associated to a Key and a Value. Furthermore, it can also be associated to a type to identify its nature and data structure. By default, it is associated to the type of the Class (e.g., java.lang.String) but it can be directly changed by the developer to associate it to a specific ontology or data type.</li><li><code>DigitalTwinStateEvent</code>: This class define a generic event associated to the Digital Twin State. Events enable a mechanism for asynchronous messages to be sent by the digital twin (e.g., an overheating) . They are different from Properties that can change values according to the type of Digital Twin and may be associated also to telemetry patterns. Each event is associated to a Key and a Type used to identify its nature and data structure. By default, it is associated to the type of the Class (e.g., java.lang.String) but it can be directly changed by the developer to associate it to a specific ontology or data type.</li><li><code>DigitalTwinStateAction</code>: This class define a generic action associated to the Digital Twin State. Each action is by a key, an action type and a content type used to identify the expected input required by the action. The type of the can be directly changed by the developer to associate it to a specific ontology or data type.</li><li><code>DigitalTwinStateRelationship&lt;T></code>: Structures and describes a Relationship in the Digital Twins&rsquo;s State. This is just the description of the relationships while the effective values/instances are described through the other class DigitalTwinStateRelationshipInstance</li><li><code>DigitalTwinStateRelationshipInstance&lt;T></code>: Structures and describes a Relationship Instance in the Digital Twins&rsquo;s State. This is effective description of a relationship while its generic declaration is described through the class DigitalTwinStateRelationship.</li></ul><p>When there is a change in the DT State it is possibile to cast the received resource variation to the correct one. For example in the following code we detect and manage the variation on a Property Value:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=c1>// Get information from the state change  
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>DigitalTwinStateChange</span><span class=o>.</span><span class=na>Operation</span> <span class=n>operation</span> <span class=o>=</span> <span class=n>stateChange</span><span class=o>.</span><span class=na>getOperation</span><span class=o>();</span>  
+</span></span><span class=line><span class=cl><span class=n>DigitalTwinStateChange</span><span class=o>.</span><span class=na>ResourceType</span> <span class=n>resourceType</span> <span class=o>=</span> <span class=n>stateChange</span><span class=o>.</span><span class=na>getResourceType</span><span class=o>();</span>  
+</span></span><span class=line><span class=cl><span class=n>DigitalTwinStateResource</span> <span class=n>resource</span> <span class=o>=</span> <span class=n>stateChange</span><span class=o>.</span><span class=na>getResource</span><span class=o>();</span>  
+</span></span><span class=line><span class=cl>  
+</span></span><span class=line><span class=cl><span class=c1>// Search for property value variation  
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=k>if</span><span class=o>(</span><span class=n>resourceType</span><span class=o>.</span><span class=na>equals</span><span class=o>(</span><span class=n>DigitalTwinStateChange</span><span class=o>.</span><span class=na>ResourceType</span><span class=o>.</span><span class=na>PROPERTY_VALUE</span><span class=o>)</span> <span class=o>&amp;&amp;</span> <span class=n>operation</span><span class=o>.</span><span class=na>equals</span><span class=o>(</span><span class=n>DigitalTwinStateChange</span><span class=o>.</span><span class=na>Operation</span><span class=o>.</span><span class=na>OPERATION_UPDATE</span><span class=o>)</span> <span class=o>&amp;&amp;</span> <span class=n>resource</span> <span class=k>instanceof</span> <span class=n>DigitalTwinStateProperty</span><span class=o>){</span>  
+</span></span><span class=line><span class=cl>  
+</span></span><span class=line><span class=cl>    <span class=n>DigitalTwinStateProperty</span><span class=o>&lt;?&gt;</span> <span class=n>digitalTwinStateProperty</span> <span class=o>=</span> <span class=o>(</span><span class=n>DigitalTwinStateProperty</span><span class=o>&lt;?&gt;)</span> <span class=n>resource</span><span class=o>;</span>  
+</span></span><span class=line><span class=cl>  
+</span></span><span class=line><span class=cl>    <span class=k>if</span><span class=o>(</span><span class=n>getConfiguration</span><span class=o>().</span><span class=na>getPropertyUpdateTopics</span><span class=o>().</span><span class=na>containsKey</span><span class=o>(</span><span class=n>digitalTwinStateProperty</span><span class=o>.</span><span class=na>getKey</span><span class=o>())){</span>  
+</span></span><span class=line><span class=cl>        <span class=c1>//Handle property value variation
+</span></span></span><span class=line><span class=cl><span class=c1></span>    <span class=o>}</span>  
+</span></span><span class=line><span class=cl><span class=o>}</span>
+</span></span></code></pre></div><p><strong>Constructors:</strong></p><ul><li><code>DigitalTwinStateChange()</code>: An empty constructor that allows creating an instance of the class.</li><li><code>DigitalTwinStateChange(Operation operation, ResourceType resourceType, DigitalTwinStateResource resource)</code>: Constructs a <code>DigitalTwinStateChange</code> object with specified operation, resource type, and resource. Throws a <code>WldtDigitalTwinStateException</code> if any of the parameters is missing or null.</li></ul><p><strong>Methods:</strong></p><ul><li>Accessor methods (<code>getOperation()</code>, <code>getResourceType()</code>, <code>getResource()</code>) to retrieve the values of the fields.</li><li>Mutator methods (<code>setOperation()</code>, <code>setResourceType()</code>, <code>setResource()</code>) to update the values of the fields.</li></ul><h4 id=usage-examples>Usage Examples<a href=#usage-examples class=anchor aria-hidden=true>#</a></h4><p>Developers extending the <code>DigitalAdapter</code> class should implement the <code>onStateUpdate</code> method to define custom logic that needs to be executed whenever the state of the Digital Twin is updated. This could include tasks such as processing state changes, updating internal variables, triggering specific actions, or notifying other components about the state update.</p><p>Here&rsquo;s an example of how the method might be implemented in a concrete subclass of <code>DigitalAdapter</code>:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=nd>@Override</span>
+</span></span><span class=line><span class=cl><span class=kd>protected</span> <span class=kt>void</span> <span class=nf>onStateUpdate</span><span class=o>(</span><span class=n>DigitalTwinState</span> <span class=n>newDigitalTwinState</span><span class=o>,</span>
+</span></span><span class=line><span class=cl>                              <span class=n>DigitalTwinState</span> <span class=n>previousDigitalTwinState</span><span class=o>,</span>
+</span></span><span class=line><span class=cl>                              <span class=n>ArrayList</span><span class=o>&lt;</span><span class=n>DigitalTwinStateChange</span><span class=o>&gt;</span> <span class=n>digitalTwinStateChangeList</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>	<span class=c1>// In newDigitalTwinState we have the new DT State
+</span></span></span><span class=line><span class=cl><span class=c1></span>	<span class=n>System</span><span class=o>.</span><span class=na>out</span><span class=o>.</span><span class=na>println</span><span class=o>(</span><span class=s>&#34;New DT State is: &#34;</span> <span class=o>+</span> <span class=n>newDigitalTwinState</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>	<span class=c1>// The previous DT State is available through the variable previousDigitalTwinState
+</span></span></span><span class=line><span class=cl><span class=c1></span>	<span class=n>System</span><span class=o>.</span><span class=na>out</span><span class=o>.</span><span class=na>println</span><span class=o>(</span><span class=s>&#34;Previous DT State is: &#34;</span> <span class=o>+</span> <span class=n>previousDigitalTwinState</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=c1>// We can also check each DT&#39;s state change potentially differentiating the behaviour for each change
+</span></span></span><span class=line><span class=cl><span class=c1></span>    <span class=k>if</span> <span class=o>(</span><span class=n>digitalTwinStateChangeList</span> <span class=o>!=</span> <span class=kc>null</span> <span class=o>&amp;&amp;</span> <span class=o>!</span><span class=n>digitalTwinStateChangeList</span><span class=o>.</span><span class=na>isEmpty</span><span class=o>())</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        
+</span></span><span class=line><span class=cl>        <span class=c1>// Iterate through each state change in the list
+</span></span></span><span class=line><span class=cl><span class=c1></span>        <span class=k>for</span> <span class=o>(</span><span class=n>DigitalTwinStateChange</span> <span class=n>stateChange</span> <span class=o>:</span> <span class=n>digitalTwinStateChangeList</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>            
+</span></span><span class=line><span class=cl>            <span class=c1>// Get information from the state change
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=n>DigitalTwinStateChange</span><span class=o>.</span><span class=na>Operation</span> <span class=n>operation</span> <span class=o>=</span> <span class=n>stateChange</span><span class=o>.</span><span class=na>getOperation</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>            <span class=n>DigitalTwinStateChange</span><span class=o>.</span><span class=na>ResourceType</span> <span class=n>resourceType</span> <span class=o>=</span> <span class=n>stateChange</span><span class=o>.</span><span class=na>getResourceType</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>            <span class=n>DigitalTwinStateResource</span> <span class=n>resource</span> <span class=o>=</span> <span class=n>stateChange</span><span class=o>.</span><span class=na>getResource</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>            
+</span></span><span class=line><span class=cl>            <span class=c1>// Perform different actions based on the type of operation
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=k>switch</span> <span class=o>(</span><span class=n>operation</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>                <span class=k>case</span> <span class=n>OPERATION_UPDATE</span><span class=o>:</span>
+</span></span><span class=line><span class=cl>                    <span class=c1>// Handle an update operation
+</span></span></span><span class=line><span class=cl><span class=c1></span>                    <span class=n>System</span><span class=o>.</span><span class=na>out</span><span class=o>.</span><span class=na>println</span><span class=o>(</span><span class=s>&#34;Update operation on &#34;</span> <span class=o>+</span> <span class=n>resourceType</span> <span class=o>+</span> <span class=s>&#34;: &#34;</span> <span class=o>+</span> <span class=n>resource</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>                    <span class=k>break</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>                <span class=k>case</span> <span class=n>OPERATION_UPDATE_VALUE</span><span class=o>:</span>
+</span></span><span class=line><span class=cl>                    <span class=c1>// Handle an update value operation
+</span></span></span><span class=line><span class=cl><span class=c1></span>                    <span class=n>System</span><span class=o>.</span><span class=na>out</span><span class=o>.</span><span class=na>println</span><span class=o>(</span><span class=s>&#34;Update value operation on &#34;</span> <span class=o>+</span> <span class=n>resourceType</span> <span class=o>+</span> <span class=s>&#34;: &#34;</span> <span class=o>+</span> <span class=n>resource</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>                    <span class=k>break</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>                <span class=k>case</span> <span class=n>OPERATION_ADD</span><span class=o>:</span>
+</span></span><span class=line><span class=cl>                    <span class=c1>// Handle an add operation
+</span></span></span><span class=line><span class=cl><span class=c1></span>                    <span class=n>System</span><span class=o>.</span><span class=na>out</span><span class=o>.</span><span class=na>println</span><span class=o>(</span><span class=s>&#34;Add operation on &#34;</span> <span class=o>+</span> <span class=n>resourceType</span> <span class=o>+</span> <span class=s>&#34;: &#34;</span> <span class=o>+</span> <span class=n>resource</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>                    <span class=k>break</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>                <span class=k>case</span> <span class=n>OPERATION_REMOVE</span><span class=o>:</span>
+</span></span><span class=line><span class=cl>                    <span class=c1>// Handle a remove operation
+</span></span></span><span class=line><span class=cl><span class=c1></span>                    <span class=n>System</span><span class=o>.</span><span class=na>out</span><span class=o>.</span><span class=na>println</span><span class=o>(</span><span class=s>&#34;Remove operation on &#34;</span> <span class=o>+</span> <span class=n>resourceType</span> <span class=o>+</span> <span class=s>&#34;: &#34;</span> <span class=o>+</span> <span class=n>resource</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>                    <span class=k>break</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>                <span class=k>default</span><span class=o>:</span>
+</span></span><span class=line><span class=cl>                    <span class=c1>// Handle unknown operation (optional)
+</span></span></span><span class=line><span class=cl><span class=c1></span>                    <span class=n>System</span><span class=o>.</span><span class=na>out</span><span class=o>.</span><span class=na>println</span><span class=o>(</span><span class=s>&#34;Unknown operation on &#34;</span> <span class=o>+</span> <span class=n>resourceType</span> <span class=o>+</span> <span class=s>&#34;: &#34;</span> <span class=o>+</span> <span class=n>resource</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>                    <span class=k>break</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>            <span class=o>}</span>
+</span></span><span class=line><span class=cl>        <span class=o>}</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span> <span class=k>else</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        <span class=c1>// No state changes
+</span></span></span><span class=line><span class=cl><span class=c1></span>        <span class=n>System</span><span class=o>.</span><span class=na>out</span><span class=o>.</span><span class=na>println</span><span class=o>(</span><span class=s>&#34;No state changes detected.&#34;</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl><span class=o>}</span>
+</span></span></code></pre></div><p>In this example, the method iterates over the list of state changes, extracts information about each change, and performs custom actions based on the changes. Developers can adapt this method to suit the specific requirements of their Digital Twin application.</p><div class="page-footer-meta d-flex flex-column flex-md-row justify-content-between"><div class=last-modified><a href=https://github.com/wldt/wldt.github.io/commit/ab5a164de259055162e9420d8cb56c2b1562dee9><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-calendar"><rect x="3" y="4" width="18" height="18" rx="2" ry="2"/><line x1="16" y1="2" x2="16" y2="6"/><line x1="8" y1="2" x2="8" y2="6"/><line x1="3" y1="10" x2="21" y2="10"/></svg>Last updated on February 9, 2024</a></div><div class=edit-page><a href=https://github.com/wldt/wldt.github.io/blob/main/content//docs/change-logs/change-log-0.3.0.md><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-edit-2"><path d="M17 3a2.828 2.828.0 114 4L7.5 20.5 2 22l1.5-5.5L17 3z"/></svg>Edit this page on GitHub</a></div></div><div class="page-nav d-flex flex-column flex-sm-row"><div class="card w-100"><div class="card-body d-flex"><div class="d-flex flex-column justify-content-center"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-arrow-left" width="20" height="20" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 12h14"/><path d="M5 12l6 6"/><path d="M5 12l6-6"/></svg></div><div class="d-flex flex-column"><div class=text-body-secondary>Prev</div><a href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/ class="stretched-link text-reset text-decoration-none">MQTT Digital Adapter</a></div></div></div><div class=m-2></div><div class="card text-end w-100"><div class="card-body d-flex justify-content-end"><div class="d-flex flex-column"><div class=text-body-secondary>Next</div><a href=https://wldt.github.io/docs/adapters/http-digital-adapter/ class="stretched-link text-reset text-decoration-none">HTTP Digital Adapter</a></div><div class="d-flex flex-column justify-content-center"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-arrow-right" width="20" height="20" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 12h14"/><path d="M13 18l6-6"/><path d="M13 6l6 6"/></svg></div></div></div></div></main></div></div></div><footer class="footer text-muted"><div class=container-lg><div class=row><div class="col-lg-8 text-center text-lg-start"><ul class=list-inline><li class=list-inline-item><a class=text-muted href=https://wldt.github.io/privacy/>Privacy Policy</a></li></ul></div><div class="col-lg-8 text-center text-lg-end"><ul class=list-inline><li class=list-inline-item>Brought to you by <a class=text-muted href=https://gethyas.com/>Hyas</a></li></ul></div></div></div></footer><script async src=https://wldt.github.io/js/app.1e84dcdaa5ccef6fe83f6d88ac1e444a1f237111cfa2a7a97427f758e9c27ef4.js integrity="sha256-HoTc2qXM72/oP22IrB5ESh8jcRHPoqepdCf3WOnCfvQ="></script>
+<script async src=https://wldt.github.io/js/flexsearch.dc00caef2c3490dbab3c345ed0d4133b0aafb803efeb21c3df80776d6d3ea821.js integrity="sha256-3ADK7yw0kNurPDRe0NQTOwqvuAPv6yHD34B3bW0+qCE="></script><script async src=https://wldt.github.io/js/search-modal.c4c023efcdee308e4b5f1110afe1db6b1656f217e67aa7efe54e2f4bf2feccf8.js integrity="sha256-xMAj783uMI5LXxEQr+HbaxZW8hfmeqfv5U4vS/L+zPg="></script><div class="d-inline-flex fixed-bottom-right pb-4 pe-4"><button id=toTop type=button class="btn btn-primary rounded-circle ms-auto p-2"><span class=visually-hidden>Top</span><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-chevron-up" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M6 15l6-6 6 6"/></svg></button></div></body></html>
\ No newline at end of file
diff --git a/docs/reference/index.html b/docs/change-logs/index.html
similarity index 51%
rename from docs/reference/index.html
rename to docs/change-logs/index.html
index ba1332d..cea62ec 100644
--- a/docs/reference/index.html
+++ b/docs/change-logs/index.html
@@ -1,9 +1,11 @@
 <!doctype html><html lang=en data-bs-theme=auto><head><meta charset=utf-8><meta http-equiv=x-ua-compatible content="ie=edge"><meta name=viewport content="width=device-width,initial-scale=1"><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-regular.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-500.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-700.woff2 type=font/woff2 crossorigin><script src=https://wldt.github.io/js/color-mode.86a91f050a481d0a3f0c72ac26543cb6228c770875981c58dcbc008fd3f875c8.js integrity="sha256-hqkfBQpIHQo/DHKsJlQ8tiKMdwh1mBxY3LwAj9P4dcg="></script>
-<link rel=stylesheet href=https://wldt.github.io/main.5d6e5440c13f1c45183e82bbb906165564d1edfd71498c4a2c38775086796022bfab9cfb137199a537d8e42c2fb6ce2ab74b69461aed15b7389bd0e12ec63b19.css integrity="sha512-XW5UQME/HEUYPoK7uQYWVWTR7f1xSYxKLDh3UIZ5YCK/q5z7E3GZpTfY5Cwvts4qt0tpRhrtFbc4m9DhLsY7GQ==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>Reference | WLDT</title><meta property="canonical" content="https://wldt.github.io/docs/reference/"><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/docs/reference/"><meta property="og:title" content="Reference"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:section" content="docs"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/example-guide/"><meta property="og:see_also" content="https://wldt.github.io/docs/reference/example-reference/"><meta name=twitter:card content="summary"><meta name=twitter:title content="Reference"><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","item":"https://wldt.github.io/docs/","name":"Docs","position":2},{"@type":"ListItem","name":"Reference","position":3}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="list section docs" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
+<link rel=stylesheet href=https://wldt.github.io/main.5fb433a44687c98f7ae7b3d0137c762777049ba27235e1f08c279c03c8533a7a9a1e3b0ef5b125a31b6bb63a362cdcbc39c3706ed41ad7f1a620b9281013866c.css integrity="sha512-X7QzpEaHyY9657PQE3x2J3cEm6JyNeHwjCecA8hTOnqaHjsO9bEloxtrtjo2LNy8OcNwbtQa1/GmILkoEBOGbA==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>Change Logs | WLDT</title><meta property="canonical" content="https://wldt.github.io/docs/change-logs/"><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/docs/change-logs/"><meta property="og:title" content="Change Logs"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:section" content="docs"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-model/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-life-cycle/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/library-structure-basic-concepts/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/physical-adapter/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/shadowing-function/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/digital-adapter/"><meta name=twitter:card content="summary"><meta name=twitter:title content="Change Logs"><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","item":"https://wldt.github.io/docs/","name":"Docs","position":2},{"@type":"ListItem","name":"Change Logs","position":3}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="list section docs" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
 <button type=button id=searchToggleMobile class="btn btn-link nav-link mx-2 d-lg-none" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
-<button class="btn btn-link d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavSection aria-controls=offcanvasNavSection aria-label="Open section navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-dots-vertical" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 19m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 5m-1 0a1 1 0 102 0 1 1 0 10-2 0"/></svg></button><div class="offcanvas offcanvas-start d-lg-none" tabindex=-1 id=offcanvasNavSection aria-labelledby=offcanvasNavSectionLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavSectionLabel>Docs</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class=offcanvas-body><aside class="doks-sidebar mt-n3"><nav id=doks-docs-nav aria-label="Tertiary navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-45389ee90014e0938cb09409b9a8794d aria-expanded=false>
-Guides</button><div class=collapse id=section-45389ee90014e0938cb09409b9a8794d><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/example-guide/>Example Guide</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-63d5049791d9d79d86e9a108b0a999ca aria-expanded=true>
-Reference</button><div class="collapse show" id=section-63d5049791d9d79d86e9a108b0a999ca><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/reference/example-reference/>Example Reference</a></li></ul></div></li></ul></nav></aside></div></div><button class="btn btn-link nav-link mx-2 order-3 d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavMain aria-controls=offcanvasNavMain aria-label="Open main navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-menu" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><line x1="4" y1="8" x2="20" y2="8"/><line x1="4" y1="16" x2="20" y2="16"/></svg></button><div class="offcanvas offcanvas-end h-auto" tabindex=-1 id=offcanvasNavMain aria-labelledby=offcanvasNavMainLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavMainLabel>WLDT</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class="offcanvas-body d-flex flex-column flex-lg-row justify-content-between"><ul class="navbar-nav flex-grow-1"><li class=nav-item><a class=nav-link href=https://wldt.github.io/docs/guides/example-guide/>Documentation</a></li><li class=nav-item><a class=nav-link href=https://wldt.github.io/blog/>Blog</a></li></ul><button type=button id=searchToggleDesktop class="btn btn-link nav-link p-2 d-none d-lg-block" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button class="btn btn-link d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavSection aria-controls=offcanvasNavSection aria-label="Open section navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-dots-vertical" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 19m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 5m-1 0a1 1 0 102 0 1 1 0 10-2 0"/></svg></button><div class="offcanvas offcanvas-start d-lg-none" tabindex=-1 id=offcanvasNavSection aria-labelledby=offcanvasNavSectionLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavSectionLabel>Docs</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class=offcanvas-body><aside class="doks-sidebar mt-n3"><nav id=doks-docs-nav aria-label="Tertiary navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-0b79795d3efc95b9976c7c5b933afce2 aria-expanded=false>
+Introduction</button><div class=collapse id=section-0b79795d3efc95b9976c7c5b933afce2><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-model/>DT Model</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-life-cycle/>DT Life Cycle</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/>Library Structure & Basic Concepts</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-3978929206deee2c125a1d732aae5545 aria-expanded=true>
+Change Logs</button><div class="collapse show" id=section-3978929206deee2c125a1d732aae5545><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/>Change Log 0.3.0</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-89413bd312d0909efb85e6693f36cb89 aria-expanded=false>
+Adapters</button><div class=collapse id=section-89413bd312d0909efb85e6693f36cb89><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/>MQTT Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/>MQTT Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/http-digital-adapter/>HTTP Digital Adapter</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-bf647454e36069fd16f1a7a35cf6a865 aria-expanded=false>
+Getting Started</button><div class=collapse id=section-bf647454e36069fd16f1a7a35cf6a865><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/physical-adapter/>Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/shadowing-function/>Shadowing Function</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-adapter/>Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/>DT Engine & DT Instance</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-actions/>Digital Actions</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/configurable-adapters/>Configurable Adapters</a></li></ul></div></li></ul></nav></aside></div></div><button class="btn btn-link nav-link mx-2 order-3 d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavMain aria-controls=offcanvasNavMain aria-label="Open main navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-menu" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><line x1="4" y1="8" x2="20" y2="8"/><line x1="4" y1="16" x2="20" y2="16"/></svg></button><div class="offcanvas offcanvas-end h-auto" tabindex=-1 id=offcanvasNavMain aria-labelledby=offcanvasNavMainLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavMainLabel>WLDT</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class="offcanvas-body d-flex flex-column flex-lg-row justify-content-between"><ul class="navbar-nav flex-grow-1"><li class=nav-item><a class=nav-link href=https://wldt.github.io/docs/guides/example-guide/>Documentation</a></li><li class=nav-item><a class=nav-link href=https://wldt.github.io/blog/>Blog</a></li></ul><button type=button id=searchToggleDesktop class="btn btn-link nav-link p-2 d-none d-lg-block" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
 <button id=buttonColorMode class="btn btn-link mx-auto nav-link p-0 ms-lg-2 me-lg-1" type=button aria-label="Toggle theme"><svg data-bs-theme-value="dark" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-moon" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 3c.132.0.263.0.393.0a7.5 7.5.0 007.92 12.446A9 9 0 1112 2.992z"/></svg><svg data-bs-theme-value="light" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-sun" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-4 0a4 4 0 108 0 4 4 0 10-8 0m-5 0h1m8-9v1m8 8h1m-9 8v1M5.6 5.6l.7.7m12.1-.7-.7.7m0 11.4.7.7m-12.1-.7-.7.7"/></svg></button><ul id=socialMenu class="nav mx-auto flex-row order-lg-4"><li class=nav-item><a class="nav-link social-link" href=https://github.com/wldt><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-brand-github" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 19c-4.3 1.4-4.3-2.5-6-3m12 5v-3.5c0-1 .1-1.4-.5-2 2.8-.3 5.5-1.4 5.5-6a4.6 4.6.0 00-1.3-3.2 4.2 4.2.0 00-.1-3.2s-1.1-.3-3.5 1.3a12.3 12.3.0 00-6.2.0C6.5 2.8 5.4 3.1 5.4 3.1a4.2 4.2.0 00-.1 3.2A4.6 4.6.0 004 9.5c0 4.6 2.7 5.7 5.5 6-.6.6-.6 1.2-.5 2V21"/></svg><small class="ms-2 visually-hidden">GitHub</small></a></li></ul></div></div></div></header></div><div class=modal id=searchModal tabindex=-1 aria-labelledby=searchModalLabel aria-hidden=true><div class="modal-dialog modal-dialog-scrollable modal-fullscreen-md-down"><div class=modal-content><div class=modal-header><h1 class="modal-title fs-5 visually-hidden" id=searchModalLabel>Search</h1><button type=button class="btn-close visually-hidden" data-bs-dismiss=modal aria-label=Close></button><div class="search-input flex-grow-1 d-none"><form id=search-form class=search-form action=# method=post accept-charset=utf-8 role=search><label for=query class=visually-hidden>Search</label><div class=d-flex><input type=search id=query name=query class="search-text form-control form-control-lg" placeholder=Search aria-label=Search maxlength=128 autocomplete=off>
-<button type=button class="btn btn-link text-decoration-none px-0 ms-3 d-md-none" data-bs-dismiss=modal aria-label=Close>Cancel</button></div></form></div></div><div class=modal-body><p class="search-loading status message d-none mt-3 text-center">Loading search index…</p><p class="search-no-recent message d-none mt-3 text-center">No recent searches</p><p class="search-no-results message d-none mt-3 text-center">No results for "<strong><span class=query-no-results>Query here</span></strong>"</p><div id=searchResults class=search-results></div><template><article class="search-result list-view"><div class="card my-3"><div class=card-body><header><h2 class="h5 title title-submitted mb-0"><a class="stretched-link text-decoration-none text-reset" href=#>Title here</a></h2><div class="submitted d-none"><time class=created-date>Date here</time></div></header><div class=content>Summary here</div></div></div></article></template></div><div class=modal-footer><ul class="list-inline me-auto d-none d-md-block"><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Enter key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M12 3.53088v3c0 1-1 2-2 2H4m3 3-3-3 3-3"/></g></svg></kbd><span class=DocSearch-Label>to select</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Arrow down" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 3.5v8m3-3-3 3-3-3"/></g></svg></kbd><kbd class=me-2><svg width="15" height="15" aria-label="Arrow up" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 11.5v-8m3 3-3-3-3 3"/></g></svg></kbd><span class=DocSearch-Label>to navigate</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Escape key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M13.6167 8.936c-.1065.3583-.6883.962-1.4875.962-.7993.0-1.653-.9165-1.653-2.1258v-.5678c0-1.2548.7896-2.1016 1.653-2.1016s1.3601.4778 1.4875 1.0724M9 6c-.1352-.4735-.7506-.9219-1.46-.8972-.7092.0246-1.344.57-1.344 1.2166s.4198.8812 1.3445.9805C8.465 7.3992 8.968 7.9337 9 8.5s-.454 1.398-1.4595 1.398C6.6593 9.898 6 9 5.963 8.4851m-1.4748.5368c-.2635.5941-.8099.876-1.5443.876s-1.7073-.6248-1.7073-2.204v-.4603c0-1.0416.721-2.131 1.7073-2.131.9864.0 1.6425 1.031 1.5443 2.2492h-2.956"/></g></svg></kbd><span class=DocSearch-Label>to close</span></li></ul><p class=d-md-none>Search by <a class=text-decoration-none href=https://github.com/nextapps-de/flexsearch>FlexSearch</a></p></div></div></div></div><div class="wrap container-lg" role=document><div class=content><div class="row justify-content-center"><div class="col-md-12 col-lg-10 col-xl-8"><article><h1 class=text-center>Reference</h1><div class=card-list><div class="card my-3"><div class=card-body><a class=stretched-link href=https://wldt.github.io/docs/reference/example-reference/>Example Reference &rarr;</a></div></div></div></article></div></div></div></div><footer class="footer text-muted"><div class=container-lg><div class=row><div class="col-lg-8 text-center text-lg-start"><ul class=list-inline><li class=list-inline-item><a class=text-muted href=https://wldt.github.io/privacy/>Privacy Policy</a></li></ul></div><div class="col-lg-8 text-center text-lg-end"><ul class=list-inline><li class=list-inline-item>Brought to you by <a class=text-muted href=https://gethyas.com/>Hyas</a></li></ul></div></div></div></footer><script async src=https://wldt.github.io/js/app.1e84dcdaa5ccef6fe83f6d88ac1e444a1f237111cfa2a7a97427f758e9c27ef4.js integrity="sha256-HoTc2qXM72/oP22IrB5ESh8jcRHPoqepdCf3WOnCfvQ="></script>
+<button type=button class="btn btn-link text-decoration-none px-0 ms-3 d-md-none" data-bs-dismiss=modal aria-label=Close>Cancel</button></div></form></div></div><div class=modal-body><p class="search-loading status message d-none mt-3 text-center">Loading search index…</p><p class="search-no-recent message d-none mt-3 text-center">No recent searches</p><p class="search-no-results message d-none mt-3 text-center">No results for "<strong><span class=query-no-results>Query here</span></strong>"</p><div id=searchResults class=search-results></div><template><article class="search-result list-view"><div class="card my-3"><div class=card-body><header><h2 class="h5 title title-submitted mb-0"><a class="stretched-link text-decoration-none text-reset" href=#>Title here</a></h2><div class="submitted d-none"><time class=created-date>Date here</time></div></header><div class=content>Summary here</div></div></div></article></template></div><div class=modal-footer><ul class="list-inline me-auto d-none d-md-block"><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Enter key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M12 3.53088v3c0 1-1 2-2 2H4m3 3-3-3 3-3"/></g></svg></kbd><span class=DocSearch-Label>to select</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Arrow down" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 3.5v8m3-3-3 3-3-3"/></g></svg></kbd><kbd class=me-2><svg width="15" height="15" aria-label="Arrow up" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 11.5v-8m3 3-3-3-3 3"/></g></svg></kbd><span class=DocSearch-Label>to navigate</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Escape key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M13.6167 8.936c-.1065.3583-.6883.962-1.4875.962-.7993.0-1.653-.9165-1.653-2.1258v-.5678c0-1.2548.7896-2.1016 1.653-2.1016s1.3601.4778 1.4875 1.0724M9 6c-.1352-.4735-.7506-.9219-1.46-.8972-.7092.0246-1.344.57-1.344 1.2166s.4198.8812 1.3445.9805C8.465 7.3992 8.968 7.9337 9 8.5s-.454 1.398-1.4595 1.398C6.6593 9.898 6 9 5.963 8.4851m-1.4748.5368c-.2635.5941-.8099.876-1.5443.876s-1.7073-.6248-1.7073-2.204v-.4603c0-1.0416.721-2.131 1.7073-2.131.9864.0 1.6425 1.031 1.5443 2.2492h-2.956"/></g></svg></kbd><span class=DocSearch-Label>to close</span></li></ul><p class=d-md-none>Search by <a class=text-decoration-none href=https://github.com/nextapps-de/flexsearch>FlexSearch</a></p></div></div></div></div><div class="wrap container-lg" role=document><div class=content><div class="row justify-content-center"><div class="col-md-12 col-lg-10 col-xl-8"><article><h1 class=text-center>Change Logs</h1><div class=card-list><div class="card my-3"><div class=card-body><a class=stretched-link href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/>Change Log 0.3.0 &rarr;</a></div></div></div></article></div></div></div></div><footer class="footer text-muted"><div class=container-lg><div class=row><div class="col-lg-8 text-center text-lg-start"><ul class=list-inline><li class=list-inline-item><a class=text-muted href=https://wldt.github.io/privacy/>Privacy Policy</a></li></ul></div><div class="col-lg-8 text-center text-lg-end"><ul class=list-inline><li class=list-inline-item>Brought to you by <a class=text-muted href=https://gethyas.com/>Hyas</a></li></ul></div></div></div></footer><script async src=https://wldt.github.io/js/app.1e84dcdaa5ccef6fe83f6d88ac1e444a1f237111cfa2a7a97427f758e9c27ef4.js integrity="sha256-HoTc2qXM72/oP22IrB5ESh8jcRHPoqepdCf3WOnCfvQ="></script>
 <script async src=https://wldt.github.io/js/flexsearch.dc00caef2c3490dbab3c345ed0d4133b0aafb803efeb21c3df80776d6d3ea821.js integrity="sha256-3ADK7yw0kNurPDRe0NQTOwqvuAPv6yHD34B3bW0+qCE="></script><script async src=https://wldt.github.io/js/search-modal.c4c023efcdee308e4b5f1110afe1db6b1656f217e67aa7efe54e2f4bf2feccf8.js integrity="sha256-xMAj783uMI5LXxEQr+HbaxZW8hfmeqfv5U4vS/L+zPg="></script><div class="d-inline-flex fixed-bottom-right pb-4 pe-4"><button id=toTop type=button class="btn btn-primary rounded-circle ms-auto p-2"><span class=visually-hidden>Top</span><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-chevron-up" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M6 15l6-6 6 6"/></svg></button></div></body></html>
\ No newline at end of file
diff --git a/docs/change-logs/index.xml b/docs/change-logs/index.xml
new file mode 100644
index 0000000..890d00b
--- /dev/null
+++ b/docs/change-logs/index.xml
@@ -0,0 +1 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Change Logs on WLDT</title><link>https://wldt.github.io/docs/change-logs/</link><description>Recent content in Change Logs on WLDT</description><generator>Hugo -- gohugo.io</generator><language>en</language><copyright>Copyright (c) 2023 Hyas</copyright><lastBuildDate>Fri, 09 Feb 2024 12:24:39 +0100</lastBuildDate><atom:link href="https://wldt.github.io/docs/change-logs/index.xml" rel="self" type="application/rss+xml"/><item><title>Change Log 0.3.0</title><link>https://wldt.github.io/docs/change-logs/change-log-0.3.0/</link><pubDate>Fri, 09 Feb 2024 12:23:33 +0100</pubDate><guid>https://wldt.github.io/docs/change-logs/change-log-0.3.0/</guid><description>Digital Adapters The following methods have been discontinued and removed from the DigitalAdapter class: onStateChangePropertyCreated onStateChangePropertyUpdated onStateChangePropertyDeleted onStatePropertyUpdated onStatePropertyDeleted onStateChangeActionEnabled onStateChangeActionUpdated onStateChangeActionDisabled onStateChangeEventRegistered onStateChangeEventRegistrationUpdated onStateChangeEventUnregistered onStateChangeRelationshipInstanceDeleted onStateChangeRelationshipDeleted onStateChangeRelationshipInstanceCreated onStateChangeRelationshipCreated onDigitalTwinStateEventNotificationReceived The Signature of the following methods have been changed: onDigitalTwinSync(IDigitalTwinState currentDigitalTwinState) -&amp;gt; onDigitalTwinSync(DigitalTwinState currentDigitalTwinState) onDigitalTwinUnSync(IDigitalTwinState currentDigitalTwinState) -&amp;gt; onDigitalTwinUnSync(DigitalTwinState currentDigitalTwinState) New methods that have been added are: onStateUpdate(DigitalTwinState newDigitalTwinState, DigitalTwinState previousDigitalTwinState, ArrayList&amp;lt;DigitalTwinStateChange&amp;gt; digitalTwinStateChangeList) onEventNotificationReceived(DigitalTwinStateEventNotification&amp;lt;?</description></item></channel></rss>
\ No newline at end of file
diff --git a/docs/change-logs/page/1/index.html b/docs/change-logs/page/1/index.html
new file mode 100644
index 0000000..1373cfe
--- /dev/null
+++ b/docs/change-logs/page/1/index.html
@@ -0,0 +1 @@
+<!doctype html><html lang=en><head><title>https://wldt.github.io/docs/change-logs/</title><link rel=canonical href=https://wldt.github.io/docs/change-logs/><meta name=robots content="noindex"><meta charset=utf-8><meta http-equiv=refresh content="0; url=https://wldt.github.io/docs/change-logs/"></head></html>
\ No newline at end of file
diff --git a/docs/reference/sitemap.xml b/docs/change-logs/sitemap.xml
similarity index 55%
rename from docs/reference/sitemap.xml
rename to docs/change-logs/sitemap.xml
index 2a9af5d..bac15bb 100644
--- a/docs/reference/sitemap.xml
+++ b/docs/change-logs/sitemap.xml
@@ -1 +1 @@
-<?xml version="1.0" encoding="utf-8" standalone="yes"?><urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml"><url><loc>https://wldt.github.io/docs/reference/example-reference/</loc><lastmod>2024-02-09T09:54:12+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url></urlset>
\ No newline at end of file
+<?xml version="1.0" encoding="utf-8" standalone="yes"?><urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml"><url><loc>https://wldt.github.io/docs/change-logs/change-log-0.3.0/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url></urlset>
\ No newline at end of file
diff --git a/docs/guides/configurable-adapters/index.html b/docs/guides/configurable-adapters/index.html
new file mode 100644
index 0000000..6329935
--- /dev/null
+++ b/docs/guides/configurable-adapters/index.html
@@ -0,0 +1,237 @@
+<!doctype html><html lang=en data-bs-theme=auto><head><meta charset=utf-8><meta http-equiv=x-ua-compatible content="ie=edge"><meta name=viewport content="width=device-width,initial-scale=1"><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-regular.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-500.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-700.woff2 type=font/woff2 crossorigin><script src=https://wldt.github.io/js/color-mode.86a91f050a481d0a3f0c72ac26543cb6228c770875981c58dcbc008fd3f875c8.js integrity="sha256-hqkfBQpIHQo/DHKsJlQ8tiKMdwh1mBxY3LwAj9P4dcg="></script>
+<link rel=stylesheet href=https://wldt.github.io/main.5fb433a44687c98f7ae7b3d0137c762777049ba27235e1f08c279c03c8533a7a9a1e3b0ef5b125a31b6bb63a362cdcbc39c3706ed41ad7f1a620b9281013866c.css integrity="sha512-X7QzpEaHyY9657PQE3x2J3cEm6JyNeHwjCecA8hTOnqaHjsO9bEloxtrtjo2LNy8OcNwbtQa1/GmILkoEBOGbA==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>Configurable Adapters | WLDT</title><meta property="canonical" content="https://wldt.github.io/docs/guides/configurable-adapters/"><meta name=description content="The WLDT library provides a native method to define Configurable Physical ad Digital Adapters specifying a custom configuration class passed as parameter in the constructor."><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/docs/guides/configurable-adapters/"><meta property="og:title" content="Configurable Adapters"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:section" content="docs"><meta property="og:description" content="The WLDT library provides a native method to define Configurable Physical ad Digital Adapters specifying a custom configuration class passed as parameter in the constructor."><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-model/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-life-cycle/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/library-structure-basic-concepts/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/physical-adapter/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/shadowing-function/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/digital-adapter/"><meta name=twitter:card content="summary"><meta name=twitter:title content="Configurable Adapters"><meta name=twitter:description content="The WLDT library provides a native method to define Configurable Physical ad Digital Adapters specifying a custom configuration class passed as parameter in the constructor."><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","item":"https://wldt.github.io/docs/","name":"Docs","position":2},{"@type":"ListItem","item":"https://wldt.github.io/docs/guides/","name":"Getting Started","position":3},{"@type":"ListItem","name":"Configurable Adapters","position":4}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="single section docs" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
+<button type=button id=searchToggleMobile class="btn btn-link nav-link mx-2 d-lg-none" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button class="btn btn-link d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavSection aria-controls=offcanvasNavSection aria-label="Open section navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-dots-vertical" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 19m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 5m-1 0a1 1 0 102 0 1 1 0 10-2 0"/></svg></button><div class="offcanvas offcanvas-start d-lg-none" tabindex=-1 id=offcanvasNavSection aria-labelledby=offcanvasNavSectionLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavSectionLabel>Docs</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class=offcanvas-body><aside class="doks-sidebar mt-n3"><nav id=doks-docs-nav aria-label="Tertiary navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-0b79795d3efc95b9976c7c5b933afce2 aria-expanded=false>
+Introduction</button><div class=collapse id=section-0b79795d3efc95b9976c7c5b933afce2><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-model/>DT Model</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-life-cycle/>DT Life Cycle</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/>Library Structure & Basic Concepts</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-3978929206deee2c125a1d732aae5545 aria-expanded=false>
+Change Logs</button><div class=collapse id=section-3978929206deee2c125a1d732aae5545><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/>Change Log 0.3.0</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-89413bd312d0909efb85e6693f36cb89 aria-expanded=false>
+Adapters</button><div class=collapse id=section-89413bd312d0909efb85e6693f36cb89><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/>MQTT Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/>MQTT Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/http-digital-adapter/>HTTP Digital Adapter</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-bf647454e36069fd16f1a7a35cf6a865 aria-expanded=true>
+Getting Started</button><div class="collapse show" id=section-bf647454e36069fd16f1a7a35cf6a865><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/physical-adapter/>Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/shadowing-function/>Shadowing Function</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-adapter/>Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/>DT Engine & DT Instance</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-actions/>Digital Actions</a></li><li><a class="docs-link rounded active" href=https://wldt.github.io/docs/guides/configurable-adapters/>Configurable Adapters</a></li></ul></div></li></ul></nav></aside></div></div><button class="btn btn-link nav-link mx-2 order-3 d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavMain aria-controls=offcanvasNavMain aria-label="Open main navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-menu" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><line x1="4" y1="8" x2="20" y2="8"/><line x1="4" y1="16" x2="20" y2="16"/></svg></button><div class="offcanvas offcanvas-end h-auto" tabindex=-1 id=offcanvasNavMain aria-labelledby=offcanvasNavMainLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavMainLabel>WLDT</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class="offcanvas-body d-flex flex-column flex-lg-row justify-content-between"><ul class="navbar-nav flex-grow-1"><li class=nav-item><a class=nav-link href=https://wldt.github.io/docs/guides/example-guide/>Documentation</a></li><li class=nav-item><a class=nav-link href=https://wldt.github.io/blog/>Blog</a></li></ul><button type=button id=searchToggleDesktop class="btn btn-link nav-link p-2 d-none d-lg-block" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button id=buttonColorMode class="btn btn-link mx-auto nav-link p-0 ms-lg-2 me-lg-1" type=button aria-label="Toggle theme"><svg data-bs-theme-value="dark" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-moon" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 3c.132.0.263.0.393.0a7.5 7.5.0 007.92 12.446A9 9 0 1112 2.992z"/></svg><svg data-bs-theme-value="light" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-sun" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-4 0a4 4 0 108 0 4 4 0 10-8 0m-5 0h1m8-9v1m8 8h1m-9 8v1M5.6 5.6l.7.7m12.1-.7-.7.7m0 11.4.7.7m-12.1-.7-.7.7"/></svg></button><ul id=socialMenu class="nav mx-auto flex-row order-lg-4"><li class=nav-item><a class="nav-link social-link" href=https://github.com/wldt><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-brand-github" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 19c-4.3 1.4-4.3-2.5-6-3m12 5v-3.5c0-1 .1-1.4-.5-2 2.8-.3 5.5-1.4 5.5-6a4.6 4.6.0 00-1.3-3.2 4.2 4.2.0 00-.1-3.2s-1.1-.3-3.5 1.3a12.3 12.3.0 00-6.2.0C6.5 2.8 5.4 3.1 5.4 3.1a4.2 4.2.0 00-.1 3.2A4.6 4.6.0 004 9.5c0 4.6 2.7 5.7 5.5 6-.6.6-.6 1.2-.5 2V21"/></svg><small class="ms-2 visually-hidden">GitHub</small></a></li></ul></div></div></div></header></div><div class=modal id=searchModal tabindex=-1 aria-labelledby=searchModalLabel aria-hidden=true><div class="modal-dialog modal-dialog-scrollable modal-fullscreen-md-down"><div class=modal-content><div class=modal-header><h1 class="modal-title fs-5 visually-hidden" id=searchModalLabel>Search</h1><button type=button class="btn-close visually-hidden" data-bs-dismiss=modal aria-label=Close></button><div class="search-input flex-grow-1 d-none"><form id=search-form class=search-form action=# method=post accept-charset=utf-8 role=search><label for=query class=visually-hidden>Search</label><div class=d-flex><input type=search id=query name=query class="search-text form-control form-control-lg" placeholder=Search aria-label=Search maxlength=128 autocomplete=off>
+<button type=button class="btn btn-link text-decoration-none px-0 ms-3 d-md-none" data-bs-dismiss=modal aria-label=Close>Cancel</button></div></form></div></div><div class=modal-body><p class="search-loading status message d-none mt-3 text-center">Loading search index…</p><p class="search-no-recent message d-none mt-3 text-center">No recent searches</p><p class="search-no-results message d-none mt-3 text-center">No results for "<strong><span class=query-no-results>Query here</span></strong>"</p><div id=searchResults class=search-results></div><template><article class="search-result list-view"><div class="card my-3"><div class=card-body><header><h2 class="h5 title title-submitted mb-0"><a class="stretched-link text-decoration-none text-reset" href=#>Title here</a></h2><div class="submitted d-none"><time class=created-date>Date here</time></div></header><div class=content>Summary here</div></div></div></article></template></div><div class=modal-footer><ul class="list-inline me-auto d-none d-md-block"><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Enter key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M12 3.53088v3c0 1-1 2-2 2H4m3 3-3-3 3-3"/></g></svg></kbd><span class=DocSearch-Label>to select</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Arrow down" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 3.5v8m3-3-3 3-3-3"/></g></svg></kbd><kbd class=me-2><svg width="15" height="15" aria-label="Arrow up" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 11.5v-8m3 3-3-3-3 3"/></g></svg></kbd><span class=DocSearch-Label>to navigate</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Escape key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M13.6167 8.936c-.1065.3583-.6883.962-1.4875.962-.7993.0-1.653-.9165-1.653-2.1258v-.5678c0-1.2548.7896-2.1016 1.653-2.1016s1.3601.4778 1.4875 1.0724M9 6c-.1352-.4735-.7506-.9219-1.46-.8972-.7092.0246-1.344.57-1.344 1.2166s.4198.8812 1.3445.9805C8.465 7.3992 8.968 7.9337 9 8.5s-.454 1.398-1.4595 1.398C6.6593 9.898 6 9 5.963 8.4851m-1.4748.5368c-.2635.5941-.8099.876-1.5443.876s-1.7073-.6248-1.7073-2.204v-.4603c0-1.0416.721-2.131 1.7073-2.131.9864.0 1.6425 1.031 1.5443 2.2492h-2.956"/></g></svg></kbd><span class=DocSearch-Label>to close</span></li></ul><p class=d-md-none>Search by <a class=text-decoration-none href=https://github.com/nextapps-de/flexsearch>FlexSearch</a></p></div></div></div></div><div class="wrap container-lg" role=document><div class=content><div class="row flex-xl-nowrap"><div class="col-lg-5 col-xl-4 docs-sidebar d-none d-lg-block"><nav class=docs-links aria-label="Main navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-0b79795d3efc95b9976c7c5b933afce2 aria-expanded=false>
+Introduction</button><div class=collapse id=section-0b79795d3efc95b9976c7c5b933afce2><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-model/>DT Model</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-life-cycle/>DT Life Cycle</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/>Library Structure & Basic Concepts</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-3978929206deee2c125a1d732aae5545 aria-expanded=false>
+Change Logs</button><div class=collapse id=section-3978929206deee2c125a1d732aae5545><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/>Change Log 0.3.0</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-89413bd312d0909efb85e6693f36cb89 aria-expanded=false>
+Adapters</button><div class=collapse id=section-89413bd312d0909efb85e6693f36cb89><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/>MQTT Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/>MQTT Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/http-digital-adapter/>HTTP Digital Adapter</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-bf647454e36069fd16f1a7a35cf6a865 aria-expanded=true>
+Getting Started</button><div class="collapse show" id=section-bf647454e36069fd16f1a7a35cf6a865><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/physical-adapter/>Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/shadowing-function/>Shadowing Function</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-adapter/>Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/>DT Engine & DT Instance</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-actions/>Digital Actions</a></li><li><a class="docs-link rounded active" href=https://wldt.github.io/docs/guides/configurable-adapters/>Configurable Adapters</a></li></ul></div></li></ul></nav></div><nav class="docs-toc d-none d-xl-block col-xl-3" aria-label="Secondary navigation"><div class=page-links></div></nav><main class="docs-content col-lg-11 col-xl-9"><nav aria-label=breadcrumb><ol class=breadcrumb><li class=breadcrumb-item><a href=https://wldt.github.io/>Home</a></li><li class=breadcrumb-item><a href=https://wldt.github.io/docs/>Docs</a></li><li class=breadcrumb-item><a href=https://wldt.github.io/docs/guides/>Getting Started</a></li><li class="breadcrumb-item active" aria-current=page>Configurable Adapters</li></ol></nav><h1>Configurable Adapters</h1><nav class="toc-mobile d-xl-none" aria-label="Quaternary navigation"></nav><p>The WLDT library provides a native method to define Configurable Physical ad Digital Adapters specifying a
+custom configuration class passed as parameter in the constructor.</p><p>Starting with the Physical Adapter created in the previous example <code>DemoPhysicalAdapter</code> instead of extending the
+base class <code>PhysicalAdapter</code> we can extend now <code>ConfigurablePhysicalAdapter&lt;C></code> where <code>C</code> is the name of the
+that we would like to use as configuration.</p><p>In our example we can create a simple configuration class called <code>DemoPhysicalAdapterConfiguration</code> where we move
+the constant variable used to implement the behaviour of our demo physical adapter. The resulting class will be the
+following:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=kd>public</span> <span class=kd>class</span> <span class=nc>DemoPhysicalAdapterConfiguration</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=kd>private</span> <span class=kt>int</span> <span class=n>messageUpdateTime</span> <span class=o>=</span> <span class=n>GlobalKeywords</span><span class=o>.</span><span class=na>MESSAGE_UPDATE_TIME</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=kd>private</span> <span class=kt>int</span> <span class=n>messageUpdateNumber</span> <span class=o>=</span> <span class=n>GlobalKeywords</span><span class=o>.</span><span class=na>MESSAGE_UPDATE_NUMBER</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=kd>private</span> <span class=kt>double</span> <span class=n>temperatureMinValue</span> <span class=o>=</span> <span class=n>GlobalKeywords</span><span class=o>.</span><span class=na>TEMPERATURE_MIN_VALUE</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=kd>private</span> <span class=kt>double</span> <span class=n>temperatureMaxValue</span> <span class=o>=</span> <span class=n>GlobalKeywords</span><span class=o>.</span><span class=na>TEMPERATURE_MAX_VALUE</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=kd>public</span> <span class=nf>DemoPhysicalAdapterConfiguration</span><span class=o>()</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=kd>public</span> <span class=nf>DemoPhysicalAdapterConfiguration</span><span class=o>(</span><span class=kt>int</span> <span class=n>messageUpdateTime</span><span class=o>,</span> <span class=kt>int</span> <span class=n>messageUpdateNumber</span><span class=o>,</span> <span class=kt>double</span> <span class=n>temperatureMinValue</span><span class=o>,</span> <span class=kt>double</span> <span class=n>temperatureMaxValue</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        <span class=k>this</span><span class=o>.</span><span class=na>messageUpdateTime</span> <span class=o>=</span> <span class=n>messageUpdateTime</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>        <span class=k>this</span><span class=o>.</span><span class=na>messageUpdateNumber</span> <span class=o>=</span> <span class=n>messageUpdateNumber</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>        <span class=k>this</span><span class=o>.</span><span class=na>temperatureMinValue</span> <span class=o>=</span> <span class=n>temperatureMinValue</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>        <span class=k>this</span><span class=o>.</span><span class=na>temperatureMaxValue</span> <span class=o>=</span> <span class=n>temperatureMaxValue</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=kd>public</span> <span class=kt>int</span> <span class=nf>getMessageUpdateTime</span><span class=o>()</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        <span class=k>return</span> <span class=n>messageUpdateTime</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=kd>public</span> <span class=kt>void</span> <span class=nf>setMessageUpdateTime</span><span class=o>(</span><span class=kt>int</span> <span class=n>messageUpdateTime</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        <span class=k>this</span><span class=o>.</span><span class=na>messageUpdateTime</span> <span class=o>=</span> <span class=n>messageUpdateTime</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=kd>public</span> <span class=kt>int</span> <span class=nf>getMessageUpdateNumber</span><span class=o>()</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        <span class=k>return</span> <span class=n>messageUpdateNumber</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=kd>public</span> <span class=kt>void</span> <span class=nf>setMessageUpdateNumber</span><span class=o>(</span><span class=kt>int</span> <span class=n>messageUpdateNumber</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        <span class=k>this</span><span class=o>.</span><span class=na>messageUpdateNumber</span> <span class=o>=</span> <span class=n>messageUpdateNumber</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=kd>public</span> <span class=kt>double</span> <span class=nf>getTemperatureMinValue</span><span class=o>()</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        <span class=k>return</span> <span class=n>temperatureMinValue</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=kd>public</span> <span class=kt>void</span> <span class=nf>setTemperatureMinValue</span><span class=o>(</span><span class=kt>double</span> <span class=n>temperatureMinValue</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        <span class=k>this</span><span class=o>.</span><span class=na>temperatureMinValue</span> <span class=o>=</span> <span class=n>temperatureMinValue</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=kd>public</span> <span class=kt>double</span> <span class=nf>getTemperatureMaxValue</span><span class=o>()</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        <span class=k>return</span> <span class=n>temperatureMaxValue</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=kd>public</span> <span class=kt>void</span> <span class=nf>setTemperatureMaxValue</span><span class=o>(</span><span class=kt>double</span> <span class=n>temperatureMaxValue</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        <span class=k>this</span><span class=o>.</span><span class=na>temperatureMaxValue</span> <span class=o>=</span> <span class=n>temperatureMaxValue</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl><span class=o>}</span>
+</span></span></code></pre></div><p>Now we can create or update our Physical Adapter extending <code>ConfigurablePhysicalAdapter&lt;DemoPhysicalAdapterConfiguration></code>
+as illustrated in the following snippet:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=kd>public</span> <span class=kd>class</span> <span class=nc>DemoPhysicalAdapter</span> <span class=kd>extends</span> <span class=n>ConfigurablePhysicalAdapter</span><span class=o>&lt;</span><span class=n>DemoPhysicalAdapterConfiguration</span><span class=o>&gt;</span> <span class=o>{</span> 
+</span></span><span class=line><span class=cl>  <span class=o>[...]</span>
+</span></span><span class=line><span class=cl><span class=o>}</span>
+</span></span></code></pre></div><p>Extending this class also the constructor should be updated getting as a parameter the expected configuration instance.
+Our constructor will be the following:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=kd>public</span> <span class=nf>DemoConfPhysicalAdapter</span><span class=o>(</span><span class=n>String</span> <span class=n>id</span><span class=o>,</span> <span class=n>DemoPhysicalAdapterConfiguration</span> <span class=n>configuration</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>    <span class=kd>super</span><span class=o>(</span><span class=n>id</span><span class=o>,</span> <span class=n>configuration</span><span class=o>);</span>
+</span></span><span class=line><span class=cl><span class=o>}</span>
+</span></span></code></pre></div><p>After that change since we removed and moved the used constant values into the new Configuration class we have also to
+update the <code>deviceEmulation()</code> method having access to the configuration through the method <code>getConfiguration()</code> or <code>this.getConfiguration()</code>
+directly on the adapter.</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=kd>private</span> <span class=n>Runnable</span> <span class=nf>deviceEmulation</span><span class=o>(){</span>
+</span></span><span class=line><span class=cl>    <span class=k>return</span> <span class=o>()</span> <span class=o>-&gt;</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        <span class=k>try</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=n>System</span><span class=o>.</span><span class=na>out</span><span class=o>.</span><span class=na>println</span><span class=o>(</span><span class=s>&#34;[DemoPhysicalAdapter] -&gt; Sleeping before Starting Physical Device Emulation ...&#34;</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=c1>//Sleep 5 seconds to emulate device startup
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=n>Thread</span><span class=o>.</span><span class=na>sleep</span><span class=o>(</span><span class=mi>10000</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=n>System</span><span class=o>.</span><span class=na>out</span><span class=o>.</span><span class=na>println</span><span class=o>(</span><span class=s>&#34;[DemoPhysicalAdapter] -&gt; Starting Physical Device Emulation ...&#34;</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=c1>//Create a new random object to emulate temperature variations
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=n>Random</span> <span class=n>r</span> <span class=o>=</span> <span class=k>new</span> <span class=n>Random</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=c1>//Publish an initial Event for a normal condition
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=n>publishPhysicalAssetEventWldtEvent</span><span class=o>(</span><span class=k>new</span> <span class=n>PhysicalAssetEventWldtEvent</span><span class=o>&lt;&gt;(</span><span class=n>GlobalKeywords</span><span class=o>.</span><span class=na>OVERHEATING_EVENT_KEY</span><span class=o>,</span> <span class=s>&#34;normal&#34;</span><span class=o>));</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=c1>//Emulate the generation on &#39;n&#39; temperature measurements
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=k>for</span><span class=o>(</span><span class=kt>int</span> <span class=n>i</span> <span class=o>=</span> <span class=mi>0</span><span class=o>;</span> <span class=n>i</span> <span class=o>&lt;</span> <span class=n>getConfiguration</span><span class=o>().</span><span class=na>getMessageUpdateNumber</span><span class=o>();</span> <span class=n>i</span><span class=o>++){</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>                <span class=c1>//Sleep to emulate sensor measurement
+</span></span></span><span class=line><span class=cl><span class=c1></span>                <span class=n>Thread</span><span class=o>.</span><span class=na>sleep</span><span class=o>(</span><span class=n>getConfiguration</span><span class=o>().</span><span class=na>getMessageUpdateTime</span><span class=o>());</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>                <span class=c1>//Update the
+</span></span></span><span class=line><span class=cl><span class=c1></span>                <span class=kt>double</span> <span class=n>randomTemperature</span> <span class=o>=</span> <span class=n>getConfiguration</span><span class=o>().</span><span class=na>getTemperatureMinValue</span><span class=o>()</span> <span class=o>+</span> <span class=o>(</span><span class=n>getConfiguration</span><span class=o>().</span><span class=na>getTemperatureMaxValue</span><span class=o>()</span> <span class=o>-</span> <span class=n>getConfiguration</span><span class=o>().</span><span class=na>getTemperatureMinValue</span><span class=o>())</span> <span class=o>*</span> <span class=n>r</span><span class=o>.</span><span class=na>nextDouble</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>                <span class=c1>//Create a new event to notify the variation of a Physical Property
+</span></span></span><span class=line><span class=cl><span class=c1></span>                <span class=n>PhysicalAssetPropertyWldtEvent</span><span class=o>&lt;</span><span class=n>Double</span><span class=o>&gt;</span> <span class=n>newPhysicalPropertyEvent</span> <span class=o>=</span> <span class=k>new</span> <span class=n>PhysicalAssetPropertyWldtEvent</span><span class=o>&lt;&gt;(</span><span class=n>GlobalKeywords</span><span class=o>.</span><span class=na>TEMPERATURE_PROPERTY_KEY</span><span class=o>,</span> <span class=n>randomTemperature</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>                <span class=c1>//Publish the WLDTEvent associated to the Physical Property Variation
+</span></span></span><span class=line><span class=cl><span class=c1></span>                <span class=n>publishPhysicalAssetPropertyWldtEvent</span><span class=o>(</span><span class=n>newPhysicalPropertyEvent</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>            <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=c1>//Publish a demo Physical Event associated to a &#39;critical&#39; overheating condition
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=n>publishPhysicalAssetEventWldtEvent</span><span class=o>(</span><span class=k>new</span> <span class=n>PhysicalAssetEventWldtEvent</span><span class=o>&lt;&gt;(</span><span class=n>GlobalKeywords</span><span class=o>.</span><span class=na>OVERHEATING_EVENT_KEY</span><span class=o>,</span> <span class=s>&#34;critical&#34;</span><span class=o>));</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>        <span class=o>}</span> <span class=k>catch</span> <span class=o>(</span><span class=n>EventBusException</span> <span class=o>|</span> <span class=n>InterruptedException</span> <span class=n>e</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>            <span class=n>e</span><span class=o>.</span><span class=na>printStackTrace</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>        <span class=o>}</span>
+</span></span><span class=line><span class=cl>    <span class=o>};</span>
+</span></span><span class=line><span class=cl><span class=o>}</span>
+</span></span></code></pre></div><p>A similar approach can be adopted also for the Digital Adapter with the small difference that the base class
+<code>DigitalAdapter</code> already allow the possibility to specify a configuration. For this reason in the previous example
+we extended <code>DigitalAdapter&lt;Void></code> avoiding to specifying a configuration.</p><p>In this updated version we can create a new <code>DemoDigitalAdapterConfiguration</code> class containing the parameter association
+to the emulation of the action and then update our adapter to support the new configuration. Our new configuration class will be:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=kd>public</span> <span class=kd>class</span> <span class=nc>DemoDigitalAdapterConfiguration</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>  <span class=kd>private</span> <span class=kt>int</span> <span class=n>sleepTimeMs</span> <span class=o>=</span> <span class=n>GlobalKeywords</span><span class=o>.</span><span class=na>ACTION_SLEEP_TIME_MS</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>  <span class=kd>private</span> <span class=kt>int</span> <span class=n>emulatedActionCount</span> <span class=o>=</span> <span class=n>GlobalKeywords</span><span class=o>.</span><span class=na>EMULATED_ACTION_COUNT</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>  <span class=kd>private</span> <span class=kt>double</span> <span class=n>temperatureMinValue</span> <span class=o>=</span> <span class=n>GlobalKeywords</span><span class=o>.</span><span class=na>TEMPERATURE_MIN_VALUE</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>  <span class=kd>private</span> <span class=kt>double</span> <span class=n>temperatureMaxValue</span> <span class=o>=</span> <span class=n>GlobalKeywords</span><span class=o>.</span><span class=na>TEMPERATURE_MAX_VALUE</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>  <span class=kd>public</span> <span class=nf>DemoDigitalAdapterConfiguration</span><span class=o>()</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>  <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>  <span class=kd>public</span> <span class=nf>DemoDigitalAdapterConfiguration</span><span class=o>(</span><span class=kt>int</span> <span class=n>sleepTimeMs</span><span class=o>,</span> <span class=kt>int</span> <span class=n>emulatedActionCount</span><span class=o>,</span> <span class=kt>double</span> <span class=n>temperatureMinValue</span><span class=o>,</span> <span class=kt>double</span> <span class=n>temperatureMaxValue</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>    <span class=k>this</span><span class=o>.</span><span class=na>sleepTimeMs</span> <span class=o>=</span> <span class=n>sleepTimeMs</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>    <span class=k>this</span><span class=o>.</span><span class=na>emulatedActionCount</span> <span class=o>=</span> <span class=n>emulatedActionCount</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>    <span class=k>this</span><span class=o>.</span><span class=na>temperatureMinValue</span> <span class=o>=</span> <span class=n>temperatureMinValue</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>    <span class=k>this</span><span class=o>.</span><span class=na>temperatureMaxValue</span> <span class=o>=</span> <span class=n>temperatureMaxValue</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>  <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>  <span class=kd>public</span> <span class=kt>int</span> <span class=nf>getSleepTimeMs</span><span class=o>()</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>    <span class=k>return</span> <span class=n>sleepTimeMs</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>  <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>  <span class=kd>public</span> <span class=kt>void</span> <span class=nf>setSleepTimeMs</span><span class=o>(</span><span class=kt>int</span> <span class=n>sleepTimeMs</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>    <span class=k>this</span><span class=o>.</span><span class=na>sleepTimeMs</span> <span class=o>=</span> <span class=n>sleepTimeMs</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>  <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>  <span class=kd>public</span> <span class=kt>int</span> <span class=nf>getEmulatedActionCount</span><span class=o>()</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>    <span class=k>return</span> <span class=n>emulatedActionCount</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>  <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>  <span class=kd>public</span> <span class=kt>void</span> <span class=nf>setEmulatedActionCount</span><span class=o>(</span><span class=kt>int</span> <span class=n>emulatedActionCount</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>    <span class=k>this</span><span class=o>.</span><span class=na>emulatedActionCount</span> <span class=o>=</span> <span class=n>emulatedActionCount</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>  <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>  <span class=kd>public</span> <span class=kt>double</span> <span class=nf>getTemperatureMinValue</span><span class=o>()</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>    <span class=k>return</span> <span class=n>temperatureMinValue</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>  <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>  <span class=kd>public</span> <span class=kt>void</span> <span class=nf>setTemperatureMinValue</span><span class=o>(</span><span class=kt>double</span> <span class=n>temperatureMinValue</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>    <span class=k>this</span><span class=o>.</span><span class=na>temperatureMinValue</span> <span class=o>=</span> <span class=n>temperatureMinValue</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>  <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>  <span class=kd>public</span> <span class=kt>double</span> <span class=nf>getTemperatureMaxValue</span><span class=o>()</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>    <span class=k>return</span> <span class=n>temperatureMaxValue</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>  <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>  <span class=kd>public</span> <span class=kt>void</span> <span class=nf>setTemperatureMaxValue</span><span class=o>(</span><span class=kt>double</span> <span class=n>temperatureMaxValue</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>    <span class=k>this</span><span class=o>.</span><span class=na>temperatureMaxValue</span> <span class=o>=</span> <span class=n>temperatureMaxValue</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>  <span class=o>}</span>
+</span></span><span class=line><span class=cl><span class=o>}</span>
+</span></span></code></pre></div><p>After that we can update the declaration of our Digital Adapter and modify its constructor to accept the configuration.
+The resulting class will be:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=kd>public</span> <span class=kd>class</span> <span class=nc>DemoDigitalAdapter</span> <span class=kd>extends</span> <span class=n>DigitalAdapter</span><span class=o>&lt;</span><span class=n>DemoDigitalAdapterConfiguration</span><span class=o>&gt;</span> <span class=o>{</span> 
+</span></span><span class=line><span class=cl>  
+</span></span><span class=line><span class=cl>  <span class=kd>public</span> <span class=nf>DemoDigitalAdapter</span><span class=o>(</span><span class=n>String</span> <span class=n>id</span><span class=o>,</span> <span class=n>DemoDigitalAdapterConfiguration</span> <span class=n>configuration</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>    <span class=kd>super</span><span class=o>(</span><span class=n>id</span><span class=o>,</span> <span class=n>configuration</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>  <span class=o>}</span>
+</span></span><span class=line><span class=cl>  
+</span></span><span class=line><span class=cl>  <span class=o>[...]</span>
+</span></span><span class=line><span class=cl><span class=o>}</span>
+</span></span></code></pre></div><p>Of course the possibility to have this configuration will allow us to improve the <code>emulateIncomingDigitalAction</code> method
+in the following way having access to the configuration through the method <code>getConfiguration()</code> or <code>this.getConfiguration()</code>
+directly on the adapter:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=kd>private</span> <span class=n>Runnable</span> <span class=nf>emulateIncomingDigitalAction</span><span class=o>(){</span>
+</span></span><span class=line><span class=cl>    <span class=k>return</span> <span class=o>()</span> <span class=o>-&gt;</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        <span class=k>try</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=n>System</span><span class=o>.</span><span class=na>out</span><span class=o>.</span><span class=na>println</span><span class=o>(</span><span class=s>&#34;[DemoDigitalAdapter] -&gt; Sleeping before Emulating Incoming Digital Action ...&#34;</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>            <span class=n>Thread</span><span class=o>.</span><span class=na>sleep</span><span class=o>(</span><span class=mi>5000</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>            <span class=n>Random</span> <span class=n>random</span> <span class=o>=</span> <span class=k>new</span> <span class=n>Random</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=c1>//Emulate the generation on &#39;n&#39; temperature measurements
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=k>for</span><span class=o>(</span><span class=kt>int</span> <span class=n>i</span> <span class=o>=</span> <span class=mi>0</span><span class=o>;</span> <span class=n>i</span> <span class=o>&lt;</span> <span class=n>getConfiguration</span><span class=o>().</span><span class=na>getEmulatedActionCount</span><span class=o>();</span> <span class=n>i</span><span class=o>++){</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>                <span class=c1>//Sleep to emulate sensor measurement
+</span></span></span><span class=line><span class=cl><span class=c1></span>                <span class=n>Thread</span><span class=o>.</span><span class=na>sleep</span><span class=o>(</span><span class=n>getConfiguration</span><span class=o>().</span><span class=na>getSleepTimeMs</span><span class=o>());</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>                <span class=kt>double</span> <span class=n>randomTemperature</span> <span class=o>=</span> <span class=n>getConfiguration</span><span class=o>().</span><span class=na>getTemperatureMinValue</span><span class=o>()</span> <span class=o>+</span> <span class=o>(</span><span class=n>getConfiguration</span><span class=o>().</span><span class=na>getTemperatureMaxValue</span><span class=o>()</span> <span class=o>-</span> <span class=n>getConfiguration</span><span class=o>().</span><span class=na>getTemperatureMinValue</span><span class=o>())</span> <span class=o>*</span> <span class=n>random</span><span class=o>.</span><span class=na>nextDouble</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>                <span class=n>publishDigitalActionWldtEvent</span><span class=o>(</span><span class=s>&#34;set-temperature-action-key&#34;</span><span class=o>,</span> <span class=n>randomTemperature</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>        <span class=o>}</span> <span class=k>catch</span> <span class=o>(</span><span class=n>Exception</span> <span class=n>e</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>            <span class=n>e</span><span class=o>.</span><span class=na>printStackTrace</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>        <span class=o>}</span>
+</span></span><span class=line><span class=cl>    <span class=o>};</span>
+</span></span><span class=line><span class=cl><span class=o>}</span>
+</span></span></code></pre></div><p>When we have updated both adapters making them configurable we can update our <code>main</code> function in the process
+that we have previouly device using the updated adapters and passing the configurations:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=kd>public</span> <span class=kd>class</span> <span class=nc>DemoDigitalTwin</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=kd>public</span> <span class=kd>static</span> <span class=kt>void</span> <span class=nf>main</span><span class=o>(</span><span class=n>String</span><span class=o>[]</span> <span class=n>args</span><span class=o>)</span>  <span class=o>{</span>
+</span></span><span class=line><span class=cl>        <span class=k>try</span><span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=n>WldtEngine</span> <span class=n>digitalTwinEngine</span> <span class=o>=</span> <span class=k>new</span> <span class=n>WldtEngine</span><span class=o>(</span><span class=k>new</span> <span class=n>DemoShadowingFunction</span><span class=o>(</span><span class=s>&#34;test-shadowing-function&#34;</span><span class=o>),</span> <span class=s>&#34;test-digital-twin&#34;</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=c1>//Default Physical and Digital Adapter
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=c1>//digitalTwinEngine.addPhysicalAdapter(new DemoPhysicalAdapter(&#34;test-physical-adapter&#34;));
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=c1>//digitalTwinEngine.addDigitalAdapter(new DemoDigitalAdapter(&#34;test-digital-adapter&#34;));
+</span></span></span><span class=line><span class=cl><span class=c1></span>
+</span></span><span class=line><span class=cl>            <span class=c1>//Physical and Digital Adapters with Configuration
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=n>digitalTwinEngine</span><span class=o>.</span><span class=na>addPhysicalAdapter</span><span class=o>(</span><span class=k>new</span> <span class=n>DemoConfPhysicalAdapter</span><span class=o>(</span><span class=s>&#34;test-physical-adapter&#34;</span><span class=o>,</span> <span class=k>new</span> <span class=n>DemoPhysicalAdapterConfiguration</span><span class=o>()));</span>
+</span></span><span class=line><span class=cl>            <span class=n>digitalTwinEngine</span><span class=o>.</span><span class=na>addDigitalAdapter</span><span class=o>(</span><span class=k>new</span> <span class=n>DemoConfDigitalAdapter</span><span class=o>(</span><span class=s>&#34;test-digital-adapter&#34;</span><span class=o>,</span> <span class=k>new</span> <span class=n>DemoDigitalAdapterConfiguration</span><span class=o>()));</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=n>digitalTwinEngine</span><span class=o>.</span><span class=na>startLifeCycle</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>        <span class=o>}</span><span class=k>catch</span> <span class=o>(</span><span class=n>Exception</span> <span class=n>e</span><span class=o>){</span>
+</span></span><span class=line><span class=cl>            <span class=n>e</span><span class=o>.</span><span class=na>printStackTrace</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>        <span class=o>}</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl><span class=o>}</span>
+</span></span></code></pre></div><div class="page-footer-meta d-flex flex-column flex-md-row justify-content-between"><div class=last-modified><a href=https://github.com/wldt/wldt.github.io/commit/ab5a164de259055162e9420d8cb56c2b1562dee9><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-calendar"><rect x="3" y="4" width="18" height="18" rx="2" ry="2"/><line x1="16" y1="2" x2="16" y2="6"/><line x1="8" y1="2" x2="8" y2="6"/><line x1="3" y1="10" x2="21" y2="10"/></svg>Last updated on February 9, 2024</a></div><div class=edit-page><a href=https://github.com/wldt/wldt.github.io/blob/main/content//docs/guides/configurable-adapters.md><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-edit-2"><path d="M17 3a2.828 2.828.0 114 4L7.5 20.5 2 22l1.5-5.5L17 3z"/></svg>Edit this page on GitHub</a></div></div><div class="page-nav d-flex flex-column flex-sm-row"><div class="card w-100"><div class="card-body d-flex"><div class="d-flex flex-column justify-content-center"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-arrow-left" width="20" height="20" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 12h14"/><path d="M5 12l6 6"/><path d="M5 12l6-6"/></svg></div><div class="d-flex flex-column"><div class=text-body-secondary>Prev</div><a href=https://wldt.github.io/docs/guides/digital-actions/ class="stretched-link text-reset text-decoration-none">Digital Actions</a></div></div></div><div class=m-2></div><div class="card text-end w-100"><div class="card-body d-flex justify-content-end"><div class="d-flex flex-column"><div class=text-body-secondary>Next</div><a href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/ class="stretched-link text-reset text-decoration-none">MQTT Physical Adapter</a></div><div class="d-flex flex-column justify-content-center"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-arrow-right" width="20" height="20" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 12h14"/><path d="M13 18l6-6"/><path d="M13 6l6 6"/></svg></div></div></div></div></main></div></div></div><footer class="footer text-muted"><div class=container-lg><div class=row><div class="col-lg-8 text-center text-lg-start"><ul class=list-inline><li class=list-inline-item><a class=text-muted href=https://wldt.github.io/privacy/>Privacy Policy</a></li></ul></div><div class="col-lg-8 text-center text-lg-end"><ul class=list-inline><li class=list-inline-item>Brought to you by <a class=text-muted href=https://gethyas.com/>Hyas</a></li></ul></div></div></div></footer><script async src=https://wldt.github.io/js/app.1e84dcdaa5ccef6fe83f6d88ac1e444a1f237111cfa2a7a97427f758e9c27ef4.js integrity="sha256-HoTc2qXM72/oP22IrB5ESh8jcRHPoqepdCf3WOnCfvQ="></script>
+<script async src=https://wldt.github.io/js/flexsearch.dc00caef2c3490dbab3c345ed0d4133b0aafb803efeb21c3df80776d6d3ea821.js integrity="sha256-3ADK7yw0kNurPDRe0NQTOwqvuAPv6yHD34B3bW0+qCE="></script><script async src=https://wldt.github.io/js/search-modal.c4c023efcdee308e4b5f1110afe1db6b1656f217e67aa7efe54e2f4bf2feccf8.js integrity="sha256-xMAj783uMI5LXxEQr+HbaxZW8hfmeqfv5U4vS/L+zPg="></script><div class="d-inline-flex fixed-bottom-right pb-4 pe-4"><button id=toTop type=button class="btn btn-primary rounded-circle ms-auto p-2"><span class=visually-hidden>Top</span><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-chevron-up" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M6 15l6-6 6 6"/></svg></button></div></body></html>
\ No newline at end of file
diff --git a/docs/guides/digital-actions/index.html b/docs/guides/digital-actions/index.html
new file mode 100644
index 0000000..f097d92
--- /dev/null
+++ b/docs/guides/digital-actions/index.html
@@ -0,0 +1,75 @@
+<!doctype html><html lang=en data-bs-theme=auto><head><meta charset=utf-8><meta http-equiv=x-ua-compatible content="ie=edge"><meta name=viewport content="width=device-width,initial-scale=1"><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-regular.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-500.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-700.woff2 type=font/woff2 crossorigin><script src=https://wldt.github.io/js/color-mode.86a91f050a481d0a3f0c72ac26543cb6228c770875981c58dcbc008fd3f875c8.js integrity="sha256-hqkfBQpIHQo/DHKsJlQ8tiKMdwh1mBxY3LwAj9P4dcg="></script>
+<link rel=stylesheet href=https://wldt.github.io/main.5fb433a44687c98f7ae7b3d0137c762777049ba27235e1f08c279c03c8533a7a9a1e3b0ef5b125a31b6bb63a362cdcbc39c3706ed41ad7f1a620b9281013866c.css integrity="sha512-X7QzpEaHyY9657PQE3x2J3cEm6JyNeHwjCecA8hTOnqaHjsO9bEloxtrtjo2LNy8OcNwbtQa1/GmILkoEBOGbA==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>Digital Actions | WLDT</title><meta property="canonical" content="https://wldt.github.io/docs/guides/digital-actions/"><meta name=description content="In this demo implementation, we are going to emulate an incoming Digital Action on the Digital Adapter in order to show how it can be handled by the adapter and properly forwarded to the Shadowing Function for validation and the consequent interaction with the Physical Adapter and then with the physical twin."><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/docs/guides/digital-actions/"><meta property="og:title" content="Digital Actions"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:section" content="docs"><meta property="og:description" content="In this demo implementation, we are going to emulate an incoming Digital Action on the Digital Adapter in order to show how it can be handled by the adapter and properly forwarded to the Shadowing Function for validation and the consequent interaction with the Physical Adapter and then with the physical twin."><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-model/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-life-cycle/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/library-structure-basic-concepts/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/physical-adapter/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/shadowing-function/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/digital-adapter/"><meta name=twitter:card content="summary"><meta name=twitter:title content="Digital Actions"><meta name=twitter:description content="In this demo implementation, we are going to emulate an incoming Digital Action on the Digital Adapter in order to show how it can be handled by the adapter and properly forwarded to the Shadowing Function for validation and the consequent interaction with the Physical Adapter and then with the physical twin."><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","item":"https://wldt.github.io/docs/","name":"Docs","position":2},{"@type":"ListItem","item":"https://wldt.github.io/docs/guides/","name":"Getting Started","position":3},{"@type":"ListItem","name":"Digital Actions","position":4}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="single section docs" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
+<button type=button id=searchToggleMobile class="btn btn-link nav-link mx-2 d-lg-none" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button class="btn btn-link d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavSection aria-controls=offcanvasNavSection aria-label="Open section navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-dots-vertical" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 19m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 5m-1 0a1 1 0 102 0 1 1 0 10-2 0"/></svg></button><div class="offcanvas offcanvas-start d-lg-none" tabindex=-1 id=offcanvasNavSection aria-labelledby=offcanvasNavSectionLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavSectionLabel>Docs</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class=offcanvas-body><aside class="doks-sidebar mt-n3"><nav id=doks-docs-nav aria-label="Tertiary navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-0b79795d3efc95b9976c7c5b933afce2 aria-expanded=false>
+Introduction</button><div class=collapse id=section-0b79795d3efc95b9976c7c5b933afce2><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-model/>DT Model</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-life-cycle/>DT Life Cycle</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/>Library Structure & Basic Concepts</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-3978929206deee2c125a1d732aae5545 aria-expanded=false>
+Change Logs</button><div class=collapse id=section-3978929206deee2c125a1d732aae5545><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/>Change Log 0.3.0</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-89413bd312d0909efb85e6693f36cb89 aria-expanded=false>
+Adapters</button><div class=collapse id=section-89413bd312d0909efb85e6693f36cb89><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/>MQTT Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/>MQTT Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/http-digital-adapter/>HTTP Digital Adapter</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-bf647454e36069fd16f1a7a35cf6a865 aria-expanded=true>
+Getting Started</button><div class="collapse show" id=section-bf647454e36069fd16f1a7a35cf6a865><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/physical-adapter/>Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/shadowing-function/>Shadowing Function</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-adapter/>Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/>DT Engine & DT Instance</a></li><li><a class="docs-link rounded active" href=https://wldt.github.io/docs/guides/digital-actions/>Digital Actions</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/configurable-adapters/>Configurable Adapters</a></li></ul></div></li></ul></nav></aside></div></div><button class="btn btn-link nav-link mx-2 order-3 d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavMain aria-controls=offcanvasNavMain aria-label="Open main navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-menu" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><line x1="4" y1="8" x2="20" y2="8"/><line x1="4" y1="16" x2="20" y2="16"/></svg></button><div class="offcanvas offcanvas-end h-auto" tabindex=-1 id=offcanvasNavMain aria-labelledby=offcanvasNavMainLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavMainLabel>WLDT</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class="offcanvas-body d-flex flex-column flex-lg-row justify-content-between"><ul class="navbar-nav flex-grow-1"><li class=nav-item><a class=nav-link href=https://wldt.github.io/docs/guides/example-guide/>Documentation</a></li><li class=nav-item><a class=nav-link href=https://wldt.github.io/blog/>Blog</a></li></ul><button type=button id=searchToggleDesktop class="btn btn-link nav-link p-2 d-none d-lg-block" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button id=buttonColorMode class="btn btn-link mx-auto nav-link p-0 ms-lg-2 me-lg-1" type=button aria-label="Toggle theme"><svg data-bs-theme-value="dark" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-moon" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 3c.132.0.263.0.393.0a7.5 7.5.0 007.92 12.446A9 9 0 1112 2.992z"/></svg><svg data-bs-theme-value="light" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-sun" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-4 0a4 4 0 108 0 4 4 0 10-8 0m-5 0h1m8-9v1m8 8h1m-9 8v1M5.6 5.6l.7.7m12.1-.7-.7.7m0 11.4.7.7m-12.1-.7-.7.7"/></svg></button><ul id=socialMenu class="nav mx-auto flex-row order-lg-4"><li class=nav-item><a class="nav-link social-link" href=https://github.com/wldt><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-brand-github" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 19c-4.3 1.4-4.3-2.5-6-3m12 5v-3.5c0-1 .1-1.4-.5-2 2.8-.3 5.5-1.4 5.5-6a4.6 4.6.0 00-1.3-3.2 4.2 4.2.0 00-.1-3.2s-1.1-.3-3.5 1.3a12.3 12.3.0 00-6.2.0C6.5 2.8 5.4 3.1 5.4 3.1a4.2 4.2.0 00-.1 3.2A4.6 4.6.0 004 9.5c0 4.6 2.7 5.7 5.5 6-.6.6-.6 1.2-.5 2V21"/></svg><small class="ms-2 visually-hidden">GitHub</small></a></li></ul></div></div></div></header></div><div class=modal id=searchModal tabindex=-1 aria-labelledby=searchModalLabel aria-hidden=true><div class="modal-dialog modal-dialog-scrollable modal-fullscreen-md-down"><div class=modal-content><div class=modal-header><h1 class="modal-title fs-5 visually-hidden" id=searchModalLabel>Search</h1><button type=button class="btn-close visually-hidden" data-bs-dismiss=modal aria-label=Close></button><div class="search-input flex-grow-1 d-none"><form id=search-form class=search-form action=# method=post accept-charset=utf-8 role=search><label for=query class=visually-hidden>Search</label><div class=d-flex><input type=search id=query name=query class="search-text form-control form-control-lg" placeholder=Search aria-label=Search maxlength=128 autocomplete=off>
+<button type=button class="btn btn-link text-decoration-none px-0 ms-3 d-md-none" data-bs-dismiss=modal aria-label=Close>Cancel</button></div></form></div></div><div class=modal-body><p class="search-loading status message d-none mt-3 text-center">Loading search index…</p><p class="search-no-recent message d-none mt-3 text-center">No recent searches</p><p class="search-no-results message d-none mt-3 text-center">No results for "<strong><span class=query-no-results>Query here</span></strong>"</p><div id=searchResults class=search-results></div><template><article class="search-result list-view"><div class="card my-3"><div class=card-body><header><h2 class="h5 title title-submitted mb-0"><a class="stretched-link text-decoration-none text-reset" href=#>Title here</a></h2><div class="submitted d-none"><time class=created-date>Date here</time></div></header><div class=content>Summary here</div></div></div></article></template></div><div class=modal-footer><ul class="list-inline me-auto d-none d-md-block"><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Enter key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M12 3.53088v3c0 1-1 2-2 2H4m3 3-3-3 3-3"/></g></svg></kbd><span class=DocSearch-Label>to select</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Arrow down" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 3.5v8m3-3-3 3-3-3"/></g></svg></kbd><kbd class=me-2><svg width="15" height="15" aria-label="Arrow up" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 11.5v-8m3 3-3-3-3 3"/></g></svg></kbd><span class=DocSearch-Label>to navigate</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Escape key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M13.6167 8.936c-.1065.3583-.6883.962-1.4875.962-.7993.0-1.653-.9165-1.653-2.1258v-.5678c0-1.2548.7896-2.1016 1.653-2.1016s1.3601.4778 1.4875 1.0724M9 6c-.1352-.4735-.7506-.9219-1.46-.8972-.7092.0246-1.344.57-1.344 1.2166s.4198.8812 1.3445.9805C8.465 7.3992 8.968 7.9337 9 8.5s-.454 1.398-1.4595 1.398C6.6593 9.898 6 9 5.963 8.4851m-1.4748.5368c-.2635.5941-.8099.876-1.5443.876s-1.7073-.6248-1.7073-2.204v-.4603c0-1.0416.721-2.131 1.7073-2.131.9864.0 1.6425 1.031 1.5443 2.2492h-2.956"/></g></svg></kbd><span class=DocSearch-Label>to close</span></li></ul><p class=d-md-none>Search by <a class=text-decoration-none href=https://github.com/nextapps-de/flexsearch>FlexSearch</a></p></div></div></div></div><div class="wrap container-lg" role=document><div class=content><div class="row flex-xl-nowrap"><div class="col-lg-5 col-xl-4 docs-sidebar d-none d-lg-block"><nav class=docs-links aria-label="Main navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-0b79795d3efc95b9976c7c5b933afce2 aria-expanded=false>
+Introduction</button><div class=collapse id=section-0b79795d3efc95b9976c7c5b933afce2><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-model/>DT Model</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-life-cycle/>DT Life Cycle</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/>Library Structure & Basic Concepts</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-3978929206deee2c125a1d732aae5545 aria-expanded=false>
+Change Logs</button><div class=collapse id=section-3978929206deee2c125a1d732aae5545><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/>Change Log 0.3.0</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-89413bd312d0909efb85e6693f36cb89 aria-expanded=false>
+Adapters</button><div class=collapse id=section-89413bd312d0909efb85e6693f36cb89><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/>MQTT Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/>MQTT Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/http-digital-adapter/>HTTP Digital Adapter</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-bf647454e36069fd16f1a7a35cf6a865 aria-expanded=true>
+Getting Started</button><div class="collapse show" id=section-bf647454e36069fd16f1a7a35cf6a865><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/physical-adapter/>Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/shadowing-function/>Shadowing Function</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-adapter/>Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/>DT Engine & DT Instance</a></li><li><a class="docs-link rounded active" href=https://wldt.github.io/docs/guides/digital-actions/>Digital Actions</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/configurable-adapters/>Configurable Adapters</a></li></ul></div></li></ul></nav></div><nav class="docs-toc d-none d-xl-block col-xl-3" aria-label="Secondary navigation"><div class=page-links></div></nav><main class="docs-content col-lg-11 col-xl-9"><nav aria-label=breadcrumb><ol class=breadcrumb><li class=breadcrumb-item><a href=https://wldt.github.io/>Home</a></li><li class=breadcrumb-item><a href=https://wldt.github.io/docs/>Docs</a></li><li class=breadcrumb-item><a href=https://wldt.github.io/docs/guides/>Getting Started</a></li><li class="breadcrumb-item active" aria-current=page>Digital Actions</li></ol></nav><h1>Digital Actions</h1><nav class="toc-mobile d-xl-none" aria-label="Quaternary navigation"></nav><p>In this demo implementation, we are going to emulate an incoming Digital Action on the Digital Adapter in order to show how it can be handled by the adapter and
+properly forwarded to the Shadowing Function for validation and the consequent interaction with the Physical Adapter and then with the physical twin.</p><p>In order to add a demo Digital Action trigger on the Digital Adapter we add the following method to the <code>DemoDigitalAdapter</code> class:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=kd>private</span> <span class=n>Runnable</span> <span class=nf>emulateIncomingDigitalAction</span><span class=o>(){</span>
+</span></span><span class=line><span class=cl>    <span class=k>return</span> <span class=o>()</span> <span class=o>-&gt;</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        <span class=k>try</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=n>System</span><span class=o>.</span><span class=na>out</span><span class=o>.</span><span class=na>println</span><span class=o>(</span><span class=s>&#34;Sleeping before Emulating Incoming Digital Action ...&#34;</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>            <span class=n>Thread</span><span class=o>.</span><span class=na>sleep</span><span class=o>(</span><span class=mi>5000</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>            <span class=n>Random</span> <span class=n>random</span> <span class=o>=</span> <span class=k>new</span> <span class=n>Random</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=c1>//Emulate the generation on &#39;n&#39; temperature measurements
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=k>for</span><span class=o>(</span><span class=kt>int</span> <span class=n>i</span> <span class=o>=</span> <span class=mi>0</span><span class=o>;</span> <span class=n>i</span> <span class=o>&lt;</span> <span class=mi>10</span><span class=o>;</span> <span class=n>i</span><span class=o>++){</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>                <span class=c1>//Sleep to emulate sensor measurement
+</span></span></span><span class=line><span class=cl><span class=c1></span>                <span class=n>Thread</span><span class=o>.</span><span class=na>sleep</span><span class=o>(</span><span class=mi>1000</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>                <span class=kt>double</span> <span class=n>randomTemperature</span> <span class=o>=</span> <span class=mi>25</span><span class=o>.</span><span class=na>0</span> <span class=o>+</span> <span class=o>(</span><span class=mi>30</span><span class=o>.</span><span class=na>0</span> <span class=o>-</span> <span class=mi>25</span><span class=o>.</span><span class=na>0</span><span class=o>)</span> <span class=o>*</span> <span class=n>random</span><span class=o>.</span><span class=na>nextDouble</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>                <span class=n>publishDigitalActionWldtEvent</span><span class=o>(</span><span class=s>&#34;set-temperature-action-key&#34;</span><span class=o>,</span> <span class=n>randomTemperature</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>        <span class=o>}</span> <span class=k>catch</span> <span class=o>(</span><span class=n>Exception</span> <span class=n>e</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>            <span class=n>e</span><span class=o>.</span><span class=na>printStackTrace</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>        <span class=o>}</span>
+</span></span><span class=line><span class=cl>    <span class=o>};</span>
+</span></span><span class=line><span class=cl><span class=o>}</span>
+</span></span></code></pre></div><p>This method uses the Digital Adapter internal function denoted as <code>publishDigitalActionWldtEvent(String actionKey, T body)</code> allowing the adapter
+to send a notification to the DT&rsquo;s Core (and consequently the Shadowing Function) about the arrival of a Digital Action with a specific <code>key</code> and <code>body</code>.
+In our case the <code>key</code> is <code>set-temperature-action-key</code> as declared in the Physical Adapter and in the PAD and the value is a simple Double with the new temperature value.</p><p>Then we call this method in the following way at the end ot the <code>onDigitalTwinSync(IDigitalTwinState currentDigitalTwinState)</code> method.</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=c1>//Start Digital Action Emulation
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=k>new</span> <span class=n>Thread</span><span class=o>(</span><span class=n>emulateIncomingDigitalAction</span><span class=o>()).</span><span class=na>start</span><span class=o>();</span>
+</span></span></code></pre></div><p>Now the Shadowing Function should be updated in order to handle the incoming Action request from the Digital Adapter.
+In our case the shadowing function does not apply any validation or check and just forward to action to the Physical Adapter
+in order to be then forwarded to the physical twin. Of course advanced implementation can be introduced for example to
+validate action, adapt payload and data-formats or to augment functionalities (e.g., trigger multiple physical actions from a single digital request).</p><p>In our simple demo implementation the updated Shadowing Function method <code>onDigitalActionEvent(DigitalActionWldtEvent&lt;?> digitalActionWldtEvent)</code> results as follows:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=nd>@Override</span>
+</span></span><span class=line><span class=cl><span class=kd>protected</span> <span class=kt>void</span> <span class=nf>onDigitalActionEvent</span><span class=o>(</span><span class=n>DigitalActionWldtEvent</span><span class=o>&lt;?&gt;</span> <span class=n>digitalActionWldtEvent</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>    <span class=k>try</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        <span class=k>this</span><span class=o>.</span><span class=na>publishPhysicalAssetActionWldtEvent</span><span class=o>(</span><span class=n>digitalActionWldtEvent</span><span class=o>.</span><span class=na>getActionKey</span><span class=o>(),</span> <span class=n>digitalActionWldtEvent</span><span class=o>.</span><span class=na>getBody</span><span class=o>());</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span> <span class=k>catch</span> <span class=o>(</span><span class=n>Exception</span> <span class=n>e</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        <span class=n>e</span><span class=o>.</span><span class=na>printStackTrace</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl><span class=o>}</span>
+</span></span></code></pre></div><p>This forwarding of the action triggers the corresponding Physical Adapter method <code>onIncomingPhysicalAction(PhysicalAssetActionWldtEvent&lt;?> physicalAssetActionWldtEvent)</code>
+that in our case is emulated just with a Log on the console. Also in that case advanced Physical Adapter implementation can be introduced
+for example to adapt the request from a high-level (and potentially standard) DT action description to the custom requirements of the
+specific physical twin managed by the adapter.</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=nd>@Override</span>
+</span></span><span class=line><span class=cl><span class=kd>public</span> <span class=kt>void</span> <span class=nf>onIncomingPhysicalAction</span><span class=o>(</span><span class=n>PhysicalAssetActionWldtEvent</span><span class=o>&lt;?&gt;</span> <span class=n>physicalAssetActionWldtEvent</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>    <span class=k>try</span><span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>        <span class=k>if</span><span class=o>(</span><span class=n>physicalAssetActionWldtEvent</span> <span class=o>!=</span> <span class=kc>null</span>
+</span></span><span class=line><span class=cl>                <span class=o>&amp;&amp;</span> <span class=n>physicalAssetActionWldtEvent</span><span class=o>.</span><span class=na>getActionKey</span><span class=o>().</span><span class=na>equals</span><span class=o>(</span><span class=n>SET_TEMPERATURE_ACTION_KEY</span><span class=o>)</span>
+</span></span><span class=line><span class=cl>                <span class=o>&amp;&amp;</span> <span class=n>physicalAssetActionWldtEvent</span><span class=o>.</span><span class=na>getBody</span><span class=o>()</span> <span class=k>instanceof</span> <span class=n>Double</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>            <span class=n>System</span><span class=o>.</span><span class=na>out</span><span class=o>.</span><span class=na>println</span><span class=o>(</span><span class=s>&#34;Received Action Request: &#34;</span> <span class=o>+</span> <span class=n>physicalAssetActionWldtEvent</span><span class=o>.</span><span class=na>getActionKey</span><span class=o>()</span>
+</span></span><span class=line><span class=cl>                    <span class=o>+</span> <span class=s>&#34; with Body: &#34;</span> <span class=o>+</span> <span class=n>physicalAssetActionWldtEvent</span><span class=o>.</span><span class=na>getBody</span><span class=o>());</span>
+</span></span><span class=line><span class=cl>        <span class=o>}</span>
+</span></span><span class=line><span class=cl>        <span class=k>else</span>
+</span></span><span class=line><span class=cl>            <span class=n>System</span><span class=o>.</span><span class=na>err</span><span class=o>.</span><span class=na>println</span><span class=o>(</span><span class=s>&#34;Wrong Action Received !&#34;</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=o>}</span><span class=k>catch</span> <span class=o>(</span><span class=n>Exception</span> <span class=n>e</span><span class=o>){</span>
+</span></span><span class=line><span class=cl>        <span class=n>e</span><span class=o>.</span><span class=na>printStackTrace</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl><span class=o>}</span>
+</span></span></code></pre></div><div class="page-footer-meta d-flex flex-column flex-md-row justify-content-between"><div class=last-modified><a href=https://github.com/wldt/wldt.github.io/commit/ab5a164de259055162e9420d8cb56c2b1562dee9><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-calendar"><rect x="3" y="4" width="18" height="18" rx="2" ry="2"/><line x1="16" y1="2" x2="16" y2="6"/><line x1="8" y1="2" x2="8" y2="6"/><line x1="3" y1="10" x2="21" y2="10"/></svg>Last updated on February 9, 2024</a></div><div class=edit-page><a href=https://github.com/wldt/wldt.github.io/blob/main/content//docs/guides/digital-actions.md><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-edit-2"><path d="M17 3a2.828 2.828.0 114 4L7.5 20.5 2 22l1.5-5.5L17 3z"/></svg>Edit this page on GitHub</a></div></div><div class="page-nav d-flex flex-column flex-sm-row"><div class="card w-100"><div class="card-body d-flex"><div class="d-flex flex-column justify-content-center"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-arrow-left" width="20" height="20" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 12h14"/><path d="M5 12l6 6"/><path d="M5 12l6-6"/></svg></div><div class="d-flex flex-column"><div class=text-body-secondary>Prev</div><a href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/ class="stretched-link text-reset text-decoration-none">DT Engine & DT Instance</a></div></div></div><div class=m-2></div><div class="card text-end w-100"><div class="card-body d-flex justify-content-end"><div class="d-flex flex-column"><div class=text-body-secondary>Next</div><a href=https://wldt.github.io/docs/guides/configurable-adapters/ class="stretched-link text-reset text-decoration-none">Configurable Adapters</a></div><div class="d-flex flex-column justify-content-center"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-arrow-right" width="20" height="20" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 12h14"/><path d="M13 18l6-6"/><path d="M13 6l6 6"/></svg></div></div></div></div></main></div></div></div><footer class="footer text-muted"><div class=container-lg><div class=row><div class="col-lg-8 text-center text-lg-start"><ul class=list-inline><li class=list-inline-item><a class=text-muted href=https://wldt.github.io/privacy/>Privacy Policy</a></li></ul></div><div class="col-lg-8 text-center text-lg-end"><ul class=list-inline><li class=list-inline-item>Brought to you by <a class=text-muted href=https://gethyas.com/>Hyas</a></li></ul></div></div></div></footer><script async src=https://wldt.github.io/js/app.1e84dcdaa5ccef6fe83f6d88ac1e444a1f237111cfa2a7a97427f758e9c27ef4.js integrity="sha256-HoTc2qXM72/oP22IrB5ESh8jcRHPoqepdCf3WOnCfvQ="></script>
+<script async src=https://wldt.github.io/js/flexsearch.dc00caef2c3490dbab3c345ed0d4133b0aafb803efeb21c3df80776d6d3ea821.js integrity="sha256-3ADK7yw0kNurPDRe0NQTOwqvuAPv6yHD34B3bW0+qCE="></script><script async src=https://wldt.github.io/js/search-modal.c4c023efcdee308e4b5f1110afe1db6b1656f217e67aa7efe54e2f4bf2feccf8.js integrity="sha256-xMAj783uMI5LXxEQr+HbaxZW8hfmeqfv5U4vS/L+zPg="></script><div class="d-inline-flex fixed-bottom-right pb-4 pe-4"><button id=toTop type=button class="btn btn-primary rounded-circle ms-auto p-2"><span class=visually-hidden>Top</span><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-chevron-up" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M6 15l6-6 6 6"/></svg></button></div></body></html>
\ No newline at end of file
diff --git a/docs/guides/digital-adapter/index.html b/docs/guides/digital-adapter/index.html
new file mode 100644
index 0000000..24ba966
--- /dev/null
+++ b/docs/guides/digital-adapter/index.html
@@ -0,0 +1,193 @@
+<!doctype html><html lang=en data-bs-theme=auto><head><meta charset=utf-8><meta http-equiv=x-ua-compatible content="ie=edge"><meta name=viewport content="width=device-width,initial-scale=1"><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-regular.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-500.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-700.woff2 type=font/woff2 crossorigin><script src=https://wldt.github.io/js/color-mode.86a91f050a481d0a3f0c72ac26543cb6228c770875981c58dcbc008fd3f875c8.js integrity="sha256-hqkfBQpIHQo/DHKsJlQ8tiKMdwh1mBxY3LwAj9P4dcg="></script>
+<link rel=stylesheet href=https://wldt.github.io/main.5fb433a44687c98f7ae7b3d0137c762777049ba27235e1f08c279c03c8533a7a9a1e3b0ef5b125a31b6bb63a362cdcbc39c3706ed41ad7f1a620b9281013866c.css integrity="sha512-X7QzpEaHyY9657PQE3x2J3cEm6JyNeHwjCecA8hTOnqaHjsO9bEloxtrtjo2LNy8OcNwbtQa1/GmILkoEBOGbA==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>Digital Adapter | WLDT</title><meta property="canonical" content="https://wldt.github.io/docs/guides/digital-adapter/"><meta name=description content="The las component that we have to implement to complete our first simple Digital Twin definition through the WLDT library is a Digital Adapter in charge of:"><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/docs/guides/digital-adapter/"><meta property="og:title" content="Digital Adapter"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:section" content="docs"><meta property="og:description" content="The las component that we have to implement to complete our first simple Digital Twin definition through the WLDT library is a Digital Adapter in charge of:"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-model/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-life-cycle/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/library-structure-basic-concepts/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/physical-adapter/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/shadowing-function/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/digital-adapter/"><meta name=twitter:card content="summary"><meta name=twitter:title content="Digital Adapter"><meta name=twitter:description content="The las component that we have to implement to complete our first simple Digital Twin definition through the WLDT library is a Digital Adapter in charge of:"><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","item":"https://wldt.github.io/docs/","name":"Docs","position":2},{"@type":"ListItem","item":"https://wldt.github.io/docs/guides/","name":"Getting Started","position":3},{"@type":"ListItem","name":"Digital Adapter","position":4}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="single section docs" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
+<button type=button id=searchToggleMobile class="btn btn-link nav-link mx-2 d-lg-none" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button class="btn btn-link d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavSection aria-controls=offcanvasNavSection aria-label="Open section navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-dots-vertical" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 19m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 5m-1 0a1 1 0 102 0 1 1 0 10-2 0"/></svg></button><div class="offcanvas offcanvas-start d-lg-none" tabindex=-1 id=offcanvasNavSection aria-labelledby=offcanvasNavSectionLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavSectionLabel>Docs</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class=offcanvas-body><aside class="doks-sidebar mt-n3"><nav id=doks-docs-nav aria-label="Tertiary navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-0b79795d3efc95b9976c7c5b933afce2 aria-expanded=false>
+Introduction</button><div class=collapse id=section-0b79795d3efc95b9976c7c5b933afce2><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-model/>DT Model</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-life-cycle/>DT Life Cycle</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/>Library Structure & Basic Concepts</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-3978929206deee2c125a1d732aae5545 aria-expanded=false>
+Change Logs</button><div class=collapse id=section-3978929206deee2c125a1d732aae5545><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/>Change Log 0.3.0</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-89413bd312d0909efb85e6693f36cb89 aria-expanded=false>
+Adapters</button><div class=collapse id=section-89413bd312d0909efb85e6693f36cb89><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/>MQTT Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/>MQTT Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/http-digital-adapter/>HTTP Digital Adapter</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-bf647454e36069fd16f1a7a35cf6a865 aria-expanded=true>
+Getting Started</button><div class="collapse show" id=section-bf647454e36069fd16f1a7a35cf6a865><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/physical-adapter/>Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/shadowing-function/>Shadowing Function</a></li><li><a class="docs-link rounded active" href=https://wldt.github.io/docs/guides/digital-adapter/>Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/>DT Engine & DT Instance</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-actions/>Digital Actions</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/configurable-adapters/>Configurable Adapters</a></li></ul></div></li></ul></nav></aside></div></div><button class="btn btn-link nav-link mx-2 order-3 d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavMain aria-controls=offcanvasNavMain aria-label="Open main navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-menu" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><line x1="4" y1="8" x2="20" y2="8"/><line x1="4" y1="16" x2="20" y2="16"/></svg></button><div class="offcanvas offcanvas-end h-auto" tabindex=-1 id=offcanvasNavMain aria-labelledby=offcanvasNavMainLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavMainLabel>WLDT</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class="offcanvas-body d-flex flex-column flex-lg-row justify-content-between"><ul class="navbar-nav flex-grow-1"><li class=nav-item><a class=nav-link href=https://wldt.github.io/docs/guides/example-guide/>Documentation</a></li><li class=nav-item><a class=nav-link href=https://wldt.github.io/blog/>Blog</a></li></ul><button type=button id=searchToggleDesktop class="btn btn-link nav-link p-2 d-none d-lg-block" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button id=buttonColorMode class="btn btn-link mx-auto nav-link p-0 ms-lg-2 me-lg-1" type=button aria-label="Toggle theme"><svg data-bs-theme-value="dark" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-moon" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 3c.132.0.263.0.393.0a7.5 7.5.0 007.92 12.446A9 9 0 1112 2.992z"/></svg><svg data-bs-theme-value="light" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-sun" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-4 0a4 4 0 108 0 4 4 0 10-8 0m-5 0h1m8-9v1m8 8h1m-9 8v1M5.6 5.6l.7.7m12.1-.7-.7.7m0 11.4.7.7m-12.1-.7-.7.7"/></svg></button><ul id=socialMenu class="nav mx-auto flex-row order-lg-4"><li class=nav-item><a class="nav-link social-link" href=https://github.com/wldt><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-brand-github" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 19c-4.3 1.4-4.3-2.5-6-3m12 5v-3.5c0-1 .1-1.4-.5-2 2.8-.3 5.5-1.4 5.5-6a4.6 4.6.0 00-1.3-3.2 4.2 4.2.0 00-.1-3.2s-1.1-.3-3.5 1.3a12.3 12.3.0 00-6.2.0C6.5 2.8 5.4 3.1 5.4 3.1a4.2 4.2.0 00-.1 3.2A4.6 4.6.0 004 9.5c0 4.6 2.7 5.7 5.5 6-.6.6-.6 1.2-.5 2V21"/></svg><small class="ms-2 visually-hidden">GitHub</small></a></li></ul></div></div></div></header></div><div class=modal id=searchModal tabindex=-1 aria-labelledby=searchModalLabel aria-hidden=true><div class="modal-dialog modal-dialog-scrollable modal-fullscreen-md-down"><div class=modal-content><div class=modal-header><h1 class="modal-title fs-5 visually-hidden" id=searchModalLabel>Search</h1><button type=button class="btn-close visually-hidden" data-bs-dismiss=modal aria-label=Close></button><div class="search-input flex-grow-1 d-none"><form id=search-form class=search-form action=# method=post accept-charset=utf-8 role=search><label for=query class=visually-hidden>Search</label><div class=d-flex><input type=search id=query name=query class="search-text form-control form-control-lg" placeholder=Search aria-label=Search maxlength=128 autocomplete=off>
+<button type=button class="btn btn-link text-decoration-none px-0 ms-3 d-md-none" data-bs-dismiss=modal aria-label=Close>Cancel</button></div></form></div></div><div class=modal-body><p class="search-loading status message d-none mt-3 text-center">Loading search index…</p><p class="search-no-recent message d-none mt-3 text-center">No recent searches</p><p class="search-no-results message d-none mt-3 text-center">No results for "<strong><span class=query-no-results>Query here</span></strong>"</p><div id=searchResults class=search-results></div><template><article class="search-result list-view"><div class="card my-3"><div class=card-body><header><h2 class="h5 title title-submitted mb-0"><a class="stretched-link text-decoration-none text-reset" href=#>Title here</a></h2><div class="submitted d-none"><time class=created-date>Date here</time></div></header><div class=content>Summary here</div></div></div></article></template></div><div class=modal-footer><ul class="list-inline me-auto d-none d-md-block"><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Enter key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M12 3.53088v3c0 1-1 2-2 2H4m3 3-3-3 3-3"/></g></svg></kbd><span class=DocSearch-Label>to select</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Arrow down" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 3.5v8m3-3-3 3-3-3"/></g></svg></kbd><kbd class=me-2><svg width="15" height="15" aria-label="Arrow up" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 11.5v-8m3 3-3-3-3 3"/></g></svg></kbd><span class=DocSearch-Label>to navigate</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Escape key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M13.6167 8.936c-.1065.3583-.6883.962-1.4875.962-.7993.0-1.653-.9165-1.653-2.1258v-.5678c0-1.2548.7896-2.1016 1.653-2.1016s1.3601.4778 1.4875 1.0724M9 6c-.1352-.4735-.7506-.9219-1.46-.8972-.7092.0246-1.344.57-1.344 1.2166s.4198.8812 1.3445.9805C8.465 7.3992 8.968 7.9337 9 8.5s-.454 1.398-1.4595 1.398C6.6593 9.898 6 9 5.963 8.4851m-1.4748.5368c-.2635.5941-.8099.876-1.5443.876s-1.7073-.6248-1.7073-2.204v-.4603c0-1.0416.721-2.131 1.7073-2.131.9864.0 1.6425 1.031 1.5443 2.2492h-2.956"/></g></svg></kbd><span class=DocSearch-Label>to close</span></li></ul><p class=d-md-none>Search by <a class=text-decoration-none href=https://github.com/nextapps-de/flexsearch>FlexSearch</a></p></div></div></div></div><div class="wrap container-lg" role=document><div class=content><div class="row flex-xl-nowrap"><div class="col-lg-5 col-xl-4 docs-sidebar d-none d-lg-block"><nav class=docs-links aria-label="Main navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-0b79795d3efc95b9976c7c5b933afce2 aria-expanded=false>
+Introduction</button><div class=collapse id=section-0b79795d3efc95b9976c7c5b933afce2><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-model/>DT Model</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-life-cycle/>DT Life Cycle</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/>Library Structure & Basic Concepts</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-3978929206deee2c125a1d732aae5545 aria-expanded=false>
+Change Logs</button><div class=collapse id=section-3978929206deee2c125a1d732aae5545><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/>Change Log 0.3.0</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-89413bd312d0909efb85e6693f36cb89 aria-expanded=false>
+Adapters</button><div class=collapse id=section-89413bd312d0909efb85e6693f36cb89><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/>MQTT Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/>MQTT Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/http-digital-adapter/>HTTP Digital Adapter</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-bf647454e36069fd16f1a7a35cf6a865 aria-expanded=true>
+Getting Started</button><div class="collapse show" id=section-bf647454e36069fd16f1a7a35cf6a865><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/physical-adapter/>Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/shadowing-function/>Shadowing Function</a></li><li><a class="docs-link rounded active" href=https://wldt.github.io/docs/guides/digital-adapter/>Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/>DT Engine & DT Instance</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-actions/>Digital Actions</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/configurable-adapters/>Configurable Adapters</a></li></ul></div></li></ul></nav></div><nav class="docs-toc d-none d-xl-block col-xl-3" aria-label="Secondary navigation"><div class=page-links></div></nav><main class="docs-content col-lg-11 col-xl-9"><nav aria-label=breadcrumb><ol class=breadcrumb><li class=breadcrumb-item><a href=https://wldt.github.io/>Home</a></li><li class=breadcrumb-item><a href=https://wldt.github.io/docs/>Docs</a></li><li class=breadcrumb-item><a href=https://wldt.github.io/docs/guides/>Getting Started</a></li><li class="breadcrumb-item active" aria-current=page>Digital Adapter</li></ol></nav><h1>Digital Adapter</h1><nav class="toc-mobile d-xl-none" aria-label="Quaternary navigation"></nav><p>The las component that we have to implement to complete our first simple Digital Twin definition through the WLDT library is a
+Digital Adapter in charge of:</p><ul><li>Receiving event from the DT&rsquo;s Core related to the variation of properties, events, available actions and relationships</li><li>Expose received information to the external world according to its implementation and the supported protocol</li><li>Handle incoming digital action and forward them to the Core in order to be validated and processed by the Shadowing Function</li></ul><p>The basic library class that we are going to extend is called <code>DigitalAdapter</code> and creating a new class
+named <code>DemoDigitalAdapter</code>. The DigitalTwinAdapter class can take as Generic Type the type of Configuration used to configure its behaviours.
+In this simplified example we are defining a DigitalAdapter without any Configuration.</p><p>A Digital Adapter has direct access to the current DT&rsquo;s State through callbacks or directly in a synchronous way using the
+internal variable called: <code>digitalTwinState</code>. Through it is possibile to navigate all the fields currently composing the state of our Digital Twin.</p><p>The Digital Adapter class has e long list of callback and notification method to allow
+the adapter to be updated about all the variation and changes on the twin.
+Available callbacks can be summarized as follows:</p><ul><li>Digital Adapter Start/Stop:<ul><li><code>onAdapterStart()</code>: Feedback when the Digital Adapter correctly starts</li><li><code>onAdapterStop()</code>: Feedback when the Digital Adapter has been stopped</li></ul></li><li>Digital Twin Life Cycle Notifications:<ul><li><code>onDigitalTwinCreate()</code>: The DT has been created</li><li><code>onDigitalTwinStart()</code>: The DT started</li><li><code>onDigitalTwinSync(IDigitalTwinState digitalTwinState)</code>: The DT is Synchronized with its physical counterpart.
+The current DigitalTwinState is passed as parameter to allow the Digital Adapter to know the current state and consequently
+implement its behaviour</li><li><code>onDigitalTwinUnSync(IDigitalTwinState digitalTwinState)</code>: The DT is not synchronized anymore with its physical counterpart.
+The last current DigitalTwinState is passed as parameter to allow the Digital Adapter to know the last state and consequently
+implement its behaviour</li><li><code>onDigitalTwinStop()</code>: The DT is stopped</li><li><code>onDigitalTwinDestroy()</code>: The DT has been destroyed and the application stopped</li></ul></li></ul><p>The Digital Adapter DT State variations and DT events are received by the Adapter from the DT core belongs to the following categories:</p><ul><li><strong>Digital Twin State Update</strong> through the method <code>onStateUpdate(...)</code> providing information about the new state of the Digital Twin,
+the previous state, and a list of changes that occurred between these two states. In the previous version each variation of a property,
+relationships, actions or events were notified. In the new version only a committed DT&rsquo;State variation is notified to listeners.</li><li><strong>Event Notifications</strong> through the method <code>onEventNotificationReceived(...)</code> whenever there is a notification about an event related to the
+Digital Twin&rsquo;s state coming from the physical world, generated by the twin and processed by the Shadowing Function.
+For example in the DT State we can have the declaration of the <code>over-heating-alert</code> structured and received in the
+DT State while the effective occurrence of the event and the associated notification is notified through this dedicated callback</li></ul><p>The <code>onStateUpdate</code> method is an abstract method that must be implemented by any class extending the <code>DigitalAdapter</code> class.
+This method is called whenever there is an update to the Digital Twin&rsquo;s state. It provides information about the new state of the Digital Twin,
+the previous state, and a list of changes that occurred between these two states.</p><p>The explanation of the parameters is the following:</p><ol><li><code>newDigitalTwinState</code>: This parameter represents the updated state of the Digital Twin. It is an instance of the <code>DigitalTwinState</code> class, which encapsulates the current state information.</li><li><code>previousDigitalTwinState</code>: This parameter represents the state of the Digital Twin before the update. It is also an instance of the <code>DigitalTwinState</code> class.</li><li><code>digitalTwinStateChangeList</code>: This parameter is an <code>ArrayList</code> containing <code>DigitalTwinStateChange</code> objects. Each <code>DigitalTwinStateChange</code> object encapsulates information about a specific change that occurred between the previous and new states. It includes details such as the property or aspect of the state that changed, the previous value, and the new value.</li></ol><p>Another core method where a Digital Adapter receive the description of the DT&rsquo;State is <code>onDigitalTwinSync(IDigitalTwinState digitalTwinState)</code>.
+The Adapter using the parameter <code>digitalTwinState</code> can analyze available properties, actions, events and relationships and decide how to implement its internal behaviour with the methods presented in <a href=#shadowing-function>ShadowingFunction</a>.
+The DT State is automatically monitored by each Digital Adapter while for the Events potentially generated by the DT can be observed by each adapter using:</p><ul><li><code>observeAllDigitalTwinEventsNotifications</code>: Enable the observation of available Digital Twin State Events Notifications.</li><li><code>unObserveAllDigitalTwinEventsNotifications</code>: Cancel the observation of Digital Twin State Events Notifications</li><li><code>observeDigitalTwinEventsNotifications</code>: Enable the observation of the notification associated to a specific list of Digital Twin State events. With respect to event a notification contains the new associated value</li><li><code>unObserveDigitalTwinEventsNotifications</code>: Cancel the observation of a target list of properties</li><li><code>observeDigitalTwinEventNotification</code>: Enable the observation of the notification associated to a single Digital Twin State event. With respect to event a notification contains the new associated value</li><li><code>unObserveDigitalTwinEventNotification</code>: Cancel the observation of a single target event</li></ul><p>The resulting code will be the following after adding the required
+methods (still empty) and the basic constructor with the id String parameter is the following:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=kn>import</span> <span class=nn>it.wldt.adapter.digital.DigitalAdapter</span><span class=o>;</span>
+</span></span><span class=line><span class=cl><span class=kn>import</span> <span class=nn>it.wldt.core.state.*</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=kd>public</span> <span class=kd>class</span> <span class=nc>DemoDigitalAdapter</span> <span class=kd>extends</span> <span class=n>DigitalAdapter</span><span class=o>&lt;</span><span class=n>Void</span><span class=o>&gt;</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=kd>public</span> <span class=nf>DemoDigitalAdapter</span><span class=o>(</span><span class=n>String</span> <span class=n>id</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        <span class=kd>super</span><span class=o>(</span><span class=n>id</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=cm>/**
+</span></span></span><span class=line><span class=cl><span class=cm>     * Callback to notify the adapter on its correct startup
+</span></span></span><span class=line><span class=cl><span class=cm>     */</span>
+</span></span><span class=line><span class=cl>    <span class=nd>@Override</span>
+</span></span><span class=line><span class=cl>    <span class=kd>public</span> <span class=kt>void</span> <span class=nf>onAdapterStart</span><span class=o>()</span> <span class=o>{}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=cm>/**
+</span></span></span><span class=line><span class=cl><span class=cm>     * Callback to notify the adapter that has been stopped
+</span></span></span><span class=line><span class=cl><span class=cm>     */</span>
+</span></span><span class=line><span class=cl>    <span class=nd>@Override</span>
+</span></span><span class=line><span class=cl>    <span class=kd>public</span> <span class=kt>void</span> <span class=nf>onAdapterStop</span><span class=o>()</span> <span class=o>{}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=cm>/**
+</span></span></span><span class=line><span class=cl><span class=cm>     * DT Life Cycle notification that the DT is correctly on Sync
+</span></span></span><span class=line><span class=cl><span class=cm>     * @param digitalTwinState
+</span></span></span><span class=line><span class=cl><span class=cm>     */</span>
+</span></span><span class=line><span class=cl>    <span class=nd>@Override</span>
+</span></span><span class=line><span class=cl>    <span class=kd>public</span> <span class=kt>void</span> <span class=nf>onDigitalTwinSync</span><span class=o>(</span><span class=n>DigitalTwinState</span> <span class=n>digitalTwinState</span><span class=o>)</span> <span class=o>{}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=cm>/**
+</span></span></span><span class=line><span class=cl><span class=cm>     * DT Life Cycle notification that the DT is currently Not Sync
+</span></span></span><span class=line><span class=cl><span class=cm>     * @param digitalTwinState
+</span></span></span><span class=line><span class=cl><span class=cm>     */</span>
+</span></span><span class=line><span class=cl>    <span class=nd>@Override</span>
+</span></span><span class=line><span class=cl>    <span class=kd>public</span> <span class=kt>void</span> <span class=nf>onDigitalTwinUnSync</span><span class=o>(</span><span class=n>DigitalTwinState</span> <span class=n>digitalTwinState</span><span class=o>)</span> <span class=o>{}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=cm>/**
+</span></span></span><span class=line><span class=cl><span class=cm>     * DT Life Cycle notification that the DT has been created
+</span></span></span><span class=line><span class=cl><span class=cm>     */</span>
+</span></span><span class=line><span class=cl>    <span class=nd>@Override</span>
+</span></span><span class=line><span class=cl>    <span class=kd>public</span> <span class=kt>void</span> <span class=nf>onDigitalTwinCreate</span><span class=o>()</span> <span class=o>{}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=cm>/**
+</span></span></span><span class=line><span class=cl><span class=cm>     * DT Life Cycle Notification that the DT has correctly Started
+</span></span></span><span class=line><span class=cl><span class=cm>     */</span>
+</span></span><span class=line><span class=cl>    <span class=nd>@Override</span>
+</span></span><span class=line><span class=cl>    <span class=kd>public</span> <span class=kt>void</span> <span class=nf>onDigitalTwinStart</span><span class=o>()</span> <span class=o>{}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=cm>/**
+</span></span></span><span class=line><span class=cl><span class=cm>     * DT Life Cycle Notification that the DT has been stopped
+</span></span></span><span class=line><span class=cl><span class=cm>     */</span>
+</span></span><span class=line><span class=cl>    <span class=nd>@Override</span>
+</span></span><span class=line><span class=cl>    <span class=kd>public</span> <span class=kt>void</span> <span class=nf>onDigitalTwinStop</span><span class=o>()</span> <span class=o>{}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=cm>/**
+</span></span></span><span class=line><span class=cl><span class=cm>     * DT Life Cycle Notification that the DT has destroyed
+</span></span></span><span class=line><span class=cl><span class=cm>     */</span>
+</span></span><span class=line><span class=cl>    <span class=nd>@Override</span>
+</span></span><span class=line><span class=cl>    <span class=kd>public</span> <span class=kt>void</span> <span class=nf>onDigitalTwinDestroy</span><span class=o>()</span> <span class=o>{}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=cm>/**
+</span></span></span><span class=line><span class=cl><span class=cm>     * Callback method allowing the Digital Adapter to receive the updated Digital Twin State together with
+</span></span></span><span class=line><span class=cl><span class=cm>     * the previous state and the list of applied changes
+</span></span></span><span class=line><span class=cl><span class=cm>     *
+</span></span></span><span class=line><span class=cl><span class=cm>     * @param newDigitalTwinState The new Digital Twin State computed by the Shadowing Function
+</span></span></span><span class=line><span class=cl><span class=cm>     * @param previousDigitalTwinState The previous Digital Twin State
+</span></span></span><span class=line><span class=cl><span class=cm>     * @param digitalTwinStateChangeList The list of applied changes to compute the new Digital Twin State
+</span></span></span><span class=line><span class=cl><span class=cm>     */</span>
+</span></span><span class=line><span class=cl>    <span class=nd>@Override</span>
+</span></span><span class=line><span class=cl>    <span class=kd>protected</span> <span class=kt>void</span> <span class=nf>onStateUpdate</span><span class=o>(</span><span class=n>DigitalTwinState</span> <span class=n>newDigitalTwinState</span><span class=o>,</span> <span class=n>DigitalTwinState</span> <span class=n>previousDigitalTwinState</span><span class=o>,</span> <span class=n>ArrayList</span><span class=o>&lt;</span><span class=n>DigitalTwinStateChange</span><span class=o>&gt;</span> <span class=n>digitalTwinStateChangeList</span><span class=o>)</span> <span class=o>{}</span>
+</span></span><span class=line><span class=cl>  
+</span></span><span class=line><span class=cl>    <span class=cm>/**
+</span></span></span><span class=line><span class=cl><span class=cm>     * Callback method to receive a new computed Event Notification (associated to event declared in the DT State)
+</span></span></span><span class=line><span class=cl><span class=cm>     *
+</span></span></span><span class=line><span class=cl><span class=cm>     * @param digitalTwinStateEventNotification The generated Notification associated to a DT Event
+</span></span></span><span class=line><span class=cl><span class=cm>     */</span>
+</span></span><span class=line><span class=cl>    <span class=nd>@Override</span>
+</span></span><span class=line><span class=cl>    <span class=kd>protected</span> <span class=kt>void</span> <span class=nf>onEventNotificationReceived</span><span class=o>(</span><span class=n>DigitalTwinStateEventNotification</span><span class=o>&lt;?&gt;</span> <span class=n>digitalTwinStateEventNotification</span><span class=o>)</span> <span class=o>{}</span>
+</span></span><span class=line><span class=cl><span class=o>}</span>
+</span></span></code></pre></div><p>By default, a Digital Adapter observes all the variation on the DT&rsquo;s State in terms of Properties, Relationships, Actions and Events.
+As previously mentioned the observation of DT&rsquo;s State Properties allows to receive also properties variation on the method since a property is natively composed by its description (e.g., type) and its
+current value. On the opposite the observation on DT&rsquo;s State Action, Relationships and Events allow ONLY to receive callbacks when a new entity is added or an update is occurred without receiving updates on values variation.</p><p>The only thing that we should add in the <code>onDigitalTwinSync(IDigitalTwinState currentDigitalTwinState)</code> callback is the direct observation for Events.
+Following this approach we can change our Digital Adapter in the following methods:</p><p>In <code>onDigitalTwinSync</code> we observe in this first simple implementation only the incoming values for declared Events in the DT&rsquo;State.
+As previously mentioned the observation of any variation of the State structure together with Properties Values are by default observed by any Digital Adapter.
+In this method we use the internal variable <code>digitalTwinState</code> to access the DT&rsquo;s state and find available Events declaration that we would like to observe.</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=kd>public</span> <span class=kt>void</span> <span class=nf>onDigitalTwinSync</span><span class=o>(</span><span class=n>IDigitalTwinState</span> <span class=n>currentDigitalTwinState</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>      <span class=k>try</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>          
+</span></span><span class=line><span class=cl>          <span class=c1>//Retrieve the list of available events and observe all variations
+</span></span></span><span class=line><span class=cl><span class=c1></span>          <span class=n>digitalTwinState</span><span class=o>.</span><span class=na>getEventList</span><span class=o>()</span>
+</span></span><span class=line><span class=cl>                  <span class=o>.</span><span class=na>map</span><span class=o>(</span><span class=n>eventList</span> <span class=o>-&gt;</span> <span class=n>eventList</span><span class=o>.</span><span class=na>stream</span><span class=o>()</span>
+</span></span><span class=line><span class=cl>                          <span class=o>.</span><span class=na>map</span><span class=o>(</span><span class=n>DigitalTwinStateEvent</span><span class=o>::</span><span class=n>getKey</span><span class=o>)</span>
+</span></span><span class=line><span class=cl>                          <span class=o>.</span><span class=na>collect</span><span class=o>(</span><span class=n>Collectors</span><span class=o>.</span><span class=na>toList</span><span class=o>()))</span>
+</span></span><span class=line><span class=cl>                  <span class=o>.</span><span class=na>ifPresent</span><span class=o>(</span><span class=n>eventKeys</span> <span class=o>-&gt;</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>                      <span class=k>try</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>                          <span class=n>observeDigitalTwinEventsNotifications</span><span class=o>(</span><span class=n>eventKeys</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>                      <span class=o>}</span> <span class=k>catch</span> <span class=o>(</span><span class=n>EventBusException</span> <span class=n>e</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>                          <span class=n>e</span><span class=o>.</span><span class=na>printStackTrace</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>                      <span class=o>}</span>
+</span></span><span class=line><span class=cl>                  <span class=o>});</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>      <span class=o>}</span> <span class=k>catch</span> <span class=o>(</span><span class=n>Exception</span> <span class=n>e</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>          <span class=n>e</span><span class=o>.</span><span class=na>printStackTrace</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>      <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>  <span class=o>}</span>
+</span></span></code></pre></div><p>Developers extending the <code>DigitalAdapter</code> class should implement the <code>onStateUpdate</code> method to define custom logic that
+needs to be executed whenever the state of the Digital Twin is updated. This could include tasks such as processing state changes, updating internal variables, triggering specific actions, or notifying other components about the state update.</p><p>Here&rsquo;s an example of how the method might be implemented in a concrete subclass of <code>DigitalAdapter</code>:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=nd>@Override</span>
+</span></span><span class=line><span class=cl><span class=kd>protected</span> <span class=kt>void</span> <span class=nf>onStateUpdate</span><span class=o>(</span><span class=n>DigitalTwinState</span> <span class=n>newDigitalTwinState</span><span class=o>,</span>
+</span></span><span class=line><span class=cl>                              <span class=n>DigitalTwinState</span> <span class=n>previousDigitalTwinState</span><span class=o>,</span>
+</span></span><span class=line><span class=cl>                              <span class=n>ArrayList</span><span class=o>&lt;</span><span class=n>DigitalTwinStateChange</span><span class=o>&gt;</span> <span class=n>digitalTwinStateChangeList</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>	<span class=c1>// In newDigitalTwinState we have the new DT State
+</span></span></span><span class=line><span class=cl><span class=c1></span>	<span class=n>System</span><span class=o>.</span><span class=na>out</span><span class=o>.</span><span class=na>println</span><span class=o>(</span><span class=s>&#34;New DT State is: &#34;</span> <span class=o>+</span> <span class=n>newDigitalTwinState</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>	<span class=c1>// The previous DT State is available through the variable previousDigitalTwinState
+</span></span></span><span class=line><span class=cl><span class=c1></span>	<span class=n>System</span><span class=o>.</span><span class=na>out</span><span class=o>.</span><span class=na>println</span><span class=o>(</span><span class=s>&#34;Previous DT State is: &#34;</span> <span class=o>+</span> <span class=n>previousDigitalTwinState</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=c1>// We can also check each DT&#39;s state change potentially differentiating the behaviour for each change
+</span></span></span><span class=line><span class=cl><span class=c1></span>    <span class=k>if</span> <span class=o>(</span><span class=n>digitalTwinStateChangeList</span> <span class=o>!=</span> <span class=kc>null</span> <span class=o>&amp;&amp;</span> <span class=o>!</span><span class=n>digitalTwinStateChangeList</span><span class=o>.</span><span class=na>isEmpty</span><span class=o>())</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        
+</span></span><span class=line><span class=cl>        <span class=c1>// Iterate through each state change in the list
+</span></span></span><span class=line><span class=cl><span class=c1></span>        <span class=k>for</span> <span class=o>(</span><span class=n>DigitalTwinStateChange</span> <span class=n>stateChange</span> <span class=o>:</span> <span class=n>digitalTwinStateChangeList</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>            
+</span></span><span class=line><span class=cl>            <span class=c1>// Get information from the state change
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=n>DigitalTwinStateChange</span><span class=o>.</span><span class=na>Operation</span> <span class=n>operation</span> <span class=o>=</span> <span class=n>stateChange</span><span class=o>.</span><span class=na>getOperation</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>            <span class=n>DigitalTwinStateChange</span><span class=o>.</span><span class=na>ResourceType</span> <span class=n>resourceType</span> <span class=o>=</span> <span class=n>stateChange</span><span class=o>.</span><span class=na>getResourceType</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>            <span class=n>DigitalTwinStateResource</span> <span class=n>resource</span> <span class=o>=</span> <span class=n>stateChange</span><span class=o>.</span><span class=na>getResource</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>            
+</span></span><span class=line><span class=cl>            <span class=c1>// Perform different actions based on the type of operation
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=k>switch</span> <span class=o>(</span><span class=n>operation</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>                <span class=k>case</span> <span class=n>OPERATION_UPDATE</span><span class=o>:</span>
+</span></span><span class=line><span class=cl>                    <span class=c1>// Handle an update operation
+</span></span></span><span class=line><span class=cl><span class=c1></span>                    <span class=n>System</span><span class=o>.</span><span class=na>out</span><span class=o>.</span><span class=na>println</span><span class=o>(</span><span class=s>&#34;Update operation on &#34;</span> <span class=o>+</span> <span class=n>resourceType</span> <span class=o>+</span> <span class=s>&#34;: &#34;</span> <span class=o>+</span> <span class=n>resource</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>                    <span class=k>break</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>                <span class=k>case</span> <span class=n>OPERATION_UPDATE_VALUE</span><span class=o>:</span>
+</span></span><span class=line><span class=cl>                    <span class=c1>// Handle an update value operation
+</span></span></span><span class=line><span class=cl><span class=c1></span>                    <span class=n>System</span><span class=o>.</span><span class=na>out</span><span class=o>.</span><span class=na>println</span><span class=o>(</span><span class=s>&#34;Update value operation on &#34;</span> <span class=o>+</span> <span class=n>resourceType</span> <span class=o>+</span> <span class=s>&#34;: &#34;</span> <span class=o>+</span> <span class=n>resource</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>                    <span class=k>break</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>                <span class=k>case</span> <span class=n>OPERATION_ADD</span><span class=o>:</span>
+</span></span><span class=line><span class=cl>                    <span class=c1>// Handle an add operation
+</span></span></span><span class=line><span class=cl><span class=c1></span>                    <span class=n>System</span><span class=o>.</span><span class=na>out</span><span class=o>.</span><span class=na>println</span><span class=o>(</span><span class=s>&#34;Add operation on &#34;</span> <span class=o>+</span> <span class=n>resourceType</span> <span class=o>+</span> <span class=s>&#34;: &#34;</span> <span class=o>+</span> <span class=n>resource</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>                    <span class=k>break</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>                <span class=k>case</span> <span class=n>OPERATION_REMOVE</span><span class=o>:</span>
+</span></span><span class=line><span class=cl>                    <span class=c1>// Handle a remove operation
+</span></span></span><span class=line><span class=cl><span class=c1></span>                    <span class=n>System</span><span class=o>.</span><span class=na>out</span><span class=o>.</span><span class=na>println</span><span class=o>(</span><span class=s>&#34;Remove operation on &#34;</span> <span class=o>+</span> <span class=n>resourceType</span> <span class=o>+</span> <span class=s>&#34;: &#34;</span> <span class=o>+</span> <span class=n>resource</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>                    <span class=k>break</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>                <span class=k>default</span><span class=o>:</span>
+</span></span><span class=line><span class=cl>                    <span class=c1>// Handle unknown operation (optional)
+</span></span></span><span class=line><span class=cl><span class=c1></span>                    <span class=n>System</span><span class=o>.</span><span class=na>out</span><span class=o>.</span><span class=na>println</span><span class=o>(</span><span class=s>&#34;Unknown operation on &#34;</span> <span class=o>+</span> <span class=n>resourceType</span> <span class=o>+</span> <span class=s>&#34;: &#34;</span> <span class=o>+</span> <span class=n>resource</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>                    <span class=k>break</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>            <span class=o>}</span>
+</span></span><span class=line><span class=cl>        <span class=o>}</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span> <span class=k>else</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        <span class=c1>// No state changes
+</span></span></span><span class=line><span class=cl><span class=c1></span>        <span class=n>System</span><span class=o>.</span><span class=na>out</span><span class=o>.</span><span class=na>println</span><span class=o>(</span><span class=s>&#34;No state changes detected.&#34;</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl><span class=o>}</span>
+</span></span></code></pre></div><p>In this example, the method iterates over the list of state changes, extracts information about each change, and performs custom actions based on the changes.
+Developers can adapt this method to suit the specific requirements of their Digital Twin application.</p><div class="page-footer-meta d-flex flex-column flex-md-row justify-content-between"><div class=last-modified><a href=https://github.com/wldt/wldt.github.io/commit/ab5a164de259055162e9420d8cb56c2b1562dee9><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-calendar"><rect x="3" y="4" width="18" height="18" rx="2" ry="2"/><line x1="16" y1="2" x2="16" y2="6"/><line x1="8" y1="2" x2="8" y2="6"/><line x1="3" y1="10" x2="21" y2="10"/></svg>Last updated on February 9, 2024</a></div><div class=edit-page><a href=https://github.com/wldt/wldt.github.io/blob/main/content//docs/guides/digital-adapter.md><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-edit-2"><path d="M17 3a2.828 2.828.0 114 4L7.5 20.5 2 22l1.5-5.5L17 3z"/></svg>Edit this page on GitHub</a></div></div><div class="page-nav d-flex flex-column flex-sm-row"><div class="card w-100"><div class="card-body d-flex"><div class="d-flex flex-column justify-content-center"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-arrow-left" width="20" height="20" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 12h14"/><path d="M5 12l6 6"/><path d="M5 12l6-6"/></svg></div><div class="d-flex flex-column"><div class=text-body-secondary>Prev</div><a href=https://wldt.github.io/docs/guides/shadowing-function/ class="stretched-link text-reset text-decoration-none">Shadowing Function</a></div></div></div><div class=m-2></div><div class="card text-end w-100"><div class="card-body d-flex justify-content-end"><div class="d-flex flex-column"><div class=text-body-secondary>Next</div><a href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/ class="stretched-link text-reset text-decoration-none">DT Engine & DT Instance</a></div><div class="d-flex flex-column justify-content-center"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-arrow-right" width="20" height="20" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 12h14"/><path d="M13 18l6-6"/><path d="M13 6l6 6"/></svg></div></div></div></div></main></div></div></div><footer class="footer text-muted"><div class=container-lg><div class=row><div class="col-lg-8 text-center text-lg-start"><ul class=list-inline><li class=list-inline-item><a class=text-muted href=https://wldt.github.io/privacy/>Privacy Policy</a></li></ul></div><div class="col-lg-8 text-center text-lg-end"><ul class=list-inline><li class=list-inline-item>Brought to you by <a class=text-muted href=https://gethyas.com/>Hyas</a></li></ul></div></div></div></footer><script async src=https://wldt.github.io/js/app.1e84dcdaa5ccef6fe83f6d88ac1e444a1f237111cfa2a7a97427f758e9c27ef4.js integrity="sha256-HoTc2qXM72/oP22IrB5ESh8jcRHPoqepdCf3WOnCfvQ="></script>
+<script async src=https://wldt.github.io/js/flexsearch.dc00caef2c3490dbab3c345ed0d4133b0aafb803efeb21c3df80776d6d3ea821.js integrity="sha256-3ADK7yw0kNurPDRe0NQTOwqvuAPv6yHD34B3bW0+qCE="></script><script async src=https://wldt.github.io/js/search-modal.c4c023efcdee308e4b5f1110afe1db6b1656f217e67aa7efe54e2f4bf2feccf8.js integrity="sha256-xMAj783uMI5LXxEQr+HbaxZW8hfmeqfv5U4vS/L+zPg="></script><div class="d-inline-flex fixed-bottom-right pb-4 pe-4"><button id=toTop type=button class="btn btn-primary rounded-circle ms-auto p-2"><span class=visually-hidden>Top</span><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-chevron-up" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M6 15l6-6 6 6"/></svg></button></div></body></html>
\ No newline at end of file
diff --git a/docs/guides/dt-engine-dt-instance/index.html b/docs/guides/dt-engine-dt-instance/index.html
new file mode 100644
index 0000000..7214034
--- /dev/null
+++ b/docs/guides/dt-engine-dt-instance/index.html
@@ -0,0 +1,91 @@
+<!doctype html><html lang=en data-bs-theme=auto><head><meta charset=utf-8><meta http-equiv=x-ua-compatible content="ie=edge"><meta name=viewport content="width=device-width,initial-scale=1"><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-regular.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-500.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-700.woff2 type=font/woff2 crossorigin><script src=https://wldt.github.io/js/color-mode.86a91f050a481d0a3f0c72ac26543cb6228c770875981c58dcbc008fd3f875c8.js integrity="sha256-hqkfBQpIHQo/DHKsJlQ8tiKMdwh1mBxY3LwAj9P4dcg="></script>
+<link rel=stylesheet href=https://wldt.github.io/main.5fb433a44687c98f7ae7b3d0137c762777049ba27235e1f08c279c03c8533a7a9a1e3b0ef5b125a31b6bb63a362cdcbc39c3706ed41ad7f1a620b9281013866c.css integrity="sha512-X7QzpEaHyY9657PQE3x2J3cEm6JyNeHwjCecA8hTOnqaHjsO9bEloxtrtjo2LNy8OcNwbtQa1/GmILkoEBOGbA==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>DT Engine & DT Instance | WLDT</title><meta property="canonical" content="https://wldt.github.io/docs/guides/dt-engine-dt-instance/"><meta name=description content="Now that we have created the main fundamental element of a DT (Physical Adapter, Shadowing Function and Digital Adapter) we can create Class file with a main to create the WLDT Engine with the created components and start the DT."><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/docs/guides/dt-engine-dt-instance/"><meta property="og:title" content="DT Engine & DT Instance"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:section" content="docs"><meta property="og:description" content="Now that we have created the main fundamental element of a DT (Physical Adapter, Shadowing Function and Digital Adapter) we can create Class file with a main to create the WLDT Engine with the created components and start the DT."><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-model/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-life-cycle/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/library-structure-basic-concepts/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/physical-adapter/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/shadowing-function/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/digital-adapter/"><meta name=twitter:card content="summary"><meta name=twitter:title content="DT Engine & DT Instance"><meta name=twitter:description content="Now that we have created the main fundamental element of a DT (Physical Adapter, Shadowing Function and Digital Adapter) we can create Class file with a main to create the WLDT Engine with the created components and start the DT."><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","item":"https://wldt.github.io/docs/","name":"Docs","position":2},{"@type":"ListItem","item":"https://wldt.github.io/docs/guides/","name":"Getting Started","position":3},{"@type":"ListItem","name":"DT Engine \u0026 DT Instance","position":4}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="single section docs" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
+<button type=button id=searchToggleMobile class="btn btn-link nav-link mx-2 d-lg-none" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button class="btn btn-link d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavSection aria-controls=offcanvasNavSection aria-label="Open section navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-dots-vertical" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 19m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 5m-1 0a1 1 0 102 0 1 1 0 10-2 0"/></svg></button><div class="offcanvas offcanvas-start d-lg-none" tabindex=-1 id=offcanvasNavSection aria-labelledby=offcanvasNavSectionLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavSectionLabel>Docs</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class=offcanvas-body><aside class="doks-sidebar mt-n3"><nav id=doks-docs-nav aria-label="Tertiary navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-0b79795d3efc95b9976c7c5b933afce2 aria-expanded=false>
+Introduction</button><div class=collapse id=section-0b79795d3efc95b9976c7c5b933afce2><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-model/>DT Model</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-life-cycle/>DT Life Cycle</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/>Library Structure & Basic Concepts</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-3978929206deee2c125a1d732aae5545 aria-expanded=false>
+Change Logs</button><div class=collapse id=section-3978929206deee2c125a1d732aae5545><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/>Change Log 0.3.0</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-89413bd312d0909efb85e6693f36cb89 aria-expanded=false>
+Adapters</button><div class=collapse id=section-89413bd312d0909efb85e6693f36cb89><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/>MQTT Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/>MQTT Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/http-digital-adapter/>HTTP Digital Adapter</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-bf647454e36069fd16f1a7a35cf6a865 aria-expanded=true>
+Getting Started</button><div class="collapse show" id=section-bf647454e36069fd16f1a7a35cf6a865><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/physical-adapter/>Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/shadowing-function/>Shadowing Function</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-adapter/>Digital Adapter</a></li><li><a class="docs-link rounded active" href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/>DT Engine & DT Instance</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-actions/>Digital Actions</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/configurable-adapters/>Configurable Adapters</a></li></ul></div></li></ul></nav></aside></div></div><button class="btn btn-link nav-link mx-2 order-3 d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavMain aria-controls=offcanvasNavMain aria-label="Open main navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-menu" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><line x1="4" y1="8" x2="20" y2="8"/><line x1="4" y1="16" x2="20" y2="16"/></svg></button><div class="offcanvas offcanvas-end h-auto" tabindex=-1 id=offcanvasNavMain aria-labelledby=offcanvasNavMainLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavMainLabel>WLDT</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class="offcanvas-body d-flex flex-column flex-lg-row justify-content-between"><ul class="navbar-nav flex-grow-1"><li class=nav-item><a class=nav-link href=https://wldt.github.io/docs/guides/example-guide/>Documentation</a></li><li class=nav-item><a class=nav-link href=https://wldt.github.io/blog/>Blog</a></li></ul><button type=button id=searchToggleDesktop class="btn btn-link nav-link p-2 d-none d-lg-block" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button id=buttonColorMode class="btn btn-link mx-auto nav-link p-0 ms-lg-2 me-lg-1" type=button aria-label="Toggle theme"><svg data-bs-theme-value="dark" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-moon" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 3c.132.0.263.0.393.0a7.5 7.5.0 007.92 12.446A9 9 0 1112 2.992z"/></svg><svg data-bs-theme-value="light" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-sun" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-4 0a4 4 0 108 0 4 4 0 10-8 0m-5 0h1m8-9v1m8 8h1m-9 8v1M5.6 5.6l.7.7m12.1-.7-.7.7m0 11.4.7.7m-12.1-.7-.7.7"/></svg></button><ul id=socialMenu class="nav mx-auto flex-row order-lg-4"><li class=nav-item><a class="nav-link social-link" href=https://github.com/wldt><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-brand-github" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 19c-4.3 1.4-4.3-2.5-6-3m12 5v-3.5c0-1 .1-1.4-.5-2 2.8-.3 5.5-1.4 5.5-6a4.6 4.6.0 00-1.3-3.2 4.2 4.2.0 00-.1-3.2s-1.1-.3-3.5 1.3a12.3 12.3.0 00-6.2.0C6.5 2.8 5.4 3.1 5.4 3.1a4.2 4.2.0 00-.1 3.2A4.6 4.6.0 004 9.5c0 4.6 2.7 5.7 5.5 6-.6.6-.6 1.2-.5 2V21"/></svg><small class="ms-2 visually-hidden">GitHub</small></a></li></ul></div></div></div></header></div><div class=modal id=searchModal tabindex=-1 aria-labelledby=searchModalLabel aria-hidden=true><div class="modal-dialog modal-dialog-scrollable modal-fullscreen-md-down"><div class=modal-content><div class=modal-header><h1 class="modal-title fs-5 visually-hidden" id=searchModalLabel>Search</h1><button type=button class="btn-close visually-hidden" data-bs-dismiss=modal aria-label=Close></button><div class="search-input flex-grow-1 d-none"><form id=search-form class=search-form action=# method=post accept-charset=utf-8 role=search><label for=query class=visually-hidden>Search</label><div class=d-flex><input type=search id=query name=query class="search-text form-control form-control-lg" placeholder=Search aria-label=Search maxlength=128 autocomplete=off>
+<button type=button class="btn btn-link text-decoration-none px-0 ms-3 d-md-none" data-bs-dismiss=modal aria-label=Close>Cancel</button></div></form></div></div><div class=modal-body><p class="search-loading status message d-none mt-3 text-center">Loading search index…</p><p class="search-no-recent message d-none mt-3 text-center">No recent searches</p><p class="search-no-results message d-none mt-3 text-center">No results for "<strong><span class=query-no-results>Query here</span></strong>"</p><div id=searchResults class=search-results></div><template><article class="search-result list-view"><div class="card my-3"><div class=card-body><header><h2 class="h5 title title-submitted mb-0"><a class="stretched-link text-decoration-none text-reset" href=#>Title here</a></h2><div class="submitted d-none"><time class=created-date>Date here</time></div></header><div class=content>Summary here</div></div></div></article></template></div><div class=modal-footer><ul class="list-inline me-auto d-none d-md-block"><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Enter key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M12 3.53088v3c0 1-1 2-2 2H4m3 3-3-3 3-3"/></g></svg></kbd><span class=DocSearch-Label>to select</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Arrow down" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 3.5v8m3-3-3 3-3-3"/></g></svg></kbd><kbd class=me-2><svg width="15" height="15" aria-label="Arrow up" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 11.5v-8m3 3-3-3-3 3"/></g></svg></kbd><span class=DocSearch-Label>to navigate</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Escape key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M13.6167 8.936c-.1065.3583-.6883.962-1.4875.962-.7993.0-1.653-.9165-1.653-2.1258v-.5678c0-1.2548.7896-2.1016 1.653-2.1016s1.3601.4778 1.4875 1.0724M9 6c-.1352-.4735-.7506-.9219-1.46-.8972-.7092.0246-1.344.57-1.344 1.2166s.4198.8812 1.3445.9805C8.465 7.3992 8.968 7.9337 9 8.5s-.454 1.398-1.4595 1.398C6.6593 9.898 6 9 5.963 8.4851m-1.4748.5368c-.2635.5941-.8099.876-1.5443.876s-1.7073-.6248-1.7073-2.204v-.4603c0-1.0416.721-2.131 1.7073-2.131.9864.0 1.6425 1.031 1.5443 2.2492h-2.956"/></g></svg></kbd><span class=DocSearch-Label>to close</span></li></ul><p class=d-md-none>Search by <a class=text-decoration-none href=https://github.com/nextapps-de/flexsearch>FlexSearch</a></p></div></div></div></div><div class="wrap container-lg" role=document><div class=content><div class="row flex-xl-nowrap"><div class="col-lg-5 col-xl-4 docs-sidebar d-none d-lg-block"><nav class=docs-links aria-label="Main navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-0b79795d3efc95b9976c7c5b933afce2 aria-expanded=false>
+Introduction</button><div class=collapse id=section-0b79795d3efc95b9976c7c5b933afce2><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-model/>DT Model</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-life-cycle/>DT Life Cycle</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/>Library Structure & Basic Concepts</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-3978929206deee2c125a1d732aae5545 aria-expanded=false>
+Change Logs</button><div class=collapse id=section-3978929206deee2c125a1d732aae5545><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/>Change Log 0.3.0</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-89413bd312d0909efb85e6693f36cb89 aria-expanded=false>
+Adapters</button><div class=collapse id=section-89413bd312d0909efb85e6693f36cb89><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/>MQTT Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/>MQTT Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/http-digital-adapter/>HTTP Digital Adapter</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-bf647454e36069fd16f1a7a35cf6a865 aria-expanded=true>
+Getting Started</button><div class="collapse show" id=section-bf647454e36069fd16f1a7a35cf6a865><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/physical-adapter/>Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/shadowing-function/>Shadowing Function</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-adapter/>Digital Adapter</a></li><li><a class="docs-link rounded active" href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/>DT Engine & DT Instance</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-actions/>Digital Actions</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/configurable-adapters/>Configurable Adapters</a></li></ul></div></li></ul></nav></div><nav class="docs-toc d-none d-xl-block col-xl-3" aria-label="Secondary navigation"><div class=page-links></div></nav><main class="docs-content col-lg-11 col-xl-9"><nav aria-label=breadcrumb><ol class=breadcrumb><li class=breadcrumb-item><a href=https://wldt.github.io/>Home</a></li><li class=breadcrumb-item><a href=https://wldt.github.io/docs/>Docs</a></li><li class=breadcrumb-item><a href=https://wldt.github.io/docs/guides/>Getting Started</a></li><li class="breadcrumb-item active" aria-current=page>DT Engine & DT Instance</li></ol></nav><h1>DT Engine & DT Instance</h1><nav class="toc-mobile d-xl-none" aria-label="Quaternary navigation"></nav><p>Now that we have created the main fundamental element of a DT (Physical Adapter, Shadowing Function and Digital Adapter) we can create Class file with a main to create the WLDT Engine
+with the created components and start the DT.</p><p>Create a new Java file called <code>DemoDigitalTwin</code> adding the following code:</p><p>With the following code we now create a new Digital Twin Instance</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=c1>// Create the new Digital Twin with its Shadowing Function  
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>DigitalTwin</span> <span class=n>digitalTwin</span> <span class=o>=</span> <span class=k>new</span> <span class=n>DigitalTwin</span><span class=o>(</span><span class=n>digitalTwinId</span><span class=o>,</span> <span class=k>new</span> <span class=n>DemoShadowingFunction</span><span class=o>());</span>  
+</span></span><span class=line><span class=cl>  
+</span></span><span class=line><span class=cl><span class=c1>// Physical Adapter with Configuration  
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>digitalTwin</span><span class=o>.</span><span class=na>addPhysicalAdapter</span><span class=o>(</span>  
+</span></span><span class=line><span class=cl>        <span class=k>new</span> <span class=n>DemoPhysicalAdapter</span><span class=o>(</span>  
+</span></span><span class=line><span class=cl>                <span class=n>String</span><span class=o>.</span><span class=na>format</span><span class=o>(</span><span class=s>&#34;%s-%s&#34;</span><span class=o>,</span> <span class=n>digitalTwinId</span><span class=o>,</span> <span class=s>&#34;test-physical-adapter&#34;</span><span class=o>),</span>  
+</span></span><span class=line><span class=cl>                <span class=k>new</span> <span class=n>DemoPhysicalAdapterConfiguration</span><span class=o>(),</span>  
+</span></span><span class=line><span class=cl>                <span class=kc>true</span><span class=o>));</span>  
+</span></span><span class=line><span class=cl>  
+</span></span><span class=line><span class=cl><span class=c1>// Digital Adapter with Configuration  
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>digitalTwin</span><span class=o>.</span><span class=na>addDigitalAdapter</span><span class=o>(</span>  
+</span></span><span class=line><span class=cl>        <span class=k>new</span> <span class=n>DemoDigitalAdapter</span><span class=o>(</span>  
+</span></span><span class=line><span class=cl>                <span class=n>String</span><span class=o>.</span><span class=na>format</span><span class=o>(</span><span class=s>&#34;%s-%s&#34;</span><span class=o>,</span> <span class=n>digitalTwinId</span><span class=o>,</span> <span class=s>&#34;test-digital-adapter&#34;</span><span class=o>),</span>  
+</span></span><span class=line><span class=cl>                <span class=k>new</span> <span class=n>DemoDigitalAdapterConfiguration</span><span class=o>())</span>  
+</span></span><span class=line><span class=cl><span class=o>);</span>
+</span></span></code></pre></div><p>DTs cannot be directly run but it should be added to the <code>DigitalTwinEngine</code> in order to be executed through the WLDT Library</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=c1>// Create the Digital Twin Engine
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>DigitalTwinEngine</span> <span class=n>digitalTwinEngine</span> <span class=o>=</span> <span class=k>new</span> <span class=n>DigitalTwinEngine</span><span class=o>();</span>  
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=c1>// Add the Digital Twin to the Engine
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>digitalTwinEngine</span><span class=o>.</span><span class=na>addDigitalTwin</span><span class=o>(</span><span class=n>digitalTwin</span><span class=o>);</span>
+</span></span></code></pre></div><p>In order to start a DT from the Engine you can:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=c1>// Directly start when you add it passing a second boolean value = true
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>digitalTwinEngine</span><span class=o>.</span><span class=na>addDigitalTwin</span><span class=o>(</span><span class=n>digitalTwin</span><span class=o>.</span> <span class=kc>true</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=c1>// Starting the single DT on the engine through its id
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>digitalTwinEngine</span><span class=o>.</span><span class=na>startDigitalTwin</span><span class=o>(</span><span class=n>DIGITAL_TWIN_ID</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=c1>// Start all the DTs registered on the engine
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>digitalTwinEngine</span><span class=o>.</span><span class=na>startAll</span><span class=o>();</span>
+</span></span></code></pre></div><p>To stop a single twin or all the twin registered on the engine:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=c1>// Stop a single DT on the engine through its id
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>digitalTwinEngine</span><span class=o>.</span><span class=na>stopDigitalTwin</span><span class=o>(</span><span class=n>DIGITAL_TWIN_ID</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=c1>// Stop all the DTs registered on the engine
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>digitalTwinEngine</span><span class=o>.</span><span class=na>stopAll</span><span class=o>();</span>
+</span></span></code></pre></div><p>It is also possible to remove a DT from the Engine with a consequent stop if it is active and the deletion of its reference from the engine:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=c1>// Remove a single DT on the engine through its id
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>digitalTwinEngine</span><span class=o>.</span><span class=na>removeDigitalTwin</span><span class=o>(</span><span class=n>DIGITAL_TWIN_ID</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=c1>// Remove all the DTs registered on the engine
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>digitalTwinEngine</span><span class=o>.</span><span class=na>removeAll</span><span class=o>();</span>
+</span></span></code></pre></div><p>The resulting code in our case is:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=kd>public</span> <span class=kd>class</span> <span class=nc>DemoDigitalTwin</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=kd>public</span> <span class=kd>static</span> <span class=kt>void</span> <span class=nf>main</span><span class=o>(</span><span class=n>String</span><span class=o>[]</span> <span class=n>args</span><span class=o>)</span>  <span class=o>{</span>
+</span></span><span class=line><span class=cl>        <span class=k>try</span><span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=c1>// Create the new Digital Twin
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=n>DigitalTwin</span> <span class=n>digitalTwin</span> <span class=o>=</span> <span class=k>new</span> <span class=n>DigitalTwin</span><span class=o>(</span>
+</span></span><span class=line><span class=cl>                    <span class=s>&#34;test-dt-id&#34;</span><span class=o>,</span>
+</span></span><span class=line><span class=cl>                    <span class=k>new</span> <span class=n>DemoShadowingFunction</span><span class=o>(</span><span class=s>&#34;test-shadowing-function&#34;</span><span class=o>)</span>
+</span></span><span class=line><span class=cl>            <span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=c1>//Default Physical and Digital Adapter
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=c1>//digitalTwin.addPhysicalAdapter(new DemoPhysicalAdapter(&#34;test-physical-adapter&#34;));
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=c1>//digitalTwin.addDigitalAdapter(new DemoDigitalAdapter(&#34;test-digital-adapter&#34;));
+</span></span></span><span class=line><span class=cl><span class=c1></span>
+</span></span><span class=line><span class=cl>            <span class=c1>//Physical and Digital Adapters with Configuration
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=n>digitalTwin</span><span class=o>.</span><span class=na>addPhysicalAdapter</span><span class=o>(</span><span class=k>new</span> <span class=n>DemoConfPhysicalAdapter</span><span class=o>(</span><span class=s>&#34;test-physical-adapter&#34;</span><span class=o>,</span> <span class=k>new</span> <span class=n>DemoPhysicalAdapterConfiguration</span><span class=o>()));</span>
+</span></span><span class=line><span class=cl>            <span class=n>digitalTwin</span><span class=o>.</span><span class=na>addDigitalAdapter</span><span class=o>(</span><span class=k>new</span> <span class=n>DemoConfDigitalAdapter</span><span class=o>(</span><span class=s>&#34;test-digital-adapter&#34;</span><span class=o>,</span> <span class=k>new</span> <span class=n>DemoDigitalAdapterConfiguration</span><span class=o>()));</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=c1>// Create the Digital Twin Engine
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=n>DigitalTwinEngine</span> <span class=n>digitalTwinEngine</span> <span class=o>=</span> <span class=k>new</span> <span class=n>DigitalTwinEngine</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=c1>// Add the Digital Twin to the Engine
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=n>digitalTwinEngine</span><span class=o>.</span><span class=na>addDigitalTwin</span><span class=o>(</span><span class=n>digitalTwin</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=c1>// Set a new Event-Logger to a Custom One that we created with the class &#39;DemoEventLogger&#39;
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=n>WldtEventBus</span><span class=o>.</span><span class=na>getInstance</span><span class=o>().</span><span class=na>setEventLogger</span><span class=o>(</span><span class=k>new</span> <span class=n>DemoEventLogger</span><span class=o>());</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=c1>// Start all the DTs registered on the engine
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=n>digitalTwinEngine</span><span class=o>.</span><span class=na>startAll</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>        <span class=o>}</span><span class=k>catch</span> <span class=o>(</span><span class=n>Exception</span> <span class=n>e</span><span class=o>){</span>
+</span></span><span class=line><span class=cl>            <span class=n>e</span><span class=o>.</span><span class=na>printStackTrace</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>        <span class=o>}</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl><span class=o>}</span>
+</span></span></code></pre></div><div class="page-footer-meta d-flex flex-column flex-md-row justify-content-between"><div class=last-modified><a href=https://github.com/wldt/wldt.github.io/commit/ab5a164de259055162e9420d8cb56c2b1562dee9><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-calendar"><rect x="3" y="4" width="18" height="18" rx="2" ry="2"/><line x1="16" y1="2" x2="16" y2="6"/><line x1="8" y1="2" x2="8" y2="6"/><line x1="3" y1="10" x2="21" y2="10"/></svg>Last updated on February 9, 2024</a></div><div class=edit-page><a href=https://github.com/wldt/wldt.github.io/blob/main/content//docs/guides/dt-process.md><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-edit-2"><path d="M17 3a2.828 2.828.0 114 4L7.5 20.5 2 22l1.5-5.5L17 3z"/></svg>Edit this page on GitHub</a></div></div><div class="page-nav d-flex flex-column flex-sm-row"><div class="card w-100"><div class="card-body d-flex"><div class="d-flex flex-column justify-content-center"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-arrow-left" width="20" height="20" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 12h14"/><path d="M5 12l6 6"/><path d="M5 12l6-6"/></svg></div><div class="d-flex flex-column"><div class=text-body-secondary>Prev</div><a href=https://wldt.github.io/docs/guides/digital-adapter/ class="stretched-link text-reset text-decoration-none">Digital Adapter</a></div></div></div><div class=m-2></div><div class="card text-end w-100"><div class="card-body d-flex justify-content-end"><div class="d-flex flex-column"><div class=text-body-secondary>Next</div><a href=https://wldt.github.io/docs/guides/digital-actions/ class="stretched-link text-reset text-decoration-none">Digital Actions</a></div><div class="d-flex flex-column justify-content-center"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-arrow-right" width="20" height="20" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 12h14"/><path d="M13 18l6-6"/><path d="M13 6l6 6"/></svg></div></div></div></div></main></div></div></div><footer class="footer text-muted"><div class=container-lg><div class=row><div class="col-lg-8 text-center text-lg-start"><ul class=list-inline><li class=list-inline-item><a class=text-muted href=https://wldt.github.io/privacy/>Privacy Policy</a></li></ul></div><div class="col-lg-8 text-center text-lg-end"><ul class=list-inline><li class=list-inline-item>Brought to you by <a class=text-muted href=https://gethyas.com/>Hyas</a></li></ul></div></div></div></footer><script async src=https://wldt.github.io/js/app.1e84dcdaa5ccef6fe83f6d88ac1e444a1f237111cfa2a7a97427f758e9c27ef4.js integrity="sha256-HoTc2qXM72/oP22IrB5ESh8jcRHPoqepdCf3WOnCfvQ="></script>
+<script async src=https://wldt.github.io/js/flexsearch.dc00caef2c3490dbab3c345ed0d4133b0aafb803efeb21c3df80776d6d3ea821.js integrity="sha256-3ADK7yw0kNurPDRe0NQTOwqvuAPv6yHD34B3bW0+qCE="></script><script async src=https://wldt.github.io/js/search-modal.c4c023efcdee308e4b5f1110afe1db6b1656f217e67aa7efe54e2f4bf2feccf8.js integrity="sha256-xMAj783uMI5LXxEQr+HbaxZW8hfmeqfv5U4vS/L+zPg="></script><div class="d-inline-flex fixed-bottom-right pb-4 pe-4"><button id=toTop type=button class="btn btn-primary rounded-circle ms-auto p-2"><span class=visually-hidden>Top</span><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-chevron-up" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M6 15l6-6 6 6"/></svg></button></div></body></html>
\ No newline at end of file
diff --git a/docs/guides/example-guide/index.html b/docs/guides/example-guide/index.html
deleted file mode 100644
index dd6c49b..0000000
--- a/docs/guides/example-guide/index.html
+++ /dev/null
@@ -1,11 +0,0 @@
-<!doctype html><html lang=en data-bs-theme=auto><head><meta charset=utf-8><meta http-equiv=x-ua-compatible content="ie=edge"><meta name=viewport content="width=device-width,initial-scale=1"><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-regular.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-500.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-700.woff2 type=font/woff2 crossorigin><script src=https://wldt.github.io/js/color-mode.86a91f050a481d0a3f0c72ac26543cb6228c770875981c58dcbc008fd3f875c8.js integrity="sha256-hqkfBQpIHQo/DHKsJlQ8tiKMdwh1mBxY3LwAj9P4dcg="></script>
-<link rel=stylesheet href=https://wldt.github.io/main.5d6e5440c13f1c45183e82bbb906165564d1edfd71498c4a2c38775086796022bfab9cfb137199a537d8e42c2fb6ce2ab74b69461aed15b7389bd0e12ec63b19.css integrity="sha512-XW5UQME/HEUYPoK7uQYWVWTR7f1xSYxKLDh3UIZ5YCK/q5z7E3GZpTfY5Cwvts4qt0tpRhrtFbc4m9DhLsY7GQ==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>Example Guide | WLDT</title><meta property="canonical" content="https://wldt.github.io/docs/guides/example-guide/"><meta name=description content="Guides lead a user through a specific task they want to accomplish, often with a sequence of steps. Writing a good guide requires thinking about what your users are trying to do."><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/docs/guides/example-guide/"><meta property="og:title" content="Example Guide"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:section" content="docs"><meta property="og:description" content="Guides lead a user through a specific task they want to accomplish, often with a sequence of steps. Writing a good guide requires thinking about what your users are trying to do."><meta property="og:see_also" content="https://wldt.github.io/docs/guides/example-guide/"><meta property="og:see_also" content="https://wldt.github.io/docs/reference/example-reference/"><meta name=twitter:card content="summary"><meta name=twitter:title content="Example Guide"><meta name=twitter:description content="Guides lead a user through a specific task they want to accomplish, often with a sequence of steps. Writing a good guide requires thinking about what your users are trying to do."><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","item":"https://wldt.github.io/docs/","name":"Docs","position":2},{"@type":"ListItem","item":"https://wldt.github.io/docs/guides/","name":"Guides","position":3},{"@type":"ListItem","name":"Example Guide","position":4}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="single section docs" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
-<button type=button id=searchToggleMobile class="btn btn-link nav-link mx-2 d-lg-none" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
-<button class="btn btn-link d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavSection aria-controls=offcanvasNavSection aria-label="Open section navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-dots-vertical" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 19m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 5m-1 0a1 1 0 102 0 1 1 0 10-2 0"/></svg></button><div class="offcanvas offcanvas-start d-lg-none" tabindex=-1 id=offcanvasNavSection aria-labelledby=offcanvasNavSectionLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavSectionLabel>Docs</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class=offcanvas-body><aside class="doks-sidebar mt-n3"><nav id=doks-docs-nav aria-label="Tertiary navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-45389ee90014e0938cb09409b9a8794d aria-expanded=true>
-Guides</button><div class="collapse show" id=section-45389ee90014e0938cb09409b9a8794d><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded active" href=https://wldt.github.io/docs/guides/example-guide/>Example Guide</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-63d5049791d9d79d86e9a108b0a999ca aria-expanded=false>
-Reference</button><div class=collapse id=section-63d5049791d9d79d86e9a108b0a999ca><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/reference/example-reference/>Example Reference</a></li></ul></div></li></ul></nav></aside></div></div><button class="btn btn-link nav-link mx-2 order-3 d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavMain aria-controls=offcanvasNavMain aria-label="Open main navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-menu" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><line x1="4" y1="8" x2="20" y2="8"/><line x1="4" y1="16" x2="20" y2="16"/></svg></button><div class="offcanvas offcanvas-end h-auto" tabindex=-1 id=offcanvasNavMain aria-labelledby=offcanvasNavMainLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavMainLabel>WLDT</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class="offcanvas-body d-flex flex-column flex-lg-row justify-content-between"><ul class="navbar-nav flex-grow-1"><li class=nav-item><a class=nav-link href=https://wldt.github.io/docs/guides/example-guide/>Documentation</a></li><li class=nav-item><a class=nav-link href=https://wldt.github.io/blog/>Blog</a></li></ul><button type=button id=searchToggleDesktop class="btn btn-link nav-link p-2 d-none d-lg-block" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
-<button id=buttonColorMode class="btn btn-link mx-auto nav-link p-0 ms-lg-2 me-lg-1" type=button aria-label="Toggle theme"><svg data-bs-theme-value="dark" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-moon" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 3c.132.0.263.0.393.0a7.5 7.5.0 007.92 12.446A9 9 0 1112 2.992z"/></svg><svg data-bs-theme-value="light" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-sun" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-4 0a4 4 0 108 0 4 4 0 10-8 0m-5 0h1m8-9v1m8 8h1m-9 8v1M5.6 5.6l.7.7m12.1-.7-.7.7m0 11.4.7.7m-12.1-.7-.7.7"/></svg></button><ul id=socialMenu class="nav mx-auto flex-row order-lg-4"><li class=nav-item><a class="nav-link social-link" href=https://github.com/wldt><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-brand-github" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 19c-4.3 1.4-4.3-2.5-6-3m12 5v-3.5c0-1 .1-1.4-.5-2 2.8-.3 5.5-1.4 5.5-6a4.6 4.6.0 00-1.3-3.2 4.2 4.2.0 00-.1-3.2s-1.1-.3-3.5 1.3a12.3 12.3.0 00-6.2.0C6.5 2.8 5.4 3.1 5.4 3.1a4.2 4.2.0 00-.1 3.2A4.6 4.6.0 004 9.5c0 4.6 2.7 5.7 5.5 6-.6.6-.6 1.2-.5 2V21"/></svg><small class="ms-2 visually-hidden">GitHub</small></a></li></ul></div></div></div></header></div><div class=modal id=searchModal tabindex=-1 aria-labelledby=searchModalLabel aria-hidden=true><div class="modal-dialog modal-dialog-scrollable modal-fullscreen-md-down"><div class=modal-content><div class=modal-header><h1 class="modal-title fs-5 visually-hidden" id=searchModalLabel>Search</h1><button type=button class="btn-close visually-hidden" data-bs-dismiss=modal aria-label=Close></button><div class="search-input flex-grow-1 d-none"><form id=search-form class=search-form action=# method=post accept-charset=utf-8 role=search><label for=query class=visually-hidden>Search</label><div class=d-flex><input type=search id=query name=query class="search-text form-control form-control-lg" placeholder=Search aria-label=Search maxlength=128 autocomplete=off>
-<button type=button class="btn btn-link text-decoration-none px-0 ms-3 d-md-none" data-bs-dismiss=modal aria-label=Close>Cancel</button></div></form></div></div><div class=modal-body><p class="search-loading status message d-none mt-3 text-center">Loading search index…</p><p class="search-no-recent message d-none mt-3 text-center">No recent searches</p><p class="search-no-results message d-none mt-3 text-center">No results for "<strong><span class=query-no-results>Query here</span></strong>"</p><div id=searchResults class=search-results></div><template><article class="search-result list-view"><div class="card my-3"><div class=card-body><header><h2 class="h5 title title-submitted mb-0"><a class="stretched-link text-decoration-none text-reset" href=#>Title here</a></h2><div class="submitted d-none"><time class=created-date>Date here</time></div></header><div class=content>Summary here</div></div></div></article></template></div><div class=modal-footer><ul class="list-inline me-auto d-none d-md-block"><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Enter key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M12 3.53088v3c0 1-1 2-2 2H4m3 3-3-3 3-3"/></g></svg></kbd><span class=DocSearch-Label>to select</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Arrow down" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 3.5v8m3-3-3 3-3-3"/></g></svg></kbd><kbd class=me-2><svg width="15" height="15" aria-label="Arrow up" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 11.5v-8m3 3-3-3-3 3"/></g></svg></kbd><span class=DocSearch-Label>to navigate</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Escape key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M13.6167 8.936c-.1065.3583-.6883.962-1.4875.962-.7993.0-1.653-.9165-1.653-2.1258v-.5678c0-1.2548.7896-2.1016 1.653-2.1016s1.3601.4778 1.4875 1.0724M9 6c-.1352-.4735-.7506-.9219-1.46-.8972-.7092.0246-1.344.57-1.344 1.2166s.4198.8812 1.3445.9805C8.465 7.3992 8.968 7.9337 9 8.5s-.454 1.398-1.4595 1.398C6.6593 9.898 6 9 5.963 8.4851m-1.4748.5368c-.2635.5941-.8099.876-1.5443.876s-1.7073-.6248-1.7073-2.204v-.4603c0-1.0416.721-2.131 1.7073-2.131.9864.0 1.6425 1.031 1.5443 2.2492h-2.956"/></g></svg></kbd><span class=DocSearch-Label>to close</span></li></ul><p class=d-md-none>Search by <a class=text-decoration-none href=https://github.com/nextapps-de/flexsearch>FlexSearch</a></p></div></div></div></div><div class="wrap container-lg" role=document><div class=content><div class="row flex-xl-nowrap"><div class="col-lg-5 col-xl-4 docs-sidebar d-none d-lg-block"><nav class=docs-links aria-label="Main navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-45389ee90014e0938cb09409b9a8794d aria-expanded=true>
-Guides</button><div class="collapse show" id=section-45389ee90014e0938cb09409b9a8794d><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded active" href=https://wldt.github.io/docs/guides/example-guide/>Example Guide</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-63d5049791d9d79d86e9a108b0a999ca aria-expanded=false>
-Reference</button><div class=collapse id=section-63d5049791d9d79d86e9a108b0a999ca><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/reference/example-reference/>Example Reference</a></li></ul></div></li></ul></nav></div><nav class="docs-toc d-none d-xl-block col-xl-3" aria-label="Secondary navigation"><div class=page-links><h3>Example Guide</h3><nav id=toc><ul><li><a href=#further-reading>Further reading</a></li></ul></nav></div></nav><main class="docs-content col-lg-11 col-xl-9"><nav aria-label=breadcrumb><ol class=breadcrumb><li class=breadcrumb-item><a href=https://wldt.github.io/>Home</a></li><li class=breadcrumb-item><a href=https://wldt.github.io/docs/>Docs</a></li><li class=breadcrumb-item><a href=https://wldt.github.io/docs/guides/>Guides</a></li><li class="breadcrumb-item active" aria-current=page>Example Guide</li></ol></nav><h1>Example Guide</h1><nav class="toc-mobile d-xl-none" aria-label="Quaternary navigation"><details><summary>On this page</summary><div class=page-links><nav id=TableOfContents><ul><li><a href=#further-reading>Further reading</a></li></ul></nav></div></details></nav><p>Guides lead a user through a specific task they want to accomplish, often with a sequence of steps. Writing a good guide requires thinking about what your users are trying to do.</p><h2 id=further-reading>Further reading<a href=#further-reading class=anchor aria-hidden=true>#</a></h2><ul><li>Read <a href=https://diataxis.fr/how-to-guides/>about how-to guides</a> in the Diátaxis framework</li></ul><div class="page-footer-meta d-flex flex-column flex-md-row justify-content-between"><div class=last-modified><a href=https://github.com/wldt/wldt.github.io/commit/4527b1ec8860597aebbb44ede14781ea4e43e577><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-calendar"><rect x="3" y="4" width="18" height="18" rx="2" ry="2"/><line x1="16" y1="2" x2="16" y2="6"/><line x1="8" y1="2" x2="8" y2="6"/><line x1="3" y1="10" x2="21" y2="10"/></svg>Last updated on February 9, 2024</a></div><div class=edit-page><a href=https://github.com/wldt/wldt.github.io/blob/main/content//docs/guides/example.md><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-edit-2"><path d="M17 3a2.828 2.828.0 114 4L7.5 20.5 2 22l1.5-5.5L17 3z"/></svg>Edit this page on GitHub</a></div></div><div class="page-nav d-flex flex-column flex-sm-row"><div class="card text-end w-100"><div class="card-body d-flex justify-content-end"><div class="d-flex flex-column"><div class=text-body-secondary>Next</div><a href=https://wldt.github.io/docs/reference/example-reference/ class="stretched-link text-reset text-decoration-none">Example Reference</a></div><div class="d-flex flex-column justify-content-center"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-arrow-right" width="20" height="20" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 12h14"/><path d="M13 18l6-6"/><path d="M13 6l6 6"/></svg></div></div></div></div></main></div></div></div><footer class="footer text-muted"><div class=container-lg><div class=row><div class="col-lg-8 text-center text-lg-start"><ul class=list-inline><li class=list-inline-item><a class=text-muted href=https://wldt.github.io/privacy/>Privacy Policy</a></li></ul></div><div class="col-lg-8 text-center text-lg-end"><ul class=list-inline><li class=list-inline-item>Brought to you by <a class=text-muted href=https://gethyas.com/>Hyas</a></li></ul></div></div></div></footer><script async src=https://wldt.github.io/js/app.1e84dcdaa5ccef6fe83f6d88ac1e444a1f237111cfa2a7a97427f758e9c27ef4.js integrity="sha256-HoTc2qXM72/oP22IrB5ESh8jcRHPoqepdCf3WOnCfvQ="></script>
-<script async src=https://wldt.github.io/js/flexsearch.dc00caef2c3490dbab3c345ed0d4133b0aafb803efeb21c3df80776d6d3ea821.js integrity="sha256-3ADK7yw0kNurPDRe0NQTOwqvuAPv6yHD34B3bW0+qCE="></script><script async src=https://wldt.github.io/js/search-modal.c4c023efcdee308e4b5f1110afe1db6b1656f217e67aa7efe54e2f4bf2feccf8.js integrity="sha256-xMAj783uMI5LXxEQr+HbaxZW8hfmeqfv5U4vS/L+zPg="></script><div class="d-inline-flex fixed-bottom-right pb-4 pe-4"><button id=toTop type=button class="btn btn-primary rounded-circle ms-auto p-2"><span class=visually-hidden>Top</span><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-chevron-up" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M6 15l6-6 6 6"/></svg></button></div></body></html>
\ No newline at end of file
diff --git a/docs/guides/index.html b/docs/guides/index.html
index dc8cd1f..7402183 100644
--- a/docs/guides/index.html
+++ b/docs/guides/index.html
@@ -1,9 +1,11 @@
 <!doctype html><html lang=en data-bs-theme=auto><head><meta charset=utf-8><meta http-equiv=x-ua-compatible content="ie=edge"><meta name=viewport content="width=device-width,initial-scale=1"><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-regular.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-500.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-700.woff2 type=font/woff2 crossorigin><script src=https://wldt.github.io/js/color-mode.86a91f050a481d0a3f0c72ac26543cb6228c770875981c58dcbc008fd3f875c8.js integrity="sha256-hqkfBQpIHQo/DHKsJlQ8tiKMdwh1mBxY3LwAj9P4dcg="></script>
-<link rel=stylesheet href=https://wldt.github.io/main.5d6e5440c13f1c45183e82bbb906165564d1edfd71498c4a2c38775086796022bfab9cfb137199a537d8e42c2fb6ce2ab74b69461aed15b7389bd0e12ec63b19.css integrity="sha512-XW5UQME/HEUYPoK7uQYWVWTR7f1xSYxKLDh3UIZ5YCK/q5z7E3GZpTfY5Cwvts4qt0tpRhrtFbc4m9DhLsY7GQ==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>Guides | WLDT</title><meta property="canonical" content="https://wldt.github.io/docs/guides/"><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/docs/guides/"><meta property="og:title" content="Guides"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:section" content="docs"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/example-guide/"><meta property="og:see_also" content="https://wldt.github.io/docs/reference/example-reference/"><meta name=twitter:card content="summary"><meta name=twitter:title content="Guides"><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","item":"https://wldt.github.io/docs/","name":"Docs","position":2},{"@type":"ListItem","name":"Guides","position":3}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="list section docs" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
+<link rel=stylesheet href=https://wldt.github.io/main.5fb433a44687c98f7ae7b3d0137c762777049ba27235e1f08c279c03c8533a7a9a1e3b0ef5b125a31b6bb63a362cdcbc39c3706ed41ad7f1a620b9281013866c.css integrity="sha512-X7QzpEaHyY9657PQE3x2J3cEm6JyNeHwjCecA8hTOnqaHjsO9bEloxtrtjo2LNy8OcNwbtQa1/GmILkoEBOGbA==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>Getting Started | WLDT</title><meta property="canonical" content="https://wldt.github.io/docs/guides/"><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/docs/guides/"><meta property="og:title" content="Getting Started"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:section" content="docs"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-model/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-life-cycle/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/library-structure-basic-concepts/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/physical-adapter/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/shadowing-function/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/digital-adapter/"><meta name=twitter:card content="summary"><meta name=twitter:title content="Getting Started"><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","item":"https://wldt.github.io/docs/","name":"Docs","position":2},{"@type":"ListItem","name":"Getting Started","position":3}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="list section docs" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
 <button type=button id=searchToggleMobile class="btn btn-link nav-link mx-2 d-lg-none" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
-<button class="btn btn-link d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavSection aria-controls=offcanvasNavSection aria-label="Open section navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-dots-vertical" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 19m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 5m-1 0a1 1 0 102 0 1 1 0 10-2 0"/></svg></button><div class="offcanvas offcanvas-start d-lg-none" tabindex=-1 id=offcanvasNavSection aria-labelledby=offcanvasNavSectionLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavSectionLabel>Docs</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class=offcanvas-body><aside class="doks-sidebar mt-n3"><nav id=doks-docs-nav aria-label="Tertiary navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-45389ee90014e0938cb09409b9a8794d aria-expanded=true>
-Guides</button><div class="collapse show" id=section-45389ee90014e0938cb09409b9a8794d><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/example-guide/>Example Guide</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-63d5049791d9d79d86e9a108b0a999ca aria-expanded=false>
-Reference</button><div class=collapse id=section-63d5049791d9d79d86e9a108b0a999ca><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/reference/example-reference/>Example Reference</a></li></ul></div></li></ul></nav></aside></div></div><button class="btn btn-link nav-link mx-2 order-3 d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavMain aria-controls=offcanvasNavMain aria-label="Open main navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-menu" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><line x1="4" y1="8" x2="20" y2="8"/><line x1="4" y1="16" x2="20" y2="16"/></svg></button><div class="offcanvas offcanvas-end h-auto" tabindex=-1 id=offcanvasNavMain aria-labelledby=offcanvasNavMainLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavMainLabel>WLDT</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class="offcanvas-body d-flex flex-column flex-lg-row justify-content-between"><ul class="navbar-nav flex-grow-1"><li class=nav-item><a class=nav-link href=https://wldt.github.io/docs/guides/example-guide/>Documentation</a></li><li class=nav-item><a class=nav-link href=https://wldt.github.io/blog/>Blog</a></li></ul><button type=button id=searchToggleDesktop class="btn btn-link nav-link p-2 d-none d-lg-block" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button class="btn btn-link d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavSection aria-controls=offcanvasNavSection aria-label="Open section navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-dots-vertical" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 19m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 5m-1 0a1 1 0 102 0 1 1 0 10-2 0"/></svg></button><div class="offcanvas offcanvas-start d-lg-none" tabindex=-1 id=offcanvasNavSection aria-labelledby=offcanvasNavSectionLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavSectionLabel>Docs</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class=offcanvas-body><aside class="doks-sidebar mt-n3"><nav id=doks-docs-nav aria-label="Tertiary navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-0b79795d3efc95b9976c7c5b933afce2 aria-expanded=false>
+Introduction</button><div class=collapse id=section-0b79795d3efc95b9976c7c5b933afce2><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-model/>DT Model</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-life-cycle/>DT Life Cycle</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/>Library Structure & Basic Concepts</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-3978929206deee2c125a1d732aae5545 aria-expanded=false>
+Change Logs</button><div class=collapse id=section-3978929206deee2c125a1d732aae5545><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/>Change Log 0.3.0</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-89413bd312d0909efb85e6693f36cb89 aria-expanded=false>
+Adapters</button><div class=collapse id=section-89413bd312d0909efb85e6693f36cb89><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/>MQTT Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/>MQTT Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/http-digital-adapter/>HTTP Digital Adapter</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-bf647454e36069fd16f1a7a35cf6a865 aria-expanded=true>
+Getting Started</button><div class="collapse show" id=section-bf647454e36069fd16f1a7a35cf6a865><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/physical-adapter/>Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/shadowing-function/>Shadowing Function</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-adapter/>Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/>DT Engine & DT Instance</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-actions/>Digital Actions</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/configurable-adapters/>Configurable Adapters</a></li></ul></div></li></ul></nav></aside></div></div><button class="btn btn-link nav-link mx-2 order-3 d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavMain aria-controls=offcanvasNavMain aria-label="Open main navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-menu" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><line x1="4" y1="8" x2="20" y2="8"/><line x1="4" y1="16" x2="20" y2="16"/></svg></button><div class="offcanvas offcanvas-end h-auto" tabindex=-1 id=offcanvasNavMain aria-labelledby=offcanvasNavMainLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavMainLabel>WLDT</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class="offcanvas-body d-flex flex-column flex-lg-row justify-content-between"><ul class="navbar-nav flex-grow-1"><li class=nav-item><a class=nav-link href=https://wldt.github.io/docs/guides/example-guide/>Documentation</a></li><li class=nav-item><a class=nav-link href=https://wldt.github.io/blog/>Blog</a></li></ul><button type=button id=searchToggleDesktop class="btn btn-link nav-link p-2 d-none d-lg-block" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
 <button id=buttonColorMode class="btn btn-link mx-auto nav-link p-0 ms-lg-2 me-lg-1" type=button aria-label="Toggle theme"><svg data-bs-theme-value="dark" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-moon" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 3c.132.0.263.0.393.0a7.5 7.5.0 007.92 12.446A9 9 0 1112 2.992z"/></svg><svg data-bs-theme-value="light" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-sun" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-4 0a4 4 0 108 0 4 4 0 10-8 0m-5 0h1m8-9v1m8 8h1m-9 8v1M5.6 5.6l.7.7m12.1-.7-.7.7m0 11.4.7.7m-12.1-.7-.7.7"/></svg></button><ul id=socialMenu class="nav mx-auto flex-row order-lg-4"><li class=nav-item><a class="nav-link social-link" href=https://github.com/wldt><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-brand-github" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 19c-4.3 1.4-4.3-2.5-6-3m12 5v-3.5c0-1 .1-1.4-.5-2 2.8-.3 5.5-1.4 5.5-6a4.6 4.6.0 00-1.3-3.2 4.2 4.2.0 00-.1-3.2s-1.1-.3-3.5 1.3a12.3 12.3.0 00-6.2.0C6.5 2.8 5.4 3.1 5.4 3.1a4.2 4.2.0 00-.1 3.2A4.6 4.6.0 004 9.5c0 4.6 2.7 5.7 5.5 6-.6.6-.6 1.2-.5 2V21"/></svg><small class="ms-2 visually-hidden">GitHub</small></a></li></ul></div></div></div></header></div><div class=modal id=searchModal tabindex=-1 aria-labelledby=searchModalLabel aria-hidden=true><div class="modal-dialog modal-dialog-scrollable modal-fullscreen-md-down"><div class=modal-content><div class=modal-header><h1 class="modal-title fs-5 visually-hidden" id=searchModalLabel>Search</h1><button type=button class="btn-close visually-hidden" data-bs-dismiss=modal aria-label=Close></button><div class="search-input flex-grow-1 d-none"><form id=search-form class=search-form action=# method=post accept-charset=utf-8 role=search><label for=query class=visually-hidden>Search</label><div class=d-flex><input type=search id=query name=query class="search-text form-control form-control-lg" placeholder=Search aria-label=Search maxlength=128 autocomplete=off>
-<button type=button class="btn btn-link text-decoration-none px-0 ms-3 d-md-none" data-bs-dismiss=modal aria-label=Close>Cancel</button></div></form></div></div><div class=modal-body><p class="search-loading status message d-none mt-3 text-center">Loading search index…</p><p class="search-no-recent message d-none mt-3 text-center">No recent searches</p><p class="search-no-results message d-none mt-3 text-center">No results for "<strong><span class=query-no-results>Query here</span></strong>"</p><div id=searchResults class=search-results></div><template><article class="search-result list-view"><div class="card my-3"><div class=card-body><header><h2 class="h5 title title-submitted mb-0"><a class="stretched-link text-decoration-none text-reset" href=#>Title here</a></h2><div class="submitted d-none"><time class=created-date>Date here</time></div></header><div class=content>Summary here</div></div></div></article></template></div><div class=modal-footer><ul class="list-inline me-auto d-none d-md-block"><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Enter key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M12 3.53088v3c0 1-1 2-2 2H4m3 3-3-3 3-3"/></g></svg></kbd><span class=DocSearch-Label>to select</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Arrow down" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 3.5v8m3-3-3 3-3-3"/></g></svg></kbd><kbd class=me-2><svg width="15" height="15" aria-label="Arrow up" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 11.5v-8m3 3-3-3-3 3"/></g></svg></kbd><span class=DocSearch-Label>to navigate</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Escape key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M13.6167 8.936c-.1065.3583-.6883.962-1.4875.962-.7993.0-1.653-.9165-1.653-2.1258v-.5678c0-1.2548.7896-2.1016 1.653-2.1016s1.3601.4778 1.4875 1.0724M9 6c-.1352-.4735-.7506-.9219-1.46-.8972-.7092.0246-1.344.57-1.344 1.2166s.4198.8812 1.3445.9805C8.465 7.3992 8.968 7.9337 9 8.5s-.454 1.398-1.4595 1.398C6.6593 9.898 6 9 5.963 8.4851m-1.4748.5368c-.2635.5941-.8099.876-1.5443.876s-1.7073-.6248-1.7073-2.204v-.4603c0-1.0416.721-2.131 1.7073-2.131.9864.0 1.6425 1.031 1.5443 2.2492h-2.956"/></g></svg></kbd><span class=DocSearch-Label>to close</span></li></ul><p class=d-md-none>Search by <a class=text-decoration-none href=https://github.com/nextapps-de/flexsearch>FlexSearch</a></p></div></div></div></div><div class="wrap container-lg" role=document><div class=content><div class="row justify-content-center"><div class="col-md-12 col-lg-10 col-xl-8"><article><h1 class=text-center>Guides</h1><div class=card-list><div class="card my-3"><div class=card-body><a class=stretched-link href=https://wldt.github.io/docs/guides/example-guide/>Example Guide &rarr;</a></div></div></div></article></div></div></div></div><footer class="footer text-muted"><div class=container-lg><div class=row><div class="col-lg-8 text-center text-lg-start"><ul class=list-inline><li class=list-inline-item><a class=text-muted href=https://wldt.github.io/privacy/>Privacy Policy</a></li></ul></div><div class="col-lg-8 text-center text-lg-end"><ul class=list-inline><li class=list-inline-item>Brought to you by <a class=text-muted href=https://gethyas.com/>Hyas</a></li></ul></div></div></div></footer><script async src=https://wldt.github.io/js/app.1e84dcdaa5ccef6fe83f6d88ac1e444a1f237111cfa2a7a97427f758e9c27ef4.js integrity="sha256-HoTc2qXM72/oP22IrB5ESh8jcRHPoqepdCf3WOnCfvQ="></script>
+<button type=button class="btn btn-link text-decoration-none px-0 ms-3 d-md-none" data-bs-dismiss=modal aria-label=Close>Cancel</button></div></form></div></div><div class=modal-body><p class="search-loading status message d-none mt-3 text-center">Loading search index…</p><p class="search-no-recent message d-none mt-3 text-center">No recent searches</p><p class="search-no-results message d-none mt-3 text-center">No results for "<strong><span class=query-no-results>Query here</span></strong>"</p><div id=searchResults class=search-results></div><template><article class="search-result list-view"><div class="card my-3"><div class=card-body><header><h2 class="h5 title title-submitted mb-0"><a class="stretched-link text-decoration-none text-reset" href=#>Title here</a></h2><div class="submitted d-none"><time class=created-date>Date here</time></div></header><div class=content>Summary here</div></div></div></article></template></div><div class=modal-footer><ul class="list-inline me-auto d-none d-md-block"><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Enter key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M12 3.53088v3c0 1-1 2-2 2H4m3 3-3-3 3-3"/></g></svg></kbd><span class=DocSearch-Label>to select</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Arrow down" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 3.5v8m3-3-3 3-3-3"/></g></svg></kbd><kbd class=me-2><svg width="15" height="15" aria-label="Arrow up" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 11.5v-8m3 3-3-3-3 3"/></g></svg></kbd><span class=DocSearch-Label>to navigate</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Escape key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M13.6167 8.936c-.1065.3583-.6883.962-1.4875.962-.7993.0-1.653-.9165-1.653-2.1258v-.5678c0-1.2548.7896-2.1016 1.653-2.1016s1.3601.4778 1.4875 1.0724M9 6c-.1352-.4735-.7506-.9219-1.46-.8972-.7092.0246-1.344.57-1.344 1.2166s.4198.8812 1.3445.9805C8.465 7.3992 8.968 7.9337 9 8.5s-.454 1.398-1.4595 1.398C6.6593 9.898 6 9 5.963 8.4851m-1.4748.5368c-.2635.5941-.8099.876-1.5443.876s-1.7073-.6248-1.7073-2.204v-.4603c0-1.0416.721-2.131 1.7073-2.131.9864.0 1.6425 1.031 1.5443 2.2492h-2.956"/></g></svg></kbd><span class=DocSearch-Label>to close</span></li></ul><p class=d-md-none>Search by <a class=text-decoration-none href=https://github.com/nextapps-de/flexsearch>FlexSearch</a></p></div></div></div></div><div class="wrap container-lg" role=document><div class=content><div class="row justify-content-center"><div class="col-md-12 col-lg-10 col-xl-8"><article><h1 class=text-center>Getting Started</h1><div class=card-list><div class="card my-3"><div class=card-body><a class=stretched-link href=https://wldt.github.io/docs/guides/configurable-adapters/>Configurable Adapters &rarr;</a></div></div><div class="card my-3"><div class=card-body><a class=stretched-link href=https://wldt.github.io/docs/guides/digital-actions/>Digital Actions &rarr;</a></div></div><div class="card my-3"><div class=card-body><a class=stretched-link href=https://wldt.github.io/docs/guides/digital-adapter/>Digital Adapter &rarr;</a></div></div><div class="card my-3"><div class=card-body><a class=stretched-link href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/>DT Engine & DT Instance &rarr;</a></div></div><div class="card my-3"><div class=card-body><a class=stretched-link href=https://wldt.github.io/docs/guides/physical-adapter/>Physical Adapter &rarr;</a></div></div><div class="card my-3"><div class=card-body><a class=stretched-link href=https://wldt.github.io/docs/guides/shadowing-function/>Shadowing Function &rarr;</a></div></div></div></article></div></div></div></div><footer class="footer text-muted"><div class=container-lg><div class=row><div class="col-lg-8 text-center text-lg-start"><ul class=list-inline><li class=list-inline-item><a class=text-muted href=https://wldt.github.io/privacy/>Privacy Policy</a></li></ul></div><div class="col-lg-8 text-center text-lg-end"><ul class=list-inline><li class=list-inline-item>Brought to you by <a class=text-muted href=https://gethyas.com/>Hyas</a></li></ul></div></div></div></footer><script async src=https://wldt.github.io/js/app.1e84dcdaa5ccef6fe83f6d88ac1e444a1f237111cfa2a7a97427f758e9c27ef4.js integrity="sha256-HoTc2qXM72/oP22IrB5ESh8jcRHPoqepdCf3WOnCfvQ="></script>
 <script async src=https://wldt.github.io/js/flexsearch.dc00caef2c3490dbab3c345ed0d4133b0aafb803efeb21c3df80776d6d3ea821.js integrity="sha256-3ADK7yw0kNurPDRe0NQTOwqvuAPv6yHD34B3bW0+qCE="></script><script async src=https://wldt.github.io/js/search-modal.c4c023efcdee308e4b5f1110afe1db6b1656f217e67aa7efe54e2f4bf2feccf8.js integrity="sha256-xMAj783uMI5LXxEQr+HbaxZW8hfmeqfv5U4vS/L+zPg="></script><div class="d-inline-flex fixed-bottom-right pb-4 pe-4"><button id=toTop type=button class="btn btn-primary rounded-circle ms-auto p-2"><span class=visually-hidden>Top</span><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-chevron-up" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M6 15l6-6 6 6"/></svg></button></div></body></html>
\ No newline at end of file
diff --git a/docs/guides/index.xml b/docs/guides/index.xml
index 3b74500..42749b0 100644
--- a/docs/guides/index.xml
+++ b/docs/guides/index.xml
@@ -1 +1 @@
-<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Guides on WLDT</title><link>https://wldt.github.io/docs/guides/</link><description>Recent content in Guides on WLDT</description><generator>Hugo -- gohugo.io</generator><language>en</language><copyright>Copyright (c) 2023 Hyas</copyright><lastBuildDate>Thu, 07 Sep 2023 16:06:50 +0200</lastBuildDate><atom:link href="https://wldt.github.io/docs/guides/index.xml" rel="self" type="application/rss+xml"/><item><title>Example Guide</title><link>https://wldt.github.io/docs/guides/example-guide/</link><pubDate>Thu, 07 Sep 2023 16:04:48 +0200</pubDate><guid>https://wldt.github.io/docs/guides/example-guide/</guid><description>Guides lead a user through a specific task they want to accomplish, often with a sequence of steps. Writing a good guide requires thinking about what your users are trying to do.</description></item></channel></rss>
\ No newline at end of file
+<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Getting Started on WLDT</title><link>https://wldt.github.io/docs/guides/</link><description>Recent content in Getting Started on WLDT</description><generator>Hugo -- gohugo.io</generator><language>en</language><copyright>Copyright (c) 2023 Hyas</copyright><lastBuildDate>Fri, 09 Feb 2024 12:11:11 +0100</lastBuildDate><atom:link href="https://wldt.github.io/docs/guides/index.xml" rel="self" type="application/rss+xml"/><item><title>Physical Adapter</title><link>https://wldt.github.io/docs/guides/physical-adapter/</link><pubDate>Fri, 09 Feb 2024 12:09:02 +0100</pubDate><guid>https://wldt.github.io/docs/guides/physical-adapter/</guid><description>The developer can use an existing Physical Adapter or create a new one to handle the communication with a specific physical twin.</description></item><item><title>Shadowing Function</title><link>https://wldt.github.io/docs/guides/shadowing-function/</link><pubDate>Fri, 09 Feb 2024 12:15:33 +0100</pubDate><guid>https://wldt.github.io/docs/guides/shadowing-function/</guid><description>After the definition of the Physical Adapter it is time to start implementing the core of our DT through the definition of its shadowing function in charge of:</description></item><item><title>Digital Adapter</title><link>https://wldt.github.io/docs/guides/digital-adapter/</link><pubDate>Fri, 09 Feb 2024 12:16:06 +0100</pubDate><guid>https://wldt.github.io/docs/guides/digital-adapter/</guid><description>The las component that we have to implement to complete our first simple Digital Twin definition through the WLDT library is a Digital Adapter in charge of:</description></item><item><title>DT Engine &amp; DT Instance</title><link>https://wldt.github.io/docs/guides/dt-engine-dt-instance/</link><pubDate>Fri, 09 Feb 2024 12:16:36 +0100</pubDate><guid>https://wldt.github.io/docs/guides/dt-engine-dt-instance/</guid><description>Now that we have created the main fundamental element of a DT (Physical Adapter, Shadowing Function and Digital Adapter) we can create Class file with a main to create the WLDT Engine with the created components and start the DT.</description></item><item><title>Digital Actions</title><link>https://wldt.github.io/docs/guides/digital-actions/</link><pubDate>Fri, 09 Feb 2024 12:18:13 +0100</pubDate><guid>https://wldt.github.io/docs/guides/digital-actions/</guid><description>In this demo implementation, we are going to emulate an incoming Digital Action on the Digital Adapter in order to show how it can be handled by the adapter and properly forwarded to the Shadowing Function for validation and the consequent interaction with the Physical Adapter and then with the physical twin.</description></item><item><title>Configurable Adapters</title><link>https://wldt.github.io/docs/guides/configurable-adapters/</link><pubDate>Fri, 09 Feb 2024 12:19:37 +0100</pubDate><guid>https://wldt.github.io/docs/guides/configurable-adapters/</guid><description>The WLDT library provides a native method to define Configurable Physical ad Digital Adapters specifying a custom configuration class passed as parameter in the constructor.</description></item></channel></rss>
\ No newline at end of file
diff --git a/docs/guides/physical-adapter/index.html b/docs/guides/physical-adapter/index.html
new file mode 100644
index 0000000..cdfee67
--- /dev/null
+++ b/docs/guides/physical-adapter/index.html
@@ -0,0 +1,261 @@
+<!doctype html><html lang=en data-bs-theme=auto><head><meta charset=utf-8><meta http-equiv=x-ua-compatible content="ie=edge"><meta name=viewport content="width=device-width,initial-scale=1"><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-regular.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-500.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-700.woff2 type=font/woff2 crossorigin><script src=https://wldt.github.io/js/color-mode.86a91f050a481d0a3f0c72ac26543cb6228c770875981c58dcbc008fd3f875c8.js integrity="sha256-hqkfBQpIHQo/DHKsJlQ8tiKMdwh1mBxY3LwAj9P4dcg="></script>
+<link rel=stylesheet href=https://wldt.github.io/main.5fb433a44687c98f7ae7b3d0137c762777049ba27235e1f08c279c03c8533a7a9a1e3b0ef5b125a31b6bb63a362cdcbc39c3706ed41ad7f1a620b9281013866c.css integrity="sha512-X7QzpEaHyY9657PQE3x2J3cEm6JyNeHwjCecA8hTOnqaHjsO9bEloxtrtjo2LNy8OcNwbtQa1/GmILkoEBOGbA==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>Physical Adapter | WLDT</title><meta property="canonical" content="https://wldt.github.io/docs/guides/physical-adapter/"><meta name=description content="The developer can use an existing Physical Adapter or create a new one to handle the communication with a specific physical twin."><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/docs/guides/physical-adapter/"><meta property="og:title" content="Physical Adapter"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:section" content="docs"><meta property="og:description" content="The developer can use an existing Physical Adapter or create a new one to handle the communication with a specific physical twin."><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-model/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-life-cycle/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/library-structure-basic-concepts/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/physical-adapter/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/shadowing-function/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/digital-adapter/"><meta name=twitter:card content="summary"><meta name=twitter:title content="Physical Adapter"><meta name=twitter:description content="The developer can use an existing Physical Adapter or create a new one to handle the communication with a specific physical twin."><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","item":"https://wldt.github.io/docs/","name":"Docs","position":2},{"@type":"ListItem","item":"https://wldt.github.io/docs/guides/","name":"Getting Started","position":3},{"@type":"ListItem","name":"Physical Adapter","position":4}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="single section docs" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
+<button type=button id=searchToggleMobile class="btn btn-link nav-link mx-2 d-lg-none" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button class="btn btn-link d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavSection aria-controls=offcanvasNavSection aria-label="Open section navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-dots-vertical" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 19m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 5m-1 0a1 1 0 102 0 1 1 0 10-2 0"/></svg></button><div class="offcanvas offcanvas-start d-lg-none" tabindex=-1 id=offcanvasNavSection aria-labelledby=offcanvasNavSectionLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavSectionLabel>Docs</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class=offcanvas-body><aside class="doks-sidebar mt-n3"><nav id=doks-docs-nav aria-label="Tertiary navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-0b79795d3efc95b9976c7c5b933afce2 aria-expanded=false>
+Introduction</button><div class=collapse id=section-0b79795d3efc95b9976c7c5b933afce2><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-model/>DT Model</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-life-cycle/>DT Life Cycle</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/>Library Structure & Basic Concepts</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-3978929206deee2c125a1d732aae5545 aria-expanded=false>
+Change Logs</button><div class=collapse id=section-3978929206deee2c125a1d732aae5545><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/>Change Log 0.3.0</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-89413bd312d0909efb85e6693f36cb89 aria-expanded=false>
+Adapters</button><div class=collapse id=section-89413bd312d0909efb85e6693f36cb89><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/>MQTT Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/>MQTT Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/http-digital-adapter/>HTTP Digital Adapter</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-bf647454e36069fd16f1a7a35cf6a865 aria-expanded=true>
+Getting Started</button><div class="collapse show" id=section-bf647454e36069fd16f1a7a35cf6a865><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded active" href=https://wldt.github.io/docs/guides/physical-adapter/>Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/shadowing-function/>Shadowing Function</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-adapter/>Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/>DT Engine & DT Instance</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-actions/>Digital Actions</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/configurable-adapters/>Configurable Adapters</a></li></ul></div></li></ul></nav></aside></div></div><button class="btn btn-link nav-link mx-2 order-3 d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavMain aria-controls=offcanvasNavMain aria-label="Open main navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-menu" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><line x1="4" y1="8" x2="20" y2="8"/><line x1="4" y1="16" x2="20" y2="16"/></svg></button><div class="offcanvas offcanvas-end h-auto" tabindex=-1 id=offcanvasNavMain aria-labelledby=offcanvasNavMainLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavMainLabel>WLDT</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class="offcanvas-body d-flex flex-column flex-lg-row justify-content-between"><ul class="navbar-nav flex-grow-1"><li class=nav-item><a class=nav-link href=https://wldt.github.io/docs/guides/example-guide/>Documentation</a></li><li class=nav-item><a class=nav-link href=https://wldt.github.io/blog/>Blog</a></li></ul><button type=button id=searchToggleDesktop class="btn btn-link nav-link p-2 d-none d-lg-block" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button id=buttonColorMode class="btn btn-link mx-auto nav-link p-0 ms-lg-2 me-lg-1" type=button aria-label="Toggle theme"><svg data-bs-theme-value="dark" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-moon" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 3c.132.0.263.0.393.0a7.5 7.5.0 007.92 12.446A9 9 0 1112 2.992z"/></svg><svg data-bs-theme-value="light" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-sun" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-4 0a4 4 0 108 0 4 4 0 10-8 0m-5 0h1m8-9v1m8 8h1m-9 8v1M5.6 5.6l.7.7m12.1-.7-.7.7m0 11.4.7.7m-12.1-.7-.7.7"/></svg></button><ul id=socialMenu class="nav mx-auto flex-row order-lg-4"><li class=nav-item><a class="nav-link social-link" href=https://github.com/wldt><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-brand-github" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 19c-4.3 1.4-4.3-2.5-6-3m12 5v-3.5c0-1 .1-1.4-.5-2 2.8-.3 5.5-1.4 5.5-6a4.6 4.6.0 00-1.3-3.2 4.2 4.2.0 00-.1-3.2s-1.1-.3-3.5 1.3a12.3 12.3.0 00-6.2.0C6.5 2.8 5.4 3.1 5.4 3.1a4.2 4.2.0 00-.1 3.2A4.6 4.6.0 004 9.5c0 4.6 2.7 5.7 5.5 6-.6.6-.6 1.2-.5 2V21"/></svg><small class="ms-2 visually-hidden">GitHub</small></a></li></ul></div></div></div></header></div><div class=modal id=searchModal tabindex=-1 aria-labelledby=searchModalLabel aria-hidden=true><div class="modal-dialog modal-dialog-scrollable modal-fullscreen-md-down"><div class=modal-content><div class=modal-header><h1 class="modal-title fs-5 visually-hidden" id=searchModalLabel>Search</h1><button type=button class="btn-close visually-hidden" data-bs-dismiss=modal aria-label=Close></button><div class="search-input flex-grow-1 d-none"><form id=search-form class=search-form action=# method=post accept-charset=utf-8 role=search><label for=query class=visually-hidden>Search</label><div class=d-flex><input type=search id=query name=query class="search-text form-control form-control-lg" placeholder=Search aria-label=Search maxlength=128 autocomplete=off>
+<button type=button class="btn btn-link text-decoration-none px-0 ms-3 d-md-none" data-bs-dismiss=modal aria-label=Close>Cancel</button></div></form></div></div><div class=modal-body><p class="search-loading status message d-none mt-3 text-center">Loading search index…</p><p class="search-no-recent message d-none mt-3 text-center">No recent searches</p><p class="search-no-results message d-none mt-3 text-center">No results for "<strong><span class=query-no-results>Query here</span></strong>"</p><div id=searchResults class=search-results></div><template><article class="search-result list-view"><div class="card my-3"><div class=card-body><header><h2 class="h5 title title-submitted mb-0"><a class="stretched-link text-decoration-none text-reset" href=#>Title here</a></h2><div class="submitted d-none"><time class=created-date>Date here</time></div></header><div class=content>Summary here</div></div></div></article></template></div><div class=modal-footer><ul class="list-inline me-auto d-none d-md-block"><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Enter key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M12 3.53088v3c0 1-1 2-2 2H4m3 3-3-3 3-3"/></g></svg></kbd><span class=DocSearch-Label>to select</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Arrow down" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 3.5v8m3-3-3 3-3-3"/></g></svg></kbd><kbd class=me-2><svg width="15" height="15" aria-label="Arrow up" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 11.5v-8m3 3-3-3-3 3"/></g></svg></kbd><span class=DocSearch-Label>to navigate</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Escape key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M13.6167 8.936c-.1065.3583-.6883.962-1.4875.962-.7993.0-1.653-.9165-1.653-2.1258v-.5678c0-1.2548.7896-2.1016 1.653-2.1016s1.3601.4778 1.4875 1.0724M9 6c-.1352-.4735-.7506-.9219-1.46-.8972-.7092.0246-1.344.57-1.344 1.2166s.4198.8812 1.3445.9805C8.465 7.3992 8.968 7.9337 9 8.5s-.454 1.398-1.4595 1.398C6.6593 9.898 6 9 5.963 8.4851m-1.4748.5368c-.2635.5941-.8099.876-1.5443.876s-1.7073-.6248-1.7073-2.204v-.4603c0-1.0416.721-2.131 1.7073-2.131.9864.0 1.6425 1.031 1.5443 2.2492h-2.956"/></g></svg></kbd><span class=DocSearch-Label>to close</span></li></ul><p class=d-md-none>Search by <a class=text-decoration-none href=https://github.com/nextapps-de/flexsearch>FlexSearch</a></p></div></div></div></div><div class="wrap container-lg" role=document><div class=content><div class="row flex-xl-nowrap"><div class="col-lg-5 col-xl-4 docs-sidebar d-none d-lg-block"><nav class=docs-links aria-label="Main navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-0b79795d3efc95b9976c7c5b933afce2 aria-expanded=false>
+Introduction</button><div class=collapse id=section-0b79795d3efc95b9976c7c5b933afce2><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-model/>DT Model</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-life-cycle/>DT Life Cycle</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/>Library Structure & Basic Concepts</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-3978929206deee2c125a1d732aae5545 aria-expanded=false>
+Change Logs</button><div class=collapse id=section-3978929206deee2c125a1d732aae5545><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/>Change Log 0.3.0</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-89413bd312d0909efb85e6693f36cb89 aria-expanded=false>
+Adapters</button><div class=collapse id=section-89413bd312d0909efb85e6693f36cb89><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/>MQTT Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/>MQTT Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/http-digital-adapter/>HTTP Digital Adapter</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-bf647454e36069fd16f1a7a35cf6a865 aria-expanded=true>
+Getting Started</button><div class="collapse show" id=section-bf647454e36069fd16f1a7a35cf6a865><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded active" href=https://wldt.github.io/docs/guides/physical-adapter/>Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/shadowing-function/>Shadowing Function</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-adapter/>Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/>DT Engine & DT Instance</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-actions/>Digital Actions</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/configurable-adapters/>Configurable Adapters</a></li></ul></div></li></ul></nav></div><nav class="docs-toc d-none d-xl-block col-xl-3" aria-label="Secondary navigation"><div class=page-links></div></nav><main class="docs-content col-lg-11 col-xl-9"><nav aria-label=breadcrumb><ol class=breadcrumb><li class=breadcrumb-item><a href=https://wldt.github.io/>Home</a></li><li class=breadcrumb-item><a href=https://wldt.github.io/docs/>Docs</a></li><li class=breadcrumb-item><a href=https://wldt.github.io/docs/guides/>Getting Started</a></li><li class="breadcrumb-item active" aria-current=page>Physical Adapter</li></ol></nav><h1>Physical Adapter</h1><nav class="toc-mobile d-xl-none" aria-label="Quaternary navigation"></nav><p>The developer can use an existing Physical Adapter or create a new one to handle the communication with a specific physical twin.
+In this documentation we focus on the creation of a new Physical Adapter in order to explain library core functionalities.
+However, existing Physical Adapters can be found on the official repository and linked in the core documentation and webpage (<a href=https://github.com/wldt>WLDT-GitHub</a>).</p><p>In general WLDT Physical Adapter extends the class <code>PhysicalAdapter</code> and it is responsible to talk with the physical world and handling the following main tasks:</p><ul><li>Generate a PAD describing the properties, events, actions and relationships available on the physical twin using the class <code>PhysicalAssetDescription</code></li><li>Generate Physical Event using the class <code>PhysicalAssetEventWldtEvent</code> associated to the variation of any aspect of the physical state (properties, events, and relationships)</li><li>Handle action request coming from the Digital World through the DT Shadowing Function by implementing the method <code>onIncomingPhysicalAction</code> and processing events modeled through the class <code>PhysicalAssetActionWldtEvent</code></li></ul><p>Create a new class called <code>DemoPhysicalAdapter</code> extending the library class <code>PhysicalAdapter</code> and implement the following methods:</p><ul><li><code>onAdapterStart</code>: A callback method used to notify when the adapter has been effectively started withing the DT&rsquo;s life cycle</li><li><code>onAdapterStop</code>: A call method invoked when the adapter has been stopped and will be dismissed by the core</li><li><code>onIncomingPhysicalAction</code>: The callback method called when a new <code>PhysicalAssetActionWldtEvent</code> is sent by the Shadowing Function upon the receiving of a valid Digital Action through a Digital Adapter</li></ul><p>Then you have to create a constructor for your Physical Adapter with a single String parameter representing the id of the adapter.
+This id will be used internally by the library to handle and coordinate multiple adapters, adapts logs and execute functions upon the arrival of a new event.
+The resulting empty class will the following:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=kd>public</span> <span class=kd>class</span> <span class=nc>DemoPhysicalAdapter</span> <span class=kd>extends</span> <span class=n>PhysicalAdapter</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=kd>public</span> <span class=nf>DemoPhysicalAdapter</span><span class=o>(</span><span class=n>String</span> <span class=n>id</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        <span class=kd>super</span><span class=o>(</span><span class=n>id</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=nd>@Override</span>
+</span></span><span class=line><span class=cl>    <span class=kd>public</span> <span class=kt>void</span> <span class=nf>onIncomingPhysicalAction</span><span class=o>(</span><span class=n>PhysicalAssetActionWldtEvent</span><span class=o>&lt;?&gt;</span> <span class=n>physicalAssetActionWldtEvent</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=nd>@Override</span>
+</span></span><span class=line><span class=cl>    <span class=kd>public</span> <span class=kt>void</span> <span class=nf>onAdapterStart</span><span class=o>()</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=nd>@Override</span>
+</span></span><span class=line><span class=cl>    <span class=kd>public</span> <span class=kt>void</span> <span class=nf>onAdapterStop</span><span class=o>()</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl><span class=o>}</span>
+</span></span></code></pre></div><p>In our test Physical Adapter example we are going to emulate the communication with an Internet of Things device with the following sensing and actuation characteristics:</p><ul><li>A Temperature Sensor generating data about new measurements</li><li>The possibility to generate OVER-HEATING events</li><li>An action to set the target desired temperature value</li></ul><p>The first step will be to generate and publish the <code>PhysicalAssetDescription</code> (PAD) to describe the capabilities and the characteristics of our object allowing
+the Shadowing Function to decide how to digitalize its physical counterpart.
+<em><strong>Of course in our case the PAD is generated manually but according to the nature of the
+connected physical twin it can be automatically generated starting from a discovery or a configuration passed to the adapter.</strong></em></p><p>The generation of the PAD for each active Physical Adapter is the fundamental DT process to handle the binding procedure
+and to allow the Shadowing Function and consequently the core of the twin to be aware of what is available in the physical world and
+consequently decide what to observe and digitalize.</p><p>In order to publish the PAD we can update the onAdapterStart method with the following lines of code:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=kd>private</span> <span class=kd>final</span> <span class=kd>static</span> <span class=n>String</span> <span class=n>TEMPERATURE_PROPERTY_KEY</span> <span class=o>=</span> <span class=s>&#34;temperature-property-key&#34;</span><span class=o>;</span>
+</span></span><span class=line><span class=cl><span class=kd>private</span> <span class=kd>final</span> <span class=kd>static</span> <span class=n>String</span> <span class=n>OVERHEATING_EVENT_KEY</span> <span class=o>=</span> <span class=s>&#34;overheating-event-key&#34;</span><span class=o>;</span>
+</span></span><span class=line><span class=cl><span class=kd>private</span> <span class=kd>final</span> <span class=kd>static</span> <span class=n>String</span> <span class=n>SET_TEMPERATURE_ACTION_KEY</span> <span class=o>=</span> <span class=s>&#34;set-temperatura-action-key&#34;</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=nd>@Override</span>
+</span></span><span class=line><span class=cl><span class=kd>public</span> <span class=kt>void</span> <span class=nf>onAdapterStart</span><span class=o>()</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>    <span class=k>try</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        <span class=c1>//Create an empty PAD
+</span></span></span><span class=line><span class=cl><span class=c1></span>        <span class=n>PhysicalAssetDescription</span> <span class=n>pad</span> <span class=o>=</span> <span class=k>new</span> <span class=n>PhysicalAssetDescription</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>        
+</span></span><span class=line><span class=cl>        <span class=c1>//Add a new Property associated to the target PAD with a key and a default value
+</span></span></span><span class=line><span class=cl><span class=c1></span>        <span class=n>PhysicalAssetProperty</span><span class=o>&lt;</span><span class=n>Double</span><span class=o>&gt;</span> <span class=n>temperatureProperty</span> <span class=o>=</span> <span class=k>new</span> <span class=n>PhysicalAssetProperty</span><span class=o>&lt;</span><span class=n>Double</span><span class=o>&gt;(</span><span class=n>TEMPERATURE_PROPERTY_KEY</span><span class=o>,</span> <span class=mi>0</span><span class=o>.</span><span class=na>0</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>        <span class=n>pad</span><span class=o>.</span><span class=na>getProperties</span><span class=o>().</span><span class=na>add</span><span class=o>(</span><span class=n>temperatureProperty</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>        
+</span></span><span class=line><span class=cl>        <span class=c1>//Add the declaration of a new type of generated event associated to a event key
+</span></span></span><span class=line><span class=cl><span class=c1></span>        <span class=c1>// and the content type of the generated payload
+</span></span></span><span class=line><span class=cl><span class=c1></span>        <span class=n>PhysicalAssetEvent</span> <span class=n>overheatingEvent</span> <span class=o>=</span> <span class=k>new</span> <span class=n>PhysicalAssetEvent</span><span class=o>(</span><span class=n>OVERHEATING_EVENT_KEY</span><span class=o>,</span> <span class=s>&#34;text/plain&#34;</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>        <span class=n>pad</span><span class=o>.</span><span class=na>getEvents</span><span class=o>().</span><span class=na>add</span><span class=o>(</span><span class=n>overheatingEvent</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>        
+</span></span><span class=line><span class=cl>        <span class=c1>//Declare the availability of a target action characterized by a Key, an action type
+</span></span></span><span class=line><span class=cl><span class=c1></span>        <span class=c1>// and the expected content type and the request body
+</span></span></span><span class=line><span class=cl><span class=c1></span>        <span class=n>PhysicalAssetAction</span> <span class=n>setTemperatureAction</span> <span class=o>=</span> <span class=k>new</span> <span class=n>PhysicalAssetAction</span><span class=o>(</span><span class=n>SET_TEMPERATURE_ACTION_KEY</span><span class=o>,</span> <span class=s>&#34;temperature.actuation&#34;</span><span class=o>,</span> <span class=s>&#34;text/plain&#34;</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>        <span class=n>pad</span><span class=o>.</span><span class=na>getActions</span><span class=o>().</span><span class=na>add</span><span class=o>(</span><span class=n>setTemperatureAction</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>        
+</span></span><span class=line><span class=cl>        <span class=c1>//Notify the new PAD to the DT&#39;s Shadowing Function
+</span></span></span><span class=line><span class=cl><span class=c1></span>        <span class=k>this</span><span class=o>.</span><span class=na>notifyPhysicalAdapterBound</span><span class=o>(</span><span class=n>pad</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>        
+</span></span><span class=line><span class=cl>        <span class=c1>//TODO add here the Device Emulation method 
+</span></span></span><span class=line><span class=cl><span class=c1></span>        
+</span></span><span class=line><span class=cl>    <span class=o>}</span> <span class=k>catch</span> <span class=o>(</span><span class=n>PhysicalAdapterException</span> <span class=o>|</span> <span class=n>EventBusException</span> <span class=n>e</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        <span class=n>e</span><span class=o>.</span><span class=na>printStackTrace</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl><span class=o>}</span>
+</span></span></code></pre></div><p>Now we need a simple code to emulate the generation of new temperature measurements and over-heating events.
+In a real Physical Adapter implementation we have to implement the real communication with the physical twin in
+order to read its state variation over time according to the supported protocols.
+In our simplified Physical Adapter we can the following function:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=kd>private</span> <span class=kd>final</span> <span class=kd>static</span> <span class=kt>int</span> <span class=n>MESSAGE_UPDATE_TIME</span> <span class=o>=</span> <span class=mi>1000</span><span class=o>;</span>
+</span></span><span class=line><span class=cl><span class=kd>private</span> <span class=kd>final</span> <span class=kd>static</span> <span class=kt>int</span> <span class=n>MESSAGE_UPDATE_NUMBER</span> <span class=o>=</span> <span class=mi>10</span><span class=o>;</span>
+</span></span><span class=line><span class=cl><span class=kd>private</span> <span class=kd>final</span> <span class=kd>static</span> <span class=kt>double</span> <span class=n>TEMPERATURE_MIN_VALUE</span> <span class=o>=</span> <span class=mi>20</span><span class=o>;</span>
+</span></span><span class=line><span class=cl><span class=kd>private</span> <span class=kd>final</span> <span class=kd>static</span> <span class=kt>double</span> <span class=n>TEMPERATURE_MAX_VALUE</span> <span class=o>=</span> <span class=mi>30</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=kd>private</span> <span class=n>Runnable</span> <span class=nf>deviceEmulation</span><span class=o>(){</span>
+</span></span><span class=line><span class=cl>    <span class=k>return</span> <span class=o>()</span> <span class=o>-&gt;</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        <span class=k>try</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=c1>//Sleep 5 seconds to emulate device startup
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=n>Thread</span><span class=o>.</span><span class=na>sleep</span><span class=o>(</span><span class=mi>5000</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>            
+</span></span><span class=line><span class=cl>            <span class=c1>//Create a new random object to emulate temperature variations
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=n>Random</span> <span class=n>r</span> <span class=o>=</span> <span class=k>new</span> <span class=n>Random</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>            
+</span></span><span class=line><span class=cl>            <span class=c1>//Publish an initial Event for a normal condition
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=n>publishPhysicalAssetEventWldtEvent</span><span class=o>(</span><span class=k>new</span> <span class=n>PhysicalAssetEventWldtEvent</span><span class=o>&lt;&gt;(</span><span class=n>OVERHEATING_EVENT_KEY</span><span class=o>,</span> <span class=s>&#34;normal&#34;</span><span class=o>));</span>
+</span></span><span class=line><span class=cl>            
+</span></span><span class=line><span class=cl>            <span class=c1>//Emulate the generation on &#39;n&#39; temperature measurements
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=k>for</span><span class=o>(</span><span class=kt>int</span> <span class=n>i</span> <span class=o>=</span> <span class=mi>0</span><span class=o>;</span> <span class=n>i</span> <span class=o>&lt;</span> <span class=n>MESSAGE_UPDATE_NUMBER</span><span class=o>;</span> <span class=n>i</span><span class=o>++){</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>                <span class=c1>//Sleep to emulate sensor measurement
+</span></span></span><span class=line><span class=cl><span class=c1></span>                <span class=n>Thread</span><span class=o>.</span><span class=na>sleep</span><span class=o>(</span><span class=n>MESSAGE_UPDATE_TIME</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>                
+</span></span><span class=line><span class=cl>                <span class=c1>//Update the 
+</span></span></span><span class=line><span class=cl><span class=c1></span>                <span class=kt>double</span> <span class=n>randomTemperature</span> <span class=o>=</span> <span class=n>TEMPERATURE_MIN_VALUE</span> <span class=o>+</span> <span class=o>(</span><span class=n>TEMPERATURE_MAX_VALUE</span> <span class=o>-</span> <span class=n>TEMPERATURE_MIN_VALUE</span><span class=o>)</span> <span class=o>*</span> <span class=n>r</span><span class=o>.</span><span class=na>nextDouble</span><span class=o>();</span> 
+</span></span><span class=line><span class=cl>                
+</span></span><span class=line><span class=cl>                <span class=c1>//Create a new event to notify the variation of a Physical Property
+</span></span></span><span class=line><span class=cl><span class=c1></span>                <span class=n>PhysicalAssetPropertyWldtEvent</span><span class=o>&lt;</span><span class=n>Double</span><span class=o>&gt;</span> <span class=n>newPhysicalPropertyEvent</span> <span class=o>=</span> <span class=k>new</span> <span class=n>PhysicalAssetPropertyWldtEvent</span><span class=o>&lt;&gt;(</span><span class=n>TEMPERATURE_PROPERTY_KEY</span><span class=o>,</span> <span class=n>randomTemperature</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>                
+</span></span><span class=line><span class=cl>                <span class=c1>//Publish the WLDTEvent associated to the Physical Property Variation
+</span></span></span><span class=line><span class=cl><span class=c1></span>                <span class=n>publishPhysicalAssetPropertyWldtEvent</span><span class=o>(</span><span class=n>newPhysicalPropertyEvent</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>            <span class=o>}</span>
+</span></span><span class=line><span class=cl>            
+</span></span><span class=line><span class=cl>            <span class=c1>//Publish a demo Physical Event associated to a &#39;critical&#39; overheating condition
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=n>publishPhysicalAssetEventWldtEvent</span><span class=o>(</span><span class=k>new</span> <span class=n>PhysicalAssetEventWldtEvent</span><span class=o>&lt;&gt;(</span><span class=n>OVERHEATING_EVENT_KEY</span><span class=o>,</span> <span class=s>&#34;critical&#34;</span><span class=o>));</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>        <span class=o>}</span> <span class=k>catch</span> <span class=o>(</span><span class=n>EventBusException</span> <span class=o>|</span> <span class=n>InterruptedException</span> <span class=n>e</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>            <span class=n>e</span><span class=o>.</span><span class=na>printStackTrace</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>        <span class=o>}</span>
+</span></span><span class=line><span class=cl>    <span class=o>};</span>
+</span></span><span class=line><span class=cl><span class=o>}</span>
+</span></span></code></pre></div><p>Now we have to call the <code>deviceEmulationFunction()</code> inside the <code>onAdapterStart()</code> triggering its execution and emulating the physical counterpart of our DT.
+To do that add the following line at the end of the <code>onAdapterStart()</code> method after the <code>this.notifyPhysicalAdapterBound(pad);</code>.</p><p>The last step will be to handle an incoming action trying to set a new temperature on the device by implementing the method <code>onIncomingPhysicalAction()</code>.
+This method will receive a <code>PhysicalAssetActionWldtEvent&lt;?> physicalAssetActionWldtEvent</code> associated to the action request generated by the shadowing function.
+Since a Physical Adapter can handle multiple action we have to check both <code>action-key</code> and <code>body</code> type in order to properly process the action (in our case just logging the request).
+The new update method will result like this:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=nd>@Override</span>
+</span></span><span class=line><span class=cl><span class=kd>public</span> <span class=kt>void</span> <span class=nf>onIncomingPhysicalAction</span><span class=o>(</span><span class=n>PhysicalAssetActionWldtEvent</span><span class=o>&lt;?&gt;</span> <span class=n>physicalAssetActionWldtEvent</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>    <span class=k>try</span><span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>        <span class=k>if</span><span class=o>(</span><span class=n>physicalAssetActionWldtEvent</span> <span class=o>!=</span> <span class=kc>null</span>
+</span></span><span class=line><span class=cl>                <span class=o>&amp;&amp;</span> <span class=n>physicalAssetActionWldtEvent</span><span class=o>.</span><span class=na>getActionKey</span><span class=o>().</span><span class=na>equals</span><span class=o>(</span><span class=n>SET_TEMPERATURE_ACTION_KEY</span><span class=o>)</span>
+</span></span><span class=line><span class=cl>                <span class=o>&amp;&amp;</span> <span class=n>physicalAssetActionWldtEvent</span><span class=o>.</span><span class=na>getBody</span><span class=o>()</span> <span class=k>instanceof</span> <span class=n>String</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>            <span class=n>System</span><span class=o>.</span><span class=na>out</span><span class=o>.</span><span class=na>println</span><span class=o>(</span><span class=s>&#34;Received Action Request: &#34;</span> <span class=o>+</span> <span class=n>physicalAssetActionWldtEvent</span><span class=o>.</span><span class=na>getActionKey</span><span class=o>()</span>
+</span></span><span class=line><span class=cl>                    <span class=o>+</span> <span class=s>&#34; with Body: &#34;</span> <span class=o>+</span> <span class=n>physicalAssetActionWldtEvent</span><span class=o>.</span><span class=na>getBody</span><span class=o>());</span>
+</span></span><span class=line><span class=cl>        <span class=o>}</span>
+</span></span><span class=line><span class=cl>        <span class=k>else</span>
+</span></span><span class=line><span class=cl>            <span class=n>System</span><span class=o>.</span><span class=na>err</span><span class=o>.</span><span class=na>println</span><span class=o>(</span><span class=s>&#34;Wrong Action Received !&#34;</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=o>}</span><span class=k>catch</span> <span class=o>(</span><span class=n>Exception</span> <span class=n>e</span><span class=o>){</span>
+</span></span><span class=line><span class=cl>        <span class=n>e</span><span class=o>.</span><span class=na>printStackTrace</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl><span class=o>}</span>
+</span></span></code></pre></div><p>The overall class will result as following:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=kn>import</span> <span class=nn>it.wldt.adapter.physical.*</span><span class=o>;</span>
+</span></span><span class=line><span class=cl><span class=kn>import</span> <span class=nn>it.wldt.adapter.physical.event.PhysicalAssetActionWldtEvent</span><span class=o>;</span>
+</span></span><span class=line><span class=cl><span class=kn>import</span> <span class=nn>it.wldt.adapter.physical.event.PhysicalAssetEventWldtEvent</span><span class=o>;</span>
+</span></span><span class=line><span class=cl><span class=kn>import</span> <span class=nn>it.wldt.adapter.physical.event.PhysicalAssetPropertyWldtEvent</span><span class=o>;</span>
+</span></span><span class=line><span class=cl><span class=kn>import</span> <span class=nn>it.wldt.exception.EventBusException</span><span class=o>;</span>
+</span></span><span class=line><span class=cl><span class=kn>import</span> <span class=nn>it.wldt.exception.PhysicalAdapterException</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=kn>import</span> <span class=nn>java.util.Random</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=kd>public</span> <span class=kd>class</span> <span class=nc>DemoPhysicalAdapter</span> <span class=kd>extends</span> <span class=n>PhysicalAdapter</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=kd>private</span> <span class=kd>final</span> <span class=kd>static</span> <span class=n>String</span> <span class=n>TEMPERATURE_PROPERTY_KEY</span> <span class=o>=</span> <span class=s>&#34;temperature-property-key&#34;</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>    <span class=kd>private</span> <span class=kd>final</span> <span class=kd>static</span> <span class=n>String</span> <span class=n>OVERHEATING_EVENT_KEY</span> <span class=o>=</span> <span class=s>&#34;overheating-event-key&#34;</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>    <span class=kd>private</span> <span class=kd>final</span> <span class=kd>static</span> <span class=n>String</span> <span class=n>SET_TEMPERATURE_ACTION_KEY</span> <span class=o>=</span> <span class=s>&#34;set-temperature-action-key&#34;</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=kd>private</span> <span class=kd>final</span> <span class=kd>static</span> <span class=kt>int</span> <span class=n>MESSAGE_UPDATE_TIME</span> <span class=o>=</span> <span class=mi>1000</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>    <span class=kd>private</span> <span class=kd>final</span> <span class=kd>static</span> <span class=kt>int</span> <span class=n>MESSAGE_UPDATE_NUMBER</span> <span class=o>=</span> <span class=mi>10</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>    <span class=kd>private</span> <span class=kd>final</span> <span class=kd>static</span> <span class=kt>double</span> <span class=n>TEMPERATURE_MIN_VALUE</span> <span class=o>=</span> <span class=mi>20</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>    <span class=kd>private</span> <span class=kd>final</span> <span class=kd>static</span> <span class=kt>double</span> <span class=n>TEMPERATURE_MAX_VALUE</span> <span class=o>=</span> <span class=mi>30</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=kd>public</span> <span class=nf>DemoPhysicalAdapter</span><span class=o>(</span><span class=n>String</span> <span class=n>id</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        <span class=kd>super</span><span class=o>(</span><span class=n>id</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=nd>@Override</span>
+</span></span><span class=line><span class=cl>    <span class=kd>public</span> <span class=kt>void</span> <span class=nf>onIncomingPhysicalAction</span><span class=o>(</span><span class=n>PhysicalAssetActionWldtEvent</span><span class=o>&lt;?&gt;</span> <span class=n>physicalAssetActionWldtEvent</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        <span class=k>try</span><span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=k>if</span><span class=o>(</span><span class=n>physicalAssetActionWldtEvent</span> <span class=o>!=</span> <span class=kc>null</span>
+</span></span><span class=line><span class=cl>                    <span class=o>&amp;&amp;</span> <span class=n>physicalAssetActionWldtEvent</span><span class=o>.</span><span class=na>getActionKey</span><span class=o>().</span><span class=na>equals</span><span class=o>(</span><span class=n>SET_TEMPERATURE_ACTION_KEY</span><span class=o>)</span>
+</span></span><span class=line><span class=cl>                    <span class=o>&amp;&amp;</span> <span class=n>physicalAssetActionWldtEvent</span><span class=o>.</span><span class=na>getBody</span><span class=o>()</span> <span class=k>instanceof</span> <span class=n>Double</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>                <span class=n>System</span><span class=o>.</span><span class=na>out</span><span class=o>.</span><span class=na>println</span><span class=o>(</span><span class=s>&#34;Received Action Request: &#34;</span> <span class=o>+</span> <span class=n>physicalAssetActionWldtEvent</span><span class=o>.</span><span class=na>getActionKey</span><span class=o>()</span>
+</span></span><span class=line><span class=cl>                        <span class=o>+</span> <span class=s>&#34; with Body: &#34;</span> <span class=o>+</span> <span class=n>physicalAssetActionWldtEvent</span><span class=o>.</span><span class=na>getBody</span><span class=o>());</span>
+</span></span><span class=line><span class=cl>            <span class=o>}</span>
+</span></span><span class=line><span class=cl>            <span class=k>else</span>
+</span></span><span class=line><span class=cl>                <span class=n>System</span><span class=o>.</span><span class=na>err</span><span class=o>.</span><span class=na>println</span><span class=o>(</span><span class=s>&#34;Wrong Action Received !&#34;</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>        <span class=o>}</span><span class=k>catch</span> <span class=o>(</span><span class=n>Exception</span> <span class=n>e</span><span class=o>){</span>
+</span></span><span class=line><span class=cl>            <span class=n>e</span><span class=o>.</span><span class=na>printStackTrace</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>        <span class=o>}</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=nd>@Override</span>
+</span></span><span class=line><span class=cl>    <span class=kd>public</span> <span class=kt>void</span> <span class=nf>onAdapterStart</span><span class=o>()</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        <span class=k>try</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>            <span class=c1>//Create an empty PAD
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=n>PhysicalAssetDescription</span> <span class=n>pad</span> <span class=o>=</span> <span class=k>new</span> <span class=n>PhysicalAssetDescription</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=c1>//Add a new Property associated to the target PAD with a key and a default value
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=n>PhysicalAssetProperty</span><span class=o>&lt;</span><span class=n>Double</span><span class=o>&gt;</span> <span class=n>temperatureProperty</span> <span class=o>=</span> <span class=k>new</span> <span class=n>PhysicalAssetProperty</span><span class=o>&lt;</span><span class=n>Double</span><span class=o>&gt;(</span><span class=n>GlobalKeywords</span><span class=o>.</span><span class=na>TEMPERATURE_PROPERTY_KEY</span><span class=o>,</span> <span class=mi>0</span><span class=o>.</span><span class=na>0</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>            <span class=n>pad</span><span class=o>.</span><span class=na>getProperties</span><span class=o>().</span><span class=na>add</span><span class=o>(</span><span class=n>temperatureProperty</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=c1>//Add the declaration of a new type of generated event associated to a event key
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=c1>// and the content type of the generated payload
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=n>PhysicalAssetEvent</span> <span class=n>overheatingEvent</span> <span class=o>=</span> <span class=k>new</span> <span class=n>PhysicalAssetEvent</span><span class=o>(</span><span class=n>GlobalKeywords</span><span class=o>.</span><span class=na>OVERHEATING_EVENT_KEY</span><span class=o>,</span> <span class=s>&#34;text/plain&#34;</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>            <span class=n>pad</span><span class=o>.</span><span class=na>getEvents</span><span class=o>().</span><span class=na>add</span><span class=o>(</span><span class=n>overheatingEvent</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=c1>//Declare the availability of a target action characterized by a Key, an action type
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=c1>// and the expected content type and the request body
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=n>PhysicalAssetAction</span> <span class=n>setTemperatureAction</span> <span class=o>=</span> <span class=k>new</span> <span class=n>PhysicalAssetAction</span><span class=o>(</span><span class=n>GlobalKeywords</span><span class=o>.</span><span class=na>SET_TEMPERATURE_ACTION_KEY</span><span class=o>,</span> <span class=s>&#34;temperature.actuation&#34;</span><span class=o>,</span> <span class=s>&#34;text/plain&#34;</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>            <span class=n>pad</span><span class=o>.</span><span class=na>getActions</span><span class=o>().</span><span class=na>add</span><span class=o>(</span><span class=n>setTemperatureAction</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=c1>//Notify the new PAD to the DT&#39;s Shadowing Function
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=k>this</span><span class=o>.</span><span class=na>notifyPhysicalAdapterBound</span><span class=o>(</span><span class=n>pad</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=c1>//Start Device Emulation
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=k>new</span> <span class=n>Thread</span><span class=o>(</span><span class=n>deviceEmulation</span><span class=o>()).</span><span class=na>start</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>        <span class=o>}</span> <span class=k>catch</span> <span class=o>(</span><span class=n>PhysicalAdapterException</span> <span class=o>|</span> <span class=n>EventBusException</span> <span class=n>e</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>            <span class=n>e</span><span class=o>.</span><span class=na>printStackTrace</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>        <span class=o>}</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=nd>@Override</span>
+</span></span><span class=line><span class=cl>    <span class=kd>public</span> <span class=kt>void</span> <span class=nf>onAdapterStop</span><span class=o>()</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=kd>private</span> <span class=n>Runnable</span> <span class=nf>deviceEmulation</span><span class=o>(){</span>
+</span></span><span class=line><span class=cl>        <span class=k>return</span> <span class=o>()</span> <span class=o>-&gt;</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>            <span class=k>try</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>                <span class=c1>//Sleep 5 seconds to emulate device startup
+</span></span></span><span class=line><span class=cl><span class=c1></span>                <span class=n>Thread</span><span class=o>.</span><span class=na>sleep</span><span class=o>(</span><span class=mi>5000</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>                <span class=c1>//Create a new random object to emulate temperature variations
+</span></span></span><span class=line><span class=cl><span class=c1></span>                <span class=n>Random</span> <span class=n>r</span> <span class=o>=</span> <span class=k>new</span> <span class=n>Random</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>                <span class=c1>//Publish an initial Event for a normal condition
+</span></span></span><span class=line><span class=cl><span class=c1></span>                <span class=n>publishPhysicalAssetEventWldtEvent</span><span class=o>(</span><span class=k>new</span> <span class=n>PhysicalAssetEventWldtEvent</span><span class=o>&lt;&gt;(</span><span class=n>GlobalKeywords</span><span class=o>.</span><span class=na>OVERHEATING_EVENT_KEY</span><span class=o>,</span> <span class=s>&#34;normal&#34;</span><span class=o>));</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>                <span class=c1>//Emulate the generation on &#39;n&#39; temperature measurements
+</span></span></span><span class=line><span class=cl><span class=c1></span>                <span class=k>for</span><span class=o>(</span><span class=kt>int</span> <span class=n>i</span> <span class=o>=</span> <span class=mi>0</span><span class=o>;</span> <span class=n>i</span> <span class=o>&lt;</span> <span class=n>GlobalKeywords</span><span class=o>.</span><span class=na>MESSAGE_UPDATE_NUMBER</span><span class=o>;</span> <span class=n>i</span><span class=o>++){</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>                    <span class=c1>//Sleep to emulate sensor measurement
+</span></span></span><span class=line><span class=cl><span class=c1></span>                    <span class=n>Thread</span><span class=o>.</span><span class=na>sleep</span><span class=o>(</span><span class=n>GlobalKeywords</span><span class=o>.</span><span class=na>MESSAGE_UPDATE_TIME</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>                    <span class=c1>//Update the
+</span></span></span><span class=line><span class=cl><span class=c1></span>                    <span class=kt>double</span> <span class=n>randomTemperature</span> <span class=o>=</span> <span class=n>GlobalKeywords</span><span class=o>.</span><span class=na>TEMPERATURE_MIN_VALUE</span> <span class=o>+</span> <span class=o>(</span><span class=n>GlobalKeywords</span><span class=o>.</span><span class=na>TEMPERATURE_MAX_VALUE</span> <span class=o>-</span> <span class=n>GlobalKeywords</span><span class=o>.</span><span class=na>TEMPERATURE_MIN_VALUE</span><span class=o>)</span> <span class=o>*</span> <span class=n>r</span><span class=o>.</span><span class=na>nextDouble</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>                    <span class=c1>//Create a new event to notify the variation of a Physical Property
+</span></span></span><span class=line><span class=cl><span class=c1></span>                    <span class=n>PhysicalAssetPropertyWldtEvent</span><span class=o>&lt;</span><span class=n>Double</span><span class=o>&gt;</span> <span class=n>newPhysicalPropertyEvent</span> <span class=o>=</span> <span class=k>new</span> <span class=n>PhysicalAssetPropertyWldtEvent</span><span class=o>&lt;&gt;(</span><span class=n>GlobalKeywords</span><span class=o>.</span><span class=na>TEMPERATURE_PROPERTY_KEY</span><span class=o>,</span> <span class=n>randomTemperature</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>                    <span class=c1>//Publish the WLDTEvent associated to the Physical Property Variation
+</span></span></span><span class=line><span class=cl><span class=c1></span>                    <span class=n>publishPhysicalAssetPropertyWldtEvent</span><span class=o>(</span><span class=n>newPhysicalPropertyEvent</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>                <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>                <span class=c1>//Publish a demo Physical Event associated to a &#39;critical&#39; overheating condition
+</span></span></span><span class=line><span class=cl><span class=c1></span>                <span class=n>publishPhysicalAssetEventWldtEvent</span><span class=o>(</span><span class=k>new</span> <span class=n>PhysicalAssetEventWldtEvent</span><span class=o>&lt;&gt;(</span><span class=n>GlobalKeywords</span><span class=o>.</span><span class=na>OVERHEATING_EVENT_KEY</span><span class=o>,</span> <span class=s>&#34;critical&#34;</span><span class=o>));</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=o>}</span> <span class=k>catch</span> <span class=o>(</span><span class=n>EventBusException</span> <span class=o>|</span> <span class=n>InterruptedException</span> <span class=n>e</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>                <span class=n>e</span><span class=o>.</span><span class=na>printStackTrace</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>            <span class=o>}</span>
+</span></span><span class=line><span class=cl>        <span class=o>};</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl><span class=o>}</span>
+</span></span></code></pre></div><p>Both Physical Adapters and Digital Adapters can be defined natively with a custom configuration provided by the developer
+as illustrated in the dedicated Section: <a href=#configurable-physical-and-digital-adapters>Configurable Physical & Digital Adapters</a>.</p><div class="page-footer-meta d-flex flex-column flex-md-row justify-content-between"><div class=last-modified><a href=https://github.com/wldt/wldt.github.io/commit/ab5a164de259055162e9420d8cb56c2b1562dee9><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-calendar"><rect x="3" y="4" width="18" height="18" rx="2" ry="2"/><line x1="16" y1="2" x2="16" y2="6"/><line x1="8" y1="2" x2="8" y2="6"/><line x1="3" y1="10" x2="21" y2="10"/></svg>Last updated on February 9, 2024</a></div><div class=edit-page><a href=https://github.com/wldt/wldt.github.io/blob/main/content//docs/guides/physical-adapter.md><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-edit-2"><path d="M17 3a2.828 2.828.0 114 4L7.5 20.5 2 22l1.5-5.5L17 3z"/></svg>Edit this page on GitHub</a></div></div><div class="page-nav d-flex flex-column flex-sm-row"><div class="card text-end w-100"><div class="card-body d-flex justify-content-end"><div class="d-flex flex-column"><div class=text-body-secondary>Next</div><a href=https://wldt.github.io/docs/guides/shadowing-function/ class="stretched-link text-reset text-decoration-none">Shadowing Function</a></div><div class="d-flex flex-column justify-content-center"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-arrow-right" width="20" height="20" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 12h14"/><path d="M13 18l6-6"/><path d="M13 6l6 6"/></svg></div></div></div></div></main></div></div></div><footer class="footer text-muted"><div class=container-lg><div class=row><div class="col-lg-8 text-center text-lg-start"><ul class=list-inline><li class=list-inline-item><a class=text-muted href=https://wldt.github.io/privacy/>Privacy Policy</a></li></ul></div><div class="col-lg-8 text-center text-lg-end"><ul class=list-inline><li class=list-inline-item>Brought to you by <a class=text-muted href=https://gethyas.com/>Hyas</a></li></ul></div></div></div></footer><script async src=https://wldt.github.io/js/app.1e84dcdaa5ccef6fe83f6d88ac1e444a1f237111cfa2a7a97427f758e9c27ef4.js integrity="sha256-HoTc2qXM72/oP22IrB5ESh8jcRHPoqepdCf3WOnCfvQ="></script>
+<script async src=https://wldt.github.io/js/flexsearch.dc00caef2c3490dbab3c345ed0d4133b0aafb803efeb21c3df80776d6d3ea821.js integrity="sha256-3ADK7yw0kNurPDRe0NQTOwqvuAPv6yHD34B3bW0+qCE="></script><script async src=https://wldt.github.io/js/search-modal.c4c023efcdee308e4b5f1110afe1db6b1656f217e67aa7efe54e2f4bf2feccf8.js integrity="sha256-xMAj783uMI5LXxEQr+HbaxZW8hfmeqfv5U4vS/L+zPg="></script><div class="d-inline-flex fixed-bottom-right pb-4 pe-4"><button id=toTop type=button class="btn btn-primary rounded-circle ms-auto p-2"><span class=visually-hidden>Top</span><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-chevron-up" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M6 15l6-6 6 6"/></svg></button></div></body></html>
\ No newline at end of file
diff --git a/docs/guides/shadowing-function/index.html b/docs/guides/shadowing-function/index.html
new file mode 100644
index 0000000..34058f3
--- /dev/null
+++ b/docs/guides/shadowing-function/index.html
@@ -0,0 +1,277 @@
+<!doctype html><html lang=en data-bs-theme=auto><head><meta charset=utf-8><meta http-equiv=x-ua-compatible content="ie=edge"><meta name=viewport content="width=device-width,initial-scale=1"><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-regular.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-500.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-700.woff2 type=font/woff2 crossorigin><script src=https://wldt.github.io/js/color-mode.86a91f050a481d0a3f0c72ac26543cb6228c770875981c58dcbc008fd3f875c8.js integrity="sha256-hqkfBQpIHQo/DHKsJlQ8tiKMdwh1mBxY3LwAj9P4dcg="></script>
+<link rel=stylesheet href=https://wldt.github.io/main.5fb433a44687c98f7ae7b3d0137c762777049ba27235e1f08c279c03c8533a7a9a1e3b0ef5b125a31b6bb63a362cdcbc39c3706ed41ad7f1a620b9281013866c.css integrity="sha512-X7QzpEaHyY9657PQE3x2J3cEm6JyNeHwjCecA8hTOnqaHjsO9bEloxtrtjo2LNy8OcNwbtQa1/GmILkoEBOGbA==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>Shadowing Function | WLDT</title><meta property="canonical" content="https://wldt.github.io/docs/guides/shadowing-function/"><meta name=description content="After the definition of the Physical Adapter it is time to start implementing the core of our DT through the definition of its shadowing function in charge of:"><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/docs/guides/shadowing-function/"><meta property="og:title" content="Shadowing Function"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:section" content="docs"><meta property="og:description" content="After the definition of the Physical Adapter it is time to start implementing the core of our DT through the definition of its shadowing function in charge of:"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-model/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-life-cycle/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/library-structure-basic-concepts/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/physical-adapter/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/shadowing-function/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/digital-adapter/"><meta name=twitter:card content="summary"><meta name=twitter:title content="Shadowing Function"><meta name=twitter:description content="After the definition of the Physical Adapter it is time to start implementing the core of our DT through the definition of its shadowing function in charge of:"><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","item":"https://wldt.github.io/docs/","name":"Docs","position":2},{"@type":"ListItem","item":"https://wldt.github.io/docs/guides/","name":"Getting Started","position":3},{"@type":"ListItem","name":"Shadowing Function","position":4}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="single section docs" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
+<button type=button id=searchToggleMobile class="btn btn-link nav-link mx-2 d-lg-none" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button class="btn btn-link d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavSection aria-controls=offcanvasNavSection aria-label="Open section navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-dots-vertical" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 19m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 5m-1 0a1 1 0 102 0 1 1 0 10-2 0"/></svg></button><div class="offcanvas offcanvas-start d-lg-none" tabindex=-1 id=offcanvasNavSection aria-labelledby=offcanvasNavSectionLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavSectionLabel>Docs</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class=offcanvas-body><aside class="doks-sidebar mt-n3"><nav id=doks-docs-nav aria-label="Tertiary navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-0b79795d3efc95b9976c7c5b933afce2 aria-expanded=false>
+Introduction</button><div class=collapse id=section-0b79795d3efc95b9976c7c5b933afce2><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-model/>DT Model</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-life-cycle/>DT Life Cycle</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/>Library Structure & Basic Concepts</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-3978929206deee2c125a1d732aae5545 aria-expanded=false>
+Change Logs</button><div class=collapse id=section-3978929206deee2c125a1d732aae5545><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/>Change Log 0.3.0</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-89413bd312d0909efb85e6693f36cb89 aria-expanded=false>
+Adapters</button><div class=collapse id=section-89413bd312d0909efb85e6693f36cb89><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/>MQTT Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/>MQTT Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/http-digital-adapter/>HTTP Digital Adapter</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-bf647454e36069fd16f1a7a35cf6a865 aria-expanded=true>
+Getting Started</button><div class="collapse show" id=section-bf647454e36069fd16f1a7a35cf6a865><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/physical-adapter/>Physical Adapter</a></li><li><a class="docs-link rounded active" href=https://wldt.github.io/docs/guides/shadowing-function/>Shadowing Function</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-adapter/>Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/>DT Engine & DT Instance</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-actions/>Digital Actions</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/configurable-adapters/>Configurable Adapters</a></li></ul></div></li></ul></nav></aside></div></div><button class="btn btn-link nav-link mx-2 order-3 d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavMain aria-controls=offcanvasNavMain aria-label="Open main navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-menu" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><line x1="4" y1="8" x2="20" y2="8"/><line x1="4" y1="16" x2="20" y2="16"/></svg></button><div class="offcanvas offcanvas-end h-auto" tabindex=-1 id=offcanvasNavMain aria-labelledby=offcanvasNavMainLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavMainLabel>WLDT</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class="offcanvas-body d-flex flex-column flex-lg-row justify-content-between"><ul class="navbar-nav flex-grow-1"><li class=nav-item><a class=nav-link href=https://wldt.github.io/docs/guides/example-guide/>Documentation</a></li><li class=nav-item><a class=nav-link href=https://wldt.github.io/blog/>Blog</a></li></ul><button type=button id=searchToggleDesktop class="btn btn-link nav-link p-2 d-none d-lg-block" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button id=buttonColorMode class="btn btn-link mx-auto nav-link p-0 ms-lg-2 me-lg-1" type=button aria-label="Toggle theme"><svg data-bs-theme-value="dark" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-moon" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 3c.132.0.263.0.393.0a7.5 7.5.0 007.92 12.446A9 9 0 1112 2.992z"/></svg><svg data-bs-theme-value="light" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-sun" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-4 0a4 4 0 108 0 4 4 0 10-8 0m-5 0h1m8-9v1m8 8h1m-9 8v1M5.6 5.6l.7.7m12.1-.7-.7.7m0 11.4.7.7m-12.1-.7-.7.7"/></svg></button><ul id=socialMenu class="nav mx-auto flex-row order-lg-4"><li class=nav-item><a class="nav-link social-link" href=https://github.com/wldt><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-brand-github" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 19c-4.3 1.4-4.3-2.5-6-3m12 5v-3.5c0-1 .1-1.4-.5-2 2.8-.3 5.5-1.4 5.5-6a4.6 4.6.0 00-1.3-3.2 4.2 4.2.0 00-.1-3.2s-1.1-.3-3.5 1.3a12.3 12.3.0 00-6.2.0C6.5 2.8 5.4 3.1 5.4 3.1a4.2 4.2.0 00-.1 3.2A4.6 4.6.0 004 9.5c0 4.6 2.7 5.7 5.5 6-.6.6-.6 1.2-.5 2V21"/></svg><small class="ms-2 visually-hidden">GitHub</small></a></li></ul></div></div></div></header></div><div class=modal id=searchModal tabindex=-1 aria-labelledby=searchModalLabel aria-hidden=true><div class="modal-dialog modal-dialog-scrollable modal-fullscreen-md-down"><div class=modal-content><div class=modal-header><h1 class="modal-title fs-5 visually-hidden" id=searchModalLabel>Search</h1><button type=button class="btn-close visually-hidden" data-bs-dismiss=modal aria-label=Close></button><div class="search-input flex-grow-1 d-none"><form id=search-form class=search-form action=# method=post accept-charset=utf-8 role=search><label for=query class=visually-hidden>Search</label><div class=d-flex><input type=search id=query name=query class="search-text form-control form-control-lg" placeholder=Search aria-label=Search maxlength=128 autocomplete=off>
+<button type=button class="btn btn-link text-decoration-none px-0 ms-3 d-md-none" data-bs-dismiss=modal aria-label=Close>Cancel</button></div></form></div></div><div class=modal-body><p class="search-loading status message d-none mt-3 text-center">Loading search index…</p><p class="search-no-recent message d-none mt-3 text-center">No recent searches</p><p class="search-no-results message d-none mt-3 text-center">No results for "<strong><span class=query-no-results>Query here</span></strong>"</p><div id=searchResults class=search-results></div><template><article class="search-result list-view"><div class="card my-3"><div class=card-body><header><h2 class="h5 title title-submitted mb-0"><a class="stretched-link text-decoration-none text-reset" href=#>Title here</a></h2><div class="submitted d-none"><time class=created-date>Date here</time></div></header><div class=content>Summary here</div></div></div></article></template></div><div class=modal-footer><ul class="list-inline me-auto d-none d-md-block"><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Enter key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M12 3.53088v3c0 1-1 2-2 2H4m3 3-3-3 3-3"/></g></svg></kbd><span class=DocSearch-Label>to select</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Arrow down" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 3.5v8m3-3-3 3-3-3"/></g></svg></kbd><kbd class=me-2><svg width="15" height="15" aria-label="Arrow up" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 11.5v-8m3 3-3-3-3 3"/></g></svg></kbd><span class=DocSearch-Label>to navigate</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Escape key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M13.6167 8.936c-.1065.3583-.6883.962-1.4875.962-.7993.0-1.653-.9165-1.653-2.1258v-.5678c0-1.2548.7896-2.1016 1.653-2.1016s1.3601.4778 1.4875 1.0724M9 6c-.1352-.4735-.7506-.9219-1.46-.8972-.7092.0246-1.344.57-1.344 1.2166s.4198.8812 1.3445.9805C8.465 7.3992 8.968 7.9337 9 8.5s-.454 1.398-1.4595 1.398C6.6593 9.898 6 9 5.963 8.4851m-1.4748.5368c-.2635.5941-.8099.876-1.5443.876s-1.7073-.6248-1.7073-2.204v-.4603c0-1.0416.721-2.131 1.7073-2.131.9864.0 1.6425 1.031 1.5443 2.2492h-2.956"/></g></svg></kbd><span class=DocSearch-Label>to close</span></li></ul><p class=d-md-none>Search by <a class=text-decoration-none href=https://github.com/nextapps-de/flexsearch>FlexSearch</a></p></div></div></div></div><div class="wrap container-lg" role=document><div class=content><div class="row flex-xl-nowrap"><div class="col-lg-5 col-xl-4 docs-sidebar d-none d-lg-block"><nav class=docs-links aria-label="Main navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-0b79795d3efc95b9976c7c5b933afce2 aria-expanded=false>
+Introduction</button><div class=collapse id=section-0b79795d3efc95b9976c7c5b933afce2><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-model/>DT Model</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-life-cycle/>DT Life Cycle</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/>Library Structure & Basic Concepts</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-3978929206deee2c125a1d732aae5545 aria-expanded=false>
+Change Logs</button><div class=collapse id=section-3978929206deee2c125a1d732aae5545><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/>Change Log 0.3.0</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-89413bd312d0909efb85e6693f36cb89 aria-expanded=false>
+Adapters</button><div class=collapse id=section-89413bd312d0909efb85e6693f36cb89><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/>MQTT Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/>MQTT Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/http-digital-adapter/>HTTP Digital Adapter</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-bf647454e36069fd16f1a7a35cf6a865 aria-expanded=true>
+Getting Started</button><div class="collapse show" id=section-bf647454e36069fd16f1a7a35cf6a865><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/physical-adapter/>Physical Adapter</a></li><li><a class="docs-link rounded active" href=https://wldt.github.io/docs/guides/shadowing-function/>Shadowing Function</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-adapter/>Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/>DT Engine & DT Instance</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-actions/>Digital Actions</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/configurable-adapters/>Configurable Adapters</a></li></ul></div></li></ul></nav></div><nav class="docs-toc d-none d-xl-block col-xl-3" aria-label="Secondary navigation"><div class=page-links></div></nav><main class="docs-content col-lg-11 col-xl-9"><nav aria-label=breadcrumb><ol class=breadcrumb><li class=breadcrumb-item><a href=https://wldt.github.io/>Home</a></li><li class=breadcrumb-item><a href=https://wldt.github.io/docs/>Docs</a></li><li class=breadcrumb-item><a href=https://wldt.github.io/docs/guides/>Getting Started</a></li><li class="breadcrumb-item active" aria-current=page>Shadowing Function</li></ol></nav><h1>Shadowing Function</h1><nav class="toc-mobile d-xl-none" aria-label="Quaternary navigation"></nav><p>After the definition of the Physical Adapter it is time to start implementing the core of our DT through the definition of
+its shadowing function in charge of:</p><ul><li>Handle received PAD from Physical Adapters in order to device which properties, events, relationships or actions available on connected physical twins should be mapped and managed into the DT State</li><li>Manage incoming notifications/callbacks associated to the variation of physical properties (e.g, temperature variation) or the generation of physical event (e.g., overheating)</li><li>Process action requests from the digital world that should be validated and forward to the correct Physical Adapter in order to trigger the associated actions on the physical world</li></ul><p>The Shadowing Function has the responsibility to build and maintain the updated state of the Digital Twin
+The internal variable of any WLDT Shadowing Function (available through the base class <code>ShadowingFunction</code>) used to do that is <code>DigitalTwinStateManager</code> accessible through the variable: <code>this.digitalTwinStateManager</code></p><p>When the Shadowing Function has to compute the new DT State it can now work with the following method to handle DT State Transition:</p><ul><li>Start the DT State Transaction: <code>startStateTransaction()</code></li><li>DT State variation methods such as:<ul><li><code>createProperty()</code></li><li><code>updateProperty()</code></li><li><code>updatePropertyValue()</code></li><li><code>deleteProperty()</code></li><li><code>enableAction()</code></li><li><code>updateAction()</code></li><li><code>disableAction()</code></li><li><code>registerEvent()</code></li><li><code>updateRegisteredEvent()</code></li><li><code>unRegisterEvent()</code></li><li><code>createRelationship()</code></li><li><code>addRelationshipInstance()</code></li><li><code>deleteRelationship()</code></li><li><code>deleteRelationshipInstance()</code></li></ul></li><li>At the end the transaction can be committed using the method: <code>commitStateTransaction()</code></li></ul><p>To access the current DT State the Shadowing Function implementation can use the method <code>this.digitalTwinStateManager.getDigitalTwinState()</code>
+The information available on the DT State are:</p><ul><li><code>properties</code>: List of Properties with their values (if available)</li><li><code>actions</code>: List of Actions that can be called on the DT</li><li><code>events</code>: List of Events that can be generated by the DT</li><li><code>relationships</code>: List of Relationships and their instances (if available)</li><li><code>evaluationInstant</code>: The timestamp representing the evaluation instant of the DT state</li></ul><p>Available main methods on that class instance are:</p><ul><li>Properties:<ul><li><code>getProperty(String propertyKey)</code>: Retrieves if present the target DigitalTwinStateProperty by Key</li><li><code>containsProperty(String propertyKey)</code>: Checks if a target Property Key is already available in the current Digital Twin&rsquo;s State</li><li><code>getPropertyList()</code>: Loads the list of available Properties (described by the class DigitalTwinStateProperty) available on the Digital Twin&rsquo;s State</li><li><code>createProperty(DigitalTwinStateProperty&lt;?> dtStateProperty)</code>: Allows the creation of a new Property on the Digital Twin&rsquo;s State through the class DigitalTwinStateProperty</li><li><code>readProperty(String propertyKey)</code>: Retrieves if present the target DigitalTwinStateProperty by Key</li><li><code>updateProperty(DigitalTwinStateProperty&lt;?> dtStateProperty)</code>: Updates the target property using the DigitalTwinStateProperty and the associated Property Key field</li><li><code>deleteProperty(String propertyKey)</code>: Deletes the target property identified by the specified key</li></ul></li><li>Actions:<ul><li><code>containsAction(String actionKey)</code>: Checks if a Digital Twin State Action with the specified key is correctly registered</li><li><code>getAction(String actionKey)</code>: Loads the target DigitalTwinStateAction by key</li><li><code>getActionList()</code>: Gets the list of available Actions registered on the Digital Twin&rsquo;s State</li><li><code>enableAction(DigitalTwinStateAction digitalTwinStateAction)</code>: Enables and registers the target Action described through an instance of the DigitalTwinStateAction class</li><li><code>updateAction(DigitalTwinStateAction digitalTwinStateAction)</code>: Update the already registered target Action described through an instance of the DigitalTwinStateAction class</li><li><code>disableAction(String actionKey)</code>: Disables and unregisters the target Action described through an instance of the DigitalTwinStateAction class</li></ul></li><li>Events:<ul><li><code>containsEvent(String eventKey)</code>: Check if a Digital Twin State Event with the specified key is correctly registered</li><li><code>getEvent(String eventKey)</code>: Return the description of a registered Digital Twin State Event according to its Key</li><li><code>getEventList()</code>: Return the list of existing and registered Digital Twin State Events</li><li><code>registerEvent(DigitalTwinStateEvent digitalTwinStateEvent)</code>: Register a new Digital Twin State Event</li><li><code>updateRegisteredEvent(DigitalTwinStateEvent digitalTwinStateEvent)</code>: Update the registration and signature of an existing Digital Twin State Event</li><li><code>unRegisterEvent(String eventKey)</code>: Un-register a Digital Twin State Event</li><li><code>notifyDigitalTwinStateEvent(DigitalTwinStateEventNotification&lt;?> digitalTwinStateEventNotification)</code>: Method to notify the occurrence of the target Digital Twin State Event</li></ul></li><li>Relationships:<ul><li><code>containsRelationship(String relationshipName)</code>: Checks if a Relationship Name is already available in the current Digital Twin&rsquo;s State</li><li><code>createRelationship(DigitalTwinStateRelationship&lt;?> relationship)</code>: Creates a new Relationships (described by the class DigitalTwinStateRelationship) in the Digital Twin&rsquo;s State</li><li><code>addRelationshipInstance(String name, DigitalTwinStateRelationshipInstance&lt;?> instance)</code>: Adds a new Relationship instance described through the class DigitalTwinStateRelationshipInstance and identified through its name</li><li><code>getRelationshipList()</code>: Loads the list of existing relationships on the Digital Twin&rsquo;s State through a list of DigitalTwinStateRelationship</li><li><code>getRelationship(String name)</code>: Gets a target Relationship identified through its name and described through the class DigitalTwinStateRelationship</li><li><code>deleteRelationship(String name)</code>: Deletes a target Relationship identified through its name</li><li><code>deleteRelationshipInstance(String relationshipName, String instanceKey)</code>: Deletes the target Relationship Instance using relationship name and instance Key</li></ul></li></ul><p>The basic library class that we are going to extend is called <code>ShadowingFunction</code> and creating a new class named <code>DemoShadowingFunction</code> the resulting
+code is the same after implementing required methods the basic constructor with the id String parameter.</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=kn>import</span> <span class=nn>it.wldt.adapter.digital.event.DigitalActionWldtEvent</span><span class=o>;</span>
+</span></span><span class=line><span class=cl><span class=kn>import</span> <span class=nn>it.wldt.adapter.physical.PhysicalAssetDescription</span><span class=o>;</span>
+</span></span><span class=line><span class=cl><span class=kn>import</span> <span class=nn>it.wldt.adapter.physical.event.PhysicalAssetEventWldtEvent</span><span class=o>;</span>
+</span></span><span class=line><span class=cl><span class=kn>import</span> <span class=nn>it.wldt.adapter.physical.event.PhysicalAssetPropertyWldtEvent</span><span class=o>;</span>
+</span></span><span class=line><span class=cl><span class=kn>import</span> <span class=nn>it.wldt.adapter.physical.event.PhysicalAssetRelationshipInstanceCreatedWldtEvent</span><span class=o>;</span>
+</span></span><span class=line><span class=cl><span class=kn>import</span> <span class=nn>it.wldt.adapter.physical.event.PhysicalAssetRelationshipInstanceDeletedWldtEvent</span><span class=o>;</span>
+</span></span><span class=line><span class=cl><span class=kn>import</span> <span class=nn>it.wldt.core.model.ShadowingModelFunction</span><span class=o>;</span>
+</span></span><span class=line><span class=cl><span class=kn>import</span> <span class=nn>java.util.Map</span><span class=o>;</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl><span class=kd>public</span> <span class=kd>class</span> <span class=nc>DemoShadowingFunction</span> <span class=kd>extends</span> <span class=n>ShadowingModelFunction</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=kd>public</span> <span class=nf>DemoShadowingFunction</span><span class=o>(</span><span class=n>String</span> <span class=n>id</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        <span class=kd>super</span><span class=o>(</span><span class=n>id</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=c1>//// Shadowing Function Management Callbacks ////
+</span></span></span><span class=line><span class=cl><span class=c1></span>
+</span></span><span class=line><span class=cl>    <span class=nd>@Override</span>
+</span></span><span class=line><span class=cl>    <span class=kd>protected</span> <span class=kt>void</span> <span class=nf>onCreate</span><span class=o>()</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=nd>@Override</span>
+</span></span><span class=line><span class=cl>    <span class=kd>protected</span> <span class=kt>void</span> <span class=nf>onStart</span><span class=o>()</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=nd>@Override</span>
+</span></span><span class=line><span class=cl>    <span class=kd>protected</span> <span class=kt>void</span> <span class=nf>onStop</span><span class=o>()</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=c1>//// Bound LifeCycle State Management Callbacks ////
+</span></span></span><span class=line><span class=cl><span class=c1></span>
+</span></span><span class=line><span class=cl>    <span class=nd>@Override</span>
+</span></span><span class=line><span class=cl>    <span class=kd>protected</span> <span class=kt>void</span> <span class=nf>onDigitalTwinBound</span><span class=o>(</span><span class=n>Map</span><span class=o>&lt;</span><span class=n>String</span><span class=o>,</span> <span class=n>PhysicalAssetDescription</span><span class=o>&gt;</span> <span class=n>adaptersPhysicalAssetDescriptionMap</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=nd>@Override</span>
+</span></span><span class=line><span class=cl>    <span class=kd>protected</span> <span class=kt>void</span> <span class=nf>onDigitalTwinUnBound</span><span class=o>(</span><span class=n>Map</span><span class=o>&lt;</span><span class=n>String</span><span class=o>,</span> <span class=n>PhysicalAssetDescription</span><span class=o>&gt;</span> <span class=n>map</span><span class=o>,</span> <span class=n>String</span> <span class=n>s</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=nd>@Override</span>
+</span></span><span class=line><span class=cl>    <span class=kd>protected</span> <span class=kt>void</span> <span class=nf>onPhysicalAdapterBidingUpdate</span><span class=o>(</span><span class=n>String</span> <span class=n>s</span><span class=o>,</span> <span class=n>PhysicalAssetDescription</span> <span class=n>physicalAssetDescription</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=c1>//// Physical Property Variation Callback ////
+</span></span></span><span class=line><span class=cl><span class=c1></span>
+</span></span><span class=line><span class=cl>    <span class=nd>@Override</span>
+</span></span><span class=line><span class=cl>    <span class=kd>protected</span> <span class=kt>void</span> <span class=nf>onPhysicalAssetPropertyVariation</span><span class=o>(</span><span class=n>PhysicalAssetPropertyWldtEvent</span><span class=o>&lt;?&gt;</span> <span class=n>physicalAssetPropertyWldtEvent</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=c1>//// Physical Event Notification Callback ////
+</span></span></span><span class=line><span class=cl><span class=c1></span>
+</span></span><span class=line><span class=cl>    <span class=nd>@Override</span>
+</span></span><span class=line><span class=cl>    <span class=kd>protected</span> <span class=kt>void</span> <span class=nf>onPhysicalAssetEventNotification</span><span class=o>(</span><span class=n>PhysicalAssetEventWldtEvent</span><span class=o>&lt;?&gt;</span> <span class=n>physicalAssetEventWldtEvent</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=c1>//// Physical Relationships Notification Callbacks ////
+</span></span></span><span class=line><span class=cl><span class=c1></span>
+</span></span><span class=line><span class=cl>    <span class=nd>@Override</span>
+</span></span><span class=line><span class=cl>    <span class=kd>protected</span> <span class=kt>void</span> <span class=nf>onPhysicalAssetRelationshipEstablished</span><span class=o>(</span><span class=n>PhysicalAssetRelationshipInstanceCreatedWldtEvent</span><span class=o>&lt;?&gt;</span> <span class=n>physicalAssetRelationshipInstanceCreatedWldtEvent</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=nd>@Override</span>
+</span></span><span class=line><span class=cl>    <span class=kd>protected</span> <span class=kt>void</span> <span class=nf>onPhysicalAssetRelationshipDeleted</span><span class=o>(</span><span class=n>PhysicalAssetRelationshipInstanceDeletedWldtEvent</span><span class=o>&lt;?&gt;</span> <span class=n>physicalAssetRelationshipInstanceDeletedWldtEvent</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=c1>//// Digital Action Received Callbacks ////
+</span></span></span><span class=line><span class=cl><span class=c1></span>
+</span></span><span class=line><span class=cl>    <span class=nd>@Override</span>
+</span></span><span class=line><span class=cl>    <span class=kd>protected</span> <span class=kt>void</span> <span class=nf>onDigitalActionEvent</span><span class=o>(</span><span class=n>DigitalActionWldtEvent</span><span class=o>&lt;?&gt;</span> <span class=n>digitalActionWldtEvent</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl><span class=o>}</span>
+</span></span></code></pre></div><p>The methods <code>onCreate()</code>, <code>onStart()</code> and <code>onStop()</code> are used to receive callbacks from the DT&rsquo;s core when the Shadowing Function has been effectively created within the twin, is started or stopped
+according to the evolution of its life cycle. In our initial implementation we are not implementing any of them but they can be useful to trigger specific behaviours according to the different phases.</p><p>The first method that we have to implement in order to analyze received PAD and build the Digital Twin State in terms of properties, events, relationships and available actions is
+the <code>onDigitalTwinBound(Map&lt;String, PhysicalAssetDescription> map)</code> method. In our initial implementation we just pass through all the received characteristics recevied from each connected
+Physical Adapter mapping every physical entity into the DT&rsquo;s state without any change or adaptation (Of course complex behaviour can be implemented to customized the digitalization process).</p><p>Through the following method we implement the following behaviour:</p><ul><li>Analyze each received PAD from each connected and active Physical Adapter (in our case we will have just 1 Physical Adapter)</li><li>Iterate over all the received Properties for each PAD and create the same Property on the Digital Twin State</li><li>Start observing target Physical Properties in order to receive notification callback about physical variation through the method <code>observePhysicalAssetProperty(property);</code></li><li>Analyze received PAD&rsquo;s Events declaration and recreates them also on the DT&rsquo;s State</li><li>Start observing target Physical Event in order to receive notification callback about physical event generation through the method <code>observePhysicalAssetEvent(event);</code></li><li>Check available Physical Action and enable them on the DT&rsquo;s State. Enabled Digital Action are automatically observed by the Shadowing Function in order to receive action requests from active Digital Adapters</li></ul><p>The possibility to manually observe Physical Properties and Event has been introduced to allow the Shadowing Function to decide what
+to do according to the nature of the property or of the target event. For example in some cases with static properties it will not be necessary
+to observe any variation, and it will be enough to read the initial value to build the digital replica of that specific property.</p><p>Since the DT State is managed through the <code>DigitalTwinStateManager</code> class all the changes and variation should be applied on the
+DT ShadowingFunction using the previously presented transaction management and the correct call of methods <code>startStateTransaction()</code> and <code>commitStateTransaction()</code>.</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=nd>@Override</span>
+</span></span><span class=line><span class=cl><span class=kd>protected</span> <span class=kt>void</span> <span class=nf>onDigitalTwinBound</span><span class=o>(</span><span class=n>Map</span><span class=o>&lt;</span><span class=n>String</span><span class=o>,</span> <span class=n>PhysicalAssetDescription</span><span class=o>&gt;</span> <span class=n>adaptersPhysicalAssetDescriptionMap</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=k>try</span><span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>      <span class=c1>// NEW from 0.3.0 -&gt; Start DT State Change Transaction  
+</span></span></span><span class=line><span class=cl><span class=c1></span>      <span class=k>this</span><span class=o>.</span><span class=na>digitalTwinStateManager</span><span class=o>.</span><span class=na>startStateTransaction</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>      <span class=c1>//Iterate over all the received PAD from connected Physical Adapters
+</span></span></span><span class=line><span class=cl><span class=c1></span>        <span class=n>adaptersPhysicalAssetDescriptionMap</span><span class=o>.</span><span class=na>values</span><span class=o>().</span><span class=na>forEach</span><span class=o>(</span><span class=n>pad</span> <span class=o>-&gt;</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=c1>//Iterate over all the received PAD from connected Physical Adapters
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=n>adaptersPhysicalAssetDescriptionMap</span><span class=o>.</span><span class=na>values</span><span class=o>().</span><span class=na>forEach</span><span class=o>(</span><span class=n>pad</span> <span class=o>-&gt;</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>                <span class=n>pad</span><span class=o>.</span><span class=na>getProperties</span><span class=o>().</span><span class=na>forEach</span><span class=o>(</span><span class=n>property</span> <span class=o>-&gt;</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>                <span class=k>try</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>                    
+</span></span><span class=line><span class=cl>                    <span class=c1>//Create and write the property on the DT&#39;s State
+</span></span></span><span class=line><span class=cl><span class=c1></span>                    <span class=k>this</span><span class=o>.</span><span class=na>digitalTwinState</span><span class=o>.</span><span class=na>createProperty</span><span class=o>(</span><span class=k>new</span> <span class=n>DigitalTwinStateProperty</span><span class=o>&lt;&gt;(</span><span class=n>property</span><span class=o>.</span><span class=na>getKey</span><span class=o>(),(</span><span class=n>Double</span><span class=o>)</span> <span class=n>property</span><span class=o>.</span><span class=na>getInitialValue</span><span class=o>()));</span>
+</span></span><span class=line><span class=cl>            
+</span></span><span class=line><span class=cl>                    <span class=c1>//Start observing the variation of the physical property in order to receive notifications
+</span></span></span><span class=line><span class=cl><span class=c1></span>                    <span class=c1>//Without this call the Shadowing Function will not receive any notifications or callback about
+</span></span></span><span class=line><span class=cl><span class=c1></span>                    <span class=c1>//incoming physical property of the target type and with the target key
+</span></span></span><span class=line><span class=cl><span class=c1></span>                    <span class=k>this</span><span class=o>.</span><span class=na>observePhysicalAssetProperty</span><span class=o>(</span><span class=n>property</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>        
+</span></span><span class=line><span class=cl>                <span class=o>}</span> <span class=k>catch</span> <span class=o>(</span><span class=n>Exception</span> <span class=n>e</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>                    <span class=n>e</span><span class=o>.</span><span class=na>printStackTrace</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>                <span class=o>}</span>
+</span></span><span class=line><span class=cl>            <span class=o>});</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=c1>//Iterate over available declared Physical Events for the target Physical Adapter&#39;s PAD
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=n>pad</span><span class=o>.</span><span class=na>getEvents</span><span class=o>().</span><span class=na>forEach</span><span class=o>(</span><span class=n>event</span> <span class=o>-&gt;</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>                <span class=k>try</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>                    <span class=c1>//Instantiate a new DT State Event with the same key and type
+</span></span></span><span class=line><span class=cl><span class=c1></span>                    <span class=n>DigitalTwinStateEvent</span> <span class=n>dtStateEvent</span> <span class=o>=</span> <span class=k>new</span> <span class=n>DigitalTwinStateEvent</span><span class=o>(</span><span class=n>event</span><span class=o>.</span><span class=na>getKey</span><span class=o>(),</span> <span class=n>event</span><span class=o>.</span><span class=na>getType</span><span class=o>());</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>                    <span class=c1>//Create and write the event on the DT&#39;s State
+</span></span></span><span class=line><span class=cl><span class=c1></span>                    <span class=k>this</span><span class=o>.</span><span class=na>digitalTwinState</span><span class=o>.</span><span class=na>registerEvent</span><span class=o>(</span><span class=n>dtStateEvent</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>                    <span class=c1>//Start observing the variation of the physical event in order to receive notifications
+</span></span></span><span class=line><span class=cl><span class=c1></span>                    <span class=c1>//Without this call the Shadowing Function will not receive any notifications or callback about
+</span></span></span><span class=line><span class=cl><span class=c1></span>                    <span class=c1>//incoming physical events of the target type and with the target key
+</span></span></span><span class=line><span class=cl><span class=c1></span>                    <span class=k>this</span><span class=o>.</span><span class=na>observePhysicalAssetEvent</span><span class=o>(</span><span class=n>event</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>                <span class=o>}</span> <span class=k>catch</span> <span class=o>(</span><span class=n>Exception</span> <span class=n>e</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>                    <span class=n>e</span><span class=o>.</span><span class=na>printStackTrace</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>                <span class=o>}</span>
+</span></span><span class=line><span class=cl>            <span class=o>});</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=c1>//Iterate over available declared Physical Actions for the target Physical Adapter&#39;s PAD
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=n>pad</span><span class=o>.</span><span class=na>getActions</span><span class=o>().</span><span class=na>forEach</span><span class=o>(</span><span class=n>action</span> <span class=o>-&gt;</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>                <span class=k>try</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>                    <span class=c1>//Instantiate a new DT State Action with the same key and type
+</span></span></span><span class=line><span class=cl><span class=c1></span>                    <span class=n>DigitalTwinStateAction</span> <span class=n>dtStateAction</span> <span class=o>=</span> <span class=k>new</span> <span class=n>DigitalTwinStateAction</span><span class=o>(</span><span class=n>action</span><span class=o>.</span><span class=na>getKey</span><span class=o>(),</span> <span class=n>action</span><span class=o>.</span><span class=na>getType</span><span class=o>(),</span> <span class=n>action</span><span class=o>.</span><span class=na>getContentType</span><span class=o>());</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>                    <span class=c1>//Enable the action on the DT&#39;s State
+</span></span></span><span class=line><span class=cl><span class=c1></span>                    <span class=k>this</span><span class=o>.</span><span class=na>digitalTwinState</span><span class=o>.</span><span class=na>enableAction</span><span class=o>(</span><span class=n>dtStateAction</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>                <span class=o>}</span> <span class=k>catch</span> <span class=o>(</span><span class=n>Exception</span> <span class=n>e</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>                    <span class=n>e</span><span class=o>.</span><span class=na>printStackTrace</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>                <span class=o>}</span>
+</span></span><span class=line><span class=cl>            <span class=o>});</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>        <span class=o>});</span>
+</span></span><span class=line><span class=cl>            
+</span></span><span class=line><span class=cl>        <span class=c1>// NEW from 0.3.0 -&gt; Commit DT State Change Transaction to apply the changes on the DT State and notify about the change
+</span></span></span><span class=line><span class=cl><span class=c1></span>        <span class=k>this</span><span class=o>.</span><span class=na>digitalTwinStateManager</span><span class=o>.</span><span class=na>commitStateTransaction</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>        <span class=c1>//Start observation to receive all incoming Digital Action through active Digital Adapter
+</span></span></span><span class=line><span class=cl><span class=c1></span>        <span class=c1>//Without this call the Shadowing Function will not receive any notifications or callback about
+</span></span></span><span class=line><span class=cl><span class=c1></span>        <span class=c1>//incoming request to execute an exposed DT&#39;s Action
+</span></span></span><span class=line><span class=cl><span class=c1></span>        <span class=n>observeDigitalActionEvents</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>        <span class=c1>//Notify the DT Core that the Bounding phase has been correctly completed and the DT has evaluated its
+</span></span></span><span class=line><span class=cl><span class=c1></span>        <span class=c1>//internal status according to what is available and declared through the Physical Adapters
+</span></span></span><span class=line><span class=cl><span class=c1></span>        <span class=n>notifyShadowingSync</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=o>}</span><span class=k>catch</span> <span class=o>(</span><span class=n>Exception</span> <span class=n>e</span><span class=o>){</span>
+</span></span><span class=line><span class=cl>        <span class=n>e</span><span class=o>.</span><span class=na>printStackTrace</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl><span class=o>}</span>
+</span></span></code></pre></div><p>In particular the method <code>observeDigitalActionEvents()</code> should be called start the observation of digital actions and
+to receive all incoming Digital Action through active Digital Adapters.
+Without this call the Shadowing Function will not receive any notifications or callback about
+incoming request to execute an exposed DT&rsquo;s Action. Of course, we have to call this method if we are mapping any digital
+action in our DT.</p><p>Another fundamental method is <code>notifyShadowingSync()</code> used to notify the DT Core that
+the Bounding phase has been correctly completed and the DT has evaluated its internal status according
+to what is available and declared through the Physical Adapters.</p><p>As mentioned, in the previous example the Shadowing Function does not apply any control or check on the nature of declared
+physical property. Of course in order to have a more granular control, it will be possible to use property <code>Key</code> or any other field or even
+the type of the instance through an <code>instanceof</code> check to implement different controls and behaviours.</p><p>A variation (only for the property management code) to the previous method can be the following:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=c1>//Iterate over available declared Physical Property for the target Physical Adapter&#39;s PAD 
+</span></span></span><span class=line><span class=cl><span class=c1></span><span class=n>pad</span><span class=o>.</span><span class=na>getProperties</span><span class=o>().</span><span class=na>forEach</span><span class=o>(</span><span class=n>property</span> <span class=o>-&gt;</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>    <span class=k>try</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>        <span class=c1>//Check property Key and Instance of to validate that is a Double
+</span></span></span><span class=line><span class=cl><span class=c1></span>        <span class=k>if</span><span class=o>(</span><span class=n>property</span><span class=o>.</span><span class=na>getKey</span><span class=o>().</span><span class=na>equals</span><span class=o>(</span><span class=s>&#34;temperature-property-key&#34;</span><span class=o>)</span>
+</span></span><span class=line><span class=cl>                <span class=o>&amp;&amp;</span> <span class=n>property</span><span class=o>.</span><span class=na>getInitialValue</span><span class=o>()</span> <span class=o>!=</span> <span class=kc>null</span>
+</span></span><span class=line><span class=cl>                <span class=o>&amp;&amp;</span>  <span class=n>property</span><span class=o>.</span><span class=na>getInitialValue</span><span class=o>()</span> <span class=k>instanceof</span> <span class=n>Double</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=c1>//Instantiate a new DT State Property of the right type, the same key and initial value
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=n>DigitalTwinStateProperty</span><span class=o>&lt;</span><span class=n>Double</span><span class=o>&gt;</span> <span class=n>dtStateProperty</span> <span class=o>=</span> <span class=k>new</span> <span class=n>DigitalTwinStateProperty</span><span class=o>&lt;</span><span class=n>Double</span><span class=o>&gt;(</span><span class=n>property</span><span class=o>.</span><span class=na>getKey</span><span class=o>(),(</span><span class=n>Double</span><span class=o>)</span> <span class=n>property</span><span class=o>.</span><span class=na>getInitialValue</span><span class=o>());</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=c1>//Create and write the property on the DT&#39;s State
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=k>this</span><span class=o>.</span><span class=na>digitalTwinState</span><span class=o>.</span><span class=na>createProperty</span><span class=o>(</span><span class=n>dtStateProperty</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>            <span class=c1>//Start observing the variation of the physical property in order to receive notifications
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=c1>//Without this call the Shadowing Function will not receive any notifications or callback about
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=c1>//incoming physical property of the target type and with the target key
+</span></span></span><span class=line><span class=cl><span class=c1></span>            <span class=k>this</span><span class=o>.</span><span class=na>observePhysicalAssetProperty</span><span class=o>(</span><span class=n>property</span><span class=o>);</span>
+</span></span><span class=line><span class=cl>        <span class=o>}</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>    <span class=o>}</span> <span class=k>catch</span> <span class=o>(</span><span class=n>Exception</span> <span class=n>e</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        <span class=n>e</span><span class=o>.</span><span class=na>printStackTrace</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl><span class=o>});</span>
+</span></span></code></pre></div><p>The next method that we have to implement in order to properly define and implement the behaviour of our DT through its
+ShadowingModelFunction are:</p><ul><li><code>onPhysicalAssetPropertyVariation</code>: Method called when a new variation for a specific Physical Property has been detected
+by the associated Physical Adapter. The method receive as parameter a specific WLDT Event called <code>PhysicalAssetPropertyWldtEvent&lt;?> physicalPropertyEventMessage</code>
+containing all the information generated by the Physical Adapter upon the variation of the monitored physical counterpart.</li><li><code>onPhysicalAssetEventNotification</code>: Callback method used to be notified by a PhysicalAdapter about the generation of a Physical Event.
+As for the previous method, also this function receive a WLDT Event parameter of type <code>onPhysicalAssetEventNotification(PhysicalAssetEventWldtEvent&lt;?> physicalAssetEventWldtEvent)</code>)
+containing all the field of the generated physical event.</li><li><code>onDigitalActionEvent</code>: On the opposite this method is triggered from one of the active Digital Adapter when an Action request has been received on the Digital Interface.
+The method receive as parameter an instance of the WLDT Event class <code>DigitalActionWldtEvent&lt;?> digitalActionWldtEvent</code> describing the target digital action request and the associated
+body.</li></ul><p>For the <code>onPhysicalAssetPropertyVariation</code> a simple implementation in charge ONLY of mapping the new Physical Property value
+into the corresponding DT&rsquo;State property can be implemented as follows:</p><p>The DT State transaction management should be applied in the point of the code where the
+Shadowing Function receive a variation from the Physical world through a target adapter and the callback method <code>onPhysicalAssetPropertyVariation(...)</code></p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=nd>@Override</span>
+</span></span><span class=line><span class=cl><span class=kd>protected</span> <span class=kt>void</span> <span class=nf>onPhysicalAssetPropertyVariation</span><span class=o>(</span><span class=n>PhysicalAssetPropertyWldtEvent</span><span class=o>&lt;?&gt;</span> <span class=n>physicalPropertyEventMessage</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>    <span class=k>try</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>      <span class=c1>//Update Digital Twin State  
+</span></span></span><span class=line><span class=cl><span class=c1></span>      <span class=c1>//NEW from 0.3.0 -&gt; Start State Transaction
+</span></span></span><span class=line><span class=cl><span class=c1></span>      <span class=k>this</span><span class=o>.</span><span class=na>digitalTwinStateManager</span><span class=o>.</span><span class=na>startStateTransaction</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>      <span class=k>this</span><span class=o>.</span><span class=na>digitalTwinState</span><span class=o>.</span><span class=na>updateProperty</span><span class=o>(</span><span class=k>new</span> <span class=n>DigitalTwinStateProperty</span><span class=o>&lt;&gt;(</span><span class=n>physicalPropertyEventMessage</span><span class=o>.</span><span class=na>getPhysicalPropertyId</span><span class=o>(),</span> <span class=n>physicalPropertyEventMessage</span><span class=o>.</span><span class=na>getBody</span><span class=o>()));</span>
+</span></span><span class=line><span class=cl>
+</span></span><span class=line><span class=cl>      <span class=c1>//NEW from 0.3.0 -&gt; Commit State Transaction
+</span></span></span><span class=line><span class=cl><span class=c1></span>      <span class=k>this</span><span class=o>.</span><span class=na>digitalTwinStateManager</span><span class=o>.</span><span class=na>commitStateTransaction</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>      
+</span></span><span class=line><span class=cl>    <span class=o>}</span> <span class=k>catch</span> <span class=o>(</span><span class=n>WldtDigitalTwinStatePropertyException</span> <span class=o>|</span> <span class=n>WldtDigitalTwinStatePropertyBadRequestException</span> <span class=o>|</span> <span class=n>WldtDigitalTwinStatePropertyNotFoundException</span> <span class=o>|</span> <span class=n>WldtDigitalTwinStateException</span> <span class=n>e</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        <span class=n>e</span><span class=o>.</span><span class=na>printStackTrace</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl><span class=o>}</span>
+</span></span></code></pre></div><p>In this case as reported in the code, we call the method <code>this.digitalTwinState.updateProperty</code> on the Shadowing Function
+in order to update an existing DT&rsquo;State property (previously created in the <code>onDigitalTwinBound</code> method).
+To update the value we directly use the received data on the <code>PhysicalAssetPropertyWldtEvent</code> without any additional check
+or change that might be instead needed in advanced examples.</p><p>Following the same principle, a simplified digital mapping between physical and digital state upon the receving of a physical event variation can be the following:</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=nd>@Override</span>
+</span></span><span class=line><span class=cl><span class=kd>protected</span> <span class=kt>void</span> <span class=nf>onPhysicalAssetEventNotification</span><span class=o>(</span><span class=n>PhysicalAssetEventWldtEvent</span><span class=o>&lt;?&gt;</span> <span class=n>physicalAssetEventWldtEvent</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>    <span class=k>try</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        <span class=k>this</span><span class=o>.</span><span class=na>digitalTwinStateManager</span><span class=o>.</span><span class=na>notifyDigitalTwinStateEvent</span><span class=o>(</span><span class=k>new</span> <span class=n>DigitalTwinStateEventNotification</span><span class=o>&lt;&gt;(</span><span class=n>physicalAssetEventWldtEvent</span><span class=o>.</span><span class=na>getPhysicalEventKey</span><span class=o>(),</span> <span class=n>physicalAssetEventWldtEvent</span><span class=o>.</span><span class=na>getBody</span><span class=o>(),</span> <span class=n>physicalAssetEventWldtEvent</span><span class=o>.</span><span class=na>getCreationTimestamp</span><span class=o>()));</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span> <span class=k>catch</span> <span class=o>(</span><span class=n>WldtDigitalTwinStateEventNotificationException</span> <span class=o>|</span> <span class=n>EventBusException</span> <span class=n>e</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        <span class=n>e</span><span class=o>.</span><span class=na>printStackTrace</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl><span class=o>}</span>
+</span></span></code></pre></div><p>With respect to events management, we use the Shadowint Function method <code>this.digitalTwinState.notifyDigitalTwinStateEvent</code> to notify
+the other DT Components (e.g., Digital Adapters) the incoming Physical Event by creating a new instance of a <code>DigitalTwinStateEventNotification</code> class
+containing all the information associated to the event. Of course, additional controls and checks can be introduced in this
+method validating and processing the incoming physical message to define complex behaviours.</p><p>The last method that we are going to implement is the <code>onDigitalActionEvent</code> one where we have to handle an incoming
+Digital Action request associated to an Action declared on the DT&rsquo;s State in the <code>onDigitalTwinBound</code> method.
+In that case the Digital Action should be forwarded to the Physical Interface in order to be sent to the physical counterpart
+for the effective execution.</p><div class=highlight><pre tabindex=0 class=chroma><code class=language-java data-lang=java><span class=line><span class=cl><span class=nd>@Override</span>
+</span></span><span class=line><span class=cl><span class=kd>protected</span> <span class=kt>void</span> <span class=nf>onDigitalActionEvent</span><span class=o>(</span><span class=n>DigitalActionWldtEvent</span><span class=o>&lt;?&gt;</span> <span class=n>digitalActionWldtEvent</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>    <span class=k>try</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        <span class=k>this</span><span class=o>.</span><span class=na>publishPhysicalAssetActionWldtEvent</span><span class=o>(</span><span class=n>digitalActionWldtEvent</span><span class=o>.</span><span class=na>getActionKey</span><span class=o>(),</span> <span class=n>digitalActionWldtEvent</span><span class=o>.</span><span class=na>getBody</span><span class=o>());</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span> <span class=k>catch</span> <span class=o>(</span><span class=n>EventBusException</span> <span class=n>e</span><span class=o>)</span> <span class=o>{</span>
+</span></span><span class=line><span class=cl>        <span class=n>e</span><span class=o>.</span><span class=na>printStackTrace</span><span class=o>();</span>
+</span></span><span class=line><span class=cl>    <span class=o>}</span>
+</span></span><span class=line><span class=cl><span class=o>}</span>
+</span></span></code></pre></div><p>Also in that case we are forwarding the incoming Digital Action request described through the class <code>DigitalActionWldtEvent</code>
+to the Physical Adapter with the method of the Shadowing Function denoted as <code>this.publishPhysicalAssetActionWldtEvent</code> and
+passing directly the action key and the target Body. No additional processing or validation have been introduced here, but they might
+be required in advanced scenario in order to properly adapt incoming digital action request to what is effectively expected on the
+physical counterpart.</p><div class="page-footer-meta d-flex flex-column flex-md-row justify-content-between"><div class=last-modified><a href=https://github.com/wldt/wldt.github.io/commit/ab5a164de259055162e9420d8cb56c2b1562dee9><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-calendar"><rect x="3" y="4" width="18" height="18" rx="2" ry="2"/><line x1="16" y1="2" x2="16" y2="6"/><line x1="8" y1="2" x2="8" y2="6"/><line x1="3" y1="10" x2="21" y2="10"/></svg>Last updated on February 9, 2024</a></div><div class=edit-page><a href=https://github.com/wldt/wldt.github.io/blob/main/content//docs/guides/shadowing-function.md><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-edit-2"><path d="M17 3a2.828 2.828.0 114 4L7.5 20.5 2 22l1.5-5.5L17 3z"/></svg>Edit this page on GitHub</a></div></div><div class="page-nav d-flex flex-column flex-sm-row"><div class="card w-100"><div class="card-body d-flex"><div class="d-flex flex-column justify-content-center"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-arrow-left" width="20" height="20" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 12h14"/><path d="M5 12l6 6"/><path d="M5 12l6-6"/></svg></div><div class="d-flex flex-column"><div class=text-body-secondary>Prev</div><a href=https://wldt.github.io/docs/guides/physical-adapter/ class="stretched-link text-reset text-decoration-none">Physical Adapter</a></div></div></div><div class=m-2></div><div class="card text-end w-100"><div class="card-body d-flex justify-content-end"><div class="d-flex flex-column"><div class=text-body-secondary>Next</div><a href=https://wldt.github.io/docs/guides/digital-adapter/ class="stretched-link text-reset text-decoration-none">Digital Adapter</a></div><div class="d-flex flex-column justify-content-center"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-arrow-right" width="20" height="20" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 12h14"/><path d="M13 18l6-6"/><path d="M13 6l6 6"/></svg></div></div></div></div></main></div></div></div><footer class="footer text-muted"><div class=container-lg><div class=row><div class="col-lg-8 text-center text-lg-start"><ul class=list-inline><li class=list-inline-item><a class=text-muted href=https://wldt.github.io/privacy/>Privacy Policy</a></li></ul></div><div class="col-lg-8 text-center text-lg-end"><ul class=list-inline><li class=list-inline-item>Brought to you by <a class=text-muted href=https://gethyas.com/>Hyas</a></li></ul></div></div></div></footer><script async src=https://wldt.github.io/js/app.1e84dcdaa5ccef6fe83f6d88ac1e444a1f237111cfa2a7a97427f758e9c27ef4.js integrity="sha256-HoTc2qXM72/oP22IrB5ESh8jcRHPoqepdCf3WOnCfvQ="></script>
+<script async src=https://wldt.github.io/js/flexsearch.dc00caef2c3490dbab3c345ed0d4133b0aafb803efeb21c3df80776d6d3ea821.js integrity="sha256-3ADK7yw0kNurPDRe0NQTOwqvuAPv6yHD34B3bW0+qCE="></script><script async src=https://wldt.github.io/js/search-modal.c4c023efcdee308e4b5f1110afe1db6b1656f217e67aa7efe54e2f4bf2feccf8.js integrity="sha256-xMAj783uMI5LXxEQr+HbaxZW8hfmeqfv5U4vS/L+zPg="></script><div class="d-inline-flex fixed-bottom-right pb-4 pe-4"><button id=toTop type=button class="btn btn-primary rounded-circle ms-auto p-2"><span class=visually-hidden>Top</span><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-chevron-up" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M6 15l6-6 6 6"/></svg></button></div></body></html>
\ No newline at end of file
diff --git a/docs/guides/sitemap.xml b/docs/guides/sitemap.xml
index c112f59..7b1ce26 100644
--- a/docs/guides/sitemap.xml
+++ b/docs/guides/sitemap.xml
@@ -1 +1 @@
-<?xml version="1.0" encoding="utf-8" standalone="yes"?><urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml"><url><loc>https://wldt.github.io/docs/guides/example-guide/</loc><lastmod>2024-02-09T09:54:12+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url></urlset>
\ No newline at end of file
+<?xml version="1.0" encoding="utf-8" standalone="yes"?><urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml"><url><loc>https://wldt.github.io/docs/guides/physical-adapter/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/guides/shadowing-function/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/guides/digital-adapter/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/guides/dt-engine-dt-instance/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/guides/digital-actions/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/guides/configurable-adapters/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url></urlset>
\ No newline at end of file
diff --git a/docs/index.html b/docs/index.html
index 84089aa..5128117 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -1,9 +1,11 @@
 <!doctype html><html lang=en data-bs-theme=auto><head><meta charset=utf-8><meta http-equiv=x-ua-compatible content="ie=edge"><meta name=viewport content="width=device-width,initial-scale=1"><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-regular.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-500.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-700.woff2 type=font/woff2 crossorigin><script src=https://wldt.github.io/js/color-mode.86a91f050a481d0a3f0c72ac26543cb6228c770875981c58dcbc008fd3f875c8.js integrity="sha256-hqkfBQpIHQo/DHKsJlQ8tiKMdwh1mBxY3LwAj9P4dcg="></script>
-<link rel=stylesheet href=https://wldt.github.io/main.5d6e5440c13f1c45183e82bbb906165564d1edfd71498c4a2c38775086796022bfab9cfb137199a537d8e42c2fb6ce2ab74b69461aed15b7389bd0e12ec63b19.css integrity="sha512-XW5UQME/HEUYPoK7uQYWVWTR7f1xSYxKLDh3UIZ5YCK/q5z7E3GZpTfY5Cwvts4qt0tpRhrtFbc4m9DhLsY7GQ==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>Docs | WLDT</title><meta property="canonical" content="https://wldt.github.io/docs/"><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/docs/"><meta property="og:title" content="Docs"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:section" content="docs"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/example-guide/"><meta property="og:see_also" content="https://wldt.github.io/docs/reference/example-reference/"><meta name=twitter:card content="summary"><meta name=twitter:title content="Docs"><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","name":"Docs","position":2}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="list section docs" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
+<link rel=stylesheet href=https://wldt.github.io/main.5fb433a44687c98f7ae7b3d0137c762777049ba27235e1f08c279c03c8533a7a9a1e3b0ef5b125a31b6bb63a362cdcbc39c3706ed41ad7f1a620b9281013866c.css integrity="sha512-X7QzpEaHyY9657PQE3x2J3cEm6JyNeHwjCecA8hTOnqaHjsO9bEloxtrtjo2LNy8OcNwbtQa1/GmILkoEBOGbA==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>Docs | WLDT</title><meta property="canonical" content="https://wldt.github.io/docs/"><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/docs/"><meta property="og:title" content="Docs"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:section" content="docs"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-model/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-life-cycle/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/library-structure-basic-concepts/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/physical-adapter/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/shadowing-function/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/digital-adapter/"><meta name=twitter:card content="summary"><meta name=twitter:title content="Docs"><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","name":"Docs","position":2}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="list section docs" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
 <button type=button id=searchToggleMobile class="btn btn-link nav-link mx-2 d-lg-none" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
-<button class="btn btn-link d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavSection aria-controls=offcanvasNavSection aria-label="Open section navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-dots-vertical" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 19m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 5m-1 0a1 1 0 102 0 1 1 0 10-2 0"/></svg></button><div class="offcanvas offcanvas-start d-lg-none" tabindex=-1 id=offcanvasNavSection aria-labelledby=offcanvasNavSectionLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavSectionLabel>Docs</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class=offcanvas-body><aside class="doks-sidebar mt-n3"><nav id=doks-docs-nav aria-label="Tertiary navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-45389ee90014e0938cb09409b9a8794d aria-expanded=false>
-Guides</button><div class=collapse id=section-45389ee90014e0938cb09409b9a8794d><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/example-guide/>Example Guide</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-63d5049791d9d79d86e9a108b0a999ca aria-expanded=false>
-Reference</button><div class=collapse id=section-63d5049791d9d79d86e9a108b0a999ca><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/reference/example-reference/>Example Reference</a></li></ul></div></li></ul></nav></aside></div></div><button class="btn btn-link nav-link mx-2 order-3 d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavMain aria-controls=offcanvasNavMain aria-label="Open main navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-menu" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><line x1="4" y1="8" x2="20" y2="8"/><line x1="4" y1="16" x2="20" y2="16"/></svg></button><div class="offcanvas offcanvas-end h-auto" tabindex=-1 id=offcanvasNavMain aria-labelledby=offcanvasNavMainLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavMainLabel>WLDT</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class="offcanvas-body d-flex flex-column flex-lg-row justify-content-between"><ul class="navbar-nav flex-grow-1"><li class=nav-item><a class=nav-link href=https://wldt.github.io/docs/guides/example-guide/>Documentation</a></li><li class=nav-item><a class=nav-link href=https://wldt.github.io/blog/>Blog</a></li></ul><button type=button id=searchToggleDesktop class="btn btn-link nav-link p-2 d-none d-lg-block" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button class="btn btn-link d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavSection aria-controls=offcanvasNavSection aria-label="Open section navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-dots-vertical" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 19m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 5m-1 0a1 1 0 102 0 1 1 0 10-2 0"/></svg></button><div class="offcanvas offcanvas-start d-lg-none" tabindex=-1 id=offcanvasNavSection aria-labelledby=offcanvasNavSectionLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavSectionLabel>Docs</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class=offcanvas-body><aside class="doks-sidebar mt-n3"><nav id=doks-docs-nav aria-label="Tertiary navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-0b79795d3efc95b9976c7c5b933afce2 aria-expanded=false>
+Introduction</button><div class=collapse id=section-0b79795d3efc95b9976c7c5b933afce2><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-model/>DT Model</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-life-cycle/>DT Life Cycle</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/>Library Structure & Basic Concepts</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-3978929206deee2c125a1d732aae5545 aria-expanded=false>
+Change Logs</button><div class=collapse id=section-3978929206deee2c125a1d732aae5545><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/>Change Log 0.3.0</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-89413bd312d0909efb85e6693f36cb89 aria-expanded=false>
+Adapters</button><div class=collapse id=section-89413bd312d0909efb85e6693f36cb89><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/>MQTT Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/>MQTT Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/http-digital-adapter/>HTTP Digital Adapter</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-bf647454e36069fd16f1a7a35cf6a865 aria-expanded=false>
+Getting Started</button><div class=collapse id=section-bf647454e36069fd16f1a7a35cf6a865><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/physical-adapter/>Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/shadowing-function/>Shadowing Function</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-adapter/>Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/>DT Engine & DT Instance</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-actions/>Digital Actions</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/configurable-adapters/>Configurable Adapters</a></li></ul></div></li></ul></nav></aside></div></div><button class="btn btn-link nav-link mx-2 order-3 d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavMain aria-controls=offcanvasNavMain aria-label="Open main navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-menu" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><line x1="4" y1="8" x2="20" y2="8"/><line x1="4" y1="16" x2="20" y2="16"/></svg></button><div class="offcanvas offcanvas-end h-auto" tabindex=-1 id=offcanvasNavMain aria-labelledby=offcanvasNavMainLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavMainLabel>WLDT</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class="offcanvas-body d-flex flex-column flex-lg-row justify-content-between"><ul class="navbar-nav flex-grow-1"><li class=nav-item><a class=nav-link href=https://wldt.github.io/docs/guides/example-guide/>Documentation</a></li><li class=nav-item><a class=nav-link href=https://wldt.github.io/blog/>Blog</a></li></ul><button type=button id=searchToggleDesktop class="btn btn-link nav-link p-2 d-none d-lg-block" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
 <button id=buttonColorMode class="btn btn-link mx-auto nav-link p-0 ms-lg-2 me-lg-1" type=button aria-label="Toggle theme"><svg data-bs-theme-value="dark" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-moon" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 3c.132.0.263.0.393.0a7.5 7.5.0 007.92 12.446A9 9 0 1112 2.992z"/></svg><svg data-bs-theme-value="light" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-sun" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-4 0a4 4 0 108 0 4 4 0 10-8 0m-5 0h1m8-9v1m8 8h1m-9 8v1M5.6 5.6l.7.7m12.1-.7-.7.7m0 11.4.7.7m-12.1-.7-.7.7"/></svg></button><ul id=socialMenu class="nav mx-auto flex-row order-lg-4"><li class=nav-item><a class="nav-link social-link" href=https://github.com/wldt><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-brand-github" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 19c-4.3 1.4-4.3-2.5-6-3m12 5v-3.5c0-1 .1-1.4-.5-2 2.8-.3 5.5-1.4 5.5-6a4.6 4.6.0 00-1.3-3.2 4.2 4.2.0 00-.1-3.2s-1.1-.3-3.5 1.3a12.3 12.3.0 00-6.2.0C6.5 2.8 5.4 3.1 5.4 3.1a4.2 4.2.0 00-.1 3.2A4.6 4.6.0 004 9.5c0 4.6 2.7 5.7 5.5 6-.6.6-.6 1.2-.5 2V21"/></svg><small class="ms-2 visually-hidden">GitHub</small></a></li></ul></div></div></div></header></div><div class=modal id=searchModal tabindex=-1 aria-labelledby=searchModalLabel aria-hidden=true><div class="modal-dialog modal-dialog-scrollable modal-fullscreen-md-down"><div class=modal-content><div class=modal-header><h1 class="modal-title fs-5 visually-hidden" id=searchModalLabel>Search</h1><button type=button class="btn-close visually-hidden" data-bs-dismiss=modal aria-label=Close></button><div class="search-input flex-grow-1 d-none"><form id=search-form class=search-form action=# method=post accept-charset=utf-8 role=search><label for=query class=visually-hidden>Search</label><div class=d-flex><input type=search id=query name=query class="search-text form-control form-control-lg" placeholder=Search aria-label=Search maxlength=128 autocomplete=off>
-<button type=button class="btn btn-link text-decoration-none px-0 ms-3 d-md-none" data-bs-dismiss=modal aria-label=Close>Cancel</button></div></form></div></div><div class=modal-body><p class="search-loading status message d-none mt-3 text-center">Loading search index…</p><p class="search-no-recent message d-none mt-3 text-center">No recent searches</p><p class="search-no-results message d-none mt-3 text-center">No results for "<strong><span class=query-no-results>Query here</span></strong>"</p><div id=searchResults class=search-results></div><template><article class="search-result list-view"><div class="card my-3"><div class=card-body><header><h2 class="h5 title title-submitted mb-0"><a class="stretched-link text-decoration-none text-reset" href=#>Title here</a></h2><div class="submitted d-none"><time class=created-date>Date here</time></div></header><div class=content>Summary here</div></div></div></article></template></div><div class=modal-footer><ul class="list-inline me-auto d-none d-md-block"><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Enter key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M12 3.53088v3c0 1-1 2-2 2H4m3 3-3-3 3-3"/></g></svg></kbd><span class=DocSearch-Label>to select</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Arrow down" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 3.5v8m3-3-3 3-3-3"/></g></svg></kbd><kbd class=me-2><svg width="15" height="15" aria-label="Arrow up" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 11.5v-8m3 3-3-3-3 3"/></g></svg></kbd><span class=DocSearch-Label>to navigate</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Escape key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M13.6167 8.936c-.1065.3583-.6883.962-1.4875.962-.7993.0-1.653-.9165-1.653-2.1258v-.5678c0-1.2548.7896-2.1016 1.653-2.1016s1.3601.4778 1.4875 1.0724M9 6c-.1352-.4735-.7506-.9219-1.46-.8972-.7092.0246-1.344.57-1.344 1.2166s.4198.8812 1.3445.9805C8.465 7.3992 8.968 7.9337 9 8.5s-.454 1.398-1.4595 1.398C6.6593 9.898 6 9 5.963 8.4851m-1.4748.5368c-.2635.5941-.8099.876-1.5443.876s-1.7073-.6248-1.7073-2.204v-.4603c0-1.0416.721-2.131 1.7073-2.131.9864.0 1.6425 1.031 1.5443 2.2492h-2.956"/></g></svg></kbd><span class=DocSearch-Label>to close</span></li></ul><p class=d-md-none>Search by <a class=text-decoration-none href=https://github.com/nextapps-de/flexsearch>FlexSearch</a></p></div></div></div></div><div class="wrap container-lg" role=document><div class=content><div class="row justify-content-center"><div class="col-md-12 col-lg-10 col-xl-8"><article><h1 class=text-center>Docs</h1><div class=card-list><div class="card my-3"><div class=card-body><a class=stretched-link href=https://wldt.github.io/docs/guides/example-guide/>Example Guide &rarr;</a></div></div><div class="card my-3"><div class=card-body><a class=stretched-link href=https://wldt.github.io/docs/reference/example-reference/>Example Reference &rarr;</a></div></div></div></article></div></div></div></div><footer class="footer text-muted"><div class=container-lg><div class=row><div class="col-lg-8 text-center text-lg-start"><ul class=list-inline><li class=list-inline-item><a class=text-muted href=https://wldt.github.io/privacy/>Privacy Policy</a></li></ul></div><div class="col-lg-8 text-center text-lg-end"><ul class=list-inline><li class=list-inline-item>Brought to you by <a class=text-muted href=https://gethyas.com/>Hyas</a></li></ul></div></div></div></footer><script async src=https://wldt.github.io/js/app.1e84dcdaa5ccef6fe83f6d88ac1e444a1f237111cfa2a7a97427f758e9c27ef4.js integrity="sha256-HoTc2qXM72/oP22IrB5ESh8jcRHPoqepdCf3WOnCfvQ="></script>
+<button type=button class="btn btn-link text-decoration-none px-0 ms-3 d-md-none" data-bs-dismiss=modal aria-label=Close>Cancel</button></div></form></div></div><div class=modal-body><p class="search-loading status message d-none mt-3 text-center">Loading search index…</p><p class="search-no-recent message d-none mt-3 text-center">No recent searches</p><p class="search-no-results message d-none mt-3 text-center">No results for "<strong><span class=query-no-results>Query here</span></strong>"</p><div id=searchResults class=search-results></div><template><article class="search-result list-view"><div class="card my-3"><div class=card-body><header><h2 class="h5 title title-submitted mb-0"><a class="stretched-link text-decoration-none text-reset" href=#>Title here</a></h2><div class="submitted d-none"><time class=created-date>Date here</time></div></header><div class=content>Summary here</div></div></div></article></template></div><div class=modal-footer><ul class="list-inline me-auto d-none d-md-block"><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Enter key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M12 3.53088v3c0 1-1 2-2 2H4m3 3-3-3 3-3"/></g></svg></kbd><span class=DocSearch-Label>to select</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Arrow down" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 3.5v8m3-3-3 3-3-3"/></g></svg></kbd><kbd class=me-2><svg width="15" height="15" aria-label="Arrow up" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 11.5v-8m3 3-3-3-3 3"/></g></svg></kbd><span class=DocSearch-Label>to navigate</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Escape key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M13.6167 8.936c-.1065.3583-.6883.962-1.4875.962-.7993.0-1.653-.9165-1.653-2.1258v-.5678c0-1.2548.7896-2.1016 1.653-2.1016s1.3601.4778 1.4875 1.0724M9 6c-.1352-.4735-.7506-.9219-1.46-.8972-.7092.0246-1.344.57-1.344 1.2166s.4198.8812 1.3445.9805C8.465 7.3992 8.968 7.9337 9 8.5s-.454 1.398-1.4595 1.398C6.6593 9.898 6 9 5.963 8.4851m-1.4748.5368c-.2635.5941-.8099.876-1.5443.876s-1.7073-.6248-1.7073-2.204v-.4603c0-1.0416.721-2.131 1.7073-2.131.9864.0 1.6425 1.031 1.5443 2.2492h-2.956"/></g></svg></kbd><span class=DocSearch-Label>to close</span></li></ul><p class=d-md-none>Search by <a class=text-decoration-none href=https://github.com/nextapps-de/flexsearch>FlexSearch</a></p></div></div></div></div><div class="wrap container-lg" role=document><div class=content><div class="row justify-content-center"><div class="col-md-12 col-lg-10 col-xl-8"><article><h1 class=text-center>Docs</h1><div class=card-list><div class="card my-3"><div class=card-body><a class=stretched-link href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/>Change Log 0.3.0 &rarr;</a></div></div><div class="card my-3"><div class=card-body><a class=stretched-link href=https://wldt.github.io/docs/guides/configurable-adapters/>Configurable Adapters &rarr;</a></div></div><div class="card my-3"><div class=card-body><a class=stretched-link href=https://wldt.github.io/docs/guides/digital-actions/>Digital Actions &rarr;</a></div></div><div class="card my-3"><div class=card-body><a class=stretched-link href=https://wldt.github.io/docs/guides/digital-adapter/>Digital Adapter &rarr;</a></div></div><div class="card my-3"><div class=card-body><a class=stretched-link href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/>DT Engine & DT Instance &rarr;</a></div></div><div class="card my-3"><div class=card-body><a class=stretched-link href=https://wldt.github.io/docs/introduction/dt-life-cycle/>DT Life Cycle &rarr;</a></div></div><div class="card my-3"><div class=card-body><a class=stretched-link href=https://wldt.github.io/docs/introduction/dt-model/>DT Model &rarr;</a></div></div><div class="card my-3"><div class=card-body><a class=stretched-link href=https://wldt.github.io/docs/adapters/http-digital-adapter/>HTTP Digital Adapter &rarr;</a></div></div><div class="card my-3"><div class=card-body><a class=stretched-link href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/>Library Structure & Basic Concepts &rarr;</a></div></div><div class="card my-3"><div class=card-body><a class=stretched-link href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/>MQTT Digital Adapter &rarr;</a></div></div><div class="card my-3"><div class=card-body><a class=stretched-link href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/>MQTT Physical Adapter &rarr;</a></div></div><div class="card my-3"><div class=card-body><a class=stretched-link href=https://wldt.github.io/docs/guides/physical-adapter/>Physical Adapter &rarr;</a></div></div><div class="card my-3"><div class=card-body><a class=stretched-link href=https://wldt.github.io/docs/guides/shadowing-function/>Shadowing Function &rarr;</a></div></div></div></article></div></div></div></div><footer class="footer text-muted"><div class=container-lg><div class=row><div class="col-lg-8 text-center text-lg-start"><ul class=list-inline><li class=list-inline-item><a class=text-muted href=https://wldt.github.io/privacy/>Privacy Policy</a></li></ul></div><div class="col-lg-8 text-center text-lg-end"><ul class=list-inline><li class=list-inline-item>Brought to you by <a class=text-muted href=https://gethyas.com/>Hyas</a></li></ul></div></div></div></footer><script async src=https://wldt.github.io/js/app.1e84dcdaa5ccef6fe83f6d88ac1e444a1f237111cfa2a7a97427f758e9c27ef4.js integrity="sha256-HoTc2qXM72/oP22IrB5ESh8jcRHPoqepdCf3WOnCfvQ="></script>
 <script async src=https://wldt.github.io/js/flexsearch.dc00caef2c3490dbab3c345ed0d4133b0aafb803efeb21c3df80776d6d3ea821.js integrity="sha256-3ADK7yw0kNurPDRe0NQTOwqvuAPv6yHD34B3bW0+qCE="></script><script async src=https://wldt.github.io/js/search-modal.c4c023efcdee308e4b5f1110afe1db6b1656f217e67aa7efe54e2f4bf2feccf8.js integrity="sha256-xMAj783uMI5LXxEQr+HbaxZW8hfmeqfv5U4vS/L+zPg="></script><div class="d-inline-flex fixed-bottom-right pb-4 pe-4"><button id=toTop type=button class="btn btn-primary rounded-circle ms-auto p-2"><span class=visually-hidden>Top</span><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-chevron-up" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M6 15l6-6 6 6"/></svg></button></div></body></html>
\ No newline at end of file
diff --git a/docs/introduction/dt-life-cycle/index.html b/docs/introduction/dt-life-cycle/index.html
new file mode 100644
index 0000000..5b5d8c9
--- /dev/null
+++ b/docs/introduction/dt-life-cycle/index.html
@@ -0,0 +1,46 @@
+<!doctype html><html lang=en data-bs-theme=auto><head><meta charset=utf-8><meta http-equiv=x-ua-compatible content="ie=edge"><meta name=viewport content="width=device-width,initial-scale=1"><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-regular.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-500.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-700.woff2 type=font/woff2 crossorigin><script src=https://wldt.github.io/js/color-mode.86a91f050a481d0a3f0c72ac26543cb6228c770875981c58dcbc008fd3f875c8.js integrity="sha256-hqkfBQpIHQo/DHKsJlQ8tiKMdwh1mBxY3LwAj9P4dcg="></script>
+<link rel=stylesheet href=https://wldt.github.io/main.5fb433a44687c98f7ae7b3d0137c762777049ba27235e1f08c279c03c8533a7a9a1e3b0ef5b125a31b6bb63a362cdcbc39c3706ed41ad7f1a620b9281013866c.css integrity="sha512-X7QzpEaHyY9657PQE3x2J3cEm6JyNeHwjCecA8hTOnqaHjsO9bEloxtrtjo2LNy8OcNwbtQa1/GmILkoEBOGbA==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>DT Life Cycle | WLDT</title><meta property="canonical" content="https://wldt.github.io/docs/introduction/dt-life-cycle/"><meta name=description content="The modeling of the concept of DT includes also the definition and characterization of its life cycle. Based on the scientific literature, we model (and then map into the library) a life cycle with 5 states through which the DT goes from when it is executed to when it is stopped."><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/docs/introduction/dt-life-cycle/"><meta property="og:title" content="DT Life Cycle"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:section" content="docs"><meta property="og:description" content="The modeling of the concept of DT includes also the definition and characterization of its life cycle. Based on the scientific literature, we model (and then map into the library) a life cycle with 5 states through which the DT goes from when it is executed to when it is stopped."><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-model/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-life-cycle/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/library-structure-basic-concepts/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/physical-adapter/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/shadowing-function/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/digital-adapter/"><meta name=twitter:card content="summary"><meta name=twitter:title content="DT Life Cycle"><meta name=twitter:description content="The modeling of the concept of DT includes also the definition and characterization of its life cycle. Based on the scientific literature, we model (and then map into the library) a life cycle with 5 states through which the DT goes from when it is executed to when it is stopped."><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","item":"https://wldt.github.io/docs/","name":"Docs","position":2},{"@type":"ListItem","item":"https://wldt.github.io/docs/introduction/","name":"Introduction","position":3},{"@type":"ListItem","name":"DT Life Cycle","position":4}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="single section docs" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
+<button type=button id=searchToggleMobile class="btn btn-link nav-link mx-2 d-lg-none" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button class="btn btn-link d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavSection aria-controls=offcanvasNavSection aria-label="Open section navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-dots-vertical" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 19m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 5m-1 0a1 1 0 102 0 1 1 0 10-2 0"/></svg></button><div class="offcanvas offcanvas-start d-lg-none" tabindex=-1 id=offcanvasNavSection aria-labelledby=offcanvasNavSectionLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavSectionLabel>Docs</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class=offcanvas-body><aside class="doks-sidebar mt-n3"><nav id=doks-docs-nav aria-label="Tertiary navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-0b79795d3efc95b9976c7c5b933afce2 aria-expanded=true>
+Introduction</button><div class="collapse show" id=section-0b79795d3efc95b9976c7c5b933afce2><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-model/>DT Model</a></li><li><a class="docs-link rounded active" href=https://wldt.github.io/docs/introduction/dt-life-cycle/>DT Life Cycle</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/>Library Structure & Basic Concepts</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-3978929206deee2c125a1d732aae5545 aria-expanded=false>
+Change Logs</button><div class=collapse id=section-3978929206deee2c125a1d732aae5545><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/>Change Log 0.3.0</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-89413bd312d0909efb85e6693f36cb89 aria-expanded=false>
+Adapters</button><div class=collapse id=section-89413bd312d0909efb85e6693f36cb89><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/>MQTT Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/>MQTT Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/http-digital-adapter/>HTTP Digital Adapter</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-bf647454e36069fd16f1a7a35cf6a865 aria-expanded=false>
+Getting Started</button><div class=collapse id=section-bf647454e36069fd16f1a7a35cf6a865><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/physical-adapter/>Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/shadowing-function/>Shadowing Function</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-adapter/>Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/>DT Engine & DT Instance</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-actions/>Digital Actions</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/configurable-adapters/>Configurable Adapters</a></li></ul></div></li></ul></nav></aside></div></div><button class="btn btn-link nav-link mx-2 order-3 d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavMain aria-controls=offcanvasNavMain aria-label="Open main navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-menu" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><line x1="4" y1="8" x2="20" y2="8"/><line x1="4" y1="16" x2="20" y2="16"/></svg></button><div class="offcanvas offcanvas-end h-auto" tabindex=-1 id=offcanvasNavMain aria-labelledby=offcanvasNavMainLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavMainLabel>WLDT</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class="offcanvas-body d-flex flex-column flex-lg-row justify-content-between"><ul class="navbar-nav flex-grow-1"><li class=nav-item><a class=nav-link href=https://wldt.github.io/docs/guides/example-guide/>Documentation</a></li><li class=nav-item><a class=nav-link href=https://wldt.github.io/blog/>Blog</a></li></ul><button type=button id=searchToggleDesktop class="btn btn-link nav-link p-2 d-none d-lg-block" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button id=buttonColorMode class="btn btn-link mx-auto nav-link p-0 ms-lg-2 me-lg-1" type=button aria-label="Toggle theme"><svg data-bs-theme-value="dark" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-moon" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 3c.132.0.263.0.393.0a7.5 7.5.0 007.92 12.446A9 9 0 1112 2.992z"/></svg><svg data-bs-theme-value="light" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-sun" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-4 0a4 4 0 108 0 4 4 0 10-8 0m-5 0h1m8-9v1m8 8h1m-9 8v1M5.6 5.6l.7.7m12.1-.7-.7.7m0 11.4.7.7m-12.1-.7-.7.7"/></svg></button><ul id=socialMenu class="nav mx-auto flex-row order-lg-4"><li class=nav-item><a class="nav-link social-link" href=https://github.com/wldt><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-brand-github" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 19c-4.3 1.4-4.3-2.5-6-3m12 5v-3.5c0-1 .1-1.4-.5-2 2.8-.3 5.5-1.4 5.5-6a4.6 4.6.0 00-1.3-3.2 4.2 4.2.0 00-.1-3.2s-1.1-.3-3.5 1.3a12.3 12.3.0 00-6.2.0C6.5 2.8 5.4 3.1 5.4 3.1a4.2 4.2.0 00-.1 3.2A4.6 4.6.0 004 9.5c0 4.6 2.7 5.7 5.5 6-.6.6-.6 1.2-.5 2V21"/></svg><small class="ms-2 visually-hidden">GitHub</small></a></li></ul></div></div></div></header></div><div class=modal id=searchModal tabindex=-1 aria-labelledby=searchModalLabel aria-hidden=true><div class="modal-dialog modal-dialog-scrollable modal-fullscreen-md-down"><div class=modal-content><div class=modal-header><h1 class="modal-title fs-5 visually-hidden" id=searchModalLabel>Search</h1><button type=button class="btn-close visually-hidden" data-bs-dismiss=modal aria-label=Close></button><div class="search-input flex-grow-1 d-none"><form id=search-form class=search-form action=# method=post accept-charset=utf-8 role=search><label for=query class=visually-hidden>Search</label><div class=d-flex><input type=search id=query name=query class="search-text form-control form-control-lg" placeholder=Search aria-label=Search maxlength=128 autocomplete=off>
+<button type=button class="btn btn-link text-decoration-none px-0 ms-3 d-md-none" data-bs-dismiss=modal aria-label=Close>Cancel</button></div></form></div></div><div class=modal-body><p class="search-loading status message d-none mt-3 text-center">Loading search index…</p><p class="search-no-recent message d-none mt-3 text-center">No recent searches</p><p class="search-no-results message d-none mt-3 text-center">No results for "<strong><span class=query-no-results>Query here</span></strong>"</p><div id=searchResults class=search-results></div><template><article class="search-result list-view"><div class="card my-3"><div class=card-body><header><h2 class="h5 title title-submitted mb-0"><a class="stretched-link text-decoration-none text-reset" href=#>Title here</a></h2><div class="submitted d-none"><time class=created-date>Date here</time></div></header><div class=content>Summary here</div></div></div></article></template></div><div class=modal-footer><ul class="list-inline me-auto d-none d-md-block"><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Enter key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M12 3.53088v3c0 1-1 2-2 2H4m3 3-3-3 3-3"/></g></svg></kbd><span class=DocSearch-Label>to select</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Arrow down" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 3.5v8m3-3-3 3-3-3"/></g></svg></kbd><kbd class=me-2><svg width="15" height="15" aria-label="Arrow up" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 11.5v-8m3 3-3-3-3 3"/></g></svg></kbd><span class=DocSearch-Label>to navigate</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Escape key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M13.6167 8.936c-.1065.3583-.6883.962-1.4875.962-.7993.0-1.653-.9165-1.653-2.1258v-.5678c0-1.2548.7896-2.1016 1.653-2.1016s1.3601.4778 1.4875 1.0724M9 6c-.1352-.4735-.7506-.9219-1.46-.8972-.7092.0246-1.344.57-1.344 1.2166s.4198.8812 1.3445.9805C8.465 7.3992 8.968 7.9337 9 8.5s-.454 1.398-1.4595 1.398C6.6593 9.898 6 9 5.963 8.4851m-1.4748.5368c-.2635.5941-.8099.876-1.5443.876s-1.7073-.6248-1.7073-2.204v-.4603c0-1.0416.721-2.131 1.7073-2.131.9864.0 1.6425 1.031 1.5443 2.2492h-2.956"/></g></svg></kbd><span class=DocSearch-Label>to close</span></li></ul><p class=d-md-none>Search by <a class=text-decoration-none href=https://github.com/nextapps-de/flexsearch>FlexSearch</a></p></div></div></div></div><div class="wrap container-lg" role=document><div class=content><div class="row flex-xl-nowrap"><div class="col-lg-5 col-xl-4 docs-sidebar d-none d-lg-block"><nav class=docs-links aria-label="Main navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-0b79795d3efc95b9976c7c5b933afce2 aria-expanded=true>
+Introduction</button><div class="collapse show" id=section-0b79795d3efc95b9976c7c5b933afce2><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-model/>DT Model</a></li><li><a class="docs-link rounded active" href=https://wldt.github.io/docs/introduction/dt-life-cycle/>DT Life Cycle</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/>Library Structure & Basic Concepts</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-3978929206deee2c125a1d732aae5545 aria-expanded=false>
+Change Logs</button><div class=collapse id=section-3978929206deee2c125a1d732aae5545><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/>Change Log 0.3.0</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-89413bd312d0909efb85e6693f36cb89 aria-expanded=false>
+Adapters</button><div class=collapse id=section-89413bd312d0909efb85e6693f36cb89><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/>MQTT Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/>MQTT Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/http-digital-adapter/>HTTP Digital Adapter</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-bf647454e36069fd16f1a7a35cf6a865 aria-expanded=false>
+Getting Started</button><div class=collapse id=section-bf647454e36069fd16f1a7a35cf6a865><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/physical-adapter/>Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/shadowing-function/>Shadowing Function</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-adapter/>Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/>DT Engine & DT Instance</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-actions/>Digital Actions</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/configurable-adapters/>Configurable Adapters</a></li></ul></div></li></ul></nav></div><nav class="docs-toc d-none d-xl-block col-xl-3" aria-label="Secondary navigation"><div class=page-links><h3>Example Guide</h3><nav id=toc><ul><li><ul><li></li></ul></li></ul></nav></div></nav><main class="docs-content col-lg-11 col-xl-9"><nav aria-label=breadcrumb><ol class=breadcrumb><li class=breadcrumb-item><a href=https://wldt.github.io/>Home</a></li><li class=breadcrumb-item><a href=https://wldt.github.io/docs/>Docs</a></li><li class=breadcrumb-item><a href=https://wldt.github.io/docs/introduction/>Introduction</a></li><li class="breadcrumb-item active" aria-current=page>DT Life Cycle</li></ol></nav><h1>DT Life Cycle</h1><nav class="toc-mobile d-xl-none" aria-label="Quaternary navigation"><details><summary>On this page</summary><div class=page-links><nav id=TableOfContents><ul><li><ul><li></li></ul></li></ul></nav></div></details></nav><p>The modeling of the concept of DT includes also the definition and characterization of its life cycle.
+Based on the scientific literature, we model (and then map into the library) a life cycle with 5 states
+through which the DT goes from when it is executed to when it is stopped.
+The previous Figure shows a graphical representation of the life cycle with the following steps:</p><ul><li><strong>Operating & Not Bound</strong>: this is the state in which the DT is located following the initialization phase,
+indicating that all internal modules of the DT are active but there is no association yet with the corresponding PA.</li><li><strong>Bound</strong>: this is the state in which the DT transitions following the correct execution of the binding procedure.
+The binding procedure allows to connect the two parts and enables bidirectional flow of events.</li><li><strong>Shadowed</strong>: this is the state reached by the DT when the shadowing process begins and its state
+is correctly synchronized with that of the PA.</li><li><strong>Out of Sync</strong>: this is the state that determines the presence of errors in the shadowing process.
+When in this state, the DT is not able to handle either state alignment events or those generated
+by the application layer.</li><li><strong>Done</strong>: this is the state that the DT reaches when the shadowing process is stopped,
+but the DT continues to be active to handle requests coming from external applications.</li></ul><h4 id=from-unbound-to-bound>From Unbound to Bound<a href=#from-unbound-to-bound class=anchor aria-hidden=true>#</a></h4><p>Taking into account the target reference Life Cycle the first point to address is how we can move from an <code>UnBound</code> state
+to a <code>Bound</code> condition with respect to the relationship with the Physical Layer.</p><p>The previous Figure illustrates a simple scenario where a Physical Asset uses two protocols (P1 and P2) to communicate and it is
+connected to the Digital Twin through a DT&rsquo;s Physical Interface enabled with two dedicated Adapters for protocol P1 and P2.
+In order to move from the Unbound to Bound state the DT should be aware of the description of the target asset with respect to
+the two protocols. For example through P1 the asset exposes telemetry data (e.g., light bulb status and energy consumption)
+while on P2 allows incoming action requests (e.g., turn on/off the light). The Digital Twin can start the shadowing process
+only when it is bound and has a description of the properties and capabilities of the associated physical counterpart.
+The schematic procedure is illustrated in the following Figure:</p><p>Involved steps are:</p><ol><li>The Adapter P1 communicates with the PA through Protocol 1 and provides a <code>Physical Asset Description</code> from its perspective</li><li>The Adapter P2 communicates with the PA through Protocol 2 and provides a <code>Physical Asset Description</code> from its perspective</li><li>Only when all Physical Adapters have been correctly bound (it may require time) to the Physical Asset and the associated <code>Physical Asset Descriptions</code>
+have been generated, the DT can move from UnBound to Bound</li></ol><p>Main core aspects associated to the concept of Physical Asset Description (PAD) are the following:</p><ul><li>It is used to describe the list of <strong>properties</strong>, <strong>actions</strong> and <strong>relationships</strong> of a Physical Asset</li><li>Each Physical Adapter generates a dedicated PAD associated to its perspective on the Physical Assets
+and its capabilities to read data and execute actions</li><li>It is a responsibility of the DT to handle multiple descriptions in order to build the digital replica</li><li>It will be used by the DT to handle the shadowing process and keep the digital replica synchronized with the physical counterpart</li></ul><h4 id=from-bound-to-shadowed>From Bound to Shadowed<a href=#from-bound-to-shadowed class=anchor aria-hidden=true>#</a></h4><p>Following the same approach described in the previous step we need to define a procedure to allow the DT to move from a <code>Bound</code> state
+to a <code>Shadowed</code> condition where the twin identified the interesting capabilities of the Physical Asset that has to be
+digitalized and according to the received Physical Asset Descriptions start the shadowing procedure to be synchronized with the physical world.</p><p>As schematically illustrated in the previous Figure, involved steps are:</p><ol><li>The Model defines which properties should be monitored on the Physical Asset and start observing
+them through the target adapters</li><li>Involved Physical Adapters communicate with the Physical Asset, receive data and generate Events (ePA)
+to notify about physical property changes</li><li>Received ePA will be used by the Digital Twin Model in order to run the
+Shadowing function and compute the new DT State</li><li>The DT can move from the Bound to Shadowed phase until it is able to maintain a proper synchronization
+with the physical asset over time through its shadowing process and the generation and maintenance of the DT&rsquo;s State</li></ol><p>The Digital Twin State is structured and characterized by the following elements:</p><ul><li>A list of properties</li><li>A list of actions</li><li>A list of relationships</li></ul><p>Listed elements can be directly associated to the corresponding element of the Physical Asset or generated by DT Model
+combining multiple physical properties, actions or relationships at the same time. The Digital Twin State can be managed
+through the Shadowing Function and exposes a set of methods for its manipulated. When there is a change in the DT State an event (eDT) will be generated</p><p>The manipulation of DT&rsquo;s State generates a set of DT&rsquo;s events (eDT) associated to each specific variation and evolution of the
+twin during its life cyle. These events are used by the Digital Interface and in particular by its Digital Adapters to
+expose the DT&rsquo;s State, its properties and capabilities to the external digital world. At the same time, eDT can be used by
+Digital Adapters to trigger action on the DT and consequently to propagate (if acceptable and/or needed)
+the incoming request to the physical assets bound with the target DT. Supported events are illustrated in the following
+schema.</p><div class="page-footer-meta d-flex flex-column flex-md-row justify-content-between"><div class=last-modified><a href=https://github.com/wldt/wldt.github.io/commit/ab5a164de259055162e9420d8cb56c2b1562dee9><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-calendar"><rect x="3" y="4" width="18" height="18" rx="2" ry="2"/><line x1="16" y1="2" x2="16" y2="6"/><line x1="8" y1="2" x2="8" y2="6"/><line x1="3" y1="10" x2="21" y2="10"/></svg>Last updated on February 9, 2024</a></div><div class=edit-page><a href=https://github.com/wldt/wldt.github.io/blob/main/content//docs/introduction/dt-life-cycle.md><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-edit-2"><path d="M17 3a2.828 2.828.0 114 4L7.5 20.5 2 22l1.5-5.5L17 3z"/></svg>Edit this page on GitHub</a></div></div><div class="page-nav d-flex flex-column flex-sm-row"><div class="card w-100"><div class="card-body d-flex"><div class="d-flex flex-column justify-content-center"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-arrow-left" width="20" height="20" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 12h14"/><path d="M5 12l6 6"/><path d="M5 12l6-6"/></svg></div><div class="d-flex flex-column"><div class=text-body-secondary>Prev</div><a href=https://wldt.github.io/docs/introduction/dt-model/ class="stretched-link text-reset text-decoration-none">DT Model</a></div></div></div><div class=m-2></div><div class="card text-end w-100"><div class="card-body d-flex justify-content-end"><div class="d-flex flex-column"><div class=text-body-secondary>Next</div><a href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/ class="stretched-link text-reset text-decoration-none">Library Structure & Basic Concepts</a></div><div class="d-flex flex-column justify-content-center"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-arrow-right" width="20" height="20" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 12h14"/><path d="M13 18l6-6"/><path d="M13 6l6 6"/></svg></div></div></div></div></main></div></div></div><footer class="footer text-muted"><div class=container-lg><div class=row><div class="col-lg-8 text-center text-lg-start"><ul class=list-inline><li class=list-inline-item><a class=text-muted href=https://wldt.github.io/privacy/>Privacy Policy</a></li></ul></div><div class="col-lg-8 text-center text-lg-end"><ul class=list-inline><li class=list-inline-item>Brought to you by <a class=text-muted href=https://gethyas.com/>Hyas</a></li></ul></div></div></div></footer><script async src=https://wldt.github.io/js/app.1e84dcdaa5ccef6fe83f6d88ac1e444a1f237111cfa2a7a97427f758e9c27ef4.js integrity="sha256-HoTc2qXM72/oP22IrB5ESh8jcRHPoqepdCf3WOnCfvQ="></script>
+<script async src=https://wldt.github.io/js/flexsearch.dc00caef2c3490dbab3c345ed0d4133b0aafb803efeb21c3df80776d6d3ea821.js integrity="sha256-3ADK7yw0kNurPDRe0NQTOwqvuAPv6yHD34B3bW0+qCE="></script><script async src=https://wldt.github.io/js/search-modal.c4c023efcdee308e4b5f1110afe1db6b1656f217e67aa7efe54e2f4bf2feccf8.js integrity="sha256-xMAj783uMI5LXxEQr+HbaxZW8hfmeqfv5U4vS/L+zPg="></script><div class="d-inline-flex fixed-bottom-right pb-4 pe-4"><button id=toTop type=button class="btn btn-primary rounded-circle ms-auto p-2"><span class=visually-hidden>Top</span><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-chevron-up" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M6 15l6-6 6 6"/></svg></button></div></body></html>
\ No newline at end of file
diff --git a/docs/introduction/dt-model/index.html b/docs/introduction/dt-model/index.html
new file mode 100644
index 0000000..99233a3
--- /dev/null
+++ b/docs/introduction/dt-model/index.html
@@ -0,0 +1,47 @@
+<!doctype html><html lang=en data-bs-theme=auto><head><meta charset=utf-8><meta http-equiv=x-ua-compatible content="ie=edge"><meta name=viewport content="width=device-width,initial-scale=1"><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-regular.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-500.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-700.woff2 type=font/woff2 crossorigin><script src=https://wldt.github.io/js/color-mode.86a91f050a481d0a3f0c72ac26543cb6228c770875981c58dcbc008fd3f875c8.js integrity="sha256-hqkfBQpIHQo/DHKsJlQ8tiKMdwh1mBxY3LwAj9P4dcg="></script>
+<link rel=stylesheet href=https://wldt.github.io/main.5fb433a44687c98f7ae7b3d0137c762777049ba27235e1f08c279c03c8533a7a9a1e3b0ef5b125a31b6bb63a362cdcbc39c3706ed41ad7f1a620b9281013866c.css integrity="sha512-X7QzpEaHyY9657PQE3x2J3cEm6JyNeHwjCecA8hTOnqaHjsO9bEloxtrtjo2LNy8OcNwbtQa1/GmILkoEBOGbA==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>DT Model | WLDT</title><meta property="canonical" content="https://wldt.github.io/docs/introduction/dt-model/"><meta name=description content="With respect to the element present in the real world, it is defined as a Physical Asset (PA) with the intention of referring to any entity that has a manifestation or relevance in the physical world and a well-defined lifespan."><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/docs/introduction/dt-model/"><meta property="og:title" content="DT Model"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:section" content="docs"><meta property="og:description" content="With respect to the element present in the real world, it is defined as a Physical Asset (PA) with the intention of referring to any entity that has a manifestation or relevance in the physical world and a well-defined lifespan."><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-model/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-life-cycle/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/library-structure-basic-concepts/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/physical-adapter/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/shadowing-function/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/digital-adapter/"><meta name=twitter:card content="summary"><meta name=twitter:title content="DT Model"><meta name=twitter:description content="With respect to the element present in the real world, it is defined as a Physical Asset (PA) with the intention of referring to any entity that has a manifestation or relevance in the physical world and a well-defined lifespan."><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","item":"https://wldt.github.io/docs/","name":"Docs","position":2},{"@type":"ListItem","item":"https://wldt.github.io/docs/introduction/","name":"Introduction","position":3},{"@type":"ListItem","name":"DT Model","position":4}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="single section docs" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
+<button type=button id=searchToggleMobile class="btn btn-link nav-link mx-2 d-lg-none" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button class="btn btn-link d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavSection aria-controls=offcanvasNavSection aria-label="Open section navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-dots-vertical" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 19m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 5m-1 0a1 1 0 102 0 1 1 0 10-2 0"/></svg></button><div class="offcanvas offcanvas-start d-lg-none" tabindex=-1 id=offcanvasNavSection aria-labelledby=offcanvasNavSectionLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavSectionLabel>Docs</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class=offcanvas-body><aside class="doks-sidebar mt-n3"><nav id=doks-docs-nav aria-label="Tertiary navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-0b79795d3efc95b9976c7c5b933afce2 aria-expanded=true>
+Introduction</button><div class="collapse show" id=section-0b79795d3efc95b9976c7c5b933afce2><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded active" href=https://wldt.github.io/docs/introduction/dt-model/>DT Model</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-life-cycle/>DT Life Cycle</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/>Library Structure & Basic Concepts</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-3978929206deee2c125a1d732aae5545 aria-expanded=false>
+Change Logs</button><div class=collapse id=section-3978929206deee2c125a1d732aae5545><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/>Change Log 0.3.0</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-89413bd312d0909efb85e6693f36cb89 aria-expanded=false>
+Adapters</button><div class=collapse id=section-89413bd312d0909efb85e6693f36cb89><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/>MQTT Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/>MQTT Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/http-digital-adapter/>HTTP Digital Adapter</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-bf647454e36069fd16f1a7a35cf6a865 aria-expanded=false>
+Getting Started</button><div class=collapse id=section-bf647454e36069fd16f1a7a35cf6a865><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/physical-adapter/>Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/shadowing-function/>Shadowing Function</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-adapter/>Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/>DT Engine & DT Instance</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-actions/>Digital Actions</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/configurable-adapters/>Configurable Adapters</a></li></ul></div></li></ul></nav></aside></div></div><button class="btn btn-link nav-link mx-2 order-3 d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavMain aria-controls=offcanvasNavMain aria-label="Open main navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-menu" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><line x1="4" y1="8" x2="20" y2="8"/><line x1="4" y1="16" x2="20" y2="16"/></svg></button><div class="offcanvas offcanvas-end h-auto" tabindex=-1 id=offcanvasNavMain aria-labelledby=offcanvasNavMainLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavMainLabel>WLDT</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class="offcanvas-body d-flex flex-column flex-lg-row justify-content-between"><ul class="navbar-nav flex-grow-1"><li class=nav-item><a class=nav-link href=https://wldt.github.io/docs/guides/example-guide/>Documentation</a></li><li class=nav-item><a class=nav-link href=https://wldt.github.io/blog/>Blog</a></li></ul><button type=button id=searchToggleDesktop class="btn btn-link nav-link p-2 d-none d-lg-block" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button id=buttonColorMode class="btn btn-link mx-auto nav-link p-0 ms-lg-2 me-lg-1" type=button aria-label="Toggle theme"><svg data-bs-theme-value="dark" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-moon" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 3c.132.0.263.0.393.0a7.5 7.5.0 007.92 12.446A9 9 0 1112 2.992z"/></svg><svg data-bs-theme-value="light" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-sun" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-4 0a4 4 0 108 0 4 4 0 10-8 0m-5 0h1m8-9v1m8 8h1m-9 8v1M5.6 5.6l.7.7m12.1-.7-.7.7m0 11.4.7.7m-12.1-.7-.7.7"/></svg></button><ul id=socialMenu class="nav mx-auto flex-row order-lg-4"><li class=nav-item><a class="nav-link social-link" href=https://github.com/wldt><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-brand-github" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 19c-4.3 1.4-4.3-2.5-6-3m12 5v-3.5c0-1 .1-1.4-.5-2 2.8-.3 5.5-1.4 5.5-6a4.6 4.6.0 00-1.3-3.2 4.2 4.2.0 00-.1-3.2s-1.1-.3-3.5 1.3a12.3 12.3.0 00-6.2.0C6.5 2.8 5.4 3.1 5.4 3.1a4.2 4.2.0 00-.1 3.2A4.6 4.6.0 004 9.5c0 4.6 2.7 5.7 5.5 6-.6.6-.6 1.2-.5 2V21"/></svg><small class="ms-2 visually-hidden">GitHub</small></a></li></ul></div></div></div></header></div><div class=modal id=searchModal tabindex=-1 aria-labelledby=searchModalLabel aria-hidden=true><div class="modal-dialog modal-dialog-scrollable modal-fullscreen-md-down"><div class=modal-content><div class=modal-header><h1 class="modal-title fs-5 visually-hidden" id=searchModalLabel>Search</h1><button type=button class="btn-close visually-hidden" data-bs-dismiss=modal aria-label=Close></button><div class="search-input flex-grow-1 d-none"><form id=search-form class=search-form action=# method=post accept-charset=utf-8 role=search><label for=query class=visually-hidden>Search</label><div class=d-flex><input type=search id=query name=query class="search-text form-control form-control-lg" placeholder=Search aria-label=Search maxlength=128 autocomplete=off>
+<button type=button class="btn btn-link text-decoration-none px-0 ms-3 d-md-none" data-bs-dismiss=modal aria-label=Close>Cancel</button></div></form></div></div><div class=modal-body><p class="search-loading status message d-none mt-3 text-center">Loading search index…</p><p class="search-no-recent message d-none mt-3 text-center">No recent searches</p><p class="search-no-results message d-none mt-3 text-center">No results for "<strong><span class=query-no-results>Query here</span></strong>"</p><div id=searchResults class=search-results></div><template><article class="search-result list-view"><div class="card my-3"><div class=card-body><header><h2 class="h5 title title-submitted mb-0"><a class="stretched-link text-decoration-none text-reset" href=#>Title here</a></h2><div class="submitted d-none"><time class=created-date>Date here</time></div></header><div class=content>Summary here</div></div></div></article></template></div><div class=modal-footer><ul class="list-inline me-auto d-none d-md-block"><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Enter key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M12 3.53088v3c0 1-1 2-2 2H4m3 3-3-3 3-3"/></g></svg></kbd><span class=DocSearch-Label>to select</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Arrow down" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 3.5v8m3-3-3 3-3-3"/></g></svg></kbd><kbd class=me-2><svg width="15" height="15" aria-label="Arrow up" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 11.5v-8m3 3-3-3-3 3"/></g></svg></kbd><span class=DocSearch-Label>to navigate</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Escape key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M13.6167 8.936c-.1065.3583-.6883.962-1.4875.962-.7993.0-1.653-.9165-1.653-2.1258v-.5678c0-1.2548.7896-2.1016 1.653-2.1016s1.3601.4778 1.4875 1.0724M9 6c-.1352-.4735-.7506-.9219-1.46-.8972-.7092.0246-1.344.57-1.344 1.2166s.4198.8812 1.3445.9805C8.465 7.3992 8.968 7.9337 9 8.5s-.454 1.398-1.4595 1.398C6.6593 9.898 6 9 5.963 8.4851m-1.4748.5368c-.2635.5941-.8099.876-1.5443.876s-1.7073-.6248-1.7073-2.204v-.4603c0-1.0416.721-2.131 1.7073-2.131.9864.0 1.6425 1.031 1.5443 2.2492h-2.956"/></g></svg></kbd><span class=DocSearch-Label>to close</span></li></ul><p class=d-md-none>Search by <a class=text-decoration-none href=https://github.com/nextapps-de/flexsearch>FlexSearch</a></p></div></div></div></div><div class="wrap container-lg" role=document><div class=content><div class="row flex-xl-nowrap"><div class="col-lg-5 col-xl-4 docs-sidebar d-none d-lg-block"><nav class=docs-links aria-label="Main navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-0b79795d3efc95b9976c7c5b933afce2 aria-expanded=true>
+Introduction</button><div class="collapse show" id=section-0b79795d3efc95b9976c7c5b933afce2><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded active" href=https://wldt.github.io/docs/introduction/dt-model/>DT Model</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-life-cycle/>DT Life Cycle</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/>Library Structure & Basic Concepts</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-3978929206deee2c125a1d732aae5545 aria-expanded=false>
+Change Logs</button><div class=collapse id=section-3978929206deee2c125a1d732aae5545><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/>Change Log 0.3.0</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-89413bd312d0909efb85e6693f36cb89 aria-expanded=false>
+Adapters</button><div class=collapse id=section-89413bd312d0909efb85e6693f36cb89><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/>MQTT Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/>MQTT Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/http-digital-adapter/>HTTP Digital Adapter</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-bf647454e36069fd16f1a7a35cf6a865 aria-expanded=false>
+Getting Started</button><div class=collapse id=section-bf647454e36069fd16f1a7a35cf6a865><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/physical-adapter/>Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/shadowing-function/>Shadowing Function</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-adapter/>Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/>DT Engine & DT Instance</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-actions/>Digital Actions</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/configurable-adapters/>Configurable Adapters</a></li></ul></div></li></ul></nav></div><nav class="docs-toc d-none d-xl-block col-xl-3" aria-label="Secondary navigation"><div class=page-links><h3>Example Guide</h3><nav id=toc><ul><li><ul><li><a href=#the-shadowing-process>The Shadowing Process</a></li></ul></li></ul></nav></div></nav><main class="docs-content col-lg-11 col-xl-9"><nav aria-label=breadcrumb><ol class=breadcrumb><li class=breadcrumb-item><a href=https://wldt.github.io/>Home</a></li><li class=breadcrumb-item><a href=https://wldt.github.io/docs/>Docs</a></li><li class=breadcrumb-item><a href=https://wldt.github.io/docs/introduction/>Introduction</a></li><li class="breadcrumb-item active" aria-current=page>DT Model</li></ol></nav><h1>DT Model</h1><nav class="toc-mobile d-xl-none" aria-label="Quaternary navigation"><details><summary>On this page</summary><div class=page-links><nav id=TableOfContents><ul><li><ul><li><a href=#the-shadowing-process>The Shadowing Process</a></li></ul></li></ul></nav></div></details></nav><hr><p>With respect to the element present in the real world,
+it is defined as a Physical Asset (PA) with the intention of referring to any entity
+that has a manifestation or relevance in the physical world and a well-defined lifespan.</p><p>The previous Figure schematically illustrates the main component of an abstract Digital Twin and clarifies its
+responsibility to be a bridge between the cyber and the physical world.
+The blueprint components (then mapped into the WLDT Library) are:</p><ul><li><strong>Physical Interface</strong> The entity in charge of both the initial <em>digitalization</em> o <em>shadowing</em> process and the perpetual responsibility
+to keep the DT and PA in synch during its life cycle. It can execute multiple <strong>Physical Asset Adapters</strong> to interact with the PA and detect and
+digitalize the physical event coming from the physical entity according to its nature and the supported protocols and data formats (e.g., through HTTP and JSON).</li><li><strong>Digital Interface</strong> The component complementary to the Physical Interface and in charge of handling DT&rsquo;s internal variations and events
+towards external digital entities and consumers. It executes multiple and reusable <strong>Digital Adapters</strong> in charge of handling digital interactions and events
+and responsible for making the DT interoperable with external applications.</li><li><strong>DT&rsquo;s Model</strong> The module defining the DT&rsquo;s behaviour and its augmented functionalities. It supports the execution of different configurable
+and reusable modules and functionalities handling both physical and digial events according to the implemented behaviour.
+Furthermore, the Model is the component responsible to handle and keep updated the Digital Twin State as described in the following sections.</li></ul><p>The Digital Twin <code>Model</code>(M) allows capturing and representing the PA at an appropriate level of abstraction,
+i.e., avoiding irrelevant aspects for its purpose and modeling only domain-level information rather than technological ones.
+Finally, the link between the physical and digital copy is defined as shadowing. Specifically,
+the term defines the process that enables continuous and (almost) real-time updating of the internal state of the DT in relation to changes
+that occur in the PA.</p><p>Each DT is thus equipped with an internal model, which defines how the PA is represented in the digital level.
+The DT&rsquo;s representation denoted as <strong>Digital Twin State</strong> supported and defined through M is defined in terms of:</p><ul><li><strong>Properties</strong>: represent the observable attributes of the corresponding PA as labeled data
+whose values can dynamically change over time, in accordance with the evolution of the PA&rsquo;s state.</li><li><strong>Events</strong>: represent the domain-level events that can be observed in the PA.</li><li><strong>Relationships</strong>: represent the links that exist between the modeled PA and other physical
+assets of the organizations through links to their corresponding Digital Twins.
+Like properties, relationships can be observed, dynamically created, and change over time,
+but unlike properties, they are not properly part of the PA&rsquo;s state but of its operational context
+(e.g., a DT of a robot within a production line).</li><li><strong>Actions</strong>: represent the actions that can be invoked on the PA through interaction with the DT or directly
+on the DT if they are not directly available on the PA (the DT is augmenting the physical capabilities).</li></ul><p>Once the model M is defined, the dynamic state of the DT (SDT) can be defined by through the combination of
+its <em>properties</em>, <em>events</em>, <em>relationships</em> and <em>actions</em> associated to the DT <em>timestamp</em> that represents the current time of
+synchronization between the physical and digital counterparts.</p><h3 id=the-shadowing-process>The Shadowing Process<a href=#the-shadowing-process class=anchor aria-hidden=true>#</a></h3><p>The <em>shadowing</em> process (also known as replication of digitalization) allows to keep the
+Digital Twin State synchronized with that of the corresponding physical resource
+according to what is defined by the model M. Specifically, each relevant update of the PA state (SPA)
+is translated into a sequence of 3 main steps:</p><ul><li>each relevant change in physical asset state is modeled by a <code>physical_event</code> (<code>e_pa</code>);</li><li>the event is propagated to the DT;</li><li>given the new <code>physical_event</code>, the DT&rsquo;s is updated through the application of a <em>shadowing function</em>,
+which depends on the model M</li></ul><p>The shadowing process allows also the DT to reflect and invoke possible actions of the PA.
+The DT receives an action request (denoted as <code>digital_action</code>) on its digital interface, applies the shadowing function to validate it and then
+propagates the request through its physical interface.
+An important aspect to emphasize is that the request for a <code>digital_action</code> does not
+directly change the state of the DT since any changes can only occur as a result of the
+shadowing function from the PA to the DT, as described earlier.</p><div class="page-footer-meta d-flex flex-column flex-md-row justify-content-between"><div class=last-modified><a href=https://github.com/wldt/wldt.github.io/commit/ab5a164de259055162e9420d8cb56c2b1562dee9><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-calendar"><rect x="3" y="4" width="18" height="18" rx="2" ry="2"/><line x1="16" y1="2" x2="16" y2="6"/><line x1="8" y1="2" x2="8" y2="6"/><line x1="3" y1="10" x2="21" y2="10"/></svg>Last updated on February 9, 2024</a></div><div class=edit-page><a href=https://github.com/wldt/wldt.github.io/blob/main/content//docs/introduction/dt-model.md><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-edit-2"><path d="M17 3a2.828 2.828.0 114 4L7.5 20.5 2 22l1.5-5.5L17 3z"/></svg>Edit this page on GitHub</a></div></div><div class="page-nav d-flex flex-column flex-sm-row"><div class="card w-100"><div class="card-body d-flex"><div class="d-flex flex-column justify-content-center"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-arrow-left" width="20" height="20" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 12h14"/><path d="M5 12l6 6"/><path d="M5 12l6-6"/></svg></div><div class="d-flex flex-column"><div class=text-body-secondary>Prev</div><a href=https://wldt.github.io/docs/adapters/http-digital-adapter/ class="stretched-link text-reset text-decoration-none">HTTP Digital Adapter</a></div></div></div><div class=m-2></div><div class="card text-end w-100"><div class="card-body d-flex justify-content-end"><div class="d-flex flex-column"><div class=text-body-secondary>Next</div><a href=https://wldt.github.io/docs/introduction/dt-life-cycle/ class="stretched-link text-reset text-decoration-none">DT Life Cycle</a></div><div class="d-flex flex-column justify-content-center"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-arrow-right" width="20" height="20" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 12h14"/><path d="M13 18l6-6"/><path d="M13 6l6 6"/></svg></div></div></div></div></main></div></div></div><footer class="footer text-muted"><div class=container-lg><div class=row><div class="col-lg-8 text-center text-lg-start"><ul class=list-inline><li class=list-inline-item><a class=text-muted href=https://wldt.github.io/privacy/>Privacy Policy</a></li></ul></div><div class="col-lg-8 text-center text-lg-end"><ul class=list-inline><li class=list-inline-item>Brought to you by <a class=text-muted href=https://gethyas.com/>Hyas</a></li></ul></div></div></div></footer><script async src=https://wldt.github.io/js/app.1e84dcdaa5ccef6fe83f6d88ac1e444a1f237111cfa2a7a97427f758e9c27ef4.js integrity="sha256-HoTc2qXM72/oP22IrB5ESh8jcRHPoqepdCf3WOnCfvQ="></script>
+<script async src=https://wldt.github.io/js/flexsearch.dc00caef2c3490dbab3c345ed0d4133b0aafb803efeb21c3df80776d6d3ea821.js integrity="sha256-3ADK7yw0kNurPDRe0NQTOwqvuAPv6yHD34B3bW0+qCE="></script><script async src=https://wldt.github.io/js/search-modal.c4c023efcdee308e4b5f1110afe1db6b1656f217e67aa7efe54e2f4bf2feccf8.js integrity="sha256-xMAj783uMI5LXxEQr+HbaxZW8hfmeqfv5U4vS/L+zPg="></script><div class="d-inline-flex fixed-bottom-right pb-4 pe-4"><button id=toTop type=button class="btn btn-primary rounded-circle ms-auto p-2"><span class=visually-hidden>Top</span><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-chevron-up" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M6 15l6-6 6 6"/></svg></button></div></body></html>
\ No newline at end of file
diff --git a/docs/introduction/index.html b/docs/introduction/index.html
new file mode 100644
index 0000000..437c63d
--- /dev/null
+++ b/docs/introduction/index.html
@@ -0,0 +1,11 @@
+<!doctype html><html lang=en data-bs-theme=auto><head><meta charset=utf-8><meta http-equiv=x-ua-compatible content="ie=edge"><meta name=viewport content="width=device-width,initial-scale=1"><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-regular.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-500.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-700.woff2 type=font/woff2 crossorigin><script src=https://wldt.github.io/js/color-mode.86a91f050a481d0a3f0c72ac26543cb6228c770875981c58dcbc008fd3f875c8.js integrity="sha256-hqkfBQpIHQo/DHKsJlQ8tiKMdwh1mBxY3LwAj9P4dcg="></script>
+<link rel=stylesheet href=https://wldt.github.io/main.5fb433a44687c98f7ae7b3d0137c762777049ba27235e1f08c279c03c8533a7a9a1e3b0ef5b125a31b6bb63a362cdcbc39c3706ed41ad7f1a620b9281013866c.css integrity="sha512-X7QzpEaHyY9657PQE3x2J3cEm6JyNeHwjCecA8hTOnqaHjsO9bEloxtrtjo2LNy8OcNwbtQa1/GmILkoEBOGbA==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>Introduction | WLDT</title><meta property="canonical" content="https://wldt.github.io/docs/introduction/"><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/docs/introduction/"><meta property="og:title" content="Introduction"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:section" content="docs"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-model/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-life-cycle/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/library-structure-basic-concepts/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/physical-adapter/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/shadowing-function/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/digital-adapter/"><meta name=twitter:card content="summary"><meta name=twitter:title content="Introduction"><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","item":"https://wldt.github.io/docs/","name":"Docs","position":2},{"@type":"ListItem","name":"Introduction","position":3}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="list section docs" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
+<button type=button id=searchToggleMobile class="btn btn-link nav-link mx-2 d-lg-none" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button class="btn btn-link d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavSection aria-controls=offcanvasNavSection aria-label="Open section navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-dots-vertical" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 19m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 5m-1 0a1 1 0 102 0 1 1 0 10-2 0"/></svg></button><div class="offcanvas offcanvas-start d-lg-none" tabindex=-1 id=offcanvasNavSection aria-labelledby=offcanvasNavSectionLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavSectionLabel>Docs</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class=offcanvas-body><aside class="doks-sidebar mt-n3"><nav id=doks-docs-nav aria-label="Tertiary navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-0b79795d3efc95b9976c7c5b933afce2 aria-expanded=true>
+Introduction</button><div class="collapse show" id=section-0b79795d3efc95b9976c7c5b933afce2><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-model/>DT Model</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-life-cycle/>DT Life Cycle</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/>Library Structure & Basic Concepts</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-3978929206deee2c125a1d732aae5545 aria-expanded=false>
+Change Logs</button><div class=collapse id=section-3978929206deee2c125a1d732aae5545><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/>Change Log 0.3.0</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-89413bd312d0909efb85e6693f36cb89 aria-expanded=false>
+Adapters</button><div class=collapse id=section-89413bd312d0909efb85e6693f36cb89><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/>MQTT Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/>MQTT Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/http-digital-adapter/>HTTP Digital Adapter</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-bf647454e36069fd16f1a7a35cf6a865 aria-expanded=false>
+Getting Started</button><div class=collapse id=section-bf647454e36069fd16f1a7a35cf6a865><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/physical-adapter/>Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/shadowing-function/>Shadowing Function</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-adapter/>Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/>DT Engine & DT Instance</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-actions/>Digital Actions</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/configurable-adapters/>Configurable Adapters</a></li></ul></div></li></ul></nav></aside></div></div><button class="btn btn-link nav-link mx-2 order-3 d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavMain aria-controls=offcanvasNavMain aria-label="Open main navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-menu" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><line x1="4" y1="8" x2="20" y2="8"/><line x1="4" y1="16" x2="20" y2="16"/></svg></button><div class="offcanvas offcanvas-end h-auto" tabindex=-1 id=offcanvasNavMain aria-labelledby=offcanvasNavMainLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavMainLabel>WLDT</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class="offcanvas-body d-flex flex-column flex-lg-row justify-content-between"><ul class="navbar-nav flex-grow-1"><li class=nav-item><a class=nav-link href=https://wldt.github.io/docs/guides/example-guide/>Documentation</a></li><li class=nav-item><a class=nav-link href=https://wldt.github.io/blog/>Blog</a></li></ul><button type=button id=searchToggleDesktop class="btn btn-link nav-link p-2 d-none d-lg-block" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button id=buttonColorMode class="btn btn-link mx-auto nav-link p-0 ms-lg-2 me-lg-1" type=button aria-label="Toggle theme"><svg data-bs-theme-value="dark" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-moon" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 3c.132.0.263.0.393.0a7.5 7.5.0 007.92 12.446A9 9 0 1112 2.992z"/></svg><svg data-bs-theme-value="light" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-sun" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-4 0a4 4 0 108 0 4 4 0 10-8 0m-5 0h1m8-9v1m8 8h1m-9 8v1M5.6 5.6l.7.7m12.1-.7-.7.7m0 11.4.7.7m-12.1-.7-.7.7"/></svg></button><ul id=socialMenu class="nav mx-auto flex-row order-lg-4"><li class=nav-item><a class="nav-link social-link" href=https://github.com/wldt><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-brand-github" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 19c-4.3 1.4-4.3-2.5-6-3m12 5v-3.5c0-1 .1-1.4-.5-2 2.8-.3 5.5-1.4 5.5-6a4.6 4.6.0 00-1.3-3.2 4.2 4.2.0 00-.1-3.2s-1.1-.3-3.5 1.3a12.3 12.3.0 00-6.2.0C6.5 2.8 5.4 3.1 5.4 3.1a4.2 4.2.0 00-.1 3.2A4.6 4.6.0 004 9.5c0 4.6 2.7 5.7 5.5 6-.6.6-.6 1.2-.5 2V21"/></svg><small class="ms-2 visually-hidden">GitHub</small></a></li></ul></div></div></div></header></div><div class=modal id=searchModal tabindex=-1 aria-labelledby=searchModalLabel aria-hidden=true><div class="modal-dialog modal-dialog-scrollable modal-fullscreen-md-down"><div class=modal-content><div class=modal-header><h1 class="modal-title fs-5 visually-hidden" id=searchModalLabel>Search</h1><button type=button class="btn-close visually-hidden" data-bs-dismiss=modal aria-label=Close></button><div class="search-input flex-grow-1 d-none"><form id=search-form class=search-form action=# method=post accept-charset=utf-8 role=search><label for=query class=visually-hidden>Search</label><div class=d-flex><input type=search id=query name=query class="search-text form-control form-control-lg" placeholder=Search aria-label=Search maxlength=128 autocomplete=off>
+<button type=button class="btn btn-link text-decoration-none px-0 ms-3 d-md-none" data-bs-dismiss=modal aria-label=Close>Cancel</button></div></form></div></div><div class=modal-body><p class="search-loading status message d-none mt-3 text-center">Loading search index…</p><p class="search-no-recent message d-none mt-3 text-center">No recent searches</p><p class="search-no-results message d-none mt-3 text-center">No results for "<strong><span class=query-no-results>Query here</span></strong>"</p><div id=searchResults class=search-results></div><template><article class="search-result list-view"><div class="card my-3"><div class=card-body><header><h2 class="h5 title title-submitted mb-0"><a class="stretched-link text-decoration-none text-reset" href=#>Title here</a></h2><div class="submitted d-none"><time class=created-date>Date here</time></div></header><div class=content>Summary here</div></div></div></article></template></div><div class=modal-footer><ul class="list-inline me-auto d-none d-md-block"><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Enter key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M12 3.53088v3c0 1-1 2-2 2H4m3 3-3-3 3-3"/></g></svg></kbd><span class=DocSearch-Label>to select</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Arrow down" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 3.5v8m3-3-3 3-3-3"/></g></svg></kbd><kbd class=me-2><svg width="15" height="15" aria-label="Arrow up" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 11.5v-8m3 3-3-3-3 3"/></g></svg></kbd><span class=DocSearch-Label>to navigate</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Escape key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M13.6167 8.936c-.1065.3583-.6883.962-1.4875.962-.7993.0-1.653-.9165-1.653-2.1258v-.5678c0-1.2548.7896-2.1016 1.653-2.1016s1.3601.4778 1.4875 1.0724M9 6c-.1352-.4735-.7506-.9219-1.46-.8972-.7092.0246-1.344.57-1.344 1.2166s.4198.8812 1.3445.9805C8.465 7.3992 8.968 7.9337 9 8.5s-.454 1.398-1.4595 1.398C6.6593 9.898 6 9 5.963 8.4851m-1.4748.5368c-.2635.5941-.8099.876-1.5443.876s-1.7073-.6248-1.7073-2.204v-.4603c0-1.0416.721-2.131 1.7073-2.131.9864.0 1.6425 1.031 1.5443 2.2492h-2.956"/></g></svg></kbd><span class=DocSearch-Label>to close</span></li></ul><p class=d-md-none>Search by <a class=text-decoration-none href=https://github.com/nextapps-de/flexsearch>FlexSearch</a></p></div></div></div></div><div class="wrap container-lg" role=document><div class=content><div class="row justify-content-center"><div class="col-md-12 col-lg-10 col-xl-8"><article><h1 class=text-center>Introduction</h1><div class=card-list><div class="card my-3"><div class=card-body><a class=stretched-link href=https://wldt.github.io/docs/introduction/dt-life-cycle/>DT Life Cycle &rarr;</a></div></div><div class="card my-3"><div class=card-body><a class=stretched-link href=https://wldt.github.io/docs/introduction/dt-model/>DT Model &rarr;</a></div></div><div class="card my-3"><div class=card-body><a class=stretched-link href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/>Library Structure & Basic Concepts &rarr;</a></div></div></div></article></div></div></div></div><footer class="footer text-muted"><div class=container-lg><div class=row><div class="col-lg-8 text-center text-lg-start"><ul class=list-inline><li class=list-inline-item><a class=text-muted href=https://wldt.github.io/privacy/>Privacy Policy</a></li></ul></div><div class="col-lg-8 text-center text-lg-end"><ul class=list-inline><li class=list-inline-item>Brought to you by <a class=text-muted href=https://gethyas.com/>Hyas</a></li></ul></div></div></div></footer><script async src=https://wldt.github.io/js/app.1e84dcdaa5ccef6fe83f6d88ac1e444a1f237111cfa2a7a97427f758e9c27ef4.js integrity="sha256-HoTc2qXM72/oP22IrB5ESh8jcRHPoqepdCf3WOnCfvQ="></script>
+<script async src=https://wldt.github.io/js/flexsearch.dc00caef2c3490dbab3c345ed0d4133b0aafb803efeb21c3df80776d6d3ea821.js integrity="sha256-3ADK7yw0kNurPDRe0NQTOwqvuAPv6yHD34B3bW0+qCE="></script><script async src=https://wldt.github.io/js/search-modal.c4c023efcdee308e4b5f1110afe1db6b1656f217e67aa7efe54e2f4bf2feccf8.js integrity="sha256-xMAj783uMI5LXxEQr+HbaxZW8hfmeqfv5U4vS/L+zPg="></script><div class="d-inline-flex fixed-bottom-right pb-4 pe-4"><button id=toTop type=button class="btn btn-primary rounded-circle ms-auto p-2"><span class=visually-hidden>Top</span><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-chevron-up" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M6 15l6-6 6 6"/></svg></button></div></body></html>
\ No newline at end of file
diff --git a/docs/introduction/index.xml b/docs/introduction/index.xml
new file mode 100644
index 0000000..10de606
--- /dev/null
+++ b/docs/introduction/index.xml
@@ -0,0 +1 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Introduction on WLDT</title><link>https://wldt.github.io/docs/introduction/</link><description>Recent content in Introduction on WLDT</description><generator>Hugo -- gohugo.io</generator><language>en</language><copyright>Copyright (c) 2023 Hyas</copyright><lastBuildDate>Thu, 07 Sep 2023 16:06:50 +0200</lastBuildDate><atom:link href="https://wldt.github.io/docs/introduction/index.xml" rel="self" type="application/rss+xml"/><item><title>DT Model</title><link>https://wldt.github.io/docs/introduction/dt-model/</link><pubDate>Fri, 09 Feb 2024 11:44:11 +0100</pubDate><guid>https://wldt.github.io/docs/introduction/dt-model/</guid><description>With respect to the element present in the real world, it is defined as a Physical Asset (PA) with the intention of referring to any entity that has a manifestation or relevance in the physical world and a well-defined lifespan.</description></item><item><title>DT Life Cycle</title><link>https://wldt.github.io/docs/introduction/dt-life-cycle/</link><pubDate>Fri, 09 Feb 2024 11:51:38 +0100</pubDate><guid>https://wldt.github.io/docs/introduction/dt-life-cycle/</guid><description>The modeling of the concept of DT includes also the definition and characterization of its life cycle. Based on the scientific literature, we model (and then map into the library) a life cycle with 5 states through which the DT goes from when it is executed to when it is stopped.</description></item><item><title>Library Structure &amp; Basic Concepts</title><link>https://wldt.github.io/docs/introduction/library-structure-basic-concepts/</link><pubDate>Fri, 09 Feb 2024 11:54:42 +0100</pubDate><guid>https://wldt.github.io/docs/introduction/library-structure-basic-concepts/</guid><description>The WLDT framework intends to maximize modularity, re-usability and flexibility in order to effectively mirror physical smart objects in their digital counterparts.</description></item></channel></rss>
\ No newline at end of file
diff --git a/docs/introduction/library-structure-basic-concepts/index.html b/docs/introduction/library-structure-basic-concepts/index.html
new file mode 100644
index 0000000..4edbc02
--- /dev/null
+++ b/docs/introduction/library-structure-basic-concepts/index.html
@@ -0,0 +1,82 @@
+<!doctype html><html lang=en data-bs-theme=auto><head><meta charset=utf-8><meta http-equiv=x-ua-compatible content="ie=edge"><meta name=viewport content="width=device-width,initial-scale=1"><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-regular.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-500.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-700.woff2 type=font/woff2 crossorigin><script src=https://wldt.github.io/js/color-mode.86a91f050a481d0a3f0c72ac26543cb6228c770875981c58dcbc008fd3f875c8.js integrity="sha256-hqkfBQpIHQo/DHKsJlQ8tiKMdwh1mBxY3LwAj9P4dcg="></script>
+<link rel=stylesheet href=https://wldt.github.io/main.5fb433a44687c98f7ae7b3d0137c762777049ba27235e1f08c279c03c8533a7a9a1e3b0ef5b125a31b6bb63a362cdcbc39c3706ed41ad7f1a620b9281013866c.css integrity="sha512-X7QzpEaHyY9657PQE3x2J3cEm6JyNeHwjCecA8hTOnqaHjsO9bEloxtrtjo2LNy8OcNwbtQa1/GmILkoEBOGbA==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>Library Structure & Basic Concepts | WLDT</title><meta property="canonical" content="https://wldt.github.io/docs/introduction/library-structure-basic-concepts/"><meta name=description content="The WLDT framework intends to maximize modularity, re-usability and flexibility in order to effectively mirror physical smart objects in their digital counterparts."><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/docs/introduction/library-structure-basic-concepts/"><meta property="og:title" content="Library Structure & Basic Concepts"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:section" content="docs"><meta property="og:description" content="The WLDT framework intends to maximize modularity, re-usability and flexibility in order to effectively mirror physical smart objects in their digital counterparts."><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-model/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/dt-life-cycle/"><meta property="og:see_also" content="https://wldt.github.io/docs/introduction/library-structure-basic-concepts/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/physical-adapter/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/shadowing-function/"><meta property="og:see_also" content="https://wldt.github.io/docs/guides/digital-adapter/"><meta name=twitter:card content="summary"><meta name=twitter:title content="Library Structure & Basic Concepts"><meta name=twitter:description content="The WLDT framework intends to maximize modularity, re-usability and flexibility in order to effectively mirror physical smart objects in their digital counterparts."><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","item":"https://wldt.github.io/docs/","name":"Docs","position":2},{"@type":"ListItem","item":"https://wldt.github.io/docs/introduction/","name":"Introduction","position":3},{"@type":"ListItem","name":"Library Structure \u0026 Basic Concepts","position":4}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="single section docs" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
+<button type=button id=searchToggleMobile class="btn btn-link nav-link mx-2 d-lg-none" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button class="btn btn-link d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavSection aria-controls=offcanvasNavSection aria-label="Open section navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-dots-vertical" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 19m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 5m-1 0a1 1 0 102 0 1 1 0 10-2 0"/></svg></button><div class="offcanvas offcanvas-start d-lg-none" tabindex=-1 id=offcanvasNavSection aria-labelledby=offcanvasNavSectionLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavSectionLabel>Docs</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class=offcanvas-body><aside class="doks-sidebar mt-n3"><nav id=doks-docs-nav aria-label="Tertiary navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-0b79795d3efc95b9976c7c5b933afce2 aria-expanded=true>
+Introduction</button><div class="collapse show" id=section-0b79795d3efc95b9976c7c5b933afce2><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-model/>DT Model</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-life-cycle/>DT Life Cycle</a></li><li><a class="docs-link rounded active" href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/>Library Structure & Basic Concepts</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-3978929206deee2c125a1d732aae5545 aria-expanded=false>
+Change Logs</button><div class=collapse id=section-3978929206deee2c125a1d732aae5545><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/>Change Log 0.3.0</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-89413bd312d0909efb85e6693f36cb89 aria-expanded=false>
+Adapters</button><div class=collapse id=section-89413bd312d0909efb85e6693f36cb89><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/>MQTT Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/>MQTT Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/http-digital-adapter/>HTTP Digital Adapter</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-bf647454e36069fd16f1a7a35cf6a865 aria-expanded=false>
+Getting Started</button><div class=collapse id=section-bf647454e36069fd16f1a7a35cf6a865><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/physical-adapter/>Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/shadowing-function/>Shadowing Function</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-adapter/>Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/>DT Engine & DT Instance</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-actions/>Digital Actions</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/configurable-adapters/>Configurable Adapters</a></li></ul></div></li></ul></nav></aside></div></div><button class="btn btn-link nav-link mx-2 order-3 d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavMain aria-controls=offcanvasNavMain aria-label="Open main navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-menu" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><line x1="4" y1="8" x2="20" y2="8"/><line x1="4" y1="16" x2="20" y2="16"/></svg></button><div class="offcanvas offcanvas-end h-auto" tabindex=-1 id=offcanvasNavMain aria-labelledby=offcanvasNavMainLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavMainLabel>WLDT</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class="offcanvas-body d-flex flex-column flex-lg-row justify-content-between"><ul class="navbar-nav flex-grow-1"><li class=nav-item><a class=nav-link href=https://wldt.github.io/docs/guides/example-guide/>Documentation</a></li><li class=nav-item><a class=nav-link href=https://wldt.github.io/blog/>Blog</a></li></ul><button type=button id=searchToggleDesktop class="btn btn-link nav-link p-2 d-none d-lg-block" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button id=buttonColorMode class="btn btn-link mx-auto nav-link p-0 ms-lg-2 me-lg-1" type=button aria-label="Toggle theme"><svg data-bs-theme-value="dark" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-moon" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 3c.132.0.263.0.393.0a7.5 7.5.0 007.92 12.446A9 9 0 1112 2.992z"/></svg><svg data-bs-theme-value="light" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-sun" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-4 0a4 4 0 108 0 4 4 0 10-8 0m-5 0h1m8-9v1m8 8h1m-9 8v1M5.6 5.6l.7.7m12.1-.7-.7.7m0 11.4.7.7m-12.1-.7-.7.7"/></svg></button><ul id=socialMenu class="nav mx-auto flex-row order-lg-4"><li class=nav-item><a class="nav-link social-link" href=https://github.com/wldt><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-brand-github" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 19c-4.3 1.4-4.3-2.5-6-3m12 5v-3.5c0-1 .1-1.4-.5-2 2.8-.3 5.5-1.4 5.5-6a4.6 4.6.0 00-1.3-3.2 4.2 4.2.0 00-.1-3.2s-1.1-.3-3.5 1.3a12.3 12.3.0 00-6.2.0C6.5 2.8 5.4 3.1 5.4 3.1a4.2 4.2.0 00-.1 3.2A4.6 4.6.0 004 9.5c0 4.6 2.7 5.7 5.5 6-.6.6-.6 1.2-.5 2V21"/></svg><small class="ms-2 visually-hidden">GitHub</small></a></li></ul></div></div></div></header></div><div class=modal id=searchModal tabindex=-1 aria-labelledby=searchModalLabel aria-hidden=true><div class="modal-dialog modal-dialog-scrollable modal-fullscreen-md-down"><div class=modal-content><div class=modal-header><h1 class="modal-title fs-5 visually-hidden" id=searchModalLabel>Search</h1><button type=button class="btn-close visually-hidden" data-bs-dismiss=modal aria-label=Close></button><div class="search-input flex-grow-1 d-none"><form id=search-form class=search-form action=# method=post accept-charset=utf-8 role=search><label for=query class=visually-hidden>Search</label><div class=d-flex><input type=search id=query name=query class="search-text form-control form-control-lg" placeholder=Search aria-label=Search maxlength=128 autocomplete=off>
+<button type=button class="btn btn-link text-decoration-none px-0 ms-3 d-md-none" data-bs-dismiss=modal aria-label=Close>Cancel</button></div></form></div></div><div class=modal-body><p class="search-loading status message d-none mt-3 text-center">Loading search index…</p><p class="search-no-recent message d-none mt-3 text-center">No recent searches</p><p class="search-no-results message d-none mt-3 text-center">No results for "<strong><span class=query-no-results>Query here</span></strong>"</p><div id=searchResults class=search-results></div><template><article class="search-result list-view"><div class="card my-3"><div class=card-body><header><h2 class="h5 title title-submitted mb-0"><a class="stretched-link text-decoration-none text-reset" href=#>Title here</a></h2><div class="submitted d-none"><time class=created-date>Date here</time></div></header><div class=content>Summary here</div></div></div></article></template></div><div class=modal-footer><ul class="list-inline me-auto d-none d-md-block"><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Enter key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M12 3.53088v3c0 1-1 2-2 2H4m3 3-3-3 3-3"/></g></svg></kbd><span class=DocSearch-Label>to select</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Arrow down" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 3.5v8m3-3-3 3-3-3"/></g></svg></kbd><kbd class=me-2><svg width="15" height="15" aria-label="Arrow up" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 11.5v-8m3 3-3-3-3 3"/></g></svg></kbd><span class=DocSearch-Label>to navigate</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Escape key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M13.6167 8.936c-.1065.3583-.6883.962-1.4875.962-.7993.0-1.653-.9165-1.653-2.1258v-.5678c0-1.2548.7896-2.1016 1.653-2.1016s1.3601.4778 1.4875 1.0724M9 6c-.1352-.4735-.7506-.9219-1.46-.8972-.7092.0246-1.344.57-1.344 1.2166s.4198.8812 1.3445.9805C8.465 7.3992 8.968 7.9337 9 8.5s-.454 1.398-1.4595 1.398C6.6593 9.898 6 9 5.963 8.4851m-1.4748.5368c-.2635.5941-.8099.876-1.5443.876s-1.7073-.6248-1.7073-2.204v-.4603c0-1.0416.721-2.131 1.7073-2.131.9864.0 1.6425 1.031 1.5443 2.2492h-2.956"/></g></svg></kbd><span class=DocSearch-Label>to close</span></li></ul><p class=d-md-none>Search by <a class=text-decoration-none href=https://github.com/nextapps-de/flexsearch>FlexSearch</a></p></div></div></div></div><div class="wrap container-lg" role=document><div class=content><div class="row flex-xl-nowrap"><div class="col-lg-5 col-xl-4 docs-sidebar d-none d-lg-block"><nav class=docs-links aria-label="Main navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-0b79795d3efc95b9976c7c5b933afce2 aria-expanded=true>
+Introduction</button><div class="collapse show" id=section-0b79795d3efc95b9976c7c5b933afce2><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-model/>DT Model</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/introduction/dt-life-cycle/>DT Life Cycle</a></li><li><a class="docs-link rounded active" href=https://wldt.github.io/docs/introduction/library-structure-basic-concepts/>Library Structure & Basic Concepts</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-3978929206deee2c125a1d732aae5545 aria-expanded=false>
+Change Logs</button><div class=collapse id=section-3978929206deee2c125a1d732aae5545><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/change-logs/change-log-0.3.0/>Change Log 0.3.0</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-89413bd312d0909efb85e6693f36cb89 aria-expanded=false>
+Adapters</button><div class=collapse id=section-89413bd312d0909efb85e6693f36cb89><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-physical-adapter/>MQTT Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/mqtt-digital-adapter/>MQTT Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/adapters/http-digital-adapter/>HTTP Digital Adapter</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-bf647454e36069fd16f1a7a35cf6a865 aria-expanded=false>
+Getting Started</button><div class=collapse id=section-bf647454e36069fd16f1a7a35cf6a865><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/physical-adapter/>Physical Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/shadowing-function/>Shadowing Function</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-adapter/>Digital Adapter</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/dt-engine-dt-instance/>DT Engine & DT Instance</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/digital-actions/>Digital Actions</a></li><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/configurable-adapters/>Configurable Adapters</a></li></ul></div></li></ul></nav></div><nav class="docs-toc d-none d-xl-block col-xl-3" aria-label="Secondary navigation"><div class=page-links></div></nav><main class="docs-content col-lg-11 col-xl-9"><nav aria-label=breadcrumb><ol class=breadcrumb><li class=breadcrumb-item><a href=https://wldt.github.io/>Home</a></li><li class=breadcrumb-item><a href=https://wldt.github.io/docs/>Docs</a></li><li class=breadcrumb-item><a href=https://wldt.github.io/docs/introduction/>Introduction</a></li><li class="breadcrumb-item active" aria-current=page>Library Structure & Basic Concepts</li></ol></nav><h1>Library Structure & Basic Concepts</h1><nav class="toc-mobile d-xl-none" aria-label="Quaternary navigation"></nav><p>The WLDT framework intends to maximize modularity, re-usability and flexibility in order to effectively mirror
+physical smart objects in their digital counterparts. The proposed library focuses on the simplification of twins
+design and development aiming to provide a set of core features and functionalities for the widespread
+adoption of Internet of Things DTs applications.</p><p>A WLDT instance is a general purpose software entity
+implementing all the features and functionalities of a Digital Twin running
+in cloud or on the edge. It has the peculiar characteristic
+to be generic and ``attachable&rsquo;&rsquo; to any physical thing in order to
+impersonate and maintain its digital replica and extend the provided functionalities
+for example through the support of additional protocols or a specific translation
+or normalization for data and formats.</p><p>Hereafter, the requirements that led the design and development of the WLDT framework are:</p><ul><li>i) Simplicity - with WLDT developers must have the possibility to easily create a new instance by using
+existing modules or customizing the behavior according the need of their application scenario;</li><li>ii) Extensibility - while WLDT must be as simple and light as possible,
+the API should be also easily extendible in order to let programmers to personalize
+the configuration and/or to add new features loading and executing multiple modules at the same times;</li><li>iii) Portability & Micorservice Readiness - a digital twin implemented through WLDT must
+be able to run on any platform without changes and customization. Our goal is to have a simple and light core engine
+with a strategic set of IoT-oriented features allowing the developer to easily create DT applications modeled
+as independent software agents and packed as microservices.</li></ul><p>In the following Figure, the main components that make up the architecture of WLDT are represented,
+and thus through which the individual Digital Twin is implemented.
+Specifically, from the image it is possible to identify the three levels on which the
+architecture is developed: the one related to the <code>core</code> of the library, the one that <code>models</code> the DT,
+and finally, that of the <code>adapters</code>.</p><p>Each of this core components has the following main characteristics:</p><ul><li><strong>Metrics Manager</strong>: Provides the functionalities for managing and tracking various metrics
+within DT instances combining both internal and custom metrics through a flexible and extensible approach.</li><li><strong>Logger</strong>: Is designed to facilitate efficient and customizable logging within implemented and deployed DTs with
+configurable log levels and versatile output options.</li><li><strong>Utils & Commons</strong>: Hold a collection of utility classes and common functionalities that can be readily employed
+across DT implementations ranging from handling common data structures to providing helpful tools for string manipulation.</li><li><strong>Event Communication Bus</strong>: Represents the internal Event Bus, designed to support communication between
+the different components of the DT&rsquo;s instance. It allows defining customized events to model
+both physical and digital input and outputs. Each WLDT&rsquo;s component can publish on the shared Event Bus and define
+an Event Filter to specify which types of events it is interested in managing,
+associating a specific callback to each one to process the different messages.</li><li><strong>Digital Twin Engine</strong>: Defines the multi-thread engine of the library allowing the execution and monitoring of
+multiple DTs (and their core components) simultaneously. Therefore, it is also responsible for orchestrating
+the different internal modules of the architecture while keeping track of each one, and it can be
+considered the core of the platform itself allowing the execution and control of the deployed DTs. Currently, it supports
+the execution of twins on the same Java process, however the same engine abstraction might be used to extend the framework to
+support distributed execution for example through different processes or microservices.</li><li><strong>Digital Twin</strong>: Models a modular DT structure built through the combination of core functionalities together with physical
+and digital adapter capabilities. This Layer includes the <code>Digital Twin State</code> responsible to structure the state of the DT by defining the list of properties, events, and actions.
+The different instances included in the lists can correspond directly to elements of the physical asset
+or can derive from their combination, in any case, it is the <code>Shadowing Function (SF)</code> that defines
+the mapping, following the model defined by the designer.
+This component also exposes a set of methods to allow SF manipulation.
+Every time the Digital Twin State is modified, the latter generates the corresponding DT&rsquo;s event to notify all the components
+about the variation.</li><li><strong>Shadowing Function</strong>: It is the library component responsible for defining the behavior of
+the Digital Twin by interacting with the Digital Twin State.
+Specifically, it implements the shadowing process that allows keeping the
+DT synchronized with its physical entity.
+This component is based on a specific implementation of a WLDT Worker called Model Engine,
+in order to be executed by the WLDT Engine.
+The Shadowing Model Function is the fundamental component that must be extended by the DT designer
+to concretize its model.
+The shadowing function observes the life cycle of the Digital Twin to be notified of the different state changes.
+For example, it is informed when the DT enters the Bound state, i.e. when its Physical Adapters
+have completed the binding procedure with the physical asset. This component also allows the designer
+to define the behavior of the DT in case a property is modified, an event is triggered, or an action is invoked.</li><li><strong>Physical Adapter</strong>: It defines the essential functionalities that the individual extensions,
+related to specific protocols, must implement.
+As provided by the DT definition, a DT can be equipped with multiple Physical Adapters
+in order to manage communication with the corresponding physical entity.
+Each will produce a <code>Physical Asset Description (PAD)</code>,
+i.e., a description of the properties, events, actions, and relationships
+that the physical asset exposes through the specific protocol.
+The DT transitions from the Unbound to the Bound state when all its Physical Adapters
+have produced their respective PADs.
+The Shadowing Function, following the DT model,
+selects the components of the various PADs that it is interested in managing.</li><li><strong>Digital Adapter</strong>: It provides the set of callbacks that each specific implementation can use
+to be notified of changes in the DT state.
+Symmetrically to what happens with Physical Adapters, a Digital Twin can define
+multiple Digital Adapters to expose its state and functionality through different protocols.</li></ul><p>Therefore, to create a Digital Twin using WLDT, it is necessary to define and instantiate a DT with its Shadowing Function and
+at least one Physical Adapter and one Digital Adapter, in order to enable connection with the physical
+entity and allow the DT to be used by external applications. Once the 3 components are defined,
+it is possible to instantiate the WLDT Engine and, subsequently, start the lifecycle of the DT.
+In the following sections we will go through the fundamental steps to start working with the library and creating all
+the basic modules to design, develop and execute our first Java Digital Twin.</p><div class="page-footer-meta d-flex flex-column flex-md-row justify-content-between"><div class=last-modified><a href=https://github.com/wldt/wldt.github.io/commit/ab5a164de259055162e9420d8cb56c2b1562dee9><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-calendar"><rect x="3" y="4" width="18" height="18" rx="2" ry="2"/><line x1="16" y1="2" x2="16" y2="6"/><line x1="8" y1="2" x2="8" y2="6"/><line x1="3" y1="10" x2="21" y2="10"/></svg>Last updated on February 9, 2024</a></div><div class=edit-page><a href=https://github.com/wldt/wldt.github.io/blob/main/content//docs/introduction/library-structure.md><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-edit-2"><path d="M17 3a2.828 2.828.0 114 4L7.5 20.5 2 22l1.5-5.5L17 3z"/></svg>Edit this page on GitHub</a></div></div><div class="page-nav d-flex flex-column flex-sm-row"><div class="card w-100"><div class="card-body d-flex"><div class="d-flex flex-column justify-content-center"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-arrow-left" width="20" height="20" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 12h14"/><path d="M5 12l6 6"/><path d="M5 12l6-6"/></svg></div><div class="d-flex flex-column"><div class=text-body-secondary>Prev</div><a href=https://wldt.github.io/docs/introduction/dt-life-cycle/ class="stretched-link text-reset text-decoration-none">DT Life Cycle</a></div></div></div></div></main></div></div></div><footer class="footer text-muted"><div class=container-lg><div class=row><div class="col-lg-8 text-center text-lg-start"><ul class=list-inline><li class=list-inline-item><a class=text-muted href=https://wldt.github.io/privacy/>Privacy Policy</a></li></ul></div><div class="col-lg-8 text-center text-lg-end"><ul class=list-inline><li class=list-inline-item>Brought to you by <a class=text-muted href=https://gethyas.com/>Hyas</a></li></ul></div></div></div></footer><script async src=https://wldt.github.io/js/app.1e84dcdaa5ccef6fe83f6d88ac1e444a1f237111cfa2a7a97427f758e9c27ef4.js integrity="sha256-HoTc2qXM72/oP22IrB5ESh8jcRHPoqepdCf3WOnCfvQ="></script>
+<script async src=https://wldt.github.io/js/flexsearch.dc00caef2c3490dbab3c345ed0d4133b0aafb803efeb21c3df80776d6d3ea821.js integrity="sha256-3ADK7yw0kNurPDRe0NQTOwqvuAPv6yHD34B3bW0+qCE="></script><script async src=https://wldt.github.io/js/search-modal.c4c023efcdee308e4b5f1110afe1db6b1656f217e67aa7efe54e2f4bf2feccf8.js integrity="sha256-xMAj783uMI5LXxEQr+HbaxZW8hfmeqfv5U4vS/L+zPg="></script><div class="d-inline-flex fixed-bottom-right pb-4 pe-4"><button id=toTop type=button class="btn btn-primary rounded-circle ms-auto p-2"><span class=visually-hidden>Top</span><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-chevron-up" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M6 15l6-6 6 6"/></svg></button></div></body></html>
\ No newline at end of file
diff --git a/docs/introduction/page/1/index.html b/docs/introduction/page/1/index.html
new file mode 100644
index 0000000..f8e3ad4
--- /dev/null
+++ b/docs/introduction/page/1/index.html
@@ -0,0 +1 @@
+<!doctype html><html lang=en><head><title>https://wldt.github.io/docs/introduction/</title><link rel=canonical href=https://wldt.github.io/docs/introduction/><meta name=robots content="noindex"><meta charset=utf-8><meta http-equiv=refresh content="0; url=https://wldt.github.io/docs/introduction/"></head></html>
\ No newline at end of file
diff --git a/docs/introduction/sitemap.xml b/docs/introduction/sitemap.xml
new file mode 100644
index 0000000..c331583
--- /dev/null
+++ b/docs/introduction/sitemap.xml
@@ -0,0 +1 @@
+<?xml version="1.0" encoding="utf-8" standalone="yes"?><urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml"><url><loc>https://wldt.github.io/docs/introduction/dt-model/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/introduction/dt-life-cycle/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/introduction/library-structure-basic-concepts/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url></urlset>
\ No newline at end of file
diff --git a/docs/reference/example-reference/index.html b/docs/reference/example-reference/index.html
deleted file mode 100644
index 6bb790c..0000000
--- a/docs/reference/example-reference/index.html
+++ /dev/null
@@ -1,11 +0,0 @@
-<!doctype html><html lang=en data-bs-theme=auto><head><meta charset=utf-8><meta http-equiv=x-ua-compatible content="ie=edge"><meta name=viewport content="width=device-width,initial-scale=1"><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-regular.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-500.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-700.woff2 type=font/woff2 crossorigin><script src=https://wldt.github.io/js/color-mode.86a91f050a481d0a3f0c72ac26543cb6228c770875981c58dcbc008fd3f875c8.js integrity="sha256-hqkfBQpIHQo/DHKsJlQ8tiKMdwh1mBxY3LwAj9P4dcg="></script>
-<link rel=stylesheet href=https://wldt.github.io/main.5d6e5440c13f1c45183e82bbb906165564d1edfd71498c4a2c38775086796022bfab9cfb137199a537d8e42c2fb6ce2ab74b69461aed15b7389bd0e12ec63b19.css integrity="sha512-XW5UQME/HEUYPoK7uQYWVWTR7f1xSYxKLDh3UIZ5YCK/q5z7E3GZpTfY5Cwvts4qt0tpRhrtFbc4m9DhLsY7GQ==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>Example Reference | WLDT</title><meta property="canonical" content="https://wldt.github.io/docs/reference/example-reference/"><meta name=description content="Reference pages are ideal for outlining how things work in terse and clear terms. Less concerned with telling a story or addressing a specific use case, they should give a comprehensive outline of what your documenting."><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/docs/reference/example-reference/"><meta property="og:title" content="Example Reference"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:section" content="docs"><meta property="og:description" content="Reference pages are ideal for outlining how things work in terse and clear terms. Less concerned with telling a story or addressing a specific use case, they should give a comprehensive outline of what your documenting."><meta property="og:see_also" content="https://wldt.github.io/docs/guides/example-guide/"><meta property="og:see_also" content="https://wldt.github.io/docs/reference/example-reference/"><meta name=twitter:card content="summary"><meta name=twitter:title content="Example Reference"><meta name=twitter:description content="Reference pages are ideal for outlining how things work in terse and clear terms. Less concerned with telling a story or addressing a specific use case, they should give a comprehensive outline of what your documenting."><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","item":"https://wldt.github.io/docs/","name":"Docs","position":2},{"@type":"ListItem","item":"https://wldt.github.io/docs/reference/","name":"Reference","position":3},{"@type":"ListItem","name":"Example Reference","position":4}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="single section docs" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
-<button type=button id=searchToggleMobile class="btn btn-link nav-link mx-2 d-lg-none" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
-<button class="btn btn-link d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavSection aria-controls=offcanvasNavSection aria-label="Open section navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-dots-vertical" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 19m-1 0a1 1 0 102 0 1 1 0 10-2 0"/><path d="M12 5m-1 0a1 1 0 102 0 1 1 0 10-2 0"/></svg></button><div class="offcanvas offcanvas-start d-lg-none" tabindex=-1 id=offcanvasNavSection aria-labelledby=offcanvasNavSectionLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavSectionLabel>Docs</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class=offcanvas-body><aside class="doks-sidebar mt-n3"><nav id=doks-docs-nav aria-label="Tertiary navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-45389ee90014e0938cb09409b9a8794d aria-expanded=false>
-Guides</button><div class=collapse id=section-45389ee90014e0938cb09409b9a8794d><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/example-guide/>Example Guide</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-63d5049791d9d79d86e9a108b0a999ca aria-expanded=true>
-Reference</button><div class="collapse show" id=section-63d5049791d9d79d86e9a108b0a999ca><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded active" href=https://wldt.github.io/docs/reference/example-reference/>Example Reference</a></li></ul></div></li></ul></nav></aside></div></div><button class="btn btn-link nav-link mx-2 order-3 d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavMain aria-controls=offcanvasNavMain aria-label="Open main navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-menu" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><line x1="4" y1="8" x2="20" y2="8"/><line x1="4" y1="16" x2="20" y2="16"/></svg></button><div class="offcanvas offcanvas-end h-auto" tabindex=-1 id=offcanvasNavMain aria-labelledby=offcanvasNavMainLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavMainLabel>WLDT</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class="offcanvas-body d-flex flex-column flex-lg-row justify-content-between"><ul class="navbar-nav flex-grow-1"><li class=nav-item><a class=nav-link href=https://wldt.github.io/docs/guides/example-guide/>Documentation</a></li><li class=nav-item><a class=nav-link href=https://wldt.github.io/blog/>Blog</a></li></ul><button type=button id=searchToggleDesktop class="btn btn-link nav-link p-2 d-none d-lg-block" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
-<button id=buttonColorMode class="btn btn-link mx-auto nav-link p-0 ms-lg-2 me-lg-1" type=button aria-label="Toggle theme"><svg data-bs-theme-value="dark" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-moon" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 3c.132.0.263.0.393.0a7.5 7.5.0 007.92 12.446A9 9 0 1112 2.992z"/></svg><svg data-bs-theme-value="light" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-sun" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-4 0a4 4 0 108 0 4 4 0 10-8 0m-5 0h1m8-9v1m8 8h1m-9 8v1M5.6 5.6l.7.7m12.1-.7-.7.7m0 11.4.7.7m-12.1-.7-.7.7"/></svg></button><ul id=socialMenu class="nav mx-auto flex-row order-lg-4"><li class=nav-item><a class="nav-link social-link" href=https://github.com/wldt><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-brand-github" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 19c-4.3 1.4-4.3-2.5-6-3m12 5v-3.5c0-1 .1-1.4-.5-2 2.8-.3 5.5-1.4 5.5-6a4.6 4.6.0 00-1.3-3.2 4.2 4.2.0 00-.1-3.2s-1.1-.3-3.5 1.3a12.3 12.3.0 00-6.2.0C6.5 2.8 5.4 3.1 5.4 3.1a4.2 4.2.0 00-.1 3.2A4.6 4.6.0 004 9.5c0 4.6 2.7 5.7 5.5 6-.6.6-.6 1.2-.5 2V21"/></svg><small class="ms-2 visually-hidden">GitHub</small></a></li></ul></div></div></div></header></div><div class=modal id=searchModal tabindex=-1 aria-labelledby=searchModalLabel aria-hidden=true><div class="modal-dialog modal-dialog-scrollable modal-fullscreen-md-down"><div class=modal-content><div class=modal-header><h1 class="modal-title fs-5 visually-hidden" id=searchModalLabel>Search</h1><button type=button class="btn-close visually-hidden" data-bs-dismiss=modal aria-label=Close></button><div class="search-input flex-grow-1 d-none"><form id=search-form class=search-form action=# method=post accept-charset=utf-8 role=search><label for=query class=visually-hidden>Search</label><div class=d-flex><input type=search id=query name=query class="search-text form-control form-control-lg" placeholder=Search aria-label=Search maxlength=128 autocomplete=off>
-<button type=button class="btn btn-link text-decoration-none px-0 ms-3 d-md-none" data-bs-dismiss=modal aria-label=Close>Cancel</button></div></form></div></div><div class=modal-body><p class="search-loading status message d-none mt-3 text-center">Loading search index…</p><p class="search-no-recent message d-none mt-3 text-center">No recent searches</p><p class="search-no-results message d-none mt-3 text-center">No results for "<strong><span class=query-no-results>Query here</span></strong>"</p><div id=searchResults class=search-results></div><template><article class="search-result list-view"><div class="card my-3"><div class=card-body><header><h2 class="h5 title title-submitted mb-0"><a class="stretched-link text-decoration-none text-reset" href=#>Title here</a></h2><div class="submitted d-none"><time class=created-date>Date here</time></div></header><div class=content>Summary here</div></div></div></article></template></div><div class=modal-footer><ul class="list-inline me-auto d-none d-md-block"><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Enter key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M12 3.53088v3c0 1-1 2-2 2H4m3 3-3-3 3-3"/></g></svg></kbd><span class=DocSearch-Label>to select</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Arrow down" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 3.5v8m3-3-3 3-3-3"/></g></svg></kbd><kbd class=me-2><svg width="15" height="15" aria-label="Arrow up" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 11.5v-8m3 3-3-3-3 3"/></g></svg></kbd><span class=DocSearch-Label>to navigate</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Escape key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M13.6167 8.936c-.1065.3583-.6883.962-1.4875.962-.7993.0-1.653-.9165-1.653-2.1258v-.5678c0-1.2548.7896-2.1016 1.653-2.1016s1.3601.4778 1.4875 1.0724M9 6c-.1352-.4735-.7506-.9219-1.46-.8972-.7092.0246-1.344.57-1.344 1.2166s.4198.8812 1.3445.9805C8.465 7.3992 8.968 7.9337 9 8.5s-.454 1.398-1.4595 1.398C6.6593 9.898 6 9 5.963 8.4851m-1.4748.5368c-.2635.5941-.8099.876-1.5443.876s-1.7073-.6248-1.7073-2.204v-.4603c0-1.0416.721-2.131 1.7073-2.131.9864.0 1.6425 1.031 1.5443 2.2492h-2.956"/></g></svg></kbd><span class=DocSearch-Label>to close</span></li></ul><p class=d-md-none>Search by <a class=text-decoration-none href=https://github.com/nextapps-de/flexsearch>FlexSearch</a></p></div></div></div></div><div class="wrap container-lg" role=document><div class=content><div class="row flex-xl-nowrap"><div class="col-lg-5 col-xl-4 docs-sidebar d-none d-lg-block"><nav class=docs-links aria-label="Main navigation"><ul class="list-unstyled collapsible-sidebar"><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-45389ee90014e0938cb09409b9a8794d aria-expanded=false>
-Guides</button><div class=collapse id=section-45389ee90014e0938cb09409b9a8794d><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded" href=https://wldt.github.io/docs/guides/example-guide/>Example Guide</a></li></ul></div></li><li class=mb-1><button class="btn btn-toggle align-items-center rounded collapsed" data-bs-toggle=collapse data-bs-target=#section-63d5049791d9d79d86e9a108b0a999ca aria-expanded=true>
-Reference</button><div class="collapse show" id=section-63d5049791d9d79d86e9a108b0a999ca><ul class="btn-toggle-nav list-unstyled fw-normal pb-1 small"><li><a class="docs-link rounded active" href=https://wldt.github.io/docs/reference/example-reference/>Example Reference</a></li></ul></div></li></ul></nav></div><nav class="docs-toc d-none d-xl-block col-xl-3" aria-label="Secondary navigation"><div class=page-links><h3>Example Guide</h3><nav id=toc><ul><li><a href=#further-reading>Further reading</a></li></ul></nav></div></nav><main class="docs-content col-lg-11 col-xl-9"><nav aria-label=breadcrumb><ol class=breadcrumb><li class=breadcrumb-item><a href=https://wldt.github.io/>Home</a></li><li class=breadcrumb-item><a href=https://wldt.github.io/docs/>Docs</a></li><li class=breadcrumb-item><a href=https://wldt.github.io/docs/reference/>Reference</a></li><li class="breadcrumb-item active" aria-current=page>Example Reference</li></ol></nav><h1>Example Reference</h1><nav class="toc-mobile d-xl-none" aria-label="Quaternary navigation"><details><summary>On this page</summary><div class=page-links><nav id=TableOfContents><ul><li><a href=#further-reading>Further reading</a></li></ul></nav></div></details></nav><p>Reference pages are ideal for outlining how things work in terse and clear terms. Less concerned with telling a story or addressing a specific use case, they should give a comprehensive outline of what your documenting.</p><h2 id=further-reading>Further reading<a href=#further-reading class=anchor aria-hidden=true>#</a></h2><ul><li>Read <a href=https://diataxis.fr/reference/>about reference</a> in the Diátaxis framework</li></ul><div class="page-footer-meta d-flex flex-column flex-md-row justify-content-between"><div class=last-modified><a href=https://github.com/wldt/wldt.github.io/commit/4527b1ec8860597aebbb44ede14781ea4e43e577><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-calendar"><rect x="3" y="4" width="18" height="18" rx="2" ry="2"/><line x1="16" y1="2" x2="16" y2="6"/><line x1="8" y1="2" x2="8" y2="6"/><line x1="3" y1="10" x2="21" y2="10"/></svg>Last updated on February 9, 2024</a></div><div class=edit-page><a href=https://github.com/wldt/wldt.github.io/blob/main/content//docs/reference/example.md><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentcolor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-edit-2"><path d="M17 3a2.828 2.828.0 114 4L7.5 20.5 2 22l1.5-5.5L17 3z"/></svg>Edit this page on GitHub</a></div></div><div class="page-nav d-flex flex-column flex-sm-row"><div class="card w-100"><div class="card-body d-flex"><div class="d-flex flex-column justify-content-center"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-arrow-left" width="20" height="20" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 12h14"/><path d="M5 12l6 6"/><path d="M5 12l6-6"/></svg></div><div class="d-flex flex-column"><div class=text-body-secondary>Prev</div><a href=https://wldt.github.io/docs/guides/example-guide/ class="stretched-link text-reset text-decoration-none">Example Guide</a></div></div></div></div></main></div></div></div><footer class="footer text-muted"><div class=container-lg><div class=row><div class="col-lg-8 text-center text-lg-start"><ul class=list-inline><li class=list-inline-item><a class=text-muted href=https://wldt.github.io/privacy/>Privacy Policy</a></li></ul></div><div class="col-lg-8 text-center text-lg-end"><ul class=list-inline><li class=list-inline-item>Brought to you by <a class=text-muted href=https://gethyas.com/>Hyas</a></li></ul></div></div></div></footer><script async src=https://wldt.github.io/js/app.1e84dcdaa5ccef6fe83f6d88ac1e444a1f237111cfa2a7a97427f758e9c27ef4.js integrity="sha256-HoTc2qXM72/oP22IrB5ESh8jcRHPoqepdCf3WOnCfvQ="></script>
-<script async src=https://wldt.github.io/js/flexsearch.dc00caef2c3490dbab3c345ed0d4133b0aafb803efeb21c3df80776d6d3ea821.js integrity="sha256-3ADK7yw0kNurPDRe0NQTOwqvuAPv6yHD34B3bW0+qCE="></script><script async src=https://wldt.github.io/js/search-modal.c4c023efcdee308e4b5f1110afe1db6b1656f217e67aa7efe54e2f4bf2feccf8.js integrity="sha256-xMAj783uMI5LXxEQr+HbaxZW8hfmeqfv5U4vS/L+zPg="></script><div class="d-inline-flex fixed-bottom-right pb-4 pe-4"><button id=toTop type=button class="btn btn-primary rounded-circle ms-auto p-2"><span class=visually-hidden>Top</span><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-chevron-up" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M6 15l6-6 6 6"/></svg></button></div></body></html>
\ No newline at end of file
diff --git a/docs/reference/index.xml b/docs/reference/index.xml
deleted file mode 100644
index ac5c22c..0000000
--- a/docs/reference/index.xml
+++ /dev/null
@@ -1 +0,0 @@
-<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Reference on WLDT</title><link>https://wldt.github.io/docs/reference/</link><description>Recent content in Reference on WLDT</description><generator>Hugo -- gohugo.io</generator><language>en</language><copyright>Copyright (c) 2023 Hyas</copyright><lastBuildDate>Thu, 07 Sep 2023 16:12:37 +0200</lastBuildDate><atom:link href="https://wldt.github.io/docs/reference/index.xml" rel="self" type="application/rss+xml"/><item><title>Example Reference</title><link>https://wldt.github.io/docs/reference/example-reference/</link><pubDate>Thu, 07 Sep 2023 16:13:18 +0200</pubDate><guid>https://wldt.github.io/docs/reference/example-reference/</guid><description>Reference pages are ideal for outlining how things work in terse and clear terms. Less concerned with telling a story or addressing a specific use case, they should give a comprehensive outline of what your documenting.</description></item></channel></rss>
\ No newline at end of file
diff --git a/docs/reference/page/1/index.html b/docs/reference/page/1/index.html
deleted file mode 100644
index 41a3495..0000000
--- a/docs/reference/page/1/index.html
+++ /dev/null
@@ -1 +0,0 @@
-<!doctype html><html lang=en><head><title>https://wldt.github.io/docs/reference/</title><link rel=canonical href=https://wldt.github.io/docs/reference/><meta name=robots content="noindex"><meta charset=utf-8><meta http-equiv=refresh content="0; url=https://wldt.github.io/docs/reference/"></head></html>
\ No newline at end of file
diff --git a/docs/sitemap.xml b/docs/sitemap.xml
index 4ead103..3298544 100644
--- a/docs/sitemap.xml
+++ b/docs/sitemap.xml
@@ -1 +1 @@
-<?xml version="1.0" encoding="utf-8" standalone="yes"?><urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml"><url><loc>https://wldt.github.io/docs/guides/</loc><lastmod>2024-02-09T09:54:12+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/reference/</loc><lastmod>2024-02-09T09:54:12+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/guides/example-guide/</loc><lastmod>2024-02-09T09:54:12+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/reference/example-reference/</loc><lastmod>2024-02-09T09:54:12+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url></urlset>
\ No newline at end of file
+<?xml version="1.0" encoding="utf-8" standalone="yes"?><urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml"><url><loc>https://wldt.github.io/docs/introduction/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/change-logs/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/adapters/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/guides/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/introduction/dt-model/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/introduction/dt-life-cycle/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/introduction/library-structure-basic-concepts/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/change-logs/change-log-0.3.0/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/adapters/mqtt-physical-adapter/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/adapters/mqtt-digital-adapter/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/adapters/http-digital-adapter/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/guides/physical-adapter/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/guides/shadowing-function/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/guides/digital-adapter/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/guides/dt-engine-dt-instance/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/guides/digital-actions/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/guides/configurable-adapters/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url></urlset>
\ No newline at end of file
diff --git a/en/sitemap.xml b/en/sitemap.xml
index 85345b5..8b9b951 100644
--- a/en/sitemap.xml
+++ b/en/sitemap.xml
@@ -1 +1 @@
-<?xml version="1.0" encoding="utf-8" standalone="yes"?><urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml"><url><loc>https://wldt.github.io/blog/example-post/</loc><lastmod>2024-02-09T09:54:12+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/blog/</loc><lastmod>2024-02-09T09:54:12+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/guides/</loc><lastmod>2024-02-09T09:54:12+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/guides/example-guide/</loc><lastmod>2024-02-09T09:54:12+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/reference/</loc><lastmod>2024-02-09T09:54:12+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/reference/example-reference/</loc><lastmod>2024-02-09T09:54:12+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/</loc><lastmod>2024-02-09T09:54:12+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/</loc><lastmod>2024-02-09T09:54:12+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/privacy/</loc><lastmod>2024-02-09T09:54:12+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/categories/</loc><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/contributors/</loc><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/tags/</loc><changefreq>monthly</changefreq><priority>0.5</priority></url></urlset>
\ No newline at end of file
+<?xml version="1.0" encoding="utf-8" standalone="yes"?><urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml"><url><loc>https://wldt.github.io/blog/example-post/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/blog/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/introduction/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/guides/physical-adapter/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/guides/shadowing-function/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/guides/digital-adapter/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/guides/dt-engine-dt-instance/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/guides/digital-actions/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/guides/configurable-adapters/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/adapters/mqtt-physical-adapter/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/change-logs/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/adapters/mqtt-digital-adapter/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/change-logs/change-log-0.3.0/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/adapters/http-digital-adapter/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/introduction/dt-model/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/introduction/dt-life-cycle/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/adapters/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/guides/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/introduction/library-structure-basic-concepts/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/docs/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/privacy/</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/categories/</loc><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/contributors/</loc><changefreq>monthly</changefreq><priority>0.5</priority></url><url><loc>https://wldt.github.io/tags/</loc><changefreq>monthly</changefreq><priority>0.5</priority></url></urlset>
\ No newline at end of file
diff --git a/index.html b/index.html
index 353c2a3..25e8631 100644
--- a/index.html
+++ b/index.html
@@ -1,7 +1,7 @@
 <!doctype html><html lang=en data-bs-theme=auto><head><meta charset=utf-8><meta http-equiv=x-ua-compatible content="ie=edge"><meta name=viewport content="width=device-width,initial-scale=1"><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-regular.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-500.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-700.woff2 type=font/woff2 crossorigin><script src=https://wldt.github.io/js/color-mode.86a91f050a481d0a3f0c72ac26543cb6228c770875981c58dcbc008fd3f875c8.js integrity="sha256-hqkfBQpIHQo/DHKsJlQ8tiKMdwh1mBxY3LwAj9P4dcg="></script>
-<link rel=stylesheet href=https://wldt.github.io/main.5d6e5440c13f1c45183e82bbb906165564d1edfd71498c4a2c38775086796022bfab9cfb137199a537d8e42c2fb6ce2ab74b69461aed15b7389bd0e12ec63b19.css integrity="sha512-XW5UQME/HEUYPoK7uQYWVWTR7f1xSYxKLDh3UIZ5YCK/q5z7E3GZpTfY5Cwvts4qt0tpRhrtFbc4m9DhLsY7GQ==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>WLDT</title><meta property="canonical" content="https://wldt.github.io/"><meta name=description content="What is a digital Twin? A Digital Twin (DT) is a comprehensive software representation of any individual Physical Asset (PA) in the real world."><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/"><meta property="og:title" content="White Label Digital Twins"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:description" content="What is a digital Twin? A Digital Twin (DT) is a comprehensive software representation of any individual Physical Asset (PA) in the real world."><meta property="og:see_also" content="https://wldt.github.io/privacy/"><meta name=twitter:card content="summary"><meta name=twitter:title content="White Label Digital Twins"><meta name=twitter:description content="What is a digital Twin? A Digital Twin (DT) is a comprehensive software representation of any individual Physical Asset (PA) in the real world."><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","name":"White Label Digital Twins","position":1}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="single home" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
+<link rel=stylesheet href=https://wldt.github.io/main.5fb433a44687c98f7ae7b3d0137c762777049ba27235e1f08c279c03c8533a7a9a1e3b0ef5b125a31b6bb63a362cdcbc39c3706ed41ad7f1a620b9281013866c.css integrity="sha512-X7QzpEaHyY9657PQE3x2J3cEm6JyNeHwjCecA8hTOnqaHjsO9bEloxtrtjo2LNy8OcNwbtQa1/GmILkoEBOGbA==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>WLDT</title><meta property="canonical" content="https://wldt.github.io/"><meta name=description content="What is a digital Twin? A Digital Twin (DT) is a comprehensive software representation of any individual Physical Asset (PA) in the real world."><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/"><meta property="og:title" content="White Label Digital Twins"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:description" content="What is a digital Twin? A Digital Twin (DT) is a comprehensive software representation of any individual Physical Asset (PA) in the real world."><meta property="og:see_also" content="https://wldt.github.io/privacy/"><meta name=twitter:card content="summary"><meta name=twitter:title content="White Label Digital Twins"><meta name=twitter:description content="What is a digital Twin? A Digital Twin (DT) is a comprehensive software representation of any individual Physical Asset (PA) in the real world."><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","name":"White Label Digital Twins","position":1}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="single home" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
 <button type=button id=searchToggleMobile class="btn btn-link nav-link mx-2 d-lg-none" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
 <button class="btn btn-link nav-link mx-2 order-3 d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavMain aria-controls=offcanvasNavMain aria-label="Open main navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-menu" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><line x1="4" y1="8" x2="20" y2="8"/><line x1="4" y1="16" x2="20" y2="16"/></svg></button><div class="offcanvas offcanvas-end h-auto" tabindex=-1 id=offcanvasNavMain aria-labelledby=offcanvasNavMainLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavMainLabel>WLDT</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class="offcanvas-body d-flex flex-column flex-lg-row justify-content-between"><ul class="navbar-nav flex-grow-1"><li class=nav-item><a class=nav-link href=https://wldt.github.io/docs/guides/example-guide/>Documentation</a></li><li class=nav-item><a class=nav-link href=https://wldt.github.io/blog/>Blog</a></li></ul><button type=button id=searchToggleDesktop class="btn btn-link nav-link p-2 d-none d-lg-block" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
 <button id=buttonColorMode class="btn btn-link mx-auto nav-link p-0 ms-lg-2 me-lg-1" type=button aria-label="Toggle theme"><svg data-bs-theme-value="dark" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-moon" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 3c.132.0.263.0.393.0a7.5 7.5.0 007.92 12.446A9 9 0 1112 2.992z"/></svg><svg data-bs-theme-value="light" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-sun" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-4 0a4 4 0 108 0 4 4 0 10-8 0m-5 0h1m8-9v1m8 8h1m-9 8v1M5.6 5.6l.7.7m12.1-.7-.7.7m0 11.4.7.7m-12.1-.7-.7.7"/></svg></button><ul id=socialMenu class="nav mx-auto flex-row order-lg-4"><li class=nav-item><a class="nav-link social-link" href=https://github.com/wldt><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-brand-github" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 19c-4.3 1.4-4.3-2.5-6-3m12 5v-3.5c0-1 .1-1.4-.5-2 2.8-.3 5.5-1.4 5.5-6a4.6 4.6.0 00-1.3-3.2 4.2 4.2.0 00-.1-3.2s-1.1-.3-3.5 1.3a12.3 12.3.0 00-6.2.0C6.5 2.8 5.4 3.1 5.4 3.1a4.2 4.2.0 00-.1 3.2A4.6 4.6.0 004 9.5c0 4.6 2.7 5.7 5.5 6-.6.6-.6 1.2-.5 2V21"/></svg><small class="ms-2 visually-hidden">GitHub</small></a></li></ul></div></div></div></header></div><div class=modal id=searchModal tabindex=-1 aria-labelledby=searchModalLabel aria-hidden=true><div class="modal-dialog modal-dialog-scrollable modal-fullscreen-md-down"><div class=modal-content><div class=modal-header><h1 class="modal-title fs-5 visually-hidden" id=searchModalLabel>Search</h1><button type=button class="btn-close visually-hidden" data-bs-dismiss=modal aria-label=Close></button><div class="search-input flex-grow-1 d-none"><form id=search-form class=search-form action=# method=post accept-charset=utf-8 role=search><label for=query class=visually-hidden>Search</label><div class=d-flex><input type=search id=query name=query class="search-text form-control form-control-lg" placeholder=Search aria-label=Search maxlength=128 autocomplete=off>
-<button type=button class="btn btn-link text-decoration-none px-0 ms-3 d-md-none" data-bs-dismiss=modal aria-label=Close>Cancel</button></div></form></div></div><div class=modal-body><p class="search-loading status message d-none mt-3 text-center">Loading search index…</p><p class="search-no-recent message d-none mt-3 text-center">No recent searches</p><p class="search-no-results message d-none mt-3 text-center">No results for "<strong><span class=query-no-results>Query here</span></strong>"</p><div id=searchResults class=search-results></div><template><article class="search-result list-view"><div class="card my-3"><div class=card-body><header><h2 class="h5 title title-submitted mb-0"><a class="stretched-link text-decoration-none text-reset" href=#>Title here</a></h2><div class="submitted d-none"><time class=created-date>Date here</time></div></header><div class=content>Summary here</div></div></div></article></template></div><div class=modal-footer><ul class="list-inline me-auto d-none d-md-block"><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Enter key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M12 3.53088v3c0 1-1 2-2 2H4m3 3-3-3 3-3"/></g></svg></kbd><span class=DocSearch-Label>to select</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Arrow down" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 3.5v8m3-3-3 3-3-3"/></g></svg></kbd><kbd class=me-2><svg width="15" height="15" aria-label="Arrow up" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 11.5v-8m3 3-3-3-3 3"/></g></svg></kbd><span class=DocSearch-Label>to navigate</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Escape key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M13.6167 8.936c-.1065.3583-.6883.962-1.4875.962-.7993.0-1.653-.9165-1.653-2.1258v-.5678c0-1.2548.7896-2.1016 1.653-2.1016s1.3601.4778 1.4875 1.0724M9 6c-.1352-.4735-.7506-.9219-1.46-.8972-.7092.0246-1.344.57-1.344 1.2166s.4198.8812 1.3445.9805C8.465 7.3992 8.968 7.9337 9 8.5s-.454 1.398-1.4595 1.398C6.6593 9.898 6 9 5.963 8.4851m-1.4748.5368c-.2635.5941-.8099.876-1.5443.876s-1.7073-.6248-1.7073-2.204v-.4603c0-1.0416.721-2.131 1.7073-2.131.9864.0 1.6425 1.031 1.5443 2.2492h-2.956"/></g></svg></kbd><span class=DocSearch-Label>to close</span></li></ul><p class=d-md-none>Search by <a class=text-decoration-none href=https://github.com/nextapps-de/flexsearch>FlexSearch</a></p></div></div></div></div><div class="wrap container-lg" role=document><div class=content><section class="section container-fluid mt-n3 pb-3"><div class="row justify-content-center"><div class="col-lg-12 text-center"><h1>White Label Digital Twins</h1></div><div class="col-lg-9 col-xl-8 text-center"><p class=lead>A Java library to easily create Digital Twins for all your Internet of Things Projects</p><p class=lead>Open-source on <a href=https://github.com/wldt>GitHub</a></p></div></div></section></div></div><section class="section section-md section-features"><div class=container><div class="row justify-content-center text-center"><p><div class=img-wrapper><picture><source data-srcset="https://wldt.github.io/logo_hu30be7725a70675d228614e3bb6524ba2_120563_480x0_resize_q75_h2_box_3.webp 480w, https://wldt.github.io/logo_hu30be7725a70675d228614e3bb6524ba2_120563_640x0_resize_q75_h2_box_3.webp 640w, https://wldt.github.io/logo_hu30be7725a70675d228614e3bb6524ba2_120563_768x0_resize_q75_h2_box_3.webp 768w, https://wldt.github.io/logo_hu30be7725a70675d228614e3bb6524ba2_120563_1024x0_resize_q75_h2_box_3.webp 1024w, https://wldt.github.io/logo_hu30be7725a70675d228614e3bb6524ba2_120563_1061x0_resize_q75_h2_box_3.webp 1061w" type=image/webp><source data-srcset="https://wldt.github.io/logo_hu30be7725a70675d228614e3bb6524ba2_120563_480x0_resize_box_3.png 480w, https://wldt.github.io/logo_hu30be7725a70675d228614e3bb6524ba2_120563_640x0_resize_box_3.png 640w, https://wldt.github.io/logo_hu30be7725a70675d228614e3bb6524ba2_120563_768x0_resize_box_3.png 768w, https://wldt.github.io/logo_hu30be7725a70675d228614e3bb6524ba2_120563_1024x0_resize_box_3.png 1024w, https://wldt.github.io/logo_hu30be7725a70675d228614e3bb6524ba2_120563_1061x0_resize_box_3.png 1061w" type=image/png><img data-src=https://wldt.github.io/logo_hu30be7725a70675d228614e3bb6524ba2_120563_1061x0_resize_box_3.png height=1060 width=1061 class="img-fluid blur-up lazyload" data-sizes=auto alt="WLDT Library Logo"></picture></div></p><h3 id=what-is-a-digital-twin>What is a digital Twin?</h3><p>A <strong>Digital Twin</strong> (DT) is a comprehensive software representation of any individual <strong>Physical Asset</strong> (PA) in the real world.<br>It includes the properties, conditions, relationships, and behavior(s) of the real-life object through models and data.<br>A Digital Twin is a set of realistic models that can digitalize an object’s behavior in the deployed environment and has the responsibility to represent and reflect its physical counterpart over time maintaining its digital replica across the object’s entire lifecycle.</p><h3 id=what-can-wldt-do-for-me>What can WLDT do for me?</h3><p>The White Label Digital Twin (WLDT) library aims to support the design, development, and deployment of Digital Twins within the Internet of Things (IoT) ecosystems.<br>The library has been designed following the latest DT definitions coming from both Industrial and Scientific domains and identifying DTs as active, flexible and scalable software components.</p></div></div></section><section class="section section-md container-fluid bg-light"><div class="row justify-content-center text-center"><div class=col-lg-7><h2 class=mt-2>Start building with WLDT today</h2><a class="btn btn-primary rounded-pill px-4 my-2" href=https://wldt.github.io/docs/prologue/introduction/ role=button>Get Started</a></div></div></section><footer class="footer text-muted"><div class=container-lg><div class=row><div class="col-lg-8 text-center text-lg-start"><ul class=list-inline><li class=list-inline-item><a class=text-muted href=https://wldt.github.io/privacy/>Privacy Policy</a></li></ul></div><div class="col-lg-8 text-center text-lg-end"><ul class=list-inline><li class=list-inline-item>Brought to you by <a class=text-muted href=https://gethyas.com/>Hyas</a></li></ul></div></div></div></footer><script async src=https://wldt.github.io/js/app.1e84dcdaa5ccef6fe83f6d88ac1e444a1f237111cfa2a7a97427f758e9c27ef4.js integrity="sha256-HoTc2qXM72/oP22IrB5ESh8jcRHPoqepdCf3WOnCfvQ="></script>
+<button type=button class="btn btn-link text-decoration-none px-0 ms-3 d-md-none" data-bs-dismiss=modal aria-label=Close>Cancel</button></div></form></div></div><div class=modal-body><p class="search-loading status message d-none mt-3 text-center">Loading search index…</p><p class="search-no-recent message d-none mt-3 text-center">No recent searches</p><p class="search-no-results message d-none mt-3 text-center">No results for "<strong><span class=query-no-results>Query here</span></strong>"</p><div id=searchResults class=search-results></div><template><article class="search-result list-view"><div class="card my-3"><div class=card-body><header><h2 class="h5 title title-submitted mb-0"><a class="stretched-link text-decoration-none text-reset" href=#>Title here</a></h2><div class="submitted d-none"><time class=created-date>Date here</time></div></header><div class=content>Summary here</div></div></div></article></template></div><div class=modal-footer><ul class="list-inline me-auto d-none d-md-block"><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Enter key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M12 3.53088v3c0 1-1 2-2 2H4m3 3-3-3 3-3"/></g></svg></kbd><span class=DocSearch-Label>to select</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Arrow down" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 3.5v8m3-3-3 3-3-3"/></g></svg></kbd><kbd class=me-2><svg width="15" height="15" aria-label="Arrow up" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 11.5v-8m3 3-3-3-3 3"/></g></svg></kbd><span class=DocSearch-Label>to navigate</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Escape key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M13.6167 8.936c-.1065.3583-.6883.962-1.4875.962-.7993.0-1.653-.9165-1.653-2.1258v-.5678c0-1.2548.7896-2.1016 1.653-2.1016s1.3601.4778 1.4875 1.0724M9 6c-.1352-.4735-.7506-.9219-1.46-.8972-.7092.0246-1.344.57-1.344 1.2166s.4198.8812 1.3445.9805C8.465 7.3992 8.968 7.9337 9 8.5s-.454 1.398-1.4595 1.398C6.6593 9.898 6 9 5.963 8.4851m-1.4748.5368c-.2635.5941-.8099.876-1.5443.876s-1.7073-.6248-1.7073-2.204v-.4603c0-1.0416.721-2.131 1.7073-2.131.9864.0 1.6425 1.031 1.5443 2.2492h-2.956"/></g></svg></kbd><span class=DocSearch-Label>to close</span></li></ul><p class=d-md-none>Search by <a class=text-decoration-none href=https://github.com/nextapps-de/flexsearch>FlexSearch</a></p></div></div></div></div><div class="wrap container-lg" role=document><div class=content><section class="section container-fluid mt-n3 pb-3"><div class="row justify-content-center"><div class="col-lg-12 text-center"><h1>White Label Digital Twins</h1></div><div class="col-lg-9 col-xl-8 text-center"><p class=lead>A Java library to easily create Digital Twins for all your Internet of Things Projects</p><p class=lead>Open-source on <a href=https://github.com/wldt>GitHub</a></p></div></div></section></div></div><section class="section section-md section-features"><div class=container><div class="row justify-content-center text-center"><h3 id=what-is-a-digital-twin>What is a digital Twin?</h3><p>A <strong>Digital Twin</strong> (DT) is a comprehensive software representation of any individual <strong>Physical Asset</strong> (PA) in the real world.<br>It includes the properties, conditions, relationships, and behavior(s) of the real-life object through models and data.<br>A Digital Twin is a set of realistic models that can digitalize an object’s behavior in the deployed environment and has the responsibility to represent and reflect its physical counterpart over time maintaining its digital replica across the object’s entire lifecycle.</p><h3 id=what-can-wldt-do-for-me>What can WLDT do for me?</h3><p>The White Label Digital Twin (WLDT) library aims to support the design, development, and deployment of Digital Twins within the Internet of Things (IoT) ecosystems.<br>The library has been designed following the latest DT definitions coming from both Industrial and Scientific domains and identifying DTs as active, flexible and scalable software components.</p></div></div></section><section class="section section-md container-fluid bg-light"><div class="row justify-content-center text-center"><div class=col-lg-7><h2 class=mt-2>Start building with WLDT today</h2><a class="btn btn-primary rounded-pill px-4 my-2" href=https://wldt.github.io/docs/prologue/introduction/ role=button>Get Started</a></div></div></section><footer class="footer text-muted"><div class=container-lg><div class=row><div class="col-lg-8 text-center text-lg-start"><ul class=list-inline><li class=list-inline-item><a class=text-muted href=https://wldt.github.io/privacy/>Privacy Policy</a></li></ul></div><div class="col-lg-8 text-center text-lg-end"><ul class=list-inline><li class=list-inline-item>Brought to you by <a class=text-muted href=https://gethyas.com/>Hyas</a></li></ul></div></div></div></footer><script async src=https://wldt.github.io/js/app.1e84dcdaa5ccef6fe83f6d88ac1e444a1f237111cfa2a7a97427f758e9c27ef4.js integrity="sha256-HoTc2qXM72/oP22IrB5ESh8jcRHPoqepdCf3WOnCfvQ="></script>
 <script async src=https://wldt.github.io/js/flexsearch.dc00caef2c3490dbab3c345ed0d4133b0aafb803efeb21c3df80776d6d3ea821.js integrity="sha256-3ADK7yw0kNurPDRe0NQTOwqvuAPv6yHD34B3bW0+qCE="></script><script async src=https://wldt.github.io/js/search-modal.c4c023efcdee308e4b5f1110afe1db6b1656f217e67aa7efe54e2f4bf2feccf8.js integrity="sha256-xMAj783uMI5LXxEQr+HbaxZW8hfmeqfv5U4vS/L+zPg="></script><div class="d-inline-flex fixed-bottom-right pb-4 pe-4"><button id=toTop type=button class="btn btn-primary rounded-circle ms-auto p-2"><span class=visually-hidden>Top</span><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-chevron-up" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M6 15l6-6 6 6"/></svg></button></div></body></html>
\ No newline at end of file
diff --git a/index.xml b/index.xml
index 0b74ff4..f62d1c1 100644
--- a/index.xml
+++ b/index.xml
@@ -1 +1,2 @@
-<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>White Label Digital Twins on WLDT</title><link>https://wldt.github.io/</link><description>Recent content in White Label Digital Twins on WLDT</description><generator>Hugo -- gohugo.io</generator><language>en</language><copyright>Copyright (c) 2023 Hyas</copyright><lastBuildDate>Fri, 06 Oct 2023 08:47:36 +0000</lastBuildDate><atom:link href="https://wldt.github.io/index.xml" rel="self" type="application/rss+xml"/><item><title>Example Post</title><link>https://wldt.github.io/blog/example-post/</link><pubDate>Thu, 07 Sep 2023 16:27:22 +0200</pubDate><guid>https://wldt.github.io/blog/example-post/</guid><description/></item><item><title>Example Guide</title><link>https://wldt.github.io/docs/guides/example-guide/</link><pubDate>Thu, 07 Sep 2023 16:04:48 +0200</pubDate><guid>https://wldt.github.io/docs/guides/example-guide/</guid><description>Guides lead a user through a specific task they want to accomplish, often with a sequence of steps. Writing a good guide requires thinking about what your users are trying to do.</description></item><item><title>Example Reference</title><link>https://wldt.github.io/docs/reference/example-reference/</link><pubDate>Thu, 07 Sep 2023 16:13:18 +0200</pubDate><guid>https://wldt.github.io/docs/reference/example-reference/</guid><description>Reference pages are ideal for outlining how things work in terse and clear terms. Less concerned with telling a story or addressing a specific use case, they should give a comprehensive outline of what your documenting.</description></item><item><title>Privacy Policy</title><link>https://wldt.github.io/privacy/</link><pubDate>Thu, 07 Sep 2023 17:19:07 +0200</pubDate><guid>https://wldt.github.io/privacy/</guid><description/></item></channel></rss>
\ No newline at end of file
+<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>White Label Digital Twins on WLDT</title><link>https://wldt.github.io/</link><description>Recent content in White Label Digital Twins on WLDT</description><generator>Hugo -- gohugo.io</generator><language>en</language><copyright>Copyright (c) 2023 Hyas</copyright><lastBuildDate>Fri, 06 Oct 2023 08:47:36 +0000</lastBuildDate><atom:link href="https://wldt.github.io/index.xml" rel="self" type="application/rss+xml"/><item><title>Example Post</title><link>https://wldt.github.io/blog/example-post/</link><pubDate>Thu, 07 Sep 2023 16:27:22 +0200</pubDate><guid>https://wldt.github.io/blog/example-post/</guid><description/></item><item><title>Physical Adapter</title><link>https://wldt.github.io/docs/guides/physical-adapter/</link><pubDate>Fri, 09 Feb 2024 12:09:02 +0100</pubDate><guid>https://wldt.github.io/docs/guides/physical-adapter/</guid><description>The developer can use an existing Physical Adapter or create a new one to handle the communication with a specific physical twin.</description></item><item><title>Shadowing Function</title><link>https://wldt.github.io/docs/guides/shadowing-function/</link><pubDate>Fri, 09 Feb 2024 12:15:33 +0100</pubDate><guid>https://wldt.github.io/docs/guides/shadowing-function/</guid><description>After the definition of the Physical Adapter it is time to start implementing the core of our DT through the definition of its shadowing function in charge of:</description></item><item><title>Digital Adapter</title><link>https://wldt.github.io/docs/guides/digital-adapter/</link><pubDate>Fri, 09 Feb 2024 12:16:06 +0100</pubDate><guid>https://wldt.github.io/docs/guides/digital-adapter/</guid><description>The las component that we have to implement to complete our first simple Digital Twin definition through the WLDT library is a Digital Adapter in charge of:</description></item><item><title>DT Engine &amp; DT Instance</title><link>https://wldt.github.io/docs/guides/dt-engine-dt-instance/</link><pubDate>Fri, 09 Feb 2024 12:16:36 +0100</pubDate><guid>https://wldt.github.io/docs/guides/dt-engine-dt-instance/</guid><description>Now that we have created the main fundamental element of a DT (Physical Adapter, Shadowing Function and Digital Adapter) we can create Class file with a main to create the WLDT Engine with the created components and start the DT.</description></item><item><title>Digital Actions</title><link>https://wldt.github.io/docs/guides/digital-actions/</link><pubDate>Fri, 09 Feb 2024 12:18:13 +0100</pubDate><guid>https://wldt.github.io/docs/guides/digital-actions/</guid><description>In this demo implementation, we are going to emulate an incoming Digital Action on the Digital Adapter in order to show how it can be handled by the adapter and properly forwarded to the Shadowing Function for validation and the consequent interaction with the Physical Adapter and then with the physical twin.</description></item><item><title>Configurable Adapters</title><link>https://wldt.github.io/docs/guides/configurable-adapters/</link><pubDate>Fri, 09 Feb 2024 12:19:37 +0100</pubDate><guid>https://wldt.github.io/docs/guides/configurable-adapters/</guid><description>The WLDT library provides a native method to define Configurable Physical ad Digital Adapters specifying a custom configuration class passed as parameter in the constructor.</description></item><item><title>MQTT Physical Adapter</title><link>https://wldt.github.io/docs/adapters/mqtt-physical-adapter/</link><pubDate>Fri, 09 Feb 2024 12:55:52 +0100</pubDate><guid>https://wldt.github.io/docs/adapters/mqtt-physical-adapter/</guid><description>The MqttPhysicalAdapter library provides a streamlined solution for efficiently managing physical assets through the MQTT protocol. It offers a range of features, including a versatile builder for effortless configuration of MQTT connections, dedicated classes for handling both incoming and outgoing topics, and a specialized adapter designed for seamless integration with diverse physical assets.</description></item><item><title>MQTT Digital Adapter</title><link>https://wldt.github.io/docs/adapters/mqtt-digital-adapter/</link><pubDate>Fri, 09 Feb 2024 12:58:14 +0100</pubDate><guid>https://wldt.github.io/docs/adapters/mqtt-digital-adapter/</guid><description>The MqttDigitalAdapter,
+MqttDigitalAdapterConfiguration, and MqttDigitalAdapterConfigurationBuilder classes and guides you through using these classes to set up an MQTT Digital Adapter within WLDT.</description></item><item><title>Change Log 0.3.0</title><link>https://wldt.github.io/docs/change-logs/change-log-0.3.0/</link><pubDate>Fri, 09 Feb 2024 12:23:33 +0100</pubDate><guid>https://wldt.github.io/docs/change-logs/change-log-0.3.0/</guid><description>Digital Adapters The following methods have been discontinued and removed from the DigitalAdapter class: onStateChangePropertyCreated onStateChangePropertyUpdated onStateChangePropertyDeleted onStatePropertyUpdated onStatePropertyDeleted onStateChangeActionEnabled onStateChangeActionUpdated onStateChangeActionDisabled onStateChangeEventRegistered onStateChangeEventRegistrationUpdated onStateChangeEventUnregistered onStateChangeRelationshipInstanceDeleted onStateChangeRelationshipDeleted onStateChangeRelationshipInstanceCreated onStateChangeRelationshipCreated onDigitalTwinStateEventNotificationReceived The Signature of the following methods have been changed: onDigitalTwinSync(IDigitalTwinState currentDigitalTwinState) -&amp;gt; onDigitalTwinSync(DigitalTwinState currentDigitalTwinState) onDigitalTwinUnSync(IDigitalTwinState currentDigitalTwinState) -&amp;gt; onDigitalTwinUnSync(DigitalTwinState currentDigitalTwinState) New methods that have been added are: onStateUpdate(DigitalTwinState newDigitalTwinState, DigitalTwinState previousDigitalTwinState, ArrayList&amp;lt;DigitalTwinStateChange&amp;gt; digitalTwinStateChangeList) onEventNotificationReceived(DigitalTwinStateEventNotification&amp;lt;?</description></item></channel></rss>
\ No newline at end of file
diff --git a/logo.png b/logo.png
index 3bac7c39fd15918f990b0728037c29c4330919b7..f511c0c312bbdd2197b5bf0fe1a2bdefc8c04e10 100644
GIT binary patch
delta 51431
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%0Dnswd{?DTx8~u2FuFq+nXrdYkJUm(
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

literal 120563
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

diff --git a/logo_hu30be7725a70675d228614e3bb6524ba2_120563_1024x0_resize_box_3.png b/logo_hu30be7725a70675d228614e3bb6524ba2_120563_1024x0_resize_box_3.png
deleted file mode 100644
index e769a8c910c32a0c8a9028fd8380919e2050b82d..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 92114
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
EA2<qzssI20

diff --git a/logo_hu30be7725a70675d228614e3bb6524ba2_120563_1024x0_resize_q75_h2_box_3.webp b/logo_hu30be7725a70675d228614e3bb6524ba2_120563_1024x0_resize_q75_h2_box_3.webp
deleted file mode 100644
index 98c6c938d3691a08514a0b9dd38bceef1c398f09..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 34900
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

diff --git a/logo_hu30be7725a70675d228614e3bb6524ba2_120563_1061x0_resize_box_3.png b/logo_hu30be7725a70675d228614e3bb6524ba2_120563_1061x0_resize_box_3.png
deleted file mode 100644
index a2f38343cd582be27cd4667f837cf3eaad74a819..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 95399
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
S8%?CEG9Ks{L2K_hM*knGCF%$O

diff --git a/logo_hu30be7725a70675d228614e3bb6524ba2_120563_1061x0_resize_q75_h2_box_3.webp b/logo_hu30be7725a70675d228614e3bb6524ba2_120563_1061x0_resize_q75_h2_box_3.webp
deleted file mode 100644
index 3d39c45e1b70d387c2297e9dfcd879a0ce598a8f..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 36950
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

diff --git a/logo_hu30be7725a70675d228614e3bb6524ba2_120563_480x0_resize_box_3.png b/logo_hu30be7725a70675d228614e3bb6524ba2_120563_480x0_resize_box_3.png
deleted file mode 100644
index d5e6a0a6a159c78c67254315a14348f445c98e0e..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 40103
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%0D1i^zJ!6ba
zA@}Y=YZX^r&kB_>`~{y>p}|z|$tr)AVd+1uhUN7KhQ+s^P0`GCZ-eK8Y*+&gnVpUv
z);LbeCX_T}#*Z9JiI*%S=}^2ekNjCNl{Dx+QF|SFS{}Gf@3YoYd)i9TmGvZS(mP;#
zCFyDQbTf_7(A`%|&b04bPor}OQ4WxEobj9A?<0r&PTzm&<ghy%R|T~z{vS&h!+_~J
zeWrqL&Llvv{qy5d(OMx<+2{}re!f1lB-*cuHV=QIli7MzX{E&!dskZqf<3#o6)2wh
zyl2|qr#{Gs3g<Uu!WQ3&T5Gg~-W;Pr0_6})W~iVK;{*ea#e=hRZx`E|fbSJ%cG?9I
zrwePA>R)E|)z}`jk|1&|JAIs}>fC8WVd+Q=DnkKw*<(PHJ<y*lb9UqQ?5rhhnjY5b
zU?=t;==h!+eUGeBW;nLmTAusNWxgQuA7W)7IB7l6-&&c}&^bHW2Wu}!XraR{z$Hde
z9&jxI+>`Pc6#*@OZ+Nwf?N>!grsy}}nelZ#<-gMhP5cAxU>|XMqbG;c+wM+pBy};W
z`3L7~k@MTzT;6nE>qq_9*_u<wZjn00M^Odydi{UeO&V>@&@Qj1Y!4el!Jm(tsI+@p
z9Hs6BZ_qgPzvj80_VtevA_g3FP|UX~QBS`s%C2!7L@kDeMz;6w7ujd&SzL!rru|b(
z=ZzgwGr4uUy|QxE1y3GzL*3<2^yHf()n}&h$2)cj=v~LTf6iZ87b+)A6RXbe<IRZ)
zmdqAOpy=FU=bRfTZxZmP<MwwLiMSq2;C}7-$Rqh^wps?@Y_jQBFt5yd%k2dPkz?g-
z*^_{korymb;go7^W$b+Sc@6F{?h#UqhQTlK+g{o6Zm3XW|GGT{FynIKL}#tTv(^U>
z2wJR9woHo{Tj_|ga9~ur!Q_JbQKnl(pB!+2#~f7gG<={FYIr%~gS1ZyVXH)7TZDxx
z-wjtpHq4i^m<hf3v!ZDVKck-(+X??w{!vDnB))XquEt=i7=02|&~i!(QWUCuV&LiX
zM^4%bu5JElt}9ZesI=F#|ADhCEIsssuFVc|6wA^GoZOXuqkEB!3JdJCy#G=czKjhO
z8ghR6sVl$wo;0k}%%KBQqB_vmxfXJQX~!iY`5q81AYe-~1ujR2K_CIuw!DZl`YZe7
z{gQaVr!RzPmhxXtR=Ec$>3oq!GLVp#b#f?L$7V~%z)cP5IPc)uKU_oB74CdL0Aj6~
zwzRi2QIekIem^NzxyZH<pGK}fPm1euXeH(emR&RGch)c-TMLDk@4kv#YJqA?jS4hL
zG@ZSYQ%7x*)@_keDexmyTZU7%DJ8rsBcRCn{T$I(UGM^8gwrBcOtSdx<wwMQ-!Tf6
z(e*u5scxiI49g>Ljc`ER&(D39HGWV=JU}j6Nu$6IYgLT}24bsWvy!Qg#rLd!LXSg5
zIomAvVMwOKxNVh7gcd4nsa_f4aIa24^433RG@lC@qRy*-<>p(;MORRCcO0GEEfs{}
zWi8)BJ)vcE?Kw+Gc$33i!O+_nxM!LXhfm?kC_yH_K1o8vD$8{fC~!IMq_0g(n9s_S
zvb`HVkp4UC%LrO$5g==`kQlBS0s!OFf%v%bFuykE!p@$eqo&)_*OGA`$=Y5eQ*}eb
z{Jh#2w2o=6pPodLBF$sqyt-9LV9GEwzuMA^#&}4#eWz=u4tUvHme=EZ=VlOQGlyWS
z3-AvN10feUf7QvXxvLXai(l{U=87v10PX$!M`tQ$pJ@#PVqoqzs#SlD&WZ(Kqk*k5
zlq%C?<c}LGn;eO)9K7l129Q1^^JyRC%G7>->x!yc`&Ij4>b1M7s$T8uYr>{SR;50z
zDMmZaIfRBJbY}WQ#D=gy&1pO?3yBo(D+{;&TKwz(Zl_apBV{0|PBA4T>z%Rq#b<ue
zBk6XkX_RC6!|VI2$5xA<*d0p5M<<NBs%$}xy}Dv{tv4IGocGI)WHRhDK7BOg;JaEd
zgWdK%xKY~<>oVIEPiphIo}%mD=1`OCJIRFhC#+I_Otn9HNVY{%zJ%b8AY6GUBfm&_
zD7^L3IQDc>Yhhc4Xx<DOsq>$VWq2sf$-98pzr%d04G^bizv2?nJ>hU}XArlD69J%r
zz^0KJkrO1I72KZ5?-e<3DUptc)i8_Kh%eReO2(ncgFCtF{+TDIw2r!Oa`+iEyy9TX
zvjm+h+`88b&5Wt_$~4Hbj3HbbX=r_S+{cd$M0X7FLJgpQa|@c=kke|Ak<T)-70w#!
zfh$NjRioN#dmw((#91B8x`TLiGfvw?9f^zuEv6+No^S%2M~`F|r4OA=l)+Z~%FyN2
z4_-PqMx`%FN)Hxs$p*Y60S@@(O9<({s~@(z=qYLHSAIrd2QQUTUL(!~UemG>hvU2m
zoM*;sT$G|VUYUZi^xv9zZ}Hs=x^~LAB^5lM@k#ncP}9I)8oB^*S;AqgdeWX7J<cmG
zKykez%ONb(kPXIL7pB55+v!X`jTGUu7fYqUf?f)#Xxal=Skn*W^fja!9@GT<tEXo{
zxbd1RCN{knFM(paj-?Z}$??<h8Jb<>m<K0<prw90e@TLw=7rK!GagwB!3K6ETzz^k
z;pQ%|n1Jd>vH?hv%a5ZeJn{<D1UR~~&H_sSjS{fDQ8D&vsVP{$w+9>EY|#xLXj-`B
z#gt?bs4JCr`LF+k&lT07+CBSN%8h33;>fo#6j)yZA^Nc-9#sX?)VDsZ=FFj1I+d2}
z!eMFuh8}PQ5Ng5-{v_xza#>h@5BmLEf4;sPyx!r-s|926%RQx5XP+}n%i>_Q!sAwj
zJcr@6!*L|5+Gn#Q1H=Cu*oZ)6*|(r%I!2G7uT<0q%DdQ(;^f><;?G=t-Y?akK&vH!
z(wBlYOFu5o6kJ$sWijs^Wfy<S+Zfz9lmu1=Ab5(B4tVjo(JTUtbW;)e3>#e2wAuZj
z+(?`7EHU`WSNiz#Uv>1W7mSkXt8Jc@$B%}GTH)L>awJ-^ZgT!jd{i{Jyx{}MfQL}F
zNErL_UjCPz-5b9xqAX%c7i-eCF^#L*ROFVlU~TX9tv;Rc(U}o-6GH7Qw;#rCjC`lL
zYFLbgUkz4@zYbBA4#Tci29DVaUhG1i+kdszE2VxV+LbIiucfzF<72@wv&6NML!i!|
zx6<P>iSqRo!mrPUe0DB<Uey3IqaPyPl{<(s+<8aoooHYfTAHw0>DCQLnzXs)iFA$P
zIkkvNiVXQuQF|juQ^yy42ZGcKc%aUAh&}i=jYcm0_r6!m`XH59JnW}_e`TY#ESL_p
z6r6K26vXNbh=|cq{@e%gCkl0Z)~imF*-_8wz=G;*I0{bBc$-w*EpQ=A=TJMxZQmP&
zk@^}NOMj31hbld3Jemvc`FY!GG+Ql-qVrIK{I?Qp%h<MhxL&Q$8lmVZSR>%IciV(N
z4M&!E^$U6gR(I%X<8i;U8@iBzm4Awr!k<1!4@EHq2l?Xe`gNPPoJ*Q94-t=)oJqm7
z6`ZZeB!gar16@?b=D788N;8@_4E`W<eZoNxaI)+J=<zUWk%aW?LYED<^b-ciEMDZ!
zicFo2xcTAMB5X(Fa+%{K*Ow!jo)xXCQm_hAbO=#eX6@Mb22@P%Ict;HfL!p-@W!<&
zS>}^QYN}oxJnmb=|A>8;IF!;iBunU07lgO2#02Q%X75QrTx8EgHb#qgn&dGEs~8|~
z;6DZs>-I&i>qFrcXV{QfSF-DTpehOWF(yTljLTy2HaLdJ7lR?L)4`2bvmh3V*d@l7
zPK#n4z$Z~MKs{R*krHnfDk_dJ)qE9Z+BLrVV?J1piG{6b1AMaue^_Mlg^0@+VyxO9
zy2j)4R#jAkK!Ws&Bl!Y-yP3~WWAP%MGFVH2GRHn#A!g-n@_e5j7f>uj>lF`}YoU#;
zJnynw^+H1LS#?9blE)T|7t7kd6v)!Bv#GTyJpj)pZcVn!dwUuMF`hbah%5bQ0jgc#
zVP-HMx}~9)_SOQ{$!!H<AS#*NduM2bopCm@e9nZ0!=-xLY06?BFoNJAC&cebjf|Dk
zkKMG0578xC4vvIQi&wcZ@+5y_Je5aDj~37{uWi9*5!_fIjygyrZl+`5050kO*T&Z~
zwcno3YU*44hj76YfBiM~k6*;u;uJ_z>(lkM{B`3G{`e8LAsD+oYmYo@9Q75!FbHt9
zvw%z-#W~bemW`(zujIM7x2<so^N_^*&R3{QOGZueC-RRICP!0JAc8l@UdGruCS`{h
zFfj<R)#iG0FMdh$3>x{_-Fl=Qw`4{rLM`9^rfGJpn*mU2kLR3U54NHnk!_4Xft5S%
zW~wT`K)Lp`{Tgl?frN8^ZKCh%I)p6Vvnqh1*S>l2==iEG=71fj8}vUk2%Ozp$Lng4
z&tCfpU4m4X^z6EZNs0eM<l*<^d|Vi+olGgr?tl2Xj#e_x8Dis;AqMVZUcu2UrCeG^
zSb@z7n@Um$L$OB(w+%>>5!!vO3=tNIu!1}yjBCspt2Erbw%wie%PpRjj0?(aKIy|M
z;;xymGwzf!QtRNecdUhThC<0DxLXK!o7>SQVGCTYwoOOh(ejJo7^3KcEO`+E{LVy8
z3iWJ}jM`x@8#$ZO;~Y4ZNnwH)R!elkUTk<Kdgp4hYIG8JV>4a_7vwPY_k%5#uwvq!
zUwlxy8sRq+yzbk#-t+`!`8H=#gav<_^_rEfj+8KCwyY>`C-%^NaExMzCO2^@ZqyYs
zZF2i)?i}N`Ju2zlwOdtvsia#`M%I#t!ImbNrq;WjS2l9e9SBx6#!TEfkI&qC$12Uv
z&O>mkF=n=BuI}d)FWFUvXOMwF`PPQ*t~Lv-c`wLockNR@eV9|!&FO^_j!VA-VS_-H
z1HEmx*NVzTHz$qe<8nB7cRXJxM+&%iCPdEp+t8Lx{1FW9uN`(@&UKO+*hV}IR)rPY
zljiw)_V~dD&$M2A9d+on9XDFDEF4_VL@=*8TOrJen=^!}B~~wOXpsEM9C!N5-ZclJ
zrd`G);4f@E+#(VzF})X6n;BIvHnGK6nq>j5uMOJRYpZih<izoa_>><0tf+b}gU{~s
zk6B^-TSO0e_qZ!4dRz`|!ynI|$PIMx$)PiFT`edB1C#f2+eL#jUGgrEX14pQ#cg}7
zfBhB1-MIViV1!GKXDTuJs!V<<AEB<9!k4VyfcP3DEQ(ZWE=yz{IDhN;4Yldq+j`BX
z&g)O=&x85<{3CyCjJa%MnU`Ld6Y-t4uKMD$4BZbN{0}1tc5gDiVER6LpIw2QX=o_z
z1ey`8tE97LVBNjmBgenOZ+~}SC-sd2OO$ZW%mwQ2*rH-n4WFXao6Dp|(~^s%?<;B}
zFz%nWzpC$B+x6RCjU}BabF(CV$S~m~>&V1q*gC%)^2RiHyzY>j)lDmUTkoK^-_28K
zI_5~qdse3V!#5n(CG2l`v6dEL4Rz`>KV+2oppoCcN-#lc3?U-)HG8RwmT3$6mF34(
zVentki?_lf8?x%}UvY`doS3FQ5>_1>irAl94lDvu3&rPEyVA;T97Uo=m*<C8DGwNi
zc?E-Gjmq&^)Upe5UvT=-4$*`%;(Gxv%yXleyuYY<1Qi%z-tZ$VJo0C&21RCN=d-TM
zSd|te-NEl0yVxxfPJa!(V>UlkB{S34xgU%UCV!X)$MKQn`VsQx8Y{mN%np42YwJ0(
z(sXrW^?|ozACVD+p=#n5OLEKM<~`C-4?2e!B40G4D$$UzTzcswj2)`|e1z13$nbD1
z@0}vu?F78HiWt57)KQlkueok^kib=)kIq&<iFez1w$yC#>kN`AtA*;z-=Pe`7VpNA
zi6_#pu`AFX^$Yz+RTTA1BXQ{LYyPh=7u<M7CH!L_-gxS^<u38#)wVb%!xA1{vAX1X
p|AC00Sa=tmRgBRl4g!H(UpHt55%lXtk%1qOC(4>iWeOId{{wD{)F=P|

diff --git a/logo_hu30be7725a70675d228614e3bb6524ba2_120563_480x0_resize_q75_h2_box_3.webp b/logo_hu30be7725a70675d228614e3bb6524ba2_120563_480x0_resize_q75_h2_box_3.webp
deleted file mode 100644
index 68f7ddcff6fe5a25fccf25d0e517fd918ae3cb75..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 16524
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
DAQ&vv

diff --git a/logo_hu30be7725a70675d228614e3bb6524ba2_120563_640x0_resize_box_3.png b/logo_hu30be7725a70675d228614e3bb6524ba2_120563_640x0_resize_box_3.png
deleted file mode 100644
index 7eb4563e87a26edcaa2ec2a2d63cdd9e22183fe9..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 55205
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
A$N&HU

diff --git a/logo_hu30be7725a70675d228614e3bb6524ba2_120563_640x0_resize_q75_h2_box_3.webp b/logo_hu30be7725a70675d228614e3bb6524ba2_120563_640x0_resize_q75_h2_box_3.webp
deleted file mode 100644
index 9d32392cdcc61f132a03d9332a86e1c6948aec64..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 21434
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
Z0M*f=fD}`UeCX~NGvijB-tTw2004n?!bboA

diff --git a/logo_hu30be7725a70675d228614e3bb6524ba2_120563_768x0_resize_box_3.png b/logo_hu30be7725a70675d228614e3bb6524ba2_120563_768x0_resize_box_3.png
deleted file mode 100644
index 0f2a73595a344ed2804494aa7b80103353f8d3e1..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 68180
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
Y{n_jv9VDgCK)|20go1eGr!PVO1Mrl)m;e9(

diff --git a/logo_hu30be7725a70675d228614e3bb6524ba2_120563_768x0_resize_q75_h2_box_3.webp b/logo_hu30be7725a70675d228614e3bb6524ba2_120563_768x0_resize_q75_h2_box_3.webp
deleted file mode 100644
index 92ba7bc1f4d885c81526b8b0551cc522a71d45d0..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 26088
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

diff --git a/main.5d6e5440c13f1c45183e82bbb906165564d1edfd71498c4a2c38775086796022bfab9cfb137199a537d8e42c2fb6ce2ab74b69461aed15b7389bd0e12ec63b19.css b/main.5fb433a44687c98f7ae7b3d0137c762777049ba27235e1f08c279c03c8533a7a9a1e3b0ef5b125a31b6bb63a362cdcbc39c3706ed41ad7f1a620b9281013866c.css
similarity index 93%
rename from main.5d6e5440c13f1c45183e82bbb906165564d1edfd71498c4a2c38775086796022bfab9cfb137199a537d8e42c2fb6ce2ab74b69461aed15b7389bd0e12ec63b19.css
rename to main.5fb433a44687c98f7ae7b3d0137c762777049ba27235e1f08c279c03c8533a7a9a1e3b0ef5b125a31b6bb63a362cdcbc39c3706ed41ad7f1a620b9281013866c.css
index 27f8544..06640ce 100644
--- a/main.5d6e5440c13f1c45183e82bbb906165564d1edfd71498c4a2c38775086796022bfab9cfb137199a537d8e42c2fb6ce2ab74b69461aed15b7389bd0e12ec63b19.css
+++ b/main.5fb433a44687c98f7ae7b3d0137c762777049ba27235e1f08c279c03c8533a7a9a1e3b0ef5b125a31b6bb63a362cdcbc39c3706ed41ad7f1a620b9281013866c.css
@@ -1,3 +1,3 @@
 :root,::backdrop{--sl-color-white: hsl(0, 0%, 100%);--sl-color-gray-1: hsl(224, 20%, 94%);--sl-color-gray-2: hsl(224, 6%, 77%);--sl-color-gray-3: hsl(224, 6%, 56%);--sl-color-gray-4: hsl(224, 7%, 36%);--sl-color-gray-5: hsl(224, 10%, 23%);--sl-color-gray-6: hsl(224, 14%, 16%);--sl-color-black: hsl(224, 10%, 10%);--sl-hue-orange: 41;--sl-color-orange-low: hsl(var(--sl-hue-orange), 39%, 22%);--sl-color-orange: hsl(var(--sl-hue-orange), 82%, 63%);--sl-color-orange-high: hsl(var(--sl-hue-orange), 82%, 87%);--sl-hue-green: 101;--sl-color-green-low: hsl(var(--sl-hue-green), 39%, 22%);--sl-color-green: hsl(var(--sl-hue-green), 82%, 63%);--sl-color-green-high: hsl(var(--sl-hue-green), 82%, 80%);--sl-hue-blue: 234;--sl-color-blue-low: hsl(var(--sl-hue-blue), 54%, 20%);--sl-color-blue: hsl(var(--sl-hue-blue), 100%, 60%);--sl-color-blue-high: hsl(var(--sl-hue-blue), 100%, 87%);--sl-hue-purple: 281;--sl-color-purple-low: hsl(var(--sl-hue-purple), 39%, 22%);--sl-color-purple: hsl(var(--sl-hue-purple), 82%, 63%);--sl-color-purple-high: hsl(var(--sl-hue-purple), 82%, 89%);--sl-hue-red: 339;--sl-color-red-low: hsl(var(--sl-hue-red), 39%, 22%);--sl-color-red: hsl(var(--sl-hue-red), 82%, 63%);--sl-color-red-high: hsl(var(--sl-hue-red), 82%, 87%);--sl-color-accent-low: hsl(224, 54%, 20%);--sl-color-accent: hsl(224, 100%, 60%);--sl-color-accent-high: hsl(224, 100%, 85%);--sl-color-text: var(--sl-color-gray-2);--sl-color-text-accent: var(--sl-color-accent-high);--sl-color-text-invert: var(--sl-color-accent-low);--sl-color-bg: var(--sl-color-black);--sl-color-bg-nav: var(--sl-color-gray-6);--sl-color-bg-sidebar: var(--sl-color-gray-6);--sl-color-bg-inline-code: var(--sl-color-gray-5);--sl-color-hairline-light: var(--sl-color-gray-5);--sl-color-hairline: var(--sl-color-gray-6);--sl-color-hairline-shade: var(--sl-color-black);--sl-color-backdrop-overlay: hsla(223, 13%, 10%, .66);--sl-shadow-sm: 0px 1px 1px hsla(0, 0%, 0%, .12), 0px 2px 1px hsla(0, 0%, 0%, .24);--sl-shadow-md: 0px 8px 4px hsla(0, 0%, 0%, .08), 0px 5px 2px hsla(0, 0%, 0%, .08), 0px 3px 2px hsla(0, 0%, 0%, .12), 0px 1px 1px hsla(0, 0%, 0%, .15);--sl-shadow-lg: 0px 25px 7px hsla(0, 0%, 0%, .03), 0px 16px 6px hsla(0, 0%, 0%, .1), 0px 9px 5px hsla(223, 13%, 10%, .33), 0px 4px 4px hsla(0, 0%, 0%, .75), 0px 4px 2px hsla(0, 0%, 0%, .25);--sl-text-xs: .8125rem;--sl-text-sm: .875rem;--sl-text-base: 1rem;--sl-text-lg: 1.125rem;--sl-text-xl: 1.25rem;--sl-text-2xl: 1.5rem;--sl-text-3xl: 1.8125rem;--sl-text-4xl: 2.1875rem;--sl-text-5xl: 2.625rem;--sl-text-6xl: 4rem;--sl-text-body: var(--sl-text-base);--sl-text-body-sm: var(--sl-text-xs);--sl-text-code: var(--sl-text-sm);--sl-text-code-sm: var(--sl-text-xs);--sl-text-h1: var(--sl-text-4xl);--sl-text-h2: var(--sl-text-3xl);--sl-text-h3: var(--sl-text-2xl);--sl-text-h4: var(--sl-text-xl);--sl-text-h5: var(--sl-text-lg);--sl-line-height: 1.8;--sl-line-height-headings: 1.2;--sl-font-system: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";--sl-font-system-mono: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;--__sl-font: var(--sl-font, ""), var(--sl-font-system);--__sl-font-mono: var(--sl-font-mono, ""), var(--sl-font-system-mono);--sl-nav-height: 3.5rem;--sl-nav-pad-x: 1rem;--sl-nav-pad-y: .75rem;--sl-mobile-toc-height: 3rem;--sl-sidebar-width: 18.75rem;--sl-sidebar-pad-x: 1rem;--sl-content-width: 45rem;--sl-content-pad-x: 1rem;--sl-menu-button-size: 2rem;--sl-nav-gap: var(--sl-content-pad-x);--sl-outline-offset-inside: -.1875rem;--sl-z-index-toc: 4;--sl-z-index-menu: 5;--sl-z-index-navbar: 10;--sl-z-index-skiplink: 20
 }:root{--purple-hsl: 255, 60%, 60%;--overlay-blurple: hsla(var(--purple-hsl), .2)
-}:root,[data-bs-theme="light"]{--bs-blue: #3347ff;--bs-indigo: #6610f2;--bs-purple: #bd53ee;--bs-pink: #d63384;--bs-red: #ee5389;--bs-orange: #fd7e14;--bs-yellow: #eebd53;--bs-green: #84ee53;--bs-teal: #20c997;--bs-cyan: #0dcaf0;--bs-black: #000;--bs-white: #fff;--bs-gray: #6c757d;--bs-gray-dark: #343a40;--bs-gray-100: #f8f9fa;--bs-gray-200: #e9ecef;--bs-gray-300: #dee2e6;--bs-gray-400: #ced4da;--bs-gray-500: #adb5bd;--bs-gray-600: #6c757d;--bs-gray-700: #495057;--bs-gray-800: #343a40;--bs-gray-900: #212529;--bs-primary: #3347ff;--bs-secondary: #6c757d;--bs-success: #84ee53;--bs-info: #3347ff;--bs-warning: #eebd53;--bs-danger: #ee5389;--bs-light: #f8f9fa;--bs-dark: #212529;--bs-primary-rgb: 51,71.4,255;--bs-secondary-rgb: 108,117,125;--bs-success-rgb: 132.2821,238.017,83.283;--bs-info-rgb: 51,71.4,255;--bs-warning-rgb: 238.017,189.0179,83.283;--bs-danger-rgb: 238.017,83.283,137.4399;--bs-light-rgb: 248,249,250;--bs-dark-rgb: 33,37,41;--bs-primary-text-emphasis: #141d66;--bs-secondary-text-emphasis: #2b2f32;--bs-success-text-emphasis: #355f21;--bs-info-text-emphasis: #141d66;--bs-warning-text-emphasis: #5f4c21;--bs-danger-text-emphasis: #5f2137;--bs-light-text-emphasis: #495057;--bs-dark-text-emphasis: #495057;--bs-primary-bg-subtle: #d6daff;--bs-secondary-bg-subtle: #e2e3e5;--bs-success-bg-subtle: #e6fcdd;--bs-info-bg-subtle: #d6daff;--bs-warning-bg-subtle: #fcf2dd;--bs-danger-bg-subtle: #fcdde7;--bs-light-bg-subtle: #fcfcfd;--bs-dark-bg-subtle: #ced4da;--bs-primary-border-subtle: #adb6ff;--bs-secondary-border-subtle: #c4c8cb;--bs-success-border-subtle: #cef8ba;--bs-info-border-subtle: #adb6ff;--bs-warning-border-subtle: #f8e5ba;--bs-danger-border-subtle: #f8bad0;--bs-light-border-subtle: #e9ecef;--bs-dark-border-subtle: #adb5bd;--bs-white-rgb: 255,255,255;--bs-black-rgb: 0,0,0;--bs-font-sans-serif: "Jost", system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", "Noto Sans", "Liberation Sans", Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";--bs-font-monospace: SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;--bs-gradient: linear-gradient(180deg, rgba(255,255,255,0.15), rgba(255,255,255,0));--bs-body-font-family: var(--bs-font-sans-serif);--bs-body-font-size:1rem;--bs-body-font-weight: 400;--bs-body-line-height: 1.5;--bs-body-color: #1d2d35;--bs-body-color-rgb: 29,45,53;--bs-body-bg: #fff;--bs-body-bg-rgb: 255,255,255;--bs-emphasis-color: #000;--bs-emphasis-color-rgb: 0,0,0;--bs-secondary-color: rgba(29,45,53,0.75);--bs-secondary-color-rgb: 29,45,53;--bs-secondary-bg: #e9ecef;--bs-secondary-bg-rgb: 233,236,239;--bs-tertiary-color: rgba(29,45,53,0.5);--bs-tertiary-color-rgb: 29,45,53;--bs-tertiary-bg: #f8f9fa;--bs-tertiary-bg-rgb: 248,249,250;--bs-heading-color: inherit;--bs-link-color: #3347ff;--bs-link-color-rgb: 51,71.4,255;--bs-link-decoration: none;--bs-link-hover-color: #2939cc;--bs-link-hover-color-rgb: 41,57,204;--bs-link-hover-decoration: underline;--bs-code-color: #d63384;--bs-highlight-color: #1d2d35;--bs-highlight-bg: #fcf2dd;--bs-border-width: 1px;--bs-border-style: solid;--bs-border-color: #e9ecef;--bs-border-color-translucent: rgba(0,0,0,0.175);--bs-border-radius: .375rem;--bs-border-radius-sm: .25rem;--bs-border-radius-lg: .5rem;--bs-border-radius-xl: 1rem;--bs-border-radius-xxl: 2rem;--bs-border-radius-2xl: var(--bs-border-radius-xxl);--bs-border-radius-pill: 50rem;--bs-box-shadow: 0 0.5rem 1rem rgba(0,0,0,0.15);--bs-box-shadow-sm: 0 0.125rem 0.25rem rgba(0,0,0,0.075);--bs-box-shadow-lg: 0 1rem 3rem rgba(0,0,0,0.175);--bs-box-shadow-inset: inset 0 1px 2px rgba(0,0,0,0.075);--bs-focus-ring-width: .25rem;--bs-focus-ring-opacity: .25;--bs-focus-ring-color: rgba(51,71,255,0.25);--bs-form-valid-color: #84ee53;--bs-form-valid-border-color: #84ee53;--bs-form-invalid-color: #ee5389;--bs-form-invalid-border-color: #ee5389}[data-bs-theme="dark"]{color-scheme:dark;--bs-body-color: #c1c3c8;--bs-body-color-rgb: 192.831,194.7078,199.869;--bs-body-bg: #17181c;--bs-body-bg-rgb: 22.95,24.31,28.05;--bs-emphasis-color: #fff;--bs-emphasis-color-rgb: 255,255,255;--bs-secondary-color: rgba(173,181,189,0.75);--bs-secondary-color-rgb: 173,181,189;--bs-secondary-bg: #343a40;--bs-secondary-bg-rgb: 52,58,64;--bs-tertiary-color: rgba(173,181,189,0.5);--bs-tertiary-color-rgb: 173,181,189;--bs-tertiary-bg: #2b3035;--bs-tertiary-bg-rgb: 43,48,53;--bs-primary-text-emphasis: #8591ff;--bs-secondary-text-emphasis: #a7acb1;--bs-success-text-emphasis: #b5f598;--bs-info-text-emphasis: #8591ff;--bs-warning-text-emphasis: #f5d798;--bs-danger-text-emphasis: #f598b8;--bs-light-text-emphasis: #f8f9fa;--bs-dark-text-emphasis: #dee2e6;--bs-primary-bg-subtle: #0a0e33;--bs-secondary-bg-subtle: #161719;--bs-success-bg-subtle: #1a3011;--bs-info-bg-subtle: #0a0e33;--bs-warning-bg-subtle: #302611;--bs-danger-bg-subtle: #30111b;--bs-light-bg-subtle: #23262f;--bs-dark-bg-subtle: #1a1d20;--bs-primary-border-subtle: #1f2b99;--bs-secondary-border-subtle: #41464b;--bs-success-border-subtle: #4f8f32;--bs-info-border-subtle: #2e40e6;--bs-warning-border-subtle: #b38e3e;--bs-danger-border-subtle: #d64b7c;--bs-light-border-subtle: #353841;--bs-dark-border-subtle: #343a40;--bs-heading-color: #fff;--bs-link-color: #b3c7ff;--bs-link-hover-color: #9da7ff;--bs-link-color-rgb: 178.5,198.9,255;--bs-link-hover-color-rgb: 157,167,255;--bs-code-color: #e685b5;--bs-highlight-color: #c1c3c8;--bs-highlight-bg: #5f4c21;--bs-border-color: #495057;--bs-border-color-translucent: rgba(255,255,255,0.15);--bs-form-valid-color: #b5f598;--bs-form-valid-border-color: #b5f598;--bs-form-invalid-color: #f598b8;--bs-form-invalid-border-color: #f598b8}*,*::before,*::after{box-sizing:border-box}@media (prefers-reduced-motion: no-preference){:root{scroll-behavior:smooth}}body{margin:0;font-family:var(--bs-body-font-family);font-size:var(--bs-body-font-size);font-weight:var(--bs-body-font-weight);line-height:var(--bs-body-line-height);color:var(--bs-body-color);text-align:var(--bs-body-text-align);background-color:var(--bs-body-bg);-webkit-text-size-adjust:100%;-webkit-tap-highlight-color:rgba(0,0,0,0)}hr{margin:1rem 0;color:inherit;border:0;border-top:var(--bs-border-width) solid;opacity:.25}h6,.h6,h5,.h5,h4,.h4,h3,.h3,h2,.h2,h1,.h1{margin-top:0;margin-bottom:.5rem;font-weight:700;line-height:1.2;color:var(--bs-heading-color)}h1,.h1{font-size:calc(1.375rem + 1.5vw)}@media (min-width: 1200px){h1,.h1{font-size:2.5rem}}h2,.h2{font-size:calc(1.325rem + .9vw)}@media (min-width: 1200px){h2,.h2{font-size:2rem}}h3,.h3{font-size:calc(1.3rem + .6vw)}@media (min-width: 1200px){h3,.h3{font-size:1.75rem}}h4,.h4{font-size:calc(1.275rem + .3vw)}@media (min-width: 1200px){h4,.h4{font-size:1.5rem}}h5,.h5{font-size:1.25rem}h6,.h6{font-size:1rem}p{margin-top:0;margin-bottom:1rem}address{margin-bottom:1rem;font-style:normal;line-height:inherit}ol,ul{padding-left:2rem}ol,ul{margin-top:0;margin-bottom:1rem}ol ol,ul ul,ol ul,ul ol{margin-bottom:0}dt{font-weight:700}dd{margin-bottom:.5rem;margin-left:0}strong{font-weight:bolder}small,.small{font-size:.875em}sub,sup{position:relative;font-size:.75em;line-height:0;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}a{color:rgba(var(--bs-link-color-rgb), var(--bs-link-opacity, 1));text-decoration:none}a:hover{--bs-link-color-rgb: var(--bs-link-hover-color-rgb);text-decoration:underline}a:not([href]):not([class]),a:not([href]):not([class]):hover{color:inherit;text-decoration:none}pre,code,kbd,samp{font-family:var(--bs-font-monospace);font-size:1em}pre{display:block;margin-top:0;margin-bottom:1rem;overflow:auto;font-size:.875em}pre code{font-size:inherit;color:inherit;word-break:normal}code{font-size:.875em;color:var(--bs-code-color);word-wrap:break-word}a>code{color:inherit}kbd{padding:.1875rem .375rem;font-size:.875em;color:var(--bs-body-bg);background-color:var(--bs-body-color);border-radius:.25rem}kbd kbd{padding:0;font-size:1em}figure{margin:0 0 1rem}img,svg{vertical-align:middle}table{caption-side:bottom;border-collapse:collapse}caption{padding-top:.5rem;padding-bottom:.5rem;color:var(--bs-secondary-color);text-align:left}th{text-align:inherit;text-align:-webkit-match-parent}thead,tbody,tr,td,th{border-color:inherit;border-style:solid;border-width:0}label{display:inline-block}button{border-radius:0}button:focus:not(:focus-visible){outline:0}input,button,select{margin:0;font-family:inherit;font-size:inherit;line-height:inherit}button,select{text-transform:none}[role="button"]{cursor:pointer}select{word-wrap:normal}select:disabled{opacity:1}[list]:not([type="date"]):not([type="datetime-local"]):not([type="month"]):not([type="week"]):not([type="time"])::-webkit-calendar-picker-indicator{display:none !important}button,[type="button"],[type="reset"],[type="submit"]{-webkit-appearance:button}button:not(:disabled),[type="button"]:not(:disabled),[type="reset"]:not(:disabled),[type="submit"]:not(:disabled){cursor:pointer}::-moz-focus-inner{padding:0;border-style:none}::-webkit-datetime-edit-fields-wrapper,::-webkit-datetime-edit-text,::-webkit-datetime-edit-minute,::-webkit-datetime-edit-hour-field,::-webkit-datetime-edit-day-field,::-webkit-datetime-edit-month-field,::-webkit-datetime-edit-year-field{padding:0}::-webkit-inner-spin-button{height:auto}[type="search"]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-color-swatch-wrapper{padding:0}::file-selector-button{font:inherit;-webkit-appearance:button}output{display:inline-block}summary{display:list-item;cursor:pointer}.lead{font-size:1.25rem;font-weight:400}.list-unstyled{padding-left:0;list-style:none}.list-inline{padding-left:0;list-style:none}.list-inline-item{display:inline-block}.list-inline-item:not(:last-child){margin-right:.5rem}.img-fluid{max-width:100%;height:auto}.figure{display:inline-block}.container,.container-fluid,.container-lg{--bs-gutter-x: 3rem;--bs-gutter-y: 0;width:100%;padding-right:calc(var(--bs-gutter-x) * .5);padding-left:calc(var(--bs-gutter-x) * .5);margin-right:auto;margin-left:auto}@media (min-width: 576px){.container{max-width:540px}}@media (min-width: 768px){.container{max-width:720px}}@media (min-width: 992px){.container-lg,.container{max-width:960px}}@media (min-width: 1200px){.container-lg,.container{max-width:1240px}}@media (min-width: 1400px){.container-lg,.container{max-width:1320px}}:root{--bs-breakpoint-xs: 0;--bs-breakpoint-sm: 576px;--bs-breakpoint-md: 768px;--bs-breakpoint-lg: 992px;--bs-breakpoint-xl: 1200px;--bs-breakpoint-xxl: 1400px}.row{--bs-gutter-x: 3rem;--bs-gutter-y: 0;display:flex;flex-wrap:wrap;margin-top:calc(-1 * var(--bs-gutter-y));margin-right:calc(-.5 * var(--bs-gutter-x));margin-left:calc(-.5 * var(--bs-gutter-x))}.row>*{flex-shrink:0;width:100%;max-width:100%;padding-right:calc(var(--bs-gutter-x) * .5);padding-left:calc(var(--bs-gutter-x) * .5);margin-top:var(--bs-gutter-y)}.col{flex:1 0 0%}@media (min-width: 768px){.col-md-8{flex:0 0 auto;width:50%}.col-md-12{flex:0 0 auto;width:75%}.col-md-13{flex:0 0 auto;width:81.25%}.col-md-16{flex:0 0 auto;width:100%}}@media (min-width: 992px){.col-lg-4{flex:0 0 auto;width:25%}.col-lg-5{flex:0 0 auto;width:31.25%}.col-lg-7{flex:0 0 auto;width:43.75%}.col-lg-8{flex:0 0 auto;width:50%}.col-lg-9{flex:0 0 auto;width:56.25%}.col-lg-10{flex:0 0 auto;width:62.5%}.col-lg-11{flex:0 0 auto;width:68.75%}.col-lg-12{flex:0 0 auto;width:75%}}@media (min-width: 1200px){.col-xl{flex:1 0 0%}.col-xl-3{flex:0 0 auto;width:18.75%}.col-xl-4{flex:0 0 auto;width:25%}.col-xl-8{flex:0 0 auto;width:50%}.col-xl-9{flex:0 0 auto;width:56.25%}}.table,table{--bs-table-color-type: initial;--bs-table-bg-type: initial;--bs-table-color-state: initial;--bs-table-bg-state: initial;--bs-table-color: var(--bs-body-color);--bs-table-bg: rgba(0,0,0,0);--bs-table-border-color: var(--bs-border-color);--bs-table-accent-bg: rgba(0,0,0,0);--bs-table-striped-color: var(--bs-body-color);--bs-table-striped-bg: rgba(0,0,0,0.05);--bs-table-active-color: var(--bs-body-color);--bs-table-active-bg: rgba(0,0,0,0.1);--bs-table-hover-color: var(--bs-body-color);--bs-table-hover-bg: rgba(0,0,0,0.075);width:100%;margin-bottom:1rem;vertical-align:top;border-color:var(--bs-table-border-color)}.table>:not(caption)>*>*,table>:not(caption)>*>*{padding:.5rem .5rem;color:var(--bs-table-color-state, var(--bs-table-color-type, var(--bs-table-color)));background-color:var(--bs-table-bg);border-bottom-width:var(--bs-border-width);box-shadow:inset 0 0 0 9999px var(--bs-table-bg-state, var(--bs-table-bg-type, var(--bs-table-accent-bg)))}.table>tbody,table>tbody{vertical-align:inherit}.table>thead,table>thead{vertical-align:bottom}[data-bs-theme="dark"] table{--bs-table-color: #fff;--bs-table-bg: #212529;--bs-table-border-color: #373b3e;--bs-table-striped-bg: #2c3034;--bs-table-striped-color: #fff;--bs-table-active-bg: #373b3e;--bs-table-active-color: #fff;--bs-table-hover-bg: #323539;--bs-table-hover-color: #fff;color:var(--bs-table-color);border-color:var(--bs-table-border-color)}.form-control{display:block;width:100%;padding:.375rem .75rem;font-size:1rem;font-weight:400;line-height:1.5;color:var(--bs-body-color);-webkit-appearance:none;-moz-appearance:none;appearance:none;background-color:var(--bs-body-bg);background-clip:padding-box;border:var(--bs-border-width) solid var(--bs-border-color);border-radius:.375rem;transition:border-color 0.15s ease-in-out,box-shadow 0.15s ease-in-out}@media (prefers-reduced-motion: reduce){.form-control{transition:none}}.form-control[type="file"]{overflow:hidden}.form-control[type="file"]:not(:disabled):not([readonly]){cursor:pointer}.form-control:focus{color:var(--bs-body-color);background-color:var(--bs-body-bg);border-color:#99a3ff;outline:0;box-shadow:none}.form-control::-webkit-date-and-time-value{min-width:85px;height:1.5em;margin:0}.form-control::-webkit-datetime-edit{display:block;padding:0}.form-control::-moz-placeholder{color:var(--bs-secondary-color);opacity:1}.form-control::placeholder{color:var(--bs-secondary-color);opacity:1}.form-control:disabled{background-color:var(--bs-secondary-bg);opacity:1}.form-control::file-selector-button{padding:.375rem .75rem;margin:-.375rem -.75rem;margin-inline-end:.75rem;color:var(--bs-body-color);background-color:var(--bs-tertiary-bg);pointer-events:none;border-color:inherit;border-style:solid;border-width:0;border-inline-end-width:var(--bs-border-width);border-radius:0;transition:color 0.15s ease-in-out,background-color 0.15s ease-in-out,border-color 0.15s ease-in-out,box-shadow 0.15s ease-in-out}@media (prefers-reduced-motion: reduce){.form-control::file-selector-button{transition:none}}.form-control:hover:not(:disabled):not([readonly])::file-selector-button{background-color:var(--bs-secondary-bg)}.form-control-lg{min-height:calc(1.5em + 1rem + calc($input-border-width * 2));padding:.5rem 1rem;font-size:1.25rem;border-radius:.5rem}.form-control-lg::file-selector-button{padding:.5rem 1rem;margin:-.5rem -1rem;margin-inline-end:1rem}li input[type="checkbox"]{--bs-form-check-bg: var(--bs-body-bg);flex-shrink:0;width:1em;height:1em;margin-top:.25em;vertical-align:top;-webkit-appearance:none;-moz-appearance:none;appearance:none;background-color:var(--bs-form-check-bg);background-image:var(--bs-form-check-bg-image);background-repeat:no-repeat;background-position:center;background-size:contain;border:var(--bs-border-width) solid var(--bs-border-color);-webkit-print-color-adjust:exact;print-color-adjust:exact}li input[type="checkbox"]{border-radius:.25em}li input[type="radio"][type="checkbox"]{border-radius:50%}li input[type="checkbox"]:active{filter:brightness(90%)}li input[type="checkbox"]:focus{border-color:#99a3ff;outline:0;box-shadow:0 0 0 .25rem rgba(51,71,255,0.25)}li input[type="checkbox"]:checked{background-color:#3347ff;border-color:#3347ff}li input:checked[type="checkbox"]{--bs-form-check-bg-image: url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3e%3cpath fill='none' stroke='%23fff' stroke-linecap='round' stroke-linejoin='round' stroke-width='3' d='m6 10 3 3 6-6'/%3e%3c/svg%3e")}li input[type="checkbox"]:checked[type="radio"]{--bs-form-check-bg-image: url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='-4 -4 8 8'%3e%3ccircle r='2' fill='%23fff'/%3e%3c/svg%3e")}li input[type="checkbox"]:indeterminate{background-color:#3347ff;border-color:#3347ff;--bs-form-check-bg-image: url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3e%3cpath fill='none' stroke='%23fff' stroke-linecap='round' stroke-linejoin='round' stroke-width='3' d='M6 10h8'/%3e%3c/svg%3e")}li input[type="checkbox"]:disabled{pointer-events:none;filter:none;opacity:.5}.btn{--bs-btn-padding-x: .75rem;--bs-btn-padding-y: .375rem;--bs-btn-font-family: ;--bs-btn-font-size:1rem;--bs-btn-font-weight: 400;--bs-btn-line-height: 1.5;--bs-btn-color: var(--bs-body-color);--bs-btn-bg: transparent;--bs-btn-border-width: var(--bs-border-width);--bs-btn-border-color: transparent;--bs-btn-border-radius: .375rem;--bs-btn-hover-border-color: transparent;--bs-btn-box-shadow: inset 0 1px 0 rgba(255,255,255,0.15),0 1px 1px rgba(0,0,0,0.075);--bs-btn-disabled-opacity: .65;--bs-btn-focus-box-shadow: 0 0 0 0 rgba(var(--bs-btn-focus-shadow-rgb), .5);display:inline-block;padding:var(--bs-btn-padding-y) var(--bs-btn-padding-x);font-family:var(--bs-btn-font-family);font-size:var(--bs-btn-font-size);font-weight:var(--bs-btn-font-weight);line-height:var(--bs-btn-line-height);color:var(--bs-btn-color);text-align:center;vertical-align:middle;cursor:pointer;-webkit-user-select:none;-moz-user-select:none;user-select:none;border:var(--bs-btn-border-width) solid var(--bs-btn-border-color);border-radius:var(--bs-btn-border-radius);background-color:var(--bs-btn-bg);transition:color 0.15s ease-in-out,background-color 0.15s ease-in-out,border-color 0.15s ease-in-out,box-shadow 0.15s ease-in-out}@media (prefers-reduced-motion: reduce){.btn{transition:none}}.btn:hover{color:var(--bs-btn-hover-color);text-decoration:none;background-color:var(--bs-btn-hover-bg);border-color:var(--bs-btn-hover-border-color)}.btn:focus-visible{color:var(--bs-btn-hover-color);background-color:var(--bs-btn-hover-bg);border-color:var(--bs-btn-hover-border-color);outline:0;box-shadow:var(--bs-btn-focus-box-shadow)}:not(.btn-check)+.btn:active,.btn:first-child:active,.btn.active,.btn.show{color:var(--bs-btn-active-color);background-color:var(--bs-btn-active-bg);border-color:var(--bs-btn-active-border-color)}:not(.btn-check)+.btn:active:focus-visible,.btn:first-child:active:focus-visible,.btn.active:focus-visible,.btn.show:focus-visible{box-shadow:var(--bs-btn-focus-box-shadow)}.btn:disabled,.btn.disabled{color:var(--bs-btn-disabled-color);pointer-events:none;background-color:var(--bs-btn-disabled-bg);border-color:var(--bs-btn-disabled-border-color);opacity:var(--bs-btn-disabled-opacity)}.btn-primary{--bs-btn-color: #fff;--bs-btn-bg: #3347ff;--bs-btn-border-color: #3347ff;--bs-btn-hover-color: #fff;--bs-btn-hover-bg: #2b3dd9;--bs-btn-hover-border-color: #2939cc;--bs-btn-focus-shadow-rgb: 82,99,255;--bs-btn-active-color: #fff;--bs-btn-active-bg: #2939cc;--bs-btn-active-border-color: #2636bf;--bs-btn-active-shadow: inset 0 3px 5px rgba(0,0,0,0.125);--bs-btn-disabled-color: #fff;--bs-btn-disabled-bg: #3347ff;--bs-btn-disabled-border-color: #3347ff}.btn-light{--bs-btn-color: #000;--bs-btn-bg: #f8f9fa;--bs-btn-border-color: #f8f9fa;--bs-btn-hover-color: #000;--bs-btn-hover-bg: #d3d4d5;--bs-btn-hover-border-color: #c6c7c8;--bs-btn-focus-shadow-rgb: 211,212,213;--bs-btn-active-color: #000;--bs-btn-active-bg: #c6c7c8;--bs-btn-active-border-color: #babbbc;--bs-btn-active-shadow: inset 0 3px 5px rgba(0,0,0,0.125);--bs-btn-disabled-color: #000;--bs-btn-disabled-bg: #f8f9fa;--bs-btn-disabled-border-color: #f8f9fa}.btn-link{--bs-btn-font-weight: 400;--bs-btn-color: var(--bs-link-color);--bs-btn-bg: transparent;--bs-btn-border-color: transparent;--bs-btn-hover-color: var(--bs-link-hover-color);--bs-btn-hover-border-color: transparent;--bs-btn-active-color: var(--bs-link-hover-color);--bs-btn-active-border-color: transparent;--bs-btn-disabled-color: #6c757d;--bs-btn-disabled-border-color: transparent;--bs-btn-box-shadow: 0 0 0 #000;--bs-btn-focus-shadow-rgb: 82,99,255;text-decoration:none}.btn-link:hover,.btn-link:focus-visible{text-decoration:underline}.btn-link:focus-visible{color:var(--bs-btn-color)}.btn-link:hover{color:var(--bs-btn-hover-color)}.btn-lg{--bs-btn-padding-y: .5rem;--bs-btn-padding-x: 1rem;--bs-btn-font-size:1.25rem;--bs-btn-border-radius: .5rem}.fade{transition:opacity 0.15s linear}@media (prefers-reduced-motion: reduce){.fade{transition:none}}.fade:not(.show){opacity:0}.collapse:not(.show){display:none}.dropup,.dropend,.dropdown,.dropstart,.dropup-center,.dropdown-center{position:relative}.dropdown-toggle{white-space:nowrap}.dropdown-toggle::after{display:inline-block;margin-left:.255em;vertical-align:.255em;content:"";border-top:.3em solid;border-right:.3em solid transparent;border-bottom:0;border-left:.3em solid transparent}.dropdown-toggle:empty::after{margin-left:0}.dropdown-menu{--bs-dropdown-zindex: 1000;--bs-dropdown-min-width: 10rem;--bs-dropdown-padding-x: 0;--bs-dropdown-padding-y: .5rem;--bs-dropdown-spacer: .125rem;--bs-dropdown-font-size:1rem;--bs-dropdown-color: var(--bs-body-color);--bs-dropdown-bg: var(--bs-body-bg);--bs-dropdown-border-color: var(--bs-border-color-translucent);--bs-dropdown-border-radius: .375rem;--bs-dropdown-border-width: var(--bs-border-width);--bs-dropdown-inner-border-radius: calc($dropdown-border-radius - $dropdown-border-width);--bs-dropdown-divider-bg: var(--bs-border-color-translucent);--bs-dropdown-divider-margin-y: .5rem;--bs-dropdown-box-shadow: 0 0.5rem 1rem rgba(0,0,0,0.15);--bs-dropdown-link-color: var(--bs-body-color);--bs-dropdown-link-hover-color: var(--bs-body-color);--bs-dropdown-link-hover-bg: var(--bs-tertiary-bg);--bs-dropdown-link-active-color: #fff;--bs-dropdown-link-active-bg: #3347ff;--bs-dropdown-link-disabled-color: var(--bs-tertiary-color);--bs-dropdown-item-padding-x: 1rem;--bs-dropdown-item-padding-y: .25rem;--bs-dropdown-header-color: #6c757d;--bs-dropdown-header-padding-x: 1rem;--bs-dropdown-header-padding-y: .5rem;position:absolute;z-index:var(--bs-dropdown-zindex);display:none;min-width:var(--bs-dropdown-min-width);padding:var(--bs-dropdown-padding-y) var(--bs-dropdown-padding-x);margin:0;font-size:var(--bs-dropdown-font-size);color:var(--bs-dropdown-color);text-align:left;list-style:none;background-color:var(--bs-dropdown-bg);background-clip:padding-box;border:var(--bs-dropdown-border-width) solid var(--bs-dropdown-border-color);border-radius:var(--bs-dropdown-border-radius)}.dropdown-menu[data-bs-popper]{top:100%;left:0;margin-top:var(--bs-dropdown-spacer)}@media (min-width: 992px){.dropdown-menu-lg-end{--bs-position: end}.dropdown-menu-lg-end[data-bs-popper]{right:0;left:auto}}.dropup .dropdown-menu[data-bs-popper]{top:auto;bottom:100%;margin-top:0;margin-bottom:var(--bs-dropdown-spacer)}.dropup .dropdown-toggle::after{display:inline-block;margin-left:.255em;vertical-align:.255em;content:"";border-top:0;border-right:.3em solid transparent;border-bottom:.3em solid;border-left:.3em solid transparent}.dropup .dropdown-toggle:empty::after{margin-left:0}.dropend .dropdown-menu[data-bs-popper]{top:0;right:auto;left:100%;margin-top:0;margin-left:var(--bs-dropdown-spacer)}.dropend .dropdown-toggle::after{display:inline-block;margin-left:.255em;vertical-align:.255em;content:"";border-top:.3em solid transparent;border-right:0;border-bottom:.3em solid transparent;border-left:.3em solid}.dropend .dropdown-toggle:empty::after{margin-left:0}.dropend .dropdown-toggle::after{vertical-align:0}.dropstart .dropdown-menu[data-bs-popper]{top:0;right:100%;left:auto;margin-top:0;margin-right:var(--bs-dropdown-spacer)}.dropstart .dropdown-toggle::after{display:inline-block;margin-left:.255em;vertical-align:.255em;content:""}.dropstart .dropdown-toggle::after{display:none}.dropstart .dropdown-toggle::before{display:inline-block;margin-right:.255em;vertical-align:.255em;content:"";border-top:.3em solid transparent;border-right:.3em solid;border-bottom:.3em solid transparent}.dropstart .dropdown-toggle:empty::after{margin-left:0}.dropstart .dropdown-toggle::before{vertical-align:0}.dropdown-divider{height:0;margin:var(--bs-dropdown-divider-margin-y) 0;overflow:hidden;border-top:1px solid var(--bs-dropdown-divider-bg);opacity:1}.dropdown-item{display:block;width:100%;padding:var(--bs-dropdown-item-padding-y) var(--bs-dropdown-item-padding-x);clear:both;font-weight:400;color:var(--bs-dropdown-link-color);text-align:inherit;white-space:nowrap;background-color:transparent;border:0;border-radius:var(--bs-dropdown-item-border-radius, 0)}.dropdown-item:hover,.dropdown-item:focus{color:var(--bs-dropdown-link-hover-color);text-decoration:none;background-color:var(--bs-dropdown-link-hover-bg)}.dropdown-item.active,.dropdown-item:active{color:var(--bs-dropdown-link-active-color);text-decoration:none;background-color:var(--bs-dropdown-link-active-bg)}.dropdown-item.disabled,.dropdown-item:disabled{color:var(--bs-dropdown-link-disabled-color);pointer-events:none;background-color:transparent}.dropdown-menu.show{display:block}.dropdown-header{display:block;padding:var(--bs-dropdown-header-padding-y) var(--bs-dropdown-header-padding-x);margin-bottom:0;font-size:.875rem;color:var(--bs-dropdown-header-color);white-space:nowrap}.dropdown-item-text{display:block;padding:var(--bs-dropdown-item-padding-y) var(--bs-dropdown-item-padding-x);color:var(--bs-dropdown-link-color)}.dropdown-menu-dark{--bs-dropdown-color: #dee2e6;--bs-dropdown-bg: #343a40;--bs-dropdown-border-color: var(--bs-border-color-translucent);--bs-dropdown-box-shadow: ;--bs-dropdown-link-color: #dee2e6;--bs-dropdown-link-hover-color: #fff;--bs-dropdown-divider-bg: var(--bs-border-color-translucent);--bs-dropdown-link-hover-bg: rgba(255,255,255,0.15);--bs-dropdown-link-active-color: #fff;--bs-dropdown-link-active-bg: #3347ff;--bs-dropdown-link-disabled-color: #adb5bd;--bs-dropdown-header-color: #adb5bd}.nav{--bs-nav-link-padding-x: 1rem;--bs-nav-link-padding-y: .5rem;--bs-nav-link-font-weight: ;--bs-nav-link-color: var(--bs-link-color);--bs-nav-link-hover-color: var(--bs-link-hover-color);--bs-nav-link-disabled-color: var(--bs-secondary-color);display:flex;flex-wrap:wrap;padding-left:0;margin-bottom:0;list-style:none}.nav-link{display:block;padding:var(--bs-nav-link-padding-y) var(--bs-nav-link-padding-x);font-size:var(--bs-nav-link-font-size);font-weight:var(--bs-nav-link-font-weight);color:var(--bs-nav-link-color);background:none;border:0;transition:color 0.15s ease-in-out,background-color 0.15s ease-in-out,border-color 0.15s ease-in-out}@media (prefers-reduced-motion: reduce){.nav-link{transition:none}}.nav-link:hover,.nav-link:focus{color:var(--bs-nav-link-hover-color);text-decoration:none}.nav-link:focus-visible{outline:0;box-shadow:0 0 0 .25rem rgba(51,71,255,0.25)}.nav-link.disabled,.nav-link:disabled{color:var(--bs-nav-link-disabled-color);pointer-events:none;cursor:default}.nav-tabs{--bs-nav-tabs-border-width: var(--bs-border-width);--bs-nav-tabs-border-color: var(--bs-border-color);--bs-nav-tabs-border-radius: var(--bs-border-radius);--bs-nav-tabs-link-hover-border-color: var(--bs-secondary-bg) var(--bs-secondary-bg) var(--bs-border-color);--bs-nav-tabs-link-active-color: var(--bs-emphasis-color);--bs-nav-tabs-link-active-bg: var(--bs-body-bg);--bs-nav-tabs-link-active-border-color: var(--bs-border-color) var(--bs-border-color) var(--bs-body-bg);border-bottom:var(--bs-nav-tabs-border-width) solid var(--bs-nav-tabs-border-color)}.nav-tabs .nav-link{margin-bottom:calc(-1 * var(--bs-nav-tabs-border-width));border:var(--bs-nav-tabs-border-width) solid transparent;border-top-left-radius:var(--bs-nav-tabs-border-radius);border-top-right-radius:var(--bs-nav-tabs-border-radius)}.nav-tabs .nav-link:hover,.nav-tabs .nav-link:focus{isolation:isolate;border-color:var(--bs-nav-tabs-link-hover-border-color)}.nav-tabs .nav-link.active,.nav-tabs .nav-item.show .nav-link{color:var(--bs-nav-tabs-link-active-color);background-color:var(--bs-nav-tabs-link-active-bg);border-color:var(--bs-nav-tabs-link-active-border-color)}.nav-tabs .dropdown-menu{margin-top:calc(-1 * var(--bs-nav-tabs-border-width));border-top-left-radius:0;border-top-right-radius:0}.tab-content>.tab-pane{display:none}.tab-content>.active{display:block}.navbar{--bs-navbar-padding-x: 0;--bs-navbar-padding-y: .5rem;--bs-navbar-color: rgba(var(--bs-emphasis-color-rgb), 0.65);--bs-navbar-hover-color: rgba(var(--bs-emphasis-color-rgb), 0.8);--bs-navbar-disabled-color: rgba(var(--bs-emphasis-color-rgb), 0.3);--bs-navbar-active-color: rgba(var(--bs-emphasis-color-rgb), 1);--bs-navbar-brand-padding-y: .3125rem;--bs-navbar-brand-margin-end: 1rem;--bs-navbar-brand-font-size: 1.25rem;--bs-navbar-brand-color: rgba(var(--bs-emphasis-color-rgb), 1);--bs-navbar-brand-hover-color: rgba(var(--bs-emphasis-color-rgb), 1);--bs-navbar-nav-link-padding-x: .5rem;--bs-navbar-toggler-padding-y: .25rem;--bs-navbar-toggler-padding-x: .75rem;--bs-navbar-toggler-font-size: 1.25rem;--bs-navbar-toggler-icon-bg: url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 30 30'%3e%3cpath stroke='rgba%2829,45,53,0.75%29' stroke-linecap='round' stroke-miterlimit='10' stroke-width='2' d='M4 7h22M4 15h22M4 23h22'/%3e%3c/svg%3e");--bs-navbar-toggler-border-color: rgba(var(--bs-emphasis-color-rgb), 0.15);--bs-navbar-toggler-border-radius: .375rem;--bs-navbar-toggler-focus-width: 0;--bs-navbar-toggler-transition: box-shadow 0.15s ease-in-out;position:relative;display:flex;flex-wrap:wrap;align-items:center;justify-content:space-between;padding:var(--bs-navbar-padding-y) var(--bs-navbar-padding-x)}.navbar>.container,.navbar>.container-fluid,.navbar>.container-lg{display:flex;flex-wrap:inherit;align-items:center;justify-content:space-between}.navbar-brand{padding-top:var(--bs-navbar-brand-padding-y);padding-bottom:var(--bs-navbar-brand-padding-y);margin-right:var(--bs-navbar-brand-margin-end);font-size:var(--bs-navbar-brand-font-size);color:var(--bs-navbar-brand-color);white-space:nowrap}.navbar-brand:hover,.navbar-brand:focus{color:var(--bs-navbar-brand-hover-color);text-decoration:none}.navbar-nav{--bs-nav-link-padding-x: 0;--bs-nav-link-padding-y: .5rem;--bs-nav-link-font-weight: ;--bs-nav-link-color: var(--bs-navbar-color);--bs-nav-link-hover-color: var(--bs-navbar-hover-color);--bs-nav-link-disabled-color: var(--bs-navbar-disabled-color);display:flex;flex-direction:column;padding-left:0;margin-bottom:0;list-style:none}.navbar-nav .nav-link.active,.navbar-nav .nav-link.show{color:var(--bs-navbar-active-color)}.navbar-nav .dropdown-menu{position:static}@media (min-width: 992px){.navbar-expand-lg{flex-wrap:nowrap;justify-content:flex-start}.navbar-expand-lg .navbar-nav{flex-direction:row}.navbar-expand-lg .navbar-nav .dropdown-menu{position:absolute}.navbar-expand-lg .navbar-nav .nav-link{padding-right:var(--bs-navbar-nav-link-padding-x);padding-left:var(--bs-navbar-nav-link-padding-x)}.navbar-expand-lg .offcanvas{position:static;z-index:auto;flex-grow:1;width:auto !important;height:auto !important;visibility:visible !important;background-color:transparent !important;border:0 !important;transform:none !important;transition:none}.navbar-expand-lg .offcanvas .offcanvas-header{display:none}.navbar-expand-lg .offcanvas .offcanvas-body{display:flex;flex-grow:0;padding:0;overflow-y:visible}}.navbar[data-bs-theme="dark"]{--bs-navbar-color: #c1c3c8;--bs-navbar-hover-color: #b3c7ff;--bs-navbar-disabled-color: rgba(255,255,255,0.25);--bs-navbar-active-color: #b3c7ff;--bs-navbar-brand-color: #fff;--bs-navbar-brand-hover-color: #fff;--bs-navbar-toggler-border-color: rgba(255,255,255,0.1);--bs-navbar-toggler-icon-bg: url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 30 30'%3e%3cpath stroke='rgba%28255,255,255,0.55%29' stroke-linecap='round' stroke-miterlimit='10' stroke-width='2' d='M4 7h22M4 15h22M4 23h22'/%3e%3c/svg%3e")}.card{--bs-card-spacer-y: 1rem;--bs-card-spacer-x: 1rem;--bs-card-title-spacer-y: .5rem;--bs-card-title-color: ;--bs-card-subtitle-color: ;--bs-card-border-width: var(--bs-border-width);--bs-card-border-color: #e9ecef;--bs-card-border-radius: var(--bs-border-radius);--bs-card-box-shadow: ;--bs-card-inner-border-radius: calc(var(--bs-border-radius) - (var(--bs-border-width)));--bs-card-cap-padding-y: .5rem;--bs-card-cap-padding-x: 1rem;--bs-card-cap-bg: rgba(var(--bs-body-color-rgb), 0.03);--bs-card-cap-color: ;--bs-card-height: ;--bs-card-color: ;--bs-card-bg: var(--bs-body-bg);--bs-card-img-overlay-padding: 1rem;--bs-card-group-margin: 1.5rem;position:relative;display:flex;flex-direction:column;min-width:0;height:var(--bs-card-height);color:var(--bs-body-color);word-wrap:break-word;background-color:var(--bs-card-bg);background-clip:border-box;border:var(--bs-card-border-width) solid var(--bs-card-border-color);border-radius:var(--bs-card-border-radius)}.card>hr{margin-right:0;margin-left:0}.card>.list-group{border-top:inherit;border-bottom:inherit}.card>.list-group:first-child{border-top-width:0;border-top-left-radius:var(--bs-card-inner-border-radius);border-top-right-radius:var(--bs-card-inner-border-radius)}.card>.list-group:last-child{border-bottom-width:0;border-bottom-right-radius:var(--bs-card-inner-border-radius);border-bottom-left-radius:var(--bs-card-inner-border-radius)}.card-body{flex:1 1 auto;padding:var(--bs-card-spacer-y) var(--bs-card-spacer-x);color:var(--bs-card-color)}.breadcrumb{--bs-breadcrumb-padding-x: 0;--bs-breadcrumb-padding-y: 0;--bs-breadcrumb-margin-bottom: 1rem;--bs-breadcrumb-bg: ;--bs-breadcrumb-border-radius: ;--bs-breadcrumb-divider-color: var(--bs-secondary-color);--bs-breadcrumb-item-padding-x: .5rem;--bs-breadcrumb-item-active-color: var(--bs-secondary-color);display:flex;flex-wrap:wrap;padding:var(--bs-breadcrumb-padding-y) var(--bs-breadcrumb-padding-x);margin-bottom:var(--bs-breadcrumb-margin-bottom);font-size:var(--bs-breadcrumb-font-size);list-style:none;background-color:var(--bs-breadcrumb-bg);border-radius:var(--bs-breadcrumb-border-radius)}.breadcrumb-item+.breadcrumb-item{padding-left:var(--bs-breadcrumb-item-padding-x)}.breadcrumb-item+.breadcrumb-item::before{float:left;padding-right:var(--bs-breadcrumb-item-padding-x);color:var(--bs-breadcrumb-divider-color);content:var(--bs-breadcrumb-divider, "/") /* rtl: var(--bs-breadcrumb-divider, "/") */}.breadcrumb-item.active{color:var(--bs-breadcrumb-item-active-color)}.pagination{--bs-pagination-padding-x: .75rem;--bs-pagination-padding-y: .375rem;--bs-pagination-font-size:1rem;--bs-pagination-color: var(--bs-link-color);--bs-pagination-bg: var(--bs-body-bg);--bs-pagination-border-width: var(--bs-border-width);--bs-pagination-border-color: var(--bs-border-color);--bs-pagination-border-radius: var(--bs-border-radius);--bs-pagination-hover-color: var(--bs-link-hover-color);--bs-pagination-hover-bg: var(--bs-tertiary-bg);--bs-pagination-hover-border-color: var(--bs-border-color);--bs-pagination-focus-color: var(--bs-link-hover-color);--bs-pagination-focus-bg: var(--bs-secondary-bg);--bs-pagination-focus-box-shadow: 0 0 0 .25rem rgba(51,71,255,0.25);--bs-pagination-active-color: #fff;--bs-pagination-active-bg: #3347ff;--bs-pagination-active-border-color: #3347ff;--bs-pagination-disabled-color: var(--bs-secondary-color);--bs-pagination-disabled-bg: var(--bs-secondary-bg);--bs-pagination-disabled-border-color: var(--bs-border-color);display:flex;padding-left:0;list-style:none}.badge{--bs-badge-padding-x: .65em;--bs-badge-padding-y: .35em;--bs-badge-font-size:.75em;--bs-badge-font-weight: 700;--bs-badge-color: #fff;--bs-badge-border-radius: .375rem;display:inline-block;padding:var(--bs-badge-padding-y) var(--bs-badge-padding-x);font-size:var(--bs-badge-font-size);font-weight:var(--bs-badge-font-weight);line-height:1;color:var(--bs-badge-color);text-align:center;white-space:nowrap;vertical-align:baseline;border-radius:var(--bs-badge-border-radius)}.badge:empty{display:none}.btn .badge{position:relative;top:-1px}.alert{--bs-alert-bg: transparent;--bs-alert-padding-x: 1.5rem;--bs-alert-padding-y: 1rem;--bs-alert-margin-bottom: 0;--bs-alert-color: inherit;--bs-alert-border-color: transparent;--bs-alert-border: 0 solid var(--bs-alert-border-color);--bs-alert-border-radius: 0;--bs-alert-link-color: inherit;position:relative;padding:var(--bs-alert-padding-y) var(--bs-alert-padding-x);margin-bottom:var(--bs-alert-margin-bottom);color:var(--bs-alert-color);background-color:var(--bs-alert-bg);border:var(--bs-alert-border);border-radius:var(--bs-alert-border-radius)}.alert-link,.callout a{font-weight:700;color:var(--bs-alert-link-color)}.alert-dismissible{padding-right:4.5rem}.alert-dismissible .btn-close{position:absolute;top:0;right:0;z-index:2;padding:1.25rem 1.5rem}.alert-primary{--bs-alert-color: var(--bs-primary-text-emphasis);--bs-alert-bg: var(--bs-primary-bg-subtle);--bs-alert-border-color: var(--bs-primary-border-subtle);--bs-alert-link-color: var(--bs-primary-text-emphasis)}.alert-secondary{--bs-alert-color: var(--bs-secondary-text-emphasis);--bs-alert-bg: var(--bs-secondary-bg-subtle);--bs-alert-border-color: var(--bs-secondary-border-subtle);--bs-alert-link-color: var(--bs-secondary-text-emphasis)}.alert-success{--bs-alert-color: var(--bs-success-text-emphasis);--bs-alert-bg: var(--bs-success-bg-subtle);--bs-alert-border-color: var(--bs-success-border-subtle);--bs-alert-link-color: var(--bs-success-text-emphasis)}.alert-info{--bs-alert-color: var(--bs-info-text-emphasis);--bs-alert-bg: var(--bs-info-bg-subtle);--bs-alert-border-color: var(--bs-info-border-subtle);--bs-alert-link-color: var(--bs-info-text-emphasis)}.alert-warning{--bs-alert-color: var(--bs-warning-text-emphasis);--bs-alert-bg: var(--bs-warning-bg-subtle);--bs-alert-border-color: var(--bs-warning-border-subtle);--bs-alert-link-color: var(--bs-warning-text-emphasis)}.alert-danger{--bs-alert-color: var(--bs-danger-text-emphasis);--bs-alert-bg: var(--bs-danger-bg-subtle);--bs-alert-border-color: var(--bs-danger-border-subtle);--bs-alert-link-color: var(--bs-danger-text-emphasis)}.alert-light{--bs-alert-color: var(--bs-light-text-emphasis);--bs-alert-bg: var(--bs-light-bg-subtle);--bs-alert-border-color: var(--bs-light-border-subtle);--bs-alert-link-color: var(--bs-light-text-emphasis)}.alert-dark{--bs-alert-color: var(--bs-dark-text-emphasis);--bs-alert-bg: var(--bs-dark-bg-subtle);--bs-alert-border-color: var(--bs-dark-border-subtle);--bs-alert-link-color: var(--bs-dark-text-emphasis)}@keyframes progress-bar-stripes{0%{background-position-x:1rem}}.list-group{--bs-list-group-color: var(--bs-body-color);--bs-list-group-bg: var(--bs-body-bg);--bs-list-group-border-color: var(--bs-border-color);--bs-list-group-border-width: var(--bs-border-width);--bs-list-group-border-radius: var(--bs-border-radius);--bs-list-group-item-padding-x: 1rem;--bs-list-group-item-padding-y: .5rem;--bs-list-group-action-color: var(--bs-secondary-color);--bs-list-group-action-hover-color: var(--bs-emphasis-color);--bs-list-group-action-hover-bg: var(--bs-tertiary-bg);--bs-list-group-action-active-color: var(--bs-body-color);--bs-list-group-action-active-bg: var(--bs-secondary-bg);--bs-list-group-disabled-color: var(--bs-secondary-color);--bs-list-group-disabled-bg: var(--bs-body-bg);--bs-list-group-active-color: #fff;--bs-list-group-active-bg: #3347ff;--bs-list-group-active-border-color: #3347ff;display:flex;flex-direction:column;padding-left:0;margin-bottom:0;border-radius:var(--bs-list-group-border-radius)}.list-group-item-action{width:100%;color:var(--bs-list-group-action-color);text-align:inherit}.list-group-item-action:hover,.list-group-item-action:focus{z-index:1;color:var(--bs-list-group-action-hover-color);text-decoration:none;background-color:var(--bs-list-group-action-hover-bg)}.list-group-item-action:active{color:var(--bs-list-group-action-active-color);background-color:var(--bs-list-group-action-active-bg)}.list-group-item{position:relative;display:block;padding:var(--bs-list-group-item-padding-y) var(--bs-list-group-item-padding-x);color:var(--bs-list-group-color);background-color:var(--bs-list-group-bg);border:var(--bs-list-group-border-width) solid var(--bs-list-group-border-color)}.list-group-item:first-child{border-top-left-radius:inherit;border-top-right-radius:inherit}.list-group-item:last-child{border-bottom-right-radius:inherit;border-bottom-left-radius:inherit}.list-group-item.disabled,.list-group-item:disabled{color:var(--bs-list-group-disabled-color);pointer-events:none;background-color:var(--bs-list-group-disabled-bg)}.list-group-item.active{z-index:2;color:var(--bs-list-group-active-color);background-color:var(--bs-list-group-active-bg);border-color:var(--bs-list-group-active-border-color)}.list-group-item+.list-group-item{border-top-width:0}.list-group-item+.list-group-item.active{margin-top:calc(-1 * var(--bs-list-group-border-width));border-top-width:var(--bs-list-group-border-width)}.btn-close{--bs-btn-close-color: #000;--bs-btn-close-bg: url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='%23000'%3e%3cpath d='M.293.293a1 1 0 0 1 1.414 0L8 6.586 14.293.293a1 1 0 1 1 1.414 1.414L9.414 8l6.293 6.293a1 1 0 0 1-1.414 1.414L8 9.414l-6.293 6.293a1 1 0 0 1-1.414-1.414L6.586 8 .293 1.707a1 1 0 0 1 0-1.414z'/%3e%3c/svg%3e");--bs-btn-close-opacity: .5;--bs-btn-close-hover-opacity: .75;--bs-btn-close-focus-shadow: 0 0 0 .25rem rgba(51,71,255,0.25);--bs-btn-close-focus-opacity: 1;--bs-btn-close-disabled-opacity: .25;--bs-btn-close-white-filter: invert(1) grayscale(100%) brightness(200%);box-sizing:content-box;width:1em;height:1em;padding:.25em .25em;color:var(--bs-btn-close-color);background:transparent var(--bs-btn-close-bg) center/1em auto no-repeat;border:0;border-radius:.375rem;opacity:var(--bs-btn-close-opacity)}.btn-close:hover{color:var(--bs-btn-close-color);text-decoration:none;opacity:var(--bs-btn-close-hover-opacity)}.btn-close:focus{outline:0;box-shadow:var(--bs-btn-close-focus-shadow);opacity:var(--bs-btn-close-focus-opacity)}.btn-close:disabled,.btn-close.disabled{pointer-events:none;-webkit-user-select:none;-moz-user-select:none;user-select:none;opacity:var(--bs-btn-close-disabled-opacity)}[data-bs-theme="dark"] .btn-close{filter:var(--bs-btn-close-white-filter)}.modal{--bs-modal-zindex: 1055;--bs-modal-width: 500px;--bs-modal-padding: 1rem;--bs-modal-margin: .5rem;--bs-modal-color: ;--bs-modal-bg: var(--bs-body-bg);--bs-modal-border-color: var(--bs-border-color-translucent);--bs-modal-border-width: var(--bs-border-width);--bs-modal-border-radius: var(--bs-border-radius-lg);--bs-modal-box-shadow: 0 0.125rem 0.25rem rgba(0,0,0,0.075);--bs-modal-inner-border-radius: calc(var(--bs-border-radius-lg) - (var(--bs-border-width)));--bs-modal-header-padding-x: 1rem;--bs-modal-header-padding-y: 1rem;--bs-modal-header-padding: 1rem 1rem;--bs-modal-header-border-color: var(--bs-border-color);--bs-modal-header-border-width: var(--bs-border-width);--bs-modal-title-line-height: 1.5;--bs-modal-footer-gap: .5rem;--bs-modal-footer-bg: ;--bs-modal-footer-border-color: var(--bs-border-color);--bs-modal-footer-border-width: var(--bs-border-width);position:fixed;top:0;left:0;z-index:var(--bs-modal-zindex);display:none;width:100%;height:100%;overflow-x:hidden;overflow-y:auto;outline:0}.modal-dialog{position:relative;width:auto;margin:var(--bs-modal-margin);pointer-events:none}.modal.fade .modal-dialog{transition:transform 0.3s ease-out;transform:translate(0, -50px)}@media (prefers-reduced-motion: reduce){.modal.fade .modal-dialog{transition:none}}.modal.show .modal-dialog{transform:none}.modal-dialog-scrollable{height:calc(100% - var(--bs-modal-margin) * 2)}.modal-dialog-scrollable .modal-content{max-height:100%;overflow:hidden}.modal-dialog-scrollable .modal-body{overflow-y:auto}.modal-content{position:relative;display:flex;flex-direction:column;width:100%;color:var(--bs-modal-color);pointer-events:auto;background-color:var(--bs-modal-bg);background-clip:padding-box;border:var(--bs-modal-border-width) solid var(--bs-modal-border-color);border-radius:var(--bs-modal-border-radius);outline:0}.modal-backdrop{--bs-backdrop-zindex: 1050;--bs-backdrop-bg: #000;--bs-backdrop-opacity: .5;position:fixed;top:0;left:0;z-index:var(--bs-backdrop-zindex);width:100vw;height:100vh;background-color:var(--bs-backdrop-bg)}.modal-backdrop.fade{opacity:0}.modal-backdrop.show{opacity:var(--bs-backdrop-opacity)}.modal-header{display:flex;flex-shrink:0;align-items:center;justify-content:space-between;padding:var(--bs-modal-header-padding);border-bottom:var(--bs-modal-header-border-width) solid var(--bs-modal-header-border-color);border-top-left-radius:var(--bs-modal-inner-border-radius);border-top-right-radius:var(--bs-modal-inner-border-radius)}.modal-header .btn-close{padding:calc(var(--bs-modal-header-padding-y) * .5) calc(var(--bs-modal-header-padding-x) * .5);margin:calc(-.5 * var(--bs-modal-header-padding-y)) calc(-.5 * var(--bs-modal-header-padding-x)) calc(-.5 * var(--bs-modal-header-padding-y)) auto}.modal-title{margin-bottom:0;line-height:var(--bs-modal-title-line-height)}.modal-body{position:relative;flex:1 1 auto;padding:var(--bs-modal-padding)}.modal-footer{display:flex;flex-shrink:0;flex-wrap:wrap;align-items:center;justify-content:flex-end;padding:calc(var(--bs-modal-padding) - var(--bs-modal-footer-gap) * .5);background-color:var(--bs-modal-footer-bg);border-top:var(--bs-modal-footer-border-width) solid var(--bs-modal-footer-border-color);border-bottom-right-radius:var(--bs-modal-inner-border-radius);border-bottom-left-radius:var(--bs-modal-inner-border-radius)}.modal-footer>*{margin:calc(var(--bs-modal-footer-gap) * .5)}@media (min-width: 576px){.modal{--bs-modal-margin: 1.75rem;--bs-modal-box-shadow: 0 0.5rem 1rem rgba(0,0,0,0.15)}.modal-dialog{max-width:var(--bs-modal-width);margin-right:auto;margin-left:auto}}@media (max-width: 767.98px){.modal-fullscreen-md-down{width:100vw;max-width:none;height:100%;margin:0}.modal-fullscreen-md-down .modal-content{height:100%;border:0;border-radius:0}.modal-fullscreen-md-down .modal-header,.modal-fullscreen-md-down .modal-footer{border-radius:0}.modal-fullscreen-md-down .modal-body{overflow-y:auto}}@keyframes spinner-border{to{transform:rotate(360deg) /* rtl:ignore */}}@keyframes spinner-grow{0%{transform:scale(0)}50%{opacity:1;transform:none}}.offcanvas{--bs-offcanvas-zindex: 1045;--bs-offcanvas-width: 332px;--bs-offcanvas-height: 30vh;--bs-offcanvas-padding-x: 1rem;--bs-offcanvas-padding-y: 1rem;--bs-offcanvas-color: var(--bs-body-color);--bs-offcanvas-bg: var(--bs-body-bg);--bs-offcanvas-border-width: var(--bs-border-width);--bs-offcanvas-border-color: var(--bs-border-color-translucent);--bs-offcanvas-box-shadow: 0 0.125rem 0.25rem rgba(0,0,0,0.075);--bs-offcanvas-transition: transform .3s ease-in-out;--bs-offcanvas-title-line-height: 1.5}.offcanvas{position:fixed;bottom:0;z-index:var(--bs-offcanvas-zindex);display:flex;flex-direction:column;max-width:100%;color:var(--bs-offcanvas-color);visibility:hidden;background-color:var(--bs-offcanvas-bg);background-clip:padding-box;outline:0;transition:var(--bs-offcanvas-transition)}@media (prefers-reduced-motion: reduce){.offcanvas{transition:none}}.offcanvas.offcanvas-start{top:0;left:0;width:var(--bs-offcanvas-width);border-right:var(--bs-offcanvas-border-width) solid var(--bs-offcanvas-border-color);transform:translateX(-100%)}.offcanvas.offcanvas-end{top:0;right:0;width:var(--bs-offcanvas-width);border-left:var(--bs-offcanvas-border-width) solid var(--bs-offcanvas-border-color);transform:translateX(100%)}.offcanvas.showing,.offcanvas.show:not(.hiding){transform:none}.offcanvas.showing,.offcanvas.hiding,.offcanvas.show{visibility:visible}.offcanvas-backdrop{position:fixed;top:0;left:0;z-index:1040;width:100vw;height:100vh;background-color:#000}.offcanvas-backdrop.fade{opacity:0}.offcanvas-backdrop.show{opacity:.5}.offcanvas-header{display:flex;align-items:center;justify-content:space-between;padding:var(--bs-offcanvas-padding-y) var(--bs-offcanvas-padding-x)}.offcanvas-header .btn-close{padding:calc(var(--bs-offcanvas-padding-y) * .5) calc(var(--bs-offcanvas-padding-x) * .5);margin-top:calc(-.5 * var(--bs-offcanvas-padding-y));margin-right:calc(-.5 * var(--bs-offcanvas-padding-x));margin-bottom:calc(-.5 * var(--bs-offcanvas-padding-y))}.offcanvas-title{margin-bottom:0;line-height:var(--bs-offcanvas-title-line-height)}.offcanvas-body{flex-grow:1;padding:var(--bs-offcanvas-padding-y) var(--bs-offcanvas-padding-x);overflow-y:auto}.placeholder{display:inline-block;min-height:1em;vertical-align:middle;cursor:wait;background-color:currentcolor;opacity:.5}.placeholder.btn::before{display:inline-block;content:""}@keyframes placeholder-glow{50%{opacity:.2}}@keyframes placeholder-wave{100%{-webkit-mask-position:-200% 0%;mask-position:-200% 0%}}.ratio{position:relative;width:100%}.ratio::before{display:block;padding-top:var(--bs-aspect-ratio);content:""}.ratio>*{position:absolute;top:0;left:0;width:100%;height:100%}.sticky-top{position:sticky;top:0;z-index:1020}.visually-hidden{width:1px !important;height:1px !important;padding:0 !important;margin:-1px !important;overflow:hidden !important;clip:rect(0, 0, 0, 0) !important;white-space:nowrap !important;border:0 !important}.visually-hidden:not(caption){position:absolute !important}.stretched-link::after{position:absolute;top:0;right:0;bottom:0;left:0;z-index:1;content:""}.d-flex{display:flex !important}.d-inline-flex{display:inline-flex !important}.d-none{display:none !important}.shadow{box-shadow:var(--bs-box-shadow) !important}.position-relative{position:relative !important}.border-0{border:0 !important}.w-100{width:100% !important}.w-auto{width:auto !important}.h-auto{height:auto !important}.flex-row{flex-direction:row !important}.flex-column{flex-direction:column !important}.flex-grow-1{flex-grow:1 !important}.justify-content-start{justify-content:flex-start !important}.justify-content-end{justify-content:flex-end !important}.justify-content-center{justify-content:center !important}.justify-content-between{justify-content:space-between !important}.align-items-center{align-items:center !important}.order-3{order:3 !important}.m-2{margin:.5rem !important}.mx-1{margin-right:.25rem !important;margin-left:.25rem !important}.mx-2{margin-right:.5rem !important;margin-left:.5rem !important}.mx-auto{margin-right:auto !important;margin-left:auto !important}.my-1{margin-top:.25rem !important;margin-bottom:.25rem !important}.my-2{margin-top:.5rem !important;margin-bottom:.5rem !important}.my-3{margin-top:1rem !important;margin-bottom:1rem !important}.mt-1{margin-top:.25rem !important}.mt-2{margin-top:.5rem !important}.mt-3{margin-top:1rem !important}.me-2{margin-right:.5rem !important}.me-auto{margin-right:auto !important}.mb-0{margin-bottom:0 !important}.mb-1{margin-bottom:.25rem !important}.mb-2{margin-bottom:.5rem !important}.mb-4{margin-bottom:1.5rem !important}.ms-2{margin-left:.5rem !important}.ms-3{margin-left:1rem !important}.ms-auto{margin-left:auto !important}.my-n3{margin-top:-1rem !important;margin-bottom:-1rem !important}.mt-n3{margin-top:-1rem !important}.p-0{padding:0 !important}.p-2{padding:.5rem !important}.px-0{padding-right:0 !important;padding-left:0 !important}.px-4{padding-right:1.5rem !important;padding-left:1.5rem !important}.py-2{padding-top:.5rem !important;padding-bottom:.5rem !important}.pe-4{padding-right:1.5rem !important}.pb-1{padding-bottom:.25rem !important}.pb-3{padding-bottom:1rem !important}.pb-4{padding-bottom:1.5rem !important}.fs-5{font-size:1.25rem !important}.fw-normal{font-weight:400 !important}.fw-bold{font-weight:700 !important}.text-end{text-align:right !important}.text-center{text-align:center !important}.text-decoration-none{text-decoration:none !important}.text-uppercase{text-transform:uppercase !important}.text-primary{--bs-text-opacity: 1;color:rgba(var(--bs-primary-rgb), var(--bs-text-opacity)) !important}.text-body{--bs-text-opacity: 1;color:rgba(var(--bs-body-color-rgb), var(--bs-text-opacity)) !important}.text-muted{--bs-text-opacity: 1;color:var(--bs-secondary-color) !important}.text-body-secondary{--bs-text-opacity: 1;color:var(--bs-secondary-color) !important}.text-reset{--bs-text-opacity: 1;color:inherit !important}.bg-primary{--bs-bg-opacity: 1;background-color:rgba(var(--bs-primary-rgb), var(--bs-bg-opacity)) !important}.bg-light{--bs-bg-opacity: 1;background-color:rgba(var(--bs-light-rgb), var(--bs-bg-opacity)) !important}.rounded{border-radius:var(--bs-border-radius) !important}.rounded-0{border-radius:0 !important}.rounded-circle{border-radius:50% !important}.rounded-pill{border-radius:var(--bs-border-radius-pill) !important}@media (min-width: 576px){.flex-sm-row{flex-direction:row !important}}@media (min-width: 768px){.d-md-block{display:block !important}.d-md-none{display:none !important}.flex-md-row{flex-direction:row !important}}@media (min-width: 992px){.d-lg-block{display:block !important}.d-lg-flex{display:flex !important}.d-lg-none{display:none !important}.flex-lg-row{flex-direction:row !important}.order-lg-2{order:2 !important}.order-lg-3{order:3 !important}.order-lg-4{order:4 !important}.me-lg-1{margin-right:.25rem !important}.me-lg-2{margin-right:.5rem !important}.me-lg-3{margin-right:1rem !important}.ms-lg-2{margin-left:.5rem !important}.text-lg-start{text-align:left !important}.text-lg-end{text-align:right !important}}@media (min-width: 1200px){.d-xl-block{display:block !important}.d-xl-none{display:none !important}.flex-xl-nowrap{flex-wrap:nowrap !important}.mx-xl-auto{margin-right:auto !important;margin-left:auto !important}}@font-face{font-family:Jost;font-style:normal;font-weight:400;font-display:swap;src:local("Jost Regular Regular"),local("Jost-Regular"),local("Jost* Book"),local("Jost-Book"),url("fonts/vendor/jost/jost-v4-latin-regular.woff2") format("woff2"),url("fonts/vendor/jost/jost-v4-latin-regular.woff") format("woff")}@font-face{font-family:Jost;font-style:normal;font-weight:500;font-display:swap;src:local("Jost Regular Medium"),local("JostRoman-Medium"),local("Jost* Medium"),local("Jost-Medium"),url("fonts/vendor/jost/jost-v4-latin-500.woff2") format("woff2"),url("fonts/vendor/jost/jost-v4-latin-500.woff") format("woff")}@font-face{font-family:Jost;font-style:normal;font-weight:700;font-display:swap;src:local("Jost Regular Bold"),local("JostRoman-Bold"),local("Jost* Bold"),local("Jost-Bold"),url("fonts/vendor/jost/jost-v4-latin-700.woff2") format("woff2"),url("fonts/vendor/jost/jost-v4-latin-700.woff") format("woff")}@font-face{font-family:Jost;font-style:italic;font-weight:400;font-display:swap;src:local("Jost Italic Italic"),local("Jost-Italic"),local("Jost* BookItalic"),local("Jost-BookItalic"),url("fonts/vendor/jost/jost-v4-latin-italic.woff2") format("woff2"),url("fonts/vendor/jost/jost-v4-latin-italic.woff") format("woff")}@font-face{font-family:Jost;font-style:italic;font-weight:500;font-display:swap;src:local("Jost Italic Medium Italic"),local("JostItalic-Medium"),local("Jost* Medium Italic"),local("Jost-MediumItalic"),url("fonts/vendor/jost/jost-v4-latin-500italic.woff2") format("woff2"),url("fonts/vendor/jost/jost-v4-latin-500italic.woff") format("woff")}@font-face{font-family:Jost;font-style:italic;font-weight:700;font-display:swap;src:local("Jost Italic Bold Italic"),local("JostItalic-Bold"),local("Jost* Bold Italic"),local("Jost-BoldItalic"),url("fonts/vendor/jost/jost-v4-latin-700italic.woff2") format("woff2"),url("fonts/vendor/jost/jost-v4-latin-700italic.woff") format("woff")}html[data-bs-theme="dark"] .icon-tabler-sun{display:block}html[data-bs-theme="dark"] .icon-tabler-moon{display:none}html[data-bs-theme="light"] .icon-tabler-sun{display:none}html[data-bs-theme="light"] .icon-tabler-moon{display:block}.privacy .content,.terms .content,.about .content,.contributors .content,.blog .content,.page .content,.error404 .content,.docs.list .content,.tutorial.list .content,.showcase.list .content,.categories.list .content,.tags.list .content,.list.section .content{padding-top:1rem;padding-bottom:3rem}.content img{max-width:100%}h6,.h6,h5,.h5,h4,.h4,h3,.h3,h2,.h2,h1,.h1{margin-top:2rem;margin-bottom:1rem}@media (min-width: 768px){body{font-size:1.125rem}h1,h2,h3,h4,h5,h6,.h1,.h2,.h3,.h4,.h5,.h6{margin-bottom:1.125rem}}.home h1,.home .h1{font-size:calc(1.875rem + 1.5vw);margin-top:-1rem}a:hover,a:focus{text-decoration:underline}.docs-navigation .card{transition:transform 0.3s}.docs-navigation .card:hover{transform:scale(1.025)}a.btn:hover,a.btn:focus{text-decoration:none}.section{padding-top:5rem;padding-bottom:5rem}body.section{padding-top:0;padding-bottom:0}.section-md{padding-top:3rem;padding-bottom:3rem}.section-sm{padding-top:1rem;padding-bottom:1rem}.docs-sidebar{order:2}@media (min-width: 992px){.docs-sidebar{order:0;border-right:1px solid #e9ecef}@supports (position: sticky){.docs-sidebar{position:sticky;top:4.25rem;z-index:1000;height:calc(100vh - 4.25rem)}.docs-sidebar-offset{top:4.5rem;height:calc(100vh - 4.5rem)}.docs-sidebar-top{position:static}}}@media (min-width: 1200px){.docs-sidebar{flex:0 1 320px}}.docs-links{padding-bottom:5rem}@media (min-width: 992px){@supports (position: sticky){.docs-links{max-height:calc(100vh - 4rem);overflow-y:scroll}}}@media (min-width: 992px){.docs-links{display:block;width:auto;margin-right:-1.5rem;padding-bottom:4rem}}.docs-toc{order:2}@supports (position: sticky){.docs-toc{position:sticky;top:4.25rem;height:calc(100vh - 4.25rem);overflow-y:auto}.docs-toc-offset{top:4.5rem;height:calc(100vh - 4.5rem)}.docs-toc-top{position:static}}.docs-content{padding-bottom:3rem;order:1}.docs-navigation{border-top:1px solid #e9ecef;margin-top:2rem;margin-bottom:0;padding-top:2rem}.docs-navigation a{font-size:.9rem}@media (min-width: 992px){.docs-navigation{margin-bottom:-1rem}.docs-navigation a{font-size:1rem}}.docs-navigation a:hover,.docs-navigation a:focus{text-decoration:none}.navbar a:hover,.navbar a:focus{text-decoration:none}#TableOfContents ul,#toc ul{padding-left:0;list-style:none}#toc a.active{color:#3347ff;font-weight:500}.section-features{padding-top:2rem}.bg-dots{background-image:radial-gradient(#dee2e6 15%, transparent 15%);background-position:0 0;background-size:1rem 1rem;-webkit-mask:linear-gradient(to top, #fff, transparent);mask:linear-gradient(to top, #fff, transparent);width:100%;height:11rem;margin-top:-10rem;z-index:-1}.bg-dots-md{margin-top:-11rem}.bg-dots-lg{margin-top:-12rem}.gradient-text{background-color:#3347ff;background-image:linear-gradient(90deg, #3347ff, #b3c7ff 50%, var(--sl-color-blue));background-size:100%;background-repeat:repeat;-webkit-background-clip:text;-moz-background-clip:text;-webkit-text-fill-color:transparent;-moz-text-fill-color:transparent}.katex{font-size:1.125rem}.card-bar{border-top:4px solid;border-image-source:linear-gradient(90deg, #3347ff, #b3c7ff 50%, var(--sl-color-blue));border-image-slice:1}.modal-backdrop{background-color:#fff}.modal-backdrop.show{opacity:0.7}@media (min-width: 768px){.modal-backdrop.show{opacity:0}}sup[id]::after{display:block;height:6rem;margin-top:-6rem;content:""}a.footnote-backref{text-decoration:none}li input[type="checkbox"]{margin:0.25rem;border:1px solid #ced4da}li input[type="checkbox"]:disabled{pointer-events:none;filter:none;opacity:1}li input[type="checkbox"]:checked{background-color:#5d2f86;border-color:#5d2f86}[data-bs-theme="dark"] li input[type="checkbox"]{border:1px solid #6c757d}[data-bs-theme="dark"] li input[type="checkbox"]:checked{background-color:#b3c7ff;border-color:#b3c7ff;--bs-form-check-bg-image: url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3e%3cpath fill='none' stroke='%231d2d35' stroke-linecap='round' stroke-linejoin='round' stroke-width='3' d='m6 10 3 3 6-6'/%3e%3c/svg%3e")}.content .svg-inline{margin-bottom:1.5rem}.content .svg-inline:not(.svg-inline-custom){height:1.875rem;width:1.875rem;stroke-width:1.5}.logo-netlify-large-fullcolor-darkmode{display:none}[data-bs-theme="dark"] .logo-netlify-large-fullcolor-darkmode{display:block}.svg-lightmode{display:block}.svg-darkmode{display:none}.svg-monochrome path{fill:#1d2d35}[data-bs-theme="dark"] .svg-lightmode{display:none}[data-bs-theme="dark"] .svg-darkmode{display:block}[data-bs-theme="dark"] .svg-monochrome path{fill:var(--sl-color-gray-1)}hr{border-color:gray}[data-bs-theme="dark"] hr{border-color:var(--sl-color-gray-3)}[data-bs-theme="dark"] h1,[data-bs-theme="dark"] .h1,[data-bs-theme="dark"] h2,[data-bs-theme="dark"] .h2,[data-bs-theme="dark"] h3,[data-bs-theme="dark"] .h3,[data-bs-theme="dark"] h4,[data-bs-theme="dark"] .h4{color:#fff}[data-bs-theme="dark"] body{background:#17181c;color:#c1c3c8}[data-bs-theme="dark"] a{color:#b3c7ff}[data-bs-theme="dark"] .callout a{color:inherit}[data-bs-theme="dark"] .btn-primary{--bs-btn-color: #000;--bs-btn-bg: #b3c7ff;--bs-btn-border-color: #b3c7ff;--bs-btn-hover-color: #000;--bs-btn-hover-bg: #becfff;--bs-btn-hover-border-color: #bacdff;--bs-btn-focus-shadow-rgb: 152,169,217;--bs-btn-active-color: #000;--bs-btn-active-bg: #c2d2ff;--bs-btn-active-border-color: #bacdff;--bs-btn-active-shadow: inset 0 3px 5px rgba(0,0,0,0.125);--bs-btn-disabled-color: #000;--bs-btn-disabled-bg: #b3c7ff;--bs-btn-disabled-border-color: #b3c7ff;color:#17181c}[data-bs-theme="dark"] .navbar{background-color:rgba(23,24,28,0.95);border-bottom:1px solid #23262f}[data-bs-theme="dark"] body.home .navbar{border-bottom:0}[data-bs-theme="dark"] .offcanvas-header{border-bottom:1px solid #343a40}[data-bs-theme="dark"] .offcanvas .nav-link{color:#c1c3c8}[data-bs-theme="dark"] .offcanvas .nav-link:hover,[data-bs-theme="dark"] .offcanvas .nav-link:focus{color:#b3c7ff}[data-bs-theme="dark"] .offcanvas .nav-link.active{color:#b3c7ff}[data-bs-theme="dark"] .alert-primary a{color:#17181c}[data-bs-theme="dark"] .alert-doks{background:#23262f;color:#c1c3c8}[data-bs-theme="dark"] .alert-doks a{color:#b3c7ff}[data-bs-theme="dark"] .page-links a{color:#c1c3c8}[data-bs-theme="dark"] .btn-toggle-nav a{color:#c1c3c8}[data-bs-theme="dark"] .docs-link:hover,[data-bs-theme="dark"] .docs-link.active,[data-bs-theme="dark"] .page-links a:hover{text-decoration:none;color:#b3c7ff}[data-bs-theme="dark"] .btn-toggle{color:#c1c3c8;background-color:transparent;border:0}[data-bs-theme="dark"] .btn-toggle:hover,[data-bs-theme="dark"] .btn-toggle:focus{color:#c1c3c8}[data-bs-theme="dark"] .btn-toggle::before{width:1.25em;line-height:0;content:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' width='14' height='14' viewBox='0 0 16 16'%3e%3cpath fill='none' stroke='rgba%28222, 226, 230, 0.75%29' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M5 14l6-6-6-6'/%3e%3c/svg%3e");transition:transform 0.35s ease;transform-origin:0.5em 50%;margin-bottom:0.125rem}[data-bs-theme="dark"] .btn-toggle[aria-expanded="true"]{color:#c1c3c8}[data-bs-theme="dark"] .btn-toggle[aria-expanded="true"]::before{transform:rotate(90deg)}[data-bs-theme="dark"] .btn-toggle-nav a:hover,[data-bs-theme="dark"] .btn-toggle-nav a:focus{color:#b3c7ff}[data-bs-theme="dark"] .btn-toggle-nav a.active{color:#b3c7ff}[data-bs-theme="dark"] .navbar .btn-link{color:#c1c3c8}[data-bs-theme="dark"] .content .btn-link{color:#b3c7ff}[data-bs-theme="dark"] .content .btn-link:hover{color:#b3c7ff}[data-bs-theme="dark"] .navbar .btn-link:hover{color:#b3c7ff}[data-bs-theme="dark"] .navbar .btn-link:active{color:#b3c7ff}[data-bs-theme="dark"] .form-control{color:#dee2e6}[data-bs-theme="dark"] .form-control::-moz-placeholder{color:#ced4da;opacity:1}[data-bs-theme="dark"] .form-control::placeholder{color:#ced4da;opacity:1}@media (min-width: 992px){[data-bs-theme="dark"] .docs-sidebar{order:0;border-right:1px solid #23262f}}[data-bs-theme="dark"] .docs-navigation{border-top:1px solid #23262f}[data-bs-theme="dark"] pre code::-webkit-scrollbar-thumb{background:#ced4da}[data-bs-theme="dark"] code:not(.hljs){background:#23262f;color:#c1c3c8}[data-bs-theme="dark"] pre code:hover{scrollbar-width:thin;scrollbar-color:#23262f transparent}[data-bs-theme="dark"] pre code::-webkit-scrollbar-thumb:hover{background:#adb5bd}[data-bs-theme="dark"] .footer{border-top:1px solid #23262f}[data-bs-theme="dark"] .docs-links,[data-bs-theme="dark"] .docs-toc{scrollbar-width:thin;scrollbar-color:#17181c #17181c}[data-bs-theme="dark"] .docs-links::-webkit-scrollbar,[data-bs-theme="dark"] .docs-toc::-webkit-scrollbar{width:5px}[data-bs-theme="dark"] .docs-links::-webkit-scrollbar-track,[data-bs-theme="dark"] .docs-toc::-webkit-scrollbar-track{background:#17181c}[data-bs-theme="dark"] .docs-links::-webkit-scrollbar-thumb,[data-bs-theme="dark"] .docs-toc::-webkit-scrollbar-thumb{background:#17181c}[data-bs-theme="dark"] .docs-links:hover,[data-bs-theme="dark"] .docs-toc:hover{scrollbar-width:thin;scrollbar-color:#23262f #17181c}[data-bs-theme="dark"] .docs-links:hover::-webkit-scrollbar-thumb,[data-bs-theme="dark"] .docs-toc:hover::-webkit-scrollbar-thumb{background:#23262f}[data-bs-theme="dark"] .docs-links::-webkit-scrollbar-thumb:hover,[data-bs-theme="dark"] .docs-toc::-webkit-scrollbar-thumb:hover{background:#23262f}[data-bs-theme="dark"] .docs-links h3:not(:first-child),[data-bs-theme="dark"] .docs-links .h3:not(:first-child){border-top:1px solid #23262f}[data-bs-theme="dark"] a.docs-link{color:#c1c3c8}[data-bs-theme="dark"] .page-links li:not(:first-child){border-top:1px dashed #23262f}[data-bs-theme="dark"] .card{background:#17181c;border:1px solid #23262f}[data-bs-theme="dark"] .card.bg-light{background:#23262f !important}[data-bs-theme="dark"] .bg-light{background:#141518 !important}[data-bs-theme="dark"] .bg-dots{background-image:radial-gradient(#414349 15%, transparent 15%)}[data-bs-theme="dark"] .text-muted{color:#adafb6 !important}[data-bs-theme="dark"] .alert-primary{background:#b3c7ff;color:#17181c}[data-bs-theme="dark"] .offcanvas{background-color:#17181c}[data-bs-theme="dark"] .alert-dismissible .btn-close{background-image:url("data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNCIgaGVpZ2h0PSIyNCIgdmlld0JveD0iMCAwIDI0IDI0IiBmaWxsPSJub25lIiBzdHJva2U9IiNkZWUyZTYiIHN0cm9rZS13aWR0aD0iMiIgc3Ryb2tlLWxpbmVjYXA9InJvdW5kIiBzdHJva2UtbGluZWpvaW49InJvdW5kIiBjbGFzcz0iZmVhdGhlciBmZWF0aGVyLXgiPjxsaW5lIHgxPSIxOCIgeTE9IjYiIHgyPSI2IiB5Mj0iMTgiPjwvbGluZT48bGluZSB4MT0iNiIgeTE9IjYiIHgyPSIxOCIgeTI9IjE4Ij48L2xpbmU+PC9zdmc+");background-size:1.5rem}[data-bs-theme="dark"] .dropdown-item{color:#17181c}[data-bs-theme="dark"] .dropdown-menu{background:#23262f}[data-bs-theme="dark"] .dropdown-menu .dropdown-item{color:#c1c3c8}[data-bs-theme="dark"] .dropdown-menu .dropdown-item.untranslated{color:#6c757d;text-decoration:line-through}[data-bs-theme="dark"] .dropdown-menu .dropdown-item.untranslated:focus-visible,[data-bs-theme="dark"] .dropdown-menu .dropdown-item.untranslated:hover{background-image:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' class='icon icon-tabler icon-tabler-home' width='24' height='24' viewBox='0 0 24 24' stroke-width='2' stroke='%23b3c7ff' fill='none' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath stroke='none' d='M0 0h24v24H0z' fill='none'/%3E%3Cpath d='M5 12l-2 0l9 -9l9 9l-2 0' /%3E%3Cpath d='M5 12v7a2 2 0 0 0 2 2h10a2 2 0 0 0 2 -2v-7' /%3E%3Cpath d='M9 21v-6a2 2 0 0 1 2 -2h2a2 2 0 0 1 2 2v6' /%3E%3C/svg%3E");background-repeat:no-repeat;background-position:right 1rem top 0.6rem;background-size:0.9rem 0.9rem;text-decoration:unset}[data-bs-theme="dark"] .dropdown-menu .dropdown-item:hover{color:#b3c7ff;background:#17181c}[data-bs-theme="dark"] .dropdown-menu .dropdown-item.active,[data-bs-theme="dark"] .dropdown-menu .dropdown-item:focus{color:#b3c7ff;background:#17181c}[data-bs-theme="dark"] .navbar .dropdown-item.current{background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 8 8'%3e%3cpath fill='%23dee2e6' d='M2.3 6.73L.6 4.53c-.4-1.04.46-1.4 1.1-.8l1.1 1.4 3.4-3.8c.6-.63 1.6-.27 1.2.7l-4 4.6c-.43.5-.8.4-1.1.1z'/%3e%3c/svg%3e");background-repeat:no-repeat;background-position:right 1rem top 0.6rem;background-size:0.75rem 0.75rem}[data-bs-theme="dark"] details{border:1px solid #23262f}[data-bs-theme="dark"] summary:hover{background:#23262f}[data-bs-theme="dark"] details[open]>summary{border-bottom:1px solid #23262f}[data-bs-theme="dark"] details summary::after{content:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' width='14' height='14' viewBox='0 0 16 16'%3e%3cpath fill='none' stroke='rgba%28222, 226, 230, 0.75%29' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M5 14l6-6-6-6'/%3e%3c/svg%3e")}[data-bs-theme="dark"] #toc a.active{color:#b3c7ff}[data-bs-theme="dark"] .btn-light{color:#b3c7ff;background:#23262f;border:1px solid #23262f}[data-bs-theme="dark"] table th{color:#fff}[data-bs-theme="dark"] table,[data-bs-theme="dark"] [data-bs-theme="dark"] table{--bs-table-color: inherit;--bs-table-bg: $body-bg-dark;background:#17181c;border-color:#23262f}.alert{font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace;font-size:.875rem}.alert-icon{margin-right:0.75rem}.docs main .alert{margin:2rem -1.5rem}.alert .alert-link,.alert .callout a,.callout .alert a{text-decoration:underline}.alert-doks{background:#fbf7f0;color:#1d2d35}.alert-white{background-color:rgba(255,255,255,0.95)}.alert-primary{color:#fff;background-color:#3347ff}.alert a{text-decoration:underline}.alert-primary .alert-link,.alert-primary .callout a,.callout .alert-primary a{color:#fff}.alert-secondary{color:#41464b;background-color:#e2e3e5;border-color:#d3d6d8}.alert-secondary .alert-link,.alert-secondary .callout a,.callout .alert-secondary a{color:#34383c}.alert-success{color:#0f5132;background-color:#d1e7dd;border-color:#badbcc}.alert-success .alert-link,.alert-success .callout a,.callout .alert-success a{color:#0c4128}.alert-info{color:#055160;background-color:#cff4fc;border-color:#b6effb}.alert-info .alert-link,.alert-info .callout a,.callout .alert-info a{color:#04414d}.alert-warning{color:#664d03;background-color:#fff3cd;border-color:#ffecb5}.alert-warning .alert-link,.alert-warning .callout a,.callout .alert-warning a{color:#523e02}.alert-danger{color:#842029;background-color:#f8d7da;border-color:#f5c2c7}.alert-danger .alert-link,.alert-danger .callout a,.callout .alert-danger a{color:#6a1a21}.alert-light{color:#636464;background-color:#fefefe;border-color:#fdfdfe}.alert-light .alert-link,.alert-light .callout a,.callout .alert-light a{color:#4f5050}.alert-dark{color:#141619;background-color:#d3d3d4;border-color:#bcbebf}.alert-dark .alert-link,.alert-dark .callout a,.callout .alert-dark a{color:#101214}.alert .alert-link:hover,.alert .callout a:hover,.callout .alert a:hover,.alert .alert-link:focus,.alert .callout a:focus,.callout .alert a:focus{text-decoration:none}.alert-text{margin-right:-3rem;font-size:1rem}.alert-dismissible .btn-close{position:absolute;top:50%;transform:translateY(-50%);right:1rem;z-index:2;padding:0.5rem;background-image:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='32' height='32' viewBox='0 0 24 24' fill='none' stroke='currentColor' stroke-width='2' stroke-linecap='round' stroke-linejoin='round' class='feather feather-x'%3E%3Cline x1='18' y1='6' x2='6' y2='18'%3E%3C/line%3E%3Cline x1='6' y1='6' x2='18' y2='18'%3E%3C/line%3E%3C/svg%3E");background-size:1.5rem;filter:invert(1) grayscale(100%) brightness(200%)}.btn-close:focus,.btn-close:active{outline:none;box-shadow:none}@media (min-width: 768px){.alert-dismissible .btn-close{background-size:1.5rem}}[data-global-alert="closed"] #announcement{display:none}.alert code{background:#f6ecdc;color:#1d2d35;padding:0.25rem 0.5rem}.navbar .btn-link{color:rgba(var(--bs-emphasis-color-rgb), 0.65);padding:0.4375rem 0}#mode{padding:0.5rem}.btn-link:focus{outline:0;box-shadow:none}#navigation{margin-left:1.25rem}@media (min-width: 992px){#mode{margin-left:0.5rem;margin-right:0.25rem}.navbar .btn-link{padding:0.5625em 0.25rem 0.5rem 0.125rem}}.navbar .btn-link:hover{color:rgba(var(--bs-emphasis-color-rgb), 0.8)}.navbar .btn-link:active{color:rgba(var(--bs-emphasis-color-rgb), 1)}body .toggle-dark{display:block}body .toggle-light{display:none}[data-dark-mode] body .toggle-light{display:block}[data-dark-mode] body .toggle-dark{display:none}.collapsible-sidebar{margin:2.125rem 0}.btn-toggle{display:inline-flex;align-items:center;padding:0.25rem 0.5rem 0.25rem 0;font-weight:700;font-size:1rem;text-transform:uppercase;color:#1d2d35;background-color:transparent;border:0}.btn-toggle:hover,.btn-toggle:focus{color:#1d2d35;background-color:transparent;outline:0;box-shadow:none}.btn-toggle::before{width:1.25em;line-height:0;content:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' width='14' height='14' viewBox='0 0 16 16'%3e%3cpath fill='none' stroke='rgba%2829, 45, 53, 0.75%29' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M5 14l6-6-6-6'/%3e%3c/svg%3e");transition:transform 0.35s ease;transform-origin:0.5em 50%;margin-bottom:0.125rem}.btn-toggle[aria-expanded="true"]{color:#1d2d35}.btn-toggle[aria-expanded="true"]::before{transform:rotate(90deg)}.btn-toggle-nav a{display:inline-flex;padding:0.1875rem 0.5rem;margin-top:0.125rem;margin-left:1.25rem;text-decoration:none}.btn-toggle-nav a:hover,.btn-toggle-nav a:focus{background-color:transparent;color:#3347ff}.btn-toggle-nav a.active{color:#3347ff}@media (max-width: 991.98px){.dropdown-menu{width:100%;position:static}}.btn-dropdown{border:0}@media (max-width: 991.98px){.btn-dropdown{width:100%;text-align:left;padding-left:0;padding-right:0}}.navbar .dropdown-item.current{font-weight:600;background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 8 8'%3e%3cpath fill='%23292b2c' d='M2.3 6.73L.6 4.53c-.4-1.04.46-1.4 1.1-.8l1.1 1.4 3.4-3.8c.6-.63 1.6-.27 1.2.7l-4 4.6c-.43.5-.8.4-1.1.1z'/%3e%3c/svg%3e");background-repeat:no-repeat;background-position:right 1rem top 0.6rem;background-size:0.75rem 0.75rem}@media (max-width: 991.98px){.navbar .dropdown-item.current{background-position:right 0.375rem top 0.6rem}}.btn-close{background-image:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='32' height='32' viewBox='0 0 24 24' fill='none' stroke='currentColor' stroke-width='2' stroke-linecap='round' stroke-linejoin='round' class='feather feather-x'%3E%3Cline x1='18' y1='6' x2='6' y2='18'%3E%3C/line%3E%3Cline x1='6' y1='6' x2='18' y2='18'%3E%3C/line%3E%3C/svg%3E");background-size:1.5rem}.offcanvas-header .btn-close{margin-right:0 !important}.dropdown-toggle::after{display:none}.dropdown-caret{margin-left:-0.1875rem;margin-right:-0.3125rem}.dropdown-menu .dropdown-item.untranslated{color:#6c757d;text-decoration:line-through}.dropdown-menu .dropdown-item.untranslated:focus-visible,.dropdown-menu .dropdown-item.untranslated:hover{background-image:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' class='icon icon-tabler icon-tabler-home' width='24' height='24' viewBox='0 0 24 24' stroke-width='2' stroke='%233347ff' fill='none' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath stroke='none' d='M0 0h24v24H0z' fill='none'/%3E%3Cpath d='M5 12l-2 0l9 -9l9 9l-2 0' /%3E%3Cpath d='M5 12v7a2 2 0 0 0 2 2h10a2 2 0 0 0 2 -2v-7' /%3E%3Cpath d='M9 21v-6a2 2 0 0 1 2 -2h2a2 2 0 0 1 2 2v6' /%3E%3C/svg%3E");background-repeat:no-repeat;background-position:right 1rem top 0.6rem;background-size:0.9rem 0.9rem;text-decoration:unset}.dropdown-menu .dropdown-item:hover{color:#3347ff}.dropdown-menu span.dropdown-item.current:hover{color:unset}.clipboard{position:relative;float:right}.btn-clipboard{transition:opacity 0.25s ease-in-out;opacity:0;position:absolute;right:0.5rem;top:0.5rem;line-height:1;padding:0.3125rem 0.3125rem 0.1875rem;background-color:transparent;border-color:transparent}@media (max-width: 767.98px){.btn-clipboard{position:absolute;right:-0.5rem;top:0.5rem}}.btn-clipboard::after{width:22px;height:22px;display:inline-block;content:'';-webkit-mask:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' class='icon icon-tabler icon-tabler-copy' width='22' height='22' viewBox='0 0 24 24' stroke-width='1' stroke='currentColor' fill='none' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath stroke='none' d='M0 0h24v24H0z' fill='none'%3E%3C/path%3E%3Cpath d='M8 8m0 2a2 2 0 0 1 2 -2h8a2 2 0 0 1 2 2v8a2 2 0 0 1 -2 2h-8a2 2 0 0 1 -2 -2z'%3E%3C/path%3E%3Cpath d='M16 8v-2a2 2 0 0 0 -2 -2h-8a2 2 0 0 0 -2 2v8a2 2 0 0 0 2 2h2'%3E%3C/path%3E%3C/svg%3E") no-repeat 50% 50%;mask:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' class='icon icon-tabler icon-tabler-copy' width='22' height='22' viewBox='0 0 24 24' stroke-width='1' stroke='currentColor' fill='none' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath stroke='none' d='M0 0h24v24H0z' fill='none'%3E%3C/path%3E%3Cpath d='M8 8m0 2a2 2 0 0 1 2 -2h8a2 2 0 0 1 2 2v8a2 2 0 0 1 -2 2h-8a2 2 0 0 1 -2 -2z'%3E%3C/path%3E%3Cpath d='M16 8v-2a2 2 0 0 0 -2 -2h-8a2 2 0 0 0 -2 2v8a2 2 0 0 0 2 2h2'%3E%3C/path%3E%3C/svg%3E") no-repeat 50% 50%;-webkit-mask-size:cover;mask-size:cover;background-color:#495057}.btn-clipboard:hover{border-color:transparent}.btn-clipboard:hover::after{width:22px;height:22px;display:inline-block;content:'';-webkit-mask:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' class='icon icon-tabler icon-tabler-copy' width='22' height='22' viewBox='0 0 24 24' stroke-width='1' stroke='currentColor' fill='none' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath stroke='none' d='M0 0h24v24H0z' fill='none'%3E%3C/path%3E%3Cpath d='M8 8m0 2a2 2 0 0 1 2 -2h8a2 2 0 0 1 2 2v8a2 2 0 0 1 -2 2h-8a2 2 0 0 1 -2 -2z'%3E%3C/path%3E%3Cpath d='M16 8v-2a2 2 0 0 0 -2 -2h-8a2 2 0 0 0 -2 2v8a2 2 0 0 0 2 2h2'%3E%3C/path%3E%3C/svg%3E") no-repeat 50% 50%;mask:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' class='icon icon-tabler icon-tabler-copy' width='22' height='22' viewBox='0 0 24 24' stroke-width='1' stroke='currentColor' fill='none' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath stroke='none' d='M0 0h24v24H0z' fill='none'%3E%3C/path%3E%3Cpath d='M8 8m0 2a2 2 0 0 1 2 -2h8a2 2 0 0 1 2 2v8a2 2 0 0 1 -2 2h-8a2 2 0 0 1 -2 -2z'%3E%3C/path%3E%3Cpath d='M16 8v-2a2 2 0 0 0 -2 -2h-8a2 2 0 0 0 -2 2v8a2 2 0 0 0 2 2h2'%3E%3C/path%3E%3C/svg%3E") no-repeat 50% 50%;-webkit-mask-size:cover;mask-size:cover;background-color:#212529}.btn-clipboard:focus,.btn-clipboard:active{border-color:transparent !important}.btn-clipboard:focus::after,.btn-clipboard:active::after{width:22px;height:22px;display:inline-block;content:'';-webkit-mask:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='22' height='22' viewBox='0 0 24 24' stroke-width='1.25' stroke='currentColor' fill='none' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath stroke='none' d='M0 0h24v24H0z' fill='none'%3E%3C/path%3E%3Cpath d='M5 12l5 5l10 -10'%3E%3C/path%3E%3C/svg%3E") no-repeat 50% 50%;mask:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='22' height='22' viewBox='0 0 24 24' stroke-width='1.25' stroke='currentColor' fill='none' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath stroke='none' d='M0 0h24v24H0z' fill='none'%3E%3C/path%3E%3Cpath d='M5 12l5 5l10 -10'%3E%3C/path%3E%3C/svg%3E") no-repeat 50% 50%;-webkit-mask-size:cover;mask-size:cover;background-color:#212529}[data-bs-theme="dark"] .btn-clipboard{background-color:transparent;border-color:transparent}[data-bs-theme="dark"] .btn-clipboard::after{background-color:#ced4da}[data-bs-theme="dark"] .btn-clipboard:hover{border-color:transparent}[data-bs-theme="dark"] .btn-clipboard:hover::after{background-color:#e9ecef}[data-bs-theme="dark"] .btn-clipboard:focus,[data-bs-theme="dark"] .btn-clipboard:active{border-color:transparent}[data-bs-theme="dark"] .btn-clipboard:focus::after,[data-bs-theme="dark"] .btn-clipboard:active::after{background-color:#e9ecef}.highlight{position:relative}@media (min-width: 768px){.highlight:hover .btn-clipboard{opacity:1}}#toTop{opacity:0;transition:opacity 0.3s ease-in-out}#toTop.fade{opacity:1}.btn-cta{padding-left:2rem;padding-right:2rem}.callout{--bs-link-color-rgb: var(--callout-link);--bs-code-color: var(--callout-code-color);padding:1.25rem;margin-top:1.5rem;margin-bottom:1.5rem;color:var(--callout-color, inherit);background-color:var(--callout-bg, var(--bs-gray-100));border-left:0.25rem solid var(--callout-border, var(--bs-gray-300));border-radius:0}.callout h4,.callout .h4{margin-top:0;margin-bottom:.25rem}.callout>:last-child{margin-bottom:0}.callout+.callout{margin-top:-.25rem}.callout .svg-inline{position:relative;margin:-0.375rem 0 0}.callout .callout-title{display:block;margin-bottom:0.25rem;font-weight:700;font-size:1.125rem}@media (min-width: 992px){.callout .callout-title{font-size:1.25rem}}.callout .callout-title .svg-inline{margin-right:0.5rem}.callout code{background:transparent;color:inherit}.callout a{font-weight:500}.callout .highlight{background-color:rgba(0,0,0,0.05)}.callout.callout-note{border-color:var(--sl-color-blue);background-color:var(--sl-color-blue-high)}.callout.callout-note .callout-title{color:var(--sl-color-blue-low)}.callout.callout-note code{background:#d6daff}.callout.callout-tip{border-color:var(--sl-color-purple);background-color:var(--sl-color-purple-high)}.callout.callout-tip .callout-title{color:var(--sl-color-purple-low)}.callout.callout-tip code{background:#f2ddfc}.callout.callout-caution{border-color:var(--sl-color-orange);background-color:var(--sl-color-orange-high)}.callout.callout-caution .callout-title{color:var(--sl-color-orange-low)}.callout.callout-caution code{background:#fcf2dd}.callout.callout-danger{border-color:var(--sl-color-red);background-color:var(--sl-color-red-high)}.callout.callout-danger .callout-title{color:var(--sl-color-red-low)}.callout.callout-danger code{background:#fcdde7}.callout.callout-light code{background:var(--sl-color-gray-1)}[data-bs-theme="dark"] .callout{color:var(--sl-color-gray-1)}[data-bs-theme="dark"] .callout.callout-note{border-color:var(--sl-color-blue);background-color:var(--sl-color-blue-low)}[data-bs-theme="dark"] .callout.callout-note .callout-title{color:var(--sl-color-blue-high)}[data-bs-theme="dark"] .callout.callout-note code{background:#0d1240}[data-bs-theme="dark"] .callout.callout-tip{border-color:var(--sl-color-purple);background-color:var(--sl-color-purple-low)}[data-bs-theme="dark"] .callout.callout-tip .callout-title{color:var(--sl-color-purple-high)}[data-bs-theme="dark"] .callout.callout-tip code{background:#2f153c}[data-bs-theme="dark"] .callout.callout-caution{border-color:var(--sl-color-orange);background-color:var(--sl-color-orange-low)}[data-bs-theme="dark"] .callout.callout-caution .callout-title{color:var(--sl-color-orange-high)}[data-bs-theme="dark"] .callout.callout-caution code{background:#3c2f15}[data-bs-theme="dark"] .callout.callout-danger{border-color:var(--sl-color-red);background-color:var(--sl-color-red-low)}[data-bs-theme="dark"] .callout.callout-danger .callout-title{color:var(--sl-color-red-high)}[data-bs-theme="dark"] .callout.callout-danger code{background:#3c1522}pre,code,kbd,samp{font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace;font-size:.875rem;border-radius:.375rem}code{background:#fbf7f0;color:#1d2d35;padding:0.25rem 0.5rem}pre{margin:2rem 0}pre code{display:block;overflow-x:auto;line-height:1.5;padding:1.25rem 1.5rem;-moz-tab-size:4;-o-tab-size:4;tab-size:4;scrollbar-width:thin;scrollbar-color:transparent transparent}.hljs{padding:1.5rem !important}@media (max-width: 575.98px){pre,code,kbd,samp{border-radius:0}pre{margin:2rem -1.5rem}}pre code::-webkit-scrollbar{height:5px}pre code::-webkit-scrollbar-thumb{background:#ced4da}pre code:hover{scrollbar-width:thin;scrollbar-color:#adb5bd transparent}pre code::-webkit-scrollbar-thumb:hover{background:#adb5bd}code.language-mermaid{background:none}.line .ln{margin-right:1rem}.line.hl{color:var(--sl-color-blue)}[data-bs-theme="dark"] .line.hl{color:#fcf2dd}details{display:block;position:relative;border:1px solid #e9ecef;border-radius:0.25rem;padding:0.5rem 1rem 0;margin:0.5rem 0}summary{list-style:none;display:inline-block;width:calc(100% + 2rem);margin:-0.5rem -1rem 0;padding:0.5rem 1rem}summary::-webkit-details-marker{display:none}summary:hover{background:#f8f9fa}details summary::after{display:inline-block;content:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' width='14' height='14' viewBox='0 0 16 16'%3e%3cpath fill='none' stroke='rgba%2829, 45, 53, 0.75%29' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M5 14l6-6-6-6'/%3e%3c/svg%3e");transition:transform 0.35s ease;transform-origin:center center;position:absolute;right:1rem}details[open]>summary::after{transform:rotate(90deg)}details[open]{padding:0.5rem 1rem}details[open]>summary{border-bottom:1px solid #dee2e6;margin-bottom:0.5rem}details h2,details .h2,details h3,details .h3,details h4,details .h4{margin:1rem 0 0.5rem}details p:last-child{margin-bottom:0}details ul,details ol{margin-bottom:0}details pre{margin:0 0 1rem}.search-form label{font-weight:normal}img[data-sizes="auto"]{display:block;width:100%}.figure{display:block}.blur-up{filter:blur(5px);transition:filter 400ms}.blur-up.lazyloaded{filter:unset}.mermaid{margin:1.5rem 0;padding:1.5rem}.mermaid svg{height:auto}.search-form .form-control:focus{border:2px solid #3347ff}[data-bs-theme="dark"] .search-form .form-control:focus{border:2px solid #b3c7ff}[data-bs-theme="dark"] .search-form .btn-link{color:#b3c7ff}.search-form .btn-link,.modal-body p.message,.modal-footer{font-size:.875rem}.modal-body::-webkit-scrollbar{width:0.25rem}.modal-body::-webkit-scrollbar-track{background-color:#f1f1f1}.modal-body::-webkit-scrollbar-thumb{background-color:#c1c1c1}[data-bs-theme="dark"] .modal-body::-webkit-scrollbar-track{background-color:#424242}[data-bs-theme="dark"] .modal-body::-webkit-scrollbar-thumb{background-color:#686868}@media (min-width: 768px){#searchModal .modal-dialog{max-height:40rem}}.search-result h2,.search-result .h2{margin-top:0}.search-result a:focus{outline:0 none}.search-result:hover .card,.search-result.selected .card{background-color:#3347ff;color:#fff}[data-bs-theme="dark"] .search-result:hover .card,[data-bs-theme="dark"] .search-result.selected .card{background-color:#b3c7ff;color:#23262f}[data-bs-theme="dark"] .search-result:hover .card h2,[data-bs-theme="dark"] .search-result:hover .card .h2,[data-bs-theme="dark"] .search-result.selected .card h2,[data-bs-theme="dark"] .search-result.selected .card .h2{color:#17181c}.search-result .submitted{font-size:.875rem;margin-top:0.5rem}.search-result .content{margin-top:0.5rem;padding-top:0 !important;padding-bottom:0 !important}.navbar-form{position:relative}#suggestions{position:absolute;right:0;margin-top:0.5rem;width:calc(100vw - 3rem);max-width:calc(400px - 3rem);z-index:1000}@media (min-width: 768px){#suggestions{right:-2rem}}@media (min-width: 992px){#suggestions{right:0}}#suggestions a,.suggestion__no-results{padding:0.75rem;margin:0 0.5rem}#suggestions a{display:block;text-decoration:none}#suggestions a:focus{background:#f8f9fa;outline:0}#suggestions div:not(:first-child){border-top:1px dashed #e9ecef}#suggestions div:first-child{margin-top:0.5rem}#suggestions div:last-child{margin-bottom:0.5rem}#suggestions a:hover{background:#f8f9fa}#suggestions span{display:flex;font-size:1rem}.suggestion__title{font-weight:700;color:#b3c7ff}.suggestion__description,.suggestion__no-results{color:#495057}@media (min-width: 992px){#suggestions{width:31.125rem;max-width:31.125rem}#suggestions a{display:flex}.suggestion__title{width:9rem;padding-right:1rem;border-right:1px solid #e9ecef;display:inline-block;text-align:right}.suggestion__description{width:19rem;padding-left:1rem}}table{margin:3rem 0}.nav-tabs{border-bottom:0.0625rem solid #d8dee4;margin-bottom:1rem}.nav-tabs .nav-link{margin-bottom:-0.0625rem !important;background:none;border:0;border-top-left-radius:0;border-top-right-radius:0;color:inherit}.nav-tabs .nav-link:hover,.nav-tabs .nav-link:focus{isolation:isolate;border-color:transparent;color:var(--bs-emphasis-color)}.nav-tabs .nav-link.active,.nav-tabs .nav-item.show .nav-link{background-color:transparent;border-color:transparent;border-bottom:0.125rem solid #3347ff}[data-bs-theme="dark"] .nav-tabs{border-bottom:0.0625rem solid #343a40}[data-bs-theme="dark"] .nav-tabs .nav-link.active,[data-bs-theme="dark"] .nav-tabs .nav-item.show .nav-link{border-bottom:0.125rem solid #b3c7ff}.footer{border-top:1px solid #e9ecef;padding-top:1.125rem;padding-bottom:1.125rem}.footer ul{margin-bottom:0}.footer li{font-size:.875rem;margin-bottom:0}@media (max-width: 991.98px){.footer .col-lg-8{margin-top:0.25rem;margin-bottom:0.25rem}}@media (min-width: 768px){.footer li{font-size:1rem}}.fixed-bottom-right{position:fixed;right:0;bottom:0;z-index:1000}.navbar-brand{font-weight:700}.navbar-brand svg{margin-right:0.25rem}[data-bs-theme="dark"] .navbar-brand{color:inherit}.navbar{z-index:1000;background-color:rgba(255,255,255,0.95);border-bottom:1px solid #e9ecef}@media (min-width: 992px){.navbar{z-index:1025}}@media (min-width: 768px){.navbar-brand{font-size:1.375rem}}.nav-item{margin-left:0}@media (max-width: 991.98px){.navbar .icon-tabler-chevron-down{display:block;float:right;transform:rotate(270deg);transition:transform 0.35s ease}.navbar .dropdown-toggle[aria-expanded="true"] .icon-tabler-chevron-down{transform:rotate(360deg)}.navbar-nav .dropdown-menu{border:0}.navbar-nav .nav-link{font-weight:400}.navbar-nav .dropdown-item{font-weight:300}.dropdown-toggle svg{margin-top:0.25rem;margin-left:0}}@media (min-width: 768px){.nav-item{margin-left:0.5rem}}button#doks-languages{margin:0.25rem 0 0}@media (min-width: 992px){button#doks-languages{margin:0.25rem 0.5rem 0 0.25rem}}button#doks-versions{margin:0.25rem 0 0}@media (min-width: 992px){button#doks-versions{margin:0.25rem 0.5rem 0 0.25rem}}@media (max-width: 575.98px){.navbar .offcanvas.offcanvas-start,.navbar .offcanvas.offcanvas-end{width:80vw}}.offcanvas-header{border-bottom:1px solid #dee2e6;padding-top:1.0625rem;padding-bottom:0.8125rem}h5.offcanvas-title,.offcanvas-title.h5{margin:0;color:inherit}.offcanvas .nav-link{color:#1d2d35}.offcanvas .nav-link:hover,.offcanvas .nav-link:focus{color:#3347ff}.offcanvas .nav-link.active{color:#3347ff}.header-bar{border-top:4px solid;border-image-source:linear-gradient(83.21deg, #ffe000 0%, #e55235 100%);border-image-slice:1}[data-bs-theme="dark"] .header-bar{border-top:4px solid;border-image-source:linear-gradient(83.21deg, var(--sl-color-accent) 0%, var(--sl-color-green) 100%);border-image-slice:1}.offcanvas .header-bar{margin-bottom:-4px}.home .navbar{border-bottom:0}@media (min-width: 992px){.navbar-brand{margin-right:0.75rem !important}}.dropdown-divider{border-top:1px dashed #e9ecef}.dropdown-item:hover{background:#f8f9fa}.dropdown-item:active{color:inherit}.social-link{padding-right:0.375rem;padding-left:0.375rem}@media (max-width: 991.98px){#buttonColorMode{margin:0.5rem 0}#socialMenu{margin:0.5rem 0 0.5rem -0.25rem}.navbar-nav{margin-top:1rem}.dropdown-menu{box-shadow:none !important;background:transparent !important;border-radius:0 !important;padding:0;margin-bottom:0.25rem}.dropdown-item{padding:0.375rem 1rem 0.375rem 0}.nav-item .nav-link{font-weight:400;font-size:1.125rem}.btn-dropdown{font-weight:400;font-size:1.125rem}}.modal-backdrop,.offcanvas-backdrop{visibility:hidden;background:rgba(23,24,28,0.5);opacity:0}[data-bs-theme="dark"] .modal-backdrop,[data-bs-theme="dark"] .offcanvas-backdrop{visibility:hidden;background:rgba(23,24,28,0.5);opacity:0}.modal-backdrop.show,.offcanvas-backdrop.show{visibility:visible;opacity:1;-webkit-backdrop-filter:blur(8px);backdrop-filter:blur(8px)}.showing,.hiding{transition:none;display:none}.navbar>.container,.navbar>.container-fluid,.navbar>.container-lg{padding-right:0.75rem}.docs-content>h2[id]::before,.docs-content>[id].h2::before,.docs-content>h3[id]::before,.docs-content>[id].h3::before,.docs-content>h4[id]::before,.docs-content>[id].h4::before{display:block;height:6rem;margin-top:-6rem;content:""}.docs-content ul,.docs-content ol{margin-bottom:1rem}.anchor{visibility:hidden;margin-left:0.375rem}.edit-page a,.last-modified a{color:var(--sl-color-gray-3)}h1:hover a,.h1:hover a,h2:hover a,.h2:hover a,h3:hover a,.h3:hover a,h4:hover a,.h4:hover a{visibility:visible;text-decoration:none}.card-list{margin-top:2.25rem}.page-footer-meta{margin-top:2rem;margin-bottom:2rem}.edit-page,.last-modified{font-size:.875rem;margin-top:0.25rem;margin-bottom:0.25rem}@media (min-width: 768px){.edit-page,.last-modified{font-size:1rem;margin-top:0.75rem;margin-bottom:0.25rem}}.edit-page a:hover,.last-modified a:hover{color:var(--sl-color-gray-4);text-decoration:none}[data-bs-theme="dark"] .edit-page a:hover,[data-bs-theme="dark"] .last-modified a:hover{color:var(--sl-color-gray-2)}.edit-page svg,.last-modified svg{margin-right:0.25rem;margin-bottom:0.25rem}p.meta{margin-top:0.5rem;font-size:1rem}.breadcrumb{margin-top:2.25rem;font-size:1rem}.toc-mobile{margin-top:2rem;margin-bottom:2rem}.row-about{padding-top:5rem;padding-bottom:5rem}@media (min-width: 992px){.row-about{padding-top:7rem;padding-bottom:7rem}}.row-about h1,.row-about .h1{margin-top:1rem}ul li{margin:0.25rem 0}.page-nav .card .icon-tabler-arrow-left{margin-right:0.75rem}.page-nav .card .icon-tabler-arrow-right{margin-left:0.75rem}.page-nav .card:hover{border:1px solid #d9d9d9}[data-bs-theme="dark"] .page-nav .card{border:1px solid #353841}[data-bs-theme="dark"] .page-nav .card:hover{border:1px solid #888c96}.container-fw{max-width:1200px}.container-fw .docs-toc{margin-left:3rem}.home .card,.contributors.list .card,.blog.list .card,.blog.single .card,.categories.list .card,.tags.list .card{margin-top:2rem;margin-bottom:2rem;transition:transform 0.3s}.home .content .card:hover,.contributors.list .content .card:hover,.blog.list .content .card:hover,.blog.single .content .card:hover,.categories.list .content .card:hover,.tags.list .content .card:hover{transform:scale(1.025)}.contributors.list .card.card-terms:hover,.categories.list .card.card-terms:hover,.tags.list .card.card-terms:hover{transform:none}.home .content .card-body,.contributors.list .content .card-body,.blog.list .content .card-body,.blog.single .content .card-body,.categories.list .content .card-body,.tags.list .content .card-body{padding:0 2rem 1rem}.contributors.list .card-terms .card-body,.categories.list .card-terms .card-body,.tags.list .card-terms .card-body{padding:1rem}.blog-header{text-align:center;margin-bottom:2rem}h2.section-title,.section-title.h2{margin-bottom:1.25rem}.img-post-single{margin-bottom:2rem}.pagination{display:flex;justify-content:center}.tag-list-single{margin-top:3rem;margin-bottom:1rem}.section-related{padding-top:1.5rem;padding-bottom:1.5rem}.contributor-image{text-align:center;margin-top:2.5rem}.docs-links,.docs-toc{scrollbar-width:thin;scrollbar-color:#fff #fff}.docs-links::-webkit-scrollbar,.docs-toc::-webkit-scrollbar{width:5px}.docs-links::-webkit-scrollbar-track,.docs-toc::-webkit-scrollbar-track{background:#fff}.docs-links::-webkit-scrollbar-thumb,.docs-toc::-webkit-scrollbar-thumb{background:#fff}.docs-links:hover,.docs-toc:hover{scrollbar-width:thin;scrollbar-color:#e9ecef #fff}.docs-links:hover::-webkit-scrollbar-thumb,.docs-toc:hover::-webkit-scrollbar-thumb{background:#e9ecef}.docs-links::-webkit-scrollbar-thumb:hover,.docs-toc::-webkit-scrollbar-thumb:hover{background:#e9ecef}.docs-links h3,.docs-links .h3,.page-links h3,.page-links .h3{text-transform:uppercase;font-size:1rem;margin:1.25rem 0 0.5rem;padding:1.5rem 0 0}@media (min-width: 992px){.docs-links h3,.docs-links .h3,.page-links h3,.page-links .h3{margin:1.125rem 1.5rem 0.75rem 0;padding:1.375rem 0 0}}.docs-links h3:not(:first-child),.docs-links .h3:not(:first-child){border-top:1px solid #e9ecef}a.docs-link{color:#1d2d35;display:block;padding:0.125rem 0;font-size:1rem}.page-links li{margin-top:0.375rem;padding-top:0.375rem}.page-links li ul li{border-top:none;padding-left:1rem;margin-top:0.125rem;padding-top:0.125rem}.page-links li:not(:first-child){border-top:1px dashed #e9ecef}.page-links a{color:#1d2d35;display:block;padding:0.125rem 0;font-size:.9375rem;text-decoration:none}.docs-link:hover,.docs-link.active,.page-links a:hover,.page-links a.active{text-decoration:none;color:#3347ff}.nav-link.active,.docs-link.active{font-weight:500}
+}:root,[data-bs-theme="light"]{--bs-blue: #3347ff;--bs-indigo: #6610f2;--bs-purple: #bd53ee;--bs-pink: #d63384;--bs-red: #ee5389;--bs-orange: #fd7e14;--bs-yellow: #eebd53;--bs-green: #84ee53;--bs-teal: #20c997;--bs-cyan: #0dcaf0;--bs-black: #000;--bs-white: #fff;--bs-gray: #6c757d;--bs-gray-dark: #343a40;--bs-gray-100: #f8f9fa;--bs-gray-200: #e9ecef;--bs-gray-300: #dee2e6;--bs-gray-400: #ced4da;--bs-gray-500: #adb5bd;--bs-gray-600: #6c757d;--bs-gray-700: #495057;--bs-gray-800: #343a40;--bs-gray-900: #212529;--bs-primary: #3347ff;--bs-secondary: #6c757d;--bs-success: #84ee53;--bs-info: #3347ff;--bs-warning: #eebd53;--bs-danger: #ee5389;--bs-light: #f8f9fa;--bs-dark: #212529;--bs-primary-rgb: 51,71.4,255;--bs-secondary-rgb: 108,117,125;--bs-success-rgb: 132.2821,238.017,83.283;--bs-info-rgb: 51,71.4,255;--bs-warning-rgb: 238.017,189.0179,83.283;--bs-danger-rgb: 238.017,83.283,137.4399;--bs-light-rgb: 248,249,250;--bs-dark-rgb: 33,37,41;--bs-primary-text-emphasis: #141d66;--bs-secondary-text-emphasis: #2b2f32;--bs-success-text-emphasis: #355f21;--bs-info-text-emphasis: #141d66;--bs-warning-text-emphasis: #5f4c21;--bs-danger-text-emphasis: #5f2137;--bs-light-text-emphasis: #495057;--bs-dark-text-emphasis: #495057;--bs-primary-bg-subtle: #d6daff;--bs-secondary-bg-subtle: #e2e3e5;--bs-success-bg-subtle: #e6fcdd;--bs-info-bg-subtle: #d6daff;--bs-warning-bg-subtle: #fcf2dd;--bs-danger-bg-subtle: #fcdde7;--bs-light-bg-subtle: #fcfcfd;--bs-dark-bg-subtle: #ced4da;--bs-primary-border-subtle: #adb6ff;--bs-secondary-border-subtle: #c4c8cb;--bs-success-border-subtle: #cef8ba;--bs-info-border-subtle: #adb6ff;--bs-warning-border-subtle: #f8e5ba;--bs-danger-border-subtle: #f8bad0;--bs-light-border-subtle: #e9ecef;--bs-dark-border-subtle: #adb5bd;--bs-white-rgb: 255,255,255;--bs-black-rgb: 0,0,0;--bs-font-sans-serif: "Jost", system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", "Noto Sans", "Liberation Sans", Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";--bs-font-monospace: SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;--bs-gradient: linear-gradient(180deg, rgba(255,255,255,0.15), rgba(255,255,255,0));--bs-body-font-family: var(--bs-font-sans-serif);--bs-body-font-size:1rem;--bs-body-font-weight: 400;--bs-body-line-height: 1.5;--bs-body-color: #1d2d35;--bs-body-color-rgb: 29,45,53;--bs-body-bg: #fff;--bs-body-bg-rgb: 255,255,255;--bs-emphasis-color: #000;--bs-emphasis-color-rgb: 0,0,0;--bs-secondary-color: rgba(29,45,53,0.75);--bs-secondary-color-rgb: 29,45,53;--bs-secondary-bg: #e9ecef;--bs-secondary-bg-rgb: 233,236,239;--bs-tertiary-color: rgba(29,45,53,0.5);--bs-tertiary-color-rgb: 29,45,53;--bs-tertiary-bg: #f8f9fa;--bs-tertiary-bg-rgb: 248,249,250;--bs-heading-color: inherit;--bs-link-color: #3347ff;--bs-link-color-rgb: 51,71.4,255;--bs-link-decoration: none;--bs-link-hover-color: #2939cc;--bs-link-hover-color-rgb: 41,57,204;--bs-link-hover-decoration: underline;--bs-code-color: #d63384;--bs-highlight-color: #1d2d35;--bs-highlight-bg: #fcf2dd;--bs-border-width: 1px;--bs-border-style: solid;--bs-border-color: #e9ecef;--bs-border-color-translucent: rgba(0,0,0,0.175);--bs-border-radius: .375rem;--bs-border-radius-sm: .25rem;--bs-border-radius-lg: .5rem;--bs-border-radius-xl: 1rem;--bs-border-radius-xxl: 2rem;--bs-border-radius-2xl: var(--bs-border-radius-xxl);--bs-border-radius-pill: 50rem;--bs-box-shadow: 0 0.5rem 1rem rgba(0,0,0,0.15);--bs-box-shadow-sm: 0 0.125rem 0.25rem rgba(0,0,0,0.075);--bs-box-shadow-lg: 0 1rem 3rem rgba(0,0,0,0.175);--bs-box-shadow-inset: inset 0 1px 2px rgba(0,0,0,0.075);--bs-focus-ring-width: .25rem;--bs-focus-ring-opacity: .25;--bs-focus-ring-color: rgba(51,71,255,0.25);--bs-form-valid-color: #84ee53;--bs-form-valid-border-color: #84ee53;--bs-form-invalid-color: #ee5389;--bs-form-invalid-border-color: #ee5389}[data-bs-theme="dark"]{color-scheme:dark;--bs-body-color: #c1c3c8;--bs-body-color-rgb: 192.831,194.7078,199.869;--bs-body-bg: #17181c;--bs-body-bg-rgb: 22.95,24.31,28.05;--bs-emphasis-color: #fff;--bs-emphasis-color-rgb: 255,255,255;--bs-secondary-color: rgba(173,181,189,0.75);--bs-secondary-color-rgb: 173,181,189;--bs-secondary-bg: #343a40;--bs-secondary-bg-rgb: 52,58,64;--bs-tertiary-color: rgba(173,181,189,0.5);--bs-tertiary-color-rgb: 173,181,189;--bs-tertiary-bg: #2b3035;--bs-tertiary-bg-rgb: 43,48,53;--bs-primary-text-emphasis: #8591ff;--bs-secondary-text-emphasis: #a7acb1;--bs-success-text-emphasis: #b5f598;--bs-info-text-emphasis: #8591ff;--bs-warning-text-emphasis: #f5d798;--bs-danger-text-emphasis: #f598b8;--bs-light-text-emphasis: #f8f9fa;--bs-dark-text-emphasis: #dee2e6;--bs-primary-bg-subtle: #0a0e33;--bs-secondary-bg-subtle: #161719;--bs-success-bg-subtle: #1a3011;--bs-info-bg-subtle: #0a0e33;--bs-warning-bg-subtle: #302611;--bs-danger-bg-subtle: #30111b;--bs-light-bg-subtle: #23262f;--bs-dark-bg-subtle: #1a1d20;--bs-primary-border-subtle: #1f2b99;--bs-secondary-border-subtle: #41464b;--bs-success-border-subtle: #4f8f32;--bs-info-border-subtle: #2e40e6;--bs-warning-border-subtle: #b38e3e;--bs-danger-border-subtle: #d64b7c;--bs-light-border-subtle: #353841;--bs-dark-border-subtle: #343a40;--bs-heading-color: #fff;--bs-link-color: #b3c7ff;--bs-link-hover-color: #9da7ff;--bs-link-color-rgb: 178.5,198.9,255;--bs-link-hover-color-rgb: 157,167,255;--bs-code-color: #e685b5;--bs-highlight-color: #c1c3c8;--bs-highlight-bg: #5f4c21;--bs-border-color: #495057;--bs-border-color-translucent: rgba(255,255,255,0.15);--bs-form-valid-color: #b5f598;--bs-form-valid-border-color: #b5f598;--bs-form-invalid-color: #f598b8;--bs-form-invalid-border-color: #f598b8}*,*::before,*::after{box-sizing:border-box}@media (prefers-reduced-motion: no-preference){:root{scroll-behavior:smooth}}body{margin:0;font-family:var(--bs-body-font-family);font-size:var(--bs-body-font-size);font-weight:var(--bs-body-font-weight);line-height:var(--bs-body-line-height);color:var(--bs-body-color);text-align:var(--bs-body-text-align);background-color:var(--bs-body-bg);-webkit-text-size-adjust:100%;-webkit-tap-highlight-color:rgba(0,0,0,0)}hr{margin:1rem 0;color:inherit;border:0;border-top:var(--bs-border-width) solid;opacity:.25}h6,.h6,h5,.h5,h4,.h4,h3,.h3,h2,.h2,h1,.h1{margin-top:0;margin-bottom:.5rem;font-weight:700;line-height:1.2;color:var(--bs-heading-color)}h1,.h1{font-size:calc(1.375rem + 1.5vw)}@media (min-width: 1200px){h1,.h1{font-size:2.5rem}}h2,.h2{font-size:calc(1.325rem + .9vw)}@media (min-width: 1200px){h2,.h2{font-size:2rem}}h3,.h3{font-size:calc(1.3rem + .6vw)}@media (min-width: 1200px){h3,.h3{font-size:1.75rem}}h4,.h4{font-size:calc(1.275rem + .3vw)}@media (min-width: 1200px){h4,.h4{font-size:1.5rem}}h5,.h5{font-size:1.25rem}h6,.h6{font-size:1rem}p{margin-top:0;margin-bottom:1rem}address{margin-bottom:1rem;font-style:normal;line-height:inherit}ol,ul{padding-left:2rem}ol,ul{margin-top:0;margin-bottom:1rem}ol ol,ul ul,ol ul,ul ol{margin-bottom:0}dt{font-weight:700}dd{margin-bottom:.5rem;margin-left:0}strong{font-weight:bolder}small,.small{font-size:.875em}sub,sup{position:relative;font-size:.75em;line-height:0;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}a{color:rgba(var(--bs-link-color-rgb), var(--bs-link-opacity, 1));text-decoration:none}a:hover{--bs-link-color-rgb: var(--bs-link-hover-color-rgb);text-decoration:underline}a:not([href]):not([class]),a:not([href]):not([class]):hover{color:inherit;text-decoration:none}pre,code,kbd,samp{font-family:var(--bs-font-monospace);font-size:1em}pre{display:block;margin-top:0;margin-bottom:1rem;overflow:auto;font-size:.875em}pre code{font-size:inherit;color:inherit;word-break:normal}code{font-size:.875em;color:var(--bs-code-color);word-wrap:break-word}a>code{color:inherit}kbd{padding:.1875rem .375rem;font-size:.875em;color:var(--bs-body-bg);background-color:var(--bs-body-color);border-radius:.25rem}kbd kbd{padding:0;font-size:1em}figure{margin:0 0 1rem}img,svg{vertical-align:middle}table{caption-side:bottom;border-collapse:collapse}caption{padding-top:.5rem;padding-bottom:.5rem;color:var(--bs-secondary-color);text-align:left}th{text-align:inherit;text-align:-webkit-match-parent}thead,tbody,tr,td,th{border-color:inherit;border-style:solid;border-width:0}label{display:inline-block}button{border-radius:0}button:focus:not(:focus-visible){outline:0}input,button,select{margin:0;font-family:inherit;font-size:inherit;line-height:inherit}button,select{text-transform:none}[role="button"]{cursor:pointer}select{word-wrap:normal}select:disabled{opacity:1}[list]:not([type="date"]):not([type="datetime-local"]):not([type="month"]):not([type="week"]):not([type="time"])::-webkit-calendar-picker-indicator{display:none !important}button,[type="button"],[type="reset"],[type="submit"]{-webkit-appearance:button}button:not(:disabled),[type="button"]:not(:disabled),[type="reset"]:not(:disabled),[type="submit"]:not(:disabled){cursor:pointer}::-moz-focus-inner{padding:0;border-style:none}::-webkit-datetime-edit-fields-wrapper,::-webkit-datetime-edit-text,::-webkit-datetime-edit-minute,::-webkit-datetime-edit-hour-field,::-webkit-datetime-edit-day-field,::-webkit-datetime-edit-month-field,::-webkit-datetime-edit-year-field{padding:0}::-webkit-inner-spin-button{height:auto}[type="search"]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-color-swatch-wrapper{padding:0}::file-selector-button{font:inherit;-webkit-appearance:button}output{display:inline-block}summary{display:list-item;cursor:pointer}.lead{font-size:1.25rem;font-weight:400}.list-unstyled{padding-left:0;list-style:none}.list-inline{padding-left:0;list-style:none}.list-inline-item{display:inline-block}.list-inline-item:not(:last-child){margin-right:.5rem}.img-fluid{max-width:100%;height:auto}.figure{display:inline-block}.container,.container-fluid,.container-lg{--bs-gutter-x: 3rem;--bs-gutter-y: 0;width:100%;padding-right:calc(var(--bs-gutter-x) * .5);padding-left:calc(var(--bs-gutter-x) * .5);margin-right:auto;margin-left:auto}@media (min-width: 576px){.container{max-width:540px}}@media (min-width: 768px){.container{max-width:720px}}@media (min-width: 992px){.container-lg,.container{max-width:960px}}@media (min-width: 1200px){.container-lg,.container{max-width:1240px}}@media (min-width: 1400px){.container-lg,.container{max-width:1320px}}:root{--bs-breakpoint-xs: 0;--bs-breakpoint-sm: 576px;--bs-breakpoint-md: 768px;--bs-breakpoint-lg: 992px;--bs-breakpoint-xl: 1200px;--bs-breakpoint-xxl: 1400px}.row{--bs-gutter-x: 3rem;--bs-gutter-y: 0;display:flex;flex-wrap:wrap;margin-top:calc(-1 * var(--bs-gutter-y));margin-right:calc(-.5 * var(--bs-gutter-x));margin-left:calc(-.5 * var(--bs-gutter-x))}.row>*{flex-shrink:0;width:100%;max-width:100%;padding-right:calc(var(--bs-gutter-x) * .5);padding-left:calc(var(--bs-gutter-x) * .5);margin-top:var(--bs-gutter-y)}.col{flex:1 0 0%}@media (min-width: 768px){.col-md-8{flex:0 0 auto;width:50%}.col-md-12{flex:0 0 auto;width:75%}.col-md-13{flex:0 0 auto;width:81.25%}.col-md-16{flex:0 0 auto;width:100%}}@media (min-width: 992px){.col-lg-4{flex:0 0 auto;width:25%}.col-lg-5{flex:0 0 auto;width:31.25%}.col-lg-7{flex:0 0 auto;width:43.75%}.col-lg-8{flex:0 0 auto;width:50%}.col-lg-9{flex:0 0 auto;width:56.25%}.col-lg-10{flex:0 0 auto;width:62.5%}.col-lg-11{flex:0 0 auto;width:68.75%}.col-lg-12{flex:0 0 auto;width:75%}}@media (min-width: 1200px){.col-xl{flex:1 0 0%}.col-xl-3{flex:0 0 auto;width:18.75%}.col-xl-4{flex:0 0 auto;width:25%}.col-xl-8{flex:0 0 auto;width:50%}.col-xl-9{flex:0 0 auto;width:56.25%}}.table,table{--bs-table-color-type: initial;--bs-table-bg-type: initial;--bs-table-color-state: initial;--bs-table-bg-state: initial;--bs-table-color: var(--bs-body-color);--bs-table-bg: rgba(0,0,0,0);--bs-table-border-color: var(--bs-border-color);--bs-table-accent-bg: rgba(0,0,0,0);--bs-table-striped-color: var(--bs-body-color);--bs-table-striped-bg: rgba(0,0,0,0.05);--bs-table-active-color: var(--bs-body-color);--bs-table-active-bg: rgba(0,0,0,0.1);--bs-table-hover-color: var(--bs-body-color);--bs-table-hover-bg: rgba(0,0,0,0.075);width:100%;margin-bottom:1rem;vertical-align:top;border-color:var(--bs-table-border-color)}.table>:not(caption)>*>*,table>:not(caption)>*>*{padding:.5rem .5rem;color:var(--bs-table-color-state, var(--bs-table-color-type, var(--bs-table-color)));background-color:var(--bs-table-bg);border-bottom-width:var(--bs-border-width);box-shadow:inset 0 0 0 9999px var(--bs-table-bg-state, var(--bs-table-bg-type, var(--bs-table-accent-bg)))}.table>tbody,table>tbody{vertical-align:inherit}.table>thead,table>thead{vertical-align:bottom}[data-bs-theme="dark"] table{--bs-table-color: #fff;--bs-table-bg: #212529;--bs-table-border-color: #373b3e;--bs-table-striped-bg: #2c3034;--bs-table-striped-color: #fff;--bs-table-active-bg: #373b3e;--bs-table-active-color: #fff;--bs-table-hover-bg: #323539;--bs-table-hover-color: #fff;color:var(--bs-table-color);border-color:var(--bs-table-border-color)}.form-control{display:block;width:100%;padding:.375rem .75rem;font-size:1rem;font-weight:400;line-height:1.5;color:var(--bs-body-color);-webkit-appearance:none;-moz-appearance:none;appearance:none;background-color:var(--bs-body-bg);background-clip:padding-box;border:var(--bs-border-width) solid var(--bs-border-color);border-radius:.375rem;transition:border-color 0.15s ease-in-out,box-shadow 0.15s ease-in-out}@media (prefers-reduced-motion: reduce){.form-control{transition:none}}.form-control[type="file"]{overflow:hidden}.form-control[type="file"]:not(:disabled):not([readonly]){cursor:pointer}.form-control:focus{color:var(--bs-body-color);background-color:var(--bs-body-bg);border-color:#99a3ff;outline:0;box-shadow:none}.form-control::-webkit-date-and-time-value{min-width:85px;height:1.5em;margin:0}.form-control::-webkit-datetime-edit{display:block;padding:0}.form-control::-moz-placeholder{color:var(--bs-secondary-color);opacity:1}.form-control::placeholder{color:var(--bs-secondary-color);opacity:1}.form-control:disabled{background-color:var(--bs-secondary-bg);opacity:1}.form-control::file-selector-button{padding:.375rem .75rem;margin:-.375rem -.75rem;margin-inline-end:.75rem;color:var(--bs-body-color);background-color:var(--bs-tertiary-bg);pointer-events:none;border-color:inherit;border-style:solid;border-width:0;border-inline-end-width:var(--bs-border-width);border-radius:0;transition:color 0.15s ease-in-out,background-color 0.15s ease-in-out,border-color 0.15s ease-in-out,box-shadow 0.15s ease-in-out}@media (prefers-reduced-motion: reduce){.form-control::file-selector-button{transition:none}}.form-control:hover:not(:disabled):not([readonly])::file-selector-button{background-color:var(--bs-secondary-bg)}.form-control-lg{min-height:calc(1.5em + 1rem + calc($input-border-width * 2));padding:.5rem 1rem;font-size:1.25rem;border-radius:.5rem}.form-control-lg::file-selector-button{padding:.5rem 1rem;margin:-.5rem -1rem;margin-inline-end:1rem}li input[type="checkbox"]{--bs-form-check-bg: var(--bs-body-bg);flex-shrink:0;width:1em;height:1em;margin-top:.25em;vertical-align:top;-webkit-appearance:none;-moz-appearance:none;appearance:none;background-color:var(--bs-form-check-bg);background-image:var(--bs-form-check-bg-image);background-repeat:no-repeat;background-position:center;background-size:contain;border:var(--bs-border-width) solid var(--bs-border-color);-webkit-print-color-adjust:exact;print-color-adjust:exact}li input[type="checkbox"]{border-radius:.25em}li input[type="radio"][type="checkbox"]{border-radius:50%}li input[type="checkbox"]:active{filter:brightness(90%)}li input[type="checkbox"]:focus{border-color:#99a3ff;outline:0;box-shadow:0 0 0 .25rem rgba(51,71,255,0.25)}li input[type="checkbox"]:checked{background-color:#3347ff;border-color:#3347ff}li input:checked[type="checkbox"]{--bs-form-check-bg-image: url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3e%3cpath fill='none' stroke='%23fff' stroke-linecap='round' stroke-linejoin='round' stroke-width='3' d='m6 10 3 3 6-6'/%3e%3c/svg%3e")}li input[type="checkbox"]:checked[type="radio"]{--bs-form-check-bg-image: url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='-4 -4 8 8'%3e%3ccircle r='2' fill='%23fff'/%3e%3c/svg%3e")}li input[type="checkbox"]:indeterminate{background-color:#3347ff;border-color:#3347ff;--bs-form-check-bg-image: url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3e%3cpath fill='none' stroke='%23fff' stroke-linecap='round' stroke-linejoin='round' stroke-width='3' d='M6 10h8'/%3e%3c/svg%3e")}li input[type="checkbox"]:disabled{pointer-events:none;filter:none;opacity:.5}.btn{--bs-btn-padding-x: .75rem;--bs-btn-padding-y: .375rem;--bs-btn-font-family: ;--bs-btn-font-size:1rem;--bs-btn-font-weight: 400;--bs-btn-line-height: 1.5;--bs-btn-color: var(--bs-body-color);--bs-btn-bg: transparent;--bs-btn-border-width: var(--bs-border-width);--bs-btn-border-color: transparent;--bs-btn-border-radius: .375rem;--bs-btn-hover-border-color: transparent;--bs-btn-box-shadow: inset 0 1px 0 rgba(255,255,255,0.15),0 1px 1px rgba(0,0,0,0.075);--bs-btn-disabled-opacity: .65;--bs-btn-focus-box-shadow: 0 0 0 0 rgba(var(--bs-btn-focus-shadow-rgb), .5);display:inline-block;padding:var(--bs-btn-padding-y) var(--bs-btn-padding-x);font-family:var(--bs-btn-font-family);font-size:var(--bs-btn-font-size);font-weight:var(--bs-btn-font-weight);line-height:var(--bs-btn-line-height);color:var(--bs-btn-color);text-align:center;vertical-align:middle;cursor:pointer;-webkit-user-select:none;-moz-user-select:none;user-select:none;border:var(--bs-btn-border-width) solid var(--bs-btn-border-color);border-radius:var(--bs-btn-border-radius);background-color:var(--bs-btn-bg);transition:color 0.15s ease-in-out,background-color 0.15s ease-in-out,border-color 0.15s ease-in-out,box-shadow 0.15s ease-in-out}@media (prefers-reduced-motion: reduce){.btn{transition:none}}.btn:hover{color:var(--bs-btn-hover-color);text-decoration:none;background-color:var(--bs-btn-hover-bg);border-color:var(--bs-btn-hover-border-color)}.btn:focus-visible{color:var(--bs-btn-hover-color);background-color:var(--bs-btn-hover-bg);border-color:var(--bs-btn-hover-border-color);outline:0;box-shadow:var(--bs-btn-focus-box-shadow)}:not(.btn-check)+.btn:active,.btn:first-child:active,.btn.active,.btn.show{color:var(--bs-btn-active-color);background-color:var(--bs-btn-active-bg);border-color:var(--bs-btn-active-border-color)}:not(.btn-check)+.btn:active:focus-visible,.btn:first-child:active:focus-visible,.btn.active:focus-visible,.btn.show:focus-visible{box-shadow:var(--bs-btn-focus-box-shadow)}.btn:disabled,.btn.disabled{color:var(--bs-btn-disabled-color);pointer-events:none;background-color:var(--bs-btn-disabled-bg);border-color:var(--bs-btn-disabled-border-color);opacity:var(--bs-btn-disabled-opacity)}.btn-primary{--bs-btn-color: #fff;--bs-btn-bg: #3347ff;--bs-btn-border-color: #3347ff;--bs-btn-hover-color: #fff;--bs-btn-hover-bg: #2b3dd9;--bs-btn-hover-border-color: #2939cc;--bs-btn-focus-shadow-rgb: 82,99,255;--bs-btn-active-color: #fff;--bs-btn-active-bg: #2939cc;--bs-btn-active-border-color: #2636bf;--bs-btn-active-shadow: inset 0 3px 5px rgba(0,0,0,0.125);--bs-btn-disabled-color: #fff;--bs-btn-disabled-bg: #3347ff;--bs-btn-disabled-border-color: #3347ff}.btn-light{--bs-btn-color: #000;--bs-btn-bg: #f8f9fa;--bs-btn-border-color: #f8f9fa;--bs-btn-hover-color: #000;--bs-btn-hover-bg: #d3d4d5;--bs-btn-hover-border-color: #c6c7c8;--bs-btn-focus-shadow-rgb: 211,212,213;--bs-btn-active-color: #000;--bs-btn-active-bg: #c6c7c8;--bs-btn-active-border-color: #babbbc;--bs-btn-active-shadow: inset 0 3px 5px rgba(0,0,0,0.125);--bs-btn-disabled-color: #000;--bs-btn-disabled-bg: #f8f9fa;--bs-btn-disabled-border-color: #f8f9fa}.btn-link{--bs-btn-font-weight: 400;--bs-btn-color: var(--bs-link-color);--bs-btn-bg: transparent;--bs-btn-border-color: transparent;--bs-btn-hover-color: var(--bs-link-hover-color);--bs-btn-hover-border-color: transparent;--bs-btn-active-color: var(--bs-link-hover-color);--bs-btn-active-border-color: transparent;--bs-btn-disabled-color: #6c757d;--bs-btn-disabled-border-color: transparent;--bs-btn-box-shadow: 0 0 0 #000;--bs-btn-focus-shadow-rgb: 82,99,255;text-decoration:none}.btn-link:hover,.btn-link:focus-visible{text-decoration:underline}.btn-link:focus-visible{color:var(--bs-btn-color)}.btn-link:hover{color:var(--bs-btn-hover-color)}.btn-lg{--bs-btn-padding-y: .5rem;--bs-btn-padding-x: 1rem;--bs-btn-font-size:1.25rem;--bs-btn-border-radius: .5rem}.fade{transition:opacity 0.15s linear}@media (prefers-reduced-motion: reduce){.fade{transition:none}}.fade:not(.show){opacity:0}.collapse:not(.show){display:none}.dropup,.dropend,.dropdown,.dropstart,.dropup-center,.dropdown-center{position:relative}.dropdown-toggle{white-space:nowrap}.dropdown-toggle::after{display:inline-block;margin-left:.255em;vertical-align:.255em;content:"";border-top:.3em solid;border-right:.3em solid transparent;border-bottom:0;border-left:.3em solid transparent}.dropdown-toggle:empty::after{margin-left:0}.dropdown-menu{--bs-dropdown-zindex: 1000;--bs-dropdown-min-width: 10rem;--bs-dropdown-padding-x: 0;--bs-dropdown-padding-y: .5rem;--bs-dropdown-spacer: .125rem;--bs-dropdown-font-size:1rem;--bs-dropdown-color: var(--bs-body-color);--bs-dropdown-bg: var(--bs-body-bg);--bs-dropdown-border-color: var(--bs-border-color-translucent);--bs-dropdown-border-radius: .375rem;--bs-dropdown-border-width: var(--bs-border-width);--bs-dropdown-inner-border-radius: calc($dropdown-border-radius - $dropdown-border-width);--bs-dropdown-divider-bg: var(--bs-border-color-translucent);--bs-dropdown-divider-margin-y: .5rem;--bs-dropdown-box-shadow: 0 0.5rem 1rem rgba(0,0,0,0.15);--bs-dropdown-link-color: var(--bs-body-color);--bs-dropdown-link-hover-color: var(--bs-body-color);--bs-dropdown-link-hover-bg: var(--bs-tertiary-bg);--bs-dropdown-link-active-color: #fff;--bs-dropdown-link-active-bg: #3347ff;--bs-dropdown-link-disabled-color: var(--bs-tertiary-color);--bs-dropdown-item-padding-x: 1rem;--bs-dropdown-item-padding-y: .25rem;--bs-dropdown-header-color: #6c757d;--bs-dropdown-header-padding-x: 1rem;--bs-dropdown-header-padding-y: .5rem;position:absolute;z-index:var(--bs-dropdown-zindex);display:none;min-width:var(--bs-dropdown-min-width);padding:var(--bs-dropdown-padding-y) var(--bs-dropdown-padding-x);margin:0;font-size:var(--bs-dropdown-font-size);color:var(--bs-dropdown-color);text-align:left;list-style:none;background-color:var(--bs-dropdown-bg);background-clip:padding-box;border:var(--bs-dropdown-border-width) solid var(--bs-dropdown-border-color);border-radius:var(--bs-dropdown-border-radius)}.dropdown-menu[data-bs-popper]{top:100%;left:0;margin-top:var(--bs-dropdown-spacer)}@media (min-width: 992px){.dropdown-menu-lg-end{--bs-position: end}.dropdown-menu-lg-end[data-bs-popper]{right:0;left:auto}}.dropup .dropdown-menu[data-bs-popper]{top:auto;bottom:100%;margin-top:0;margin-bottom:var(--bs-dropdown-spacer)}.dropup .dropdown-toggle::after{display:inline-block;margin-left:.255em;vertical-align:.255em;content:"";border-top:0;border-right:.3em solid transparent;border-bottom:.3em solid;border-left:.3em solid transparent}.dropup .dropdown-toggle:empty::after{margin-left:0}.dropend .dropdown-menu[data-bs-popper]{top:0;right:auto;left:100%;margin-top:0;margin-left:var(--bs-dropdown-spacer)}.dropend .dropdown-toggle::after{display:inline-block;margin-left:.255em;vertical-align:.255em;content:"";border-top:.3em solid transparent;border-right:0;border-bottom:.3em solid transparent;border-left:.3em solid}.dropend .dropdown-toggle:empty::after{margin-left:0}.dropend .dropdown-toggle::after{vertical-align:0}.dropstart .dropdown-menu[data-bs-popper]{top:0;right:100%;left:auto;margin-top:0;margin-right:var(--bs-dropdown-spacer)}.dropstart .dropdown-toggle::after{display:inline-block;margin-left:.255em;vertical-align:.255em;content:""}.dropstart .dropdown-toggle::after{display:none}.dropstart .dropdown-toggle::before{display:inline-block;margin-right:.255em;vertical-align:.255em;content:"";border-top:.3em solid transparent;border-right:.3em solid;border-bottom:.3em solid transparent}.dropstart .dropdown-toggle:empty::after{margin-left:0}.dropstart .dropdown-toggle::before{vertical-align:0}.dropdown-divider{height:0;margin:var(--bs-dropdown-divider-margin-y) 0;overflow:hidden;border-top:1px solid var(--bs-dropdown-divider-bg);opacity:1}.dropdown-item{display:block;width:100%;padding:var(--bs-dropdown-item-padding-y) var(--bs-dropdown-item-padding-x);clear:both;font-weight:400;color:var(--bs-dropdown-link-color);text-align:inherit;white-space:nowrap;background-color:transparent;border:0;border-radius:var(--bs-dropdown-item-border-radius, 0)}.dropdown-item:hover,.dropdown-item:focus{color:var(--bs-dropdown-link-hover-color);text-decoration:none;background-color:var(--bs-dropdown-link-hover-bg)}.dropdown-item.active,.dropdown-item:active{color:var(--bs-dropdown-link-active-color);text-decoration:none;background-color:var(--bs-dropdown-link-active-bg)}.dropdown-item.disabled,.dropdown-item:disabled{color:var(--bs-dropdown-link-disabled-color);pointer-events:none;background-color:transparent}.dropdown-menu.show{display:block}.dropdown-header{display:block;padding:var(--bs-dropdown-header-padding-y) var(--bs-dropdown-header-padding-x);margin-bottom:0;font-size:.875rem;color:var(--bs-dropdown-header-color);white-space:nowrap}.dropdown-item-text{display:block;padding:var(--bs-dropdown-item-padding-y) var(--bs-dropdown-item-padding-x);color:var(--bs-dropdown-link-color)}.dropdown-menu-dark{--bs-dropdown-color: #dee2e6;--bs-dropdown-bg: #343a40;--bs-dropdown-border-color: var(--bs-border-color-translucent);--bs-dropdown-box-shadow: ;--bs-dropdown-link-color: #dee2e6;--bs-dropdown-link-hover-color: #fff;--bs-dropdown-divider-bg: var(--bs-border-color-translucent);--bs-dropdown-link-hover-bg: rgba(255,255,255,0.15);--bs-dropdown-link-active-color: #fff;--bs-dropdown-link-active-bg: #3347ff;--bs-dropdown-link-disabled-color: #adb5bd;--bs-dropdown-header-color: #adb5bd}.nav{--bs-nav-link-padding-x: 1rem;--bs-nav-link-padding-y: .5rem;--bs-nav-link-font-weight: ;--bs-nav-link-color: var(--bs-link-color);--bs-nav-link-hover-color: var(--bs-link-hover-color);--bs-nav-link-disabled-color: var(--bs-secondary-color);display:flex;flex-wrap:wrap;padding-left:0;margin-bottom:0;list-style:none}.nav-link{display:block;padding:var(--bs-nav-link-padding-y) var(--bs-nav-link-padding-x);font-size:var(--bs-nav-link-font-size);font-weight:var(--bs-nav-link-font-weight);color:var(--bs-nav-link-color);background:none;border:0;transition:color 0.15s ease-in-out,background-color 0.15s ease-in-out,border-color 0.15s ease-in-out}@media (prefers-reduced-motion: reduce){.nav-link{transition:none}}.nav-link:hover,.nav-link:focus{color:var(--bs-nav-link-hover-color);text-decoration:none}.nav-link:focus-visible{outline:0;box-shadow:0 0 0 .25rem rgba(51,71,255,0.25)}.nav-link.disabled,.nav-link:disabled{color:var(--bs-nav-link-disabled-color);pointer-events:none;cursor:default}.nav-tabs{--bs-nav-tabs-border-width: var(--bs-border-width);--bs-nav-tabs-border-color: var(--bs-border-color);--bs-nav-tabs-border-radius: var(--bs-border-radius);--bs-nav-tabs-link-hover-border-color: var(--bs-secondary-bg) var(--bs-secondary-bg) var(--bs-border-color);--bs-nav-tabs-link-active-color: var(--bs-emphasis-color);--bs-nav-tabs-link-active-bg: var(--bs-body-bg);--bs-nav-tabs-link-active-border-color: var(--bs-border-color) var(--bs-border-color) var(--bs-body-bg);border-bottom:var(--bs-nav-tabs-border-width) solid var(--bs-nav-tabs-border-color)}.nav-tabs .nav-link{margin-bottom:calc(-1 * var(--bs-nav-tabs-border-width));border:var(--bs-nav-tabs-border-width) solid transparent;border-top-left-radius:var(--bs-nav-tabs-border-radius);border-top-right-radius:var(--bs-nav-tabs-border-radius)}.nav-tabs .nav-link:hover,.nav-tabs .nav-link:focus{isolation:isolate;border-color:var(--bs-nav-tabs-link-hover-border-color)}.nav-tabs .nav-link.active,.nav-tabs .nav-item.show .nav-link{color:var(--bs-nav-tabs-link-active-color);background-color:var(--bs-nav-tabs-link-active-bg);border-color:var(--bs-nav-tabs-link-active-border-color)}.nav-tabs .dropdown-menu{margin-top:calc(-1 * var(--bs-nav-tabs-border-width));border-top-left-radius:0;border-top-right-radius:0}.tab-content>.tab-pane{display:none}.tab-content>.active{display:block}.navbar{--bs-navbar-padding-x: 0;--bs-navbar-padding-y: .5rem;--bs-navbar-color: rgba(var(--bs-emphasis-color-rgb), 0.65);--bs-navbar-hover-color: rgba(var(--bs-emphasis-color-rgb), 0.8);--bs-navbar-disabled-color: rgba(var(--bs-emphasis-color-rgb), 0.3);--bs-navbar-active-color: rgba(var(--bs-emphasis-color-rgb), 1);--bs-navbar-brand-padding-y: .3125rem;--bs-navbar-brand-margin-end: 1rem;--bs-navbar-brand-font-size: 1.25rem;--bs-navbar-brand-color: rgba(var(--bs-emphasis-color-rgb), 1);--bs-navbar-brand-hover-color: rgba(var(--bs-emphasis-color-rgb), 1);--bs-navbar-nav-link-padding-x: .5rem;--bs-navbar-toggler-padding-y: .25rem;--bs-navbar-toggler-padding-x: .75rem;--bs-navbar-toggler-font-size: 1.25rem;--bs-navbar-toggler-icon-bg: url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 30 30'%3e%3cpath stroke='rgba%2829,45,53,0.75%29' stroke-linecap='round' stroke-miterlimit='10' stroke-width='2' d='M4 7h22M4 15h22M4 23h22'/%3e%3c/svg%3e");--bs-navbar-toggler-border-color: rgba(var(--bs-emphasis-color-rgb), 0.15);--bs-navbar-toggler-border-radius: .375rem;--bs-navbar-toggler-focus-width: 0;--bs-navbar-toggler-transition: box-shadow 0.15s ease-in-out;position:relative;display:flex;flex-wrap:wrap;align-items:center;justify-content:space-between;padding:var(--bs-navbar-padding-y) var(--bs-navbar-padding-x)}.navbar>.container,.navbar>.container-fluid,.navbar>.container-lg{display:flex;flex-wrap:inherit;align-items:center;justify-content:space-between}.navbar-brand{padding-top:var(--bs-navbar-brand-padding-y);padding-bottom:var(--bs-navbar-brand-padding-y);margin-right:var(--bs-navbar-brand-margin-end);font-size:var(--bs-navbar-brand-font-size);color:var(--bs-navbar-brand-color);white-space:nowrap}.navbar-brand:hover,.navbar-brand:focus{color:var(--bs-navbar-brand-hover-color);text-decoration:none}.navbar-nav{--bs-nav-link-padding-x: 0;--bs-nav-link-padding-y: .5rem;--bs-nav-link-font-weight: ;--bs-nav-link-color: var(--bs-navbar-color);--bs-nav-link-hover-color: var(--bs-navbar-hover-color);--bs-nav-link-disabled-color: var(--bs-navbar-disabled-color);display:flex;flex-direction:column;padding-left:0;margin-bottom:0;list-style:none}.navbar-nav .nav-link.active,.navbar-nav .nav-link.show{color:var(--bs-navbar-active-color)}.navbar-nav .dropdown-menu{position:static}@media (min-width: 992px){.navbar-expand-lg{flex-wrap:nowrap;justify-content:flex-start}.navbar-expand-lg .navbar-nav{flex-direction:row}.navbar-expand-lg .navbar-nav .dropdown-menu{position:absolute}.navbar-expand-lg .navbar-nav .nav-link{padding-right:var(--bs-navbar-nav-link-padding-x);padding-left:var(--bs-navbar-nav-link-padding-x)}.navbar-expand-lg .offcanvas{position:static;z-index:auto;flex-grow:1;width:auto !important;height:auto !important;visibility:visible !important;background-color:transparent !important;border:0 !important;transform:none !important;transition:none}.navbar-expand-lg .offcanvas .offcanvas-header{display:none}.navbar-expand-lg .offcanvas .offcanvas-body{display:flex;flex-grow:0;padding:0;overflow-y:visible}}.navbar[data-bs-theme="dark"]{--bs-navbar-color: #c1c3c8;--bs-navbar-hover-color: #b3c7ff;--bs-navbar-disabled-color: rgba(255,255,255,0.25);--bs-navbar-active-color: #b3c7ff;--bs-navbar-brand-color: #fff;--bs-navbar-brand-hover-color: #fff;--bs-navbar-toggler-border-color: rgba(255,255,255,0.1);--bs-navbar-toggler-icon-bg: url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 30 30'%3e%3cpath stroke='rgba%28255,255,255,0.55%29' stroke-linecap='round' stroke-miterlimit='10' stroke-width='2' d='M4 7h22M4 15h22M4 23h22'/%3e%3c/svg%3e")}.card{--bs-card-spacer-y: 1rem;--bs-card-spacer-x: 1rem;--bs-card-title-spacer-y: .5rem;--bs-card-title-color: ;--bs-card-subtitle-color: ;--bs-card-border-width: var(--bs-border-width);--bs-card-border-color: #e9ecef;--bs-card-border-radius: var(--bs-border-radius);--bs-card-box-shadow: ;--bs-card-inner-border-radius: calc(var(--bs-border-radius) - (var(--bs-border-width)));--bs-card-cap-padding-y: .5rem;--bs-card-cap-padding-x: 1rem;--bs-card-cap-bg: rgba(var(--bs-body-color-rgb), 0.03);--bs-card-cap-color: ;--bs-card-height: ;--bs-card-color: ;--bs-card-bg: var(--bs-body-bg);--bs-card-img-overlay-padding: 1rem;--bs-card-group-margin: 1.5rem;position:relative;display:flex;flex-direction:column;min-width:0;height:var(--bs-card-height);color:var(--bs-body-color);word-wrap:break-word;background-color:var(--bs-card-bg);background-clip:border-box;border:var(--bs-card-border-width) solid var(--bs-card-border-color);border-radius:var(--bs-card-border-radius)}.card>hr{margin-right:0;margin-left:0}.card>.list-group{border-top:inherit;border-bottom:inherit}.card>.list-group:first-child{border-top-width:0;border-top-left-radius:var(--bs-card-inner-border-radius);border-top-right-radius:var(--bs-card-inner-border-radius)}.card>.list-group:last-child{border-bottom-width:0;border-bottom-right-radius:var(--bs-card-inner-border-radius);border-bottom-left-radius:var(--bs-card-inner-border-radius)}.card-body{flex:1 1 auto;padding:var(--bs-card-spacer-y) var(--bs-card-spacer-x);color:var(--bs-card-color)}.breadcrumb{--bs-breadcrumb-padding-x: 0;--bs-breadcrumb-padding-y: 0;--bs-breadcrumb-margin-bottom: 1rem;--bs-breadcrumb-bg: ;--bs-breadcrumb-border-radius: ;--bs-breadcrumb-divider-color: var(--bs-secondary-color);--bs-breadcrumb-item-padding-x: .5rem;--bs-breadcrumb-item-active-color: var(--bs-secondary-color);display:flex;flex-wrap:wrap;padding:var(--bs-breadcrumb-padding-y) var(--bs-breadcrumb-padding-x);margin-bottom:var(--bs-breadcrumb-margin-bottom);font-size:var(--bs-breadcrumb-font-size);list-style:none;background-color:var(--bs-breadcrumb-bg);border-radius:var(--bs-breadcrumb-border-radius)}.breadcrumb-item+.breadcrumb-item{padding-left:var(--bs-breadcrumb-item-padding-x)}.breadcrumb-item+.breadcrumb-item::before{float:left;padding-right:var(--bs-breadcrumb-item-padding-x);color:var(--bs-breadcrumb-divider-color);content:var(--bs-breadcrumb-divider, "/") /* rtl: var(--bs-breadcrumb-divider, "/") */}.breadcrumb-item.active{color:var(--bs-breadcrumb-item-active-color)}.pagination{--bs-pagination-padding-x: .75rem;--bs-pagination-padding-y: .375rem;--bs-pagination-font-size:1rem;--bs-pagination-color: var(--bs-link-color);--bs-pagination-bg: var(--bs-body-bg);--bs-pagination-border-width: var(--bs-border-width);--bs-pagination-border-color: var(--bs-border-color);--bs-pagination-border-radius: var(--bs-border-radius);--bs-pagination-hover-color: var(--bs-link-hover-color);--bs-pagination-hover-bg: var(--bs-tertiary-bg);--bs-pagination-hover-border-color: var(--bs-border-color);--bs-pagination-focus-color: var(--bs-link-hover-color);--bs-pagination-focus-bg: var(--bs-secondary-bg);--bs-pagination-focus-box-shadow: 0 0 0 .25rem rgba(51,71,255,0.25);--bs-pagination-active-color: #fff;--bs-pagination-active-bg: #3347ff;--bs-pagination-active-border-color: #3347ff;--bs-pagination-disabled-color: var(--bs-secondary-color);--bs-pagination-disabled-bg: var(--bs-secondary-bg);--bs-pagination-disabled-border-color: var(--bs-border-color);display:flex;padding-left:0;list-style:none}.badge{--bs-badge-padding-x: .65em;--bs-badge-padding-y: .35em;--bs-badge-font-size:.75em;--bs-badge-font-weight: 700;--bs-badge-color: #fff;--bs-badge-border-radius: .375rem;display:inline-block;padding:var(--bs-badge-padding-y) var(--bs-badge-padding-x);font-size:var(--bs-badge-font-size);font-weight:var(--bs-badge-font-weight);line-height:1;color:var(--bs-badge-color);text-align:center;white-space:nowrap;vertical-align:baseline;border-radius:var(--bs-badge-border-radius)}.badge:empty{display:none}.btn .badge{position:relative;top:-1px}.alert{--bs-alert-bg: transparent;--bs-alert-padding-x: 1.5rem;--bs-alert-padding-y: 1rem;--bs-alert-margin-bottom: 0;--bs-alert-color: inherit;--bs-alert-border-color: transparent;--bs-alert-border: 0 solid var(--bs-alert-border-color);--bs-alert-border-radius: 0;--bs-alert-link-color: inherit;position:relative;padding:var(--bs-alert-padding-y) var(--bs-alert-padding-x);margin-bottom:var(--bs-alert-margin-bottom);color:var(--bs-alert-color);background-color:var(--bs-alert-bg);border:var(--bs-alert-border);border-radius:var(--bs-alert-border-radius)}.alert-link,.callout a{font-weight:700;color:var(--bs-alert-link-color)}.alert-dismissible{padding-right:4.5rem}.alert-dismissible .btn-close{position:absolute;top:0;right:0;z-index:2;padding:1.25rem 1.5rem}.alert-primary{--bs-alert-color: var(--bs-primary-text-emphasis);--bs-alert-bg: var(--bs-primary-bg-subtle);--bs-alert-border-color: var(--bs-primary-border-subtle);--bs-alert-link-color: var(--bs-primary-text-emphasis)}.alert-secondary{--bs-alert-color: var(--bs-secondary-text-emphasis);--bs-alert-bg: var(--bs-secondary-bg-subtle);--bs-alert-border-color: var(--bs-secondary-border-subtle);--bs-alert-link-color: var(--bs-secondary-text-emphasis)}.alert-success{--bs-alert-color: var(--bs-success-text-emphasis);--bs-alert-bg: var(--bs-success-bg-subtle);--bs-alert-border-color: var(--bs-success-border-subtle);--bs-alert-link-color: var(--bs-success-text-emphasis)}.alert-info{--bs-alert-color: var(--bs-info-text-emphasis);--bs-alert-bg: var(--bs-info-bg-subtle);--bs-alert-border-color: var(--bs-info-border-subtle);--bs-alert-link-color: var(--bs-info-text-emphasis)}.alert-warning{--bs-alert-color: var(--bs-warning-text-emphasis);--bs-alert-bg: var(--bs-warning-bg-subtle);--bs-alert-border-color: var(--bs-warning-border-subtle);--bs-alert-link-color: var(--bs-warning-text-emphasis)}.alert-danger{--bs-alert-color: var(--bs-danger-text-emphasis);--bs-alert-bg: var(--bs-danger-bg-subtle);--bs-alert-border-color: var(--bs-danger-border-subtle);--bs-alert-link-color: var(--bs-danger-text-emphasis)}.alert-light{--bs-alert-color: var(--bs-light-text-emphasis);--bs-alert-bg: var(--bs-light-bg-subtle);--bs-alert-border-color: var(--bs-light-border-subtle);--bs-alert-link-color: var(--bs-light-text-emphasis)}.alert-dark{--bs-alert-color: var(--bs-dark-text-emphasis);--bs-alert-bg: var(--bs-dark-bg-subtle);--bs-alert-border-color: var(--bs-dark-border-subtle);--bs-alert-link-color: var(--bs-dark-text-emphasis)}@keyframes progress-bar-stripes{0%{background-position-x:1rem}}.list-group{--bs-list-group-color: var(--bs-body-color);--bs-list-group-bg: var(--bs-body-bg);--bs-list-group-border-color: var(--bs-border-color);--bs-list-group-border-width: var(--bs-border-width);--bs-list-group-border-radius: var(--bs-border-radius);--bs-list-group-item-padding-x: 1rem;--bs-list-group-item-padding-y: .5rem;--bs-list-group-action-color: var(--bs-secondary-color);--bs-list-group-action-hover-color: var(--bs-emphasis-color);--bs-list-group-action-hover-bg: var(--bs-tertiary-bg);--bs-list-group-action-active-color: var(--bs-body-color);--bs-list-group-action-active-bg: var(--bs-secondary-bg);--bs-list-group-disabled-color: var(--bs-secondary-color);--bs-list-group-disabled-bg: var(--bs-body-bg);--bs-list-group-active-color: #fff;--bs-list-group-active-bg: #3347ff;--bs-list-group-active-border-color: #3347ff;display:flex;flex-direction:column;padding-left:0;margin-bottom:0;border-radius:var(--bs-list-group-border-radius)}.list-group-item-action{width:100%;color:var(--bs-list-group-action-color);text-align:inherit}.list-group-item-action:hover,.list-group-item-action:focus{z-index:1;color:var(--bs-list-group-action-hover-color);text-decoration:none;background-color:var(--bs-list-group-action-hover-bg)}.list-group-item-action:active{color:var(--bs-list-group-action-active-color);background-color:var(--bs-list-group-action-active-bg)}.list-group-item{position:relative;display:block;padding:var(--bs-list-group-item-padding-y) var(--bs-list-group-item-padding-x);color:var(--bs-list-group-color);background-color:var(--bs-list-group-bg);border:var(--bs-list-group-border-width) solid var(--bs-list-group-border-color)}.list-group-item:first-child{border-top-left-radius:inherit;border-top-right-radius:inherit}.list-group-item:last-child{border-bottom-right-radius:inherit;border-bottom-left-radius:inherit}.list-group-item.disabled,.list-group-item:disabled{color:var(--bs-list-group-disabled-color);pointer-events:none;background-color:var(--bs-list-group-disabled-bg)}.list-group-item.active{z-index:2;color:var(--bs-list-group-active-color);background-color:var(--bs-list-group-active-bg);border-color:var(--bs-list-group-active-border-color)}.list-group-item+.list-group-item{border-top-width:0}.list-group-item+.list-group-item.active{margin-top:calc(-1 * var(--bs-list-group-border-width));border-top-width:var(--bs-list-group-border-width)}.btn-close{--bs-btn-close-color: #000;--bs-btn-close-bg: url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='%23000'%3e%3cpath d='M.293.293a1 1 0 0 1 1.414 0L8 6.586 14.293.293a1 1 0 1 1 1.414 1.414L9.414 8l6.293 6.293a1 1 0 0 1-1.414 1.414L8 9.414l-6.293 6.293a1 1 0 0 1-1.414-1.414L6.586 8 .293 1.707a1 1 0 0 1 0-1.414z'/%3e%3c/svg%3e");--bs-btn-close-opacity: .5;--bs-btn-close-hover-opacity: .75;--bs-btn-close-focus-shadow: 0 0 0 .25rem rgba(51,71,255,0.25);--bs-btn-close-focus-opacity: 1;--bs-btn-close-disabled-opacity: .25;--bs-btn-close-white-filter: invert(1) grayscale(100%) brightness(200%);box-sizing:content-box;width:1em;height:1em;padding:.25em .25em;color:var(--bs-btn-close-color);background:transparent var(--bs-btn-close-bg) center/1em auto no-repeat;border:0;border-radius:.375rem;opacity:var(--bs-btn-close-opacity)}.btn-close:hover{color:var(--bs-btn-close-color);text-decoration:none;opacity:var(--bs-btn-close-hover-opacity)}.btn-close:focus{outline:0;box-shadow:var(--bs-btn-close-focus-shadow);opacity:var(--bs-btn-close-focus-opacity)}.btn-close:disabled,.btn-close.disabled{pointer-events:none;-webkit-user-select:none;-moz-user-select:none;user-select:none;opacity:var(--bs-btn-close-disabled-opacity)}[data-bs-theme="dark"] .btn-close{filter:var(--bs-btn-close-white-filter)}.modal{--bs-modal-zindex: 1055;--bs-modal-width: 500px;--bs-modal-padding: 1rem;--bs-modal-margin: .5rem;--bs-modal-color: ;--bs-modal-bg: var(--bs-body-bg);--bs-modal-border-color: var(--bs-border-color-translucent);--bs-modal-border-width: var(--bs-border-width);--bs-modal-border-radius: var(--bs-border-radius-lg);--bs-modal-box-shadow: 0 0.125rem 0.25rem rgba(0,0,0,0.075);--bs-modal-inner-border-radius: calc(var(--bs-border-radius-lg) - (var(--bs-border-width)));--bs-modal-header-padding-x: 1rem;--bs-modal-header-padding-y: 1rem;--bs-modal-header-padding: 1rem 1rem;--bs-modal-header-border-color: var(--bs-border-color);--bs-modal-header-border-width: var(--bs-border-width);--bs-modal-title-line-height: 1.5;--bs-modal-footer-gap: .5rem;--bs-modal-footer-bg: ;--bs-modal-footer-border-color: var(--bs-border-color);--bs-modal-footer-border-width: var(--bs-border-width);position:fixed;top:0;left:0;z-index:var(--bs-modal-zindex);display:none;width:100%;height:100%;overflow-x:hidden;overflow-y:auto;outline:0}.modal-dialog{position:relative;width:auto;margin:var(--bs-modal-margin);pointer-events:none}.modal.fade .modal-dialog{transition:transform 0.3s ease-out;transform:translate(0, -50px)}@media (prefers-reduced-motion: reduce){.modal.fade .modal-dialog{transition:none}}.modal.show .modal-dialog{transform:none}.modal-dialog-scrollable{height:calc(100% - var(--bs-modal-margin) * 2)}.modal-dialog-scrollable .modal-content{max-height:100%;overflow:hidden}.modal-dialog-scrollable .modal-body{overflow-y:auto}.modal-content{position:relative;display:flex;flex-direction:column;width:100%;color:var(--bs-modal-color);pointer-events:auto;background-color:var(--bs-modal-bg);background-clip:padding-box;border:var(--bs-modal-border-width) solid var(--bs-modal-border-color);border-radius:var(--bs-modal-border-radius);outline:0}.modal-backdrop{--bs-backdrop-zindex: 1050;--bs-backdrop-bg: #000;--bs-backdrop-opacity: .5;position:fixed;top:0;left:0;z-index:var(--bs-backdrop-zindex);width:100vw;height:100vh;background-color:var(--bs-backdrop-bg)}.modal-backdrop.fade{opacity:0}.modal-backdrop.show{opacity:var(--bs-backdrop-opacity)}.modal-header{display:flex;flex-shrink:0;align-items:center;justify-content:space-between;padding:var(--bs-modal-header-padding);border-bottom:var(--bs-modal-header-border-width) solid var(--bs-modal-header-border-color);border-top-left-radius:var(--bs-modal-inner-border-radius);border-top-right-radius:var(--bs-modal-inner-border-radius)}.modal-header .btn-close{padding:calc(var(--bs-modal-header-padding-y) * .5) calc(var(--bs-modal-header-padding-x) * .5);margin:calc(-.5 * var(--bs-modal-header-padding-y)) calc(-.5 * var(--bs-modal-header-padding-x)) calc(-.5 * var(--bs-modal-header-padding-y)) auto}.modal-title{margin-bottom:0;line-height:var(--bs-modal-title-line-height)}.modal-body{position:relative;flex:1 1 auto;padding:var(--bs-modal-padding)}.modal-footer{display:flex;flex-shrink:0;flex-wrap:wrap;align-items:center;justify-content:flex-end;padding:calc(var(--bs-modal-padding) - var(--bs-modal-footer-gap) * .5);background-color:var(--bs-modal-footer-bg);border-top:var(--bs-modal-footer-border-width) solid var(--bs-modal-footer-border-color);border-bottom-right-radius:var(--bs-modal-inner-border-radius);border-bottom-left-radius:var(--bs-modal-inner-border-radius)}.modal-footer>*{margin:calc(var(--bs-modal-footer-gap) * .5)}@media (min-width: 576px){.modal{--bs-modal-margin: 1.75rem;--bs-modal-box-shadow: 0 0.5rem 1rem rgba(0,0,0,0.15)}.modal-dialog{max-width:var(--bs-modal-width);margin-right:auto;margin-left:auto}}@media (max-width: 767.98px){.modal-fullscreen-md-down{width:100vw;max-width:none;height:100%;margin:0}.modal-fullscreen-md-down .modal-content{height:100%;border:0;border-radius:0}.modal-fullscreen-md-down .modal-header,.modal-fullscreen-md-down .modal-footer{border-radius:0}.modal-fullscreen-md-down .modal-body{overflow-y:auto}}@keyframes spinner-border{to{transform:rotate(360deg) /* rtl:ignore */}}@keyframes spinner-grow{0%{transform:scale(0)}50%{opacity:1;transform:none}}.offcanvas{--bs-offcanvas-zindex: 1045;--bs-offcanvas-width: 332px;--bs-offcanvas-height: 30vh;--bs-offcanvas-padding-x: 1rem;--bs-offcanvas-padding-y: 1rem;--bs-offcanvas-color: var(--bs-body-color);--bs-offcanvas-bg: var(--bs-body-bg);--bs-offcanvas-border-width: var(--bs-border-width);--bs-offcanvas-border-color: var(--bs-border-color-translucent);--bs-offcanvas-box-shadow: 0 0.125rem 0.25rem rgba(0,0,0,0.075);--bs-offcanvas-transition: transform .3s ease-in-out;--bs-offcanvas-title-line-height: 1.5}.offcanvas{position:fixed;bottom:0;z-index:var(--bs-offcanvas-zindex);display:flex;flex-direction:column;max-width:100%;color:var(--bs-offcanvas-color);visibility:hidden;background-color:var(--bs-offcanvas-bg);background-clip:padding-box;outline:0;transition:var(--bs-offcanvas-transition)}@media (prefers-reduced-motion: reduce){.offcanvas{transition:none}}.offcanvas.offcanvas-start{top:0;left:0;width:var(--bs-offcanvas-width);border-right:var(--bs-offcanvas-border-width) solid var(--bs-offcanvas-border-color);transform:translateX(-100%)}.offcanvas.offcanvas-end{top:0;right:0;width:var(--bs-offcanvas-width);border-left:var(--bs-offcanvas-border-width) solid var(--bs-offcanvas-border-color);transform:translateX(100%)}.offcanvas.showing,.offcanvas.show:not(.hiding){transform:none}.offcanvas.showing,.offcanvas.hiding,.offcanvas.show{visibility:visible}.offcanvas-backdrop{position:fixed;top:0;left:0;z-index:1040;width:100vw;height:100vh;background-color:#000}.offcanvas-backdrop.fade{opacity:0}.offcanvas-backdrop.show{opacity:.5}.offcanvas-header{display:flex;align-items:center;justify-content:space-between;padding:var(--bs-offcanvas-padding-y) var(--bs-offcanvas-padding-x)}.offcanvas-header .btn-close{padding:calc(var(--bs-offcanvas-padding-y) * .5) calc(var(--bs-offcanvas-padding-x) * .5);margin-top:calc(-.5 * var(--bs-offcanvas-padding-y));margin-right:calc(-.5 * var(--bs-offcanvas-padding-x));margin-bottom:calc(-.5 * var(--bs-offcanvas-padding-y))}.offcanvas-title{margin-bottom:0;line-height:var(--bs-offcanvas-title-line-height)}.offcanvas-body{flex-grow:1;padding:var(--bs-offcanvas-padding-y) var(--bs-offcanvas-padding-x);overflow-y:auto}.placeholder{display:inline-block;min-height:1em;vertical-align:middle;cursor:wait;background-color:currentcolor;opacity:.5}.placeholder.btn::before{display:inline-block;content:""}@keyframes placeholder-glow{50%{opacity:.2}}@keyframes placeholder-wave{100%{-webkit-mask-position:-200% 0%;mask-position:-200% 0%}}.ratio{position:relative;width:100%}.ratio::before{display:block;padding-top:var(--bs-aspect-ratio);content:""}.ratio>*{position:absolute;top:0;left:0;width:100%;height:100%}.sticky-top{position:sticky;top:0;z-index:1020}.visually-hidden{width:1px !important;height:1px !important;padding:0 !important;margin:-1px !important;overflow:hidden !important;clip:rect(0, 0, 0, 0) !important;white-space:nowrap !important;border:0 !important}.visually-hidden:not(caption){position:absolute !important}.stretched-link::after{position:absolute;top:0;right:0;bottom:0;left:0;z-index:1;content:""}.d-flex{display:flex !important}.d-inline-flex{display:inline-flex !important}.d-none{display:none !important}.shadow{box-shadow:var(--bs-box-shadow) !important}.position-relative{position:relative !important}.border-0{border:0 !important}.w-100{width:100% !important}.w-auto{width:auto !important}.h-auto{height:auto !important}.flex-row{flex-direction:row !important}.flex-column{flex-direction:column !important}.flex-grow-1{flex-grow:1 !important}.justify-content-start{justify-content:flex-start !important}.justify-content-end{justify-content:flex-end !important}.justify-content-center{justify-content:center !important}.justify-content-between{justify-content:space-between !important}.align-items-center{align-items:center !important}.order-3{order:3 !important}.m-2{margin:.5rem !important}.mx-1{margin-right:.25rem !important;margin-left:.25rem !important}.mx-2{margin-right:.5rem !important;margin-left:.5rem !important}.mx-auto{margin-right:auto !important;margin-left:auto !important}.my-1{margin-top:.25rem !important;margin-bottom:.25rem !important}.my-2{margin-top:.5rem !important;margin-bottom:.5rem !important}.my-3{margin-top:1rem !important;margin-bottom:1rem !important}.mt-1{margin-top:.25rem !important}.mt-2{margin-top:.5rem !important}.mt-3{margin-top:1rem !important}.me-2{margin-right:.5rem !important}.me-auto{margin-right:auto !important}.mb-0{margin-bottom:0 !important}.mb-1{margin-bottom:.25rem !important}.mb-2{margin-bottom:.5rem !important}.mb-4{margin-bottom:1.5rem !important}.ms-2{margin-left:.5rem !important}.ms-3{margin-left:1rem !important}.ms-auto{margin-left:auto !important}.my-n3{margin-top:-1rem !important;margin-bottom:-1rem !important}.mt-n3{margin-top:-1rem !important}.p-0{padding:0 !important}.p-2{padding:.5rem !important}.px-0{padding-right:0 !important;padding-left:0 !important}.px-4{padding-right:1.5rem !important;padding-left:1.5rem !important}.py-2{padding-top:.5rem !important;padding-bottom:.5rem !important}.pe-4{padding-right:1.5rem !important}.pb-1{padding-bottom:.25rem !important}.pb-3{padding-bottom:1rem !important}.pb-4{padding-bottom:1.5rem !important}.fs-5{font-size:1.25rem !important}.fw-normal{font-weight:400 !important}.fw-bold{font-weight:700 !important}.text-end{text-align:right !important}.text-center{text-align:center !important}.text-decoration-none{text-decoration:none !important}.text-uppercase{text-transform:uppercase !important}.text-primary{--bs-text-opacity: 1;color:rgba(var(--bs-primary-rgb), var(--bs-text-opacity)) !important}.text-body{--bs-text-opacity: 1;color:rgba(var(--bs-body-color-rgb), var(--bs-text-opacity)) !important}.text-muted{--bs-text-opacity: 1;color:var(--bs-secondary-color) !important}.text-body-secondary{--bs-text-opacity: 1;color:var(--bs-secondary-color) !important}.text-reset{--bs-text-opacity: 1;color:inherit !important}.bg-primary{--bs-bg-opacity: 1;background-color:rgba(var(--bs-primary-rgb), var(--bs-bg-opacity)) !important}.bg-light{--bs-bg-opacity: 1;background-color:rgba(var(--bs-light-rgb), var(--bs-bg-opacity)) !important}.rounded{border-radius:var(--bs-border-radius) !important}.rounded-0{border-radius:0 !important}.rounded-circle{border-radius:50% !important}.rounded-pill{border-radius:var(--bs-border-radius-pill) !important}@media (min-width: 576px){.flex-sm-row{flex-direction:row !important}}@media (min-width: 768px){.d-md-block{display:block !important}.d-md-none{display:none !important}.flex-md-row{flex-direction:row !important}}@media (min-width: 992px){.d-lg-block{display:block !important}.d-lg-flex{display:flex !important}.d-lg-none{display:none !important}.flex-lg-row{flex-direction:row !important}.order-lg-2{order:2 !important}.order-lg-3{order:3 !important}.order-lg-4{order:4 !important}.me-lg-1{margin-right:.25rem !important}.me-lg-2{margin-right:.5rem !important}.me-lg-3{margin-right:1rem !important}.ms-lg-2{margin-left:.5rem !important}.text-lg-start{text-align:left !important}.text-lg-end{text-align:right !important}}@media (min-width: 1200px){.d-xl-block{display:block !important}.d-xl-none{display:none !important}.flex-xl-nowrap{flex-wrap:nowrap !important}.mx-xl-auto{margin-right:auto !important;margin-left:auto !important}}@font-face{font-family:Jost;font-style:normal;font-weight:400;font-display:swap;src:local("Jost Regular Regular"),local("Jost-Regular"),local("Jost* Book"),local("Jost-Book"),url("fonts/vendor/jost/jost-v4-latin-regular.woff2") format("woff2"),url("fonts/vendor/jost/jost-v4-latin-regular.woff") format("woff")}@font-face{font-family:Jost;font-style:normal;font-weight:500;font-display:swap;src:local("Jost Regular Medium"),local("JostRoman-Medium"),local("Jost* Medium"),local("Jost-Medium"),url("fonts/vendor/jost/jost-v4-latin-500.woff2") format("woff2"),url("fonts/vendor/jost/jost-v4-latin-500.woff") format("woff")}@font-face{font-family:Jost;font-style:normal;font-weight:700;font-display:swap;src:local("Jost Regular Bold"),local("JostRoman-Bold"),local("Jost* Bold"),local("Jost-Bold"),url("fonts/vendor/jost/jost-v4-latin-700.woff2") format("woff2"),url("fonts/vendor/jost/jost-v4-latin-700.woff") format("woff")}@font-face{font-family:Jost;font-style:italic;font-weight:400;font-display:swap;src:local("Jost Italic Italic"),local("Jost-Italic"),local("Jost* BookItalic"),local("Jost-BookItalic"),url("fonts/vendor/jost/jost-v4-latin-italic.woff2") format("woff2"),url("fonts/vendor/jost/jost-v4-latin-italic.woff") format("woff")}@font-face{font-family:Jost;font-style:italic;font-weight:500;font-display:swap;src:local("Jost Italic Medium Italic"),local("JostItalic-Medium"),local("Jost* Medium Italic"),local("Jost-MediumItalic"),url("fonts/vendor/jost/jost-v4-latin-500italic.woff2") format("woff2"),url("fonts/vendor/jost/jost-v4-latin-500italic.woff") format("woff")}@font-face{font-family:Jost;font-style:italic;font-weight:700;font-display:swap;src:local("Jost Italic Bold Italic"),local("JostItalic-Bold"),local("Jost* Bold Italic"),local("Jost-BoldItalic"),url("fonts/vendor/jost/jost-v4-latin-700italic.woff2") format("woff2"),url("fonts/vendor/jost/jost-v4-latin-700italic.woff") format("woff")}html[data-bs-theme="dark"] .icon-tabler-sun{display:block}html[data-bs-theme="dark"] .icon-tabler-moon{display:none}html[data-bs-theme="light"] .icon-tabler-sun{display:none}html[data-bs-theme="light"] .icon-tabler-moon{display:block}.privacy .content,.terms .content,.about .content,.contributors .content,.blog .content,.page .content,.error404 .content,.docs.list .content,.tutorial.list .content,.showcase.list .content,.categories.list .content,.tags.list .content,.list.section .content{padding-top:1rem;padding-bottom:3rem}.content img{max-width:100%}h6,.h6,h5,.h5,h4,.h4,h3,.h3,h2,.h2,h1,.h1{margin-top:2rem;margin-bottom:1rem}@media (min-width: 768px){body{font-size:1.125rem}h1,h2,h3,h4,h5,h6,.h1,.h2,.h3,.h4,.h5,.h6{margin-bottom:1.125rem}}.home h1,.home .h1{font-size:calc(1.875rem + 1.5vw);margin-top:-1rem}a:hover,a:focus{text-decoration:underline}.docs-navigation .card{transition:transform 0.3s}.docs-navigation .card:hover{transform:scale(1.025)}a.btn:hover,a.btn:focus{text-decoration:none}.section{padding-top:5rem;padding-bottom:5rem}body.section{padding-top:0;padding-bottom:0}.section-md{padding-top:3rem;padding-bottom:3rem}.section-sm{padding-top:1rem;padding-bottom:1rem}.docs-sidebar{order:2}@media (min-width: 992px){.docs-sidebar{order:0;border-right:1px solid #e9ecef}@supports (position: sticky){.docs-sidebar{position:sticky;top:4.25rem;z-index:1000;height:calc(100vh - 4.25rem)}.docs-sidebar-offset{top:4.5rem;height:calc(100vh - 4.5rem)}.docs-sidebar-top{position:static}}}@media (min-width: 1200px){.docs-sidebar{flex:0 1 320px}}.docs-links{padding-bottom:5rem}@media (min-width: 992px){@supports (position: sticky){.docs-links{max-height:calc(100vh - 4rem);overflow-y:scroll}}}@media (min-width: 992px){.docs-links{display:block;width:auto;margin-right:-1.5rem;padding-bottom:4rem}}.docs-toc{order:2}@supports (position: sticky){.docs-toc{position:sticky;top:4.25rem;height:calc(100vh - 4.25rem);overflow-y:auto}.docs-toc-offset{top:4.5rem;height:calc(100vh - 4.5rem)}.docs-toc-top{position:static}}.docs-content{padding-bottom:3rem;order:1}.docs-navigation{border-top:1px solid #e9ecef;margin-top:2rem;margin-bottom:0;padding-top:2rem}.docs-navigation a{font-size:.9rem}@media (min-width: 992px){.docs-navigation{margin-bottom:-1rem}.docs-navigation a{font-size:1rem}}.docs-navigation a:hover,.docs-navigation a:focus{text-decoration:none}.navbar a:hover,.navbar a:focus{text-decoration:none}#TableOfContents ul,#toc ul{padding-left:0;list-style:none}#toc a.active{color:#3347ff;font-weight:500}.section-features{padding-top:2rem}.bg-dots{background-image:radial-gradient(#dee2e6 15%, transparent 15%);background-position:0 0;background-size:1rem 1rem;-webkit-mask:linear-gradient(to top, #fff, transparent);mask:linear-gradient(to top, #fff, transparent);width:100%;height:11rem;margin-top:-10rem;z-index:-1}.bg-dots-md{margin-top:-11rem}.bg-dots-lg{margin-top:-12rem}.gradient-text{background-color:#3347ff;background-image:linear-gradient(90deg, #3347ff, #b3c7ff 50%, var(--sl-color-blue));background-size:100%;background-repeat:repeat;-webkit-background-clip:text;-moz-background-clip:text;-webkit-text-fill-color:transparent;-moz-text-fill-color:transparent}.katex{font-size:1.125rem}.card-bar{border-top:4px solid;border-image-source:linear-gradient(90deg, #3347ff, #b3c7ff 50%, var(--sl-color-blue));border-image-slice:1}.modal-backdrop{background-color:#fff}.modal-backdrop.show{opacity:0.7}@media (min-width: 768px){.modal-backdrop.show{opacity:0}}sup[id]::after{display:block;height:6rem;margin-top:-6rem;content:""}a.footnote-backref{text-decoration:none}li input[type="checkbox"]{margin:0.25rem;border:1px solid #ced4da}li input[type="checkbox"]:disabled{pointer-events:none;filter:none;opacity:1}li input[type="checkbox"]:checked{background-color:#5d2f86;border-color:#5d2f86}[data-bs-theme="dark"] li input[type="checkbox"]{border:1px solid #6c757d}[data-bs-theme="dark"] li input[type="checkbox"]:checked{background-color:#b3c7ff;border-color:#b3c7ff;--bs-form-check-bg-image: url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 20 20'%3e%3cpath fill='none' stroke='%231d2d35' stroke-linecap='round' stroke-linejoin='round' stroke-width='3' d='m6 10 3 3 6-6'/%3e%3c/svg%3e")}.content .svg-inline{margin-bottom:1.5rem}.content .svg-inline:not(.svg-inline-custom){height:1.875rem;width:1.875rem;stroke-width:1.5}.logo-netlify-large-fullcolor-darkmode{display:none}[data-bs-theme="dark"] .logo-netlify-large-fullcolor-darkmode{display:block}.svg-lightmode{display:block}.svg-darkmode{display:none}.svg-monochrome path{fill:#1d2d35}[data-bs-theme="dark"] .svg-lightmode{display:none}[data-bs-theme="dark"] .svg-darkmode{display:block}[data-bs-theme="dark"] .svg-monochrome path{fill:var(--sl-color-gray-1)}hr{border-color:gray}[data-bs-theme="dark"] hr{border-color:var(--sl-color-gray-3)}[data-bs-theme="dark"] h1,[data-bs-theme="dark"] .h1,[data-bs-theme="dark"] h2,[data-bs-theme="dark"] .h2,[data-bs-theme="dark"] h3,[data-bs-theme="dark"] .h3,[data-bs-theme="dark"] h4,[data-bs-theme="dark"] .h4{color:#fff}[data-bs-theme="dark"] body{background:#17181c;color:#c1c3c8}[data-bs-theme="dark"] a{color:#b3c7ff}[data-bs-theme="dark"] .callout a{color:inherit}[data-bs-theme="dark"] .btn-primary{--bs-btn-color: #000;--bs-btn-bg: #b3c7ff;--bs-btn-border-color: #b3c7ff;--bs-btn-hover-color: #000;--bs-btn-hover-bg: #becfff;--bs-btn-hover-border-color: #bacdff;--bs-btn-focus-shadow-rgb: 152,169,217;--bs-btn-active-color: #000;--bs-btn-active-bg: #c2d2ff;--bs-btn-active-border-color: #bacdff;--bs-btn-active-shadow: inset 0 3px 5px rgba(0,0,0,0.125);--bs-btn-disabled-color: #000;--bs-btn-disabled-bg: #b3c7ff;--bs-btn-disabled-border-color: #b3c7ff;color:#17181c}[data-bs-theme="dark"] .navbar{background-color:rgba(23,24,28,0.95);border-bottom:1px solid #23262f}[data-bs-theme="dark"] body.home .navbar{border-bottom:0}[data-bs-theme="dark"] .offcanvas-header{border-bottom:1px solid #343a40}[data-bs-theme="dark"] .offcanvas .nav-link{color:#c1c3c8}[data-bs-theme="dark"] .offcanvas .nav-link:hover,[data-bs-theme="dark"] .offcanvas .nav-link:focus{color:#b3c7ff}[data-bs-theme="dark"] .offcanvas .nav-link.active{color:#b3c7ff}[data-bs-theme="dark"] .alert-primary a{color:#17181c}[data-bs-theme="dark"] .alert-doks{background:#23262f;color:#c1c3c8}[data-bs-theme="dark"] .alert-doks a{color:#b3c7ff}[data-bs-theme="dark"] .page-links a{color:#c1c3c8}[data-bs-theme="dark"] .btn-toggle-nav a{color:#c1c3c8}[data-bs-theme="dark"] .docs-link:hover,[data-bs-theme="dark"] .docs-link.active,[data-bs-theme="dark"] .page-links a:hover{text-decoration:none;color:#b3c7ff}[data-bs-theme="dark"] .btn-toggle{color:#c1c3c8;background-color:transparent;border:0}[data-bs-theme="dark"] .btn-toggle:hover,[data-bs-theme="dark"] .btn-toggle:focus{color:#c1c3c8}[data-bs-theme="dark"] .btn-toggle::before{width:1.25em;line-height:0;content:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' width='14' height='14' viewBox='0 0 16 16'%3e%3cpath fill='none' stroke='rgba%28222, 226, 230, 0.75%29' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M5 14l6-6-6-6'/%3e%3c/svg%3e");transition:transform 0.35s ease;transform-origin:0.5em 50%;margin-bottom:0.125rem}[data-bs-theme="dark"] .btn-toggle[aria-expanded="true"]{color:#c1c3c8}[data-bs-theme="dark"] .btn-toggle[aria-expanded="true"]::before{transform:rotate(90deg)}[data-bs-theme="dark"] .btn-toggle-nav a:hover,[data-bs-theme="dark"] .btn-toggle-nav a:focus{color:#b3c7ff}[data-bs-theme="dark"] .btn-toggle-nav a.active{color:#b3c7ff}[data-bs-theme="dark"] .navbar .btn-link{color:#c1c3c8}[data-bs-theme="dark"] .content .btn-link{color:#b3c7ff}[data-bs-theme="dark"] .content .btn-link:hover{color:#b3c7ff}[data-bs-theme="dark"] .navbar .btn-link:hover{color:#b3c7ff}[data-bs-theme="dark"] .navbar .btn-link:active{color:#b3c7ff}[data-bs-theme="dark"] .form-control{color:#dee2e6}[data-bs-theme="dark"] .form-control::-moz-placeholder{color:#ced4da;opacity:1}[data-bs-theme="dark"] .form-control::placeholder{color:#ced4da;opacity:1}@media (min-width: 992px){[data-bs-theme="dark"] .docs-sidebar{order:0;border-right:1px solid #23262f}}[data-bs-theme="dark"] .docs-navigation{border-top:1px solid #23262f}[data-bs-theme="dark"] pre code::-webkit-scrollbar-thumb{background:#ced4da}[data-bs-theme="dark"] code:not(.hljs){background:#23262f;color:#c1c3c8}[data-bs-theme="dark"] pre code:hover{scrollbar-width:thin;scrollbar-color:#23262f transparent}[data-bs-theme="dark"] pre code::-webkit-scrollbar-thumb:hover{background:#adb5bd}[data-bs-theme="dark"] .footer{border-top:1px solid #23262f}[data-bs-theme="dark"] .docs-links,[data-bs-theme="dark"] .docs-toc{scrollbar-width:thin;scrollbar-color:#17181c #17181c}[data-bs-theme="dark"] .docs-links::-webkit-scrollbar,[data-bs-theme="dark"] .docs-toc::-webkit-scrollbar{width:5px}[data-bs-theme="dark"] .docs-links::-webkit-scrollbar-track,[data-bs-theme="dark"] .docs-toc::-webkit-scrollbar-track{background:#17181c}[data-bs-theme="dark"] .docs-links::-webkit-scrollbar-thumb,[data-bs-theme="dark"] .docs-toc::-webkit-scrollbar-thumb{background:#17181c}[data-bs-theme="dark"] .docs-links:hover,[data-bs-theme="dark"] .docs-toc:hover{scrollbar-width:thin;scrollbar-color:#23262f #17181c}[data-bs-theme="dark"] .docs-links:hover::-webkit-scrollbar-thumb,[data-bs-theme="dark"] .docs-toc:hover::-webkit-scrollbar-thumb{background:#23262f}[data-bs-theme="dark"] .docs-links::-webkit-scrollbar-thumb:hover,[data-bs-theme="dark"] .docs-toc::-webkit-scrollbar-thumb:hover{background:#23262f}[data-bs-theme="dark"] .docs-links h3:not(:first-child),[data-bs-theme="dark"] .docs-links .h3:not(:first-child){border-top:1px solid #23262f}[data-bs-theme="dark"] a.docs-link{color:#c1c3c8}[data-bs-theme="dark"] .page-links li:not(:first-child){border-top:1px dashed #23262f}[data-bs-theme="dark"] .card{background:#17181c;border:1px solid #23262f}[data-bs-theme="dark"] .card.bg-light{background:#23262f !important}[data-bs-theme="dark"] .bg-light{background:#141518 !important}[data-bs-theme="dark"] .bg-dots{background-image:radial-gradient(#414349 15%, transparent 15%)}[data-bs-theme="dark"] .text-muted{color:#adafb6 !important}[data-bs-theme="dark"] .alert-primary{background:#b3c7ff;color:#17181c}[data-bs-theme="dark"] .offcanvas{background-color:#17181c}[data-bs-theme="dark"] .alert-dismissible .btn-close{background-image:url("data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNCIgaGVpZ2h0PSIyNCIgdmlld0JveD0iMCAwIDI0IDI0IiBmaWxsPSJub25lIiBzdHJva2U9IiNkZWUyZTYiIHN0cm9rZS13aWR0aD0iMiIgc3Ryb2tlLWxpbmVjYXA9InJvdW5kIiBzdHJva2UtbGluZWpvaW49InJvdW5kIiBjbGFzcz0iZmVhdGhlciBmZWF0aGVyLXgiPjxsaW5lIHgxPSIxOCIgeTE9IjYiIHgyPSI2IiB5Mj0iMTgiPjwvbGluZT48bGluZSB4MT0iNiIgeTE9IjYiIHgyPSIxOCIgeTI9IjE4Ij48L2xpbmU+PC9zdmc+");background-size:1.5rem}[data-bs-theme="dark"] .dropdown-item{color:#17181c}[data-bs-theme="dark"] .dropdown-menu{background:#23262f}[data-bs-theme="dark"] .dropdown-menu .dropdown-item{color:#c1c3c8}[data-bs-theme="dark"] .dropdown-menu .dropdown-item.untranslated{color:#6c757d;text-decoration:line-through}[data-bs-theme="dark"] .dropdown-menu .dropdown-item.untranslated:focus-visible,[data-bs-theme="dark"] .dropdown-menu .dropdown-item.untranslated:hover{background-image:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' class='icon icon-tabler icon-tabler-home' width='24' height='24' viewBox='0 0 24 24' stroke-width='2' stroke='%23b3c7ff' fill='none' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath stroke='none' d='M0 0h24v24H0z' fill='none'/%3E%3Cpath d='M5 12l-2 0l9 -9l9 9l-2 0' /%3E%3Cpath d='M5 12v7a2 2 0 0 0 2 2h10a2 2 0 0 0 2 -2v-7' /%3E%3Cpath d='M9 21v-6a2 2 0 0 1 2 -2h2a2 2 0 0 1 2 2v6' /%3E%3C/svg%3E");background-repeat:no-repeat;background-position:right 1rem top 0.6rem;background-size:0.9rem 0.9rem;text-decoration:unset}[data-bs-theme="dark"] .dropdown-menu .dropdown-item:hover{color:#b3c7ff;background:#17181c}[data-bs-theme="dark"] .dropdown-menu .dropdown-item.active,[data-bs-theme="dark"] .dropdown-menu .dropdown-item:focus{color:#b3c7ff;background:#17181c}[data-bs-theme="dark"] .navbar .dropdown-item.current{background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 8 8'%3e%3cpath fill='%23dee2e6' d='M2.3 6.73L.6 4.53c-.4-1.04.46-1.4 1.1-.8l1.1 1.4 3.4-3.8c.6-.63 1.6-.27 1.2.7l-4 4.6c-.43.5-.8.4-1.1.1z'/%3e%3c/svg%3e");background-repeat:no-repeat;background-position:right 1rem top 0.6rem;background-size:0.75rem 0.75rem}[data-bs-theme="dark"] details{border:1px solid #23262f}[data-bs-theme="dark"] summary:hover{background:#23262f}[data-bs-theme="dark"] details[open]>summary{border-bottom:1px solid #23262f}[data-bs-theme="dark"] details summary::after{content:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' width='14' height='14' viewBox='0 0 16 16'%3e%3cpath fill='none' stroke='rgba%28222, 226, 230, 0.75%29' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M5 14l6-6-6-6'/%3e%3c/svg%3e")}[data-bs-theme="dark"] #toc a.active{color:#b3c7ff}[data-bs-theme="dark"] .btn-light{color:#b3c7ff;background:#23262f;border:1px solid #23262f}[data-bs-theme="dark"] table th{color:#fff}[data-bs-theme="dark"] table,[data-bs-theme="dark"] [data-bs-theme="dark"] table{--bs-table-color: inherit;--bs-table-bg: $body-bg-dark;background:#17181c;border-color:#23262f}.alert{font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace;font-size:.875rem}.alert-icon{margin-right:0.75rem}.docs main .alert{margin:2rem -1.5rem}.alert .alert-link,.alert .callout a,.callout .alert a{text-decoration:underline}.alert-doks{background:#fbf7f0;color:#1d2d35}.alert-white{background-color:rgba(255,255,255,0.95)}.alert-primary{color:#fff;background-color:#3347ff}.alert a{text-decoration:underline}.alert-primary .alert-link,.alert-primary .callout a,.callout .alert-primary a{color:#fff}.alert-secondary{color:#41464b;background-color:#e2e3e5;border-color:#d3d6d8}.alert-secondary .alert-link,.alert-secondary .callout a,.callout .alert-secondary a{color:#34383c}.alert-success{color:#0f5132;background-color:#d1e7dd;border-color:#badbcc}.alert-success .alert-link,.alert-success .callout a,.callout .alert-success a{color:#0c4128}.alert-info{color:#055160;background-color:#cff4fc;border-color:#b6effb}.alert-info .alert-link,.alert-info .callout a,.callout .alert-info a{color:#04414d}.alert-warning{color:#664d03;background-color:#fff3cd;border-color:#ffecb5}.alert-warning .alert-link,.alert-warning .callout a,.callout .alert-warning a{color:#523e02}.alert-danger{color:#842029;background-color:#f8d7da;border-color:#f5c2c7}.alert-danger .alert-link,.alert-danger .callout a,.callout .alert-danger a{color:#6a1a21}.alert-light{color:#636464;background-color:#fefefe;border-color:#fdfdfe}.alert-light .alert-link,.alert-light .callout a,.callout .alert-light a{color:#4f5050}.alert-dark{color:#141619;background-color:#d3d3d4;border-color:#bcbebf}.alert-dark .alert-link,.alert-dark .callout a,.callout .alert-dark a{color:#101214}.alert .alert-link:hover,.alert .callout a:hover,.callout .alert a:hover,.alert .alert-link:focus,.alert .callout a:focus,.callout .alert a:focus{text-decoration:none}.alert-text{margin-right:-3rem;font-size:1rem}.alert-dismissible .btn-close{position:absolute;top:50%;transform:translateY(-50%);right:1rem;z-index:2;padding:0.5rem;background-image:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='32' height='32' viewBox='0 0 24 24' fill='none' stroke='currentColor' stroke-width='2' stroke-linecap='round' stroke-linejoin='round' class='feather feather-x'%3E%3Cline x1='18' y1='6' x2='6' y2='18'%3E%3C/line%3E%3Cline x1='6' y1='6' x2='18' y2='18'%3E%3C/line%3E%3C/svg%3E");background-size:1.5rem;filter:invert(1) grayscale(100%) brightness(200%)}.btn-close:focus,.btn-close:active{outline:none;box-shadow:none}@media (min-width: 768px){.alert-dismissible .btn-close{background-size:1.5rem}}[data-global-alert="closed"] #announcement{display:none}.alert code{background:#f6ecdc;color:#1d2d35;padding:0.25rem 0.5rem}.navbar .btn-link{color:rgba(var(--bs-emphasis-color-rgb), 0.65);padding:0.4375rem 0}#mode{padding:0.5rem}.btn-link:focus{outline:0;box-shadow:none}#navigation{margin-left:1.25rem}@media (min-width: 992px){#mode{margin-left:0.5rem;margin-right:0.25rem}.navbar .btn-link{padding:0.5625em 0.25rem 0.5rem 0.125rem}}.navbar .btn-link:hover{color:rgba(var(--bs-emphasis-color-rgb), 0.8)}.navbar .btn-link:active{color:rgba(var(--bs-emphasis-color-rgb), 1)}body .toggle-dark{display:block}body .toggle-light{display:none}[data-dark-mode] body .toggle-light{display:block}[data-dark-mode] body .toggle-dark{display:none}.collapsible-sidebar{margin:2.125rem 0}.btn-toggle{display:inline-flex;align-items:center;padding:0.25rem 0.5rem 0.25rem 0;font-weight:700;font-size:1rem;text-transform:uppercase;color:#1d2d35;background-color:transparent;border:0}.btn-toggle:hover,.btn-toggle:focus{color:#1d2d35;background-color:transparent;outline:0;box-shadow:none}.btn-toggle::before{width:1.25em;line-height:0;content:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' width='14' height='14' viewBox='0 0 16 16'%3e%3cpath fill='none' stroke='rgba%2829, 45, 53, 0.75%29' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M5 14l6-6-6-6'/%3e%3c/svg%3e");transition:transform 0.35s ease;transform-origin:0.5em 50%;margin-bottom:0.125rem}.btn-toggle[aria-expanded="true"]{color:#1d2d35}.btn-toggle[aria-expanded="true"]::before{transform:rotate(90deg)}.btn-toggle-nav a{display:inline-flex;padding:0.1875rem 0.5rem;margin-top:0.125rem;margin-left:1.25rem;text-decoration:none}.btn-toggle-nav a:hover,.btn-toggle-nav a:focus{background-color:transparent;color:#3347ff}.btn-toggle-nav a.active{color:#3347ff}@media (max-width: 991.98px){.dropdown-menu{width:100%;position:static}}.btn-dropdown{border:0}@media (max-width: 991.98px){.btn-dropdown{width:100%;text-align:left;padding-left:0;padding-right:0}}.navbar .dropdown-item.current{font-weight:600;background-image:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 8 8'%3e%3cpath fill='%23292b2c' d='M2.3 6.73L.6 4.53c-.4-1.04.46-1.4 1.1-.8l1.1 1.4 3.4-3.8c.6-.63 1.6-.27 1.2.7l-4 4.6c-.43.5-.8.4-1.1.1z'/%3e%3c/svg%3e");background-repeat:no-repeat;background-position:right 1rem top 0.6rem;background-size:0.75rem 0.75rem}@media (max-width: 991.98px){.navbar .dropdown-item.current{background-position:right 0.375rem top 0.6rem}}.btn-close{background-image:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='32' height='32' viewBox='0 0 24 24' fill='none' stroke='currentColor' stroke-width='2' stroke-linecap='round' stroke-linejoin='round' class='feather feather-x'%3E%3Cline x1='18' y1='6' x2='6' y2='18'%3E%3C/line%3E%3Cline x1='6' y1='6' x2='18' y2='18'%3E%3C/line%3E%3C/svg%3E");background-size:1.5rem}.offcanvas-header .btn-close{margin-right:0 !important}.dropdown-toggle::after{display:none}.dropdown-caret{margin-left:-0.1875rem;margin-right:-0.3125rem}.dropdown-menu .dropdown-item.untranslated{color:#6c757d;text-decoration:line-through}.dropdown-menu .dropdown-item.untranslated:focus-visible,.dropdown-menu .dropdown-item.untranslated:hover{background-image:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' class='icon icon-tabler icon-tabler-home' width='24' height='24' viewBox='0 0 24 24' stroke-width='2' stroke='%233347ff' fill='none' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath stroke='none' d='M0 0h24v24H0z' fill='none'/%3E%3Cpath d='M5 12l-2 0l9 -9l9 9l-2 0' /%3E%3Cpath d='M5 12v7a2 2 0 0 0 2 2h10a2 2 0 0 0 2 -2v-7' /%3E%3Cpath d='M9 21v-6a2 2 0 0 1 2 -2h2a2 2 0 0 1 2 2v6' /%3E%3C/svg%3E");background-repeat:no-repeat;background-position:right 1rem top 0.6rem;background-size:0.9rem 0.9rem;text-decoration:unset}.dropdown-menu .dropdown-item:hover{color:#3347ff}.dropdown-menu span.dropdown-item.current:hover{color:unset}.clipboard{position:relative;float:right}.btn-clipboard{transition:opacity 0.25s ease-in-out;opacity:0;position:absolute;right:0.5rem;top:0.5rem;line-height:1;padding:0.3125rem 0.3125rem 0.1875rem;background-color:transparent;border-color:transparent}@media (max-width: 767.98px){.btn-clipboard{position:absolute;right:-0.5rem;top:0.5rem}}.btn-clipboard::after{width:22px;height:22px;display:inline-block;content:'';-webkit-mask:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' class='icon icon-tabler icon-tabler-copy' width='22' height='22' viewBox='0 0 24 24' stroke-width='1' stroke='currentColor' fill='none' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath stroke='none' d='M0 0h24v24H0z' fill='none'%3E%3C/path%3E%3Cpath d='M8 8m0 2a2 2 0 0 1 2 -2h8a2 2 0 0 1 2 2v8a2 2 0 0 1 -2 2h-8a2 2 0 0 1 -2 -2z'%3E%3C/path%3E%3Cpath d='M16 8v-2a2 2 0 0 0 -2 -2h-8a2 2 0 0 0 -2 2v8a2 2 0 0 0 2 2h2'%3E%3C/path%3E%3C/svg%3E") no-repeat 50% 50%;mask:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' class='icon icon-tabler icon-tabler-copy' width='22' height='22' viewBox='0 0 24 24' stroke-width='1' stroke='currentColor' fill='none' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath stroke='none' d='M0 0h24v24H0z' fill='none'%3E%3C/path%3E%3Cpath d='M8 8m0 2a2 2 0 0 1 2 -2h8a2 2 0 0 1 2 2v8a2 2 0 0 1 -2 2h-8a2 2 0 0 1 -2 -2z'%3E%3C/path%3E%3Cpath d='M16 8v-2a2 2 0 0 0 -2 -2h-8a2 2 0 0 0 -2 2v8a2 2 0 0 0 2 2h2'%3E%3C/path%3E%3C/svg%3E") no-repeat 50% 50%;-webkit-mask-size:cover;mask-size:cover;background-color:#495057}.btn-clipboard:hover{border-color:transparent}.btn-clipboard:hover::after{width:22px;height:22px;display:inline-block;content:'';-webkit-mask:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' class='icon icon-tabler icon-tabler-copy' width='22' height='22' viewBox='0 0 24 24' stroke-width='1' stroke='currentColor' fill='none' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath stroke='none' d='M0 0h24v24H0z' fill='none'%3E%3C/path%3E%3Cpath d='M8 8m0 2a2 2 0 0 1 2 -2h8a2 2 0 0 1 2 2v8a2 2 0 0 1 -2 2h-8a2 2 0 0 1 -2 -2z'%3E%3C/path%3E%3Cpath d='M16 8v-2a2 2 0 0 0 -2 -2h-8a2 2 0 0 0 -2 2v8a2 2 0 0 0 2 2h2'%3E%3C/path%3E%3C/svg%3E") no-repeat 50% 50%;mask:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' class='icon icon-tabler icon-tabler-copy' width='22' height='22' viewBox='0 0 24 24' stroke-width='1' stroke='currentColor' fill='none' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath stroke='none' d='M0 0h24v24H0z' fill='none'%3E%3C/path%3E%3Cpath d='M8 8m0 2a2 2 0 0 1 2 -2h8a2 2 0 0 1 2 2v8a2 2 0 0 1 -2 2h-8a2 2 0 0 1 -2 -2z'%3E%3C/path%3E%3Cpath d='M16 8v-2a2 2 0 0 0 -2 -2h-8a2 2 0 0 0 -2 2v8a2 2 0 0 0 2 2h2'%3E%3C/path%3E%3C/svg%3E") no-repeat 50% 50%;-webkit-mask-size:cover;mask-size:cover;background-color:#212529}.btn-clipboard:focus,.btn-clipboard:active{border-color:transparent !important}.btn-clipboard:focus::after,.btn-clipboard:active::after{width:22px;height:22px;display:inline-block;content:'';-webkit-mask:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='22' height='22' viewBox='0 0 24 24' stroke-width='1.25' stroke='currentColor' fill='none' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath stroke='none' d='M0 0h24v24H0z' fill='none'%3E%3C/path%3E%3Cpath d='M5 12l5 5l10 -10'%3E%3C/path%3E%3C/svg%3E") no-repeat 50% 50%;mask:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='22' height='22' viewBox='0 0 24 24' stroke-width='1.25' stroke='currentColor' fill='none' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath stroke='none' d='M0 0h24v24H0z' fill='none'%3E%3C/path%3E%3Cpath d='M5 12l5 5l10 -10'%3E%3C/path%3E%3C/svg%3E") no-repeat 50% 50%;-webkit-mask-size:cover;mask-size:cover;background-color:#212529}[data-bs-theme="dark"] .btn-clipboard{background-color:transparent;border-color:transparent}[data-bs-theme="dark"] .btn-clipboard::after{background-color:#ced4da}[data-bs-theme="dark"] .btn-clipboard:hover{border-color:transparent}[data-bs-theme="dark"] .btn-clipboard:hover::after{background-color:#e9ecef}[data-bs-theme="dark"] .btn-clipboard:focus,[data-bs-theme="dark"] .btn-clipboard:active{border-color:transparent}[data-bs-theme="dark"] .btn-clipboard:focus::after,[data-bs-theme="dark"] .btn-clipboard:active::after{background-color:#e9ecef}.highlight{position:relative}@media (min-width: 768px){.highlight:hover .btn-clipboard{opacity:1}}#toTop{opacity:0;transition:opacity 0.3s ease-in-out}#toTop.fade{opacity:1}.btn-cta{padding-left:2rem;padding-right:2rem}.callout{--bs-link-color-rgb: var(--callout-link);--bs-code-color: var(--callout-code-color);padding:1.25rem;margin-top:1.5rem;margin-bottom:1.5rem;color:var(--callout-color, inherit);background-color:var(--callout-bg, var(--bs-gray-100));border-left:0.25rem solid var(--callout-border, var(--bs-gray-300));border-radius:0}.callout h4,.callout .h4{margin-top:0;margin-bottom:.25rem}.callout>:last-child{margin-bottom:0}.callout+.callout{margin-top:-.25rem}.callout .svg-inline{position:relative;margin:-0.375rem 0 0}.callout .callout-title{display:block;margin-bottom:0.25rem;font-weight:700;font-size:1.125rem}@media (min-width: 992px){.callout .callout-title{font-size:1.25rem}}.callout .callout-title .svg-inline{margin-right:0.5rem}.callout code{background:transparent;color:inherit}.callout a{font-weight:500}.callout .highlight{background-color:rgba(0,0,0,0.05)}.callout.callout-note{border-color:var(--sl-color-blue);background-color:var(--sl-color-blue-high)}.callout.callout-note .callout-title{color:var(--sl-color-blue-low)}.callout.callout-note code{background:#d6daff}.callout.callout-tip{border-color:var(--sl-color-purple);background-color:var(--sl-color-purple-high)}.callout.callout-tip .callout-title{color:var(--sl-color-purple-low)}.callout.callout-tip code{background:#f2ddfc}.callout.callout-caution{border-color:var(--sl-color-orange);background-color:var(--sl-color-orange-high)}.callout.callout-caution .callout-title{color:var(--sl-color-orange-low)}.callout.callout-caution code{background:#fcf2dd}.callout.callout-danger{border-color:var(--sl-color-red);background-color:var(--sl-color-red-high)}.callout.callout-danger .callout-title{color:var(--sl-color-red-low)}.callout.callout-danger code{background:#fcdde7}.callout.callout-light code{background:var(--sl-color-gray-1)}[data-bs-theme="dark"] .callout{color:var(--sl-color-gray-1)}[data-bs-theme="dark"] .callout.callout-note{border-color:var(--sl-color-blue);background-color:var(--sl-color-blue-low)}[data-bs-theme="dark"] .callout.callout-note .callout-title{color:var(--sl-color-blue-high)}[data-bs-theme="dark"] .callout.callout-note code{background:#0d1240}[data-bs-theme="dark"] .callout.callout-tip{border-color:var(--sl-color-purple);background-color:var(--sl-color-purple-low)}[data-bs-theme="dark"] .callout.callout-tip .callout-title{color:var(--sl-color-purple-high)}[data-bs-theme="dark"] .callout.callout-tip code{background:#2f153c}[data-bs-theme="dark"] .callout.callout-caution{border-color:var(--sl-color-orange);background-color:var(--sl-color-orange-low)}[data-bs-theme="dark"] .callout.callout-caution .callout-title{color:var(--sl-color-orange-high)}[data-bs-theme="dark"] .callout.callout-caution code{background:#3c2f15}[data-bs-theme="dark"] .callout.callout-danger{border-color:var(--sl-color-red);background-color:var(--sl-color-red-low)}[data-bs-theme="dark"] .callout.callout-danger .callout-title{color:var(--sl-color-red-high)}[data-bs-theme="dark"] .callout.callout-danger code{background:#3c1522}pre,code,kbd,samp{font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace;font-size:.875rem;border-radius:.375rem}code{background:#fbf7f0;color:#1d2d35;padding:0.25rem 0.5rem}pre{margin:2rem 0}pre code{display:block;overflow-x:auto;line-height:1.5;padding:1.25rem 1.5rem;-moz-tab-size:4;-o-tab-size:4;tab-size:4;scrollbar-width:thin;scrollbar-color:transparent transparent}.hljs{padding:1.5rem !important}@media (max-width: 575.98px){pre,code,kbd,samp{border-radius:0}pre{margin:2rem -1.5rem}}pre code::-webkit-scrollbar{height:5px}pre code::-webkit-scrollbar-thumb{background:#ced4da}pre code:hover{scrollbar-width:thin;scrollbar-color:#adb5bd transparent}pre code::-webkit-scrollbar-thumb:hover{background:#adb5bd}code.language-mermaid{background:none}.line .ln{margin-right:1rem}.line.hl{color:var(--sl-color-blue)}[data-bs-theme="dark"] .line.hl{color:#fcf2dd}details{display:block;position:relative;border:1px solid #e9ecef;border-radius:0.25rem;padding:0.5rem 1rem 0;margin:0.5rem 0}summary{list-style:none;display:inline-block;width:calc(100% + 2rem);margin:-0.5rem -1rem 0;padding:0.5rem 1rem}summary::-webkit-details-marker{display:none}summary:hover{background:#f8f9fa}details summary::after{display:inline-block;content:url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' width='14' height='14' viewBox='0 0 16 16'%3e%3cpath fill='none' stroke='rgba%2829, 45, 53, 0.75%29' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M5 14l6-6-6-6'/%3e%3c/svg%3e");transition:transform 0.35s ease;transform-origin:center center;position:absolute;right:1rem}details[open]>summary::after{transform:rotate(90deg)}details[open]{padding:0.5rem 1rem}details[open]>summary{border-bottom:1px solid #dee2e6;margin-bottom:0.5rem}details h2,details .h2,details h3,details .h3,details h4,details .h4{margin:1rem 0 0.5rem}details p:last-child{margin-bottom:0}details ul,details ol{margin-bottom:0}details pre{margin:0 0 1rem}.search-form label{font-weight:normal}img[data-sizes="auto"]{display:block;width:100%}.figure{display:block}.blur-up{filter:blur(5px);transition:filter 400ms}.blur-up.lazyloaded{filter:unset}.mermaid{margin:1.5rem 0;padding:1.5rem}.mermaid svg{height:auto}.search-form .form-control:focus{border:2px solid #3347ff}[data-bs-theme="dark"] .search-form .form-control:focus{border:2px solid #b3c7ff}[data-bs-theme="dark"] .search-form .btn-link{color:#b3c7ff}.search-form .btn-link,.modal-body p.message,.modal-footer{font-size:.875rem}.modal-body::-webkit-scrollbar{width:0.25rem}.modal-body::-webkit-scrollbar-track{background-color:#f1f1f1}.modal-body::-webkit-scrollbar-thumb{background-color:#c1c1c1}[data-bs-theme="dark"] .modal-body::-webkit-scrollbar-track{background-color:#424242}[data-bs-theme="dark"] .modal-body::-webkit-scrollbar-thumb{background-color:#686868}@media (min-width: 768px){#searchModal .modal-dialog{max-height:40rem}}.search-result h2,.search-result .h2{margin-top:0}.search-result a:focus{outline:0 none}.search-result:hover .card,.search-result.selected .card{background-color:#3347ff;color:#fff}[data-bs-theme="dark"] .search-result:hover .card,[data-bs-theme="dark"] .search-result.selected .card{background-color:#b3c7ff;color:#23262f}[data-bs-theme="dark"] .search-result:hover .card h2,[data-bs-theme="dark"] .search-result:hover .card .h2,[data-bs-theme="dark"] .search-result.selected .card h2,[data-bs-theme="dark"] .search-result.selected .card .h2{color:#17181c}.search-result .submitted{font-size:.875rem;margin-top:0.5rem}.search-result .content{margin-top:0.5rem;padding-top:0 !important;padding-bottom:0 !important}.navbar-form{position:relative}#suggestions{position:absolute;right:0;margin-top:0.5rem;width:calc(100vw - 3rem);max-width:calc(400px - 3rem);z-index:1000}@media (min-width: 768px){#suggestions{right:-2rem}}@media (min-width: 992px){#suggestions{right:0}}#suggestions a,.suggestion__no-results{padding:0.75rem;margin:0 0.5rem}#suggestions a{display:block;text-decoration:none}#suggestions a:focus{background:#f8f9fa;outline:0}#suggestions div:not(:first-child){border-top:1px dashed #e9ecef}#suggestions div:first-child{margin-top:0.5rem}#suggestions div:last-child{margin-bottom:0.5rem}#suggestions a:hover{background:#f8f9fa}#suggestions span{display:flex;font-size:1rem}.suggestion__title{font-weight:700;color:#b3c7ff}.suggestion__description,.suggestion__no-results{color:#495057}@media (min-width: 992px){#suggestions{width:31.125rem;max-width:31.125rem}#suggestions a{display:flex}.suggestion__title{width:9rem;padding-right:1rem;border-right:1px solid #e9ecef;display:inline-block;text-align:right}.suggestion__description{width:19rem;padding-left:1rem}}table{margin:3rem 0}.nav-tabs{border-bottom:0.0625rem solid #d8dee4;margin-bottom:1rem}.nav-tabs .nav-link{margin-bottom:-0.0625rem !important;background:none;border:0;border-top-left-radius:0;border-top-right-radius:0;color:inherit}.nav-tabs .nav-link:hover,.nav-tabs .nav-link:focus{isolation:isolate;border-color:transparent;color:var(--bs-emphasis-color)}.nav-tabs .nav-link.active,.nav-tabs .nav-item.show .nav-link{background-color:transparent;border-color:transparent;border-bottom:0.125rem solid #3347ff}[data-bs-theme="dark"] .nav-tabs{border-bottom:0.0625rem solid #343a40}[data-bs-theme="dark"] .nav-tabs .nav-link.active,[data-bs-theme="dark"] .nav-tabs .nav-item.show .nav-link{border-bottom:0.125rem solid #b3c7ff}.footer{border-top:1px solid #e9ecef;padding-top:1.125rem;padding-bottom:1.125rem}.footer ul{margin-bottom:0}.footer li{font-size:.875rem;margin-bottom:0}@media (max-width: 991.98px){.footer .col-lg-8{margin-top:0.25rem;margin-bottom:0.25rem}}@media (min-width: 768px){.footer li{font-size:1rem}}.fixed-bottom-right{position:fixed;right:0;bottom:0;z-index:1000}.navbar-brand{font-weight:700}.navbar-brand svg{margin-right:0.25rem}[data-bs-theme="dark"] .navbar-brand{color:inherit}.navbar{z-index:1000;background-color:rgba(255,255,255,0.95);border-bottom:1px solid #e9ecef}@media (min-width: 992px){.navbar{z-index:1025}}@media (min-width: 768px){.navbar-brand{font-size:1.375rem}}.nav-item{margin-left:0}@media (max-width: 991.98px){.navbar .icon-tabler-chevron-down{display:block;float:right;transform:rotate(270deg);transition:transform 0.35s ease}.navbar .dropdown-toggle[aria-expanded="true"] .icon-tabler-chevron-down{transform:rotate(360deg)}.navbar-nav .dropdown-menu{border:0}.navbar-nav .nav-link{font-weight:400}.navbar-nav .dropdown-item{font-weight:300}.dropdown-toggle svg{margin-top:0.25rem;margin-left:0}}@media (min-width: 768px){.nav-item{margin-left:0.5rem}}.break{flex-basis:100%;height:0}button#doks-languages{margin:0.25rem 0 0}@media (min-width: 992px){button#doks-languages{margin:0.25rem 0.5rem 0 0.25rem}}button#doks-versions{margin:0.25rem 0 0}@media (min-width: 992px){button#doks-versions{margin:0.25rem 0.5rem 0 0.25rem}}@media (max-width: 575.98px){.navbar .offcanvas.offcanvas-start,.navbar .offcanvas.offcanvas-end{width:80vw}}.offcanvas-header{border-bottom:1px solid #dee2e6;padding-top:1.0625rem;padding-bottom:0.8125rem}h5.offcanvas-title,.offcanvas-title.h5{margin:0;color:inherit}.offcanvas .nav-link{color:#1d2d35}.offcanvas .nav-link:hover,.offcanvas .nav-link:focus{color:#3347ff}.offcanvas .nav-link.active{color:#3347ff}.header-bar{border-top:4px solid;border-image-source:linear-gradient(83.21deg, #ffe000 0%, #e55235 100%);border-image-slice:1}[data-bs-theme="dark"] .header-bar{border-top:4px solid;border-image-source:linear-gradient(83.21deg, var(--sl-color-accent) 0%, var(--sl-color-green) 100%);border-image-slice:1}.offcanvas .header-bar{margin-bottom:-4px}.home .navbar{border-bottom:0}@media (min-width: 992px){.navbar-brand{margin-right:0.75rem !important}}.dropdown-divider{border-top:1px dashed #e9ecef}.dropdown-item:hover{background:#f8f9fa}.dropdown-item:active{color:inherit}.social-link{padding-right:0.375rem;padding-left:0.375rem}@media (max-width: 991.98px){#buttonColorMode{margin:0.5rem 0}#socialMenu{margin:0.5rem 0 0.5rem -0.25rem}.navbar-nav{margin-top:1rem}.dropdown-menu{box-shadow:none !important;background:transparent !important;border-radius:0 !important;padding:0;margin-bottom:0.25rem}.dropdown-item{padding:0.375rem 1rem 0.375rem 0}.nav-item .nav-link{font-weight:400;font-size:1.125rem}.btn-dropdown{font-weight:400;font-size:1.125rem}}.modal-backdrop,.offcanvas-backdrop{visibility:hidden;background:rgba(23,24,28,0.5);opacity:0}[data-bs-theme="dark"] .modal-backdrop,[data-bs-theme="dark"] .offcanvas-backdrop{visibility:hidden;background:rgba(23,24,28,0.5);opacity:0}.modal-backdrop.show,.offcanvas-backdrop.show{visibility:visible;opacity:1;-webkit-backdrop-filter:blur(8px);backdrop-filter:blur(8px)}.showing,.hiding{transition:none;display:none}.navbar>.container,.navbar>.container-fluid,.navbar>.container-lg{padding-right:0.75rem}.docs-content>h2[id]::before,.docs-content>[id].h2::before,.docs-content>h3[id]::before,.docs-content>[id].h3::before,.docs-content>h4[id]::before,.docs-content>[id].h4::before{display:block;height:6rem;margin-top:-6rem;content:""}.docs-content ul,.docs-content ol{margin-bottom:1rem}.anchor{visibility:hidden;margin-left:0.375rem}.edit-page a,.last-modified a{color:var(--sl-color-gray-3)}h1:hover a,.h1:hover a,h2:hover a,.h2:hover a,h3:hover a,.h3:hover a,h4:hover a,.h4:hover a{visibility:visible;text-decoration:none}.card-list{margin-top:2.25rem}.page-footer-meta{margin-top:2rem;margin-bottom:2rem}.edit-page,.last-modified{font-size:.875rem;margin-top:0.25rem;margin-bottom:0.25rem}@media (min-width: 768px){.edit-page,.last-modified{font-size:1rem;margin-top:0.75rem;margin-bottom:0.25rem}}.edit-page a:hover,.last-modified a:hover{color:var(--sl-color-gray-4);text-decoration:none}[data-bs-theme="dark"] .edit-page a:hover,[data-bs-theme="dark"] .last-modified a:hover{color:var(--sl-color-gray-2)}.edit-page svg,.last-modified svg{margin-right:0.25rem;margin-bottom:0.25rem}p.meta{margin-top:0.5rem;font-size:1rem}.breadcrumb{margin-top:2.25rem;font-size:1rem}.toc-mobile{margin-top:2rem;margin-bottom:2rem}.row-about{padding-top:5rem;padding-bottom:5rem}@media (min-width: 992px){.row-about{padding-top:7rem;padding-bottom:7rem}}.row-about h1,.row-about .h1{margin-top:1rem}ul li{margin:0.25rem 0}.page-nav .card .icon-tabler-arrow-left{margin-right:0.75rem}.page-nav .card .icon-tabler-arrow-right{margin-left:0.75rem}.page-nav .card:hover{border:1px solid #d9d9d9}[data-bs-theme="dark"] .page-nav .card{border:1px solid #353841}[data-bs-theme="dark"] .page-nav .card:hover{border:1px solid #888c96}.container-fw{max-width:1200px}.container-fw .docs-toc{margin-left:3rem}.home .card,.contributors.list .card,.blog.list .card,.blog.single .card,.categories.list .card,.tags.list .card{margin-top:2rem;margin-bottom:2rem;transition:transform 0.3s}.home .content .card:hover,.contributors.list .content .card:hover,.blog.list .content .card:hover,.blog.single .content .card:hover,.categories.list .content .card:hover,.tags.list .content .card:hover{transform:scale(1.025)}.contributors.list .card.card-terms:hover,.categories.list .card.card-terms:hover,.tags.list .card.card-terms:hover{transform:none}.home .content .card-body,.contributors.list .content .card-body,.blog.list .content .card-body,.blog.single .content .card-body,.categories.list .content .card-body,.tags.list .content .card-body{padding:0 2rem 1rem}.contributors.list .card-terms .card-body,.categories.list .card-terms .card-body,.tags.list .card-terms .card-body{padding:1rem}.blog-header{text-align:center;margin-bottom:2rem}h2.section-title,.section-title.h2{margin-bottom:1.25rem}.img-post-single{margin-bottom:2rem}.pagination{display:flex;justify-content:center}.tag-list-single{margin-top:3rem;margin-bottom:1rem}.section-related{padding-top:1.5rem;padding-bottom:1.5rem}.contributor-image{text-align:center;margin-top:2.5rem}.docs-links,.docs-toc{scrollbar-width:thin;scrollbar-color:#fff #fff}.docs-links::-webkit-scrollbar,.docs-toc::-webkit-scrollbar{width:5px}.docs-links::-webkit-scrollbar-track,.docs-toc::-webkit-scrollbar-track{background:#fff}.docs-links::-webkit-scrollbar-thumb,.docs-toc::-webkit-scrollbar-thumb{background:#fff}.docs-links:hover,.docs-toc:hover{scrollbar-width:thin;scrollbar-color:#e9ecef #fff}.docs-links:hover::-webkit-scrollbar-thumb,.docs-toc:hover::-webkit-scrollbar-thumb{background:#e9ecef}.docs-links::-webkit-scrollbar-thumb:hover,.docs-toc::-webkit-scrollbar-thumb:hover{background:#e9ecef}.docs-links h3,.docs-links .h3,.page-links h3,.page-links .h3{text-transform:uppercase;font-size:1rem;margin:1.25rem 0 0.5rem;padding:1.5rem 0 0}@media (min-width: 992px){.docs-links h3,.docs-links .h3,.page-links h3,.page-links .h3{margin:1.125rem 1.5rem 0.75rem 0;padding:1.375rem 0 0}}.docs-links h3:not(:first-child),.docs-links .h3:not(:first-child){border-top:1px solid #e9ecef}a.docs-link{color:#1d2d35;display:block;padding:0.125rem 0;font-size:1rem}.page-links li{margin-top:0.375rem;padding-top:0.375rem}.page-links li ul li{border-top:none;padding-left:1rem;margin-top:0.125rem;padding-top:0.125rem}.page-links li:not(:first-child){border-top:1px dashed #e9ecef}.page-links a{color:#1d2d35;display:block;padding:0.125rem 0;font-size:.9375rem;text-decoration:none}.docs-link:hover,.docs-link.active,.page-links a:hover,.page-links a.active{text-decoration:none;color:#3347ff}.nav-link.active,.docs-link.active{font-weight:500}
diff --git a/page/2/index.html b/page/2/index.html
new file mode 100644
index 0000000..ac99416
--- /dev/null
+++ b/page/2/index.html
@@ -0,0 +1,7 @@
+<!doctype html><html lang=en data-bs-theme=auto><head><meta charset=utf-8><meta http-equiv=x-ua-compatible content="ie=edge"><meta name=viewport content="width=device-width,initial-scale=1"><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-regular.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-500.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-700.woff2 type=font/woff2 crossorigin><script src=https://wldt.github.io/js/color-mode.86a91f050a481d0a3f0c72ac26543cb6228c770875981c58dcbc008fd3f875c8.js integrity="sha256-hqkfBQpIHQo/DHKsJlQ8tiKMdwh1mBxY3LwAj9P4dcg="></script>
+<link rel=stylesheet href=https://wldt.github.io/main.5fb433a44687c98f7ae7b3d0137c762777049ba27235e1f08c279c03c8533a7a9a1e3b0ef5b125a31b6bb63a362cdcbc39c3706ed41ad7f1a620b9281013866c.css integrity="sha512-X7QzpEaHyY9657PQE3x2J3cEm6JyNeHwjCecA8hTOnqaHjsO9bEloxtrtjo2LNy8OcNwbtQa1/GmILkoEBOGbA==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>WLDT</title><meta property="canonical" content="https://wldt.github.io/page/2/"><meta name=description content="What is a digital Twin? A Digital Twin (DT) is a comprehensive software representation of any individual Physical Asset (PA) in the real world."><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/page/2/"><meta property="og:title" content="White Label Digital Twins"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:description" content="What is a digital Twin? A Digital Twin (DT) is a comprehensive software representation of any individual Physical Asset (PA) in the real world."><meta property="og:see_also" content="https://wldt.github.io/privacy/"><meta name=twitter:card content="summary"><meta name=twitter:title content="White Label Digital Twins"><meta name=twitter:description content="What is a digital Twin? A Digital Twin (DT) is a comprehensive software representation of any individual Physical Asset (PA) in the real world."><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","name":"White Label Digital Twins","position":1}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="single home" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
+<button type=button id=searchToggleMobile class="btn btn-link nav-link mx-2 d-lg-none" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button class="btn btn-link nav-link mx-2 order-3 d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavMain aria-controls=offcanvasNavMain aria-label="Open main navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-menu" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><line x1="4" y1="8" x2="20" y2="8"/><line x1="4" y1="16" x2="20" y2="16"/></svg></button><div class="offcanvas offcanvas-end h-auto" tabindex=-1 id=offcanvasNavMain aria-labelledby=offcanvasNavMainLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavMainLabel>WLDT</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class="offcanvas-body d-flex flex-column flex-lg-row justify-content-between"><ul class="navbar-nav flex-grow-1"><li class=nav-item><a class=nav-link href=https://wldt.github.io/docs/guides/example-guide/>Documentation</a></li><li class=nav-item><a class=nav-link href=https://wldt.github.io/blog/>Blog</a></li></ul><button type=button id=searchToggleDesktop class="btn btn-link nav-link p-2 d-none d-lg-block" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
+<button id=buttonColorMode class="btn btn-link mx-auto nav-link p-0 ms-lg-2 me-lg-1" type=button aria-label="Toggle theme"><svg data-bs-theme-value="dark" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-moon" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 3c.132.0.263.0.393.0a7.5 7.5.0 007.92 12.446A9 9 0 1112 2.992z"/></svg><svg data-bs-theme-value="light" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-sun" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-4 0a4 4 0 108 0 4 4 0 10-8 0m-5 0h1m8-9v1m8 8h1m-9 8v1M5.6 5.6l.7.7m12.1-.7-.7.7m0 11.4.7.7m-12.1-.7-.7.7"/></svg></button><ul id=socialMenu class="nav mx-auto flex-row order-lg-4"><li class=nav-item><a class="nav-link social-link" href=https://github.com/wldt><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-brand-github" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 19c-4.3 1.4-4.3-2.5-6-3m12 5v-3.5c0-1 .1-1.4-.5-2 2.8-.3 5.5-1.4 5.5-6a4.6 4.6.0 00-1.3-3.2 4.2 4.2.0 00-.1-3.2s-1.1-.3-3.5 1.3a12.3 12.3.0 00-6.2.0C6.5 2.8 5.4 3.1 5.4 3.1a4.2 4.2.0 00-.1 3.2A4.6 4.6.0 004 9.5c0 4.6 2.7 5.7 5.5 6-.6.6-.6 1.2-.5 2V21"/></svg><small class="ms-2 visually-hidden">GitHub</small></a></li></ul></div></div></div></header></div><div class=modal id=searchModal tabindex=-1 aria-labelledby=searchModalLabel aria-hidden=true><div class="modal-dialog modal-dialog-scrollable modal-fullscreen-md-down"><div class=modal-content><div class=modal-header><h1 class="modal-title fs-5 visually-hidden" id=searchModalLabel>Search</h1><button type=button class="btn-close visually-hidden" data-bs-dismiss=modal aria-label=Close></button><div class="search-input flex-grow-1 d-none"><form id=search-form class=search-form action=# method=post accept-charset=utf-8 role=search><label for=query class=visually-hidden>Search</label><div class=d-flex><input type=search id=query name=query class="search-text form-control form-control-lg" placeholder=Search aria-label=Search maxlength=128 autocomplete=off>
+<button type=button class="btn btn-link text-decoration-none px-0 ms-3 d-md-none" data-bs-dismiss=modal aria-label=Close>Cancel</button></div></form></div></div><div class=modal-body><p class="search-loading status message d-none mt-3 text-center">Loading search index…</p><p class="search-no-recent message d-none mt-3 text-center">No recent searches</p><p class="search-no-results message d-none mt-3 text-center">No results for "<strong><span class=query-no-results>Query here</span></strong>"</p><div id=searchResults class=search-results></div><template><article class="search-result list-view"><div class="card my-3"><div class=card-body><header><h2 class="h5 title title-submitted mb-0"><a class="stretched-link text-decoration-none text-reset" href=#>Title here</a></h2><div class="submitted d-none"><time class=created-date>Date here</time></div></header><div class=content>Summary here</div></div></div></article></template></div><div class=modal-footer><ul class="list-inline me-auto d-none d-md-block"><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Enter key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M12 3.53088v3c0 1-1 2-2 2H4m3 3-3-3 3-3"/></g></svg></kbd><span class=DocSearch-Label>to select</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Arrow down" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 3.5v8m3-3-3 3-3-3"/></g></svg></kbd><kbd class=me-2><svg width="15" height="15" aria-label="Arrow up" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M7.5 11.5v-8m3 3-3-3-3 3"/></g></svg></kbd><span class=DocSearch-Label>to navigate</span></li><li class=list-inline-item><kbd class=me-2><svg width="15" height="15" aria-label="Escape key" role="img"><g fill="none" stroke="currentcolor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.2"><path d="M13.6167 8.936c-.1065.3583-.6883.962-1.4875.962-.7993.0-1.653-.9165-1.653-2.1258v-.5678c0-1.2548.7896-2.1016 1.653-2.1016s1.3601.4778 1.4875 1.0724M9 6c-.1352-.4735-.7506-.9219-1.46-.8972-.7092.0246-1.344.57-1.344 1.2166s.4198.8812 1.3445.9805C8.465 7.3992 8.968 7.9337 9 8.5s-.454 1.398-1.4595 1.398C6.6593 9.898 6 9 5.963 8.4851m-1.4748.5368c-.2635.5941-.8099.876-1.5443.876s-1.7073-.6248-1.7073-2.204v-.4603c0-1.0416.721-2.131 1.7073-2.131.9864.0 1.6425 1.031 1.5443 2.2492h-2.956"/></g></svg></kbd><span class=DocSearch-Label>to close</span></li></ul><p class=d-md-none>Search by <a class=text-decoration-none href=https://github.com/nextapps-de/flexsearch>FlexSearch</a></p></div></div></div></div><div class="wrap container-lg" role=document><div class=content><section class="section container-fluid mt-n3 pb-3"><div class="row justify-content-center"><div class="col-lg-12 text-center"><h1>White Label Digital Twins</h1></div><div class="col-lg-9 col-xl-8 text-center"><p class=lead>A Java library to easily create Digital Twins for all your Internet of Things Projects</p><p class=lead>Open-source on <a href=https://github.com/wldt>GitHub</a></p></div></div></section></div></div><section class="section section-md section-features"><div class=container><div class="row justify-content-center text-center"><h3 id=what-is-a-digital-twin>What is a digital Twin?</h3><p>A <strong>Digital Twin</strong> (DT) is a comprehensive software representation of any individual <strong>Physical Asset</strong> (PA) in the real world.<br>It includes the properties, conditions, relationships, and behavior(s) of the real-life object through models and data.<br>A Digital Twin is a set of realistic models that can digitalize an object’s behavior in the deployed environment and has the responsibility to represent and reflect its physical counterpart over time maintaining its digital replica across the object’s entire lifecycle.</p><h3 id=what-can-wldt-do-for-me>What can WLDT do for me?</h3><p>The White Label Digital Twin (WLDT) library aims to support the design, development, and deployment of Digital Twins within the Internet of Things (IoT) ecosystems.<br>The library has been designed following the latest DT definitions coming from both Industrial and Scientific domains and identifying DTs as active, flexible and scalable software components.</p></div></div></section><section class="section section-md container-fluid bg-light"><div class="row justify-content-center text-center"><div class=col-lg-7><h2 class=mt-2>Start building with WLDT today</h2><a class="btn btn-primary rounded-pill px-4 my-2" href=https://wldt.github.io/docs/prologue/introduction/ role=button>Get Started</a></div></div></section><footer class="footer text-muted"><div class=container-lg><div class=row><div class="col-lg-8 text-center text-lg-start"><ul class=list-inline><li class=list-inline-item><a class=text-muted href=https://wldt.github.io/privacy/>Privacy Policy</a></li></ul></div><div class="col-lg-8 text-center text-lg-end"><ul class=list-inline><li class=list-inline-item>Brought to you by <a class=text-muted href=https://gethyas.com/>Hyas</a></li></ul></div></div></div></footer><script async src=https://wldt.github.io/js/app.1e84dcdaa5ccef6fe83f6d88ac1e444a1f237111cfa2a7a97427f758e9c27ef4.js integrity="sha256-HoTc2qXM72/oP22IrB5ESh8jcRHPoqepdCf3WOnCfvQ="></script>
+<script async src=https://wldt.github.io/js/flexsearch.dc00caef2c3490dbab3c345ed0d4133b0aafb803efeb21c3df80776d6d3ea821.js integrity="sha256-3ADK7yw0kNurPDRe0NQTOwqvuAPv6yHD34B3bW0+qCE="></script><script async src=https://wldt.github.io/js/search-modal.c4c023efcdee308e4b5f1110afe1db6b1656f217e67aa7efe54e2f4bf2feccf8.js integrity="sha256-xMAj783uMI5LXxEQr+HbaxZW8hfmeqfv5U4vS/L+zPg="></script><div class="d-inline-flex fixed-bottom-right pb-4 pe-4"><button id=toTop type=button class="btn btn-primary rounded-circle ms-auto p-2"><span class=visually-hidden>Top</span><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-chevron-up" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M6 15l6-6 6 6"/></svg></button></div></body></html>
\ No newline at end of file
diff --git a/privacy/index.html b/privacy/index.html
index 6aa15bb..ca2b9f0 100644
--- a/privacy/index.html
+++ b/privacy/index.html
@@ -1,5 +1,5 @@
 <!doctype html><html lang=en data-bs-theme=auto><head><meta charset=utf-8><meta http-equiv=x-ua-compatible content="ie=edge"><meta name=viewport content="width=device-width,initial-scale=1"><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-regular.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-500.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-700.woff2 type=font/woff2 crossorigin><script src=https://wldt.github.io/js/color-mode.86a91f050a481d0a3f0c72ac26543cb6228c770875981c58dcbc008fd3f875c8.js integrity="sha256-hqkfBQpIHQo/DHKsJlQ8tiKMdwh1mBxY3LwAj9P4dcg="></script>
-<link rel=stylesheet href=https://wldt.github.io/main.5d6e5440c13f1c45183e82bbb906165564d1edfd71498c4a2c38775086796022bfab9cfb137199a537d8e42c2fb6ce2ab74b69461aed15b7389bd0e12ec63b19.css integrity="sha512-XW5UQME/HEUYPoK7uQYWVWTR7f1xSYxKLDh3UIZ5YCK/q5z7E3GZpTfY5Cwvts4qt0tpRhrtFbc4m9DhLsY7GQ==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>Privacy Policy | WLDT</title><meta property="canonical" content="https://wldt.github.io/privacy/"><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/privacy/"><meta property="og:title" content="Privacy Policy"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:see_also" content="https://wldt.github.io/privacy/"><meta name=twitter:card content="summary"><meta name=twitter:title content="Privacy Policy"><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","name":"Privacy Policy","position":2}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="single privacy" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
+<link rel=stylesheet href=https://wldt.github.io/main.5fb433a44687c98f7ae7b3d0137c762777049ba27235e1f08c279c03c8533a7a9a1e3b0ef5b125a31b6bb63a362cdcbc39c3706ed41ad7f1a620b9281013866c.css integrity="sha512-X7QzpEaHyY9657PQE3x2J3cEm6JyNeHwjCecA8hTOnqaHjsO9bEloxtrtjo2LNy8OcNwbtQa1/GmILkoEBOGbA==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>Privacy Policy | WLDT</title><meta property="canonical" content="https://wldt.github.io/privacy/"><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/privacy/"><meta property="og:title" content="Privacy Policy"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:see_also" content="https://wldt.github.io/privacy/"><meta name=twitter:card content="summary"><meta name=twitter:title content="Privacy Policy"><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","name":"Privacy Policy","position":2}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="single privacy" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
 <button type=button id=searchToggleMobile class="btn btn-link nav-link mx-2 d-lg-none" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
 <button class="btn btn-link nav-link mx-2 order-3 d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavMain aria-controls=offcanvasNavMain aria-label="Open main navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-menu" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><line x1="4" y1="8" x2="20" y2="8"/><line x1="4" y1="16" x2="20" y2="16"/></svg></button><div class="offcanvas offcanvas-end h-auto" tabindex=-1 id=offcanvasNavMain aria-labelledby=offcanvasNavMainLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavMainLabel>WLDT</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class="offcanvas-body d-flex flex-column flex-lg-row justify-content-between"><ul class="navbar-nav flex-grow-1"><li class=nav-item><a class=nav-link href=https://wldt.github.io/docs/guides/example-guide/>Documentation</a></li><li class=nav-item><a class=nav-link href=https://wldt.github.io/blog/>Blog</a></li></ul><button type=button id=searchToggleDesktop class="btn btn-link nav-link p-2 d-none d-lg-block" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
 <button id=buttonColorMode class="btn btn-link mx-auto nav-link p-0 ms-lg-2 me-lg-1" type=button aria-label="Toggle theme"><svg data-bs-theme-value="dark" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-moon" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 3c.132.0.263.0.393.0a7.5 7.5.0 007.92 12.446A9 9 0 1112 2.992z"/></svg><svg data-bs-theme-value="light" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-sun" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-4 0a4 4 0 108 0 4 4 0 10-8 0m-5 0h1m8-9v1m8 8h1m-9 8v1M5.6 5.6l.7.7m12.1-.7-.7.7m0 11.4.7.7m-12.1-.7-.7.7"/></svg></button><ul id=socialMenu class="nav mx-auto flex-row order-lg-4"><li class=nav-item><a class="nav-link social-link" href=https://github.com/wldt><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-brand-github" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 19c-4.3 1.4-4.3-2.5-6-3m12 5v-3.5c0-1 .1-1.4-.5-2 2.8-.3 5.5-1.4 5.5-6a4.6 4.6.0 00-1.3-3.2 4.2 4.2.0 00-.1-3.2s-1.1-.3-3.5 1.3a12.3 12.3.0 00-6.2.0C6.5 2.8 5.4 3.1 5.4 3.1a4.2 4.2.0 00-.1 3.2A4.6 4.6.0 004 9.5c0 4.6 2.7 5.7 5.5 6-.6.6-.6 1.2-.5 2V21"/></svg><small class="ms-2 visually-hidden">GitHub</small></a></li></ul></div></div></div></header></div><div class=modal id=searchModal tabindex=-1 aria-labelledby=searchModalLabel aria-hidden=true><div class="modal-dialog modal-dialog-scrollable modal-fullscreen-md-down"><div class=modal-content><div class=modal-header><h1 class="modal-title fs-5 visually-hidden" id=searchModalLabel>Search</h1><button type=button class="btn-close visually-hidden" data-bs-dismiss=modal aria-label=Close></button><div class="search-input flex-grow-1 d-none"><form id=search-form class=search-form action=# method=post accept-charset=utf-8 role=search><label for=query class=visually-hidden>Search</label><div class=d-flex><input type=search id=query name=query class="search-text form-control form-control-lg" placeholder=Search aria-label=Search maxlength=128 autocomplete=off>
diff --git a/search-index.json b/search-index.json
index a3e7c87..3362306 100644
--- a/search-index.json
+++ b/search-index.json
@@ -1 +1 @@
-[{"content":"","date":"September 7, 2023","id":0,"permalink":"/blog/example-post/","summary":"","tags":"","title":"Example Post"},{"content":"","date":"September 7, 2023","id":1,"permalink":"/blog/","summary":"","tags":"","title":"Blog"},{"content":"","date":"September 7, 2023","id":2,"permalink":"/docs/guides/","summary":"","tags":"","title":"Guides"},{"content":"Guides lead a user through a specific task they want to accomplish, often with a sequence of steps. Writing a good guide requires thinking about what your users are trying to do.\nFurther reading Read about how-to guides in the Diátaxis framework ","date":"September 7, 2023","id":3,"permalink":"/docs/guides/example-guide/","summary":"Guides lead a user through a specific task they want to accomplish, often with a sequence of steps. Writing a good guide requires thinking about what your users are trying to do.","tags":"","title":"Example Guide"},{"content":"","date":"September 7, 2023","id":4,"permalink":"/docs/reference/","summary":"","tags":"","title":"Reference"},{"content":"Reference pages are ideal for outlining how things work in terse and clear terms. Less concerned with telling a story or addressing a specific use case, they should give a comprehensive outline of what your documenting.\nFurther reading Read about reference in the Diátaxis framework ","date":"September 7, 2023","id":5,"permalink":"/docs/reference/example-reference/","summary":"Reference pages are ideal for outlining how things work in terse and clear terms. Less concerned with telling a story or addressing a specific use case, they should give a comprehensive outline of what your documenting.","tags":"","title":"Example Reference"},{"content":"","date":"September 7, 2023","id":6,"permalink":"/docs/","summary":"","tags":"","title":"Docs"},{"content":"\rWhat is a digital Twin? A Digital Twin (DT) is a comprehensive software representation of any individual Physical Asset (PA) in the real world.\nIt includes the properties, conditions, relationships, and behavior(s) of the real-life object through models and data.\nA Digital Twin is a set of realistic models that can digitalize an object’s behavior in the deployed environment and has the responsibility to represent and reflect its physical counterpart over time maintaining its digital replica across the object’s entire lifecycle.\nWhat can WLDT do for me? The White Label Digital Twin (WLDT) library aims to support the design, development, and deployment of Digital Twins within the Internet of Things (IoT) ecosystems.\nThe library has been designed following the latest DT definitions coming from both Industrial and Scientific domains and identifying DTs as active, flexible and scalable software components.\n","date":"October 6, 2023","id":7,"permalink":"/","summary":"What is a digital Twin? A Digital Twin (DT) is a comprehensive software representation of any individual Physical Asset (PA) in the real world.","tags":"","title":"White Label Digital Twins"},{"content":"","date":"September 7, 2023","id":8,"permalink":"/privacy/","summary":"","tags":"","title":"Privacy Policy"},{"content":"","date":"January 1, 0001","id":9,"permalink":"/categories/","summary":"","tags":"","title":"Categories"},{"content":"","date":"January 1, 0001","id":10,"permalink":"/contributors/","summary":"","tags":"","title":"Contributors"},{"content":"","date":"January 1, 0001","id":11,"permalink":"/tags/","summary":"","tags":"","title":"Tags"}]
\ No newline at end of file
+[{"content":"","date":"September 7, 2023","id":0,"permalink":"/blog/example-post/","summary":"","tags":"","title":"Example Post"},{"content":"","date":"September 7, 2023","id":1,"permalink":"/blog/","summary":"","tags":"","title":"Blog"},{"content":"","date":"September 7, 2023","id":2,"permalink":"/docs/introduction/","summary":"","tags":"","title":"Introduction"},{"content":"The developer can use an existing Physical Adapter or create a new one to handle the communication with a specific physical twin. In this documentation we focus on the creation of a new Physical Adapter in order to explain library core functionalities. However, existing Physical Adapters can be found on the official repository and linked in the core documentation and webpage (WLDT-GitHub).\nIn general WLDT Physical Adapter extends the class PhysicalAdapter and it is responsible to talk with the physical world and handling the following main tasks:\nGenerate a PAD describing the properties, events, actions and relationships available on the physical twin using the class PhysicalAssetDescription Generate Physical Event using the class PhysicalAssetEventWldtEvent associated to the variation of any aspect of the physical state (properties, events, and relationships) Handle action request coming from the Digital World through the DT Shadowing Function by implementing the method onIncomingPhysicalAction and processing events modeled through the class PhysicalAssetActionWldtEvent Create a new class called DemoPhysicalAdapter extending the library class PhysicalAdapter and implement the following methods:\nonAdapterStart: A callback method used to notify when the adapter has been effectively started withing the DT\u0026rsquo;s life cycle onAdapterStop: A call method invoked when the adapter has been stopped and will be dismissed by the core onIncomingPhysicalAction: The callback method called when a new PhysicalAssetActionWldtEvent is sent by the Shadowing Function upon the receiving of a valid Digital Action through a Digital Adapter Then you have to create a constructor for your Physical Adapter with a single String parameter representing the id of the adapter. This id will be used internally by the library to handle and coordinate multiple adapters, adapts logs and execute functions upon the arrival of a new event. The resulting empty class will the following:\npublic class DemoPhysicalAdapter extends PhysicalAdapter { public DemoPhysicalAdapter(String id) { super(id); } @Override public void onIncomingPhysicalAction(PhysicalAssetActionWldtEvent\u0026lt;?\u0026gt; physicalAssetActionWldtEvent) { } @Override public void onAdapterStart() { } @Override public void onAdapterStop() { } } In our test Physical Adapter example we are going to emulate the communication with an Internet of Things device with the following sensing and actuation characteristics:\nA Temperature Sensor generating data about new measurements The possibility to generate OVER-HEATING events An action to set the target desired temperature value The first step will be to generate and publish the PhysicalAssetDescription (PAD) to describe the capabilities and the characteristics of our object allowing the Shadowing Function to decide how to digitalize its physical counterpart. Of course in our case the PAD is generated manually but according to the nature of the connected physical twin it can be automatically generated starting from a discovery or a configuration passed to the adapter.\nThe generation of the PAD for each active Physical Adapter is the fundamental DT process to handle the binding procedure and to allow the Shadowing Function and consequently the core of the twin to be aware of what is available in the physical world and consequently decide what to observe and digitalize.\nIn order to publish the PAD we can update the onAdapterStart method with the following lines of code:\nprivate final static String TEMPERATURE_PROPERTY_KEY = \u0026#34;temperature-property-key\u0026#34;; private final static String OVERHEATING_EVENT_KEY = \u0026#34;overheating-event-key\u0026#34;; private final static String SET_TEMPERATURE_ACTION_KEY = \u0026#34;set-temperatura-action-key\u0026#34;; @Override public void onAdapterStart() { try { //Create an empty PAD PhysicalAssetDescription pad = new PhysicalAssetDescription(); //Add a new Property associated to the target PAD with a key and a default value PhysicalAssetProperty\u0026lt;Double\u0026gt; temperatureProperty = new PhysicalAssetProperty\u0026lt;Double\u0026gt;(TEMPERATURE_PROPERTY_KEY, 0.0); pad.getProperties().add(temperatureProperty); //Add the declaration of a new type of generated event associated to a event key // and the content type of the generated payload PhysicalAssetEvent overheatingEvent = new PhysicalAssetEvent(OVERHEATING_EVENT_KEY, \u0026#34;text/plain\u0026#34;); pad.getEvents().add(overheatingEvent); //Declare the availability of a target action characterized by a Key, an action type // and the expected content type and the request body PhysicalAssetAction setTemperatureAction = new PhysicalAssetAction(SET_TEMPERATURE_ACTION_KEY, \u0026#34;temperature.actuation\u0026#34;, \u0026#34;text/plain\u0026#34;); pad.getActions().add(setTemperatureAction); //Notify the new PAD to the DT\u0026#39;s Shadowing Function this.notifyPhysicalAdapterBound(pad); //TODO add here the Device Emulation method } catch (PhysicalAdapterException | EventBusException e) { e.printStackTrace(); } } Now we need a simple code to emulate the generation of new temperature measurements and over-heating events. In a real Physical Adapter implementation we have to implement the real communication with the physical twin in order to read its state variation over time according to the supported protocols. In our simplified Physical Adapter we can the following function:\nprivate final static int MESSAGE_UPDATE_TIME = 1000; private final static int MESSAGE_UPDATE_NUMBER = 10; private final static double TEMPERATURE_MIN_VALUE = 20; private final static double TEMPERATURE_MAX_VALUE = 30; private Runnable deviceEmulation(){ return () -\u0026gt; { try { //Sleep 5 seconds to emulate device startup Thread.sleep(5000); //Create a new random object to emulate temperature variations Random r = new Random(); //Publish an initial Event for a normal condition publishPhysicalAssetEventWldtEvent(new PhysicalAssetEventWldtEvent\u0026lt;\u0026gt;(OVERHEATING_EVENT_KEY, \u0026#34;normal\u0026#34;)); //Emulate the generation on \u0026#39;n\u0026#39; temperature measurements for(int i = 0; i \u0026lt; MESSAGE_UPDATE_NUMBER; i++){ //Sleep to emulate sensor measurement Thread.sleep(MESSAGE_UPDATE_TIME); //Update the double randomTemperature = TEMPERATURE_MIN_VALUE + (TEMPERATURE_MAX_VALUE - TEMPERATURE_MIN_VALUE) * r.nextDouble(); //Create a new event to notify the variation of a Physical Property PhysicalAssetPropertyWldtEvent\u0026lt;Double\u0026gt; newPhysicalPropertyEvent = new PhysicalAssetPropertyWldtEvent\u0026lt;\u0026gt;(TEMPERATURE_PROPERTY_KEY, randomTemperature); //Publish the WLDTEvent associated to the Physical Property Variation publishPhysicalAssetPropertyWldtEvent(newPhysicalPropertyEvent); } //Publish a demo Physical Event associated to a \u0026#39;critical\u0026#39; overheating condition publishPhysicalAssetEventWldtEvent(new PhysicalAssetEventWldtEvent\u0026lt;\u0026gt;(OVERHEATING_EVENT_KEY, \u0026#34;critical\u0026#34;)); } catch (EventBusException | InterruptedException e) { e.printStackTrace(); } }; } Now we have to call the deviceEmulationFunction() inside the onAdapterStart() triggering its execution and emulating the physical counterpart of our DT. To do that add the following line at the end of the onAdapterStart() method after the this.notifyPhysicalAdapterBound(pad);.\nThe last step will be to handle an incoming action trying to set a new temperature on the device by implementing the method onIncomingPhysicalAction(). This method will receive a PhysicalAssetActionWldtEvent\u0026lt;?\u0026gt; physicalAssetActionWldtEvent associated to the action request generated by the shadowing function. Since a Physical Adapter can handle multiple action we have to check both action-key and body type in order to properly process the action (in our case just logging the request). The new update method will result like this:\n@Override public void onIncomingPhysicalAction(PhysicalAssetActionWldtEvent\u0026lt;?\u0026gt; physicalAssetActionWldtEvent) { try{ if(physicalAssetActionWldtEvent != null \u0026amp;\u0026amp; physicalAssetActionWldtEvent.getActionKey().equals(SET_TEMPERATURE_ACTION_KEY) \u0026amp;\u0026amp; physicalAssetActionWldtEvent.getBody() instanceof String) { System.out.println(\u0026#34;Received Action Request: \u0026#34; + physicalAssetActionWldtEvent.getActionKey() + \u0026#34; with Body: \u0026#34; + physicalAssetActionWldtEvent.getBody()); } else System.err.println(\u0026#34;Wrong Action Received !\u0026#34;); }catch (Exception e){ e.printStackTrace(); } } The overall class will result as following:\nimport it.wldt.adapter.physical.*; import it.wldt.adapter.physical.event.PhysicalAssetActionWldtEvent; import it.wldt.adapter.physical.event.PhysicalAssetEventWldtEvent; import it.wldt.adapter.physical.event.PhysicalAssetPropertyWldtEvent; import it.wldt.exception.EventBusException; import it.wldt.exception.PhysicalAdapterException; import java.util.Random; public class DemoPhysicalAdapter extends PhysicalAdapter { private final static String TEMPERATURE_PROPERTY_KEY = \u0026#34;temperature-property-key\u0026#34;; private final static String OVERHEATING_EVENT_KEY = \u0026#34;overheating-event-key\u0026#34;; private final static String SET_TEMPERATURE_ACTION_KEY = \u0026#34;set-temperature-action-key\u0026#34;; private final static int MESSAGE_UPDATE_TIME = 1000; private final static int MESSAGE_UPDATE_NUMBER = 10; private final static double TEMPERATURE_MIN_VALUE = 20; private final static double TEMPERATURE_MAX_VALUE = 30; public DemoPhysicalAdapter(String id) { super(id); } @Override public void onIncomingPhysicalAction(PhysicalAssetActionWldtEvent\u0026lt;?\u0026gt; physicalAssetActionWldtEvent) { try{ if(physicalAssetActionWldtEvent != null \u0026amp;\u0026amp; physicalAssetActionWldtEvent.getActionKey().equals(SET_TEMPERATURE_ACTION_KEY) \u0026amp;\u0026amp; physicalAssetActionWldtEvent.getBody() instanceof Double) { System.out.println(\u0026#34;Received Action Request: \u0026#34; + physicalAssetActionWldtEvent.getActionKey() + \u0026#34; with Body: \u0026#34; + physicalAssetActionWldtEvent.getBody()); } else System.err.println(\u0026#34;Wrong Action Received !\u0026#34;); }catch (Exception e){ e.printStackTrace(); } } @Override public void onAdapterStart() { try { //Create an empty PAD PhysicalAssetDescription pad = new PhysicalAssetDescription(); //Add a new Property associated to the target PAD with a key and a default value PhysicalAssetProperty\u0026lt;Double\u0026gt; temperatureProperty = new PhysicalAssetProperty\u0026lt;Double\u0026gt;(GlobalKeywords.TEMPERATURE_PROPERTY_KEY, 0.0); pad.getProperties().add(temperatureProperty); //Add the declaration of a new type of generated event associated to a event key // and the content type of the generated payload PhysicalAssetEvent overheatingEvent = new PhysicalAssetEvent(GlobalKeywords.OVERHEATING_EVENT_KEY, \u0026#34;text/plain\u0026#34;); pad.getEvents().add(overheatingEvent); //Declare the availability of a target action characterized by a Key, an action type // and the expected content type and the request body PhysicalAssetAction setTemperatureAction = new PhysicalAssetAction(GlobalKeywords.SET_TEMPERATURE_ACTION_KEY, \u0026#34;temperature.actuation\u0026#34;, \u0026#34;text/plain\u0026#34;); pad.getActions().add(setTemperatureAction); //Notify the new PAD to the DT\u0026#39;s Shadowing Function this.notifyPhysicalAdapterBound(pad); //Start Device Emulation new Thread(deviceEmulation()).start(); } catch (PhysicalAdapterException | EventBusException e) { e.printStackTrace(); } } @Override public void onAdapterStop() { } private Runnable deviceEmulation(){ return () -\u0026gt; { try { //Sleep 5 seconds to emulate device startup Thread.sleep(5000); //Create a new random object to emulate temperature variations Random r = new Random(); //Publish an initial Event for a normal condition publishPhysicalAssetEventWldtEvent(new PhysicalAssetEventWldtEvent\u0026lt;\u0026gt;(GlobalKeywords.OVERHEATING_EVENT_KEY, \u0026#34;normal\u0026#34;)); //Emulate the generation on \u0026#39;n\u0026#39; temperature measurements for(int i = 0; i \u0026lt; GlobalKeywords.MESSAGE_UPDATE_NUMBER; i++){ //Sleep to emulate sensor measurement Thread.sleep(GlobalKeywords.MESSAGE_UPDATE_TIME); //Update the double randomTemperature = GlobalKeywords.TEMPERATURE_MIN_VALUE + (GlobalKeywords.TEMPERATURE_MAX_VALUE - GlobalKeywords.TEMPERATURE_MIN_VALUE) * r.nextDouble(); //Create a new event to notify the variation of a Physical Property PhysicalAssetPropertyWldtEvent\u0026lt;Double\u0026gt; newPhysicalPropertyEvent = new PhysicalAssetPropertyWldtEvent\u0026lt;\u0026gt;(GlobalKeywords.TEMPERATURE_PROPERTY_KEY, randomTemperature); //Publish the WLDTEvent associated to the Physical Property Variation publishPhysicalAssetPropertyWldtEvent(newPhysicalPropertyEvent); } //Publish a demo Physical Event associated to a \u0026#39;critical\u0026#39; overheating condition publishPhysicalAssetEventWldtEvent(new PhysicalAssetEventWldtEvent\u0026lt;\u0026gt;(GlobalKeywords.OVERHEATING_EVENT_KEY, \u0026#34;critical\u0026#34;)); } catch (EventBusException | InterruptedException e) { e.printStackTrace(); } }; } } Both Physical Adapters and Digital Adapters can be defined natively with a custom configuration provided by the developer as illustrated in the dedicated Section: Configurable Physical \u0026amp; Digital Adapters.\n","date":"February 9, 2024","id":3,"permalink":"/docs/guides/physical-adapter/","summary":"The developer can use an existing Physical Adapter or create a new one to handle the communication with a specific physical twin.","tags":"","title":"Physical Adapter"},{"content":"After the definition of the Physical Adapter it is time to start implementing the core of our DT through the definition of its shadowing function in charge of:\nHandle received PAD from Physical Adapters in order to device which properties, events, relationships or actions available on connected physical twins should be mapped and managed into the DT State Manage incoming notifications/callbacks associated to the variation of physical properties (e.g, temperature variation) or the generation of physical event (e.g., overheating) Process action requests from the digital world that should be validated and forward to the correct Physical Adapter in order to trigger the associated actions on the physical world The Shadowing Function has the responsibility to build and maintain the updated state of the Digital Twin The internal variable of any WLDT Shadowing Function (available through the base class ShadowingFunction) used to do that is DigitalTwinStateManager accessible through the variable: this.digitalTwinStateManager\nWhen the Shadowing Function has to compute the new DT State it can now work with the following method to handle DT State Transition:\nStart the DT State Transaction: startStateTransaction() DT State variation methods such as: createProperty() updateProperty() updatePropertyValue() deleteProperty() enableAction() updateAction() disableAction() registerEvent() updateRegisteredEvent() unRegisterEvent() createRelationship() addRelationshipInstance() deleteRelationship() deleteRelationshipInstance() At the end the transaction can be committed using the method: commitStateTransaction() To access the current DT State the Shadowing Function implementation can use the method this.digitalTwinStateManager.getDigitalTwinState() The information available on the DT State are:\nproperties: List of Properties with their values (if available) actions: List of Actions that can be called on the DT events: List of Events that can be generated by the DT relationships: List of Relationships and their instances (if available) evaluationInstant: The timestamp representing the evaluation instant of the DT state Available main methods on that class instance are:\nProperties: getProperty(String propertyKey): Retrieves if present the target DigitalTwinStateProperty by Key containsProperty(String propertyKey): Checks if a target Property Key is already available in the current Digital Twin\u0026rsquo;s State getPropertyList(): Loads the list of available Properties (described by the class DigitalTwinStateProperty) available on the Digital Twin\u0026rsquo;s State createProperty(DigitalTwinStateProperty\u0026lt;?\u0026gt; dtStateProperty): Allows the creation of a new Property on the Digital Twin\u0026rsquo;s State through the class DigitalTwinStateProperty readProperty(String propertyKey): Retrieves if present the target DigitalTwinStateProperty by Key updateProperty(DigitalTwinStateProperty\u0026lt;?\u0026gt; dtStateProperty): Updates the target property using the DigitalTwinStateProperty and the associated Property Key field deleteProperty(String propertyKey): Deletes the target property identified by the specified key Actions: containsAction(String actionKey): Checks if a Digital Twin State Action with the specified key is correctly registered getAction(String actionKey): Loads the target DigitalTwinStateAction by key getActionList(): Gets the list of available Actions registered on the Digital Twin\u0026rsquo;s State enableAction(DigitalTwinStateAction digitalTwinStateAction): Enables and registers the target Action described through an instance of the DigitalTwinStateAction class updateAction(DigitalTwinStateAction digitalTwinStateAction): Update the already registered target Action described through an instance of the DigitalTwinStateAction class disableAction(String actionKey): Disables and unregisters the target Action described through an instance of the DigitalTwinStateAction class Events: containsEvent(String eventKey): Check if a Digital Twin State Event with the specified key is correctly registered getEvent(String eventKey): Return the description of a registered Digital Twin State Event according to its Key getEventList(): Return the list of existing and registered Digital Twin State Events registerEvent(DigitalTwinStateEvent digitalTwinStateEvent): Register a new Digital Twin State Event updateRegisteredEvent(DigitalTwinStateEvent digitalTwinStateEvent): Update the registration and signature of an existing Digital Twin State Event unRegisterEvent(String eventKey): Un-register a Digital Twin State Event notifyDigitalTwinStateEvent(DigitalTwinStateEventNotification\u0026lt;?\u0026gt; digitalTwinStateEventNotification): Method to notify the occurrence of the target Digital Twin State Event Relationships: containsRelationship(String relationshipName): Checks if a Relationship Name is already available in the current Digital Twin\u0026rsquo;s State createRelationship(DigitalTwinStateRelationship\u0026lt;?\u0026gt; relationship): Creates a new Relationships (described by the class DigitalTwinStateRelationship) in the Digital Twin\u0026rsquo;s State addRelationshipInstance(String name, DigitalTwinStateRelationshipInstance\u0026lt;?\u0026gt; instance): Adds a new Relationship instance described through the class DigitalTwinStateRelationshipInstance and identified through its name getRelationshipList(): Loads the list of existing relationships on the Digital Twin\u0026rsquo;s State through a list of DigitalTwinStateRelationship getRelationship(String name): Gets a target Relationship identified through its name and described through the class DigitalTwinStateRelationship deleteRelationship(String name): Deletes a target Relationship identified through its name deleteRelationshipInstance(String relationshipName, String instanceKey): Deletes the target Relationship Instance using relationship name and instance Key The basic library class that we are going to extend is called ShadowingFunction and creating a new class named DemoShadowingFunction the resulting code is the same after implementing required methods the basic constructor with the id String parameter.\nimport it.wldt.adapter.digital.event.DigitalActionWldtEvent; import it.wldt.adapter.physical.PhysicalAssetDescription; import it.wldt.adapter.physical.event.PhysicalAssetEventWldtEvent; import it.wldt.adapter.physical.event.PhysicalAssetPropertyWldtEvent; import it.wldt.adapter.physical.event.PhysicalAssetRelationshipInstanceCreatedWldtEvent; import it.wldt.adapter.physical.event.PhysicalAssetRelationshipInstanceDeletedWldtEvent; import it.wldt.core.model.ShadowingModelFunction; import java.util.Map; public class DemoShadowingFunction extends ShadowingModelFunction { public DemoShadowingFunction(String id) { super(id); } //// Shadowing Function Management Callbacks //// @Override protected void onCreate() { } @Override protected void onStart() { } @Override protected void onStop() { } //// Bound LifeCycle State Management Callbacks //// @Override protected void onDigitalTwinBound(Map\u0026lt;String, PhysicalAssetDescription\u0026gt; adaptersPhysicalAssetDescriptionMap) { } @Override protected void onDigitalTwinUnBound(Map\u0026lt;String, PhysicalAssetDescription\u0026gt; map, String s) { } @Override protected void onPhysicalAdapterBidingUpdate(String s, PhysicalAssetDescription physicalAssetDescription) { } //// Physical Property Variation Callback //// @Override protected void onPhysicalAssetPropertyVariation(PhysicalAssetPropertyWldtEvent\u0026lt;?\u0026gt; physicalAssetPropertyWldtEvent) { } //// Physical Event Notification Callback //// @Override protected void onPhysicalAssetEventNotification(PhysicalAssetEventWldtEvent\u0026lt;?\u0026gt; physicalAssetEventWldtEvent) { } //// Physical Relationships Notification Callbacks //// @Override protected void onPhysicalAssetRelationshipEstablished(PhysicalAssetRelationshipInstanceCreatedWldtEvent\u0026lt;?\u0026gt; physicalAssetRelationshipInstanceCreatedWldtEvent) { } @Override protected void onPhysicalAssetRelationshipDeleted(PhysicalAssetRelationshipInstanceDeletedWldtEvent\u0026lt;?\u0026gt; physicalAssetRelationshipInstanceDeletedWldtEvent) { } //// Digital Action Received Callbacks //// @Override protected void onDigitalActionEvent(DigitalActionWldtEvent\u0026lt;?\u0026gt; digitalActionWldtEvent) { } } The methods onCreate(), onStart() and onStop() are used to receive callbacks from the DT\u0026rsquo;s core when the Shadowing Function has been effectively created within the twin, is started or stopped according to the evolution of its life cycle. In our initial implementation we are not implementing any of them but they can be useful to trigger specific behaviours according to the different phases.\nThe first method that we have to implement in order to analyze received PAD and build the Digital Twin State in terms of properties, events, relationships and available actions is the onDigitalTwinBound(Map\u0026lt;String, PhysicalAssetDescription\u0026gt; map) method. In our initial implementation we just pass through all the received characteristics recevied from each connected Physical Adapter mapping every physical entity into the DT\u0026rsquo;s state without any change or adaptation (Of course complex behaviour can be implemented to customized the digitalization process).\nThrough the following method we implement the following behaviour:\nAnalyze each received PAD from each connected and active Physical Adapter (in our case we will have just 1 Physical Adapter) Iterate over all the received Properties for each PAD and create the same Property on the Digital Twin State Start observing target Physical Properties in order to receive notification callback about physical variation through the method observePhysicalAssetProperty(property); Analyze received PAD\u0026rsquo;s Events declaration and recreates them also on the DT\u0026rsquo;s State Start observing target Physical Event in order to receive notification callback about physical event generation through the method observePhysicalAssetEvent(event); Check available Physical Action and enable them on the DT\u0026rsquo;s State. Enabled Digital Action are automatically observed by the Shadowing Function in order to receive action requests from active Digital Adapters The possibility to manually observe Physical Properties and Event has been introduced to allow the Shadowing Function to decide what to do according to the nature of the property or of the target event. For example in some cases with static properties it will not be necessary to observe any variation, and it will be enough to read the initial value to build the digital replica of that specific property.\nSince the DT State is managed through the DigitalTwinStateManager class all the changes and variation should be applied on the DT ShadowingFunction using the previously presented transaction management and the correct call of methods startStateTransaction() and commitStateTransaction().\n@Override protected void onDigitalTwinBound(Map\u0026lt;String, PhysicalAssetDescription\u0026gt; adaptersPhysicalAssetDescriptionMap) { try{ // NEW from 0.3.0 -\u0026gt; Start DT State Change Transaction this.digitalTwinStateManager.startStateTransaction(); //Iterate over all the received PAD from connected Physical Adapters adaptersPhysicalAssetDescriptionMap.values().forEach(pad -\u0026gt; { //Iterate over all the received PAD from connected Physical Adapters adaptersPhysicalAssetDescriptionMap.values().forEach(pad -\u0026gt; { pad.getProperties().forEach(property -\u0026gt; { try { //Create and write the property on the DT\u0026#39;s State this.digitalTwinState.createProperty(new DigitalTwinStateProperty\u0026lt;\u0026gt;(property.getKey(),(Double) property.getInitialValue())); //Start observing the variation of the physical property in order to receive notifications //Without this call the Shadowing Function will not receive any notifications or callback about //incoming physical property of the target type and with the target key this.observePhysicalAssetProperty(property); } catch (Exception e) { e.printStackTrace(); } }); //Iterate over available declared Physical Events for the target Physical Adapter\u0026#39;s PAD pad.getEvents().forEach(event -\u0026gt; { try { //Instantiate a new DT State Event with the same key and type DigitalTwinStateEvent dtStateEvent = new DigitalTwinStateEvent(event.getKey(), event.getType()); //Create and write the event on the DT\u0026#39;s State this.digitalTwinState.registerEvent(dtStateEvent); //Start observing the variation of the physical event in order to receive notifications //Without this call the Shadowing Function will not receive any notifications or callback about //incoming physical events of the target type and with the target key this.observePhysicalAssetEvent(event); } catch (Exception e) { e.printStackTrace(); } }); //Iterate over available declared Physical Actions for the target Physical Adapter\u0026#39;s PAD pad.getActions().forEach(action -\u0026gt; { try { //Instantiate a new DT State Action with the same key and type DigitalTwinStateAction dtStateAction = new DigitalTwinStateAction(action.getKey(), action.getType(), action.getContentType()); //Enable the action on the DT\u0026#39;s State this.digitalTwinState.enableAction(dtStateAction); } catch (Exception e) { e.printStackTrace(); } }); }); // NEW from 0.3.0 -\u0026gt; Commit DT State Change Transaction to apply the changes on the DT State and notify about the change this.digitalTwinStateManager.commitStateTransaction(); //Start observation to receive all incoming Digital Action through active Digital Adapter //Without this call the Shadowing Function will not receive any notifications or callback about //incoming request to execute an exposed DT\u0026#39;s Action observeDigitalActionEvents(); //Notify the DT Core that the Bounding phase has been correctly completed and the DT has evaluated its //internal status according to what is available and declared through the Physical Adapters notifyShadowingSync(); }catch (Exception e){ e.printStackTrace(); } } In particular the method observeDigitalActionEvents() should be called start the observation of digital actions and to receive all incoming Digital Action through active Digital Adapters. Without this call the Shadowing Function will not receive any notifications or callback about incoming request to execute an exposed DT\u0026rsquo;s Action. Of course, we have to call this method if we are mapping any digital action in our DT.\nAnother fundamental method is notifyShadowingSync() used to notify the DT Core that the Bounding phase has been correctly completed and the DT has evaluated its internal status according to what is available and declared through the Physical Adapters.\nAs mentioned, in the previous example the Shadowing Function does not apply any control or check on the nature of declared physical property. Of course in order to have a more granular control, it will be possible to use property Key or any other field or even the type of the instance through an instanceof check to implement different controls and behaviours.\nA variation (only for the property management code) to the previous method can be the following:\n//Iterate over available declared Physical Property for the target Physical Adapter\u0026#39;s PAD pad.getProperties().forEach(property -\u0026gt; { try { //Check property Key and Instance of to validate that is a Double if(property.getKey().equals(\u0026#34;temperature-property-key\u0026#34;) \u0026amp;\u0026amp; property.getInitialValue() != null \u0026amp;\u0026amp; property.getInitialValue() instanceof Double) { //Instantiate a new DT State Property of the right type, the same key and initial value DigitalTwinStateProperty\u0026lt;Double\u0026gt; dtStateProperty = new DigitalTwinStateProperty\u0026lt;Double\u0026gt;(property.getKey(),(Double) property.getInitialValue()); //Create and write the property on the DT\u0026#39;s State this.digitalTwinState.createProperty(dtStateProperty); //Start observing the variation of the physical property in order to receive notifications //Without this call the Shadowing Function will not receive any notifications or callback about //incoming physical property of the target type and with the target key this.observePhysicalAssetProperty(property); } } catch (Exception e) { e.printStackTrace(); } }); The next method that we have to implement in order to properly define and implement the behaviour of our DT through its ShadowingModelFunction are:\nonPhysicalAssetPropertyVariation: Method called when a new variation for a specific Physical Property has been detected by the associated Physical Adapter. The method receive as parameter a specific WLDT Event called PhysicalAssetPropertyWldtEvent\u0026lt;?\u0026gt; physicalPropertyEventMessage containing all the information generated by the Physical Adapter upon the variation of the monitored physical counterpart. onPhysicalAssetEventNotification: Callback method used to be notified by a PhysicalAdapter about the generation of a Physical Event. As for the previous method, also this function receive a WLDT Event parameter of type onPhysicalAssetEventNotification(PhysicalAssetEventWldtEvent\u0026lt;?\u0026gt; physicalAssetEventWldtEvent)) containing all the field of the generated physical event. onDigitalActionEvent: On the opposite this method is triggered from one of the active Digital Adapter when an Action request has been received on the Digital Interface. The method receive as parameter an instance of the WLDT Event class DigitalActionWldtEvent\u0026lt;?\u0026gt; digitalActionWldtEvent describing the target digital action request and the associated body. For the onPhysicalAssetPropertyVariation a simple implementation in charge ONLY of mapping the new Physical Property value into the corresponding DT\u0026rsquo;State property can be implemented as follows:\nThe DT State transaction management should be applied in the point of the code where the Shadowing Function receive a variation from the Physical world through a target adapter and the callback method onPhysicalAssetPropertyVariation(...)\n@Override protected void onPhysicalAssetPropertyVariation(PhysicalAssetPropertyWldtEvent\u0026lt;?\u0026gt; physicalPropertyEventMessage) { try { //Update Digital Twin State //NEW from 0.3.0 -\u0026gt; Start State Transaction this.digitalTwinStateManager.startStateTransaction(); this.digitalTwinState.updateProperty(new DigitalTwinStateProperty\u0026lt;\u0026gt;(physicalPropertyEventMessage.getPhysicalPropertyId(), physicalPropertyEventMessage.getBody())); //NEW from 0.3.0 -\u0026gt; Commit State Transaction this.digitalTwinStateManager.commitStateTransaction(); } catch (WldtDigitalTwinStatePropertyException | WldtDigitalTwinStatePropertyBadRequestException | WldtDigitalTwinStatePropertyNotFoundException | WldtDigitalTwinStateException e) { e.printStackTrace(); } } In this case as reported in the code, we call the method this.digitalTwinState.updateProperty on the Shadowing Function in order to update an existing DT\u0026rsquo;State property (previously created in the onDigitalTwinBound method). To update the value we directly use the received data on the PhysicalAssetPropertyWldtEvent without any additional check or change that might be instead needed in advanced examples.\nFollowing the same principle, a simplified digital mapping between physical and digital state upon the receving of a physical event variation can be the following:\n@Override protected void onPhysicalAssetEventNotification(PhysicalAssetEventWldtEvent\u0026lt;?\u0026gt; physicalAssetEventWldtEvent) { try { this.digitalTwinStateManager.notifyDigitalTwinStateEvent(new DigitalTwinStateEventNotification\u0026lt;\u0026gt;(physicalAssetEventWldtEvent.getPhysicalEventKey(), physicalAssetEventWldtEvent.getBody(), physicalAssetEventWldtEvent.getCreationTimestamp())); } catch (WldtDigitalTwinStateEventNotificationException | EventBusException e) { e.printStackTrace(); } } With respect to events management, we use the Shadowint Function method this.digitalTwinState.notifyDigitalTwinStateEvent to notify the other DT Components (e.g., Digital Adapters) the incoming Physical Event by creating a new instance of a DigitalTwinStateEventNotification class containing all the information associated to the event. Of course, additional controls and checks can be introduced in this method validating and processing the incoming physical message to define complex behaviours.\nThe last method that we are going to implement is the onDigitalActionEvent one where we have to handle an incoming Digital Action request associated to an Action declared on the DT\u0026rsquo;s State in the onDigitalTwinBound method. In that case the Digital Action should be forwarded to the Physical Interface in order to be sent to the physical counterpart for the effective execution.\n@Override protected void onDigitalActionEvent(DigitalActionWldtEvent\u0026lt;?\u0026gt; digitalActionWldtEvent) { try { this.publishPhysicalAssetActionWldtEvent(digitalActionWldtEvent.getActionKey(), digitalActionWldtEvent.getBody()); } catch (EventBusException e) { e.printStackTrace(); } } Also in that case we are forwarding the incoming Digital Action request described through the class DigitalActionWldtEvent to the Physical Adapter with the method of the Shadowing Function denoted as this.publishPhysicalAssetActionWldtEvent and passing directly the action key and the target Body. No additional processing or validation have been introduced here, but they might be required in advanced scenario in order to properly adapt incoming digital action request to what is effectively expected on the physical counterpart.\n","date":"February 9, 2024","id":4,"permalink":"/docs/guides/shadowing-function/","summary":"After the definition of the Physical Adapter it is time to start implementing the core of our DT through the definition of its shadowing function in charge of:","tags":"","title":"Shadowing Function"},{"content":"The las component that we have to implement to complete our first simple Digital Twin definition through the WLDT library is a Digital Adapter in charge of:\nReceiving event from the DT\u0026rsquo;s Core related to the variation of properties, events, available actions and relationships Expose received information to the external world according to its implementation and the supported protocol Handle incoming digital action and forward them to the Core in order to be validated and processed by the Shadowing Function The basic library class that we are going to extend is called DigitalAdapter and creating a new class named DemoDigitalAdapter. The DigitalTwinAdapter class can take as Generic Type the type of Configuration used to configure its behaviours. In this simplified example we are defining a DigitalAdapter without any Configuration.\nA Digital Adapter has direct access to the current DT\u0026rsquo;s State through callbacks or directly in a synchronous way using the internal variable called: digitalTwinState. Through it is possibile to navigate all the fields currently composing the state of our Digital Twin.\nThe Digital Adapter class has e long list of callback and notification method to allow the adapter to be updated about all the variation and changes on the twin. Available callbacks can be summarized as follows:\nDigital Adapter Start/Stop: onAdapterStart(): Feedback when the Digital Adapter correctly starts onAdapterStop(): Feedback when the Digital Adapter has been stopped Digital Twin Life Cycle Notifications: onDigitalTwinCreate(): The DT has been created onDigitalTwinStart(): The DT started onDigitalTwinSync(IDigitalTwinState digitalTwinState): The DT is Synchronized with its physical counterpart. The current DigitalTwinState is passed as parameter to allow the Digital Adapter to know the current state and consequently implement its behaviour onDigitalTwinUnSync(IDigitalTwinState digitalTwinState): The DT is not synchronized anymore with its physical counterpart. The last current DigitalTwinState is passed as parameter to allow the Digital Adapter to know the last state and consequently implement its behaviour onDigitalTwinStop(): The DT is stopped onDigitalTwinDestroy(): The DT has been destroyed and the application stopped The Digital Adapter DT State variations and DT events are received by the Adapter from the DT core belongs to the following categories:\nDigital Twin State Update through the method onStateUpdate(...) providing information about the new state of the Digital Twin, the previous state, and a list of changes that occurred between these two states. In the previous version each variation of a property, relationships, actions or events were notified. In the new version only a committed DT\u0026rsquo;State variation is notified to listeners. Event Notifications through the method onEventNotificationReceived(...) whenever there is a notification about an event related to the Digital Twin\u0026rsquo;s state coming from the physical world, generated by the twin and processed by the Shadowing Function. For example in the DT State we can have the declaration of the over-heating-alert structured and received in the DT State while the effective occurrence of the event and the associated notification is notified through this dedicated callback The onStateUpdate method is an abstract method that must be implemented by any class extending the DigitalAdapter class. This method is called whenever there is an update to the Digital Twin\u0026rsquo;s state. It provides information about the new state of the Digital Twin, the previous state, and a list of changes that occurred between these two states.\nThe explanation of the parameters is the following:\nnewDigitalTwinState: This parameter represents the updated state of the Digital Twin. It is an instance of the DigitalTwinState class, which encapsulates the current state information. previousDigitalTwinState: This parameter represents the state of the Digital Twin before the update. It is also an instance of the DigitalTwinState class. digitalTwinStateChangeList: This parameter is an ArrayList containing DigitalTwinStateChange objects. Each DigitalTwinStateChange object encapsulates information about a specific change that occurred between the previous and new states. It includes details such as the property or aspect of the state that changed, the previous value, and the new value. Another core method where a Digital Adapter receive the description of the DT\u0026rsquo;State is onDigitalTwinSync(IDigitalTwinState digitalTwinState). The Adapter using the parameter digitalTwinState can analyze available properties, actions, events and relationships and decide how to implement its internal behaviour with the methods presented in ShadowingFunction. The DT State is automatically monitored by each Digital Adapter while for the Events potentially generated by the DT can be observed by each adapter using:\nobserveAllDigitalTwinEventsNotifications: Enable the observation of available Digital Twin State Events Notifications. unObserveAllDigitalTwinEventsNotifications: Cancel the observation of Digital Twin State Events Notifications observeDigitalTwinEventsNotifications: Enable the observation of the notification associated to a specific list of Digital Twin State events. With respect to event a notification contains the new associated value unObserveDigitalTwinEventsNotifications: Cancel the observation of a target list of properties observeDigitalTwinEventNotification: Enable the observation of the notification associated to a single Digital Twin State event. With respect to event a notification contains the new associated value unObserveDigitalTwinEventNotification: Cancel the observation of a single target event The resulting code will be the following after adding the required methods (still empty) and the basic constructor with the id String parameter is the following:\nimport it.wldt.adapter.digital.DigitalAdapter; import it.wldt.core.state.*; public class DemoDigitalAdapter extends DigitalAdapter\u0026lt;Void\u0026gt; { public DemoDigitalAdapter(String id) { super(id); } /** * Callback to notify the adapter on its correct startup */ @Override public void onAdapterStart() {} /** * Callback to notify the adapter that has been stopped */ @Override public void onAdapterStop() {} /** * DT Life Cycle notification that the DT is correctly on Sync * @param digitalTwinState */ @Override public void onDigitalTwinSync(DigitalTwinState digitalTwinState) {} /** * DT Life Cycle notification that the DT is currently Not Sync * @param digitalTwinState */ @Override public void onDigitalTwinUnSync(DigitalTwinState digitalTwinState) {} /** * DT Life Cycle notification that the DT has been created */ @Override public void onDigitalTwinCreate() {} /** * DT Life Cycle Notification that the DT has correctly Started */ @Override public void onDigitalTwinStart() {} /** * DT Life Cycle Notification that the DT has been stopped */ @Override public void onDigitalTwinStop() {} /** * DT Life Cycle Notification that the DT has destroyed */ @Override public void onDigitalTwinDestroy() {} /** * Callback method allowing the Digital Adapter to receive the updated Digital Twin State together with * the previous state and the list of applied changes * * @param newDigitalTwinState The new Digital Twin State computed by the Shadowing Function * @param previousDigitalTwinState The previous Digital Twin State * @param digitalTwinStateChangeList The list of applied changes to compute the new Digital Twin State */ @Override protected void onStateUpdate(DigitalTwinState newDigitalTwinState, DigitalTwinState previousDigitalTwinState, ArrayList\u0026lt;DigitalTwinStateChange\u0026gt; digitalTwinStateChangeList) {} /** * Callback method to receive a new computed Event Notification (associated to event declared in the DT State) * * @param digitalTwinStateEventNotification The generated Notification associated to a DT Event */ @Override protected void onEventNotificationReceived(DigitalTwinStateEventNotification\u0026lt;?\u0026gt; digitalTwinStateEventNotification) {} } By default, a Digital Adapter observes all the variation on the DT\u0026rsquo;s State in terms of Properties, Relationships, Actions and Events. As previously mentioned the observation of DT\u0026rsquo;s State Properties allows to receive also properties variation on the method since a property is natively composed by its description (e.g., type) and its current value. On the opposite the observation on DT\u0026rsquo;s State Action, Relationships and Events allow ONLY to receive callbacks when a new entity is added or an update is occurred without receiving updates on values variation.\nThe only thing that we should add in the onDigitalTwinSync(IDigitalTwinState currentDigitalTwinState) callback is the direct observation for Events. Following this approach we can change our Digital Adapter in the following methods:\nIn onDigitalTwinSync we observe in this first simple implementation only the incoming values for declared Events in the DT\u0026rsquo;State. As previously mentioned the observation of any variation of the State structure together with Properties Values are by default observed by any Digital Adapter. In this method we use the internal variable digitalTwinState to access the DT\u0026rsquo;s state and find available Events declaration that we would like to observe.\npublic void onDigitalTwinSync(IDigitalTwinState currentDigitalTwinState) { try { //Retrieve the list of available events and observe all variations digitalTwinState.getEventList() .map(eventList -\u0026gt; eventList.stream() .map(DigitalTwinStateEvent::getKey) .collect(Collectors.toList())) .ifPresent(eventKeys -\u0026gt; { try { observeDigitalTwinEventsNotifications(eventKeys); } catch (EventBusException e) { e.printStackTrace(); } }); } catch (Exception e) { e.printStackTrace(); } } Developers extending the DigitalAdapter class should implement the onStateUpdate method to define custom logic that needs to be executed whenever the state of the Digital Twin is updated. This could include tasks such as processing state changes, updating internal variables, triggering specific actions, or notifying other components about the state update.\nHere\u0026rsquo;s an example of how the method might be implemented in a concrete subclass of DigitalAdapter:\n@Override protected void onStateUpdate(DigitalTwinState newDigitalTwinState, DigitalTwinState previousDigitalTwinState, ArrayList\u0026lt;DigitalTwinStateChange\u0026gt; digitalTwinStateChangeList) { // In newDigitalTwinState we have the new DT State System.out.println(\u0026#34;New DT State is: \u0026#34; + newDigitalTwinState); // The previous DT State is available through the variable previousDigitalTwinState System.out.println(\u0026#34;Previous DT State is: \u0026#34; + previousDigitalTwinState); // We can also check each DT\u0026#39;s state change potentially differentiating the behaviour for each change if (digitalTwinStateChangeList != null \u0026amp;\u0026amp; !digitalTwinStateChangeList.isEmpty()) { // Iterate through each state change in the list for (DigitalTwinStateChange stateChange : digitalTwinStateChangeList) { // Get information from the state change DigitalTwinStateChange.Operation operation = stateChange.getOperation(); DigitalTwinStateChange.ResourceType resourceType = stateChange.getResourceType(); DigitalTwinStateResource resource = stateChange.getResource(); // Perform different actions based on the type of operation switch (operation) { case OPERATION_UPDATE: // Handle an update operation System.out.println(\u0026#34;Update operation on \u0026#34; + resourceType + \u0026#34;: \u0026#34; + resource); break; case OPERATION_UPDATE_VALUE: // Handle an update value operation System.out.println(\u0026#34;Update value operation on \u0026#34; + resourceType + \u0026#34;: \u0026#34; + resource); break; case OPERATION_ADD: // Handle an add operation System.out.println(\u0026#34;Add operation on \u0026#34; + resourceType + \u0026#34;: \u0026#34; + resource); break; case OPERATION_REMOVE: // Handle a remove operation System.out.println(\u0026#34;Remove operation on \u0026#34; + resourceType + \u0026#34;: \u0026#34; + resource); break; default: // Handle unknown operation (optional) System.out.println(\u0026#34;Unknown operation on \u0026#34; + resourceType + \u0026#34;: \u0026#34; + resource); break; } } } else { // No state changes System.out.println(\u0026#34;No state changes detected.\u0026#34;); } } In this example, the method iterates over the list of state changes, extracts information about each change, and performs custom actions based on the changes. Developers can adapt this method to suit the specific requirements of their Digital Twin application.\n","date":"February 9, 2024","id":5,"permalink":"/docs/guides/digital-adapter/","summary":"The las component that we have to implement to complete our first simple Digital Twin definition through the WLDT library is a Digital Adapter in charge of:","tags":"","title":"Digital Adapter"},{"content":"Now that we have created the main fundamental element of a DT (Physical Adapter, Shadowing Function and Digital Adapter) we can create Class file with a main to create the WLDT Engine with the created components and start the DT.\nCreate a new Java file called DemoDigitalTwin adding the following code:\nWith the following code we now create a new Digital Twin Instance\n// Create the new Digital Twin with its Shadowing Function DigitalTwin digitalTwin = new DigitalTwin(digitalTwinId, new DemoShadowingFunction()); // Physical Adapter with Configuration digitalTwin.addPhysicalAdapter( new DemoPhysicalAdapter( String.format(\u0026#34;%s-%s\u0026#34;, digitalTwinId, \u0026#34;test-physical-adapter\u0026#34;), new DemoPhysicalAdapterConfiguration(), true)); // Digital Adapter with Configuration digitalTwin.addDigitalAdapter( new DemoDigitalAdapter( String.format(\u0026#34;%s-%s\u0026#34;, digitalTwinId, \u0026#34;test-digital-adapter\u0026#34;), new DemoDigitalAdapterConfiguration()) ); DTs cannot be directly run but it should be added to the DigitalTwinEngine in order to be executed through the WLDT Library\n// Create the Digital Twin Engine DigitalTwinEngine digitalTwinEngine = new DigitalTwinEngine(); // Add the Digital Twin to the Engine digitalTwinEngine.addDigitalTwin(digitalTwin); In order to start a DT from the Engine you can:\n// Directly start when you add it passing a second boolean value = true digitalTwinEngine.addDigitalTwin(digitalTwin. true); // Starting the single DT on the engine through its id digitalTwinEngine.startDigitalTwin(DIGITAL_TWIN_ID); // Start all the DTs registered on the engine digitalTwinEngine.startAll(); To stop a single twin or all the twin registered on the engine:\n// Stop a single DT on the engine through its id digitalTwinEngine.stopDigitalTwin(DIGITAL_TWIN_ID); // Stop all the DTs registered on the engine digitalTwinEngine.stopAll(); It is also possible to remove a DT from the Engine with a consequent stop if it is active and the deletion of its reference from the engine:\n// Remove a single DT on the engine through its id digitalTwinEngine.removeDigitalTwin(DIGITAL_TWIN_ID); // Remove all the DTs registered on the engine digitalTwinEngine.removeAll(); The resulting code in our case is:\npublic class DemoDigitalTwin { public static void main(String[] args) { try{ // Create the new Digital Twin DigitalTwin digitalTwin = new DigitalTwin( \u0026#34;test-dt-id\u0026#34;, new DemoShadowingFunction(\u0026#34;test-shadowing-function\u0026#34;) ); //Default Physical and Digital Adapter //digitalTwin.addPhysicalAdapter(new DemoPhysicalAdapter(\u0026#34;test-physical-adapter\u0026#34;)); //digitalTwin.addDigitalAdapter(new DemoDigitalAdapter(\u0026#34;test-digital-adapter\u0026#34;)); //Physical and Digital Adapters with Configuration digitalTwin.addPhysicalAdapter(new DemoConfPhysicalAdapter(\u0026#34;test-physical-adapter\u0026#34;, new DemoPhysicalAdapterConfiguration())); digitalTwin.addDigitalAdapter(new DemoConfDigitalAdapter(\u0026#34;test-digital-adapter\u0026#34;, new DemoDigitalAdapterConfiguration())); // Create the Digital Twin Engine DigitalTwinEngine digitalTwinEngine = new DigitalTwinEngine(); // Add the Digital Twin to the Engine digitalTwinEngine.addDigitalTwin(digitalTwin); // Set a new Event-Logger to a Custom One that we created with the class \u0026#39;DemoEventLogger\u0026#39; WldtEventBus.getInstance().setEventLogger(new DemoEventLogger()); // Start all the DTs registered on the engine digitalTwinEngine.startAll(); }catch (Exception e){ e.printStackTrace(); } } } ","date":"February 9, 2024","id":6,"permalink":"/docs/guides/dt-engine-dt-instance/","summary":"Now that we have created the main fundamental element of a DT (Physical Adapter, Shadowing Function and Digital Adapter) we can create Class file with a main to create the WLDT Engine with the created components and start the DT.","tags":"","title":"DT Engine \u0026 DT Instance"},{"content":"In this demo implementation, we are going to emulate an incoming Digital Action on the Digital Adapter in order to show how it can be handled by the adapter and properly forwarded to the Shadowing Function for validation and the consequent interaction with the Physical Adapter and then with the physical twin.\nIn order to add a demo Digital Action trigger on the Digital Adapter we add the following method to the DemoDigitalAdapter class:\nprivate Runnable emulateIncomingDigitalAction(){ return () -\u0026gt; { try { System.out.println(\u0026#34;Sleeping before Emulating Incoming Digital Action ...\u0026#34;); Thread.sleep(5000); Random random = new Random(); //Emulate the generation on \u0026#39;n\u0026#39; temperature measurements for(int i = 0; i \u0026lt; 10; i++){ //Sleep to emulate sensor measurement Thread.sleep(1000); double randomTemperature = 25.0 + (30.0 - 25.0) * random.nextDouble(); publishDigitalActionWldtEvent(\u0026#34;set-temperature-action-key\u0026#34;, randomTemperature); } } catch (Exception e) { e.printStackTrace(); } }; } This method uses the Digital Adapter internal function denoted as publishDigitalActionWldtEvent(String actionKey, T body) allowing the adapter to send a notification to the DT\u0026rsquo;s Core (and consequently the Shadowing Function) about the arrival of a Digital Action with a specific key and body. In our case the key is set-temperature-action-key as declared in the Physical Adapter and in the PAD and the value is a simple Double with the new temperature value.\nThen we call this method in the following way at the end ot the onDigitalTwinSync(IDigitalTwinState currentDigitalTwinState) method.\n//Start Digital Action Emulation new Thread(emulateIncomingDigitalAction()).start(); Now the Shadowing Function should be updated in order to handle the incoming Action request from the Digital Adapter. In our case the shadowing function does not apply any validation or check and just forward to action to the Physical Adapter in order to be then forwarded to the physical twin. Of course advanced implementation can be introduced for example to validate action, adapt payload and data-formats or to augment functionalities (e.g., trigger multiple physical actions from a single digital request).\nIn our simple demo implementation the updated Shadowing Function method onDigitalActionEvent(DigitalActionWldtEvent\u0026lt;?\u0026gt; digitalActionWldtEvent) results as follows:\n@Override protected void onDigitalActionEvent(DigitalActionWldtEvent\u0026lt;?\u0026gt; digitalActionWldtEvent) { try { this.publishPhysicalAssetActionWldtEvent(digitalActionWldtEvent.getActionKey(), digitalActionWldtEvent.getBody()); } catch (Exception e) { e.printStackTrace(); } } This forwarding of the action triggers the corresponding Physical Adapter method onIncomingPhysicalAction(PhysicalAssetActionWldtEvent\u0026lt;?\u0026gt; physicalAssetActionWldtEvent) that in our case is emulated just with a Log on the console. Also in that case advanced Physical Adapter implementation can be introduced for example to adapt the request from a high-level (and potentially standard) DT action description to the custom requirements of the specific physical twin managed by the adapter.\n@Override public void onIncomingPhysicalAction(PhysicalAssetActionWldtEvent\u0026lt;?\u0026gt; physicalAssetActionWldtEvent) { try{ if(physicalAssetActionWldtEvent != null \u0026amp;\u0026amp; physicalAssetActionWldtEvent.getActionKey().equals(SET_TEMPERATURE_ACTION_KEY) \u0026amp;\u0026amp; physicalAssetActionWldtEvent.getBody() instanceof Double) { System.out.println(\u0026#34;Received Action Request: \u0026#34; + physicalAssetActionWldtEvent.getActionKey() + \u0026#34; with Body: \u0026#34; + physicalAssetActionWldtEvent.getBody()); } else System.err.println(\u0026#34;Wrong Action Received !\u0026#34;); }catch (Exception e){ e.printStackTrace(); } } ","date":"February 9, 2024","id":7,"permalink":"/docs/guides/digital-actions/","summary":"In this demo implementation, we are going to emulate an incoming Digital Action on the Digital Adapter in order to show how it can be handled by the adapter and properly forwarded to the Shadowing Function for validation and the consequent interaction with the Physical Adapter and then with the physical twin.","tags":"","title":"Digital Actions"},{"content":"The WLDT library provides a native method to define Configurable Physical ad Digital Adapters specifying a custom configuration class passed as parameter in the constructor.\nStarting with the Physical Adapter created in the previous example DemoPhysicalAdapter instead of extending the base class PhysicalAdapter we can extend now ConfigurablePhysicalAdapter\u0026lt;C\u0026gt; where C is the name of the that we would like to use as configuration.\nIn our example we can create a simple configuration class called DemoPhysicalAdapterConfiguration where we move the constant variable used to implement the behaviour of our demo physical adapter. The resulting class will be the following:\npublic class DemoPhysicalAdapterConfiguration { private int messageUpdateTime = GlobalKeywords.MESSAGE_UPDATE_TIME; private int messageUpdateNumber = GlobalKeywords.MESSAGE_UPDATE_NUMBER; private double temperatureMinValue = GlobalKeywords.TEMPERATURE_MIN_VALUE; private double temperatureMaxValue = GlobalKeywords.TEMPERATURE_MAX_VALUE; public DemoPhysicalAdapterConfiguration() { } public DemoPhysicalAdapterConfiguration(int messageUpdateTime, int messageUpdateNumber, double temperatureMinValue, double temperatureMaxValue) { this.messageUpdateTime = messageUpdateTime; this.messageUpdateNumber = messageUpdateNumber; this.temperatureMinValue = temperatureMinValue; this.temperatureMaxValue = temperatureMaxValue; } public int getMessageUpdateTime() { return messageUpdateTime; } public void setMessageUpdateTime(int messageUpdateTime) { this.messageUpdateTime = messageUpdateTime; } public int getMessageUpdateNumber() { return messageUpdateNumber; } public void setMessageUpdateNumber(int messageUpdateNumber) { this.messageUpdateNumber = messageUpdateNumber; } public double getTemperatureMinValue() { return temperatureMinValue; } public void setTemperatureMinValue(double temperatureMinValue) { this.temperatureMinValue = temperatureMinValue; } public double getTemperatureMaxValue() { return temperatureMaxValue; } public void setTemperatureMaxValue(double temperatureMaxValue) { this.temperatureMaxValue = temperatureMaxValue; } } Now we can create or update our Physical Adapter extending ConfigurablePhysicalAdapter\u0026lt;DemoPhysicalAdapterConfiguration\u0026gt; as illustrated in the following snippet:\npublic class DemoPhysicalAdapter extends ConfigurablePhysicalAdapter\u0026lt;DemoPhysicalAdapterConfiguration\u0026gt; { [...] } Extending this class also the constructor should be updated getting as a parameter the expected configuration instance. Our constructor will be the following:\npublic DemoConfPhysicalAdapter(String id, DemoPhysicalAdapterConfiguration configuration) { super(id, configuration); } After that change since we removed and moved the used constant values into the new Configuration class we have also to update the deviceEmulation() method having access to the configuration through the method getConfiguration() or this.getConfiguration() directly on the adapter.\nprivate Runnable deviceEmulation(){ return () -\u0026gt; { try { System.out.println(\u0026#34;[DemoPhysicalAdapter] -\u0026gt; Sleeping before Starting Physical Device Emulation ...\u0026#34;); //Sleep 5 seconds to emulate device startup Thread.sleep(10000); System.out.println(\u0026#34;[DemoPhysicalAdapter] -\u0026gt; Starting Physical Device Emulation ...\u0026#34;); //Create a new random object to emulate temperature variations Random r = new Random(); //Publish an initial Event for a normal condition publishPhysicalAssetEventWldtEvent(new PhysicalAssetEventWldtEvent\u0026lt;\u0026gt;(GlobalKeywords.OVERHEATING_EVENT_KEY, \u0026#34;normal\u0026#34;)); //Emulate the generation on \u0026#39;n\u0026#39; temperature measurements for(int i = 0; i \u0026lt; getConfiguration().getMessageUpdateNumber(); i++){ //Sleep to emulate sensor measurement Thread.sleep(getConfiguration().getMessageUpdateTime()); //Update the double randomTemperature = getConfiguration().getTemperatureMinValue() + (getConfiguration().getTemperatureMaxValue() - getConfiguration().getTemperatureMinValue()) * r.nextDouble(); //Create a new event to notify the variation of a Physical Property PhysicalAssetPropertyWldtEvent\u0026lt;Double\u0026gt; newPhysicalPropertyEvent = new PhysicalAssetPropertyWldtEvent\u0026lt;\u0026gt;(GlobalKeywords.TEMPERATURE_PROPERTY_KEY, randomTemperature); //Publish the WLDTEvent associated to the Physical Property Variation publishPhysicalAssetPropertyWldtEvent(newPhysicalPropertyEvent); } //Publish a demo Physical Event associated to a \u0026#39;critical\u0026#39; overheating condition publishPhysicalAssetEventWldtEvent(new PhysicalAssetEventWldtEvent\u0026lt;\u0026gt;(GlobalKeywords.OVERHEATING_EVENT_KEY, \u0026#34;critical\u0026#34;)); } catch (EventBusException | InterruptedException e) { e.printStackTrace(); } }; } A similar approach can be adopted also for the Digital Adapter with the small difference that the base class DigitalAdapter already allow the possibility to specify a configuration. For this reason in the previous example we extended DigitalAdapter\u0026lt;Void\u0026gt; avoiding to specifying a configuration.\nIn this updated version we can create a new DemoDigitalAdapterConfiguration class containing the parameter association to the emulation of the action and then update our adapter to support the new configuration. Our new configuration class will be:\npublic class DemoDigitalAdapterConfiguration { private int sleepTimeMs = GlobalKeywords.ACTION_SLEEP_TIME_MS; private int emulatedActionCount = GlobalKeywords.EMULATED_ACTION_COUNT; private double temperatureMinValue = GlobalKeywords.TEMPERATURE_MIN_VALUE; private double temperatureMaxValue = GlobalKeywords.TEMPERATURE_MAX_VALUE; public DemoDigitalAdapterConfiguration() { } public DemoDigitalAdapterConfiguration(int sleepTimeMs, int emulatedActionCount, double temperatureMinValue, double temperatureMaxValue) { this.sleepTimeMs = sleepTimeMs; this.emulatedActionCount = emulatedActionCount; this.temperatureMinValue = temperatureMinValue; this.temperatureMaxValue = temperatureMaxValue; } public int getSleepTimeMs() { return sleepTimeMs; } public void setSleepTimeMs(int sleepTimeMs) { this.sleepTimeMs = sleepTimeMs; } public int getEmulatedActionCount() { return emulatedActionCount; } public void setEmulatedActionCount(int emulatedActionCount) { this.emulatedActionCount = emulatedActionCount; } public double getTemperatureMinValue() { return temperatureMinValue; } public void setTemperatureMinValue(double temperatureMinValue) { this.temperatureMinValue = temperatureMinValue; } public double getTemperatureMaxValue() { return temperatureMaxValue; } public void setTemperatureMaxValue(double temperatureMaxValue) { this.temperatureMaxValue = temperatureMaxValue; } } After that we can update the declaration of our Digital Adapter and modify its constructor to accept the configuration. The resulting class will be:\npublic class DemoDigitalAdapter extends DigitalAdapter\u0026lt;DemoDigitalAdapterConfiguration\u0026gt; { public DemoDigitalAdapter(String id, DemoDigitalAdapterConfiguration configuration) { super(id, configuration); } [...] } Of course the possibility to have this configuration will allow us to improve the emulateIncomingDigitalAction method in the following way having access to the configuration through the method getConfiguration() or this.getConfiguration() directly on the adapter:\nprivate Runnable emulateIncomingDigitalAction(){ return () -\u0026gt; { try { System.out.println(\u0026#34;[DemoDigitalAdapter] -\u0026gt; Sleeping before Emulating Incoming Digital Action ...\u0026#34;); Thread.sleep(5000); Random random = new Random(); //Emulate the generation on \u0026#39;n\u0026#39; temperature measurements for(int i = 0; i \u0026lt; getConfiguration().getEmulatedActionCount(); i++){ //Sleep to emulate sensor measurement Thread.sleep(getConfiguration().getSleepTimeMs()); double randomTemperature = getConfiguration().getTemperatureMinValue() + (getConfiguration().getTemperatureMaxValue() - getConfiguration().getTemperatureMinValue()) * random.nextDouble(); publishDigitalActionWldtEvent(\u0026#34;set-temperature-action-key\u0026#34;, randomTemperature); } } catch (Exception e) { e.printStackTrace(); } }; } When we have updated both adapters making them configurable we can update our main function in the process that we have previouly device using the updated adapters and passing the configurations:\npublic class DemoDigitalTwin { public static void main(String[] args) { try{ WldtEngine digitalTwinEngine = new WldtEngine(new DemoShadowingFunction(\u0026#34;test-shadowing-function\u0026#34;), \u0026#34;test-digital-twin\u0026#34;); //Default Physical and Digital Adapter //digitalTwinEngine.addPhysicalAdapter(new DemoPhysicalAdapter(\u0026#34;test-physical-adapter\u0026#34;)); //digitalTwinEngine.addDigitalAdapter(new DemoDigitalAdapter(\u0026#34;test-digital-adapter\u0026#34;)); //Physical and Digital Adapters with Configuration digitalTwinEngine.addPhysicalAdapter(new DemoConfPhysicalAdapter(\u0026#34;test-physical-adapter\u0026#34;, new DemoPhysicalAdapterConfiguration())); digitalTwinEngine.addDigitalAdapter(new DemoConfDigitalAdapter(\u0026#34;test-digital-adapter\u0026#34;, new DemoDigitalAdapterConfiguration())); digitalTwinEngine.startLifeCycle(); }catch (Exception e){ e.printStackTrace(); } } } ","date":"February 9, 2024","id":8,"permalink":"/docs/guides/configurable-adapters/","summary":"The WLDT library provides a native method to define Configurable Physical ad Digital Adapters specifying a custom configuration class passed as parameter in the constructor.","tags":"","title":"Configurable Adapters"},{"content":"The MqttPhysicalAdapter library provides a streamlined solution for efficiently managing physical assets through the MQTT protocol. It offers a range of features, including a versatile builder for effortless configuration of MQTT connections, dedicated classes for handling both incoming and outgoing topics, and a specialized adapter designed for seamless integration with diverse physical assets.\nKey Features:\nBuilder for MQTT Configuration: The library incorporates a flexible builder pattern, enabling users to effortlessly configure the essential parameters of the MQTT connection. This includes specifying the MQTT broker\u0026rsquo;s address, port, and other relevant details to establish a reliable and customizable communication link. Incoming and Outgoing Topic Handling: MqttPhysicalAdapter facilitates the handling of incoming and outgoing topics, crucial for communication between the physical assets and the MQTT broker. The library includes dedicated classes for defining and managing topics, allowing users to efficiently subscribe to incoming data and publish outgoing messages. Adapter for Physical Asset Integration: At the core of the library is a robust adapter designed specifically for integrating with various physical assets. This adapter streamlines the process of connecting and interacting with physical devices, ensuring a smooth and standardized approach to managing asset-related data. In the WLDT library, Physical Adapters has the responsibility to generate and publish the PhysicalAssetDescription (PAD) to describe the capabilities and the characteristics of our object allowing the Shadowing Function to decide how to digitalize its physical counterpart.\nIn the MqttPhysicalAdapter the generation of the PAD (Physical Asset Description) is automatically and internally executed by the adapter itself accordingly to the adapter configuration in terms of MQTT topics and their mapping with DT\u0026rsquo;s properties, events and actions.\nPrerequisites:\nExternal MQTT Broker: The MqttPhysicalAdapter library requires an external MQTT broker for optimal functionality. Users must have access to a reliable MQTT broker to which the adapter can subscribe. This external broker serves as the central communication hub, facilitating the exchange of messages between the adapter and the physical assets. A complete example is provided in the test folder with a complete DT Creation in the TestMain class together with MQTT IoT demo device and a test MQTT consumer.\nWLDT-Core Version Compatibility The correct mapping and compatibility between versions is reported in the following table\nmqtt-physical-adapter wldt-core 0.2.1 wldt-core 0.3.0 0.1.0 ✅ ❌ 0.1.1 ❌ ✅ Installation To use MqttPhysicalAdapter in your Java project, you can include it as a dependency using Maven or Gradle.\nMaven \u0026lt;dependency\u0026gt; \u0026lt;groupId\u0026gt;io.github.wldt\u0026lt;/groupId\u0026gt; \u0026lt;artifactId\u0026gt;mqtt-physical-adapter\u0026lt;/artifactId\u0026gt; \u0026lt;version\u0026gt;0.1.1\u0026lt;/version\u0026gt; \u0026lt;/dependency\u0026gt; Gradle implementation \u0026#39;io.github.wldt:mqtt-physical-adapter:0.1.1\u0026#39; Class Structure \u0026amp; Functionalities MqttPhysicalAdapterConfigurationBuilder \u0026amp; Main Methods The MqttPhysicalAdapterConfigurationBuilder is the class used to build the configuration used by the PhysicalAdater and described and implemented through the class MqttPhysicalAdapterConfiguration.\nIn order to create a configuration builder we can use the static method builder() on the MqttPhysicalAdapterConfiguration class:\nMqttPhysicalAdapterConfiguration.builder(); On the builder the available methods that can be used are:\naddPhysicalAssetPropertyAndTopic public \u0026lt;T\u0026gt; MqttPhysicalAdapterConfigurationBuilder addPhysicalAssetPropertyAndTopic(String propertyKey, T initialValue, String topic, Function\u0026lt;String, T\u0026gt; topicFunction) throws MqttPhysicalAdapterConfigurationException Adds a physical asset property and its corresponding MQTT topic to the configuration.\nType Parameter T: The type of the property. propertyKey: The key of the property. initialValue: The initial value of the property. topic: The MQTT topic associated with the property. topicFunction: A function to parse the MQTT topic payload into the property type. Returns: The updated MqttPhysicalAdapterConfigurationBuilder.\nThrows: MqttPhysicalAdapterConfigurationException - If there is a configuration error.\naddPhysicalAssetActionAndTopic public \u0026lt;T\u0026gt; MqttPhysicalAdapterConfigurationBuilder addPhysicalAssetActionAndTopic(String actionKey, String type, String contentType, String topic, Function\u0026lt;T, String\u0026gt; topicFunction) throws MqttPhysicalAdapterConfigurationException Adds a physical asset action and its corresponding MQTT topic to the configuration.\nType Parameter T: The type of the action payload. actionKey: The key of the action. type: The type of the action. contentType: The content type of the action. topic: The MQTT topic associated with the action. topicFunction: A function to convert the action payload into the MQTT topic payload. Returns: The updated MqttPhysicalAdapterConfigurationBuilder.\nThrows: MqttPhysicalAdapterConfigurationException - If there is a configuration error.\naddPhysicalAssetEventAndTopic public \u0026lt;T\u0026gt; MqttPhysicalAdapterConfigurationBuilder addPhysicalAssetEventAndTopic(String eventKey, String type, String topic, Function\u0026lt;String, T\u0026gt; topicFunction) throws MqttPhysicalAdapterConfigurationException Adds a physical asset event and its corresponding MQTT topic to the configuration.\nType Parameter T: The type of the event payload. eventKey: The key of the event. type: The type of the event. topic: The MQTT topic associated with the event. topicFunction: A function to parse the MQTT topic payload into the event payload type. Returns: The updated MqttPhysicalAdapterConfigurationBuilder.\nThrows: MqttPhysicalAdapterConfigurationException - If there is a configuration error.\naddIncomingTopic public MqttPhysicalAdapterConfigurationBuilder addIncomingTopic(DigitalTwinIncomingTopic topic, List\u0026lt;PhysicalAssetProperty\u0026lt;?\u0026gt;\u0026gt; properties, List\u0026lt;PhysicalAssetEvent\u0026gt; events) throws MqttPhysicalAdapterConfigurationException This method is used when multiple properties or events can be associated to a single MQTT topic on the physical device. It adds a DigitalTwinIncomingTopic describing the topic where the DT will receive the data along with its related lists of properties and events associated to that topic.\ntopic: The DigitalTwinIncomingTopic to be added. properties: The list of related physical asset properties. events: The list of related physical asset events. Returns: The updated MqttPhysicalAdapterConfigurationBuilder.\nThrows: MqttPhysicalAdapterConfigurationException - If there is a configuration error.\naddOutgoingTopic public MqttPhysicalAdapterConfigurationBuilder addOutgoingTopic(String actionKey, String type, String contentType, DigitalTwinOutgoingTopic topic) throws MqttPhysicalAdapterConfigurationException Adds a DigitalTwinOutgoingTopic to the configuration.\nactionKey: The key of the associated action. type: The type of the associated action. contentType: The content type of the associated action. topic: The DigitalTwinOutgoingTopic to be added. Returns: The updated MqttPhysicalAdapterConfigurationBuilder.\nThrows: MqttPhysicalAdapterConfigurationException - If there is a configuration error.\nAdditional Methods setConnectionTimeout(Integer connectionTimeout): Sets the connection timeout for the MQTT client. Returns the builder for method chaining. Throws MqttPhysicalAdapterConfigurationException if the provided timeout is invalid. setCleanSessionFlag(boolean cleanSession): Sets the clean session flag for the MQTT client. Returns the builder for method chaining. setAutomaticReconnectFlag(boolean automaticReconnect): Sets the automatic reconnect flag for the MQTT client. Returns the builder for method chaining. setMqttClientPersistence(MqttClientPersistence persistence): Sets the persistence for the MQTT client. Returns the builder for method chaining. Throws MqttPhysicalAdapterConfigurationException if the provided persistence is null. build(): Builds and returns the finalized MqttPhysicalAdapterConfiguration object. Throws MqttPhysicalAdapterConfigurationException if the configuration is incomplete or invalid. MqttPhysicalAdapter The MqttPhysicalAdapter class is the core component for interacting with physical assets. Instantiate it with a unique ID and the configuration. It extends the default WLDT Library PhysicalAdapter implementing all the functionalities to automatically interact with an MQTT physical device following the specifications and details provided in the MqttPhysicalAdapterConfiguration and built using MqttPhysicalAdapterConfigurationBuilder.\nAn example of its creation is:\nMqttPhysicalAdapter mqttPhysicalAdapter = new MqttPhysicalAdapter(\u0026#34;uniqueId\u0026#34;, configuration); Integrated Example This example demonstrates the integration of a MqttPhysicalAdapter within a Digital Twin setup, where multiple adapters (including a console adapter) are added to a Digital Twin, and the overall system is managed by a DigitalTwinEngine.\n// Create a Digital Twin with a default shadowing function DigitalTwin digitalTwin = new DigitalTwin(\u0026#34;mqtt-digital-twin\u0026#34;, new DefaultShadowingFunction()); // Create an instance of ConsoleDigitalAdapter ConsoleDigitalAdapter consoleDigitalAdapter = new ConsoleDigitalAdapter(); // Create an instance of MqttPhysicalAdapterConfiguration MqttPhysicalAdapterConfiguration config = MqttPhysicalAdapterConfiguration.builder(\u0026#34;127.0.0.1\u0026#34;, 1883) .addPhysicalAssetPropertyAndTopic(\u0026#34;intensity\u0026#34;, 0, \u0026#34;sensor/intensity\u0026#34;, Integer::parseInt) .addIncomingTopic(new DigitalTwinIncomingTopic(\u0026#34;sensor/state\u0026#34;, getSensorStateFunction()), createIncomingTopicRelatedPropertyList(), new ArrayList\u0026lt;\u0026gt;()) .addPhysicalAssetEventAndTopic(\u0026#34;overheating\u0026#34;, \u0026#34;text/plain\u0026#34;, \u0026#34;sensor/overheating\u0026#34;, Function.identity()) .addPhysicalAssetActionAndTopic(\u0026#34;switch-off\u0026#34;, \u0026#34;sensor.actuation\u0026#34;, \u0026#34;text/plain\u0026#34;, \u0026#34;sensor/actions/switch\u0026#34;, actionBody -\u0026gt; \u0026#34;switch\u0026#34; + actionBody) .build(); // Create an instance of the MQTT Physical Adapter using the defined configuration MqttPhysicalAdapter mqttPhysicalAdapter = new MqttPhysicalAdapter(\u0026#34;test-mqtt-pa\u0026#34;, config); // Add both Digital and Physical Adapters to the Digital Twin digitalTwin.addDigitalAdapter(consoleDigitalAdapter); digitalTwin.addPhysicalAdapter(mqttPhysicalAdapter); // Create the Digital Twin Engine DigitalTwinEngine digitalTwinEngine = new DigitalTwinEngine(); // Add the Digital Twin to the Engine digitalTwinEngine.addDigitalTwin(digitalTwin); // Start all the Digital Twins registered on the engine digitalTwinEngine.startAll(); In this example the createIncomingTopicRelatedPropertyList() used to map properties and events associated to a single topic is the following:\nprivate static List\u0026lt;PhysicalAssetProperty\u0026lt;?\u0026gt;\u0026gt; createIncomingTopicRelatedPropertyList(){ List\u0026lt;PhysicalAssetProperty\u0026lt;?\u0026gt;\u0026gt; properties = new ArrayList\u0026lt;\u0026gt;(); properties.add(new PhysicalAssetProperty\u0026lt;\u0026gt;(\u0026#34;temperature\u0026#34;, 0)); properties.add(new PhysicalAssetProperty\u0026lt;\u0026gt;(\u0026#34;humidity\u0026#34;, 0)); return properties; } This information are used by the adapter to build the PAD describe the capabilities and the characteristics of our object allowing the Shadowing Function to decide how to digitalize its physical counterpart.\n","date":"February 9, 2024","id":9,"permalink":"/docs/adapters/mqtt-physical-adapter/","summary":"The MqttPhysicalAdapter library provides a streamlined solution for efficiently managing physical assets through the MQTT protocol. It offers a range of features, including a versatile builder for effortless configuration of MQTT connections, dedicated classes for handling both incoming and outgoing topics, and a specialized adapter designed for seamless integration with diverse physical assets.","tags":"","title":"MQTT Physical Adapter"},{"content":"","date":"February 9, 2024","id":10,"permalink":"/docs/change-logs/","summary":"","tags":"","title":"Change Logs"},{"content":"The MqttDigitalAdapter,\nMqttDigitalAdapterConfiguration, and MqttDigitalAdapterConfigurationBuilder classes and guides you through using these classes to set up an MQTT Digital Adapter within WLDT.\nRequires an external MQTT broker to send messages.\nMain functionalities are:\nManages the interaction between the Digital Twin and external systems. Handles state updates, events, and property changes. Dynamic configuration of the MqttDigitalAdapter with broker details, topics, and other settings. Allows customization of data and payload management associated to MQTT topics for properties, events, and actions. Prerequisites:\nExternal MQTT Broker: The MqttDigitalAdapter library requires an external MQTT broker for optimal functionality and communication. Users must have access to a reliable MQTT broker to which the adapter can subscribe and publish. This external broker serves as the central communication hub, facilitating the exchange of messages between the adapter and digital applications A complete example is provided in the test folder with a complete DT Creation in the TestMain class together with MQTT IoT demo device and a test MQTT consumer.\nWLDT-Core Version Compatibility The correct mapping and compatibility between versions is reported in the following table\nmqtt-digital-adapter wldt-core 0.2.1 wldt-core 0.3.0 0.1.0 ✅ ❌ 0.1.1 ❌ ✅ Installation To use MqttDigitalAdapter in your Java project, you can include it as a dependency using Maven or Gradle.\nMaven \u0026lt;dependency\u0026gt; \u0026lt;groupId\u0026gt;io.github.wldt\u0026lt;/groupId\u0026gt; \u0026lt;artifactId\u0026gt;mqtt-digital-adapter\u0026lt;/artifactId\u0026gt; \u0026lt;version\u0026gt;0.1.1\u0026lt;/version\u0026gt; \u0026lt;/dependency\u0026gt; Gradle implementation \u0026#39;io.github.wldt:mqtt-digital-adapter:0.1.1\u0026#39; Class Structure \u0026amp; Functionalities MqttDigitalAdapterConfiguration MqttDigitalAdapterConfiguration is a crucial class in the Digital Twin library, allowing developers to configure the behavior of the MQTT Digital Adapter. It provides a flexible and customizable way to set up MQTT communication parameters, topics for properties, events, and actions.\nKey functionalities and exposed capabilities:\nBroker Configuration brokerAddress and brokerPort: Set the MQTT broker\u0026rsquo;s address and port. username and password: Set optional credentials for connecting to the broker. Client Configuration clientId: Unique identifier for the MQTT client. cleanSessionFlag: Flag indicating whether the client starts with a clean session. connectionTimeout: Maximum time to wait for the connection to the MQTT broker. MQTT Client Persistence persistence: Configurable persistence for the MQTT client\u0026rsquo;s data. Reconnect Configuration: automaticReconnectFlag: Flag enabling or disabling automatic reconnection. Topic Configuration: propertyUpdateTopics: Map of property update topics. eventNotificationTopics: Map of event notification topics. actionIncomingTopics: Map of incoming action topics. Builder Methods: builder: Static method to start building a new configuration. addPropertyTopic: Add a property topic with specified parameters. addEventNotificationTopic: Add an event notification topic. addActionTopic: Add an action topic. setConnectionTimeout: Set the connection timeout. setCleanSessionFlag: Set the clean session flag. setAutomaticReconnectFlag: Set the automatic reconnect flag. setMqttClientPersistence: Set the MQTT client persistence. build: Finalize the configuration and build the instance. MqttDigitalAdapterConfigurationBuilder The MqttDigitalAdapterConfigurationBuilder is a powerful tool designed to simplify the process of constructing configurations for the MQTT Digital Adapter in the Digital Twin library. It offers a fluent and intuitive interface, allowing developers to define various aspects of MQTT communication seamlessly.\nBuilder Instantiation The builder is instantiated by providing essential parameters like brokerAddress and brokerPort or including an optional clientId\nMqttDigitalAdapterConfigurationBuilder builder = MqttDigitalAdapterConfiguration.builder(\u0026#34;127.0.0.1\u0026#34;, 1883); Adding Property Topics Developers can add property topics with specific configurations, such as the key, topic, QoS level, and a function to convert property values to payload.\nbuilder.addPropertyTopic(\u0026#34;energy\u0026#34;, \u0026#34;dummy/properties/energy\u0026#34;, MqttQosLevel.MQTT_QOS_0, value -\u0026gt; String.valueOf(((Double)value).intValue())); Adding Event Notification Topics Event notification topics are easily added, including event keys, topics, QoS levels, and payload conversion functions.\nbuilder.addEventNotificationTopic(\u0026#34;overheating\u0026#34;, \u0026#34;dummy/events/overheating/notifications\u0026#34;, MqttQosLevel.MQTT_QOS_0, Object::toString); Adding Action Topics Developers can include action topics with key, topic, and a function to convert the payload to the desired action.\nbuilder.addActionTopic(\u0026#34;switch_off\u0026#34;, \u0026#34;app/actions/switch-off\u0026#34;, msg -\u0026gt; \u0026#34;OFF\u0026#34;); Connection Options Developers can set the connection timeout for the MQTT client.\nbuilder.setConnectionTimeout(30); The clean session flag can be configured based on the desired behavior.\nbuilder.setCleanSessionFlag(true); Developers can specify whether the MQTT client should automatically reconnect in case of a connection failure.\nbuilder.setAutomaticReconnectFlag(true); The builder allows setting a custom MQTT client persistence, such as an in-memory persistence or a file-based one.\nbuilder.setMqttClientPersistence(new MemoryPersistence()); Building Configuration The final configuration is built using the build method.\nMqttDigitalAdapterConfiguration configuration = builder.build(); MqttDigitalAdapter MqttDigitalAdapter extends DigitalAdapter and specializes in MQTT communication for Digital Twin instances. It handles the publication of state updates, events, and property changes over MQTT. This class facilitates seamless integration with MQTT-enabled systems.\nIt uses the information defined and provided in the `` to handle the communication both with the DT Core and external application interested to interact with the DT through the MQTT protocol.\nHere\u0026rsquo;s a basic example illustrating how to use MqttDigitalAdapter:\n// Create a Digital Twin instance DigitalTwin digitalTwin = new DigitalTwin(\u0026#34;my-digital-twin\u0026#34;, new DefaultShadowingFunction()); // Add a Physical Adapter to the DT [...] // Build the MQTT Digital Adapter Configuration MqttDigitalAdapterConfiguration configuration = MqttDigitalAdapterConfiguration.builder(\u0026#34;127.0.0.1\u0026#34;, 1883) .addPropertyTopic(\u0026#34;energy\u0026#34;, \u0026#34;dummy/properties/energy\u0026#34;, MqttQosLevel.MQTT_QOS_0, value -\u0026gt; String.valueOf(((Double)value).intValue())) .addActionTopic(\u0026#34;switch_off\u0026#34;, \u0026#34;app/actions/switch-off\u0026#34;, msg -\u0026gt; \u0026#34;OFF\u0026#34;) .build(); // Add the MQTT Digital Adapter to the Digital Twin digitalTwin.addDigitalAdapter(new MqttDigitalAdapter(\u0026#34;mqtt-da\u0026#34;, configuration)); // Create the Digital Twin Engine and start the simulation DigitalTwinEngine digitalTwinEngine = new DigitalTwinEngine(); digitalTwinEngine.addDigitalTwin(digitalTwin); digitalTwinEngine.startAll(); ","date":"February 9, 2024","id":11,"permalink":"/docs/adapters/mqtt-digital-adapter/","summary":"The MqttDigitalAdapter,\nMqttDigitalAdapterConfiguration, and MqttDigitalAdapterConfigurationBuilder classes and guides you through using these classes to set up an MQTT Digital Adapter within WLDT.","tags":"","title":"MQTT Digital Adapter"},{"content":"Digital Adapters The following methods have been discontinued and removed from the DigitalAdapter class: onStateChangePropertyCreated onStateChangePropertyUpdated onStateChangePropertyDeleted onStatePropertyUpdated onStatePropertyDeleted onStateChangeActionEnabled onStateChangeActionUpdated onStateChangeActionDisabled onStateChangeEventRegistered onStateChangeEventRegistrationUpdated onStateChangeEventUnregistered onStateChangeRelationshipInstanceDeleted onStateChangeRelationshipDeleted onStateChangeRelationshipInstanceCreated onStateChangeRelationshipCreated onDigitalTwinStateEventNotificationReceived The Signature of the following methods have been changed: onDigitalTwinSync(IDigitalTwinState currentDigitalTwinState) -\u0026gt; onDigitalTwinSync(DigitalTwinState currentDigitalTwinState) onDigitalTwinUnSync(IDigitalTwinState currentDigitalTwinState) -\u0026gt; onDigitalTwinUnSync(DigitalTwinState currentDigitalTwinState) New methods that have been added are: onStateUpdate(DigitalTwinState newDigitalTwinState, DigitalTwinState previousDigitalTwinState, ArrayList\u0026lt;DigitalTwinStateChange\u0026gt; digitalTwinStateChangeList) onEventNotificationReceived(DigitalTwinStateEventNotification\u0026lt;?\u0026gt; digitalTwinStateEventNotification) For additional details about Digital Adapters check Sub Section [[Change Log - v.0.3.0#Digital Adapter| Digital Adapters]] Shadowing Function ShadowingModelFunction is now ShadowingFunction this.digitalTwinState is not directly accessible anymore and it is wrapped through the DigitalTwinStateManager using the variable digitalTwinStateManager (see next descriptions and changes) The method addRelationshipInstance now take only one parameter that is the DigitalTwinStateRelationshipInstance The same change for example should be applied in the point of the code where the Shadowing Function receive a variation from the Physical world through a target adapter and the callback method onPhysicalAssetPropertyVariation(...) When the Shadowing Function has to compute the new DT State it can now work with the following method to handle DT State Transition: this.digitalTwinStateManager.startStateTransaction() DT State variation methods such as: digitalTwinStateManager.createProperty() digitalTwinStateManager.updateProperty() digitalTwinStateManager.updatePropertyValue() digitalTwinStateManager.deleteProperty() digitalTwinStateManager.enableAction() digitalTwinStateManager.updateAction() digitalTwinStateManager.disableAction() digitalTwinStateManager.registerEvent() digitalTwinStateManager.updateRegisteredEvent() digitalTwinStateManager.unRegisterEvent() digitalTwinStateManager.createRelationship() digitalTwinStateManager.addRelationshipInstance() digitalTwinStateManager.deleteRelationship() digitalTwinStateManager.deleteRelationshipInstance() At the end the transaction can be committed using the method: digitalTwinStateManager.commitStateTransaction() The method notifyDigitalTwinStateEvent is now available through the digitalTwinStateManager Additional Details associated to Shadowing Function Migration can be found in the dedicated section [[Change Log - v.0.3.0#Shadowing Function Changes | Shadowing Function Changes]] WLDT Engine \u0026amp; DT Creation WldtEngine is now DigitalTwin and model and structure a single Digital Twin and takes the following parameters: String digitalTwinId ShadowingFunction shadowingFunction The startLifeCycle has been removed from the DigitalTwin (previously WLDT Engine) and now DigitalTwinEngine should be used to start twins Once a new Digital Twin has been create it has to be added to the DigitalTwinEngine DigitalTwinEngine has dedicated method to start and stop twins such as: startAll() startDigitalTwin(\u0026lt;DIGITAL_TWIN_ID\u0026gt;); stopAll() digitalTwinEngine.stopDigitalTwin(\u0026lt;DIGITAL_TWIN_ID\u0026gt;); Digital Twin \u0026amp; Digital Twin Engine With the following code we now create a new Digital Twin Instance\n// Create the new Digital Twin with its Shadowing Function DigitalTwin digitalTwin = new DigitalTwin(digitalTwinId, new DemoShadowingFunction()); // Physical Adapter with Configuration digitalTwin.addPhysicalAdapter( new DemoPhysicalAdapter( String.format(\u0026#34;%s-%s\u0026#34;, digitalTwinId, \u0026#34;test-physical-adapter\u0026#34;), new DemoPhysicalAdapterConfiguration(), true)); // Digital Adapter with Configuration digitalTwin.addDigitalAdapter( new DemoDigitalAdapter( String.format(\u0026#34;%s-%s\u0026#34;, digitalTwinId, \u0026#34;test-digital-adapter\u0026#34;), new DemoDigitalAdapterConfiguration()) ); In the new version the DT cannot be directly run but it should be added to the DigitalTwinEngine in order to be executed through the WLDT Library\n// Create the Digital Twin Engine DigitalTwinEngine digitalTwinEngine = new DigitalTwinEngine(); // Add the Digital Twin to the Engine digitalTwinEngine.addDigitalTwin(digitalTwin); In order to start a DT from the Engine you can:\n// Directly start when you add it passing a second boolean value = true digitalTwinEngine.addDigitalTwin(digitalTwin. true); // Starting the single DT on the engine through its id digitalTwinEngine.startDigitalTwin(DIGITAL_TWIN_ID); // Start all the DTs registered on the engine digitalTwinEngine.startAll(); To stop a single twin or all the twin registered on the engine:\n// Stop a single DT on the engine through its id digitalTwinEngine.stopDigitalTwin(DIGITAL_TWIN_ID); // Stop all the DTs registered on the engine digitalTwinEngine.stopAll(); It is also possible to remove a DT from the Engine with a consequent stop if it is active and the deletion of its reference from the engine:\n// Remove a single DT on the engine through its id digitalTwinEngine.removeDigitalTwin(DIGITAL_TWIN_ID); // Remove all the DTs registered on the engine digitalTwinEngine.removeAll(); Digital Twin State DT State now has the reference timestamp representing the evaluation instant of the digital twin state, this timestamp is computed through the DigitalTwinStateManager and cannot manually set by the developer The information available on the DT State are: properties: List of Properties with their values (if available) actions: List of Actions that can be called on the DT events: List of Events that can be generated by the DT relationships: List of Relationships and their instances (if available) evaluationInstant: The timestamp representing the evaluation instant of the DT state Available main methods on that class instance are: Properties:\n- getProperty(String propertyKey): Retrieves if present the target DigitalTwinStateProperty by Key\n- containsProperty(String propertyKey): Checks if a target Property Key is already available in the current Digital Twin\u0026rsquo;s State\n- getPropertyList(): Loads the list of available Properties (described by the class DigitalTwinStateProperty) available on the Digital Twin\u0026rsquo;s State\n- createProperty(DigitalTwinStateProperty\u0026lt;?\u0026gt; dtStateProperty): Allows the creation of a new Property on the Digital Twin\u0026rsquo;s State through the class DigitalTwinStateProperty\n- readProperty(String propertyKey): Retrieves if present the target DigitalTwinStateProperty by Key\n- updateProperty(DigitalTwinStateProperty\u0026lt;?\u0026gt; dtStateProperty): Updates the target property using the DigitalTwinStateProperty and the associated Property Key field\n- deleteProperty(String propertyKey): Deletes the target property identified by the specified key Actions:\n- containsAction(String actionKey): Checks if a Digital Twin State Action with the specified key is correctly registered\n- getAction(String actionKey): Loads the target DigitalTwinStateAction by key\n- getActionList(): Gets the list of available Actions registered on the Digital Twin\u0026rsquo;s State\n- enableAction(DigitalTwinStateAction digitalTwinStateAction): Enables and registers the target Action described through an instance of the DigitalTwinStateAction class\n- updateAction(DigitalTwinStateAction digitalTwinStateAction): Update the already registered target Action described through an instance of the DigitalTwinStateAction class\n- disableAction(String actionKey): Disables and unregisters the target Action described through an instance of the DigitalTwinStateAction class Events:\n- containsEvent(String eventKey): Check if a Digital Twin State Event with the specified key is correctly registered\n- getEvent(String eventKey): Return the description of a registered Digital Twin State Event according to its Key\n- getEventList(): Return the list of existing and registered Digital Twin State Events\n- registerEvent(DigitalTwinStateEvent digitalTwinStateEvent): Register a new Digital Twin State Event\n- updateRegisteredEvent(DigitalTwinStateEvent digitalTwinStateEvent): Update the registration and signature of an existing Digital Twin State Event\n- unRegisterEvent(String eventKey): Un-register a Digital Twin State Event\n- notifyDigitalTwinStateEvent(DigitalTwinStateEventNotification\u0026lt;?\u0026gt; digitalTwinStateEventNotification): Method to notify the occurrence of the target Digital Twin State Event Relationships:\n- containsRelationship(String relationshipName): Checks if a Relationship Name is already available in the current Digital Twin\u0026rsquo;s State\n- createRelationship(DigitalTwinStateRelationship\u0026lt;?\u0026gt; relationship): Creates a new Relationships (described by the class DigitalTwinStateRelationship) in the Digital Twin\u0026rsquo;s State\n- addRelationshipInstance(String name, DigitalTwinStateRelationshipInstance\u0026lt;?\u0026gt; instance): Adds a new Relationship instance described through the class DigitalTwinStateRelationshipInstance and identified through its name\n- getRelationshipList(): Loads the list of existing relationships on the Digital Twin\u0026rsquo;s State through a list of DigitalTwinStateRelationship\n- getRelationship(String name): Gets a target Relationship identified through its name and described through the class DigitalTwinStateRelationship\n- deleteRelationship(String name): Deletes a target Relationship identified through its name\n- deleteRelationshipInstance(String relationshipName, String instanceKey): Deletes the target Relationship Instance using relationship name and instance Key Digital Twin State Manager The DigitalTwinStateManager is a Java class that serves as the default implementation of the IDigitalTwinStateManager interface within the White Label Digital Twin Java Framework (whitelabel-digitaltwin). This class allows developers to manage the state of a digital twin, including properties, actions, events, and relationships.\nFeatures State Management: Handles the creation, update, and deletion of properties, actions, events, and relationships associated with the digital twin state. Transaction Support: Allows developers to start, commit, or rollback transactions to manage changes to the digital twin state. Event Notification: Notifies listeners about updates to the digital twin state through the WLDT event bus. When the Shadowing Function has to compute the new DT State it can now work with the following method to handle DT State Transition: - Start the DT State Transaction: startStateTransaction() - DT State variation methods such as: - createProperty() - updateProperty()\n- updatePropertyValue() - deleteProperty() - enableAction() - updateAction() - disableAction() - registerEvent() - updateRegisteredEvent() - unRegisterEvent() - createRelationship() - addRelationshipInstance() - deleteRelationship() - deleteRelationshipInstance()\nAt the end the transaction can be committed using the method: commitStateTransaction()\nUsage To use the DigitalTwinStateManager within your digital twin implementation:\nInitialization: Create an instance of the DigitalTwinStateManager. DigitalTwinStateManager digitalTwinStateManager = new DigitalTwinStateManager(); State Transaction:\nStart a new transaction using startStateTransaction() to manage changes. Make changes to the digital twin state. Commit the transaction using commitStateTransaction() to apply the changes. digitalTwinStateManager.startStateTransaction(); // Make changes to properties, actions, events, or relationships // [...] digitalTwinStateManager.commitStateTransaction(); Event Notification:\nDT State Updates after a commit action are automatically notified to Digital Adapter by the Manager Once an event incoming from the physical or generated by the DT itself is handled by the Shadowing Function, the developer can use notifyDigitalTwinStateUpdate to notify Digital Adapter listening about events variations. // Notify a specific event notification digitalTwinStateManager.notifyDigitalTwinStateEvent(digitalTwinStateEventNotification); Property, Action, Event, Relationship Management:\nCreate, update, or delete properties, actions, events, or relationships as needed. // Begin Digital Twin State Transaction digitalTwinStateManager.startStateTransaction(); // Create a new property digitalTwinStateManager.createProperty(dtStateProperty); // Update an existing property digitalTwinStateManager.updateProperty(dtStateProperty); // Delete a property digitalTwinStateManager.deleteProperty(propertyKey);` // Commit DT State Update to apply all the changes and notify the Digital Adapters and other listeners about the variation digitalTwinStateManager.commitStateTransaction(); Exception Handling The class throws WldtDigitalTwinStateException to indicate errors related to digital twin state management. Proper exception handling is advised to manage potential errors during state transactions. Shadowing Function Changes Now that the DT State is managed through the DigitalTwinStateManager class all the changes and variation should be applied on the DT ShadowingFunction using the previously presented transaction management and the correct call of methods startStateTransaction() and commitStateTransaction().\nHere there is an example of the change with a simple and demo shadowing function on callback onDigitalTwinBound:\n@Override protected void onDigitalTwinBound(Map\u0026lt;String, PhysicalAssetDescription\u0026gt; adaptersPhysicalAssetDescriptionMap) { try{ // NEW -\u0026gt; Start DT State Change Transaction this.digitalTwinStateManager.startStateTransaction(); for(Map.Entry\u0026lt;String, PhysicalAssetDescription\u0026gt; entry : adaptersPhysicalAssetDescriptionMap.entrySet()){ String adapterId = entry.getKey(); PhysicalAssetDescription physicalAssetDescription = entry.getValue(); //In that simple case the Digital Twin shadow all the properties and actions available in the physical asset for(PhysicalAssetProperty\u0026lt;?\u0026gt; p : physicalAssetDescription.getProperties()) this.digitalTwinStateManager.createProperty(new DigitalTwinStateProperty\u0026lt;\u0026gt;(p.getKey(), p.getInitialValue())); for(PhysicalAssetAction a : physicalAssetDescription.getActions()) this.digitalTwinStateManager.enableAction(new DigitalTwinStateAction(a.getKey(), a.getType(), a.getContentType())); for(PhysicalAssetEvent e: physicalAssetDescription.getEvents()) this.digitalTwinStateManager.registerEvent(new DigitalTwinStateEvent(e.getKey(), physicalAssetEvent.getType())); } // NEW -\u0026gt; Commit DT State Change Transaction to apply the changes on the DT State and notify about the change this.digitalTwinStateManager.commitStateTransaction(); //Observer Target Physical Properties for(Map.Entry\u0026lt;String, PhysicalAssetDescription\u0026gt; entry : adaptersPhysicalAssetDescriptionMap.entrySet()){ [...] } //Observe all the target available Physical Asset Events for each Adapter for(Map.Entry\u0026lt;String, PhysicalAssetDescription\u0026gt; entry : adaptersPhysicalAssetDescriptionMap.entrySet()){ [...] } // Observer for Incoming Digital Actions observeDigitalActionEvents(); //Notify Shadowing Completed notifyShadowingSync(); }catch (Exception e){ e.printStackTrace(); } } The same change for example should be applied in the point of the code where the Shadowing Function receive a variation from the Physical world through a target adapter and the callback method onPhysicalAssetPropertyVariation(...)\n@Override protected void onPhysicalAssetPropertyVariation(PhysicalAssetPropertyWldtEvent\u0026lt;?\u0026gt; physicalPropertyEventMessage) { try { if(physicalPropertyEventMessage != null \u0026amp;\u0026amp; getPhysicalEventsFilter().contains(physicalPropertyEventMessage.getType())){ if(physicalPropertyEventMessage.getPhysicalPropertyId().equals(TestPhysicalAdapter.SWITCH_PROPERTY_KEY) \u0026amp;\u0026amp; physicalPropertyEventMessage.getBody() instanceof String){ [...] } else{ //Update Digital Twin State //NEW -\u0026gt; Start State Transaction this.digitalTwinStateManager.startStateTransaction(); // Update State Property Value this.digitalTwinStateManager.updateProperty( new DigitalTwinStateProperty\u0026lt;\u0026gt;( physicalPropertyEventMessage.getPhysicalPropertyId(), physicalPropertyEventMessage.getBody())); //NEW -\u0026gt; Commit State Transaction this.digitalTwinStateManager.commitStateTransaction(); } } else logger.error(\u0026#34;WRONG Physical Event Message Received !\u0026#34;); }catch (Exception e){ e.printStackTrace(); } } Digital Adapter The Digital Adapter base class has been significantly extended and improved with respect to the previous version. In this new Version notifications that are received by the Adapter from the the DT core belongs to the following categories:\nDigital Twin State Update through the method onStateUpdate(...) providing information about the new state of the Digital Twin, the previous state, and a list of changes that occurred between these two states. In the previous version each variation of a property, relationships, actions or events were notified. In the new version only a committed DT\u0026rsquo;State variation is notified to listeners. Event Notifications through the method onEventNotificationReceived(...) whenever there is a notification about an event related to the Digital Twin\u0026rsquo;s state coming from the physical world, generated by the twin and processed by the Shadowing Function. For example in the DT State we can have the declaration of the over-heating-alert structured and received in the DT State while the effective occurrence of the event and the associated notification is notified through this dedicated callback The onStateUpdate method is an abstract method that must be implemented by any class extending the DigitalAdapter class. This method is called whenever there is an update to the Digital Twin\u0026rsquo;s state. It provides information about the new state of the Digital Twin, the previous state, and a list of changes that occurred between these two states.\nHere is an explanation of the parameters:\nnewDigitalTwinState: This parameter represents the updated state of the Digital Twin. It is an instance of the DigitalTwinState class, which encapsulates the current state information.\npreviousDigitalTwinState: This parameter represents the state of the Digital Twin before the update. It is also an instance of the DigitalTwinState class.\ndigitalTwinStateChangeList: This parameter is an ArrayList containing DigitalTwinStateChange objects. Each DigitalTwinStateChange object encapsulates information about a specific change that occurred between the previous and new states. It includes details such as the property or aspect of the state that changed, the previous value, and the new value.\nThe DT State is automatically monitored by each Digital Adapter while for the Events potentially generated by the DT can be observed by each adapter using:\nobserveAllDigitalTwinEventsNotifications: Enable the observation of available Digital Twin State Events Notifications. unObserveAllDigitalTwinEventsNotifications: Cancel the observation of Digital Twin State Events Notifications observeDigitalTwinEventsNotifications: Enable the observation of the notification associated to a specific list of Digital Twin State events. With respect to event a notification contains the new associated value unObserveDigitalTwinEventsNotifications: Cancel the observation of a target list of properties observeDigitalTwinEventNotification: Enable the observation of the notification associated to a single Digital Twin State event. With respect to event a notification contains the new associated value unObserveDigitalTwinEventNotification: Cancel the observation of a single target event DigitalTwinStateChange Class DigitalTwinStateChange Class\nThe DigitalTwinStateChange class is a representation of a change that occurred in the state of a Digital Twin. It encapsulates information about the type of operation, the resource type, and the affected resource within the Digital Twin.\nEnums:\nOperation: Enumerates different types of operations that can be performed on a Digital Twin state. The possible operations are: OPERATION_UPDATE: Represents an update operation on a resource. OPERATION_UPDATE_VALUE: Represents an update operation specifically on the value of a resource. OPERATION_ADD: Represents an addition operation of a new resource. OPERATION_REMOVE: Represents a removal operation of an existing resource. ResourceType: Enumerates different types of resources within a Digital Twin. The possible resource types are: PROPERTY: Represents a property of the Digital Twin. PROPERTY_VALUE: Represents the value of a property within the Digital Twin. EVENT: Represents an event associated with the Digital Twin. ACTION: Represents an action that can be performed on the Digital Twin. RELATIONSHIP: Represents a relationship between different components of the Digital Twin. RELATIONSHIP_INSTANCE: Represents an instance of a relationship. Fields:\noperation: Indicates the type of operation performed on the Digital Twin state (e.g., update, add, remove). resourceType: Represents the type of resource affected by the change (e.g., property, event, relationship). resource: The specific resource that has undergone the change, represented by an instance of the DigitalTwinStateResource class. Available type of DigitalTwinStateResource are:\nDigitalTwinStateProperty\u0026lt;T\u0026gt;: This class define a generic property associated to the Digital Twin State. Each property is associated to a Key and a Value. Furthermore, it can also be associated to a type to identify its nature and data structure. By default, it is associated to the type of the Class (e.g., java.lang.String) but it can be directly changed by the developer to associate it to a specific ontology or data type. DigitalTwinStateEvent: This class define a generic event associated to the Digital Twin State. Events enable a mechanism for asynchronous messages to be sent by the digital twin (e.g., an overheating) . They are different from Properties that can change values according to the type of Digital Twin and may be associated also to telemetry patterns. Each event is associated to a Key and a Type used to identify its nature and data structure. By default, it is associated to the type of the Class (e.g., java.lang.String) but it can be directly changed by the developer to associate it to a specific ontology or data type. DigitalTwinStateAction: This class define a generic action associated to the Digital Twin State. Each action is by a key, an action type and a content type used to identify the expected input required by the action. The type of the can be directly changed by the developer to associate it to a specific ontology or data type. DigitalTwinStateRelationship\u0026lt;T\u0026gt;: Structures and describes a Relationship in the Digital Twins\u0026rsquo;s State. This is just the description of the relationships while the effective values/instances are described through the other class DigitalTwinStateRelationshipInstance DigitalTwinStateRelationshipInstance\u0026lt;T\u0026gt;: Structures and describes a Relationship Instance in the Digital Twins\u0026rsquo;s State. This is effective description of a relationship while its generic declaration is described through the class DigitalTwinStateRelationship. When there is a change in the DT State it is possibile to cast the received resource variation to the correct one. For example in the following code we detect and manage the variation on a Property Value:\n// Get information from the state change DigitalTwinStateChange.Operation operation = stateChange.getOperation(); DigitalTwinStateChange.ResourceType resourceType = stateChange.getResourceType(); DigitalTwinStateResource resource = stateChange.getResource(); // Search for property value variation if(resourceType.equals(DigitalTwinStateChange.ResourceType.PROPERTY_VALUE) \u0026amp;\u0026amp; operation.equals(DigitalTwinStateChange.Operation.OPERATION_UPDATE) \u0026amp;\u0026amp; resource instanceof DigitalTwinStateProperty){ DigitalTwinStateProperty\u0026lt;?\u0026gt; digitalTwinStateProperty = (DigitalTwinStateProperty\u0026lt;?\u0026gt;) resource; if(getConfiguration().getPropertyUpdateTopics().containsKey(digitalTwinStateProperty.getKey())){ //Handle property value variation } } Constructors:\nDigitalTwinStateChange(): An empty constructor that allows creating an instance of the class. DigitalTwinStateChange(Operation operation, ResourceType resourceType, DigitalTwinStateResource resource): Constructs a DigitalTwinStateChange object with specified operation, resource type, and resource. Throws a WldtDigitalTwinStateException if any of the parameters is missing or null. Methods:\nAccessor methods (getOperation(), getResourceType(), getResource()) to retrieve the values of the fields. Mutator methods (setOperation(), setResourceType(), setResource()) to update the values of the fields. Usage Examples Developers extending the DigitalAdapter class should implement the onStateUpdate method to define custom logic that needs to be executed whenever the state of the Digital Twin is updated. This could include tasks such as processing state changes, updating internal variables, triggering specific actions, or notifying other components about the state update.\nHere\u0026rsquo;s an example of how the method might be implemented in a concrete subclass of DigitalAdapter:\n@Override protected void onStateUpdate(DigitalTwinState newDigitalTwinState, DigitalTwinState previousDigitalTwinState, ArrayList\u0026lt;DigitalTwinStateChange\u0026gt; digitalTwinStateChangeList) { // In newDigitalTwinState we have the new DT State System.out.println(\u0026#34;New DT State is: \u0026#34; + newDigitalTwinState); // The previous DT State is available through the variable previousDigitalTwinState System.out.println(\u0026#34;Previous DT State is: \u0026#34; + previousDigitalTwinState); // We can also check each DT\u0026#39;s state change potentially differentiating the behaviour for each change if (digitalTwinStateChangeList != null \u0026amp;\u0026amp; !digitalTwinStateChangeList.isEmpty()) { // Iterate through each state change in the list for (DigitalTwinStateChange stateChange : digitalTwinStateChangeList) { // Get information from the state change DigitalTwinStateChange.Operation operation = stateChange.getOperation(); DigitalTwinStateChange.ResourceType resourceType = stateChange.getResourceType(); DigitalTwinStateResource resource = stateChange.getResource(); // Perform different actions based on the type of operation switch (operation) { case OPERATION_UPDATE: // Handle an update operation System.out.println(\u0026#34;Update operation on \u0026#34; + resourceType + \u0026#34;: \u0026#34; + resource); break; case OPERATION_UPDATE_VALUE: // Handle an update value operation System.out.println(\u0026#34;Update value operation on \u0026#34; + resourceType + \u0026#34;: \u0026#34; + resource); break; case OPERATION_ADD: // Handle an add operation System.out.println(\u0026#34;Add operation on \u0026#34; + resourceType + \u0026#34;: \u0026#34; + resource); break; case OPERATION_REMOVE: // Handle a remove operation System.out.println(\u0026#34;Remove operation on \u0026#34; + resourceType + \u0026#34;: \u0026#34; + resource); break; default: // Handle unknown operation (optional) System.out.println(\u0026#34;Unknown operation on \u0026#34; + resourceType + \u0026#34;: \u0026#34; + resource); break; } } } else { // No state changes System.out.println(\u0026#34;No state changes detected.\u0026#34;); } } In this example, the method iterates over the list of state changes, extracts information about each change, and performs custom actions based on the changes. Developers can adapt this method to suit the specific requirements of their Digital Twin application.\n","date":"February 9, 2024","id":12,"permalink":"/docs/change-logs/change-log-0.3.0/","summary":"Digital Adapters The following methods have been discontinued and removed from the DigitalAdapter class: onStateChangePropertyCreated onStateChangePropertyUpdated onStateChangePropertyDeleted onStatePropertyUpdated onStatePropertyDeleted onStateChangeActionEnabled onStateChangeActionUpdated onStateChangeActionDisabled onStateChangeEventRegistered onStateChangeEventRegistrationUpdated onStateChangeEventUnregistered onStateChangeRelationshipInstanceDeleted onStateChangeRelationshipDeleted onStateChangeRelationshipInstanceCreated onStateChangeRelationshipCreated onDigitalTwinStateEventNotificationReceived The Signature of the following methods have been changed: onDigitalTwinSync(IDigitalTwinState currentDigitalTwinState) -\u0026gt; onDigitalTwinSync(DigitalTwinState currentDigitalTwinState) onDigitalTwinUnSync(IDigitalTwinState currentDigitalTwinState) -\u0026gt; onDigitalTwinUnSync(DigitalTwinState currentDigitalTwinState) New methods that have been added are: onStateUpdate(DigitalTwinState newDigitalTwinState, DigitalTwinState previousDigitalTwinState, ArrayList\u0026lt;DigitalTwinStateChange\u0026gt; digitalTwinStateChangeList) onEventNotificationReceived(DigitalTwinStateEventNotification\u0026lt;?","tags":"","title":"Change Log 0.3.0"},{"content":"The HttpDigitalAdapter is a powerful component designed to facilitate the integration of Digital Twins into HTTP-based systems. It serves as a bridge between a Digital Twin and HTTP-based applications, allowing developers to easily expose and interact with Digital Twin data and functionalities over HTTP.\nKey Features:\nHTTP Integration: Seamlessly integrates Digital Twins into HTTP environments, enabling communication with web applications and services. Dynamic Configuration: Offers a flexible configuration mechanism through the HttpDigitalAdapterConfiguration, allowing developers to customize the adapter\u0026rsquo;s behavior based on specific requirements. State Monitoring: Monitors changes in the Digital Twin state and provides HTTP endpoints to query the state of the Digital Twin (properties, events, actions and relationships). Event Notifications: Allows developers to retrieve event notifications triggered by changes in the Digital Twin state. A complete example is provided in the test folder with a complete DT Creation in the TestMain class together with a demo DT with and emulated Physical Adapter and the HTTP Digital Adapter.\nWLDT-Core Version Compatibility The correct mapping and compatibility between versions is reported in the following table\nhttp-digital-adapter wldt-core 0.2.1 wldt-core 0.3.0 0.1.1 ❌ ✅ Installation To use HttpDigitalAdapter in your Java project, you can include it as a dependency using Maven or Gradle.\nMaven \u0026lt;dependency\u0026gt; \u0026lt;groupId\u0026gt;io.github.wldt\u0026lt;/groupId\u0026gt; \u0026lt;artifactId\u0026gt;http-digital-adapter\u0026lt;/artifactId\u0026gt; \u0026lt;version\u0026gt;0.1.1\u0026lt;/version\u0026gt; \u0026lt;/dependency\u0026gt; Gradle implementation \u0026#39;io.github.wldt:http-digital-adapter:0.1.1\u0026#39; Class Structure \u0026amp; Functionalities HttpDigitalAdapterConfiguration The HttpDigitalAdapterConfiguration is a crucial part of the HttpDigitalAdapter, providing the necessary settings to tailor the adapter\u0026rsquo;s behavior to meet specific needs.\nRepresents the configuration for an HTTP Digital Adapter, specifying the host, port, and filters for properties, actions, events, and relationships.\nThe filters are used to selectively include or exclude specific properties, actions, events, and relationships when interacting with the HTTP Digital Adapter. Filters are meant to be white list filters, if they are empty, it means that ALL fields are considered\nThis class provides methods to add filters for each type and getters to retrieve the configured values.\nKey functionalities and exposed capabilities:\nBasic Configuration Adapter ID: A unique identifier for the HttpDigitalAdapter instance. Host: The hostname or IP address on which the adapter will listen for incoming HTTP requests. Port: The port number on which the adapter will listen for incoming HTTP requests. Filters (Optional) addPropertyFilter(String propertyKey): Adds a single property key to the property filter. addPropertiesFilter(Collection\u0026lt;String\u0026gt; propertiesKey): Adds a collection of property keys to the property filter. addActionFilter(String actionKey): Adds a single action key to the action filter. addActionsFilter(Collection\u0026lt;String\u0026gt; actionsKey): Adds a collection of action keys to the action filter. addEventFilter(String eventKey): Adds a single event key to the event filter. addEventsFilter(Collection\u0026lt;String\u0026gt; eventsKey): Adds a collection of event keys to the event filter. addRelationshipFilter(String relationshipName): Adds a single relationship name to the relationship filter. addRelationshipsFilter(Collection\u0026lt;String\u0026gt; relationshipNames): Adds a collection of relationship names to the relationship filter. Configured Filter can be accessed using: getPropertyFilter() getActionFilter() getEventFilter() getRelationshipFilter() A basic example without any filter that accesses and uses the entire DT State is:\nHttpDigitalAdapterConfiguration config = new HttpDigitalAdapterConfiguration(\u0026#34;my-http-adapter\u0026#34;, \u0026#34;localhost\u0026#34;, 8080); An example of using filter to select specific field of interest can be structured ad follows:\nHttpDigitalAdapterConfiguration config = new HttpDigitalAdapterConfiguration(\u0026#34;my-http-adapter\u0026#34;, \u0026#34;localhost\u0026#34;, 8080); // Add property filter config.addPropertyFilter(\u0026#34;temperature\u0026#34;); config.addPropertiesFilter(Arrays.asList(\u0026#34;humidity\u0026#34;, \u0026#34;pressure\u0026#34;)); // Add action filter config.addActionFilter(\u0026#34;start\u0026#34;); config.addActionsFilter(Arrays.asList(\u0026#34;stop\u0026#34;, \u0026#34;reset\u0026#34;)); // Add event filter config.addEventFilter(\u0026#34;temperatureChange\u0026#34;); config.addEventsFilter(Collections.singletonList(\u0026#34;pressureChange\u0026#34;)); // Add relationship filter config.addRelationshipFilter(\u0026#34;connectedTo\u0026#34;); config.addRelationshipsFilter(Arrays.asList(\u0026#34;parentOf\u0026#34;, \u0026#34;siblingOf\u0026#34;)); // Retrieve and display filters List\u0026lt;String\u0026gt; propertyFilter = config.getPropertyFilter(); List\u0026lt;String\u0026gt; actionFilter = config.getActionFilter(); List\u0026lt;String\u0026gt; eventFilter = config.getEventFilter(); List\u0026lt;String\u0026gt; relationshipFilter = config.getRelationshipFilter(); System.out.println(\u0026#34;Property Filter: \u0026#34; + propertyFilter); System.out.println(\u0026#34;Action Filter: \u0026#34; + actionFilter); System.out.println(\u0026#34;Event Filter: \u0026#34; + eventFilter); System.out.println(\u0026#34;Relationship Filter: \u0026#34; + relationshipFilter); HttpDigitalAdapter The HttpDigitalAdapter itself is the core component responsible for handling HTTP requests and interacting with the underlying Digital Twin. It extends the capabilities of the base DigitalAdapter to specifically cater to HTTP-based scenarios.\nKey Functionalities:\nRESTful Endpoints: Provides RESTful endpoints for reading properties, invoking actions, querying events, and managing relationships. State Updates: Automatically reflects changes in the Digital Twin state to the HTTP endpoints, ensuring real-time information. Event Handling: Listens for Digital Twin events and provides events notifications to HTTP clients. Here\u0026rsquo;s a basic example illustrating how to use MqttDigitalAdapter:\nGetting Started: Create HttpDigitalAdapterConfiguration:\nHttpDigitalAdapterConfiguration config = new HttpDigitalAdapterConfiguration(\u0026#34;my-http-adapter\u0026#34;, \u0026#34;localhost\u0026#34;, 8080); Instantiate HttpDigitalAdapter:\nDigitalTwin digitalTwin = new DigitalTwin(\u0026#34;my-digital-twin\u0026#34;, new DefaultShadowingFunction()); HttpDigitalAdapter httpDigitalAdapter = new HttpDigitalAdapter(config, digitalTwin); // Add a Physical Adapter to the DT [...] Add HttpDigitalAdapter to DigitalTwin:\ndigitalTwin.addDigitalAdapter(httpDigitalAdapter); Start the Digital Twin Engine:\nDigitalTwinEngine digitalTwinEngine = new DigitalTwinEngine(); digitalTwinEngine.addDigitalTwin(digitalTwin); digitalTwinEngine.startAll(); HTTP RESTful API This section of the documentation provides detailed information about the RESTful API exposed by the WLDT - HTTP Digital Adapter. The API allows you to interact with the Digital Twin (DT) instance, retrieve its state, read properties, actions, event and relationships description, and trigger actions.\nAvailable endpoints with the associated methods are:\nGET /instance: Retrieves information about the Digital Twin instance. GET /state: Retrieves the current state of the Digital Twin. GET /state/changes: Retrieves the list of state changes in the Digital Twin. GET /state/previous: Retrieves the previous state of the Digital Twin. GET /state/properties: Retrieves the list of properties in the Digital Twin state. GET /properties/{propertyKey}: Retrieves the value of a specific property (e.g., /properties/color) from the Digital Twin state. GET /state/events: Retrieves the list of events in the Digital Twin state. GET /state/actions: Retrieves the list of actions in the Digital Twin state. POST /state/actions/{actionKey}: Triggers the specified action (e.g., /state/actions/switch_on) in the Digital Twin state. The raw body contains the action request payload. GET /state/relationships: Retrieves the list of relationships in the Digital Twin state. GET /state/relationships/{relationshipName}/instances: Retrieves the instances of the specified relationship (e.g., /state/relationships/insideIn/instances) in the Digital Twin state. Note: Replace {propertyKey}, {actionKey}, and {relationshipName} with the actual values you want to retrieve or trigger. Make sure to use the appropriate HTTP method (GET, POST) and include any required parameters or payload as described in each endpoint\u0026rsquo;s description. For more detailed information, refer to the Postman Collection for this API available in the folder api: http_adapter_api_postman.json`\n","date":"February 9, 2024","id":13,"permalink":"/docs/adapters/http-digital-adapter/","summary":"The HttpDigitalAdapter is a powerful component designed to facilitate the integration of Digital Twins into HTTP-based systems. It serves as a bridge between a Digital Twin and HTTP-based applications, allowing developers to easily expose and interact with Digital Twin data and functionalities over HTTP.","tags":"","title":"HTTP Digital Adapter"},{"content":" With respect to the element present in the real world, it is defined as a Physical Asset (PA) with the intention of referring to any entity that has a manifestation or relevance in the physical world and a well-defined lifespan.\nThe previous Figure schematically illustrates the main component of an abstract Digital Twin and clarifies its responsibility to be a bridge between the cyber and the physical world. The blueprint components (then mapped into the WLDT Library) are:\nPhysical Interface The entity in charge of both the initial digitalization o shadowing process and the perpetual responsibility to keep the DT and PA in synch during its life cycle. It can execute multiple Physical Asset Adapters to interact with the PA and detect and digitalize the physical event coming from the physical entity according to its nature and the supported protocols and data formats (e.g., through HTTP and JSON). Digital Interface The component complementary to the Physical Interface and in charge of handling DT\u0026rsquo;s internal variations and events towards external digital entities and consumers. It executes multiple and reusable Digital Adapters in charge of handling digital interactions and events and responsible for making the DT interoperable with external applications. DT\u0026rsquo;s Model The module defining the DT\u0026rsquo;s behaviour and its augmented functionalities. It supports the execution of different configurable and reusable modules and functionalities handling both physical and digial events according to the implemented behaviour. Furthermore, the Model is the component responsible to handle and keep updated the Digital Twin State as described in the following sections. The Digital Twin Model(M) allows capturing and representing the PA at an appropriate level of abstraction, i.e., avoiding irrelevant aspects for its purpose and modeling only domain-level information rather than technological ones. Finally, the link between the physical and digital copy is defined as shadowing. Specifically, the term defines the process that enables continuous and (almost) real-time updating of the internal state of the DT in relation to changes that occur in the PA.\nEach DT is thus equipped with an internal model, which defines how the PA is represented in the digital level. The DT\u0026rsquo;s representation denoted as Digital Twin State supported and defined through M is defined in terms of:\nProperties: represent the observable attributes of the corresponding PA as labeled data whose values can dynamically change over time, in accordance with the evolution of the PA\u0026rsquo;s state. Events: represent the domain-level events that can be observed in the PA. Relationships: represent the links that exist between the modeled PA and other physical assets of the organizations through links to their corresponding Digital Twins. Like properties, relationships can be observed, dynamically created, and change over time, but unlike properties, they are not properly part of the PA\u0026rsquo;s state but of its operational context (e.g., a DT of a robot within a production line). Actions: represent the actions that can be invoked on the PA through interaction with the DT or directly on the DT if they are not directly available on the PA (the DT is augmenting the physical capabilities). Once the model M is defined, the dynamic state of the DT (SDT) can be defined by through the combination of its properties, events, relationships and actions associated to the DT timestamp that represents the current time of synchronization between the physical and digital counterparts.\nThe Shadowing Process The shadowing process (also known as replication of digitalization) allows to keep the Digital Twin State synchronized with that of the corresponding physical resource according to what is defined by the model M. Specifically, each relevant update of the PA state (SPA) is translated into a sequence of 3 main steps:\neach relevant change in physical asset state is modeled by a physical_event (e_pa); the event is propagated to the DT; given the new physical_event, the DT\u0026rsquo;s is updated through the application of a shadowing function, which depends on the model M The shadowing process allows also the DT to reflect and invoke possible actions of the PA. The DT receives an action request (denoted as digital_action) on its digital interface, applies the shadowing function to validate it and then propagates the request through its physical interface. An important aspect to emphasize is that the request for a digital_action does not directly change the state of the DT since any changes can only occur as a result of the shadowing function from the PA to the DT, as described earlier.\n","date":"February 9, 2024","id":14,"permalink":"/docs/introduction/dt-model/","summary":"With respect to the element present in the real world, it is defined as a Physical Asset (PA) with the intention of referring to any entity that has a manifestation or relevance in the physical world and a well-defined lifespan.","tags":"","title":"DT Model"},{"content":" The modeling of the concept of DT includes also the definition and characterization of its life cycle. Based on the scientific literature, we model (and then map into the library) a life cycle with 5 states through which the DT goes from when it is executed to when it is stopped. The previous Figure shows a graphical representation of the life cycle with the following steps:\nOperating \u0026amp; Not Bound: this is the state in which the DT is located following the initialization phase, indicating that all internal modules of the DT are active but there is no association yet with the corresponding PA. Bound: this is the state in which the DT transitions following the correct execution of the binding procedure. The binding procedure allows to connect the two parts and enables bidirectional flow of events. Shadowed: this is the state reached by the DT when the shadowing process begins and its state is correctly synchronized with that of the PA. Out of Sync: this is the state that determines the presence of errors in the shadowing process. When in this state, the DT is not able to handle either state alignment events or those generated by the application layer. Done: this is the state that the DT reaches when the shadowing process is stopped, but the DT continues to be active to handle requests coming from external applications. From Unbound to Bound Taking into account the target reference Life Cycle the first point to address is how we can move from an UnBound state to a Bound condition with respect to the relationship with the Physical Layer.\nThe previous Figure illustrates a simple scenario where a Physical Asset uses two protocols (P1 and P2) to communicate and it is connected to the Digital Twin through a DT\u0026rsquo;s Physical Interface enabled with two dedicated Adapters for protocol P1 and P2. In order to move from the Unbound to Bound state the DT should be aware of the description of the target asset with respect to the two protocols. For example through P1 the asset exposes telemetry data (e.g., light bulb status and energy consumption) while on P2 allows incoming action requests (e.g., turn on/off the light). The Digital Twin can start the shadowing process only when it is bound and has a description of the properties and capabilities of the associated physical counterpart. The schematic procedure is illustrated in the following Figure:\nInvolved steps are:\nThe Adapter P1 communicates with the PA through Protocol 1 and provides a Physical Asset Description from its perspective The Adapter P2 communicates with the PA through Protocol 2 and provides a Physical Asset Description from its perspective Only when all Physical Adapters have been correctly bound (it may require time) to the Physical Asset and the associated Physical Asset Descriptions have been generated, the DT can move from UnBound to Bound Main core aspects associated to the concept of Physical Asset Description (PAD) are the following:\nIt is used to describe the list of properties, actions and relationships of a Physical Asset Each Physical Adapter generates a dedicated PAD associated to its perspective on the Physical Assets and its capabilities to read data and execute actions It is a responsibility of the DT to handle multiple descriptions in order to build the digital replica It will be used by the DT to handle the shadowing process and keep the digital replica synchronized with the physical counterpart From Bound to Shadowed Following the same approach described in the previous step we need to define a procedure to allow the DT to move from a Bound state to a Shadowed condition where the twin identified the interesting capabilities of the Physical Asset that has to be digitalized and according to the received Physical Asset Descriptions start the shadowing procedure to be synchronized with the physical world.\nAs schematically illustrated in the previous Figure, involved steps are:\nThe Model defines which properties should be monitored on the Physical Asset and start observing them through the target adapters Involved Physical Adapters communicate with the Physical Asset, receive data and generate Events (ePA) to notify about physical property changes Received ePA will be used by the Digital Twin Model in order to run the Shadowing function and compute the new DT State The DT can move from the Bound to Shadowed phase until it is able to maintain a proper synchronization with the physical asset over time through its shadowing process and the generation and maintenance of the DT\u0026rsquo;s State The Digital Twin State is structured and characterized by the following elements:\nA list of properties A list of actions A list of relationships Listed elements can be directly associated to the corresponding element of the Physical Asset or generated by DT Model combining multiple physical properties, actions or relationships at the same time. The Digital Twin State can be managed through the Shadowing Function and exposes a set of methods for its manipulated. When there is a change in the DT State an event (eDT) will be generated\nThe manipulation of DT\u0026rsquo;s State generates a set of DT\u0026rsquo;s events (eDT) associated to each specific variation and evolution of the twin during its life cyle. These events are used by the Digital Interface and in particular by its Digital Adapters to expose the DT\u0026rsquo;s State, its properties and capabilities to the external digital world. At the same time, eDT can be used by Digital Adapters to trigger action on the DT and consequently to propagate (if acceptable and/or needed) the incoming request to the physical assets bound with the target DT. Supported events are illustrated in the following schema.\n","date":"February 9, 2024","id":15,"permalink":"/docs/introduction/dt-life-cycle/","summary":"The modeling of the concept of DT includes also the definition and characterization of its life cycle. Based on the scientific literature, we model (and then map into the library) a life cycle with 5 states through which the DT goes from when it is executed to when it is stopped.","tags":"","title":"DT Life Cycle"},{"content":"","date":"February 9, 2024","id":16,"permalink":"/docs/adapters/","summary":"","tags":"","title":"Adapters"},{"content":"","date":"February 9, 2024","id":17,"permalink":"/docs/guides/","summary":"","tags":"","title":"Getting Started"},{"content":"The WLDT framework intends to maximize modularity, re-usability and flexibility in order to effectively mirror physical smart objects in their digital counterparts. The proposed library focuses on the simplification of twins design and development aiming to provide a set of core features and functionalities for the widespread adoption of Internet of Things DTs applications.\nA WLDT instance is a general purpose software entity implementing all the features and functionalities of a Digital Twin running in cloud or on the edge. It has the peculiar characteristic to be generic and ``attachable\u0026rsquo;\u0026rsquo; to any physical thing in order to impersonate and maintain its digital replica and extend the provided functionalities for example through the support of additional protocols or a specific translation or normalization for data and formats.\nHereafter, the requirements that led the design and development of the WLDT framework are:\ni) Simplicity - with WLDT developers must have the possibility to easily create a new instance by using existing modules or customizing the behavior according the need of their application scenario; ii) Extensibility - while WLDT must be as simple and light as possible, the API should be also easily extendible in order to let programmers to personalize the configuration and/or to add new features loading and executing multiple modules at the same times; iii) Portability \u0026amp; Micorservice Readiness - a digital twin implemented through WLDT must be able to run on any platform without changes and customization. Our goal is to have a simple and light core engine with a strategic set of IoT-oriented features allowing the developer to easily create DT applications modeled as independent software agents and packed as microservices. In the following Figure, the main components that make up the architecture of WLDT are represented, and thus through which the individual Digital Twin is implemented. Specifically, from the image it is possible to identify the three levels on which the architecture is developed: the one related to the core of the library, the one that models the DT, and finally, that of the adapters.\nEach of this core components has the following main characteristics:\nMetrics Manager: Provides the functionalities for managing and tracking various metrics within DT instances combining both internal and custom metrics through a flexible and extensible approach. Logger: Is designed to facilitate efficient and customizable logging within implemented and deployed DTs with configurable log levels and versatile output options. Utils \u0026amp; Commons: Hold a collection of utility classes and common functionalities that can be readily employed across DT implementations ranging from handling common data structures to providing helpful tools for string manipulation. Event Communication Bus: Represents the internal Event Bus, designed to support communication between the different components of the DT\u0026rsquo;s instance. It allows defining customized events to model both physical and digital input and outputs. Each WLDT\u0026rsquo;s component can publish on the shared Event Bus and define an Event Filter to specify which types of events it is interested in managing, associating a specific callback to each one to process the different messages. Digital Twin Engine: Defines the multi-thread engine of the library allowing the execution and monitoring of multiple DTs (and their core components) simultaneously. Therefore, it is also responsible for orchestrating the different internal modules of the architecture while keeping track of each one, and it can be considered the core of the platform itself allowing the execution and control of the deployed DTs. Currently, it supports the execution of twins on the same Java process, however the same engine abstraction might be used to extend the framework to support distributed execution for example through different processes or microservices. Digital Twin: Models a modular DT structure built through the combination of core functionalities together with physical and digital adapter capabilities. This Layer includes the Digital Twin State responsible to structure the state of the DT by defining the list of properties, events, and actions. The different instances included in the lists can correspond directly to elements of the physical asset or can derive from their combination, in any case, it is the Shadowing Function (SF) that defines the mapping, following the model defined by the designer. This component also exposes a set of methods to allow SF manipulation. Every time the Digital Twin State is modified, the latter generates the corresponding DT\u0026rsquo;s event to notify all the components about the variation. Shadowing Function: It is the library component responsible for defining the behavior of the Digital Twin by interacting with the Digital Twin State. Specifically, it implements the shadowing process that allows keeping the DT synchronized with its physical entity. This component is based on a specific implementation of a WLDT Worker called Model Engine, in order to be executed by the WLDT Engine. The Shadowing Model Function is the fundamental component that must be extended by the DT designer to concretize its model. The shadowing function observes the life cycle of the Digital Twin to be notified of the different state changes. For example, it is informed when the DT enters the Bound state, i.e. when its Physical Adapters have completed the binding procedure with the physical asset. This component also allows the designer to define the behavior of the DT in case a property is modified, an event is triggered, or an action is invoked. Physical Adapter: It defines the essential functionalities that the individual extensions, related to specific protocols, must implement. As provided by the DT definition, a DT can be equipped with multiple Physical Adapters in order to manage communication with the corresponding physical entity. Each will produce a Physical Asset Description (PAD), i.e., a description of the properties, events, actions, and relationships that the physical asset exposes through the specific protocol. The DT transitions from the Unbound to the Bound state when all its Physical Adapters have produced their respective PADs. The Shadowing Function, following the DT model, selects the components of the various PADs that it is interested in managing. Digital Adapter: It provides the set of callbacks that each specific implementation can use to be notified of changes in the DT state. Symmetrically to what happens with Physical Adapters, a Digital Twin can define multiple Digital Adapters to expose its state and functionality through different protocols. Therefore, to create a Digital Twin using WLDT, it is necessary to define and instantiate a DT with its Shadowing Function and at least one Physical Adapter and one Digital Adapter, in order to enable connection with the physical entity and allow the DT to be used by external applications. Once the 3 components are defined, it is possible to instantiate the WLDT Engine and, subsequently, start the lifecycle of the DT. In the following sections we will go through the fundamental steps to start working with the library and creating all the basic modules to design, develop and execute our first Java Digital Twin.\n","date":"February 9, 2024","id":18,"permalink":"/docs/introduction/library-structure-basic-concepts/","summary":"The WLDT framework intends to maximize modularity, re-usability and flexibility in order to effectively mirror physical smart objects in their digital counterparts.","tags":"","title":"Library Structure \u0026 Basic Concepts"},{"content":"","date":"September 7, 2023","id":19,"permalink":"/docs/","summary":"","tags":"","title":"Docs"},{"content":" What is a digital Twin? A Digital Twin (DT) is a comprehensive software representation of any individual Physical Asset (PA) in the real world.\nIt includes the properties, conditions, relationships, and behavior(s) of the real-life object through models and data.\nA Digital Twin is a set of realistic models that can digitalize an object’s behavior in the deployed environment and has the responsibility to represent and reflect its physical counterpart over time maintaining its digital replica across the object’s entire lifecycle.\nWhat can WLDT do for me? The White Label Digital Twin (WLDT) library aims to support the design, development, and deployment of Digital Twins within the Internet of Things (IoT) ecosystems.\nThe library has been designed following the latest DT definitions coming from both Industrial and Scientific domains and identifying DTs as active, flexible and scalable software components.\n","date":"October 6, 2023","id":20,"permalink":"/","summary":"What is a digital Twin? A Digital Twin (DT) is a comprehensive software representation of any individual Physical Asset (PA) in the real world.","tags":"","title":"White Label Digital Twins"},{"content":"","date":"September 7, 2023","id":21,"permalink":"/privacy/","summary":"","tags":"","title":"Privacy Policy"},{"content":"","date":"January 1, 0001","id":22,"permalink":"/categories/","summary":"","tags":"","title":"Categories"},{"content":"","date":"January 1, 0001","id":23,"permalink":"/contributors/","summary":"","tags":"","title":"Contributors"},{"content":"","date":"January 1, 0001","id":24,"permalink":"/tags/","summary":"","tags":"","title":"Tags"}]
\ No newline at end of file
diff --git a/sitemap.xml b/sitemap.xml
index 08a9a2c..baa8931 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -1 +1 @@
-<?xml version="1.0" encoding="utf-8" standalone="yes"?><sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"><sitemap><loc>https://wldt.github.io/en/sitemap.xml</loc><lastmod>2024-02-09T09:54:12+01:00</lastmod></sitemap></sitemapindex>
\ No newline at end of file
+<?xml version="1.0" encoding="utf-8" standalone="yes"?><sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"><sitemap><loc>https://wldt.github.io/en/sitemap.xml</loc><lastmod>2024-02-09T13:02:54+01:00</lastmod></sitemap></sitemapindex>
\ No newline at end of file
diff --git a/tags/index.html b/tags/index.html
index 7ab13dc..069670f 100644
--- a/tags/index.html
+++ b/tags/index.html
@@ -1,5 +1,5 @@
 <!doctype html><html lang=en data-bs-theme=auto><head><meta charset=utf-8><meta http-equiv=x-ua-compatible content="ie=edge"><meta name=viewport content="width=device-width,initial-scale=1"><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-regular.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-500.woff2 type=font/woff2 crossorigin><link rel=preload as=font href=https://wldt.github.io/fonts/vendor/jost/jost-v4-latin-700.woff2 type=font/woff2 crossorigin><script src=https://wldt.github.io/js/color-mode.86a91f050a481d0a3f0c72ac26543cb6228c770875981c58dcbc008fd3f875c8.js integrity="sha256-hqkfBQpIHQo/DHKsJlQ8tiKMdwh1mBxY3LwAj9P4dcg="></script>
-<link rel=stylesheet href=https://wldt.github.io/main.5d6e5440c13f1c45183e82bbb906165564d1edfd71498c4a2c38775086796022bfab9cfb137199a537d8e42c2fb6ce2ab74b69461aed15b7389bd0e12ec63b19.css integrity="sha512-XW5UQME/HEUYPoK7uQYWVWTR7f1xSYxKLDh3UIZ5YCK/q5z7E3GZpTfY5Cwvts4qt0tpRhrtFbc4m9DhLsY7GQ==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>Tags | WLDT</title><meta property="canonical" content="https://wldt.github.io/tags/"><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/tags/"><meta property="og:title" content="Tags"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:section" content="tags"><meta name=twitter:card content="summary"><meta name=twitter:title content="Tags"><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","name":"Tags","position":2}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="list taxonomy tags" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
+<link rel=stylesheet href=https://wldt.github.io/main.5fb433a44687c98f7ae7b3d0137c762777049ba27235e1f08c279c03c8533a7a9a1e3b0ef5b125a31b6bb63a362cdcbc39c3706ed41ad7f1a620b9281013866c.css integrity="sha512-X7QzpEaHyY9657PQE3x2J3cEm6JyNeHwjCecA8hTOnqaHjsO9bEloxtrtjo2LNy8OcNwbtQa1/GmILkoEBOGbA==" crossorigin=anonymous><noscript><style>img.lazyload{display:none}</style></noscript><title>Tags | WLDT</title><meta property="canonical" content="https://wldt.github.io/tags/"><meta property="robots" content="index, follow"><meta property="og:url" content="https://wldt.github.io/tags/"><meta property="og:title" content="Tags"><meta property="og:locale" content="en"><meta property="og:site_name" content="WLDT"><meta property="og:type" content="website"><meta property="og:section" content="tags"><meta name=twitter:card content="summary"><meta name=twitter:title content="Tags"><script type=application/ld+json>{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://wldt.github.io/","name":"White Label Digital Twins","position":1},{"@type":"ListItem","name":"Tags","position":2}]}</script><meta name=theme-color content><link rel=icon href=https://wldt.github.io/favicon.ico sizes=any><link rel=icon type=image/svg+xml href=https://wldt.github.io/favicon.svg><link rel=apple-touch-icon sizes=180x180 href=https://wldt.github.io/apple-touch-icon.png><link rel=icon type=image/png sizes=32x32 href=https://wldt.github.io/favicon-32x32.png><link rel=icon type=image/png sizes=16x16 href=https://wldt.github.io/favicon-16x16.png><link rel=manifest crossorigin=use-credentials href=https://wldt.github.io/site.webmanifest></head><body class="list taxonomy tags" data-bs-spy=scroll data-bs-target=#toc data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll=true tabindex=0><div class=sticky-top><header class="navbar navbar-expand-lg"><div class=container-lg><a class="navbar-brand me-auto me-lg-3" href=https://wldt.github.io/>WLDT</a>
 <button type=button id=searchToggleMobile class="btn btn-link nav-link mx-2 d-lg-none" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
 <button class="btn btn-link nav-link mx-2 order-3 d-lg-none" type=button data-bs-toggle=offcanvas data-bs-target=#offcanvasNavMain aria-controls=offcanvasNavMain aria-label="Open main navigation menu"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-menu" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><line x1="4" y1="8" x2="20" y2="8"/><line x1="4" y1="16" x2="20" y2="16"/></svg></button><div class="offcanvas offcanvas-end h-auto" tabindex=-1 id=offcanvasNavMain aria-labelledby=offcanvasNavMainLabel><div class=offcanvas-header><h5 class=offcanvas-title id=offcanvasNavMainLabel>WLDT</h5><button type=button class="btn btn-link nav-link p-0" data-bs-dismiss=offcanvas aria-label=Close><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-x" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6 6 18"/><path d="M6 6l12 12"/></svg></button></div><div class="offcanvas-body d-flex flex-column flex-lg-row justify-content-between"><ul class="navbar-nav flex-grow-1"><li class=nav-item><a class=nav-link href=https://wldt.github.io/docs/guides/example-guide/>Documentation</a></li><li class=nav-item><a class=nav-link href=https://wldt.github.io/blog/>Blog</a></li></ul><button type=button id=searchToggleDesktop class="btn btn-link nav-link p-2 d-none d-lg-block" aria-label="Search website"><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-search" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><circle cx="10" cy="10" r="7"/><line x1="21" y1="21" x2="15" y2="15"/></svg></button>
 <button id=buttonColorMode class="btn btn-link mx-auto nav-link p-0 ms-lg-2 me-lg-1" type=button aria-label="Toggle theme"><svg data-bs-theme-value="dark" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-moon" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 3c.132.0.263.0.393.0a7.5 7.5.0 007.92 12.446A9 9 0 1112 2.992z"/></svg><svg data-bs-theme-value="light" xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-sun" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 12m-4 0a4 4 0 108 0 4 4 0 10-8 0m-5 0h1m8-9v1m8 8h1m-9 8v1M5.6 5.6l.7.7m12.1-.7-.7.7m0 11.4.7.7m-12.1-.7-.7.7"/></svg></button><ul id=socialMenu class="nav mx-auto flex-row order-lg-4"><li class=nav-item><a class="nav-link social-link" href=https://github.com/wldt><svg xmlns="http://www.w3.org/2000/svg" class="icon icon-tabler icon-tabler-brand-github" width="24" height="24" viewBox="0 0 24 24" stroke-width="2" stroke="currentcolor" fill="none" stroke-linecap="round" stroke-linejoin="round"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 19c-4.3 1.4-4.3-2.5-6-3m12 5v-3.5c0-1 .1-1.4-.5-2 2.8-.3 5.5-1.4 5.5-6a4.6 4.6.0 00-1.3-3.2 4.2 4.2.0 00-.1-3.2s-1.1-.3-3.5 1.3a12.3 12.3.0 00-6.2.0C6.5 2.8 5.4 3.1 5.4 3.1a4.2 4.2.0 00-.1 3.2A4.6 4.6.0 004 9.5c0 4.6 2.7 5.7 5.5 6-.6.6-.6 1.2-.5 2V21"/></svg><small class="ms-2 visually-hidden">GitHub</small></a></li></ul></div></div></div></header></div><div class=modal id=searchModal tabindex=-1 aria-labelledby=searchModalLabel aria-hidden=true><div class="modal-dialog modal-dialog-scrollable modal-fullscreen-md-down"><div class=modal-content><div class=modal-header><h1 class="modal-title fs-5 visually-hidden" id=searchModalLabel>Search</h1><button type=button class="btn-close visually-hidden" data-bs-dismiss=modal aria-label=Close></button><div class="search-input flex-grow-1 d-none"><form id=search-form class=search-form action=# method=post accept-charset=utf-8 role=search><label for=query class=visually-hidden>Search</label><div class=d-flex><input type=search id=query name=query class="search-text form-control form-control-lg" placeholder=Search aria-label=Search maxlength=128 autocomplete=off>