Prepare Pipe Segment and MAOP Features

Summary

Prepare Pipe Segment and MAOP Features copies your pipeline GIS database pipe segment and Maximum Allowable Operating Pressure (MAOP) features (or records) to the PIPESEGMENT and MAOP tables, respectively, by default, in an existing Gas HCA Tool project database (previously created using the Initialize Database tool). The tool collects the information relevant to subsequent calculation of Potential Impact Radius (PIR) buffers in the Create Centerline PIR Buffers tool in the gas HCA-MCA analysis workflow. The tool also collects pipe data needed for the regulated gathering determination workflow for gas gathering systems.

Usage

  • Input Pipe Segment Features or Records – Typically, your input pipe segment features/records correspond to discrete lengths of pipe with common attributes stored on your pipeline centerlines. Under the Pipeline Open Data Standard (PODS) nomenclature, your pipe segment features/records should consist of PODS PIPE_SEGMENT Under Esri Utility and Pipeline Data Model (UPDM) nomenclature, your pipe segment features/records should consist of UPDM Pipes features from the Transmission Pipe asset group.

Your input pipe segment features/records must contain the following attributes (your field names need not match, but fields containing this information must be present):

      • Input Pipe Segment Route ID Field – This field uniquely identifies the route on which the pipe segment feature occurs. This field will be mapped to and compared with Origin_Route_ID field in CENTERLINE layer.
      • Input Pipe Segment Begin Measure Field – A field that represents the begin measure of the pipe segment.
      • Input Pipe Segment End Measure Field – A field that represents the end measure of the pipe segment.
      • Input Outside Diameter Field – A field that represents the diameter of the pipe segment in inches.
      • Input % Pipe SMYS Field – A field that represents the percentage of pipe Specified Minimum Yield Strength (SMYS) pressure at which the pipe segment operates. This parameter is not used in HCA-MCA determination for transmission pipe, but rather in regulated gathering determination for gathering system pipe.
      • Input Pipe Material Type Metallic Where Clause – An SQL ‘where’ clause expression that allows you to specify which pipe segments are constructed of metallic material (typically steel). This parameter is not used in HCA-MCA determination for transmission pipe, but rather in regulated gathering determination for gathering system pipe.
  • Input MAOP Features or Records – Typically, your input MAOP features/records correspond to discrete lengths of pipe with a common MAOP. Under the Pipeline Open Data Standard (PODS) nomenclature, your MAOP features/records should consist of PODS OPERATING_PRESSURE features of type MAOP. Under Esri Utility and Pipeline Data Model (UPDM) nomenclature, your MAOP values are stored as attributes of UPDM Pipes features in the Transmission Pipe asset group.

Your input MAOP features/records must contain the following attributes (your field names need not match, but fields containing this information must be present):

      • Input MAOP Route ID Field – This field uniquely identifies the route on which the MAOP feature occurs. This field will be mapped to and compared with Origin_Route_ID field in CENTERLINE layer.
      • Input MAOP Begin Measure Field – A field that represents the begin measure of the MAOP feature.
      • Input MAOP End Measure Field – A field that represents the end measure of the MAOP feature.
      • Input Maximum Allowable Operating Pressure (MAOP) Field – A field that stores the MAOP value (in PSI) of the MAOP feature/record.
  • Output Pipe Segment Records – The default destination value for your copied pipe segment features/records is the PIPESEGMENT table in your designated input Gas HCA Tool project geodatabase. However, this parameter allows you to specify an alternate destination and name for the output pipe segment records, if desired.
  • Output MAOP Records – The default destination value for your copied MAOP features/records is the MAOP table in your designated input Gas HCA Tool project geodatabase. However, this parameter allows you to specify an alternate destination and name for the output pipe segment records, if desired.

In a typical HCA-MCA analysis workflow, Prepare Pipe Segment and MAOP Features is typically run after Prepare Structures and Prepare Qualifying Areas, and before Create Centerline PIR Buffers.

Syntax

PreparePipeSegmentMAOPTool_hcapy (project_database, pipeseg_layer, pipeseg_routeid, pipeseg_beginmeas, pipeseg_endmeas, pipe_diameter, {pipeseg_percent_smys}, {pipeseg_metallic_where}, maop_layer, maop_routeid, maop_beginmeas, maop_endmeas, maop_pressure, pipeseg_layer_out, maop_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.

There is no Python reference for this parameter.

Workspace
pipeseg_layer

Dialog Reference

Specify your input pipe segment features/records.

There is no Python reference for this parameter.

Table View
pipeseg_routeid

Dialog Reference

Specify the field that uniquely identifies the centerline segment on which the pipe segment feature/record occurs.

There is no Python reference for this parameter.

Field
pipeseg_beginmeas

Dialog Reference

Specify the field containing the begin measure value of the pipe segment feature/record on the underlying centerline feature.

There is no Python reference for this parameter.

Field
pipeseg_endmeas

Dialog Reference

Specify the field containing the end measure value of the pipe segment feature/record on the underlying centerline feature.

There is no Python reference for this parameter.

Field
pipe_diameter

Dialog Reference

Specify the field that the outside diameter (in inches) of the pipe segment feature/record.

There is no Python reference for this parameter.

Field
pipeseg_percent_smys (Optional)

Dialog Reference

Specify the field containing the percentage of pipe Specified Minimum Yield Strength (SMYS) pressure at which the pipe segment operates.

There is no Python reference for this parameter.

Field
pipeseg_metallic_where (Optional)

Dialog Reference

Specify a SQL ‘where’ clause expression that allows you to define which pipe segments are constructed of metallic material (typically steel).

There is no Python reference for this parameter.

SQL Expression
maop_layer

Dialog Reference

Specify your input MAOP features/records.

There is no Python reference for this parameter.

Table View
maop_routeid

Dialog Reference

Specify the field that uniquely identifies the centerline segment on which the MAOP feature/record occurs.

There is no Python reference for this parameter.

Field
maop_beginmeas

Dialog Reference

Specify the field containing the begin measure value of the MAOP feature/record on the underlying centerline feature.

There is no Python reference for this parameter.

Field
maop_endmeas

Dialog Reference

Specify the field containing the end measure value of the MAOP feature/record on the underlying centerline feature.

There is no Python reference for this parameter.

Field
maop_pressure

Dialog Reference

Specify the field that stores the MAOP value (in PSI) of the MAOP feature/record.

There is no Python reference for this parameter.

Field
pipeseg_layer_out

Dialog Reference

Specify the destination of the output pipe segment records.

There is no Python reference for this parameter.

Table View
maop_layer_out

Dialog Reference

Specify the destination of the output MAOP records.

There is no Python reference for this parameter.

Table View

Code sample

Prepare Pipe Segment and MAOP Features

# Import GasHCA Library
import hcapy
# improt Gas HCA Tools
arcpy.ImportToolbox(“C:\Python27\ArcGIS10.6\Lib\site-packages\hcapy\esri\Toolboxes\Gas HCA Tools.pyt”)
project_database = r”C:\projects\GasHCA_Enhancements\A_DOTCLass_Test5.gdb”
pipeseg_layer = r”C:\projects\GasHCA_Enhancements\Test.gdb\PipeSegment”
pipeseg_routeid = “RouteEventID”
pipeseg_beginmeas = “BEGIN_MEASURE”
pipeseg_endmeas = “END_MEASURE”
pipe_diameter = “Outsidediameter”
maop_layer = r”C:\projects\GasHCA_Enhancements\Test.gdb\PipeSegment”
maop_routeid = “RouteEventID”
maop_beginmeas = “BEGIN_MEASURE”
pipeseg_endmeas = “END_MEASURE”
maop_endmeas = “Outsidediameter”
maop_pressure = “ActualPressure”
# Execute tool
arcpy.PreparePipeSegmentMAOP_hcapy(project_database, pipeseg_layer, pipeseg_routeid, pipeseg_beginmeas, pipeseg_endmeas, pipe_diameter, maop_layer, maop_routeid, maop_beginmeas, maop_endmeas, maop_pressure)

Environments

Current Workspace, Scratch Workspace, Default Output Z Value, M Resolution, M ToleranceOutput M Domain, Output XY Domain, Output Z Domain, Output Coordinate System, Extent, Geographic Transformations, Output has M values, Output has Z values, XY Resolution, XY Tolerance, Z Resolution, Z Tolerance

Licensing information

This tool requires a valid Gas HCA Tool user license or subscription. Please see the Request License and Register License tool help topics for details on obtaining and registering a Gas HCA Tool software license.

Related topics

Tags

HCA, MCA, centerline, pipe segment, diameter, SYMS, maximum allowable operating pressure, MAOP, potential impact radius, PIR.

Credits

Copyright © 2016-2020 by G2 Integrated Solutions, LLC. All Rights Reserved.

Use limitations

There are no access and use limitations for this item.