Function descriptions

Create digital twin templates

FactVerse Designer provides two methods to create digital twin templates to meet different needs:

1. Customizing from Preset Templates: The Virtual Factory DLC comes with a collection of common templates, such as generators, conveyors, AGVs (Automated Guided Vehicles), and more, frequently used in factory settings. Users can choose one of these preset templates as a starting point and then customize and edit it to adapt to specific scenes and requirements. This approach simplifies and expedites the process of creating digital twin templates.

2. Creating New Templates from Scratch: FactVerse Designer also supports users in creating templates from scratch. You can start by adding resources and gradually setting the attributes and parameters of the template. This means you can fully customize and design a template from scratch that suits your specific scene, based on your needs and ideas. You can add the required components, define their attributes and behaviors, and create a completely new template that meets your requirements.

Example 1: Customizing a pre-set storage area template

In this example, we will use the preset storage area template from the Virtual Factory DLC to create a customized storage area template that allows users to modify the “Width of Goods,” “Length of Goods,” and “Height of Goods” attribute values when using the template to create storage areas. Follow the steps below:

1. Click the Open button below the Digital Twin Template on the left side of the homepage to open the template editor.

2. In the prompt window, choose the “Staging Area” template (<DLC storage path>/DLC/TwinTemplate/Staging Area) and click the Open button to open the “Staging Area” template in the Template Editor.

3. In the Digital Twin Template pane, select the Width of Goods under the Storage structure. In the Attribute Pane on the right side, check the option Whether to Show in the Digital Twin. By selecting this option, you can edit the product width when using this template to generate storage areas.

4. In the Digital Twin Template pane, select the Length of Goods under the Storage structure. In the Attribute Pane on the right side, check the option Whether to Show in the Digital Twin.

5. In the Digital Twin Template pane, select the Height of Goods under the Storage structure. In the Attribute Pane on the right side, check the option Whether to Show in the Digital Twin.

6. Click the File menu, select Save As to open the Save window for the template.

7. In the Save window, enter the template name as “Storage Area Template,” select the storage location, and click the Save button to save the template.

Example 2: Create a brand-new generator template

In this section, we will demonstrate the process of creating a brand new generator template to showcase the basic steps of building a template from scratch.

Create a new generator template

1. Click the New button below the Digital Twin Template on the left side of the homepage to open the template editor.

2. In the template editor, drag and drop the desired model resource from Resources into the Scene Area. In this example, we will use the “Creator” model as the generator model.

3. Click on the Libraries tab and find the following resources in the Digital Twin Content category. Drag and drop each of them into the scene:

• • The Name of the Panel
  • Progress Bar
  • Output

Once added, all resources will be visible under the Resources section of the Digital Twin Template pane.

4. In the Scene Area, drag and place the Name of the Panel, Progress Bar, and Output around the generator in suitable positions.

5. Click the Save button in the toolbar to open the Save window.

6. In the Save window, enter the template information and click the Save button.

• • Name: The name of the digital twin template. Note: The template name must be unique.
  • Storage Location: The storage location for the digital twin template.

7. In the prompt window for successful saving, click the OK button to complete the template upload.

Add the main function structure

1. In the Digital Twin Template pane, click on the ellipsis (︙) next to Metadata and select Add Structure.

2. Scroll down and find the newly added structure “Part_1.” Click on “Part_1” and modify the structure name to “Main Function” in the Attribute Pane.

3. Click on the ellipsis (︙) next to the Main Function structure and select Add Attribute from the list. Choose the data type Double for the attribute. This step adds a new attribute “Attribute_1” to the Main Function structure.

4. In the Digital Twin Template pane, click on “Attribute_1.”

5. As shown in the figure below, modify the attribute name to “Interval for Generating Digital Twins” in the Attribute Pane and make the following settings:

• • Unit: “Seconds”
  • Default value: “3”
  • Check the Whether to Show in the Digital Twin By checking this option, users can edit this attribute when using this template to generate digital twins in the Scene Editor.

6. Click on the ellipsis (︙) next to the Main Function structure and select Add Attribute from the list. Choose the data type Double for the attribute. This step adds a new attribute “Attribute_1” to the Main Function structure.

7. In the Digital Twin Template pane, click on “Attribute_1.”

8. As shown in the figure below, modify the attribute name to “Timer for Generating Digital Twins” in the Attribute Pane and make the following settings:

• • Unit: “Seconds”;
  • Default value: “1”;
  • Check the Whether to Show in the Digital Twin option.

9. Following the above steps, add a new attribute of data type “String.” As shown in the figure below, modify the attribute name to “Identifier for Generating Digital Twins” in the Attribute Pane and make the following settings:

• Purpose: Select “Digital Twin Template”
• Check the Whether to Show in the Digital Twin option.

10. In the Resources section, select the Progress bar. Modify the Progress Bar Attributes in the Attribute Pane, setting the Current Value to “Timer for Generating Digital Twins” and the Maximum Value to “Interval for Generating Digital Twins.”

11. Click the Save button in the toolbar to save the template.

Create a behavior tree for the generator

To create a new behavior tree for the generator template in Example 2:

1. In the Digital Twin Template pane, click ︙ next to the Mechanism column and select Create Behavior Tree to create a new behavior tree.

2. In the opened window, choose the storage path and fill in the behavior tree name.

3. Click the New button to complete the creation of the behavior tree.

4. Click the Save button in the toolbar to save the template.

Edit the behavior tree for the generator

The newly created behavior tree “Behavior Tree of Generator 1″ contains only a root node. In this section, we will add nodes and their execution conditions to the ” Behavior Tree of Generator 1″.

1. In the Digital Twin Template pane, double-click the newly created “Behavior Tree of Generator 1” under the Mechanism column to open the behavior tree editor.

2. Add a Select Node to the “Behavior Tree of Generator 1”:

a). In the left pane of Composite Nodes, drag and drop the Select Node into the editing area.

b). Connect the Root Node (Input) to the Select Node. For connection methods, please refer to Node operation.

c). Click the root node and press the “L” key to automatically format the tree.

3. Add an idle node:

a). In the left panel of Tools nodes, find the Idle node and drag it into the editing area.

b). Connect the Select Node to the Idle

c). Set the running condition of the Idle node, click the Idle node, and select Whether the Port Already Exist Digital Twin.

4. Add a Sequence Node:

a). In the left pane of Composite Nodes, find the Sequence Node and drag it into the editing area.

b). Connect the Select Node to the Sequence Node.

5. Add a Wait node:

a). In the left pane of Tools Nodes, find the Wait node and drag it into the editing area.

b). Connect the Wait node to the Sequence Node.

c). Set the attributes of the Wait node:

• • • Waiting Time: “main|createObjectInterval” (interval between producing digital twins)
    • Store the Current Wait Time into an Attribute: “main|createTimeCount”（timer for producing digital twins）

6. Add a create Digital Twin Node: Add a node for producing items to the generator.

a). In the left pane of Digital Twin Node, find the Create Digital Twin node and drag it into the editing area.

b). Connect the Sequence Node to the Create Digital Twin

c). Set the attributes of the Create Digital Twin node:

• • • The Template Identifier Used to Create the Digital Twin: “main|createObjectIdentifier” (identifier for producing digital twins).
    • Create the Location of the Digital Twin: “Exit|pos” (position of the exit)
    • Create a Rotation of the Digital Twin: 0, 0, 0

7. Add a Set Digital Twins to the Port node:

a). In the left pane of Port Nodes, find the Set Digital Twins to the Port node and drag it into the editing area.

b). Connect the Sequence Node to the Set Digital Twins to the Port

c). Set the attributes of the node:

• • • Entrance Name: “Exit”
    • Digital Twin Set in Port: “Current Digital Twin”

8. Click the Save button in the toolbar to save the template.

Create digital twins

Digital twins are elements in the digital twin scene used to simulate and showcase specific entities or devices, such as generators, conveyors, AGVs, and more. In FactVerse Designer, you can use pre-designed templates from the Virtual Factory DLC or create new digital twin templates according to your needs to build digital twins.

In this section, we will use the generator template created in Example 2 to create a digital twin named “Production 2” and add it to the scene. Here are the steps:

1. Click the Open button below the Scene section on the homepage to open the scene selection window.

2. Browse the scene directory, select the scene you want to open, and click on it to open the Scene Editor.

3. In the Scene Editor, click the button  in the Digital Twin tab of Resources to open the new digital twin window.

4. In the new digital twin window, enter the digital twin’s name as “Production 2,” select the digital twin template “Generator 1” and set the digital twin’s storage location.

5. Click the Confirm button to complete the creation of the generator.

6. In the storage directory, find the newly created “Production 2” and drag it into the Scene Area.

By following these steps, you have successfully created a digital twin named “Production 2” using the generator template and added it to the scene. Now, you can proceed with other editing operations, such as setting digital twin attributes and behaviors, performing path planning, and more, to build a complete digital twin scene.

Adjust scene perspective

In FactVerse Designer, you can adjust the scene perspective in various ways to better observe and edit the scene. Here are some commonly used methods for adjusting the scene perspective:

• • Rotate View: Hold the right mouse button to drag the entire view. The mouse cursor will change to a magnifying glass, allowing the user to observe the model from all angles.
  • Adjust Baseline Height: Use Shift + Left mouse button to quickly adjust the baseline height.
  • Space Zoom: You can zoom in and out by scrolling the mouse wheel. Scrolling up will zoom in, and scrolling down will zoom out.
  • Drag Scene: You can drag the scene by holding down the mouse wheel or clicking and dragging the left mouse button in the Scene Area. This allows you to move the scene horizontally or vertically for better viewing.

Import and export scene files

The digital twin scene file (.digpkg file) contains digital twins and other digital twin content within the scene, such as the structural data of the digital twin template, behavior trees, resources, and scene path data. Users can import and export digital twin scenes from the homepage.

Digital twin attributes

Attributes of digital twins are the collective term for the nature and characteristics of a digital twin, covering various aspects such as production information, appearance attributes, status information, and purpose-related properties.

• Production Information Attributes: These attributes describe the production-related information of the digital twin, such as model, batch, manufacturer, and production date.
• Appearance Attributes: Appearance attributes define the visual characteristics of the digital twin, including color, texture, size, position, and other visual features.
  • Status Attributes: Status attributes represent the operational status of the digital twin, such as whether it is running, malfunctioning, or under maintenance.
  • Purpose Attributes: Purpose attributes describe the performance and characteristics of the digital twin in specific use cases, such as production and processing efficiency, energy consumption, decibels, temperature, and other relevant metrics.
  • Relationships Between Digital Twins: Additionally, you can define relationships between digital twins using the Attribute Pane. This includes specifying production relationships, processing relationships, transportation relationships, storage relationships, and disposal relationships between digital twins.

To define these attributes, appropriate data types are used, including the following:

Type	Customizable Attributes
Int	Quantity, frequency, speed, etc.
Double	Temperature and humidity, power consumption, balance, quality, area, etc.
String	ID, model etc.
Bool	Running status, check status, execution results, etc.
Vector3	Placement position, placement angle, passing position, etc.
Vector2	Placement position of stationary objects on the ground, target points on the ground, etc.
Path	Movement path, transfer path, transportation path, etc.
Date	Manufacturing date, maintenance date, etc.
Time	Startup time, landing time, stop time, etc.
Color	Exterior color, status color, etc.
Enum	Error codes and error types, product codes and product categories.

Path planning

In the digital twin scene, each digital twin needs a scene route to constrain its movement trajectory when performing actions such as transportation and transfer, ensuring that it can only move within the designated route.

Within FactVerse Designer, the path planning feature allows you to mark points and draw lines in the 3D digital twin scene while specifying the route direction.

Path planning describes the movable range information in the digital twin scene, which consists of a directed connected graph formed by a series of movable key points. The path planning feature includes the following components:

1. Key Points: Key points are marked in the scene and serve as vertices in the connected graph.

2. Connectivity: Connectivity defines the relationships between key points, including whether they can be connected and the direction of the connections, forming a directed graph.

3. Path: Paths are specified as a series of consecutive vertices in the connected graph, creating a fixed movement route for digital twins.

The basic process of creating paths is as follows:

1. In the scene editing interface, click the path map button  in the toolbar to enter the Path Planning interface.

2. Once in the Path Planning interface, use the construction mode to create points. Points will be created on the plane based on the default construction height (0).The newly created points are connected in the default direction, i.e., forward from the current point to the next one.

3. In selection mode, click on points and lines to modify their positions and connection directions.

Construction mode

In the construction mode, you can create key points by left-clicking on any area in the scene and then move the mouse and click again to create the next key point. The two key points will be automatically connected with the default direction.

To improve the efficiency of path construction, you can configure the default construction settings in the upper left corner of the scene, including the key point height and connection direction.

• • Point Height: All points created in construction mode will have this height.
  • Path Direction: All points created in construction mode will be connected to the next one in this direction.

As points are constructed in the scene, corresponding entries will appear in the left-side point list pane, following the naming rule “Point+Num” by default.

After creating the key points, you can perform the following operations:

• • Rename or delete points.
  • When a point is selected, you can precisely adjust its position data through the coordinate input box in the right-side properties pane.
  • When the line connecting two key points is selected, clicking the direction arrow options in the right-side attributes pane can switch the connection direction between the two points.

Selection mode

In the selection mode, you can drag the scene to move the entire view and also select key points to modify their positions.

Visual operational debugging

In the scene playback interface, a debugging window is added to achieve the visualization of behavior tree traversal. The debugging window simplifies the process of debugging the behavior tree by providing a clear visualization. The adjustment of digital twin attributes in Attribute Pane allows for easy monitoring and optimizing the production line as needed.

• The “Behavior Tree Pane” displays the real-time execution status of the selected digital twin’s behavior tree. Nodes that are currently executing are shown in light blue, nodes that have not been executed are shown in dark blue, and green and red colors represent successful and failed return values of these nodes, respectively.

• The “Attribute Pane” of the digital twin can be used to change the digital twin’s attribute values and observe the scene performance after the numerical changes.

• The log pane is used to print the output of Log nodes in the behavior tree.