Usage Instructions
For tile data generated based on a single model dataset, this tool supports partial updates of model tile data by 'specifying update range' or 'specifying object ID', thereby enabling on-demand updates for data such as urban fine models, BIM, building white models, etc. Key points for usage:
- Data Backup: This operation will delete historical data. Please confirm that the original data has been backed up before execution.
- Parameter Consistency: The tiles for the update operation must use exactly the same parameters as when creating the original tiles (tile path, name, insertion point, side length, type, etc.), otherwise it may lead to failure.
- Data Preparation:
- Source S3M Tile Data: The target tiles to be updated.
- Update Source Model Dataset (AB): Contains the latest status of the updated model objects. It is usually formed by merging the original model dataset (A) and the model dataset to be updated (B) through methods such as 'append rows'. The model dataset AB must include the update range or update ID. Please avoid any operations that may change the existing object SMID (such as data source compaction, etc.).
- Update Range Dataset (Optional): Only required for the 'update by range' method, used to specify one or more update areas.
Update methods include updating by range and updating by business ID/SMID (when generating the source tiles, business ID is selected as the object ID field, and the business ID must be unique).
Update Principle: Follows the 'result replacement' principle. The system will locate the corresponding parts in the original tiles based on the specified range or ID list, delete them, and then write the new data from the input model dataset corresponding to the range or ID into the tiles.
- Add Objects: The input model dataset for the operation must contain the added model objects, and the update range or ID is the spatial range or ID corresponding to the added objects.
- Delete Objects: Only when using 'update by range', the input model dataset for the operation must delete the specified model objects, and the update range is the spatial range corresponding to the deleted objects.
- Modify Objects: The input model dataset for the operation must delete the original model objects to be modified and include the modified model objects, and the update range or ID is the spatial range or ID corresponding to the modified objects.
- Update Attributes: The input model dataset for the operation must modify the attribute information of certain objects, and the update range or ID is the spatial range or ID corresponding to the modified objects.
The number of updates is unlimited.
The relationship between the source tile pyramid segmentation type and the update content is as follows:
| Pyramid Segmentation Type | Update Method | Attribute Update | Add Objects | Modify/Replace Objects | Delete Objects |
|---|---|---|---|---|---|
| Quadtree | By Range Update | Supported | Supported | Supported | Supported |
| Quadtree | By ID Update | Supported | Supported | Supported | Not Supported |
| Octree | By Range Update | Supported | Supported | Supported | Supported |
| Octree | By ID Update | Supported | Supported | Not Supported | Not Supported |
| KD Tree | By Range Update | Supported | Supported | Supported | Supported |
| KD Tree | By ID Update | Supported | Supported | Supported | Not Supported |
Parameter Description
| Parameter Name | Parameter Description | Parameter Type |
|---|---|---|
| SCP Path | Input the configuration file of the source tiles (*.scp). The source tiles are S3M tiles generated based on the source model dataset, and parameters such as tile path and tile name must be consistent with when the tiles were generated. | String |
| Model Dataset | Input the model dataset containing all result data. | DatasetVector |
| Update Range (Optional) |
When selecting 'update by dataset range', determine the range of data partial update by specifying the data source and dataset. The spatial range where the dataset is located is the range for tile partial update. |
DatasetVector |
| Update ID (Optional) |
When selecting 'update by specified ID value', input the SMID or business ID of the model objects to be updated in the model dataset AB. Multiple IDs should be separated by commas, for example: 1,2. | String |
| Update Method (Optional) |
Set the data update method, including geometric data and attribute file, geometric data, attribute file.
|
UpdateType |
Output Results
| Parameter Name | Parameter Description | Parameter Type |
|---|---|---|
| Model Tile Partial Update | The storage path of the configuration file for the result tile data. | String |