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.

Credits

Use limitations

There are no access and use limitations for this item.