Skip to main content

Append Calibration Points (Linear Referencing Tools)

Summary

Appends calibration points from an input point layer into an LRS calibration point feature class. Routes associated with the appended calibration points are recalibrated after the appending process is complete.

Note:

When the target layer is a feature service layer, the validation results will be written to a file in the ArcGIS Server directory. By default, this file will be automatically cleaned up after 10 minutes, which may not be enough time to process all of the validations and write them to the workstation that is running ArcGIS Pro. For larger data loads, it is recommended that you adjust the maximum file age to at least one hour. You can edit a server directory in ArcGIS Server Manager to adjust this setting.

Usage

  • Use this tool to append calibration points during initial data loading or subsequent bulk calibration point data migration.

  • An LRS dataset is required to run this tool.

    Learn more about creating an LRS dataset in ArcGIS Linear Referencing

  • This tool supports data from a file geodatabase, an enterprise geodatabase (branch versioned connection), or a feature service (published from branch versioned data).

  • The following are the requirements for the source calibration points:

    • The measure, start date, and route ID fields in the source calibration point feature class must be populated with valid values. When the field names for these fields are different from those in the target calibration point feature class, map the fields using the Field Mapping parameter.

    • The measure values must be monotonic and within the route's measure range.

    • The start and end dates must be within the route's date range.

    • The route ID attribute must exist in the target LRS Network.

    • The source calibration points must be located on or within the x-, y-, and z-tolerance of the route.

    • The source calibration point feature class must be z-enabled and cannot be m-enabled.

    • The coordinate system, along with the field type and length of the measure, start date, end date, and route ID fields, must adhere to the requirements outlined in the LRS data model.

  • This tool supports partial loading of calibration points. The following are supported:

    • Valid source calibration points will be appended to the target calibration point feature class, even if certain source calibration points fail validation.

    • The tool performs validation on each source calibration point. Any calibration point that fails validation will not be appended to the target calibration point feature class.

    • The tool will provide a feature class that contains source calibration points that fail validation. You can use the information in the APPEND_STATUS field to fix the problematic source calibration points.

    Note:

    The feature class that is created is temporary and is deleted when ArcGIS Pro is closed. To make a copy of the feature class, right-click the layer in the Contents pane and click Data > Export Features, or use the Export Features tool.

  • If conflict prevention is enabled, source calibration points that are located on a locked route will fail validation and will not be appended to the target calibration point feature class.

  • This tool does not update derived networks and events. If the LRS contains derived networks and events, run the Generate Routes, Apply Event Behaviors, and Derive Event Measures tools in sequential order after running this tool.

Parameters

Label Explanation Data type

Source Calibration Points

The source calibration points that will be appended.

Feature Layer

Target Calibration Points

The calibration point feature layer to which the source calibration points will be appended.

Feature Layer

LRS Network

The LRS Network whose routes will be recalibrated after the appending process is complete.

Feature Layer

Field Mapping

Controls how attribute information in the source calibration point fields will be transferred to the target calibration point feature layer. Fields cannot be added to or removed from the target calibration point feature layer because it has a predefined schema. The Network ID field is excluded from the field mapping.

Field Mappings

Derived output

Label Explanation Data type

Output Calibration Points

The updated calibration point feature layer.

Feature Layer

Output Network Feature Class

The updated LRS Network feature layer.

Feature Layer

Skipped Calibration Points

The feature class that contains source calibration points that fail validation.

Feature Class

Output Details File

The text file that details changes made by the tool.

Text File

Environments

Current Workspace

Licensing information

  • Basic: Requires ArcGIS Linear Referencing
  • Standard: Requires ArcGIS Linear Referencing
  • Advanced: Requires ArcGIS Linear Referencing