Class Location Calculation
Summary
Class Location Calculation performs the final step in the Class Location analysis workflow, calculating your DOT Class Location units as specified in 49 CFR § 192.5 Class Locations. In a typical Class Location analysis, you have previously generated ‘raw’ class location units based on ‘sliding mile’ BIHO counts, as well ranges for Class 3 locations due to the presence qualifying areas/buildings, and Class 4 locations due to the prevalence of 4-story or higher buildings, and also the ranges for clusters of BIHOs. This tool combines those data layers to produce final Class Location unit ranges.
See How Class Location Calculation works to learn more about how the tool generates final Class Location unit ranges.
Usage
- Input Centerline Features – This tool requires as input the centerline segment 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 Sliding Mile Class Location Segment Records – This tool requires as input the ‘raw’ sliding mile Class Location records output by the Generate Sliding Ranges tool. Unless otherwise specified, the tool defaults this parameter to the DOT_ONEMILECLASSSEGMENT table in your selected Gas HCA Tool project geodatabase.
- Input Structure Cluster Segment Records – This tool requires as input the BIHO structure cluster segment records generated by the Prepare Cluster Buffers tool. Unless otherwise specified, the tool defaults this parameter to the DOT_STRUCTURE_CLUSTERSEGMENT table in your selected Gas HCA Tool project geodatabase.
- Input Site Cluster Segment Records – This tool requires as input the qualifying area/building cluster segment records generated by the Prepare Cluster Buffers tool. Unless otherwise specified, the tool defaults this parameter to the DOT_SITE_CLUSTERSEGMENT table in your selected Gas HCA Tool project geodatabase.
- Input Class 4 Cluster Segment Records – This tool requires as input the Class 4 cluster buffer segment records generated by the Prepare Cluster Buffers tool. Unless otherwise specified, the tool defaults this parameter to the DOT_CLASS4_CLUSTERSEGMENT table in your selected Gas HCA Tool project geodatabase.
- Sliver Segment Dissolve Tolerance for Class 4 (and 3 and 2) – These parameters allow you to specify the maximum ‘sliver’ length to be allowed when two higher Class Location units surround a short length lesser Class Location unit (a ‘sliver’). When the length of the lesser Class Location unit is less that the tolerance length, the ‘sliver’ Class Location unit is assigned the higher class of the surrounding Class Location units, in effect ‘dissolving’ the sliver. Note that the actual Class Location unit value is preserved in the data.
- Output Unclustered Class Location Features – These output features are your final, unclustered Class Location units. Unless you specify otherwise, the default destination for the output unclustered Class Location unit features is the DOT_CLASS_RANGE_UNCLUSTERED feature class in your selected Gas HCA Tool project geodatabase.
- Output Clustered Class Location Features – These output features are your final, clustered Class Location units. Unless you specify otherwise, the default destination for the output clustered Class Location unit features is the DOT_CLASS_RANGE_CLUSTERED feature class in your selected Gas HCA Tool project geodatabase.
- Output Unclustered Class Location Segment Features – These output features are your final, unclustered Class Location units, dynamically segmented with all relevant data attributes. Unless you specify otherwise, the default destination for the output unclustered Class Location segment features is the DOT_CLASS_SEGMENT_UNCLUSTERED feature class in your selected Gas HCA Tool project geodatabase.
- Output Clustered Class Location Segment Features – These output features are your final, clustered Class Location units, dynamically segmented with all relevant data attributes. Unless you specify otherwise, the default destination for the output clustered Class Location segment features is the DOT_CLASS_SEGMENT_CLUSTERED feature class in your selected Gas HCA Tool project geodatabase.
In a typical Class Location analysis workflow, Class Location Calculation is the last tool used, running after the Generate Sliding Ranges tool.
Syntax
CalculateDOTClassTool_hcapy (input_database, {centerline_layer}, {onemile_class_table}, {structure_clustered_segment}, {site_clustered_segment}, {class4_clustered_segment}, {sliver_dissolve_tolerance_4}, {sliver_dissolve_tolerance_3}, {sliver_dissolve_tolerance_2}, {output_unclustered_class}, {output_clustered_class}, {output_unclustered_class_segment}, {output_clustered_class_segment})
Parameter | Explanation | Data Type |
input_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 Specify your input centerline segment features. There is no Python reference for this parameter. |
Feature Layer |
onemile_class_table (Optional) |
Dialog Reference Specify your input ‘raw’ sliding mile Class Location records. There is no Python reference for this parameter. |
Table View |
structure_clustered_segment (Optional) |
Dialog Reference Specify your input BIHO structure cluster segment records. There is no Python reference for this parameter. |
Table View |
site_clustered_segment (Optional) |
Dialog Reference Specify your input qualifying area/building cluster segment records. There is no Python reference for this parameter. |
Table View |
class4_clustered_segment (Optional) |
Dialog Reference Specify your input Class 4 cluster buffer segment records. There is no Python reference for this parameter. |
Table View |
sliver_dissolve_tolerance_4 (Optional) |
Dialog Reference Specify the maximum sliver length value below which lower Class Location units that are surrounded by Class 4 location units will be dissolved into the surrounding Class 4 location units. There is no Python reference for this parameter. |
Double |
sliver_dissolve_tolerance_3 (Optional) |
Dialog Reference Specify the maximum sliver length value below which lower Class Location units that are surrounded by Class 3 location units will be dissolved into the surrounding Class 3 location units. There is no Python reference for this parameter. |
Double |
sliver_dissolve_tolerance_2 (Optional) |
Dialog Reference Specify the maximum sliver length value below which Class 1 location units that are surrounded by Class 2 location units will be dissolved into the surrounding Class 2 location units. There is no Python reference for this parameter. |
Double |
output_unclustered_class (Optional) |
Dialog Reference Specify the destination for your output unclustered Class Location unit features. There is no Python reference for this parameter. |
Feature Layer |
output_clustered_class (Optional) |
Dialog Reference Specify the destination for your output clustered Class Location unit features. There is no Python reference for this parameter. |
Feature Layer |
output_unclustered_class_segment (Optional) |
Dialog Reference Specify the destination for your output unclustered Class Location segment features. There is no Python reference for this parameter. |
Feature Layer |
output_clustered_class_segment (Optional) |
Dialog Reference Specify the destination for your output clustered Class Location segment features. There is no Python reference for this parameter. |
Feature Layer |
Code sample
# 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”
# Execute tool
arcpy.CalculateDOTClass_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
- Introduction to the Gas HCA Tool
- Initialize Database
- Copy Centerlines
- Prepare Cluster Buffers
- Prepare Structure and Site Buffers and Segments
- Generate Sliding Ranges
Tags
Class Location, sliding range, sliding mile, influence range, cluster, clustered, unclustered.
Credits
Copyright © 2016-2020 by G2 Integrated Solutions, LLC. All Rights Reserved.
Use limitations
There are no access and use limitations for this item.