数字孪生

数字孪生是充分利用物理模型、传感器更新、运行历史等数据，集成多学科、多物理量、多尺度、多概率的仿真过程，在虚拟空间中完成映射，从而反映相对应的实体装备的全生命周期过程。

在数字孪生模块中，用户可以创建和管理孪生体模板、属性组、孪生体、资源、机理和场景等，以管理虚拟世界的数字孪生内容，为企业提供全方位的培训、指导、体验、监测和控制，以及模拟等功能的支持。

资源

资源包含用户上传的图片、音频、模型以及 DataMesh Studio 制作的剧本等文件。用户可在 DataMesh 客户端产品中加载使用 FactVerse 服务中的资源文件。

您可以在功能模块导航栏中选择数字孪生 > 资源，进入资源页面。资源页面支持用户上传资源文件、下载等操作。

下面是关于资源页面的功能说明：

上传资源

在资源页面，您可以点击上传按钮  上传您的资源文件。关于上传资源的更多信息，请参考上传资源。

过滤资源

点击  并根据标签来过滤资源，选择一个标签后，资源列表将显示所有带有该标签的资源。

资源排列方式

使用缩略图  或列表排列方式 来显示您的资源，缩略图排列方式将平铺显示目录下的所有资源，列表排列方式将以列表的形式显示所有资源。

资源分类

通过分类方式来浏览资源，包括全部文件、剧本、模型。

资源搜索

您可以使用搜索框进行资源搜索，并且搜索框前的搜索位置选项可让您选择是进行全局搜索还是当前目录的搜索。

资源操作

当勾选资源文件后，您可以选择下载、删除或移动资源文件。注意：当用户无操作权限时，操作选项按钮置灰。

查看资源详情

点击资源的详情按钮  可以查看资源文件详情。

重命名资源文件

点击资源的编辑按钮 ，可以重命名资源。

上传资源

DataMesh FactVerse 服务支持上传以下类型文件：

• • 3D 模型：支持上传包括 FBX 和 GLB 格式的 3D 模型，上传时还可享受加速服务。
  • AB （bundle 文件）
  • 图片：支持常见的图片格式，如 JPEG、JPG、PNG、TIF、GIF、TGA 等。
  • 音频：支持多种音频格式，如 MP3、OGG。
  • 视频：支持常见的视频格式，如 MP4、MOV。
  • PDF
  • MODEL3Dv2（3D 模型新类型）
  • 可定制化资源： 这类资源通常需要 DataMesh 提供相应的开发支持，以实现所需的定制化功能和效果。
    • • ASSET（高级资源）
      • GADGET（小工具）
      • SCENE（个性化场景）

3D 模型的加速服务由 Unity 加速器支持。用户可以在企业管理 > 加速服务设置中设置加速器支持的平台。 以下是上传资源的步骤：

1. 在资源页面中选择要存储资源的目录，然后点击【上传】按钮。

2. 在弹出的本地资源窗口中，选择要上传的文件并点击【打开】。每次只能上传一个资源文件。

3. 在上传窗口中，点击【上传】按钮，等待上传进度到达 100%。

注意：文件名最多60个字符。

上传完成后，资源图标将变为“转换中”的状态，此时转换进度图标为 。服务器将会对资源进行转换，资源处理信息会显示在消息中心中。当转换完成后，图标为 ，这时您就可以在 DataMesh 客户端产品中使用这个资源了。

手动加速模型文件

FactVerse Services提供模型加速服务，可自动优化上传的模型，以优化在各平台上的加载和渲染性能。同时，用户还可以在模型上传完成后点击加速状态的刷新按钮手动触发加速任务。

手动加速任务将进入加速服务的排队队列。由于与其他用户共享加速服务，任务完成时间受排队任务数量和模型大小影响。

如果排队任务较多或上传的模型较大，加速任务完成时间可能较长。相反，如果排队任务较少或上传的模型较小，加速任务完成时间可能更快。

加速状态表示：

• • 绿点：加速成功完成。
  • 红点：加速失败。
  • 黑点：等待加速。

删除资源

您可以一次删除一个或多个资源文件。以下是删除资源的步骤：

1. 在资源页面中选择资源所在的目录，然后选中您要删除的资源文件前的复选框。

2. 点击删除按钮 。

3. 在弹出的提示窗口中点击【确认】完成资源删除。

注意：删除文件后不可恢复，会导致使用此文件的剧本无法播放。因此，请在删除之前确保您不再需要这些资源文件。

下载资源

下载资源到本地：

1. 在资源页面中选择资源所在的目录，然后选中您要下载的资源文件前的复选框。

2. 点击下载按钮 。

3. 当浏览器提示下载多个文件时，点击【允许】完成多个资源的下载。

移动资源

将一个或多个资源文件移动到其他存储目录：

1. 在资源页面中选择资源所在的目录，然后在您要移动的资源文件前，选中相应的复选框。如果您要移动多个文件，可以选择多个复选框。

2. 点击移动按钮 。

3. 在弹出的选择目录窗口中，选择您要将资源移动到的目标文件夹目录。

4. 点击【确认】按钮确认您的选择，系统将移动您选中的资源文件到目标文件夹。

查看资源详情

以下是具体的操作步骤：

1. 在资源页面中选择资源所在的目录，然后点击要查看的资源文件的详情按钮 。

此剧本的资源详情如下图所示：

资源详情窗口显示如下资源的信息：

• • 目录：资源存储目录。

• • 文件名：资源文件名。

• • 大小：文件大小。

• • 定位码数量：剧本中所包含的定位码数量。

• • 创建时间：资源上传日期。

• • 修改时间：资源修改日期。

• • 创建者：上传资源的用户名。

• • 加速状态：当查看模型文件的详情时，资源详情窗口中显示该模型的加速状态信息，即该模型使用各平台加速服务的进度，分别是：待加速、加速中、加速完成、加速失败（该状态下可手动重新加速）。注意：当手动加速时，资源的加速任务会进入加速服务排队，因为服务和企业内其他用户共享，加速任务的完成时间依赖于排队任务数量以及模型大小。

• • 标签：标签主要用于资源、活动及场景的分类。

2. 点击资源详情窗口左下角，窗口中将显示资源的链接和二维码信息。

3. 具有该目录访问权限的用户可以使用资源详情页面中提供的链接或二维码，轻松查看资源。

重命名资源文件

重命名资源文件。

操作步骤：

1. 在资源页面中选择资源所在的目录，然后点击要查看的资源文件的详情按钮 。

2. 点击资源的编辑按钮 。

3. 修改资源名。

4. 点击完成按钮  完成资源重命名。

模板

孪生体模板是定义一类数字孪生体的模板，形容一类孪生体的模板，每个模板包含一类孪生体的元数据、机理和模型，一个模板支持创建同类孪生体。

您可以在功能模块导航栏中选择数字孪生 > 模板，进入模板页面。模板页面支持用户新建模板、查看模板详情、为模板添加属性组、资源等。

新建模板

在模板页面中，您可以新建一个空模板来开始定义您的数字孪生体。

以下是新建模板的步骤：

1. 在模板页面中选择模板的存储目录。

2. 点击【新建】按钮。

3. 在新建窗口中，填写模板名称、描述等信息后，点击【确认】按钮完成模板的创建。

名称（必填）：孪生体模板名称。必须以中文、日文、英文或数字开头，最多18 个字符。

标签：用户可以自定义标签用于模板的分类。

描述：模板描述。

缩略图：模板封面图。

查看模板详情

要查看模板详情，请按照以下步骤操作：

1. 在模板页面中选择模板的存储目录。

2. 单击要查看的模板的详情按钮 。

3. 在模板详情页面中，您可以查看该模板的详细信息，并可以为模板添加属性组、机理、资源、子模板，以及查看关联的孪生体（即以此模板为基础创建的孪生体）。

添加属性组

在模板详情页面中，您可以为一个模板添加私有属性组以自定义模板属性。

操作步骤如下：

1. 在模板页面中选择模板的存储目录。

2. 点击要编辑的模板的详情按钮 ，进入模板详情页。

3. 在属性栏下点击【新建】按钮。

4. 在新建私有属性组窗口中填写属性组名称（必填），点击【确认】则新的属性组显示在属性栏中。

5. 点击属性组的添加按钮 。

6. 在新建属性窗口填写名称（必填）、数据类型、取值范围（必填）、步长（必填）等属性信息。

名称：必须以中文、日文、英文或数字开头，不超过 18 个字符。

数据类型：请参考属性的数据类型。

7. 点击【确认】完成属性的创建。

引用公用属性组

在模板详情页面中，您可以选择引用已有的公用属性组。请注意以下两点：

1. 提前创建公用属性组：确保已创建要引用的公用属性组，或者其他用户已经创建了需要引用的公用属性组。关于创建公用属性组的详细信息，请参考新建公用属性组。

2. 具有访问权：确保您有访问该属性组所属目录的权限。

以下是为模板引用公用属性组的步骤：

1. 在模板页面中选择模板的存储目录。

2. 点击要编辑的模板的详情按钮 ，进入模板详情页。

3. 在属性栏下方，点击【引用】按钮。

4. 在引用属性组窗口中，填写属性组名称，选择要引用的公用属性组所在的目录，并点选该目录下公用属性组。

5. 点击【确定】，引用的属性组（✩属性组名称）将显示在属性组列表中。

添加子模板

在模板详情页面中，您可以为一个模板添加子模板，用于定义模板的一部分结构。例如，对于一个无人车模板，您可以将轮胎模板作为子模板添加进来，以定义无人车的轮胎部分。

以下是添加子模板的步骤：

1. 在模板页面中选择模板的存储目录。

2. 点击要编辑的模板的详情按钮 ，进入模板详情页。

3. 在子模板栏下，点击【选择已有】按钮。

4. 在选择已有窗口中，点选需要的子模板，并点击【确认】完成子模板的添加。

删除模板

您可以通过以下步骤删除不需要的模板：

1. 在模板页面中选择模板的存储目录。

2. 点击要删除的模板的删除按钮 。

3. 在提示窗口中，点击【确认】。

属性组

属性组是用来描述孪生体的一组共性属性的集合，这组属性通常对应着孪生体的功能、特征或信息。

您可以在功能模块导航栏中选择数字孪生 > 属性组，进入属性组页面。在这里，您可以管理公用属性组，并在需要的时候在模板中引用这些属性组，以快速添加属性组并提高其重用性和可维护性。

属性的数据类型

属性是用来描述孪生体性质或特征，属性通常对应着孪生体的功能、特征或信息。

FactVerse 服务平台中使用了以下属性的数据类型：

1. int：整数类型，用于描述整数形式的物理量，例如：1、2、5。

取值范围：-2147483648 ~ 2147483647

步长：在每次运算中加上指定数值（即步长）重复执行此运算。

单位：属性数据的计量单位，例如，米、厘米。

2. double：描述浮点数形式的物理量，8byte 精度，例如：1.2、2.5、3.0。可以用来表示“时间”、“百分比”、“汇率”等需要精确表示数值的属性。

取值范围：-2147483648 ~ 2147483647

步长：在每次运算中加上指定数值（即步长）重复执行此运算。

单位：属性数据的计量单位，字符串类型。例如，米、厘米。

3. text：text 类型又称文本类型，可以用来输入文本。

数据长度：默认设置为 10240 字节。

4. bool：bool 类型又称布尔类型，是一种判断类型，用作逻辑判断。bool 类型属性的值只有真（1) 和假（0）。

5. vector3：用于描述三维空间信息的物理量，例如，坐标、旋转角度、缩放等属性。

用途：position、rotation。

单位：属性数据的计量单位，字符串类型。例如，度、cm。

属性值：x,y,z 格式属性值。

6. color：颜色类型。

属性值：格式 R,G,B,A，前三个数字代表 RGB 色值，第四个数字代表透明度值。

取值范围：每个数字都是 0-1 之间的小数。例如，1.0,1.0,1.0,1.0。

7. date：日期属性。例如，2023-03-01 00:00:00。

8. enum：枚举类型，指标识符与枚举值的对应关系。

新建公用属性组

以下是新建公用属性组的步骤：

1. 在属性组页面中选择属性组的目录后，点击【新建】按钮。

2. 在新建公用属性组窗口中填写属性组名称（必填），然后点击【确认】按钮，新建的属性组将会显示在属性组页面中。

注意：属性组名称必须以中文、日文、英文或数字开头，不支持特殊符号。

3. 点击添加按钮  为属性组添加属性。

4. 在新建属性窗口中，填写属性信息。例如，可以新建一个旋转角度的属性：

名称（必填）：必须以中文、日文、英文或数字开头，不超过18 个字符。

数据类型：请参考属性的数据类型。

5. 点击【确认】，新添加的属性将显示在属性组的下方。您可以根据需要点击删除按钮  删除属性或编辑按钮  编辑属性。

6. 可以重复步骤 3-5，为属性组添加多个属性。

通过以上步骤，就可以新建一个公用属性组，并添加属性到该属性组中。在创建孪生体模板时，可以方便地引用该公用属性组，并使用其中的属性进行孪生体描述。

如果要删除公用属性组，您可以点击属性组的删除按钮 ，并在提示信息窗口中点击【确认】，即可完成删除公用属性组的操作。

如果要编辑公用属性组的名称，您可以点击属性组的编辑按钮 ，然后在编辑窗口中修改属性组名称，最后点击【确认】，即可完成属性组名称的编辑。

孪生体

孪生体是在信息世界中对物理世界具体实体的等价映射，每个孪生体是一个孪生体模板的具体实例。

您可以在功能模块导航栏中选择数字孪生 > 孪生体，进入孪生体页面。孪生体页面支持用户新建孪生体、编辑和删除孪生体、查看孪生体详情等功能。

新建孪生体

新建孪生体即由孪生体模板创建出的孪生体可继承模板的元数据属性、机理、资源、子模板和关联孪生体。

步骤

1. 在孪生体页面中选择孪生体的存储目录后，点击【新建】。

2. 在新建窗口中，填写孪生体的信息。

名称（必填）：即孪生体名称。

模板（必选）：孪生体模板。

创建子模板孪生体：当一个模板 A 包含一个子模板 B 时，在使用模板 A 创建孪生体时，如果勾选了这个配置，系统会同时创建模板 A 和子模板 B 的两个独立的孪生体。

数据源：孪生体的数据源可以分为 HTTP、HTTPS 和 TCP 三种类型。

数据源地址：分为真实数据接口和模拟数据脚本。

• • 真实数据接口：参考 MQTT 服务器访问信息指定的 IP 地址进行填写。
  • 模拟数据脚本：脚本需要上传至 DataMesh FactVerse 服务平台，并将存储路径填入数据源地址。格式规范：SimulationFile:/存储路径/文件名.iotsim。

3. 点击【确认】完成孪生体的新建。

机理

机理是指孪生体进行变化的规则，与一定的内在工作方式以及在一定环境条件下相互联系、相互作用的运行规则和原理。注意：需要在 DataMesh 客户端，如 FactVerse Designer 中创建机理。

场景

您可以在功能模块导航栏中选择数字孪生 > 场景，进入场景页面。场景页面提供场景管理功能，可以配合 FactVerse Designer 客户端使用。

下面是关于场景页面的操作说明：

• • 新建场景：在场景页面，您可以点击【新建】按钮，新建一个空白场景。然后可以通过 FactVerse Designer 打开并编辑该场景。
  • 删除场景：点击场景对应的删除按钮 ，可以删除该场景。
  • 查看场景详情：点击场景对应的详情按钮 ，可以打开场景详情页以查看该场景详情。

新建场景

步骤

1. 在场景页面中选择场景的存储目录后，点击【新建】按钮。

2. 在新建窗口中，填写场景的信息。

3. 点击【确认】完成场景的创建。

查看场景详情

在场景页面，点击要查看的场景对应的详情按钮 ，可以打开该场景的场景详情页。

场景详情页上方显示场景的基础信息，包括场景名称、标签、创建者、创建时间和描述。页面下方包括孪生体列表、工位列表、机理列表和任务列表相应的功能。

孪生体列表

在场景详情页面的孪生体列表栏中，您可以进行以下操作：

引用孪生体：在场景详情页面的孪生体列表栏中，您可以点击【引用】按钮，为场景引用孪生体模块中已创建的孪生体。

删除孪生体引用：在场景详情页面的孪生体列表栏中，点击要删除的孪生体所对应的删除按钮 ，可以从场景中删除对该孪生体的引用。

为引用的孪生体分配工位：在场景详情页面的孪生体列表栏中，点击孪生体对应的设置按钮 ，为该孪生体选择已建好的工位，一个孪生体可以与一个工位绑定。