3DGS扩展包
3DGS扩展包是需要授权的高级付费功能。为保障您的权益与使用体验，请通过官方渠道联系客服购买。成功授权后，您将获得由我们技术团队提供的专属支持服务，包括但不限于扩展包部署、激活与初期使用指导，确保您能顺畅、高效地启用各项功能。
3DGS扩展包包含两大核心功能：分别为3DGS建模与发布3DGS模型服务。如需了解详细的操作流程与技巧，请参阅「新手创建引导」。
1. 3DGS 建模
进入3DGS建模功能有两种方式：
- 方式一：打开“Mapmost Studio”软件，在左侧导航栏切换到“首页”模块下，点击“3DGS建模”，进入对应3DGS建模页面。
- 方式二：打开“Mapmost Studio”软件，在左侧导航栏切换到“我的数据”模块下，点击数据列表-3DGS源数据分类列表「建模」操作，使用该 3DGS 源数据进行建模。（需已上传过3DGS源数据，数据列表里才会有记录）。
请注意：3DGS建模目前仅支持单任务运行。若当前已有建模任务正在进行中，请等待其完成后（或手动终止当前任务后）再发起新任务。
1.1. 第一步：参数配置
参数配置页面支持上传/选择数据、填写基础信息、配置建模参数，点击确认后开始全流程自动化建模。
原始数据：
（1）上传数据：支持用户上传本地数据，上传数据页面需要用户填写数据名称、坐标参考、上传文件。
①当坐标参考选择照片自带坐标信息时：支持上传的文件类型为zip，zip中建议包含50-10000张照片，照片支持格式为jpg、png、ipeg、JPG,用户需要将照片直接放置在zip包的根目录下，zip压缩包内不要创建任何文件夹；
②当坐标参考选择照片有单独坐标文件时：支持上传的文件类型为zip，zip中建议包含50-10000张照片，照片支持格式为jpg、png、ipeg、JPG，zip包内必须包含坐标文件，文件支持格式为csv、xlsx，用户需要将照片和坐标文件直接放置在zip包的根目录下，zip压缩包内不要创建任何文件夹；
③当坐标参考选择无时：支持上传的文件类型为zip，zip中建议包含50-10000张照片，照片支持格式为jpg、png、ipeg、JPG，由于照片无准确坐标信息，输出模型的位置、缩放、旋转错误，需要自行手动处理，需要用户将照片直接放置在ZIP压缩包的根目录下，ZIP压缩包内不要创建任何文件夹
（2）选择数据：若从「首页」页面进入建模，则原始数据需从「我的数据-数据列表」已上传的3DGS源数据中进行选择，若「我的数据-数据列表」内无3DGS源数据，则可根据引导先上传3DGS源数据；若从「我的数据」-3DGS源数据列表页面进入建模，则原始数据默认根据已选择的输入数据自动填充，不支持修改。
基础信息：
| 字段 | 说明 |
|---|---|
| 模型名称 | 必填，名称须以小写字母开头，长度4-32，由字母、数字、下划线组成。 |
| 创建人 | 必填，自动带入，不可修改。 |
| 备注 | 非必填，可根据实际情况填写。 |
建模参数：
| 字段 | 说明 |
|---|---|
| 建模质量等级 | 必填，支持用户下拉选择高、中、低，默认中。说明：该参数用于控制建模的精细程度，等级越高，模型越精细，但速度越慢。 |
| 统一光照 | 必填，支持用户开启或关闭，默认关闭。说明：适合光照变化大的照片集（如早晚光线差异大）。 |
| 使用GPU | 必填，GPU状态为空闲和忙碌，空闲可选，忙碌不可选。说明：指定用于训练的GPU编号，如 GPU 0 表示使用第一个GPU，GPU 0 ,GPU 1 表示使用两个GPU并行 。 |
操作：
| 字段 | 说明 |
|---|---|
| 取消 | 点击取消，退出当前建模流程，且已输入的内容不会被保存。 |
| 开始建模 | 点击开始键模，当前输入内容保存（数据列表-3DGS 模型-系统构建下会新增此条建模记录）并开始建模，依次进行后续源数据、构建空三、高斯建模流程。 |
1.2. 第二步：源数据
根据上一步输入的参数配置信息，实时展示数据加载情况和结果，加载过程显示上传进度条和剩余时间。
情况 1：若上传成功，支持查看源数据上传结果，查看照片数量、坐标信息，调整参数查看照片位姿。
情况 2：若上传失败，可根据提供排查方案检查后重新建模；也可点击参数配置，返回参数配置页，调整建模参数后重新开始建模。
1.3. 第三步：构建空三
构建空三阶段页面展示内容包括进度展示、成果展示、硬件实时监测及实时日志查看。
| 模块 | 说明 |
|---|---|
| 进度展示 | 构建空三细化为 5 个步骤，在页面顶部进度条显示，包括提取特征点，生成匹配对，匹配优化，下采样及区块划分。 |
| 成果展示 | 匹配优化完成后，可视化窗口中开始展示空三结果，匹配优化完成前，可视化窗口中无数据展示。区块划分完成后可视化窗口中展示数据划分情况。支持调整参数查看空三成果。 |
| 硬件实时监测 | 通过曲线图展示不同硬件资源的的实时占用情况：通过曲线显示内存占用率；通过曲线显示CPU使用率；通过曲线图展示不同GPU的的实时占用情况，只显示正在使用的GPU。 |
| 日志查看 | 右下角实时输出过程日志，支持收起。 |
情况 1：若构建成功，将自动进入高斯建模流程。
情况 2：若构建失败，显示对应失败节点。
- 可根据提示失败原因及建议的解决方案调整，若未定位到原因，可通过页面展示的二维码支持联系技术客服帮助解决问题。
- 支持重新构建，点击重新构建后从当前阶段开始重新构建。
1.4. 第四步：高斯建模
高斯建模阶段页面展示内容包括总进度展示、区块建模列表、区块建模成果预览、硬件实时监测及实时日志查看。
| 模块 | 说明 |
|---|---|
| 总进度展示 | 进度条形式展示建模总进度，包括总体进度完成百分比和剩余时间。 |
| 区块建模列表 | 展示区块名称、照片数、点云数、区块建模进度、运行时长、操作。 |
| 区块建模成果预览 | 支持通过预览按钮调整可视化窗口中的建模成果展示：默认预览正在构建的区块；若存在多个区块同时构建，则任意选择其中一个进行预览；用户可以对构建中和已完成的区块进行预览，未开始构建的区块预览禁用。只支持单个区块预览。 |
| 硬件实时监测 | 通过曲线图展示不同硬件资源的的实时占用情况：通过曲线显示内存占用率；通过曲线显示CPU使用率；通过曲线图展示不同GPU的的实时占用情况，只显示正在使用的GPU。 |
| 日志查看 | 右下角实时输出过程日志，支持收起。 |
情况 1：若高斯建模成功，则停留在当前页，支持操作有以下 3 种：
- 点击区块建模列表操作内的「预览」，可在当前页查看区块建模成果。
- 点击页面右上角「返回数据列表」，可返回我的数据页面，在 3DGS模型-系统构建列表内查看此条建模记录。
- 点击页面右上角「服务发布」，可使用当前建模完成的结果进行服务发布。
情况 2：若高斯建模失败，显示对应失败区块。
- 可根据提示解决方案调整，可通过页面展示的二维码支持联系技术客服帮助解决问题。
- 可下载日志，了解查看详细失败原因。
- 支持重新建模，点击重新建模后从当前阶段开始重新建模。
情况 3：高斯建模过程中支持暂停操作。
- 点击「暂停建模」，建模流程将停止，此条记录在数据列表-3DGS模型列表-系统构建中状态显示为中断。
- 点击「继续建模」，可继续当前高斯建模流程
1.5. 数据列表
数据列表内展示已上传的3DGS源数据，以及已构建/已上传的3DGS模型资源。
1.5.1. 数据列表-3DGS源数据
3DGS建模页面上传的3DGS源数据在数据列表-3DGS源数据列表中管理，列表中的3DGS源数据支持建模、下载，删除、共享、关联项目、数据筛选等操作。
1.5.1.1. 建模
上传成功的3DGS源数据支持建模操作。仅支持单个数据建模，操作流程详见前文3DGS建模。
请注意：建模功能需购买并激活3DGS扩展包，若未购买则无法使用建模功能。
1.5.1.2. 下载
本人上传成功的数据支持下载到本地，他人共享的数据不支持下载。
①单个数据下载：表格操作-下载，支持单个数据下载。
②批量数据下载：选中多个要下载的数据，点击表格上方多选操作框内下载按钮。
1.5.1.3. 删除
仅可删除本人上传的数据，他人共享的数据、已关联项目的数据、正在建模中的数据均不支持删除。
①单个数据删除：表格操作-删除，支持单个数据删除。
②批量数据删除：选中多个要删除的数据，点击表格上方多选操作框内删除按钮。
1.5.1.4. 共享
仅本人上传成功的数据支持共享，操作路径：表格操作-共享。
共享支持输入或通过搜索成员真实姓名共享。已被共享的成员名称会显示在共享弹窗内。
1.5.1.5. 关联项目
①单个关联项目：表格操作-关联项目，支持单个数据关联。
②批量关联项目：选中多个要关联项目的数据，点击表格上方多选操作框内关联项目按钮。
关联项目支持通过项目名称搜索或表格选择，支持关联多个项目。
1.5.1.6. 筛选
数据列表支持筛选
①支持通过关键字-数据名称、数据所有者进行数据筛选
②支持通过上传时间筛选
1.5.2. 数据列表-3DGS模型
在系统中构建的3DGS模型（标签为系统构建）及用户上传的3DGS模型（便签为用户上传）在数据列表-3DGS模型列表中管理。列表中默认展示系统构建的模型，点击tab支持切换。
当模型便签是系统构建时，模型状态及对应状态支持的操作说明如下：
| 建模状态 | 说明 | 支持操作 |
|---|---|---|
| 进行中 | 存在正在运行中的建模进程 | 查看、删除 |
| 中断 | 存在正在运行中的建模进程并强行关闭（例如点击建模页面中右上角关闭按钮并退出建模） | 继续建模、删除 |
| 成功 | 完成建模并输出建模成果 | 查看、发布、共享、下载、关联项目、删除 |
| 失败 | 存在某个节点建模失败 | 重新建模、下载报告、删除 |
当模型来源是用户上传时，模型状态及对应状态支持的操作说明如下：
| 上传状态 | 说明 | 支持操作 |
|---|---|---|
| 上传中 | 数据正在上传 | 删除 |
| 已上传 | 数据已上传成功 | 发布、共享、下载、关联项目、删除 |
| 上传失败 | 数据上传失败 | 删除 |
1.5.2.1. 查看
系统构建的模型支持查看功能。其中
- 建模状态为「进行中」的3DGS模型，点击查看，跳转3DGS建模页面，展示正在运行的流程页面，支持点击查看参数配置及已完成进程的页面，支持编辑建模参数重新建模；
- 建模状态为「成功」的3DGS模型，点击查看，跳转3DGS建模页面，展示高斯建模结果页面，支持点击查看参数配置，源数据，构建空三等过程页。
请注意：建模功能需购买并激活3DGS扩展包，若未购买则无法使用建模功能，因此也无法使用查看功能。
1.5.2.2. 继续建模
当强行关闭正在运行中的建模进程（例如点击建模页面中右上角关闭按钮并退出建模）时，支持在数据列表内点击继续建模操作，从终止的部分开始构建模型。
点击继续建模后跳转至建模中断进程页面，点击右上角继续建模后开始建模，或回到参数页面调整建模参数后重新建模。
请注意：建模功能需购买并激活3DGS扩展包，若未购买则无法使用建模功能，因此也无法使用继续建模功能。
1.5.2.3. 重新建模
当3DGS建模状态为失败时，支持在数据列表内进行重新建模操作。
点击重新建模后跳转至建模失败进程页面，并点击右上角重新建模后开始建模，或回到参数页面调整建模参数后重新建模。
请注意：建模功能需购买并激活3DGS扩展包，若未购买则无法使用建模功能，因此也无法使用重新建模功能。
1.5.2.4. 发布
系统构建的模型及用户上传的模型、均支持发布操作
输入数据：
| 字段 | 说明 |
|---|---|
| 数据名称 | 必填，根据已选择的输入数据自动填充。如需修改，请退出数据发布抽屉后重新在数据列表内选择需要发布的数据。 |
基础信息：
| 字段 | 说明 |
|---|---|
| 服务名称 | 必填，名称须以小写字母开头，长度4-32，由字母、数字、下划线组成。 |
| 上传人 | 必填，自动带入，不可修改。 |
| 备注 | 非必填，可根据实际情况填写。 |
坐标参数：
| 字段 | 说明 |
|---|---|
| 空间参考 | 必填，空间参考可以形象的比喻为地理数据的定位系统，其定义了如何识别和放置数据在地球上的具体位置。空间参考用于确定数据的真实位置，此项设置不当将导致处理结果位置不正确甚至处理失败。3DGS模型目前只支持EPSG: 3857。 |
| 零点坐标 | 必填，指定数据原点相对空间参考的偏移量，分为xyz三个方向，单位米，默认为不偏移(0,0,0)，设置此值可以让数据往相应方向偏移。 一般用于三维模型在某些投影坐标系下坐标非常大，难以操作的问题。 因此会假定数据具有一个偏移位置，那么在该空间参考下：建模的坐标+零点坐标=投影坐标。 |
特别说明：
- 若用户上传的3DGS源数据（照片）有坐标参考，则基于该数据构建的3DGS模型发布服务时，空间参考和零点坐标由系统自动配置，用户不需要处理；
- 若用户上传的3DGS源数据（照片）无坐标参考，则基于该数据构建的3DGS模型发布服务时，空间参考默认3857不支持修改。零点坐标由用户自行配置，若零点坐标为(0, 0, 0)，则系统默认将模型放置在北京天安门位置；若用户设置了偏移值，则以北京天安门为原点对模型按照偏移值进行偏移。
- 若用户基于自己上传的3DGS模型发布服务，系统默认将模型放置在北京天安门位置，若用户需要将模型放置在指定位置，则需要自行设置零点坐标。例如，需要将模型放在A地点，该地点的3857坐标为：(13478164,3669364,0)，北京天安门的3857坐标为：(12958175,4827503,0)，用户设置的零点坐标值=A点坐标-北京天安门坐标，即(519989,-1158139,0)。
发布抽屉操作：
| 字段 | 说明 |
|---|---|
| 取消 | 点击取消，退出当前数据发布流程，且已输入的内容不会被保存。 |
| 发布 | 点击发布，当前内容保存并发布成对应的服务，可在我的服务-3DGS模型服务列表中查看进度。 |
请注意：发布功能需购买并激活3DGS扩展包，若未购买则无法使用发布功能。
1.5.2.5. 下载
3DGS 模型下载详细操作同3DGS源数据下载
1.5.2.6. 删除
3DGS 模型删除详细操作同3DGS源数据删除
1.5.2.7. 共享
3DGS 模型共享详细操作同3DGS源数据共享
1.5.2.8. 关联项目
3DGS 模型关联项目详细操作同3DGS源数据关联项目
1.5.2.9. 筛选
可根据需要对数据来源是「系统构建」「用户上传」的3DGS 模型数据进行筛选，详细操作同3DGS源数据筛选
1.6. 项目式资源管理
支持以项目为单位管理3DGS数据资源，在项目详情页面开启编辑状态，并点击关联资源按钮，可以将已经构建/上传成功的3DGS模型数据、已经上传成功的3DGS源数据关联到该项目中，其他项目成员可以使用关联的3DGS数据进行建模或服务发布。
2. 发布3DGS模型服务
2.1. 新建
进入3DGS模型服务发布功能有两种方式：
- 方式一：打开“Mapmost Studio”软件，在左侧导航栏切换到“首页”模块下，点击“发布3DGS模型服务”，进入对应服务发布页面。
- 方式二：打开“Mapmost Studio”软件，在左侧导航栏切换到“我的数据”模块下，点击数据列表-3DGS模型分类列表「发布」操作，（需已上传或使用系统构建过 3DGS模型，数据列表里才会有记录）。
发布详细操作详见数据列表-3DGS模型-发布
2.2. 发布
原始数据：
（1）上传数据：支持用户上传本地3DGS模型数据，数据格式支持splat和ply，。
（2）选择数据：从「我的数据-数据列表」选择已上传的3DGS模型数据。
基础信息：
| 字段 | 说明 |
|---|---|
| 服务名称 | 必填，名称须以小写字母开头，长度4-32，由字母、数字、下划线组成。 |
| 创建人 | 必填，自动带入，不可修改。 |
| 备注 | 非必填，可根据实际情况填写。 |
坐标参数：
| 字段 | 说明 |
|---|---|
| 空间参考 | 必填，空间参考可以形象的比喻为地理数据的定位系统，其定义了如何识别和放置数据在地球上的具体位置。空间参考用于确定数据的真实位置，此项设置不当将导致处理结果位置不正确甚至处理失败。3DGS模型目前只支持EPSG: 3857 |
| 零点坐标 | 必填，指定数据原点相对空间参考的偏移量，分为xyz三个方向，单位米，默认为不偏移(0,0,0)，设置此值可以让数据往相应方向偏移。 一般用于三维模型在某些投影坐标系下坐标非常大，难以操作的问题。 因此会假定数据具有一个偏移位置，那么在该空间参考下：建模的坐标+零点坐标=投影坐标。 |
特别说明：
- 若用户上传的3DGS源数据（照片）有坐标参考，则基于该数据构建的3DGS模型发布服务时，空间参考和零点坐标由系统自动配置，用户不需要处理；
- 若用户上传的3DGS源数据（照片）无坐标参考，则基于该数据构建的3DGS模型发布服务时，空间参考默认3857不支持修改。零点坐标由用户自行配置，若零点坐标为(0, 0, 0)，则系统默认将模型放置在北京天安门位置；若用户设置了偏移值，则以北京天安门为原点对模型按照偏移值进行偏移。
- 若用户基于自己上传的3DGS模型发布服务，系统默认将模型放置在北京天安门位置，若用户需要将模型放置在指定位置，则需要自行设置零点坐标。例如，需要将模型放在A地点，该地点的3857坐标为：(13478164,3669364,0)，北京天安门的3857坐标为：(12958175,4827503,0)，用户设置的零点坐标值=A点坐标-北京天安门坐标，即(519989,-1158139,0)。
发布抽屉操作：
| 字段 | 说明 |
|---|---|
| 取消 | 点击取消，退出当前发布流程，且已输入的内容不会被保存。 |
| 发布 | 点击发布，当前内容保存并发布成对应的服务，可在我的服务-3DGS模型服务列表中查看进度。 |
2.3. 服务列表
服务列表内展示已发布的3DGS模型服务，并支持预览、重发、共享、关联项目、查看日志、筛选、复制服务地址、删除等操作。
2.3.1. 预览
发布成功的服务支持预览。点击预览，可预览当前服务及服务发布的参数。
点击「全屏查看」可在新建页面全屏查看服务效果。
2.3.2. 重发
发布失败的3DGS模型服务，支持重发。
点击「重发」，显示发布抽屉，可重新选择数据，调整参数后重新发布
2.3.3. 共享
仅本人发布成功的服务支持共享，操作路径：表格操作-共享。
共享支持输入或通过搜索成员真实姓名共享。已被共享的成员名称会显示在共享弹窗内。
2.3.5. 关联项目
①单个关联项目：表格操作-关联项目，支持单个服务关联。
②批量关联项目：选中多个要关联项目的服务，点击表格上方多选操作框内关联项目按钮。
2.3.6. 删除
仅可删除自己发布的服务，无法删除他人发布的服务。
①单个删除：表格操作-删除，支持单个服务删除。
②批量删除：选中多个要删除的服务，点击表格上方多选操作框内删除按钮。
2.3.7. 筛选
服务列表支持筛选
①支持通过关键字-服务名称、创建人筛选服务
②支持通过服务状态筛选服务
2.3.8. 复制服务地址
发布成功的服务支持复制，点击复制按钮，复制服务地址到剪切板，该服务地址支持在Mapmost SDK for WebGL中加载。
2.4. 项目式资源管理
支持以项目为单位管理服务资源，在项目详情页面开启编辑状态，并点击关联资源按钮，可以将已经发布成功的3DGS模型服务关联到该项目中，其他项目成员可以预览和使用该3DGS模型服务成果。
