# aws-solutions-library-samples/guidance-for-industrial-digital-twin-on-aws architecture

> Architecture diagram of the GitHub repository aws-solutions-library-samples/guidance-for-industrial-digital-twin-on-aws, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aws-solutions-library-samples/guidance-for-industrial-digital-twin-on-aws
- Repository: https://github.com/aws-solutions-library-samples/guidance-for-industrial-digital-twin-on-aws

## Overview

##### Project Type and Purpose
- This is a full-stack industrial monitoring solution that leverages AWS IoT TwinMaker and AWS IoT SiteWise to create a digital twin of a brewery production environment.
- Its purpose is to simulate and monitor plant operations by integrating real-time telemetry data from the Brewery SiteWise Simulator with 3D models and scenes. This enables plant managers to quickly assess performance metrics (such as OEE) via a Grafana dashboard.

##### Key Components Identified Through the File Structure and README
- CloudFormation Templates (cf folder): These JSON templates deploy the key AWS resources including:
- IoT TwinMaker Workspace (BreweryWorkspace.json)
- Grafana Dashboard Server (both automated and manual versions provided)
- Simulation Components:
- The Brewery SiteWise Simulator (not directly in the file tree, but referenced in the README)
- Scripts and provisioning folders that include sets of YAML files and other configuration artifacts (provisioning/alerting, provisioning/datasources)
- Visualization:
- Grafana dashboards (dashboards folder) and scenes (scenes folder) for displaying KPIs and OEE metrics.
- 3D Models and Scenes:
- 3dmodels folder contains the CAD-based models (GLB and GLTF files) for the digital twin representation.
- Scenes folder contains JSON files that define the TwinMaker scenes integrating these 3D models.
- Supporting Artifacts:

##### Architectural Relationships and Data Flow
- Data Generation and Simulation:
- The Brewery SiteWise Simulator produces telemetry data (sensor readings, state changes, alarms); this is sent to AWS IoT SiteWise.
- Data Ingestion and Synchronization:
- AWS IoT SiteWise aggregates the operational data and synchronizes asset models with the IoT TwinMaker Workspace.
- CloudFormation stacks are used to create the IoT TwinMaker Workspace that links to SiteWise assets.
- Visualization and Monitoring:
- IoT TwinMaker uses the 3D models and scene configurations (from the “3dmodels” and “scenes” folders) to visually represent the plant.
- The Grafana Dashboard Server (provisioned via CF templates) reads data—either directly from SiteWise or via synced TwinMaker workspaces—to display dashboards and alerts.
- Deployment Automation and Configuration:
- Scripts (in the “scripts” folder) facilitate the manual installation, migration, and update of credentials as needed.
- Configuration files (in “provisioning” and “cf”) ensure proper deployment and orchestration of AWS resources.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Data Ingestion & Simulation Layer
    subgraph "Data Ingestion & Simulation Layer"
        Simulator["Brewery SiteWise Simulator"]:::simulator
        SiteWise["AWS IoT SiteWise"]:::aws
    end

    %% Digital Twin Management Layer
    subgraph "Digital Twin Management Layer"
        TwinMaker["IoT TwinMaker Workspace"]:::aws
        Models["3D Models"]:::twin
        Scenes["TwinMaker Scenes"]:::twin
    end

    %% Visualization & Monitoring Layer
    subgraph "Visualization & Monitoring Layer"
        Grafana["Grafana Dashboard Server"]:::grafana
        Dashboards["Grafana Dashboards"]:::dashboard
    end

    %% Deployment & Operation Layer
    subgraph "Deployment & Operation Layer"
        CloudFormation["CloudFormation Templates"]:::deployment
        Scripts["Deployment Scripts"]:::deployment
        Provisioning["Provisioning Configurations"]:::deployment
        Mapping["Asset Mapping Files"]:::deployment
    end

    %% Data Flow Connections
    Simulator -->|"TelemetryIngestion"| SiteWise
    SiteWise -->|"DataSynchronization"| TwinMaker
    TwinMaker -->|"SceneRendering"| Models
    TwinMaker -->|"SceneRendering"| Scenes
    TwinMaker -->|"DataFeed"| Grafana
    SiteWise -->|"DirectDataFeed"| Grafana
    Grafana -->|"DisplaysDashboards"| Dashboards

    %% Deployment Relationships
    CloudFormation -->|"Deploys"| TwinMaker
    CloudFormation -->|"Deploys"| Grafana
    CloudFormation -->|"Deploys"| SiteWise
    Scripts -->|"Executes"| CloudFormation
    Provisioning -->|"Configures"| CloudFormation
    Mapping -->|"MapsAssets"| TwinMaker

    %% Click Events
    click TwinMaker "https://github.com/aws-solutions-library-samples/guidance-for-industrial-digital-twin-on-aws/blob/main/cf/BreweryWorkspace.json"
    click Grafana "https://github.com/aws-solutions-library-samples/guidance-for-industrial-digital-twin-on-aws/blob/main/cf/GrafanaDashboardServer.json"
    click CloudFormation "https://github.com/aws-solutions-library-samples/guidance-for-industrial-digital-twin-on-aws/tree/main/cf/"
    click Models "https://github.com/aws-solutions-library-samples/guidance-for-industrial-digital-twin-on-aws/tree/main/3dmodels/"
    click Scenes "https://github.com/aws-solutions-library-samples/guidance-for-industrial-digital-twin-on-aws/tree/main/scenes/"
    click Dashboards "https://github.com/aws-solutions-library-samples/guidance-for-industrial-digital-twin-on-aws/tree/main/dashboards/"
    click Provisioning "https://github.com/aws-solutions-library-samples/guidance-for-industrial-digital-twin-on-aws/tree/main/provisioning/"
    click Scripts "https://github.com/aws-solutions-library-samples/guidance-for-industrial-digital-twin-on-aws/tree/main/scripts/"
    click Mapping "https://github.com/aws-solutions-library-samples/guidance-for-industrial-digital-twin-on-aws/blob/main/mapping/original_property_ids.csv"

    %% Styles
    classDef aws fill:#FFA500,stroke:#333,stroke-width:2px;
    classDef simulator fill:#FFCC00,stroke:#333,stroke-width:2px;
    classDef twin fill:#ADFF2F,stroke:#333,stroke-width:2px;
    classDef grafana fill:#00BFFF,stroke:#333,stroke-width:2px;
    classDef dashboard fill:#7FFFD4,stroke:#333,stroke-width:2px;
    classDef deployment fill:#DDA0DD,stroke:#333,stroke-width:2px;
```
