TIME AWARE CLASS LOCATION CALCULATION

Summary

Time Aware Class Location Calculation calculates ‘time aware’ Class Location ranges by dynamically segmenting the output of the Class Location Calculation tool with Class Location ranges from a prior analysis, with the output time aware Class Location range features segmented by determination date. The time aware Class Location range features also store original Class Location and previous Class Location values, which can be useful in support of Maximum Allowable Operating Pressure (MAOP) determinations per 49 CFR §192.611 – Change in Class Location: Confirmation or Revision of Maximum Allowable Operating Pressure.

Usage

Inputs to Time Aware Class Location Calculation include your clustered and unclustered Class Location units from the current Class Location analysis performed using the Class Location Calculation tool and stored in the input Gas HCA Tool project geodatabase. The tool also allows you to specify clustered and unclustered inputs for both original and prior Class Location determinations. Note that the inputs for original and previous clustered and unclustered Class Location data are optional. The tool uses the inputs you provide to generate outputs as appropriate.

Input Current Clustered Class Location Features – This tool uses as input the clustered Class Location features created by a current Class Location analysis using the Class Location Calculation tool. Unless otherwise specified, the tool defaults this parameter to the DOT_CLASS_RANGE_CLUSTERED feature class in your selected Gas HCA Tool project geodatabase.
Input Current Unclustered Class Location Features – This tool uses as input the clustered Class Location features created by a current Class Location analysis using the Class Location Calculation tool. Unless otherwise specified, the tool defaults this parameter to the DOT_CLASS_RANGE_CLUSTERED feature class in your selected Gas HCA Tool project geodatabase.

1. Original Clustered Class Location Inputs

Input Original Clustered Class Location Features – This tool uses as input the original clustered Class Location units for the pipelines in your system. Original Class Location units are calculated at the time a pipeline enters service and should be treated as ‘for the life of the pipe’ records for the pipeline. The tool assumes that your original clustered Class Location units are the result of previous Class Location analyses performed using the Class Location Calculation tool, or an equivalent tool. There is no default value for this parameter. You may use any features or records that conform to the minimum data requirements of the DOT_CLASS_RANGE_CLUSTERED feature class in the standard Gas HCA Tool project geodatabase schema. You may use existing clustered Class Location range features or records from your pipeline database. Your input original clustered Class Location range features/records must contain the following attribution for the tool to run:
- - Original Clustered Class Location Centerline Identifier Field – A field that uniquely identifies the centerline feature on which each original clustered Class Location range feature/record occurs. This field will be mapped to and compared with ORIGINAL_ROUTE_ID field in the centerline features stored in the Gas HCA Tool project geodatabase (in the CENTERLINE feature class, by default). When using a data source that conforms to the DOT_CLASS_RANGE_CLUSTERED schema, this parameter defaults to the BEGIN_MEASURE field.
  - Original Clustered Class Location Begin Measure Field – A field that defines the begin measure values of your original clustered Class Location range features/records. When using a data source that conforms to the DOT_CLASS_RANGE_CLUSTERED schema, this parameter defaults to the BEGIN_MEASURE field.
  - Original Clustered Class Location End Measure Field – A field that defines the end measure values of your original clustered Class Location range features/records. When using a data source that conforms to the DOT_CLASS_RANGE_CLUSTERED schema, this parameter defaults to the END_MEASURE field.
  - Original Clustered Class Location Field – A field that defines the Class Location values of your original clustered Class Location range features/records. When using a data source that conforms to the DOT_CLASS_RANGE_CLUSTERED schema, this parameter defaults to the DOT_CLASS field.
  - Original Clustered Class Location Determination Date Field – A field that stores the determination date of your original clustered Class Location range features/records. When using a data source that conforms to the DOT_CLASS_RANGE_CLUSTERED schema, this parameter defaults to the DETERMINATION_DATE field.

2. Previous Clustered Class Location Inputs

Input Previous Clustered Class Location Features – This tool uses as input the clustered Class Location range features created by a previous Class Location analysis performed using the Class Location Calculation tool, or an equivalent tool. There is no default value for this parameter. You may use the DOT_CLASS_RANGE_CLUSTERED feature class from a Gas HCA Tool project geodatabase created for a prior Class Location analysis, or you may use existing clustered Class Location range features or records from your pipeline database. Your input previous clustered Class Location range features/records must contain the following attribution for the tool to run:
- - Previous Clustered Class Location Centerline Identifier Field – A field that uniquely identifies the centerline feature on which each previous clustered Class Location range feature/record occurs. This field will be mapped to and compared with the ORIGINAL_ROUTE_ID field in the centerline features stored in the Gas HCA Tool project geodatabase (in the CENTERLINE feature class, by default). When using a data source that conforms to the DOT_CLASS_RANGE_CLUSTERED schema, this parameter defaults to the BEGIN_MEASURE field.
  - Previous Clustered Class Location Begin Measure Field – A field that defines the begin measure values of your previous clustered Class Location range features/records. When using a data source that conforms to the DOT_CLASS_RANGE_CLUSTERED schema, this parameter defaults to the BEGIN_MEASURE field.
  - Previous Clustered Class Location End Measure Field – A field that defines the end measure values of your previous clustered Class Location range features/records. When using a data source that conforms to the DOT_CLASS_RANGE_CLUSTERED schema, this parameter defaults to the END_MEASURE field.
  - Previous Clustered Class Location Field – A field that defines the Class Location values of your previous clustered Class Location range features/records. When using a data source that conforms to the DOT_CLASS_RANGE_CLUSTERED schema, this parameter defaults to the DOT_CLASS field.
  - Previous Clustered Class Location Determination Date Field – A field that stores the determination date of your previous clustered Class Location range features/records. When using a data source that conforms to the DOT_CLASS_RANGE_CLUSTERED schema, this parameter defaults to the DETERMINATION_DATE field.

3. Original Unclustered Class Location Inputs

Input Original Unclustered Class Location Features – This tool uses as input the original unclustered Class Location units for the pipelines in your system. Original Class Location units are calculated at the time a pipeline enters service and should be treated as ‘for the life of the pipe’ records for the pipeline. The tool assumes that your original unclustered Class Location units are the result of previous Class Location analyses performed using the Class Location Calculation tool, or an equivalent tool. There is no default value for this parameter. You may use any features or records that conform to the minimum data requirements of the DOT_CLASS_RANGE_UNCLUSTERED feature class in the standard Gas HCA Tool project geodatabase schema. You may use existing unclustered Class Location range features or records from your pipeline database. Your input original unclustered Class Location range features/records must contain the following attribution for the tool to run:
- - Original Unclustered Class Location Centerline Identifier Field – A field that uniquely identifies the centerline feature on which each original unclustered Class Location range feature/record occurs. This field will be mapped to and compared with ORIGINAL_ROUTE_ID field in the centerline features stored in the Gas HCA Tool project geodatabase (in the CENTERLINE feature class, by default). When using a data source that conforms to the DOT_CLASS_RANGE_UNCLUSTERED schema, this parameter defaults to the BEGIN_MEASURE field.
  - Original Unclustered Class Location Begin Measure Field – A field that defines the begin measure values of your original unclustered Class Location range features/records. When using a data source that conforms to the DOT_CLASS_RANGE_UNCLUSTERED schema, this parameter defaults to the BEGIN_MEASURE field.
  - Original Unclustered Class Location End Measure Field – A field that defines the end measure values of your original unclustered Class Location range features/records. When using a data source that conforms to the DOT_CLASS_RANGE_CLUSTERED schema, this parameter defaults to the END_MEASURE field.
  - Original Unclustered Class Location Field – A field that defines the Class Location values of your original unclustered Class Location range features/records. When using a data source that conforms to the DOT_CLASS_RANGE_UNCLUSTERED schema, this parameter defaults to the DOT_CLASS field.
  - Original Unclustered Class Location Determination Date Field – A field that stores the determination date of your original unclustered Class Location range features/records. When using a data source that conforms to the DOT_CLASS_RANGE_UNCLUSTERED schema, this parameter defaults to the DETERMINATION_DATE field.

4. Previous Unclustered Class Location Inputs

Input Previous Unclustered Class Location Features – This tool uses as input the unclustered Class Location range features created by a previous Class Location analysis performed using the Class Location Calculation tool, or an equivalent tool. There is no default value for this parameter. You may use the DOT_CLASS_RANGE_UNCLUSTERED feature class from a Gas HCA Tool project geodatabase created for a prior Class Location analysis, or you may use existing unclustered Class Location range features or records from your pipeline database. Your input previous unclustered Class Location range features/records must contain the following attribution for the tool to run:
- - Previous Unclustered Class Location Centerline Identifier Field – A field that uniquely identifies the centerline feature on which each previous unclustered Class Location range feature/record occurs. This field will be mapped to and compared with ORIGINAL_ROUTE_ID field in the centerline features stored in the Gas HCA Tool project geodatabase (in the CENTERLINE feature class, by default). When using a data source that conforms to the DOT_CLASS_RANGE_UNCLUSTERED schema, this parameter defaults to the BEGIN_MEASURE field.
  - Previous Unclustered Class Location Begin Measure Field – A field that defines the begin measure values of your previous unclustered Class Location range features/records. When using a data source that conforms to the DOT_CLASS_RANGE_UNCLUSTERED schema, this parameter defaults to the BEGIN_MEASURE field.
  - Previous Unclustered Class Location End Measure Field – A field that defines the end measure values of your previous unclustered Class Location range features/records. When using a data source that conforms to the DOT_CLASS_RANGE_UNCLUSTERED schema, this parameter defaults to the END_MEASURE field.
  - Previous Unclustered Class Location Field – A field that defines the Class Location values of your previous unclustered Class Location range features/records. When using a data source that conforms to the DOT_CLASS_RANGE_UNCLUSTERED schema, this parameter defaults to the DOT_CLASS field.
  - Previous Unclustered Class Location Determination Date Field – A field that stores the determination date of your previous unclustered Class Location range features/records. When using a data source that conforms to the DOT_CLASS_RANGE_UNCLUSTERED schema, this parameter defaults to the DETERMINATION_DATE field.

5. Outputs

Output Time Aware Clustered Class Location Features – This parameter defines the destination of the output time aware clustered Class Location range features. Unless otherwise specified, the default destination for the output time aware clustered Class Location range features is the DOT_CLASS_RANGE_CLUSTERED_TAfeature class in your selected Gas HCA Tool project geodatabase.
Output Time Aware Unclustered Class Location Features – This parameter defines the destination of the output time aware unclustered Class Location range features. Unless otherwise specified, the default destination for the output time aware unclustered Class Location range features is the DOT_CLASS_RANGE_UNCLUSTERED_TA feature class in your selected Gas HCA Tool project geodatabase.
Output Original Clustered Class Location Range Features – This parameter defines the output destination for your copied original clustered Class Location range features. Unless otherwise specified, the default destination for the original clustered Class Location range features is the DOT_CLASS_RANGE_CLUSTERED_ORIG feature class in your selected Gas HCA Tool project geodatabase.
Output Original Unclustered Class Location Range Features – This parameter defines the output destination for your copied original unclustered Class Location range features. Unless otherwise specified, the default destination for the original unclustered Class Location range features is the DOT_CLASS_RANGE_UNCLUSTERED_ORIG feature class in your selected Gas HCA Tool project geodatabase.
Output Previous Clustered Class Location Range Features – This parameter defines the output destination for your copied previous clustered Class Location range features. Unless otherwise specified, the default destination for the previous clustered Class Location range features is the DOT_CLASS_RANGE_CLUSTERED_H feature class in your selected Gas HCA Tool project geodatabase.
Output Previous Unclustered Class Location Range Features – This parameter defines the output destination for your copied previous unclustered Class Location range features. Unless otherwise specified, the default destination for the previous unclustered Class Location range features is the DOT_CLASS_RANGE_UNCLUSTERED_H feature class in your selected Gas HCA Tool project geodatabase.

Syntax

GenerateDOTClassTimeAware_hcapy (project_database, {current_clustered_dot_class_layer}, {current_unclustered_dot_class_layer}, {original_clustered_dotclass_layer}, {original_clustered_dotclass_route_id}, {original_clustered_dotclass_begin_measure}, {original_clustered_dotclass_end_measure}, {original_clustered_dotclass_class}, {original_clustered_dotclass_determination_date}, {previous_clustered_dotclass_layer}, {previous_clustered_dotclass_route_id}, {previous_clustered_dotclass_begin_measure}, {previous_clustered_dotclass_end_measure}, {previous_clustered_dotclass_class}, {previous_clustered_dotclass_determination_date}, {original_unclustered_dotclass_layer}, {original_unclustered_dotclass_route_id}, {original_unclustered_dotclass_begin_measure}, {original_unclustered_dotclass_end_measure}, {original_unclustered_dotclass_class}, {original_unclustered_dotclass_determination_date}, {previous_unclustered_dotclass_layer}, {previous_unclustered_dotclass_route_id}, {previous_unclustered_dotclass_begin_measure}, {previous_unclustered_dotclass_end_measure}, {previous_unclustered_dotclass_class}, {previous_unclustered_dotclass_determination_date}, {clustered_ta_layer_out}, {unclustered_ta_layer_out}, {clustered_dot_class_original_layer_out}, {unclustered_dot_class_original_layer_out}}, {clustered_dot_class_history_layer_out}, {unclustered_dot_class_history_layer_out})

Parameter

Explanation

Data Type

project_database

Dialog Reference

Select a Gas HCA Tool project geodatabase created using the Initialize Database tool. The output from this tool is stored in this workspace, by default.