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.
  • Geometry and Attribute Files: Update the geometry data and attribute files of the data.
  • Geometry Data: Only update the geometry data of the data.
  • Attribute Files: Only update the attribute files of the data.
    If adding new attribute fields, all objects will be updated regardless of whether updating by dataset range or by specified ID value.
UpdateType

Output Result

Parameter Name Parameter Description Parameter Type
Multi-Model Tile Partial Update The storage path of the resulting tile data. String