Create Structure and Site PIR Buffers

Summary

Create Structure and Site PIR Buffers buffers your Buildings Intended for Human Occupancy (BIHO) and identified site features in preparation for HCA-MCA analysis by method 2, per 49 CFR §192.903(2). The tool selects BIHOs and identified sites that fall within the centerline PIR segment buffer features generated by the Create Centerline PIR Buffers, and then creates buffer polygons around those BIHO and identified site features using the PIR value of the selecting centerline PIR segment buffer feature.

Usage

  • Input Centerline Features – This tool requires as input the centerline features output by the Copy Centerlines Unless otherwise specified, the tool defaults this parameter to the CENTERLINE feature class in your selected Gas HCA Tool project geodatabase.
  • 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.
  • Identified Site Point Features – This tool uses as input any identified site 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. (Note that the same tool is used to process qualifying areas/buildings for Class Location analysis, and the default feature class for storing these features is also the same.)
  • Identified Site 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. (Note that the same tool is used to process qualifying areas/buildings for Class Location analysis, and the default feature class for storing these features is also the same.)
  • Calculation Type – This parameter enables you to specify HCA-MCA calculation method. (The same method should be applied to all tools in a given HCA-MCA analysis workflow.) The Gas HCA Tool supports both method 1 and method 2 HCA-MCA calculations, as defined by 49 CFR §192.903(1) and (2), respectively.
  • Output Structure and Site PIR Segment Features – Unless otherwise specified, the default destination for your output BIHO and identified site PIR segment features is the HCA_STRUCTURESEGMENT feature class in your selected Gas HCA Tool project geodatabase. These polyline segments are created by intersecting the buffer polygons for BIHOs and identified sites with your centerline features.
  • Output Structure and Site PIR Buffer Features – Unless otherwise specified, the default destination for the output PIR buffer polygons for your BIHO and identified site features is the HCA_STRUCTUREBUFFER feature class in your selected Gas HCA Tool project geodatabase.

In a typical HCA–MCA analysis workflow, Create Structure and Site PIR Buffers is run after Create Centerline PIR Buffers and before Prepare Roads.

Syntax

StructSitePIRTool_hcapy (project_database, {centerline_layer}, {structure_point_layer}, {structure_polygon_layer}, {site_point}, {site_polygon}, {tool_type}, {pir_segment_out}, {pir_buffer_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

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

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 identified site 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 identified site polygon features(previously created by the Prepare Qualifying Areas tool).

There is no Python reference for this parameter.

Feature Layer

tool_type

(Optional)

Dialog Reference

Select the calculation type. HCA Method 1 is the default value.

There is no Python reference for this parameter.

String

pir_segment_out

(Optional)

Dialog Reference

Specify the destination for your output BIHO and identified site PIR segment features.

There is no Python reference for this parameter.

Feature Layer

pir_buffer_out

(Optional)

Dialog Reference

Specify the destination for your output BIHO and identified site PIR buffer polygon features.

There is no Python reference for this parameter.

Feature Layer

Code sample

Create Structure and Site PIR Buffers

# 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”)

# Execute tool

arcpy.StructSitePIR_hcapy(project_database)

Environments

Current Workspace, Scratch Workspace, Default Output Z Value, M Resolution, M Tolerance, Output 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, building intended for human occupancy, BIHO, identified site, potential impact radius, PIR.

Credits

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

Use limitations

There are no access and use limitations for this item.