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
- Initialize Database
- Copy Centerlines
- Prepare Structures
- Prepare Qualifying Areas
- Create Centerline PIR Buffers
- Prepare Roads
Tags
HCA, MCA, centerline, building intended for human occupancy, BIHO, identified site, potential impact radius, PIR.
Credits
Copyright © 2016-2020 by ENRUST Solutions. All Rights Reserved.
Use limitations
There are no access and use limitations for this item.