Multi-Model Tile Partial Update
Usage Instructions
For S3M tile data generated by merging multiple model data, this tool supports partial updates of tile data by "specified update range" or "specified business ID" method, enabling on-demand updates for data such as detailed urban 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 (such as tile path, name, insertion point, side length, type, etc.), otherwise it may cause failure.
- Data Preparation:
- Source S3M Tile Data: The target tiles to be updated.
- Updated Source Model Dataset: Contains the latest state of the updated model objects. The model dataset name must exactly match the name recorded in the layerName tag of the original tile's attribute.json file. It also supports inputting new model datasets for incremental updates. Avoid any operations that may change the existing objects' SMID (such as data source compression, etc.) for this dataset.
- Update Range Dataset (Optional): Required when selecting the "Update by Range" method, used to specify one or more discontinuous update areas.
- Update methods include updating by specified range or by specified business SMID/ID (when generating the source tile, the 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 locates the corresponding parts in the original tiles based on the specified range or ID list, deletes them, and then writes 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 include the added model objects or a new model dataset, and the update range or ID corresponds to the spatial range or ID of 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 corresponds to the spatial range of 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. The update range or ID corresponds to the spatial range or ID of the modified objects.
- Update Attributes: The input model dataset for the operation must modify the attribute information of certain objects. The update range or ID corresponds to the spatial range or ID of the modified objects.
- There is no limit to the number of updates.
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 (*.scp) of the source model tiles. | String |
Model Dataset: | Input the model dataset to be operated. The name of the model dataset to be operated must match the original model dataset name and include all model objects, providing the data basis for partial updates. | DatasetVector |
Update by Dataset Range (Optional) |
Set the data update method. If checked, update data by specified data range; otherwise, update data by specified object ID. | Boolean |
Update Range: (Optional) |
When selecting "Update by Dataset Range," determine the partial update range by specifying the data source and dataset. The spatial range of the specified dataset is the range for partial data updates. |
DatasetVector |
Business ID: (Optional) |
When selecting "Update by Specified ID Value," determine the update objects by setting business ID numbers, separated by commas. For example: Phase1, Phase2. If no business ID is set, SMID is used as the update basis by default. | String |
Update Method: (Optional) |
Set the data update method. Options include Geometry and Attribute Files, Attribute Files, Geometry Data.
|
UpdateType |
Output Result
Parameter Name | Parameter Description | Parameter Type |
---|---|---|
Multi-Model Tile Partial Update | The storage path of the resulting tile data. | String |