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

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.