Generate Sliding Ranges

Summary

Generate Sliding Ranges calculates your 1-mile ‘sliding ranges’ for Buildings Intended for Human Occupancy (BIHO) features in preparation for Class Location calculations, as specified in 49 CFR §192.5 – Class Locations. The tool also outputs ‘raw’ Class Location unit ranges based solely on ‘sliding mile’ BIHO counts (without considering Class 3 location units based on the presence of qualifying areas/buildings, or Class 4 location units based on the prevalence of 4-story and higher buildings). It does so by dynamically segmenting BIHO influence ranges and their associated sliding mile segments (in both the down-measure and up-measure direction on the centerline) and summing the counts of overlaps.

See How Generate Sliding Ranges works to learn more about how the tool generates raw Class Location unit ranges.

Usage

  • 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 Influence Range Features – This tool requires as input the DOT_BIHO_INFLUENCE_RANGE features output by the Calculate Influence Ranges tool. Unless otherwise specified, the tool defaults this parameter to the DOT_BIHO_INFLUENCE_RANGE feature class in your selected Gas HCA Tool project geodatabase.
  • Sliding Range Distance (in Feet) –This parameter allows you to specify the length of your sliding ranges, as measured (in feet) along the centerline from the ends of your input influence range records. The default value is 5,280 feet (1 mile). Do not alter the default value when using this tool in Class Location workflows.
  • Output Sliding Range Segment Features – Unless otherwise specified, the default destination for the output sliding range segment features is the DOT_STRUCTUREONEMILESEGMENT feature class in your selected Gas HCA Tool project geodatabase.
  • Output Sliding Mile Class Location Records – Unless otherwise specified, the default destination for the ‘raw’ sliding mile Class Location records is the DOT_ONEMILECLASSSEGMENT table in your selected Gas HCA Tool project geodatabase.

In a typical Class Location analysis workflow, Generate Sliding Ranges is run after Prepare Cluster Buffers and before Class Location Calculation.

Syntax

SlidingMileTool_hcapy (project_database, {centerline_layer} {influence_range_table}, Sliding Mile Distance, {onemile_class_table}, {onemile_segment_layer})

Parameter Explanation Data Type
project_database

Dialog Reference

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

There is no Python reference for this parameter.

Workspace

centerline

(Optional)

Dialog Reference

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

There is no Python reference for this parameter.

Feature Layer

influence_range_table

(Optional)

Dialog Reference

Select your influence range features previously created by the Calculate Influence Ranges tool.

There is no Python reference for this parameter.

Feature Layer
sliding_mile_distance

Dialog Reference

Specify your desired sliding range length. 5,280 feet (one mile) is the default. (This value should not be modified for Class Location workflows.)

There is no Python reference for this parameter.

Long

onemile_class_table

(Optional)

Dialog Reference

Specify the destination for your output ‘raw’ sliding mile Class Location records.

There is no Python reference for this parameter.

Table View

onemile_segment_layer

(Optional)

Dialog Reference

Specify the destination for your output sliding range segment features.

There is no Python reference for this parameter.

Table View

Code sample

Generate Sliding Ranges

# import 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”
range_distance = 5280
# Execute tool
arcpy.SlidingRange_hcapy (project_database, sliding_mile_distance = range_distance)

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

Qualifying areas, qualifying buildings, BIHO, class location, sliding range, sliding mile.

Credits

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

Use limitations

There are no access and use limitations for this item.