Summary
Imports point data from a source point feature class into the parcel fabric points feature class. Parcel fabric points that match or lie within a proximity tolerance of the source points will be updated with the imported point data. If the source points layer has a selection, only the selected point information will be imported.
Parcel fabric points can be updated in the following ways:
- Points can be retired and new points can be created with updated information from the imported points.
- Points can be updated with attribute information from the source points. The existing parcel fabric points still remain active (nonhistoric).
If the source and target parcel fabric points meet the search criteria, and if the source point feature class has z-values, the shape x,y,z coordinates of the parcel fabric points are updated. If the source point feature class does not have z-values, only the shape x,y coordinates of the parcel fabric points are updated and the existing z-values remain unchanged. When the shape x,y coordinates of parcel fabric points are updated, connected parcel lines and polygons are updated to match the new coordinate locations.
When points are created, they can be optionally assigned to a new or existing parcel record.
Usage
This tool will modify data in the target parcel fabric. Parcel fabric point attribute values may be changed. Parcel fabric point, line, and polygon geometries may be changed. The tool will not delete parcel fabric features.
The search distance is applied by comparing the shape x,y coordinates of the source points with the shape x,y coordinates of the parcel fabric points. The search distance ignores z-values.
The tool can update both the attributes and geometry (shape coordinates), or only geometry of parcel fabric points. If attributes are updated, parcel fabric point fields that match fields in the source points feature class will be updated with the source point attribute values.
If the spatial references of the source point feature class and target parcel fabric do not match, the tool will project the source point feature class to the coordinate system used by the target parcel fabric. If the geographic datums of the spatial references of the source point feature class and target parcel fabric do not match, a geographic transformation must be performed on the source point feature class to match the geographic datum of the target parcel fabric before running the tool.
If more than one parcel fabric point is found within the proximity tolerance of a source point, a conflict will be reported as a warning message. You can optionally report conflicts in a conflicts table. If a conflicts table is specified for the Conflicts Table parameter, the Object IDs of the source point and parcel fabric points are stored in the table.
Imported points will be assigned to the record specified in the Record Name parameter. If the record does not already exist, a record will be created with the specified name.
New points will be imported to retire existing parcel fabric points, imported to an empty parcel fabric, or imported to an area where points don't exist. When importing new points to retire existing points, use the Update Type parameter's Retire and replace option. Existing points will be retired by the record specified in the Record Name parameter.
Syntax
arcpy.parcel.ImportParcelFabricPoints(source_points, target_parcel_fabric, match_point_method, {search_distance}, update_type, {record_name}, {match_field}, {conflicts_table})
Parameter | Explanation | Data Type |
source_points | The source point feature class that will be used to update points in the target parcel fabric. | Feature Layer |
target_parcel_fabric | The target parcel fabric containing the points that will be updated. The target parcel fabric can be from a file geodatabase, an enterprise geodatabase connected to the default version, or a feature service. | Parcel Layer |
match_point_method | Specifies the method that will be used to find parcel fabric points that match the source points.
| String |
search_distance (Optional) | The distance that will be used to search for parcel fabric points that lie within the proximity of source points. If a parcel fabric point is found within the search distance of a source point, the points will be matched and the parcel fabric point will be updated. | Linear Unit |
update_type | Specifies the type of update that will be applied to parcel fabric points that match source points.
| String |
record_name (Optional) | The name of the record that will be associated with the new imported points. If the record already exists in the target parcel fabric, the new points are associated with the record. If the record does not exist, a record will be created. If new points replace existing points, and Update Type is set to Retire and replace (update_type = RETIRE_AND_REPLACE in Python), the record will be used to retire the points as historic. | String |
match_field (Optional) | The field that will be used to match source points to parcel fabric points when Name and proximity (NAME_AND_PROXIMITY in Python) or Global ID and proximity (GLOBALID_AND_PROXIMITY in Python) is used for the Match Point Method (match_point_method in Python) parameter. When searching by name, the field in the source point feature class should be of type Text. When searching by Global ID, the field in the source point feature class should be of type GUID. | Field |
conflicts_table (Optional) | The path and name of the output table that will store conflicts. If more than one parcel fabric point is found within the search tolerance of a source point, the object IDs of the source points and parcel fabric points will be reported in the conflicts table. | Table |
Derived Output
Name | Explanation | Data Type |
updated_parcel_fabric | The updated parcel fabric. | Parcel Layer |
Code sample
The following Python window script demonstrates how to use the ImportParcelFabricPoints tool to import points to a parcel fabric in immediate mode.
import arcpy
arcpy.parcel.ImportParcelFabricPoints(
"C:/Parcels/Database.gdb/UpdatePoints",
"C:/Parcels/Database.gdb/County/CountyFabric", 'PROXIMITY', '0.1 Feet',
'ALL', 'Record001', None, "C:/Parcels/Database.gdb/ConflictsTable")
Environments
Licensing information
- Basic: No
- Standard: Yes
- Advanced: Yes