5.5 孪生体管理
【孪生体管理】服务提供孪生体、模板、组件的管理功能。
5.5.1 定义
5.5.1.1 孪生体
孪生体是在信息世界中对物理世界具体实体的等价映射，每个孪生体是一个孪生体模板的具体实例。
5.5.1.2 孪生体模板
孪生体模板是定义一类数字孪生体的模板，形容一类孪生体的模板，每个模板包含一类孪生体的元数据、机理和模型，一个模板支持创建同类孪生体。
5.5.1.3 子模板
子模板用来定义模板中的一部分结构，例如，一个轮胎的模板，可以做为子模板添加到无人车模板。
5.5.1.4 元数据
元数据是抽象出来的结构及其属性，用来将模型定义为孪生体。
- 结构：用来描述孪生体的一组共性属性的集合，这组属性通常对应着孪生体的功能、特征或信息。
- 属性：用来描述孪生体性质或特征，属性通常对应着孪生体的功能、特征或信息。
- 预设结构：为用户提供的一组预设的通用性较强的结构。
5.5.1.5 属性的数据类型
FactVerse 中使用了以下属性的数据类型：
- int：整数类型，用于描述整数形式的物理量，例如：1、2、5。
取值范围：-2147483648 ~ 2147483647
步长：在每次运算中加上指定数值（即步长）重复执行此运算。
单位：属性数据的计量单位，例如，米、厘米。
属性值：取值范围内的任意整数。
- double：描述浮点数形式的物理量，8byte 精度，例如：1.2、2.5、3.0。可以用来表示 “时间”、“百分比”、“汇率” 等需要精确表示数值的属性。
取值范围：-2147483648 ~ 2147483647
步长：在每次运算中加上指定数值（即步长）重复执行此运算。
单位：属性数据的计量单位，字符串类型。例如，米、厘米。
属性值：属性取值范围内的任意浮点数。
- text：text 类型又称文本类型，可以用来输入文本。
用途（必选）：基本、孪生体、模板。
数据长度：默认设置为 10240 字节。
属性值：任意字符串类型的文本。
- bool：bool 类型又称布尔类型，是一种判断类型，用作逻辑判断。bool 类型属性的值只有真（1) 和假（0）。
布尔值：自定义属性值。
- vector3：用于描述三维空间信息的物理量，例如，坐标、旋转角度、缩放等属性。
用途：位置 （position）、旋转（rotation）。
单位：属性数据的计量单位，字符串类型。例如，度、cm。
属性值：x,y,z 格式属性值。
- color：颜色类型。
属性值：格式 R,G,B,A，前三个数字代表 RGB 色值，第四个数字代表透明度值。
取值范围：每个数字都是 0-1 之间的小数。例如，1.0,1.0,1.0,1.0。
- date：日期属性。例如，2023-03-01 00:00:00。
- enum：枚举类型，指标识符与枚举值的对应关系。
枚举项：1 – 100 个。
属性值：支持整型。
取值范围：-2147483648 ~ 2147483647。
5.5.1.6 机理
机理是指孪生体进行变化的规则，与一定的内在工作方式以及在一定环境条件下相互联系、相互作用的运行规则和原理。
行为树是控制数字孪生体决策流程的分层节点树，可以形成一系列决策逻辑，以实现孪生体的运行机理。
5.5.2 模板管理
5.5.2.1 查看模板列表
查看孪生体模板列表。
步骤
- 点击工作组详情页中的【孪生体管理】服务，跳转至孪生体管理——孪生体列表页面。
- 点击【模板列表】选项卡，即可打开孪生体管理——模板列表页面。
图 1 孪生体管理 — 模板列表
用户在孪生体管理——模板列表页面可创建模板、编辑模板，以及为模板添加属性、结构、资源、行为树和子模板。
5.5.2.2 新建模板
新建一个空模板。
步骤
- 打开孪生体管理——模板列表页面。
- 点击模板列表页面上的【新建模板】打开新建模板窗口。
图 2 新建模板
- 在新建模板窗口中输入模板名称与唯一标识符等信息，点击【确认】结束新建模板。
图 3 新建模板窗口
孪生体模板名称（必填）：新建的孪生体模板名称。支持中文、大小写字母、日文、数字、短划线、下划线、斜杠和小数点，必须以中文、日文、英文或数字开头，不超过 30 个字符。
唯一标识符（必填）：孪生体模板的唯一标识符（字母或数字字符串）。支持大小写字母、数字和下划线、不超过 50 个字符。
孪生体模板类型
- 可变长宽物体：可变长宽物体是一些可以改变大小的物体，例如，生产器、转换器。
- 可变路径物体：可以调整路径的物体，例如，传送带、小车。
- 设备：带有行为树逻辑的物体，生产器和转换器也可以是设备。
- 普通物体：一些不带逻辑的物体，例如，生产器生产出来的产品等。
5.5.2.3 添加属性
为模板添加基础属性。
步骤
- 在孪生体管理——模板列表页面上，点击一个模板的【更多】>【基础属性】，打开基础属性页面。
图 4 更多–基础属性
- 在基础属性页面上，点击【添加属性】打开添加自定义功能窗口。
图 5 添加属性
- 在添加自定义功能窗口的属性页面中输入添加的属性信息。
图 6 添写属性信息
属性名称：支持中文、大小写字母、日文、数字、短划线、下划线、斜杠和小数点，必须以中文、日文、英文或数字开头，不超过 30 个字符。
唯一标识符：支持大小写字母、数字和下划线、不超过 50 个字符。
是否必填：是否为必填属性值。
是否编辑：用户是否可编辑属性。
数据类型：参考定义 > 属性的数据类型。
- 点击【下一步】填写属性值并点击【确认】完成属性添加。
5.5.2.4 添加结构
为模板添加结构。
步骤
- 在孪生体管理——模板列表页面上，点击需要添加结构的模板行的【更多】>【结构】，打开结构页面。
图 7 更多—结构
- 在结构页面上，点击【添加结构】打开添加结构窗口。
图 8 添加结构
- 在添加结构窗口中输入结构信息，点击【确认】完成结构添加。
图 9 添加结构窗口
结构名称：支持中文、大小写字母、日文、数字、短划线、下划线、斜杠和小数点，必须以中文、日文、英文或数字开头，不超过 30 个字符。
结构由第三方模型处理软件设计模型时创建，可通过 DataMesh Importer 导入模型时查看结构名称。
唯一标识符：支持大小写字母、数字和下划线、不超过 50 个字符。
- 在结构列表中，点击【添加组件】为结构添加组件。
图 10 添加组件
- 从已定义的组件列表中选择组件。关于定义组件更多信息，参考组件管理 > 定义组件。
图 11 选择组件
当结构未添加组件时支持的操作：打开、编辑、删除、添加组件。
图 12 结构的操作（未添加组件）
当结构已添加组件时支持的操作：打开、编辑、删除、删除组件。
图 13 结构的操作（已添加组件）
5.5.2.5 添加资源
为模板添加资源。
步骤
- 模板列表页面上，点击需要添加资源的模板行的【更多】>【资源】，打开资源页面。
图 14 更多–资源
- 在资源页面上，点击【新增资源】打开新增资源窗口。
图 15 新增资源
- 在新增资源窗口中选择要添加的资源类型，选择资源文件并点击【确定】完成资源添加。
图 16 选择资源类型
预设资源：系统预设的模型资源，例如，传送带、生产器。
资源：工作组中资源库里的模型资源。
在资源页面，点击一个资源行的【删除】按钮可删除该资源。
5.5.2.6 添加行为树
为模板添加行为树。
步骤
- 在孪生体管理——模板列表页面上，点击一个模板的【更多】>【行为树】，打开行为树页面。
图 17 更多 — 行为树
- 在行为树列表中选择行为树添加到模板中。
5.5.2.7 添加子模板
为模板添加子模板。
步骤
- 在孪生体管理——模板列表页面上，点击需要添加子模板的模板行的【更多】>【子模板】，打开子模板页面。
图 18 更多 — 子模板
- 在子模板页面上，点击【新增子模板】打开新增子模板窗口。
图 19 新增子模板
- 在新增子模板窗口中选择要添加的模板，填写子模板名称和唯一标识符后，点击【确认】完成子模板添加。
图 20 填写子模板信息
子模板名称（必填）：支持中文、大小写字母、日文、数字、短划线、下划线、斜杠和小数点，必须以中文、日文、英文或数字开头，不超过 30 个字符。
唯一标识符：支持大小写字母、数字和下划线、不超过 50 个字符。
在子模板页面，点击一个子模板行的【编辑】按钮可编辑该子模板；点击【删除】按钮可删除该子模板。
5.5.3 孪生体管理
5.5.3.1 查看孪生体列表
点击工作组详情页中的【孪生体管理】服务，跳转至孪生体管理——孪生体列表页面。
用户在孪生体管理——孪生体列表页面可添加孪生体、编辑孪生体、删除孪生体。
图 21 孪生体管理 — 孪生体列表
5.5.3.2 添加孪生体
添加孪生体即由孪生体模板创建出的孪生体，可继承模板的元数据属性、机理、资源、子模板和关联孪生体。
步骤
- 打开孪生体管理——孪生体列表页面上。
- 点击【添加孪生体】打开添加孪生体窗口。
图 22 添加孪生体
- 在添加孪生体窗口中输入孪生体相关信息，点击【确认】结束孪生体添加。
图 23 添加孪生体
孪生体名称（必填）：支持中文、大小写字母、日文、数字、短划线、下划线、斜杠和小数点，必须以中文、日文、英文或数字开头，不超过 30 个字符。
唯一标识符（必填）：孪生体的唯一标识符。支持大小写字母、数字和下划线、不超过 50 个字符。
孪生体模板（必选）：列表中为已定义好的孪生体模板。关于如何定义孪生体模板，参考孪生体管理 > 模板管理。
设备数据源：默认使用 http。
数据源地址：分为真实数据接口和模拟数据脚本。
- 真实数据接口：真实数据接口参考 MQTT 服务器访问信息指定的 IP 地址进行填写。例如：13.73.31.125:1883。
- 模拟数据脚本：需要上传脚本至 FactVerse 云服务平台，并将存储路径填入数据源地址。路径格式：SimulationFile:/存储路径/文件名.iotsim）。例如：SimulationFile:/AR1440_1.iotsim
设备 3D 模型：可在进行设置前将设备的 3D 模型上传至 FactVerse 云服务平台。
5.5.4 组件管理
5.5.4.1 查看组件列表
在孪生体管理页面，点击【组件列表】选项卡，打开孪生体管理——组件列表页面。
图 24 孪生体管理 — 组件列表
用户在孪生体管理——组件列表页面可添加组件、编辑组件、删除组件，以及为组件添加属性。
在组件列表页面，点击一个组件行的【编辑】按钮可编辑该组件；点击【删除】按钮可删除该组件。
点击一个组件名前的 【>】可展开该组件的自定义功能（属性和事件）列表。列表中的操作包括编辑、删除属性或事件。
5.5.4.2 定义组件
定义组件。
注意：此操作需要工作组管理员权限。
步骤
- 打开孪生体管理——组件列表页面。
- 点击【定义组件】按钮。
图 25 定义组件
- 在定义组件窗口中输入组件名称、描述信息。
图 26 定义组件窗口
- 点击【确认】关闭定义组件窗口。
5.5.4.3 添加组件属性
添加组件属性。
注意：此操作需要工作组管理员权限。
步骤
- 在孪生体管理——组件列表中，点击一个组件的【添加属性】按钮，打开添加自定义功能窗口。
图 27 添加属性
- 在添加自定义功能窗口中输入属性信息。关于属性的数据类型，参考定义 > 属性的数据类型。
- 点击【确认】完成组件属性的添加。
图 28 组件自定义功能列表