Welcome
The ScaleOut Digital Twin Builder™ lets developers build digital twin models for real-time stateful stream-processing or simulation purposes. Digital twin models are deployed either on the ScaleOut Digital Twin Cloud Service or on-premises using ScaleOut StreamServer®. A digital twin model consists of a state object, message, and a message processor classes. Both the digital twin state object and message classes are defined using base classes provided by the API library. Additional APIs enable deployment of digital twin models to ScaleOut StreamServer for message processing as well as deployment and management of an Azure IoT Hub Connector.
Instances of state objects are serialized using JSON and stored within ScaleOut StateServer's in-memory data grid for fast access. Incoming messages from data sources are delivered to instances of digital twin models, each identified by a digital twin model name (string) and an instance identifier (string). During message processing, outbound messages can be sent back to data sources and/or to other instances of digital twins.
For the concepts behind ScaleOut Digital Twin Builder, please read the ScaleOut Digital Twin Builder User Guide, including the information about ScaleOut Digital Twin Streaming Service™.
Overview
The ScaleOut Digital Twin Builder .NET API library lets application developers easily:
Define digital twin models.
Deploy those models for message processing within ScaleOut StreamServer's in-memory data grid.
Connect the execution environment to the messaging framework of your choice, like Microsoft Azure IoT Hub or ScaleOut's Messaging REST API web server.
Process incoming messages using digital twin instances dynamically created by ScaleOut StreamServer for each data source.
Send outgoing messages back to associated data sources or to other digital twins.
Send alert notifications to the monitoring service (such as Splunk On-Call™, PagerDuty™, or Slack™).
Persist digital twin instances in the Azure Digital Twins service.
The first step of using this library is to learn how to define a digital twin model, which consists of a DigitalTwin, MessageProcessor, and Message classes. The process is described in the ScaleOut Digital Twin Builder™ Software Toolkit topics in the ScaleOut Digital Twin Builder User Guide.