Setup Level Distance Constraints (Territory Design)

Summary

Tool allows setup distance constraints for the territories at the specified level.

Usage

• Territory Level must be at format: Level_Name[Level_Index]

• Distance Units parameter depends on value of Measure Type at specified level. This value can be modified by UI or SetupLevelParameter_TD tool (see in_measure_type parameter)

• Maximum Distance, Minimum Distance and Minimum Distance Between Centers values must be greater than zero

Syntax

SetupLevelDistanceConstraints_TD_td (in_territory_solution_layer, in_level, {in_distance_units}, {in_maximum_distance}, {in_minimum_distance}, {in_centers_minimum_distance})

Parameter	Explanation	Data Type
in_territory_solution_layer	Territory Solution layer to setup parameters	GP TD Layer
in_level	Territory Level to modify	String
in_distance_units (Optional)	Distance Units of distance constraints. STRAIGHT_LINE_DISTANCE —values of Measure Type: MILES KILOMETERS FEET YARDS NAUTICAL_MILES METERS DECIMAL_DEGREES DRIVE_TIME —value of Measure Type: DAYS HOURS MINUTES SECONDS	String
in_maximum_distance (Optional)	Maximum distance a territory can grow from its center	Double
in_minimum_distance (Optional)	Minimum distance a territory can be from the center of nearby territory	Double
in_centers_minimum_distance (Optional)	Minimum distance between territory centers	Double

Code Sample

SetupLevelDistanceConstraints_TD example (Python window)

The following Python window script demonstrates how to use the tool in immediate mode.

import arcgisscripting
gp = arcgisscripting.create()
gp.SetupLevelDistanceConstraints_TD("new layer", "Territories[1]", "MILES", 100, 40, 80)

SetupLevelDistanceConstraints_TD example 2 (stand-alone script)

The following stand-alone script demonstrates how to use the tool.

# Import system modules
import arcgisscripting
gp = arcgisscripting.create()

# Set local variables
solution = "new layer"
level = "Territories[1]"
distanceUnits = "MILES"
maximumDistance = 100
minimumDistance = 40
minimumCentersDistance = 80

# Execute tool
gp.SetupLevelDistanceConstraints_TD(solution, level, maximumDistance, minimumDistance, minimumCentersDistance)

Environments

This tool does not use any geoprocessing environments

Licensing Information

ArcGIS for Desktop Basic: Requires Business Analyst

ArcGIS for Desktop Standard: Requires Business Analyst

ArcGIS for Desktop Advanced: Requires Business Analyst