Digital Twin

< All Topics

Digital twins fully utilize data such as physical models, sensor updates, operational history, etc., to integrate multi-disciplinary, multi-physical quantity, multi-scale, multi-probability simulation processes, and complete mapping in the virtual space, thereby reflecting the entire life cycle process of the corresponding physical equipment. 

In the Digital Twin module, you can create and manage twin entity templates, attribute groups, twin entities, resources, mechanisms, and scene projects, etc., to manage the digital twin content of the virtual world, providing comprehensive training, guidance, experience, monitoring and control, and simulation function support for enterprises.

Resource

To access the Resource page, navigate to Digital Twin > Resource in the function navigation bar. This page allows you to manage various types of resources, including user-uploaded images, audios, models, and scenarios created using DataMesh Studio, among others.You can select Digital Twin > Resource in the function navigation bar to enter the Resource page.

On the Resource page, you can perform operations such as uploading resource files and downloading files. It provides a centralized location for managing and organizing your resources. Furthermore, the resources stored in FactVerse Services can be easily loaded and utilized within DataMesh client products.

Below are the operation instructions for the resource page:

    • Upload resources: On the Resource page, you can click the upload button to upload your resource files. For more information about uploading resources, please refer to Upload Resources.
    • Filter resources: Click  and filter resources according to tags. After selecting a tag, the resource list will display all resources with that tag.
    • Resource arrangement: Use the thumbnail  or list  arrangement to display your resources. The thumbnail arrangement will display all resources in the directory, and the list arrangement will display all resources in the list form.

    • Resource categories: Browse resources by classification, including All files, Scenario, and Model.

    • Resource search: You can use the search box to search for resources, and the search location option before the search box allows you to choose whether to conduct a global search or a search in the current directory. 
    • Resource operations: After selecting a resource file, you can choose to download, delete, or move the resource file. Note: When the user does not have operation permission, the operation option button is grayed out.

    • View resource details: Click the resource details button  to view resource file details.

    • Rename resource files: Click the resource’s edit button , you can rename the resource.

Upload resources

DataMesh FactVerse Services supports uploading the following types of files:

    • 3D models: Supports uploading 3D models in FBX and GLB formats, with the option of acceleration services during upload.
    • AB (bundle file)
    • Images: Supports common image formats such as JPEG, JPG, PNG, TIF, GIF, TGA, etc.
    • Video: Supports common video formats such as MP4, MOV
    • PDF
    • MODEL3Dv2 (new 3D model type)
    • Customizable resources: These resources usually require DataMesh to provide corresponding development support to achieve the desired customized functions and effects.
        • ASSET (advanced resources)
        • GADGET (small tools)
        • SCENE (personalized scene)

The acceleration service for 3D models is supported by the Unity Accelerator. You can set the platforms supported by the accelerator in Enterprise Management > Acceleration Service Settings.

The following are the steps for uploading resources:

1. Select the directory where you want to store the resource on the Resource page, and then click the Upload button.

2. In the pop-up local resource window, select the file to upload and click Open. Only one resource file can be uploaded at a time.

3. In the upload window, click the Upload button and wait for the upload progress to reach 100%.

Note: The file name can be up to 60 characters.

4. After finishing uploading the resource, the resource icon will change to the “Converting” status, and the conversion progress icon will be displayed. The server will convert the resource, and the resource processing information will be displayed in the message center. When the conversion is complete, the icon    will be displayed, and you can use this resource in the DataMesh client products.

Manually accelerate model files

FactVerse Services offers model acceleration services that automatically optimize uploaded models to improve loading and rendering performance on various platforms. Additionally, users can manually trigger acceleration tasks by clicking the Refresh button on the acceleration status after the model upload is complete.

Manual acceleration tasks will enter the acceleration service’s queue. Since acceleration services are shared among multiple users, task completion time is influenced by the number of queued tasks and the size of the model.

If there are many queued tasks or the uploaded model is large, the acceleration task completion time may be longer. Conversely, if there are fewer queued tasks or the uploaded model is smaller, the acceleration task completion time may be faster.

Acceleration status is indicated by:

    • Green dot: Acceleration successfully completed.
    • Red dot: Acceleration failed.
    • Black dot: Waiting for acceleration.

Delete resources

You can delete one or more resource files at once. Here are the steps to delete a resource:

1. Select the directory where the resource is located on the Resource page, and then check the checkbox in front of the resource file you want to delete.

2. Click the delete button .

3. Click Confirm in the pop-up prompt window to complete the resource deletion.

Note: Deleted files cannot be recovered and will cause scenarios that use these files to be unable to play. Therefore, please make sure that you no longer need these resource files before deleting them.

Download resources

To download resources to your local device:

1. Select the directory where the resource is on the Resource page and check the checkbox in front of the resource file you want to download.

2. Click the Download button .

3. When the browser prompts you to download multiple files, click Allow to complete the download of multiple resources. Note: a maximum of 5 files can be downloaded at the same time.

Move resources

To move one or more resource files to another storage directory:

1. Select the directory where the resource is on the Resource page and check the checkbox in front of the resource file you want to move. If you want to move multiple files, you can select multiple checkboxes.

2. Click the Move button .

3. In the pop-up window for selecting the directory, select the target folder directory where you want to move the resource.

4. Click the Confirm button to confirm your selection, and the system will move the selected resource files to the target folder.

View resource details

Here are the specific steps:

1. Select the directory where the resource is located on the Resource page, and then click the detail button  of the resource file you want to view.

The details of this resource are shown in the following figure:

The Resource details window displays the following information about the resource:

    • Directory: Resource storage directory.
  •  
    • File Name: Resource filename.
  •  
    • Size: File size.
  •  
    • Number of Locating Codes: The number of locating codes included in the scenario.
  •  
    • Creation time: Resource upload date.
  •  
    • Modification time: Resource modification date.
  •  
    • Creator: The username of the user who uploaded the resource.
  •  
    • Accelerated State: When viewing the details of a model file, the Resource detail window displays the accelerated state information of the model, indicating the progress of utilizing acceleration services on various platforms. The states are as follows: Pending acceleration, Accelerating, Acceleration completed, Acceleration failed (in this state, manual re-acceleration is possible).

Note: When manually accelerating, the resource’s acceleration task will enter the acceleration service queue because the service is shared with other users within the organization. The completion time of the acceleration task depends on the number of queued tasks and the size of the model.

  •  
    • Tags: Tags are used for the classification of resources, events, and scene projects.

2. Click the lower-left corner of the Resource details window, and the window will display the link and QR code information of the resource. 

3. Users with access permission to that directory can easily view the resource using the link or QR code provided on the Resource details page. 

Rename resource files

To rename a resource file:

1. Select the directory where the resource is located on the Resource page, and then click the detail button  of the resource file you want to view.

2. Click the edit button  of the resource.

3. Modify the resource name.

4. Click the Finish button   to complete the resource renaming.

Template

A template defines a type of digital twins. It describes a type of digital twins that include metadata, mechanisms, and models, and supports the creation of similar digital twins.

You can select Digital twin > Template in the function module navigation bar to enter the Template page. The Template page supports users to create new templates, view template details, and add attribute groups and resources to templates.

Create a new template

In the Template page, you can create a blank template to start defining your digital twin.

Here are the steps to create a new template:

1. Select the storage directory for the template on the Template page.

2. Click the New button.

3. In the New window, fill in the template Name, Description, and other information and click the Confirm button to complete the template’s creation.

    • Name (required): The name of the twin template. It must start with Chinese, Japanese, English, or numbers, and up to 18 characters.

    • Tags: Users can customize tags for template classification.

    • Description: Template description.

    • Thumbnail: Template cover image.

View template details

To view the template details, follow these steps:

1. Select the storage directory for the template on the Template page.

2. Click the detail button  of the template you want to view.

3. On the Template Details page, you can view the detailed information of the template, and add attribute groups, mechanisms, resources, sub-templates to the template. You can also view the associated digital twins (i.e., digital twins created based on this template).

Add a private attribute group

In the Template Details page, you can add a private attribute group to a template to customize the template attributes.

Here are the steps:

1. Select the storage directory for the template on the Template page.

2. Click the detail button  of the template you want to edit to enter the Template Details page.

3. Click the New button under the attribute column.

4. Fill in the Attribute Group Name (required) in the New Private Attribute Group window and click Confirm to display the new attribute group in the attribute column.

5. Click the add button  of the attribute group.

6. Fill in the attribute information such as Name (required), Data Type, Value Range (required), and Step Size (required) in the New Attribute window.

Name: It must start with Chinese, Japanese, English, or numbers, and up to 18 characters.

Data Type: Please refer to the Data types of attributes.

7. Click Confirm to complete the creation of the attribute.

Leverage the public attribute group

In the Template Details page, you can leverage existing public attribute groups for a template. Please note the following:

1. Pre-create public attribute groups: Make sure that the public attribute groups you want to leverage have been created in advance, either by yourself or by other users. For more information on creating public attribute groups, please refer to Create a public attribute group.

2. Have access rights: Ensure that you have the necessary access rights to the directory where the attribute group belongs.

Here are the steps to leverage a public attribute group for a template:

1. Select the storage directory for the template on the Template page.

2. Click the detail button  of the template you want to edit to enter the template details page.

3. Below the attribute column, click the Cite button.

4. In the Reference attribute group window, fill in the Attribute Group Name, select the directory where the public attribute group to be leveraged is located, and select the public attribute group in that directory.

5. Click Confirm, and the leveraged attribute group (✩attribute group name) will be displayed in the attribute group list.

Add sub-templates

In the Template Details page, you have the option to add sub-templates to a template, which helps define a specific part of the template’s structure. For example, in a template for an autonomous vehicle, you can add a sub-template for tires to define the tire component of the vehicle. 

Here are the steps to add a sub-template: 

1. Select the storage directory for the template on the Template page. 

2. Click the detail button of the template you want to edit to enter the Template Details page. 

3. Below the Sub Templates column, click the Select Existing button. 

4. In the Select Existing window, select the desired sub template and click Confirm to complete the addition of the sub templates. 

Delete a template

You can delete unnecessary templates by following these steps:

1. Select the storage directory for the template on the Template page.

2. Click the delete button  of the template you want to delete.

3. In the prompt window, click Confirm.

Attribute Groups

An attribute group is a collection of common attributes used to describe a digital twin, which usually correspond to the functionality, characteristics, or information of the digital twin.

You can select Digital Twin > Attribute Groups in the function navigation bar to enter the Attribute Groups page. Here, you can manage public attribute groups and reference these attribute groups in templates when needed, to quickly add attribute groups and improve their reusability and maintainability.

Data types of attributes

Attributes are used to describe the properties or characteristics of a digital twin, which usually correspond to the functionality, characteristics, or information of the digital twin.

The following data types are used for attributes in FactVerse Services:

int: Integer type, used to describe integer physical quantities, such as 1, 2, 5.

    • Value range: -2147483648 ~ 2147483647

    • Step size: Add a specified value (i.e., step size) in each operation and repeat the operation.

    • Unit: the measurement unit of attribute data, such as meters, centimeters.

double: Describes physical quantities in floating-point format, with 8-byte precision, such as 1.2, 2.5, 3.0. It can be used to represent attributes that require precise numerical representation, such as “time”, “percentage”, and “exchange rate”.

    • Value range: -2147483648 ~ 2147483647 
    • Step size: Add a specified value (i.e., step size) in each operation and repeat the operation
    • The measurement unit of attribute data, in string type. For example, meters, centimeters.

text: Also known as a text type, used to input text.

    • Data length: The default set value is 10240 bytes.

bool:  Also known as the Boolean type, it is a judgment type used for logical judgment. The value of a bool type attribute is either true (1) or false (0).

vector3: Used to describe physical quantities of three-dimensional space information, such as coordinates, rotation angles, scaling, and other attributes.

    • Application: Position, rotation。
    • Unit: The measurement unit of attribute data, in string type. For example, degrees, cm.
    • Attribute value: In the format of x, y, z.

color:  color type

    • Attribute value: In the format of R, G, B, A, where the first three numbers represent RGB color values, and the fourth number represents the transparency value.
    • Value range: Each number is a decimal between 0-1. For example, 1.0, 1.0, 1.0, 1.0.

date: Date attribute, such as 2023-03-01 00:00:00.

enum: Enumerated type, indicating the correspondence between identifiers and enumeration values.

    • Enumeration items: 1-100.
    • Attribute value: Supports integers.
    • Value range: -2147483648 ~ 2147483647.

Create a public attribute group

The following are the steps to create a new public attribute group:

1. On the Attribute Groups page, select the directory for the attribute group and click the New button.

2. In the New public attribute groups window, enter the Attribute Group Name (required), and then click the Confirm button. The newly created attribute group will be displayed on the Attribute Groups page.

Note: The attribute group name must start with Chinese, Japanese, English or numbers, and does not support special characters.

3. Click the Add button  to add attributes to the attribute group.

4. In the New Attribute window, fill in the attribute information. For example, you can create an attribute for rotation angle:

Name (required): must start with Chinese, Japanese, English or numbers, and not exceed 18 characters.

Data Type: please refer to Data types of attributes.

5. Click Confirm and the newly added attribute will be displayed below the attribute group. You can click the delete button  or edit button  to delete or edit the attributes as needed.

6. You can repeat steps 3-5 to add multiple attributes to the attribute group.

By following the above steps, you can create a new public attribute group and add attributes to it. When creating a digital twin template, you can easily reference the public attribute group and use its attributes to describe the digital twin.

To delete a public attribute group, you can click the delete button  for the attribute group and click Confirm in the prompt window to complete the deletion of the public attribute group.

To edit the name of a public attribute group, you can click the edit button  for the attribute group, modify the Attribute Group Name in the edit window, and then click Confirm to complete the editing of the attribute group name.

Digital twin

A digital twin is an equivalent mapping of a physical entity in the digital world. Each digital twin is a specific instance of a digital twin template.

You can select Digital twin > Digital Twin in the function module navigation bar to enter the Digital Twin page. The Digital Twin page supports functions such as creating, editing, and deleting digital twins, and viewing digital twin details.

Create a digital twin

Creating a digital twin means creating a digital twin based on a digital twin template, which can inherit metadata attributes, mechanisms, resources, sub templates, and associated digital twins from the template.

Steps

1. Select the storage directory for the digital twin on the Digital Twin page and click the New button.

2. In the New window, fill in the information for the digital twin.

Name (required): The name of the digital twin.

Template (required): The digital twin template.

Create a Sub Template twin: When a template A contains a sub template B, if this configuration is selected when creating a digital twin using template A, the system will create two independent digital twins for template A and sub template B at the same time.

Data Source: The data source of the digital twin can be divided into three types: HTTP, HTTPS, and TCP.

Data Source Address: It can be a real data interface or a simulated data script.

    • Real data interface: Fill in the IP address specified in the MQTT server access information.
    • Simulated data script: The script needs to be uploaded to DataMesh FactVerse Services, and the storage path should be filled in the data source address. Format specification: SimulationFile:/storage path/filename.iotsim.

3. Click Confirm to complete the creation of the digital twin.

Mechanism

Mechanism refers to the rules for changes in a digital twin, as well as the operating rules and principles that are interrelated and interact with each other under certain internal working methods and environmental conditions. Note: Mechanisms need to be created in the DataMesh client.

Scene

You can select Digital Twin > Scene from the function module navigation bar to enter the Scene page. The Scene page provides scene management functions that can be used in conjunction with FactVerse Designer.

The following are the operation instructions for the Scene page:

    • Create a new scene project: On the Scene page, you can click the New button to create a new blank scene project. You can then open and edit the scene project using FactVerse Designer.
    • Delete a scene project: Click the delete button corresponding to the scene project to delete it.
    • View scene project details: Click the detail button  corresponding to the scene project to open the Scene Details page and view the scene project details.

Creating a new scene project

Steps

1. On the Scene page, select the storage directory for the scene and click the New button.

2. In the New window, fill in the information for the scene project.

Viewing scene project details

On the Scene page, click the detail button  corresponding to the scene you want to view to open the Scene details page.

The Scene Details page displays basic information about the scene, including the scene name, tags, creator, creation time, and description. The bottom of the page includes the functions corresponding to the List of Digital Twins, List of Workstations, List of Mechanisms, and Task List.

Table of Contents