Instructions

Currently, many projects use 3D modeling software such as 3ds Max for tubular well modeling. However, this approach incurs high time and labor costs when constructing large‑volume tubular well models. To address this, the Tubular Well Modeling function provides a method to quickly and batch‑build tubular well models based on raw pipeline data and specified rules.

Before performing tubular well modeling, the name prefix of the raw pipeline data of the same type must be consistent. Taking “Water Supply Pipe” data as an example: “SSG” is the abbreviation of the Chinese name for water supply pipe; “SSG_POINT” represents water supply pipe point data, “SSG_LINE” represents water supply pipe line data, and “SSG_BOUNDLINE” represents water supply pipe region data. Point, line, and region data must contain corresponding attribute fields. Point data records the location, shape, and material of the well; line data records the location of the pipeline; and region data records the range and location of the well chamber. Using the water supply pipe as an example, the parameters for each data type are shown in Table 1 below:

Access

• 3D Geographic Design tab → Model Operations group → Procedural Modeling drop‑down menu → Tube Well Modeling

Steps

1. In the Workspace Manager, open the datasource that contains the original 2D point, line, and region datasets (with a projected coordinate system).
2. Click Tube Well Modeling in the Rule‑Based Modeling group on the 3D Geographic Design tab to open the “Tubular Well Modeling” dialog box. Set the corresponding parameters according to the actual data conditions.
3. Set source datasets: Use the toolbar buttons (Add, Select All, Invert Selection, Delete) to specify the datasets involved in the operation.
   • Add: In the selection dialog that appears, select the 2D point, line, and region datasets to be operated on, then click OK. The data list will display the point dataset, associated line dataset, and associated region dataset. The point, line, and region datasets are associated through the dataset name prefix.
   • Select All: Selects all datasets in the data list.
   • Invert Selection: Selects the datasets that are not currently selected in the data list.
   • Delete: Removes the selected dataset from the current data list.
4. Field mapping settings for tubular well modeling: Use the “Mapping Settings” button on the toolbar to configure the correspondence between attribute field values and modeling rules, thereby standardizing the conversion of attribute values.
   • Mapping Field: Select the field to be mapped from the drop‑down list, including Manhole Cover Shape, Well Material, and Well Identifier.
   • Mapping Rule: Enter the mapping relationship in the format attribute field value = modeling rule. For example, select the “Manhole Cover Shape” field; if this field takes values 0 or 1, you can map it as: 0=Rectangle, 1=Circle. Click Apply, the system will save the current mapping and display it in the rule preview box.
   • After completing the settings, click OK to finish the mapping configuration.
5. Set basic parameters:
   • Well Identifier (required): Sets the type of well, for example, gully well, inspection well, valve well, etc. This can be used to distinguish the type of texture image applied to the manhole cover model. Set it by selecting an attribute field in the point dataset; the field type is wide character. If this attribute is empty, the point is not considered a well.
   • Elevation (required): The elevation of the highest point of the well, i.e., the elevation of the manhole cover center point, in meters. Set it by selecting an attribute field in the point dataset; the field type is double‑precision.
   • Well Depth (required): The total depth of the well, i.e., the vertical distance from the top of the manhole cover to the bottom of the well chamber, in meters. Set it by selecting an attribute field in the point dataset; the field type is double‑precision.
   • Neck Depth (required): The height of the well neck, in meters. Set it by selecting an attribute field in the point dataset; the field type is double‑precision.
   • Material Folder Path (required): Specifies the path to the texture images required for constructing the tubular well model.
     Note:

     When modeling, the system searches for the texture image of the manhole cover model in the “Material Folder Path” based on the manhole cover shape attribute value and the well identifier attribute value. To ensure modeling quality, it is recommended that the texture image names for the manhole cover follow these rules:

     1. For covers that do not distinguish shape, the texture image name should match the well identifier name, e.g., “Rainwater Well”.
     2. For covers that distinguish shape, the texture image name format is: Cover Shape_Well Identifier. The specific rules are as follows:
        • When the manhole cover size (shape) field value is Rectangle, Circle, or Square, the texture image name should be like Rectangle_Rainwater Well or Circle_Rainwater Well.
        • When the manhole cover size (shape) field value is a number, number*number, numberXnumber, or numberxnumber, the texture image name is the shape corresponding to the number_Well Identifier, e.g., 1200*2700, the texture image name should be Rectangle_Rainwater Well.
   • Target Datasource: Sets the datasource where the result dataset will be saved, either by creating a new datasource or selecting an existing one.
6. Set manhole cover parameter fields:
   • Unit Setting (optional): Select the unit corresponding to the manhole cover parameter field values (excluding rotation angle) from the drop‑down list, including mm, cm, dm, m, in, ft. The default is mm.
   • Manhole Cover Size (Shape) (required): Sets the manhole cover shape. Set it by selecting an attribute field in the point dataset; the field type is wide character. The attribute field value can be “Rectangle”, “Square”, “Circle”, “0”, “1”, or a number, number*number, numberXnumber, numberxnumber.
     • When the field value is “Rectangle”, “Square”, or “0”, you need to set the cover length and cover width parameters; a rectangular manhole cover will be constructed.
     • When the field value is “Circle” or “1”, you need to set the cover diameter; a circular manhole cover will be constructed.
     • When the field value is a single number, e.g., 700, with the unit set to mm, a circular manhole cover with a diameter of 700 mm will be constructed.
     • When the field value is number*number, numberXnumber, or numberxnumber, e.g., 2700X1200, with the unit set to mm, a rectangular manhole cover with a length of 2700 mm and a width of 1200 mm will be constructed.
   • Cover Length (conditionally required): When the manhole cover shape is rectangular, you need to set the cover length. Set it by selecting an attribute field in the point dataset; the field type is double‑precision.
   • Cover Width (conditionally required): When the manhole cover shape is rectangular, you need to set the cover width. Set it by selecting an attribute field in the point dataset; the field type is double‑precision.
     The relationship between the width and height of the cover material image and the cover length and width parameters is shown in the figure below.
     
   • Rotation Angle (conditionally required): When the manhole cover shape is rectangular, you need to set the rotation angle of the cover (rotating counterclockwise around the cover center, with true north as the 0‑degree reference direction), in degrees. Set it by selecting an attribute field in the point dataset; the field type is double‑precision.
     
   • Cover Diameter (conditionally required): When the manhole cover shape is circular, you need to set the cover diameter. Set it by selecting an attribute field in the point dataset; the field type is double‑precision.
     
7. Set well parameter fields:
   • Unit Setting (optional): Select the unit corresponding to well parameter field values such as chamber size (diameter), chamber length, chamber width, well thickness, and bottom groove diameter from the drop‑down list, including mm, cm, dm, m, in, ft. The default is mm.
   • Chamber Surface Association ID (required): Set it by selecting an attribute field that exists in both the point dataset and the region dataset with the same name; the field type is wide character. The figure below shows the chamber surface association ID in the attributes of the point and region datasets. The system first retrieves the corresponding field value from the point dataset, then finds the same field value in the corresponding region dataset, and uses the region associated with that value as the cross‑section of the well chamber.
     
   • Chamber Size (Diameter) (required): Sets the size of the well chamber cross‑section. Set it by selecting an attribute field in the point dataset; the field type is wide character. The attribute field value can be expressed as a number, number*number, numberXnumber, or numberxnumber.
     • For the same well chamber, the Chamber Size (Diameter) parameter is mutually exclusive with the Chamber Length and Chamber Width parameters.
     • When the Chamber Size (Diameter) attribute value is in the form of a number, it indicates that the well chamber cross‑section shape is circular, and the attribute value is the diameter of the circle.
     • When the Chamber Size (Diameter) attribute value is in the form of number*number, numberXnumber, or numberxnumber, it indicates that the well chamber cross‑section shape is rectangular, and the attribute value is the length and width of the rectangle.
   • Chamber Length (required): Sets the length of the well chamber cross‑section. Set it by selecting an attribute field in the point dataset; the field type is double‑precision.
   • Chamber Width (required): Sets the width of the well chamber cross‑section. Set it by selecting an attribute field in the point dataset; the field type is double‑precision.
   • Rotation Angle (required): When the well chamber cross‑section shape is rectangular, you need to set the rotation angle of the chamber (rotating counterclockwise around the chamber center, with true north as the 0‑degree reference direction), in degrees. Set it by selecting an attribute field in the point dataset; the field type is double‑precision.
   • Well Material (conditionally required): When the Well Identifier field in the point dataset has a value, you need to set the well material. Set it by selecting an attribute field in the point dataset; the field type is wide character. For example, if the specified field value is “Brick”, the system will look for a texture image file named “Brick.jpg” (or other supported formats) in the specified Material Folder Path and apply it as the texture for the well chamber model.
   • Well Thickness (optional): Sets the thickness of the tubular well wall. Set it by selecting an attribute field in the point dataset; the field type is double‑precision or text.
   • Bottom Groove Diameter (optional): The bottom groove is a “U‑shaped” structure built into the well bottom for purposes such as material transfer, sewage discharge, and drainage. Set this parameter when you need to construct a groove at the bottom of the tubular well. Set it by selecting an attribute field in the point dataset; the field type is double‑precision or text.
   • Chamber Code (required): Select an attribute field in the point dataset that identifies the type of well chamber; the field type is wide character. The value of this field is used to determine whether the chamber belongs to a “multi‑well chamber” or a “single‑well chamber”.
   • Chamber Code Identifier (required): Specify the specific value in the “Chamber Code” field that represents a “multi‑well chamber”. If the value of the selected field equals this identifier value, the chamber is processed as a multi‑well chamber (the chamber and the well are treated as connected); otherwise, it is treated as a single‑well chamber. The default identifier value for a multi‑well chamber is 202.
8. After completing the settings, click OK to execute the operation. The system will construct the corresponding tubular well models based on the point and region datasets with the same name. For example, SSG_POINT and SSG_BOUNDLINE together form SSG_TubeWell; then, based on the elevation information in the 2D line attributes, the 2D lines are converted to 3D lines (e.g., SSG_LINE becomes SSG_LINE3D). The composition of a tubular well model is shown in the figure below: 1 represents the manhole cover, 2 represents the well neck, 3 represents the well chamber, and 4 represents the entire tubular well.
   
9. Additionally, some tubular wells may have auxiliary structures such as grooves, as shown below: