Twins

Subscription access level

This section describes all operations that a Subscription access level user can perform with Twins.

What is the Twins Feature in Facts?

The "Twins" feature in FACTS enables users to digitally represent and monitor their physical assets, devices, or systems. Each twin acts as a virtual counterpart of a real-world entity, providing real-time data, telemetry, properties, and relationships. This feature enhances the ability to analyze and interact with assets, improving decision-making and operational efficiency.

Users can access critical information such as the twin’s telemetry data, configure relationships, and map data inputs to capabilities. Additionally, the Twins feature supports creating relationships and mappings between twins to form a connected network of virtual entities.

What can you do in the Twins Feature?

1. View Overview: Access the basic details of each twin, including its name, model, and associated data.
2. View Capabilities: Explore the telemetry, properties, and functionalities associated with a twin.
3. Access Telemetry Data: View real-time and historical data streams from the twin’s sensors and devices.
4. View Twin Properties: Inspect specific properties associated with a twin, such as configurations or static metadata.
5. Create Relationships: Establish relationships between twins to define connections or dependencies.
6. Perform Data Mapping: Map incoming data to specific twin capabilities for streamlined data integration.
7. Create Twins: Add new digital twins to the system.

---

Procedures

Creating Twins

1. Navigate to the Twins section.
2. Click the + button in the top right corner to create a new twin.
3. Enter the following details:
   • Name: Provide a unique name for the twin.
   • Model: Select the appropriate model for the twin.
   • Start Timestamp: Specify when the twin becomes active.
   • End Timestamp: (Optional) Define when the twin becomes inactive.
4. Click Submit to create the twin.

Viewing Twin Overview

1. Navigate to the Twins section.
2. Select a twin from the list to view its overview, including model, base model, start timestamp, and end timestamp.

Viewing Twin Capabilities

1. Navigate to the Twins section.
2. Select a twin from the list.
3. Go to the Capabilities tab to view its telemetry, schema, and semantic type.

Viewing Telemetry Data

1. Navigate to the Twins section.
2. Select a twin from the list.
3. Go to the Telemetry tab to view real-time and historical data.

Viewing Twin Properties

1. Navigate to the Twins section.
2. Select a twin from the list.
3. Go to the Properties tab to inspect configurable and static properties.

Creating Relationships

1. Navigate to the Twins section.
2. Select a twin from the list.
3. Go to the Relationships tab and click Create a Relationship.
4. Select the relationship type and target twin.
5. Click Submit.

note

If no model or relationships are defined, a warning will appear indicating the inability to create a relationship.

Performing Twin Mapping

1. Navigate to the Twins section.
2. Select a twin from the list.
3. Go to the Mapping tab and click Add Mapping.
4. Specify the Value JSON Path.
5. Select the target twin and capability.
6. Configure source timestamp JSON path if necessary.
7. Click Save to apply the mapping.

---

With the Twins feature, users can effectively monitor, analyze, and control their digital representations of physical entities, creating a robust system for operational and analytical purposes.