Label | Explanation | Data Type |
Upper Line Features
| The line features that represent the top of a slope. | Feature Layer |
Lower Line Features
| The line features that represent the bottom of a slope. | Feature Layer |
Output Feature Class
| The output feature class containing multipart line or polygon hachures representing the slope area. | Feature Class |
Output Feature Type
(Optional) | Specifies whether polygon triangles or tick lines will be created to represent the slope.
| String |
Fully connected (Optional) | Specifies whether the upper and lower lines in the input data form fully connected areas. If the upper and lower lines are not fully connected, leave this parameter unchecked to create hachures inside areas that are derived by connecting the extremities of the upper and lower features. If the upper and lower lines are fully connected, check this parameter to create hachures inside the fully enclosed areas.
| Boolean |
Search Distance (Optional) |
The distance used when deriving connections between the upper and lower features. When the extremities for the upper and lower feature are within this distance, the area between the features is used for creating hachures. The default value is 20 meters. When the Fully connected parameter is checked, this parameter is not available. | Linear Unit |
Hachure Interval (Optional) |
The distance between the hachure ticks or triangles within the slope area. The default value is 10 meters. | Linear Unit |
Minimum Length (Optional) |
The length a hachure tick or triangle must be to be created. Hachures that are shorter than this length will not be created. The default value is 0 meters. | Linear Unit |
Alternate length of every other hachure (Optional) | Specifies whether the length of every other hachure triangle or tick will differ.
| Boolean |
Perpendicular to upper line (Optional) | Specifies whether the hachure ticks or triangles will be perpendicular to the upper slope line.
| Boolean |
Polygon Base Width (Optional) |
The width of the base of triangular polygon hachures. This parameter is active only when the Output Feature Type parameter is set to Polygon triangles. The default value is 5 meters. | Linear Unit |
Summary
Creates multipart lines or polygons representing the slope between the lines representing the upper and lower parts of a slope.
Illustration
Usage
The Search Distance parameter specifies the distance between the extremities of the upper and lower lines. If the extremities are within this distance, hachures are created in the area between the upper and lower lines. Both sets of extremities must be within this distance for hachures to be created. This parameter is only used if the Fully connected parameter is unchecked.
When multiple connected lines are present, they are considered as one (as though they are dissolved), and the extremities of the dissolved line are used for the search distance.
The geometry of the input features must be correctly established for the tool to determine the relationship of the features. Gaps, overlaps, or features that are not properly connected at the ends may affect the creation of the hachures.
-
Consider running the Simplify Line or Smooth Line tool first to remove small details in the upper and lower line features that may affect the orientation of the hachures.
Parameters
arcpy.cartography.GenerateHachuresForDefinedSlopes(upper_lines, lower_lines, output_feature_class, {output_type}, {fully_connected}, {search_distance}, {interval}, {minimum_length}, {alternate_hachures}, {perpendicular}, {polygon_base_width})
Name | Explanation | Data Type |
upper_lines | The line features that represent the top of a slope. | Feature Layer |
lower_lines | The line features that represent the bottom of a slope. | Feature Layer |
output_feature_class | The output feature class containing multipart line or polygon hachures representing the slope area. | Feature Class |
output_type (Optional) | Specifies whether polygon triangles or tick lines will be created to represent the slope.
| String |
fully_connected (Optional) | Specifies whether the upper and lower lines in the input data form fully connected areas. If the upper and lower lines are not fully connected, choose NOT_CONNECTED to create hachures inside areas that are derived by connecting the extremities of the upper and lower features. If the upper and lower lines are fully connected, choose FULLY_CONNECTED to create hachures inside the fully enclosed areas.
| Boolean |
search_distance (Optional) |
The distance used when deriving connections between the upper and lower features. When the extremities for the upper and lower feature are within this distance, the area between the features is used for creating hachures. The default value is 20 meters. When the fully_connected parameter is set to FULLY_CONNECTED, this parameter is ignored. | Linear Unit |
interval (Optional) |
The distance between the hachure ticks or triangles within the slope area. The default value is 10 meters. | Linear Unit |
minimum_length (Optional) |
The length a hachure tick or triangle must be to be created. Hachures that are shorter than this length will not be created. The default value is 0 meters. | Linear Unit |
alternate_hachures (Optional) | Specifies whether the length of every other hachure triangle or tick will differ.
| Boolean |
perpendicular (Optional) | Specifies whether the hachure ticks or triangles will be perpendicular to the upper slope line.
| Boolean |
polygon_base_width (Optional) |
The width of the base of triangular polygon hachures. This parameter is enabled only when the output_type parameter is set to polygon_triangles. The default value is 5 meters. | Linear Unit |
Code sample
The following Python window script demonstrates how to use the GenerateHachuresForDefinedSlopes function in immediate mode.
import arcpy
arcpy.env.workspace = "C:\Data\Hachures.gdb"
arcpy.cartography.GenerateHachuresForDefinedSlopes("UpperEdges",
"LowerEdges",
"Hachures_output",
"POLYGON_TRIANGLES",
"NOT_CONNECTED",
"20 Meters",
"10 Meters",
"0 Meters",
"UNIFORM_HACHURES",
"",
"5 Meters")
This stand-alone script shows an example of using the GenerateHachuresForDefinedSlopes function.
""" Name: GenerateHachuresForDefinedSlopes_standalone_script.py
Description: Generates multipart polygons representing
the slope between the lines of an upper and lower slope
"""
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/Data/Hachures.gdb"
# Set local variables
upper_lines = "UpperEdges"
lower_lines = "LowerEdges"
output_type = "POLYGON_TRIANGLES"
output_feature_class = "Hachures_output"
fully_connected = "NOT_CONNECTED"
search_distance = "20 Meters"
interval = "10 Meters"
minimum_length = "0 Meters"
alternate_hachures = "UNIFORM_HACHURES"
perpendicular = False
polygon_base_width = "5 Meters"
# Execute Generate Hachures For Defined Slopes
arcpy.cartography.GenerateHachuresForDefinedSlopes(upper_lines,
lower_lines,
output_feature_class,
output_type,
fully_connected,
search_distance,
interval,
minimum_length,
alternate_hachures,
perpendicular,
polygon_base_width)
Environments
Licensing information
- Basic: No
- Standard: No
- Advanced: Yes