User Tools

Site Tools


transsecs_host:how_to_build_and_use_digital_twin

TransSECS Host: How to Build and Use the Digital Twin

What Is the Digital Twin in TransSECS?

In TransSECS, a Digital Twin is a snapshot of the tool’s model as captured during the project build. It provides a read-only, simulation-ready copy of the tool interface, separate from any host-side modifications.

The DT (Digital Twin) becomes a tool simulator that you can use to test your host project, as you build and test the host you are making.

What Exactly Is Saved as the Digital Twin?

When a project is built, TransSECS automatically creates a folder under the project named: <ProjectName>DigitalTwin

This folder contains copies of key project files, but those files reflect the tool model — not the host-side logic. Although the structure may resemble the main project, the content is frozen at build time and used strictly for simulation and validation — not for active host logic.

Why It Looks Like a Project Copy

The Digital Twin folder contains familiar .xml and config files. However:

  • It is a mirror of the tool-side configuration
  • It does not reflect host-side JavaScript, triggers, or logic
  • It is not modified by later project updates — making it ideal for regression testing

Think of it as a preserved “Tool View” snapshot — perfect for comparing against evolving host implementations.

Where Is the Digital Twin Stored?

The Digital Twin folder is created automatically under your project directory at build time. It remains intact even if you later:

  • Delete CEIDs or reports
  • Modify variable mappings
  • Adjust host scripts

This allows you to roll back or validate changes against the original tool definitions.

Why Use the Digital Twin?

The Digital Twin enables you to:

  • Simulate tool behavior without a live connection
  • Reproduce mismatches between tool and host CEIDs/SVIDs
  • Test robustness against unknown or unexpected events
  • Compare changes across project versions
  • Debug and regression test with confidence

Example of Use Case Workflow

  1. Build the project with the live tool or a tool file
  2. TransSECS automatically saves the Digital Twin
  3. Modify the host project — e.g., delete certain CEIDs
  4. Test using the preserved tool model to simulate missing or extra events
  5. Analyze the host’s behavior and ensure it gracefully handles mismatches

Summary

The TransSECS Digital Twin is a powerful and convenient feature that:

  • Captures the tool’s interface model at build time
  • Preserves the original CEIDs, VIDs, reports, and metadata
  • Enables offline simulation, testing, and validation
  • Supports version control, comparison, and error scenario emulation

No setup is required — the Digital Twin is created automatically. For engineers developing and refining SECS/GEM host logic, it is an essential tool for building reliable, robust systems.

transsecs_host/how_to_build_and_use_digital_twin.txt · Last modified: by wikiadmin

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki