Prepare Structure and Site Buffers and Segments

Summary

Prepare Structure and Site Buffers and Segments creates buffers for your Buildings Intended for Human Occupancy (BIHO) structure features and qualifying areas/buildings features stored in your Gas HCA Tool project geodatabase, as specified in 49 CFR §192.5 – Class Locations. The tool creates 660-foot buffers for BIHO features and 300-foot buffers for qualifying areas/building features, plus any additional spatial tolerance you choose to add. The tool also generates polyline features representing the intersections of the BIHO and qualifying areas/building buffer polygons with pipeline centerline features stored in your Gas HCA Tool project geodatabase, in preparation for running the Calculate Influence Ranges tool as part of Class Location analysis workflow.

Usage

Inputs to Prepare Structure and Site Buffers and Segments are the following feature classes from your Gas HCA Tool project geodatabase, by default (created in prior steps of the Class Location analysis workflow):

1. Centerline Inputs

  • Input Centerline Features – This tool requires as input the CENTERLINE features output by the Copy Centerlines tool. Unless otherwise specified, the tool defaults this parameter to the CENTERLINE feature class in your selected Gas HCA Tool project geodatabase.
  • Input Centerline Structure Buffer Features – This tool requires as input the 660-foot buffers around your centerline features created by Prepare Centerline Buffers  and used to select the BIHO features processed by this tool. Unless otherwise specified, the tool defaults this parameter to the CENTERLINE_STRUCTURE_BUFFER feature class in your selected Gas HCA Tool project geodatabase.
  • Input Centerline Qualifying Area Buffer Features – This tool requires as input the 300-foot buffers around your centerline features created by Prepare Centerline Buffers and used to select the qualifying area/building features processed by this tool. Unless otherwise specified, the tool defaults this parameter to the CENTERLINE_QUALIFIED_AREA_BUFFER feature class in your selected Gas HCA Tool project geodatabase.

2. Structure Inputs

  • Input Structure Point Features – This tool uses as input any BIHO features you may have stored as points, copied into your Gas HCA Tool project geodatabase by Prepare Structures. Unless otherwise specified, the tool defaults this parameter to the STRUCTURE_POINT feature class in your selected Gas HCA Tool project geodatabase.
  • Input Structure Polygon Features – This tool uses as input any BIHO features you may have stored as polygons, copied into your Gas HCA Tool project geodatabase by Prepare Structures. Unless otherwise specified, the tool defaults this parameter to the STRUCTURE_POLYGON feature class in your selected Gas HCA Tool project geodatabase.

3. Site Inputs

  • Input Qualifying Area Point Features – This tool uses as input any qualifying area/building features you may have stored as points, copied into your Gas HCA Tool project geodatabase by Prepare Qualifying Areas. Unless otherwise specified, the tool defaults this parameter to the QUALIFYING_AREA_POINT feature class in your selected Gas HCA Tool project geodatabase.
  • Input Qualifying Area Polygon Features – This tool uses as input any qualifying area/building features you may have stored as polygons, copied into your Gas HCA Tool project geodatabase by Prepare Qualifying Areas. Unless otherwise specified, the tool defaults this parameter to the QUALIFYING_AREA_POLYGON feature class in your selected Gas HCA Tool project geodatabase.

The Prepare Structure and Site Buffers and Segments tool generates the following output feature classes by default in your Gas HCA Tool project geodatabase:

4. Outputs

  • Output Structure Buffer Features – Unless otherwise specified, the default destination for the output buffer polygons for your BIHO structure features is the STRUCTURE_BUFFER feature class in your selected Gas HCA Tool project geodatabase.
  • Output Site Buffer Features – Unless otherwise specified, the default destination for the output buffer polygons for your qualifying area/building features is the QUALIFYING_AREA_BUFFER feature class in your selected Gas HCA Tool project geodatabase.
  • Output Structure Segment Features – Unless otherwise specified, the default destination for your output structure segment features is the DOT_STRUCTURESEGMENT feature class in your selected Gas HCA Tool project geodatabase. These polyline segments are created by intersecting the PIR buffer polygons for BIHOs and qualifying area/building features with your centerline features.

In a typical Class Location analysis workflow, Prepare Structure and Site Buffers and Segments is run after Prepare Structures and Prepare Qualifying Areas, and before Calculate Influence Ranges tool.

Syntax

PrepareBufferTool_hcapy (project_database, {centerine_layer}, {centerline_structure_buffer_layer}, {centerline_qa_buffer_layer}, {structure_point_layer}, {structure_polygon_layer}, {site_point}, {site_polygon}, {output_structure_buffer}, {output_site_buffer}, {output_structure_segment})

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

centerline_layer

(Optional)

Dialog Reference

Select your input centerline features (previously created by the Copy Centerlines tool).

There is no Python reference for this parameter.

Feature Layer

centerline_structure_buffer_layer

(Optional)

Dialog Reference

Select your input centerline structure buffer features(previously created by the Prepare Centerline Buffers tool).

There is no Python reference for this parameter.

Feature Layer

centerline_qa_buffer_layer

(Optional)

Dialog Reference

Select your input centerline qualifying area/building buffer features (previously created by the Prepare Centerline Buffers tool).

There is no Python reference for this parameter.

Feature Layer

structure_point_layer

(Optional)

Dialog Reference

Select your input BIHO point features (previously created by the Prepare Structures tool).

There is no Python reference for this parameter.

Feature Layer

structure_polygon_layer

(Optional)

Dialog Reference

Select your input BIHO polygon features (previously created by the Prepare Structures tool).

There is no Python reference for this parameter.

Feature Layer

site_point

(Optional)

Dialog Reference

Select your input qualifying area/building point features(previously created by the Prepare Qualifying Areas tool).

There is no Python reference for this parameter.

Feature Layer

site_polygon

(Optional)

Dialog Reference

Select your input qualifying area/building polygon features(previously created by the Prepare Qualifying Areas tool).

There is no Python reference for this parameter.

Feature Layer

output_structure_buffer

(Optional)

Dialog Reference

Specify the destination for your output BIHO structure buffer features.

There is no Python reference for this parameter.

Feature Layer

output_site_buffer

(Optional)

Dialog Reference

Specify the destination for your output qualifying area/building buffer features.

There is no Python reference for this parameter.

Feature Layer

output_structure_segment

(Optional)

Dialog Reference

Specify the destination for your output BIHO structure buffer centerline segment features.

There is no Python reference for this parameter.

Feature Layer

Code sample

Prepare Structure and Site Buffers and Segments

# Import Gas HCA Tools
arcpy.ImportToolbox(“C:\Python27\ArcGIS10.6\Lib\site-packages\hcapy\esri\Toolboxes\Gas HCA Tools.pyt”)
# Initialize required parameters
project_database = r”C:\Users\john_doe\Documents\ArcGIS\A_DOTCLass_Test.gdb”
# Execute tool
arcpy.PrepareStructureSiteBuffer_hcapy(project_database)

 

Environments

Current WorkspaceScratch WorkspaceDefault Output Z ValueM ResolutionM ToleranceOutput M DomainOutput XY DomainOutput Z DomainOutput Coordinate System, ExtentGeographic TransformationsOutput has M valuesOutput has Z valuesXY ResolutionXY ToleranceZ ResolutionZ 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

DOT, HCA.

Credits

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

Use limitations

There are no access and use limitations for this item.